# SOME DESCRIPTIVE TITLE. # Copyright (C) 1990-2016, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 2.7\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2016-10-30 10:44+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../Doc/library/socket.rst:2 msgid ":mod:`socket` --- Low-level networking interface" msgstr "" #: ../Doc/library/socket.rst:8 msgid "" "This module provides access to the BSD *socket* interface. It is available " "on all modern Unix systems, Windows, Mac OS X, BeOS, OS/2, and probably " "additional platforms." msgstr "" #: ../Doc/library/socket.rst:14 msgid "" "Some behavior may be platform dependent, since calls are made to the " "operating system socket APIs." msgstr "" #: ../Doc/library/socket.rst:17 msgid "" "For an introduction to socket programming (in C), see the following papers: " "An Introductory 4.3BSD Interprocess Communication Tutorial, by Stuart " "Sechrest and An Advanced 4.3BSD Interprocess Communication Tutorial, by " "Samuel J. Leffler et al, both in the UNIX Programmer's Manual, " "Supplementary Documents 1 (sections PS1:7 and PS1:8). The platform-specific " "reference material for the various socket-related system calls are also a " "valuable source of information on the details of socket semantics. For " "Unix, refer to the manual pages; for Windows, see the WinSock (or Winsock 2) " "specification. For IPv6-ready APIs, readers may want to refer to :rfc:`3493` " "titled Basic Socket Interface Extensions for IPv6." msgstr "" #: ../Doc/library/socket.rst:29 msgid "" "The Python interface is a straightforward transliteration of the Unix system " "call and library interface for sockets to Python's object-oriented style: " "the :func:`.socket` function returns a :dfn:`socket object` whose methods " "implement the various socket system calls. Parameter types are somewhat " "higher-level than in the C interface: as with :meth:`read` and :meth:`write` " "operations on Python files, buffer allocation on receive operations is " "automatic, and buffer length is implicit on send operations." msgstr "" #: ../Doc/library/socket.rst:39 msgid "" "Socket addresses are represented as follows: A single string is used for " "the :const:`AF_UNIX` address family. A pair ``(host, port)`` is used for " "the :const:`AF_INET` address family, where *host* is a string representing " "either a hostname in Internet domain notation like ``'daring.cwi.nl'`` or an " "IPv4 address like ``'100.50.200.5'``, and *port* is an integer. For :const:" "`AF_INET6` address family, a four-tuple ``(host, port, flowinfo, scopeid)`` " "is used, where *flowinfo* and *scopeid* represents ``sin6_flowinfo`` and " "``sin6_scope_id`` member in :const:`struct sockaddr_in6` in C. For :mod:" "`socket` module methods, *flowinfo* and *scopeid* can be omitted just for " "backward compatibility. Note, however, omission of *scopeid* can cause " "problems in manipulating scoped IPv6 addresses. Other address families are " "currently not supported. The address format required by a particular socket " "object is automatically selected based on the address family specified when " "the socket object was created." msgstr "" #: ../Doc/library/socket.rst:54 msgid "" "For IPv4 addresses, two special forms are accepted instead of a host " "address: the empty string represents :const:`INADDR_ANY`, and the string " "``''`` represents :const:`INADDR_BROADCAST`. The behavior is not " "available for IPv6 for backward compatibility, therefore, you may want to " "avoid these if you intend to support IPv6 with your Python programs." msgstr "" #: ../Doc/library/socket.rst:60 msgid "" "If you use a hostname in the *host* portion of IPv4/v6 socket address, the " "program may show a nondeterministic behavior, as Python uses the first " "address returned from the DNS resolution. The socket address will be " "resolved differently into an actual IPv4/v6 address, depending on the " "results from DNS resolution and/or the host configuration. For " "deterministic behavior use a numeric address in *host* portion." msgstr "" #: ../Doc/library/socket.rst:67 msgid "AF_NETLINK sockets are represented as pairs ``pid, groups``." msgstr "" #: ../Doc/library/socket.rst:70 msgid "" "Linux-only support for TIPC is also available using the :const:`AF_TIPC` " "address family. TIPC is an open, non-IP based networked protocol designed " "for use in clustered computer environments. Addresses are represented by a " "tuple, and the fields depend on the address type. The general tuple form is " "``(addr_type, v1, v2, v3 [, scope])``, where:" msgstr "" #: ../Doc/library/socket.rst:77 msgid "" "*addr_type* is one of :const:`TIPC_ADDR_NAMESEQ`, :const:`TIPC_ADDR_NAME`, " "or :const:`TIPC_ADDR_ID`." msgstr "" #: ../Doc/library/socket.rst:79 msgid "" "*scope* is one of :const:`TIPC_ZONE_SCOPE`, :const:`TIPC_CLUSTER_SCOPE`, " "and :const:`TIPC_NODE_SCOPE`." msgstr "" #: ../Doc/library/socket.rst:81 msgid "" "If *addr_type* is :const:`TIPC_ADDR_NAME`, then *v1* is the server type, " "*v2* is the port identifier, and *v3* should be 0." msgstr "" #: ../Doc/library/socket.rst:84 msgid "" "If *addr_type* is :const:`TIPC_ADDR_NAMESEQ`, then *v1* is the server type, " "*v2* is the lower port number, and *v3* is the upper port number." msgstr "" #: ../Doc/library/socket.rst:87 msgid "" "If *addr_type* is :const:`TIPC_ADDR_ID`, then *v1* is the node, *v2* is the " "reference, and *v3* should be set to 0." msgstr "" #: ../Doc/library/socket.rst:91 msgid "" "All errors raise exceptions. The normal exceptions for invalid argument " "types and out-of-memory conditions can be raised; errors related to socket " "or address semantics raise the error :exc:`socket.error`." msgstr "" #: ../Doc/library/socket.rst:95 msgid "" "Non-blocking mode is supported through :meth:`~socket.setblocking`. A " "generalization of this based on timeouts is supported through :meth:`~socket." "settimeout`." msgstr "" #: ../Doc/library/socket.rst:99 msgid "The module :mod:`socket` exports the following constants and functions:" msgstr "" #: ../Doc/library/socket.rst:106 msgid "" "This exception is raised for socket-related errors. The accompanying value " "is either a string telling what went wrong or a pair ``(errno, string)`` " "representing an error returned by a system call, similar to the value " "accompanying :exc:`os.error`. See the module :mod:`errno`, which contains " "names for the error codes defined by the underlying operating system." msgstr "" #: ../Doc/library/socket.rst:112 msgid ":exc:`socket.error` is now a child class of :exc:`IOError`." msgstr "" #: ../Doc/library/socket.rst:118 msgid "" "This exception is raised for address-related errors, i.e. for functions that " "use *h_errno* in the C API, including :func:`gethostbyname_ex` and :func:" "`gethostbyaddr`." msgstr "" #: ../Doc/library/socket.rst:122 msgid "" "The accompanying value is a pair ``(h_errno, string)`` representing an error " "returned by a library call. *string* represents the description of " "*h_errno*, as returned by the :c:func:`hstrerror` C function." msgstr "" #: ../Doc/library/socket.rst:129 msgid "" "This exception is raised for address-related errors, for :func:`getaddrinfo` " "and :func:`getnameinfo`. The accompanying value is a pair ``(error, " "string)`` representing an error returned by a library call. *string* " "represents the description of *error*, as returned by the :c:func:" "`gai_strerror` C function. The *error* value will match one of the :const:" "`EAI_\\*` constants defined in this module." msgstr "" #: ../Doc/library/socket.rst:139 msgid "" "This exception is raised when a timeout occurs on a socket which has had " "timeouts enabled via a prior call to :meth:`settimeout`. The accompanying " "value is a string whose value is currently always \"timed out\"." msgstr "" #: ../Doc/library/socket.rst:150 msgid "" "These constants represent the address (and protocol) families, used for the " "first argument to :func:`.socket`. If the :const:`AF_UNIX` constant is not " "defined then this protocol is unsupported." msgstr "" #: ../Doc/library/socket.rst:161 msgid "" "These constants represent the socket types, used for the second argument to :" "func:`socket`. (Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to " "be generally useful.)" msgstr "" #: ../Doc/library/socket.rst:180 msgid "" "Many constants of these forms, documented in the Unix documentation on " "sockets and/or the IP protocol, are also defined in the socket module. They " "are generally used in arguments to the :meth:`setsockopt` and :meth:" "`getsockopt` methods of socket objects. In most cases, only those symbols " "that are defined in the Unix header files are defined; for a few symbols, " "default values are provided." msgstr "" #: ../Doc/library/socket.rst:190 msgid "" "Constants for Windows' WSAIoctl(). The constants are used as arguments to " "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" #: ../Doc/library/socket.rst:197 msgid "" "TIPC related constants, matching the ones exported by the C socket API. See " "the TIPC documentation for more information." msgstr "" #: ../Doc/library/socket.rst:204 msgid "" "This constant contains a boolean value which indicates if IPv6 is supported " "on this platform." msgstr "" #: ../Doc/library/socket.rst:212 msgid "" "Connect to a TCP service listening on the Internet *address* (a 2-tuple " "``(host, port)``), and return the socket object. This is a higher-level " "function than :meth:`socket.connect`: if *host* is a non-numeric hostname, " "it will try to resolve it for both :data:`AF_INET` and :data:`AF_INET6`, and " "then try to connect to all possible addresses in turn until a connection " "succeeds. This makes it easy to write clients that are compatible to both " "IPv4 and IPv6." msgstr "" #: ../Doc/library/socket.rst:220 msgid "" "Passing the optional *timeout* parameter will set the timeout on the socket " "instance before attempting to connect. If no *timeout* is supplied, the " "global default timeout setting returned by :func:`getdefaulttimeout` is used." msgstr "" #: ../Doc/library/socket.rst:225 msgid "" "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the " "socket to bind to as its source address before connecting. If host or port " "are '' or 0 respectively the OS default behavior will be used." msgstr "" #: ../Doc/library/socket.rst:231 msgid "*source_address* was added." msgstr "" #: ../Doc/library/socket.rst:237 msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " "service. *host* is a domain name, a string representation of an IPv4/v6 " "address or ``None``. *port* is a string service name such as ``'http'``, a " "numeric port number or ``None``. By passing ``None`` as the value of *host* " "and *port*, you can pass ``NULL`` to the underlying C API." msgstr "" #: ../Doc/library/socket.rst:244 msgid "" "The *family*, *socktype* and *proto* arguments can be optionally specified " "in order to narrow the list of addresses returned. By default, their value " "is ``0``, meaning that the full range of results is selected. The *flags* " "argument can be one or several of the ``AI_*`` constants, and will influence " "how results are computed and returned. Its default value is ``0``. For " "example, :const:`AI_NUMERICHOST` will disable domain name resolution and " "will raise an error if *host* is a domain name." msgstr "" #: ../Doc/library/socket.rst:252 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" #: ../Doc/library/socket.rst:254 msgid "``(family, socktype, proto, canonname, sockaddr)``" msgstr "" #: ../Doc/library/socket.rst:256 msgid "" "In these tuples, *family*, *socktype*, *proto* are all integers and are " "meant to be passed to the :func:`.socket` function. *canonname* will be a " "string representing the canonical name of the *host* if :const:" "`AI_CANONNAME` is part of the *flags* argument; else *canonname* will be " "empty. *sockaddr* is a tuple describing a socket address, whose format " "depends on the returned *family* (a ``(address, port)`` 2-tuple for :const:" "`AF_INET`, a ``(address, port, flow info, scope id)`` 4-tuple for :const:" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" #: ../Doc/library/socket.rst:266 msgid "" "The following example fetches address information for a hypothetical TCP " "connection to ``example.org`` on port 80 (results may differ on your system " "if IPv6 isn't enabled)::" msgstr "" #: ../Doc/library/socket.rst:279 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " "name, the hostname returned by :func:`gethostbyaddr` is checked, followed by " "aliases for the host, if available. The first name which includes a period " "is selected. In case no fully qualified domain name is available, the " "hostname as returned by :func:`gethostname` is returned." msgstr "" #: ../Doc/library/socket.rst:291 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " "address itself it is returned unchanged. See :func:`gethostbyname_ex` for a " "more complete interface. :func:`gethostbyname` does not support IPv6 name " "resolution, and :func:`getaddrinfo` should be used instead for IPv4/v6 dual " "stack support." msgstr "" #: ../Doc/library/socket.rst:300 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a " "triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the primary " "host name responding to the given *ip_address*, *aliaslist* is a (possibly " "empty) list of alternative host names for the same address, and *ipaddrlist* " "is a list of IPv4 addresses for the same interface on the same host (often " "but not always a single address). :func:`gethostbyname_ex` does not support " "IPv6 name resolution, and :func:`getaddrinfo` should be used instead for " "IPv4/v6 dual stack support." msgstr "" #: ../Doc/library/socket.rst:312 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" #: ../Doc/library/socket.rst:315 msgid "" "If you want to know the current machine's IP address, you may want to use " "``gethostbyname(gethostname())``. This operation assumes that there is a " "valid address-to-host mapping for the host, and the assumption does not " "always hold." msgstr "" #: ../Doc/library/socket.rst:320 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use ``getfqdn()`` (see above)." msgstr "" #: ../Doc/library/socket.rst:326 msgid "" "Return a triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " "(possibly empty) list of alternative host names for the same address, and " "*ipaddrlist* is a list of IPv4/v6 addresses for the same interface on the " "same host (most likely containing only a single address). To find the fully " "qualified domain name, use the function :func:`getfqdn`. :func:" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" #: ../Doc/library/socket.rst:337 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully-" "qualified domain name or numeric address representation in *host*. " "Similarly, *port* can contain a string port name or a numeric port number." msgstr "" #: ../Doc/library/socket.rst:347 msgid "" "Translate an Internet protocol name (for example, ``'icmp'``) to a constant " "suitable for passing as the (optional) third argument to the :func:`.socket` " "function. This is usually only needed for sockets opened in \"raw\" mode (:" "const:`SOCK_RAW`); for the normal socket modes, the correct protocol is " "chosen automatically if the protocol is omitted or zero." msgstr "" #: ../Doc/library/socket.rst:356 msgid "" "Translate an Internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" #: ../Doc/library/socket.rst:363 msgid "" "Translate an Internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" #: ../Doc/library/socket.rst:370 msgid "" "Create a new socket using the given address family, socket type and protocol " "number. The address family should be :const:`AF_INET` (the default), :const:" "`AF_INET6` or :const:`AF_UNIX`. The socket type should be :const:" "`SOCK_STREAM` (the default), :const:`SOCK_DGRAM` or perhaps one of the other " "``SOCK_`` constants. The protocol number is usually zero and may be omitted " "in that case." msgstr "" #: ../Doc/library/socket.rst:380 msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " "number are as for the :func:`.socket` function above. The default family is :" "const:`AF_UNIX` if defined on the platform; otherwise, the default is :const:" "`AF_INET`. Availability: Unix." msgstr "" #: ../Doc/library/socket.rst:391 msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`fileno` method) and build a socket object from the result. " "Address family, socket type and protocol number are as for the :func:`." "socket` function above. The file descriptor should refer to a socket, but " "this is not checked --- subsequent operations on the object may fail if the " "file descriptor is invalid. This function is rarely needed, but can be used " "to get or set socket options on a socket passed to a program as standard " "input or output (such as a server started by the Unix inet daemon). The " "socket is assumed to be in blocking mode. Availability: Unix." msgstr "" #: ../Doc/library/socket.rst:404 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" #: ../Doc/library/socket.rst:411 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" #: ../Doc/library/socket.rst:418 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" #: ../Doc/library/socket.rst:425 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" #: ../Doc/library/socket.rst:432 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a string four characters " "in length. This is useful when conversing with a program that uses the " "standard C library and needs objects of type :c:type:`struct in_addr`, which " "is the C type for the 32-bit packed binary this function returns." msgstr "" #: ../Doc/library/socket.rst:438 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" #: ../Doc/library/socket.rst:441 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:`socket." "error` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" #: ../Doc/library/socket.rst:445 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" #: ../Doc/library/socket.rst:451 msgid "" "Convert a 32-bit packed IPv4 address (a string four characters in length) to " "its standard dotted-quad string representation (for example, " "'123.45.67.89'). This is useful when conversing with a program that uses " "the standard C library and needs objects of type :c:type:`struct in_addr`, " "which is the C type for the 32-bit packed binary data this function takes as " "an argument." msgstr "" #: ../Doc/library/socket.rst:457 msgid "" "If the string passed to this function is not exactly 4 bytes in length, :exc:" "`socket.error` will be raised. :func:`inet_ntoa` does not support IPv6, and :" "func:`inet_ntop` should be used instead for IPv4/v6 dual stack support." msgstr "" #: ../Doc/library/socket.rst:464 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " "protocol calls for an object of type :c:type:`struct in_addr` (similar to :" "func:`inet_aton`) or :c:type:`struct in6_addr`." msgstr "" #: ../Doc/library/socket.rst:469 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" "`socket.error` will be raised. Note that exactly what is valid depends on " "both the value of *address_family* and the underlying implementation of :c:" "func:`inet_pton`." msgstr "" #: ../Doc/library/socket.rst:475 ../Doc/library/socket.rst:493 msgid "Availability: Unix (maybe not all platforms)." msgstr "" #: ../Doc/library/socket.rst:482 msgid "" "Convert a packed IP address (a string of some number of characters) to its " "standard, family-specific string representation (for example, ``'7.10.0.5'`` " "or ``'5aef:2b::8'``) :func:`inet_ntop` is useful when a library or network " "protocol returns an object of type :c:type:`struct in_addr` (similar to :" "func:`inet_ntoa`) or :c:type:`struct in6_addr`." msgstr "" #: ../Doc/library/socket.rst:488 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the string *packed_ip* is not the correct length for " "the specified address family, :exc:`ValueError` will be raised. A :exc:" "`socket.error` is raised for errors from the call to :func:`inet_ntop`." msgstr "" #: ../Doc/library/socket.rst:500 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " "the socket module is first imported, the default is ``None``." msgstr "" #: ../Doc/library/socket.rst:509 msgid "" "Set the default timeout in seconds (float) for new socket objects. A value " "of ``None`` indicates that new socket objects have no timeout. When the " "socket module is first imported, the default is ``None``." msgstr "" #: ../Doc/library/socket.rst:518 msgid "" "This is a Python type object that represents the socket object type. It is " "the same as ``type(socket(...))``." msgstr "" #: ../Doc/library/socket.rst:525 msgid "Module :mod:`SocketServer`" msgstr "" #: ../Doc/library/socket.rst:525 msgid "Classes that simplify writing network servers." msgstr "" #: ../Doc/library/socket.rst:527 msgid "Module :mod:`ssl`" msgstr "" #: ../Doc/library/socket.rst:528 msgid "A TLS/SSL wrapper for socket objects." msgstr "" #: ../Doc/library/socket.rst:534 msgid "Socket Objects" msgstr "" #: ../Doc/library/socket.rst:536 msgid "" "Socket objects have the following methods. Except for :meth:`makefile` " "these correspond to Unix system calls applicable to sockets." msgstr "" #: ../Doc/library/socket.rst:542 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " "is a *new* socket object usable to send and receive data on the connection, " "and *address* is the address bound to the socket on the other end of the " "connection." msgstr "" #: ../Doc/library/socket.rst:550 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:555 ../Doc/library/socket.rst:581 msgid "" "This method has historically accepted a pair of parameters for :const:" "`AF_INET` addresses instead of only a tuple. This was never intentional and " "is no longer available in Python 2.0 and later." msgstr "" #: ../Doc/library/socket.rst:562 msgid "" "Close the socket. All future operations on the socket object will fail. The " "remote end will receive no more data (after queued data is flushed). Sockets " "are automatically closed when they are garbage-collected." msgstr "" #: ../Doc/library/socket.rst:568 msgid "" ":meth:`close()` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " "connection in a timely fashion, call :meth:`shutdown()` before :meth:" "`close()`." msgstr "" #: ../Doc/library/socket.rst:576 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:588 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " "(other problems, such as \"host not found,\" can still raise exceptions). " "The error indicator is ``0`` if the operation succeeded, otherwise the value " "of the :c:data:`errno` variable. This is useful to support, for example, " "asynchronous connects." msgstr "" #: ../Doc/library/socket.rst:597 msgid "" "This method has historically accepted a pair of parameters for :const:" "`AF_INET` addresses instead of only a tuple. This was never intentional and " "is no longer available in Python 2.0 and later." msgstr "" #: ../Doc/library/socket.rst:604 msgid "" "Return the socket's file descriptor (a small integer). This is useful with :" "func:`select.select`." msgstr "" #: ../Doc/library/socket.rst:607 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" #: ../Doc/library/socket.rst:614 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " "format of the address returned depends on the address family --- see " "above.) On some systems this function is not supported." msgstr "" #: ../Doc/library/socket.rst:622 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " "depends on the address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:629 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:const:`SO_\\*` etc.) are " "defined in this module. If *buflen* is absent, an integer option is assumed " "and its integer value is returned by the function. If *buflen* is present, " "it specifies the maximum length of the buffer used to receive the option in, " "and this buffer is returned as a string. It is up to the caller to decode " "the contents of the buffer (see the optional built-in module :mod:`struct` " "for a way to decode C structures encoded as strings)." msgstr "" #: ../Doc/library/socket.rst:641 msgid "Windows" msgstr "Windows" #: ../Doc/library/socket.rst:643 msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " "interface. Please refer to the `Win32 documentation `_ for more information." msgstr "" #: ../Doc/library/socket.rst:648 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" #: ../Doc/library/socket.rst:656 msgid "" "Listen for connections made to the socket. The *backlog* argument specifies " "the maximum number of queued connections and should be at least 0; the " "maximum value is system-dependent (usually 5), the minimum value is forced " "to 0." msgstr "" #: ../Doc/library/socket.rst:665 msgid "" "Return a :dfn:`file object` associated with the socket. (File objects are " "described in :ref:`bltin-file-objects`.) The file object does not close the " "socket explicitly when its :meth:`close` method is called, but only removes " "its reference to the socket object, so that the socket will be closed if it " "is not referenced from anywhere else." msgstr "" #: ../Doc/library/socket.rst:671 msgid "" "The socket must be in blocking mode (it can not have a timeout). The " "optional *mode* and *bufsize* arguments are interpreted the same way as by " "the built-in :func:`file` function." msgstr "" #: ../Doc/library/socket.rst:677 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " "arguments of :meth:`subprocess.Popen`." msgstr "" #: ../Doc/library/socket.rst:684 msgid "" "Receive data from the socket. The return value is a string representing the " "data received. The maximum amount of data to be received at once is " "specified by *bufsize*. See the Unix manual page :manpage:`recv(2)` for the " "meaning of the optional argument *flags*; it defaults to zero." msgstr "" #: ../Doc/library/socket.rst:691 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" #: ../Doc/library/socket.rst:697 msgid "" "Receive data from the socket. The return value is a pair ``(string, " "address)`` where *string* is a string representing the data received and " "*address* is the address of the socket sending the data. See the Unix " "manual page :manpage:`recv(2)` for the meaning of the optional argument " "*flags*; it defaults to zero. (The format of *address* depends on the " "address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:706 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating " "a new string. The return value is a pair ``(nbytes, address)`` where " "*nbytes* is the number of bytes received and *address* is the address of the " "socket sending the data. See the Unix manual page :manpage:`recv(2)` for " "the meaning of the optional argument *flags*; it defaults to zero. (The " "format of *address* depends on the address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:718 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new string. If *nbytes* is not specified (or 0), " "receive up to the size available in the given buffer. Returns the number of " "bytes received. See the Unix manual page :manpage:`recv(2)` for the meaning " "of the optional argument *flags*; it defaults to zero." msgstr "" #: ../Doc/library/socket.rst:729 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " "above. Returns the number of bytes sent. Applications are responsible for " "checking that all data has been sent; if only some of the data was " "transmitted, the application needs to attempt delivery of the remaining " "data. For further information on this concept, consult the :ref:`socket-" "howto`." msgstr "" #: ../Doc/library/socket.rst:739 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " "above. Unlike :meth:`send`, this method continues to send data from *string* " "until either all data has been sent or an error occurs. ``None`` is " "returned on success. On error, an exception is raised, and there is no way " "to determine how much data, if any, was successfully sent." msgstr "" #: ../Doc/library/socket.rst:750 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " "optional *flags* argument has the same meaning as for :meth:`recv` above. " "Return the number of bytes sent. (The format of *address* depends on the " "address family --- see above.)" msgstr "" #: ../Doc/library/socket.rst:759 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is 0, the socket " "is set to non-blocking, else to blocking mode. Initially all sockets are in " "blocking mode. In non-blocking mode, if a :meth:`recv` call doesn't find " "any data, or if a :meth:`send` call can't immediately dispose of the data, " "an :exc:`error` exception is raised; in blocking mode, the calls block until " "they can proceed. ``s.setblocking(0)`` is equivalent to ``s." "settimeout(0.0)``; ``s.setblocking(1)`` is equivalent to ``s." "settimeout(None)``." msgstr "" #: ../Doc/library/socket.rst:770 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " "nonnegative float expressing seconds, or ``None``. If a float is given, " "subsequent socket operations will raise a :exc:`timeout` exception if the " "timeout period *value* has elapsed before the operation has completed. " "Setting a timeout of ``None`` disables timeouts on socket operations. ``s." "settimeout(0.0)`` is equivalent to ``s.setblocking(0)``; ``s." "settimeout(None)`` is equivalent to ``s.setblocking(1)``." msgstr "" #: ../Doc/library/socket.rst:783 msgid "" "Return the timeout in seconds (float) associated with socket operations, or " "``None`` if no timeout is set. This reflects the last call to :meth:" "`setblocking` or :meth:`settimeout`." msgstr "" #: ../Doc/library/socket.rst:789 msgid "" "Some notes on socket blocking and timeouts: A socket object can be in one of " "three modes: blocking, non-blocking, or timeout. Sockets are always created " "in blocking mode. In blocking mode, operations block until complete or the " "system returns an error (such as connection timed out). In non-blocking " "mode, operations fail (with an error that is unfortunately system-dependent) " "if they cannot be completed immediately. In timeout mode, operations fail " "if they cannot be completed within the timeout specified for the socket or " "if the system returns an error. The :meth:`~socket.setblocking` method is " "simply a shorthand for certain :meth:`~socket.settimeout` calls." msgstr "" #: ../Doc/library/socket.rst:799 msgid "" "Timeout mode internally sets the socket in non-blocking mode. The blocking " "and timeout modes are shared between file descriptors and socket objects " "that refer to the same network endpoint. A consequence of this is that file " "objects returned by the :meth:`~socket.makefile` method must only be used " "when the socket is in blocking mode; in timeout or non-blocking mode file " "operations that cannot be completed immediately will fail." msgstr "" #: ../Doc/library/socket.rst:806 msgid "" "Note that the :meth:`~socket.connect` operation is subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " "before calling :meth:`~socket.connect` or pass a timeout parameter to :meth:" "`create_connection`. The system network stack may return a connection " "timeout error of its own regardless of any Python socket timeout setting." msgstr "" #: ../Doc/library/socket.rst:817 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in the :mod:" "`socket` module (:const:`SO_\\*` etc.). The value can be an integer or a " "string representing a buffer. In the latter case it is up to the caller to " "ensure that the string contains the proper bits (see the optional built-in " "module :mod:`struct` for a way to encode C structures as strings)." msgstr "" #: ../Doc/library/socket.rst:827 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " "further sends are disallowed. If *how* is :const:`SHUT_RDWR`, further sends " "and receives are disallowed. Depending on the platform, shutting down one " "half of the connection can also close the opposite half (e.g. on Mac OS X, " "``shutdown(SHUT_WR)`` does not allow further reads on the other end of the " "connection)." msgstr "" #: ../Doc/library/socket.rst:834 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" #: ../Doc/library/socket.rst:837 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`socket` constructor." msgstr "" #: ../Doc/library/socket.rst:843 msgid "The socket family." msgstr "" #: ../Doc/library/socket.rst:850 msgid "The socket type." msgstr "" #: ../Doc/library/socket.rst:857 msgid "The socket protocol." msgstr "" #: ../Doc/library/socket.rst:865 msgid "Example" msgstr "Exemple" #: ../Doc/library/socket.rst:867 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " "a client using it. Note that a server must perform the sequence :func:`." "socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:`~socket." "accept` (possibly repeating the :meth:`~socket.accept` to service more than " "one client), while a client only needs the sequence :func:`.socket`, :meth:" "`~socket.connect`. Also note that the server does not :meth:`~socket." "sendall`/:meth:`~socket.recv` on the socket it is listening on but on the " "new socket returned by :meth:`~socket.accept`." msgstr "" #: ../Doc/library/socket.rst:877 msgid "The first two examples support IPv4 only. ::" msgstr "" #: ../Doc/library/socket.rst:909 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " "(it should listen to both instead). On most of IPv6-ready systems, IPv6 will " "take precedence and the server may not accept IPv4 traffic. The client side " "will try to connect to the all addresses returned as a result of the name " "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" #: ../Doc/library/socket.rst:982 msgid "" "The last example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " "the interface::" msgstr "" #: ../Doc/library/socket.rst:1008 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" #: ../Doc/library/socket.rst:1013 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" #: ../Doc/library/socket.rst:1016 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :data:" "`socket.SO_REUSEADDR`::" msgstr "" #: ../Doc/library/socket.rst:1023 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr ""