Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(2)

Delta Between Two Patch Sets: Doc/library/socket.rst

Issue 27744: Add AF_ALG (Linux Kernel crypto) to socket module
Left Patch Set: Created 3 years, 6 months ago
Right Patch Set: Created 3 years, 6 months ago
Left:
Right:
Use n/p to move between diff chunks; N/P to move between comments. Please Sign in to add in-line comments.
Jump to:
Left: Side by side diff | Download
Right: Side by side diff | Download
LEFTRIGHT
1 :mod:`socket` --- Low-level networking interface 1 :mod:`socket` --- Low-level networking interface
2 ================================================ 2 ================================================
3 3
4 .. module:: socket 4 .. module:: socket
5 :synopsis: Low-level networking interface. 5 :synopsis: Low-level networking interface.
6 6
7 **Source code:** :source:`Lib/socket.py` 7 **Source code:** :source:`Lib/socket.py`
8 8
9 -------------- 9 --------------
10 10
(...skipping 330 matching lines...) Expand 10 before | Expand all | Expand 10 after
341 SOL_RDS 341 SOL_RDS
342 RDS_* 342 RDS_*
343 343
344 Many constants of these forms, documented in the Linux documentation, are 344 Many constants of these forms, documented in the Linux documentation, are
345 also defined in the socket module. 345 also defined in the socket module.
346 346
347 Availability: Linux >= 2.6.30. 347 Availability: Linux >= 2.6.30.
348 348
349 .. versionadded:: 3.3 349 .. versionadded:: 3.3
350 350
351
351 .. data:: SIO_RCVALL 352 .. data:: SIO_RCVALL
352 SIO_KEEPALIVE_VALS 353 SIO_KEEPALIVE_VALS
353 SIO_LOOPBACK_FAST_PATH 354 SIO_LOOPBACK_FAST_PATH
354 RCVALL_* 355 RCVALL_*
355 356
356 Constants for Windows' WSAIoctl(). The constants are used as arguments to the 357 Constants for Windows' WSAIoctl(). The constants are used as arguments to the
357 :meth:`~socket.socket.ioctl` method of socket objects. 358 :meth:`~socket.socket.ioctl` method of socket objects.
358 359
359 .. versionchanged:: 3.6 360 .. versionchanged:: 3.6
360 ``SIO_LOOPBACK_FAST_PATH`` was added. 361 ``SIO_LOOPBACK_FAST_PATH`` was added.
361 362
362 363
363 .. data:: TIPC_* 364 .. data:: TIPC_*
364 365
365 TIPC related constants, matching the ones exported by the C socket API. See 366 TIPC related constants, matching the ones exported by the C socket API. See
366 the TIPC documentation for more information. 367 the TIPC documentation for more information.
367 368
368 .. data:: AF_ALG 369 .. data:: AF_ALG
369 SO_ALG 370 SOL_ALG
haypo 2016/08/30 16:56:07 SO_ALG or SOL_ALG? In socketmodule.c, I read: PyM
370 ALG_* 371 ALG_*
371 RDS_*
372 372
373 Constants for Linux Kernel cryptography. 373 Constants for Linux Kernel cryptography.
374 374
375 Availability: Linux >= 2.6.38. 375 Availability: Linux >= 2.6.38.
376 376
377 .. versionadded:: 3.6 377 .. versionadded:: 3.6
378 378
379 .. data:: AF_LINK 379 .. data:: AF_LINK
380 380
381 Availability: BSD, OSX. 381 Availability: BSD, OSX.
(...skipping 996 matching lines...) Expand 10 before | Expand all | Expand 10 after
1378 1378
1379 .. method:: socket.setsockopt(level, optname, value: int) 1379 .. method:: socket.setsockopt(level, optname, value: int)
1380 .. method:: socket.setsockopt(level, optname, value: buffer) 1380 .. method:: socket.setsockopt(level, optname, value: buffer)
1381 .. method:: socket.setsockopt(level, optname, None, optlen: int) 1381 .. method:: socket.setsockopt(level, optname, None, optlen: int)
1382 1382
1383 .. index:: module: struct 1383 .. index:: module: struct
1384 1384
1385 Set the value of the given socket option (see the Unix manual page 1385 Set the value of the given socket option (see the Unix manual page
1386 :manpage:`setsockopt(2)`). The needed symbolic constants are defined in the 1386 :manpage:`setsockopt(2)`). The needed symbolic constants are defined in the
1387 :mod:`socket` module (:const:`SO_\*` etc.). The value can be an integer, 1387 :mod:`socket` module (:const:`SO_\*` etc.). The value can be an integer,
1388 None or or a :term:`bytes-like object` representing a buffer. In the later 1388 None or or a :term:`bytes-like object` representing a buffer. In the later
Martin Panter 2016/09/04 16:01:03 “or” is doubled
christian.heimes 2016/09/04 16:58:44 thanks, fixed
1389 case it is up to the caller to ensure that the bytestring contains the 1389 case it is up to the caller to ensure that the bytestring contains the
1390 proper bits (see the optional built-in module :mod:`struct` for a way to 1390 proper bits (see the optional built-in module :mod:`struct` for a way to
1391 encode C structures as bytestrings). When value is set to None, 1391 encode C structures as bytestrings). When value is set to None,
1392 optlen argument is required. It's equivalent to call setsockopt C 1392 optlen argument is required. It's equivalent to call setsockopt C
1393 function with optval=NULL and optlen=optlen. 1393 function with optval=NULL and optlen=optlen.
haypo 2016/08/30 16:56:07 Thanks. The new format is the documentation is muc
1394 1394
1395 1395
1396 .. versionchanged:: 3.5 1396 .. versionchanged:: 3.5
1397 Writable :term:`bytes-like object` is now accepted. 1397 Writable :term:`bytes-like object` is now accepted.
1398 1398
1399 .. versionchanged:: 3.6 1399 .. versionchanged:: 3.6
1400 setsockopt(level, optname, None, optlen: int) form added. 1400 setsockopt(level, optname, None, optlen: int) form added.
1401 1401
1402 1402
1403 .. method:: socket.shutdown(how) 1403 .. method:: socket.shutdown(how)
(...skipping 316 matching lines...) Expand 10 before | Expand all | Expand 10 after
1720 1720
1721 - *An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. Lef fler et 1721 - *An Advanced 4.3BSD Interprocess Communication Tutorial*, by Samuel J. Lef fler et
1722 al, 1722 al,
1723 1723
1724 both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections 1724 both in the UNIX Programmer's Manual, Supplementary Documents 1 (sections
1725 PS1:7 and PS1:8). The platform-specific reference material for the various 1725 PS1:7 and PS1:8). The platform-specific reference material for the various
1726 socket-related system calls are also a valuable source of information on the 1726 socket-related system calls are also a valuable source of information on the
1727 details of socket semantics. For Unix, refer to the manual pages; for Window s, 1727 details of socket semantics. For Unix, refer to the manual pages; for Window s,
1728 see the WinSock (or Winsock 2) specification. For IPv6-ready APIs, readers m ay 1728 see the WinSock (or Winsock 2) specification. For IPv6-ready APIs, readers m ay
1729 want to refer to :rfc:`3493` titled Basic Socket Interface Extensions for IPv 6. 1729 want to refer to :rfc:`3493` titled Basic Socket Interface Extensions for IPv 6.
LEFTRIGHT

RSS Feeds Recent Issues | This issue
This is Rietveld 894c83f36cb7+