Clarify weasel-words for getaddrinfo().
This commit is contained in:
parent
40dc92be19
commit
801e07188f
15
pep-3156.txt
15
pep-3156.txt
|
@ -430,12 +430,17 @@ usually called implicitly by ``create_connection()``,
|
|||
implement their own DNS lookup. The optional arguments *must* be
|
||||
specified as keyword arguments.
|
||||
|
||||
Note: implementations are required to implement a subset of the full
|
||||
Note: implementations are allowed to implement a subset of the full
|
||||
socket.getaddrinfo() interface; e.g. they may not support symbolic
|
||||
port names, or they may ignore or incompletely implement the type,
|
||||
proto and flags arguments. However, if ``type`` and ``proto`` are
|
||||
ignored, the argument values should be reflected unchanged in the
|
||||
return tuples' ``socket_type`` and ``socket_protocol`` elements.
|
||||
port names, or they may ignore or incompletely implement the
|
||||
``type``, ``proto`` and ``flags`` arguments. However, if ``type``
|
||||
and ``proto`` are ignored, the argument values passed in should be
|
||||
copied unchanged into the return tuples' ``socket_type`` and
|
||||
``socket_protocol`` elements. (You can't ignore ``family``, since
|
||||
IPv4 and IPv6 addresses must be looked up differently. The only
|
||||
permissible values for ``family`` are ``socket.AF_UNSPEC`` (``0``),
|
||||
``socket.AF_INET`` and ``socket.AF_INET6``, and the latter only if
|
||||
it is defined by the platform.)
|
||||
|
||||
- ``getnameinfo(sockaddr, flags=0)``. Similar to
|
||||
``socket.getnameinfo()`` but returns a Future. The Future's result
|
||||
|
|
Loading…
Reference in New Issue