mirrors/Nim
1
0
Fork 0
mirror of https://github.com/nim-lang/Nim.git synced 2026-04-19 22:10:33 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added more SSL documentation to net module. (#15206)

Browse Source 
* Added more SSL documentation to `net` module.

* Changed two of the net.nim doc refs to links.

* Update lib/pure/net.nim doc wording.

Co-authored-by: Dominik Picheta <dominikpicheta@googlemail.com>

* Update lib/pure/net.nim - added space to doc URI

Co-authored-by: alaviss <leorize+oss@disroot.org>

* Fixed another doc URI in net module.

* For net module doc added warning to connect procedure.

* Update net.nim

Co-authored-by: Dominik Picheta <dominikpicheta@googlemail.com>
Co-authored-by: alaviss <leorize+oss@disroot.org>
This commit is contained in:
John Dupuy
2020-08-22 05:00:38 -05:00
committed by GitHub
parent 8a004e2fc0
commit 66eba3388a
1 changed files with 17 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
lib/pure/net.nim
View File

@@ -20,7 +20,9 @@
## ====
##
## In order to use the SSL procedures defined in this module, you will need to
## compile your application with the ``-d:ssl`` flag.
## compile your application with the ``-d:ssl`` flag. See the
## `newContext<net.html#newContext%2Cstring%2Cstring%2Cstring%2Cstring%2Cstring>`_
## procedure for additional details.
##
## Examples
## ========
@@ -36,9 +38,17 @@
## var socket = newSocket()
## socket.connect("google.com", Port(80))
##
## For SSL, use the following example (and make sure to compile with ``-d:ssl``):
##
## .. code-block:: Nim
## var socket = newSocket()
## var ctx = newContext()
## wrapSocket(ctx, socket)
## socket.connect("google.com", Port(443))
##
## UDP is a connectionless protocol, so UDP sockets don't have to explicitly
## call the ``connect`` procedure. They can simply start sending data
## immediately.
## call the `connect <net.html#connect%2CSocket%2Cstring>`_ procedure. They can
## simply start sending data immediately.
##
## .. code-block:: Nim
## var socket = newSocket(AF_INET, SOCK_DGRAM, IPPROTO_UDP)
@@ -1942,6 +1952,10 @@ proc connect*(socket: Socket, address: string, port = Port(0),
##
## The ``timeout`` parameter specifies the time in milliseconds to allow for
## the connection to the server to be made.
##
## **Warning:** This procedure appears to be broken for SSL connections as of
## Nim v1.0.2. Consider using the other `connect` procedure. See
## https://github.com/nim-lang/Nim/issues/15215 for more info.
socket.fd.setBlocking(false)
socket.connectAsync(address, port, socket.domain)