# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2021, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# m_aciek <maciej.olko@gmail.com>, 2020

# Michał Biliński <m.bilinskimichal@gmail.com>, 2021

#

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.8\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2021-01-01 16:06+0000\n"

"PO-Revision-Date: 2020-05-30 12:09+0000\n"

"Last-Translator: Michał Biliński <m.bilinskimichal@gmail.com>, 2021\n"

"Language-Team: Polish (https://www.transifex.com/python-doc/teams/5390/pl/)\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Language: pl\n"

"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && "

"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && "

"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"

msgid ":mod:`socket` --- Low-level networking interface"

msgstr ""

msgid "**Source code:** :source:`Lib/socket.py`"

msgstr ""

msgid ""

"This module provides access to the BSD *socket* interface. It is available "

"on all modern Unix systems, Windows, MacOS, and probably additional "

"platforms."

msgstr ""

msgid ""

"Some behavior may be platform dependent, since calls are made to the "

"operating system socket APIs."

msgstr ""

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 ""

msgid "Module :mod:`socketserver`"

msgstr ""

msgid "Classes that simplify writing network servers."

msgstr ""

msgid "Module :mod:`ssl`"

msgstr ""

msgid "A TLS/SSL wrapper for socket objects."

msgstr ""

msgid "Socket families"

msgstr ""

msgid ""

"Depending on the system and the build options, various socket families are "

"supported by this module."

msgstr ""

msgid ""

"The address format required by a particular socket object is automatically "

"selected based on the address family specified when the socket object was "

"created. Socket addresses are represented as follows:"

msgstr ""

msgid ""

"The address of an :const:`AF_UNIX` socket bound to a file system node is "

"represented as a string, using the file system encoding and the "

"``'surrogateescape'`` error handler (see :pep:`383`). An address in Linux's "

"abstract namespace is returned as a :term:`bytes-like object` with an "

"initial null byte; note that sockets in this namespace can communicate with "

"normal file system sockets, so programs intended to run on Linux may need to "

"deal with both types of address. A string or bytes-like object can be used "

"for either type of address when passing it as an argument."

msgstr ""

msgid ""

"Previously, :const:`AF_UNIX` socket paths were assumed to use UTF-8 encoding."

msgstr ""

msgid "Writable :term:`bytes-like object` is now accepted."

msgstr ""

msgid ""

"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."

msgstr ""

msgid ""

"For IPv4 addresses, two special forms are accepted instead of a host "

"address: ``''`` represents :const:`INADDR_ANY`, which is used to bind to all "

"interfaces, and the string ``'<broadcast>'`` represents :const:"

"`INADDR_BROADCAST`. This behavior is not compatible with IPv6, therefore, "

"you may want to avoid these if you intend to support IPv6 with your Python "

"programs."

msgstr ""

msgid ""

"For :const:`AF_INET6` address family, a four-tuple ``(host, port, flowinfo, "

"scopeid)`` is used, where *flowinfo* and *scopeid* represent the "

"``sin6_flowinfo`` and ``sin6_scope_id`` members 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."

msgstr ""

msgid ""

"For multicast addresses (with *scopeid* meaningful) *address* may not "

"contain ``%scope`` (or ``zone id``) part. This information is superfluous "

"and may be safely omitted (recommended)."

msgstr ""

msgid ":const:`AF_NETLINK` sockets are represented as pairs ``(pid, groups)``."

msgstr ""

msgid ""

"Linux-only support for TIPC is 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 ""

msgid ""

"*addr_type* is one of :const:`TIPC_ADDR_NAMESEQ`, :const:`TIPC_ADDR_NAME`, "

"or :const:`TIPC_ADDR_ID`."

msgstr ""

msgid ""

"*scope* is one of :const:`TIPC_ZONE_SCOPE`, :const:`TIPC_CLUSTER_SCOPE`, "

"and :const:`TIPC_NODE_SCOPE`."

msgstr ""

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 ""

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 ""

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 ""

msgid ""

"A tuple ``(interface, )`` is used for the :const:`AF_CAN` address family, "

"where *interface* is a string representing a network interface name like "

"``'can0'``. The network interface name ``''`` can be used to receive packets "

"from all network interfaces of this family."

msgstr ""

msgid ""

":const:`CAN_ISOTP` protocol require a tuple ``(interface, rx_addr, "

"tx_addr)`` where both additional parameters are unsigned long integer that "

"represent a CAN identifier (standard or extended)."

msgstr ""

msgid ""

"A string or a tuple ``(id, unit)`` is used for the :const:`SYSPROTO_CONTROL` "

"protocol of the :const:`PF_SYSTEM` family. The string is the name of a "

"kernel control using a dynamically-assigned ID. The tuple can be used if ID "

"and unit number of the kernel control are known or if a registered ID is "

"used."

msgstr ""

msgid ""

":const:`AF_BLUETOOTH` supports the following protocols and address formats:"

msgstr ""

msgid ""

":const:`BTPROTO_L2CAP` accepts ``(bdaddr, psm)`` where ``bdaddr`` is the "

"Bluetooth address as a string and ``psm`` is an integer."

msgstr ""

msgid ""

":const:`BTPROTO_RFCOMM` accepts ``(bdaddr, channel)`` where ``bdaddr`` is "

"the Bluetooth address as a string and ``channel`` is an integer."

msgstr ""

msgid ""

":const:`BTPROTO_HCI` accepts ``(device_id,)`` where ``device_id`` is either "

"an integer or a string with the Bluetooth address of the interface. (This "

"depends on your OS; NetBSD and DragonFlyBSD expect a Bluetooth address while "

"everything else expects an integer.)"

msgstr ""

msgid "NetBSD and DragonFlyBSD support added."

msgstr ""

msgid ""

":const:`BTPROTO_SCO` accepts ``bdaddr`` where ``bdaddr`` is a :class:`bytes` "

"object containing the Bluetooth address in a string format. (ex. "

"``b'12:23:34:45:56:67'``) This protocol is not supported under FreeBSD."

msgstr ""

msgid ""

":const:`AF_ALG` is a Linux-only socket based interface to Kernel "

"cryptography. An algorithm socket is configured with a tuple of two to four "

"elements ``(type, name [, feat [, mask]])``, where:"

msgstr ""

msgid ""

"*type* is the algorithm type as string, e.g. ``aead``, ``hash``, "

"``skcipher`` or ``rng``."

msgstr ""

msgid ""

"*name* is the algorithm name and operation mode as string, e.g. ``sha256``, "

"``hmac(sha256)``, ``cbc(aes)`` or ``drbg_nopr_ctr_aes256``."

msgstr ""

msgid "*feat* and *mask* are unsigned 32bit integers."

msgstr ""

msgid ""

":const:`AF_VSOCK` allows communication between virtual machines and their "

"hosts. The sockets are represented as a ``(CID, port)`` tuple where the "

"context ID or CID and port are integers."

msgstr ""

msgid ""

":const:`AF_PACKET` is a low-level interface directly to network devices. The "

"packets are represented by the tuple ``(ifname, proto[, pkttype[, hatype[, "

"addr]]])`` where:"

msgstr ""

msgid "*ifname* - String specifying the device name."

msgstr ""

msgid ""

"*proto* - An in network-byte-order integer specifying the Ethernet protocol "

"number."

msgstr ""

msgid "*pkttype* - Optional integer specifying the packet type:"

msgstr ""

msgid "``PACKET_HOST`` (the default) - Packet addressed to the local host."

msgstr ""

msgid "``PACKET_BROADCAST`` - Physical-layer broadcast packet."

msgstr ""

msgid ""

"``PACKET_MULTIHOST`` - Packet sent to a physical-layer multicast address."

msgstr ""

msgid ""

"``PACKET_OTHERHOST`` - Packet to some other host that has been caught by a "

"device driver in promiscuous mode."

msgstr ""

msgid ""

"``PACKET_OUTGOING`` - Packet originating from the local host that is looped "

"back to a packet socket."

msgstr ""

msgid "*hatype* - Optional integer specifying the ARP hardware address type."

msgstr ""

msgid ""

"*addr* - Optional bytes-like object specifying the hardware physical "

"address, whose interpretation depends on the device."

msgstr ""

msgid ""

":const:`AF_QIPCRTR` is a Linux-only socket based interface for communicating "

"with services running on co-processors in Qualcomm platforms. The address "

"family is represented as a ``(node, port)`` tuple where the *node* and "

"*port* are non-negative integers."

msgstr ""

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 ""

msgid ""

"All errors raise exceptions. The normal exceptions for invalid argument "

"types and out-of-memory conditions can be raised; starting from Python 3.3, "

"errors related to socket or address semantics raise :exc:`OSError` or one of "

"its subclasses (they used to raise :exc:`socket.error`)."

msgstr ""

msgid ""

"Non-blocking mode is supported through :meth:`~socket.setblocking`. A "

"generalization of this based on timeouts is supported through :meth:`~socket."

"settimeout`."

msgstr ""

msgid "Module contents"

msgstr ""

msgid "The module :mod:`socket` exports the following elements."

msgstr ""

msgid "Exceptions"

msgstr "Sytuacje Wyjątkowe"

msgid "A deprecated alias of :exc:`OSError`."

msgstr ""

msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`."

msgstr ""

msgid ""

"A subclass of :exc:`OSError`, this exception is raised for address-related "

"errors, i.e. for functions that use *h_errno* in the POSIX C API, including :"

"func:`gethostbyname_ex` and :func:`gethostbyaddr`. The accompanying value is "

"a pair ``(h_errno, string)`` representing an error returned by a library "

"call. *h_errno* is a numeric value, while *string* represents the "

"description of *h_errno*, as returned by the :c:func:`hstrerror` C function."

msgstr ""

msgid "This class was made a subclass of :exc:`OSError`."

msgstr ""

msgid ""

"A subclass of :exc:`OSError`, this exception is raised for address-related "

"errors by :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 numeric *error* value will "

"match one of the :const:`EAI_\\*` constants defined in this module."

msgstr ""

msgid ""

"A subclass of :exc:`OSError`, this exception is raised when a timeout occurs "

"on a socket which has had timeouts enabled via a prior call to :meth:"

"`~socket.settimeout` (or implicitly through :func:`~socket."

"setdefaulttimeout`). The accompanying value is a string whose value is "

"currently always \"timed out\"."

msgstr ""

msgid "Constants"

msgstr "Stały"

msgid ""

"The AF_* and SOCK_* constants are now :class:`AddressFamily` and :class:"

"`SocketKind` :class:`.IntEnum` collections."

msgstr ""

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. More constants may be available "

"depending on the system."

msgstr ""

msgid ""

"These constants represent the socket types, used for the second argument to :"

"func:`.socket`. More constants may be available depending on the system. "

"(Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be generally "

"useful.)"

msgstr ""

msgid ""

"These two constants, if defined, can be combined with the socket types and "

"allow you to set some flags atomically (thus avoiding possible race "

"conditions and the need for separate calls)."

msgstr ""

msgid ""

"`Secure File Descriptor Handling <http://udrepper.livejournal.com/20407."

"html>`_ for a more thorough explanation."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 2.6.27."

msgstr ""

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 ""

msgid ""

"``SO_DOMAIN``, ``SO_PROTOCOL``, ``SO_PEERSEC``, ``SO_PASSSEC``, "

"``TCP_USER_TIMEOUT``, ``TCP_CONGESTION`` were added."

msgstr ""

msgid ""

"On Windows, ``TCP_FASTOPEN``, ``TCP_KEEPCNT`` appear if run-time Windows "

"supports."

msgstr ""

msgid "``TCP_NOTSENT_LOWAT`` was added."

msgstr ""

msgid ""

"On Windows, ``TCP_KEEPIDLE``, ``TCP_KEEPINTVL`` appear if run-time Windows "

"supports."

msgstr ""

msgid ""

"Many constants of these forms, documented in the Linux documentation, are "

"also defined in the socket module."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 2.6.25."

msgstr ""

msgid ""

"CAN_BCM, in the CAN protocol family, is the broadcast manager (BCM) "

"protocol. Broadcast manager constants, documented in the Linux "

"documentation, are also defined in the socket module."

msgstr ""

msgid ""

"The :data:`CAN_BCM_CAN_FD_FRAME` flag is only available on Linux >= 4.8."

msgstr ""

msgid ""

"Enables CAN FD support in a CAN_RAW socket. This is disabled by default. "

"This allows your application to send both CAN and CAN FD frames; however, "

"you must accept both CAN and CAN FD frames when reading from the socket."

msgstr ""

msgid "This constant is documented in the Linux documentation."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 3.6."

msgstr ""

msgid ""

"CAN_ISOTP, in the CAN protocol family, is the ISO-TP (ISO 15765-2) protocol. "

"ISO-TP constants, documented in the Linux documentation."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 2.2."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 2.6.30."

msgstr ""

msgid ""

"Constants for Windows' WSAIoctl(). The constants are used as arguments to "

"the :meth:`~socket.socket.ioctl` method of socket objects."

msgstr ""

msgid "``SIO_LOOPBACK_FAST_PATH`` was added."

msgstr ""

msgid ""

"TIPC related constants, matching the ones exported by the C socket API. See "

"the TIPC documentation for more information."

msgstr ""

msgid "Constants for Linux Kernel cryptography."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 2.6.38."

msgstr ""

msgid "Constants for Linux host/guest communication."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 4.8."

msgstr ""

msgid ":ref:`Availability <availability>`: BSD, OSX."

msgstr ""

msgid ""

"This constant contains a boolean value which indicates if IPv6 is supported "

"on this platform."

msgstr ""

msgid ""

"These are string constants containing Bluetooth addresses with special "

"meanings. For example, :const:`BDADDR_ANY` can be used to indicate any "

"address when specifying the binding socket with :const:`BTPROTO_RFCOMM`."

msgstr ""

msgid ""

"For use with :const:`BTPROTO_HCI`. :const:`HCI_FILTER` is not available for "

"NetBSD or DragonFlyBSD. :const:`HCI_TIME_STAMP` and :const:`HCI_DATA_DIR` "

"are not available for FreeBSD, NetBSD, or DragonFlyBSD."

msgstr ""

msgid ""

"Constant for Qualcomm's IPC router protocol, used to communicate with "

"service providing remote processors."

msgstr ""

msgid ":ref:`Availability <availability>`: Linux >= 4.7."

msgstr ""

msgid "Functions"

msgstr "Zadania"

msgid "Creating sockets"

msgstr ""

msgid ""

"The following functions all create :ref:`socket objects <socket-objects>`."

msgstr ""

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`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, or :const:"

"`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the default), :"

"const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` "

"constants. The protocol number is usually zero and may be omitted or in the "

"case where the address family is :const:`AF_CAN` the protocol should be one "

"of :const:`CAN_RAW`, :const:`CAN_BCM` or :const:`CAN_ISOTP`."

msgstr ""

msgid ""

"If *fileno* is specified, the values for *family*, *type*, and *proto* are "

"auto-detected from the specified file descriptor. Auto-detection can be "

"overruled by calling the function with explicit *family*, *type*, or *proto* "

"arguments. This only affects how Python represents e.g. the return value "

"of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:"

"`socket.fromfd`, *fileno* will return the same socket and not a duplicate. "

"This may help close a detached socket using :meth:`socket.close()`."

msgstr ""

msgid "The newly created socket is :ref:`non-inheritable <fd_inheritance>`."

msgstr ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.__new__`` with arguments "

"``self``, ``family``, ``type``, ``protocol``."

msgstr ""

msgid "The AF_CAN family was added. The AF_RDS family was added."

msgstr ""

msgid "The CAN_BCM protocol was added."

msgstr ""

msgid "The returned socket is now non-inheritable."

msgstr ""

msgid "The CAN_ISOTP protocol was added."

msgstr ""

msgid ""

"When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied "

"to *type* they are cleared, and :attr:`socket.type` will not reflect them. "

"They are still passed to the underlying system `socket()` call. Therefore,"

msgstr ""

msgid ""

"will still create a non-blocking socket on OSes that support "

"``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``."

msgstr ""

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`."

msgstr ""

msgid "The newly created sockets are :ref:`non-inheritable <fd_inheritance>`."

msgstr ""

msgid ""

"The returned socket objects now support the whole socket API, rather than a "

"subset."

msgstr ""

msgid "The returned sockets are now non-inheritable."

msgstr ""

msgid "Windows support added."

msgstr ""

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 ""

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 ""

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 ""

msgid "*source_address* was added."

msgstr ""

msgid ""

"Convenience function which creates a TCP socket bound to *address* (a 2-"

"tuple ``(host, port)``) and return the socket object."

msgstr ""

msgid ""

"*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is "

"the queue size passed to :meth:`socket.listen`; when ``0`` a default "

"reasonable value is chosen. *reuse_port* dictates whether to set the :data:"

"`SO_REUSEPORT` socket option."

msgstr ""

msgid ""

"If *dualstack_ipv6* is true and the platform supports it the socket will be "

"able to accept both IPv4 and IPv6 connections, else it will raise :exc:"

"`ValueError`. Most POSIX platforms and Windows are supposed to support this "

"functionality. When this functionality is enabled the address returned by :"

"meth:`socket.getpeername` when an IPv4 connection occurs will be an IPv6 "

"address represented as an IPv4-mapped IPv6 address. If *dualstack_ipv6* is "

"false it will explicitly disable this functionality on platforms that enable "

"it by default (e.g. Linux). This parameter can be used in conjunction with :"

"func:`has_dualstack_ipv6`:"

msgstr ""

msgid ""

"On POSIX platforms the :data:`SO_REUSEADDR` socket option is set in order to "

"immediately reuse previous sockets which were bound on the same *address* "

"and remained in TIME_WAIT state."

msgstr ""

msgid ""

"Return ``True`` if the platform supports creating a TCP socket which can "

"handle both IPv4 and IPv6 connections."

msgstr ""

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."

msgstr ""

msgid ""

"Instantiate a socket from data obtained from the :meth:`socket.share` "

"method. The socket is assumed to be in blocking mode."

msgstr ""

msgid ":ref:`Availability <availability>`: Windows."

msgstr ""

msgid ""

"This is a Python type object that represents the socket object type. It is "

"the same as ``type(socket(...))``."

msgstr ""

msgid "Other functions"

msgstr ""

msgid "The :mod:`socket` module also offers various network-related services:"

msgstr ""

msgid ""

"Close a socket file descriptor. This is like :func:`os.close`, but for "

"sockets. On some platforms (most noticeable Windows) :func:`os.close` does "

"not work for socket file descriptors."

msgstr ""

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 ""

msgid ""

"The *family*, *type* and *proto* arguments can be optionally specified in "

"order to narrow the list of addresses returned. Passing zero as a value for "

"each of these arguments selects the full range of results. The *flags* "

"argument can be one or several of the ``AI_*`` constants, and will influence "

"how results are computed and returned. For example, :const:`AI_NUMERICHOST` "

"will disable domain name resolution and will raise an error if *host* is a "

"domain name."

msgstr ""

msgid "The function returns a list of 5-tuples with the following structure:"

msgstr ""

msgid "``(family, type, proto, canonname, sockaddr)``"

msgstr ""

msgid ""

"In these tuples, *family*, *type*, *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 ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.getaddrinfo`` with "

"arguments ``host``, ``port``, ``family``, ``type``, ``protocol``."

msgstr ""

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 ""

msgid "parameters can now be passed using keyword arguments."

msgstr ""

msgid ""

"for IPv6 multicast addresses, string representing an address will not "

"contain ``%scope`` part."

msgstr ""

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 ""

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 ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.gethostbyname`` with "

"argument ``hostname``."

msgstr ""

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 ""

msgid ""

"Return a string containing the hostname of the machine where the Python "

"interpreter is currently executing."

msgstr ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.gethostname`` with no "

"arguments."

msgstr ""

msgid ""

"Note: :func:`gethostname` doesn't always return the fully qualified domain "

"name; use :func:`getfqdn` for that."

msgstr ""

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 ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.gethostbyaddr`` with "

"argument ``ip_address``."

msgstr ""

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 ""

msgid ""

"For IPv6 addresses, ``%scope`` is appended to the host part if *sockaddr* "

"contains meaningful *scopeid*. Usually this happens for multicast addresses."

msgstr ""

msgid ""

"For more information about *flags* you can consult :manpage:`getnameinfo(3)`."

msgstr ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.getnameinfo`` with "

"argument ``sockaddr``."

msgstr ""

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 ""

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 ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.getservbyname`` with "

"arguments ``servicename``, ``protocolname``."

msgstr ""

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 ""

msgid ""

"Raises an :ref:`auditing event <auditing>` ``socket.getservbyport`` with "

"arguments ``port``, ``protocolname``."

msgstr ""

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 ""

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 ""

msgid ""

"In case *x* does not fit in 16-bit unsigned integer, but does fit in a "

"positive C int, it is silently truncated to 16-bit unsigned integer. This "

"silent truncation feature is deprecated, and will raise an exception in "

"future versions of Python."

msgstr ""

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 ""

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 ""

msgid ""

"Convert an IPv4 address from dotted-quad string format (for example, "

"'123.45.67.89') to 32-bit packed binary format, as a bytes object 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 ""

msgid ""

":func:`inet_aton` also accepts strings with less than three dots; see the "

"Unix manual page :manpage:`inet(3)` for details."

msgstr ""

msgid ""

"If the IPv4 address string passed to this function is invalid, :exc:"

"`OSError` will be raised. Note that exactly what is valid depends on the "

"underlying C implementation of :c:func:`inet_aton`."

msgstr ""

msgid ""

":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be "

"used instead for IPv4/v6 dual stack support."

msgstr ""

msgid ""

"Convert a 32-bit packed IPv4 address (a :term:`bytes-like object` four bytes "

"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 ""

msgid ""

"If the byte sequence passed to this function is not exactly 4 bytes in "

"length, :exc:`OSError` 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 ""

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 ""

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:"

"`OSError` 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 ""

msgid ""

":ref:`Availability <availability>`: Unix (maybe not all platforms), Windows."

msgstr ""

msgid "Windows support added"

msgstr ""

msgid ""

"Convert a packed IP address (a :term:`bytes-like object` of some number of "

"bytes) 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 ""

msgid ""

"Supported values for *address_family* are currently :const:`AF_INET` and :"

"const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length "

"for the specified address family, :exc:`ValueError` will be raised. :exc:"

"`OSError` is raised for errors from the call to :func:`inet_ntop`."

msgstr ""

msgid ""

"Return the total length, without trailing padding, of an ancillary data item "

"with associated data of the given *length*. This value can often be used as "

"the buffer size for :meth:`~socket.recvmsg` to receive a single item of "

"ancillary data, but :rfc:`3542` requires portable applications to use :func:"

"`CMSG_SPACE` and thus include space for padding, even when the item will be "

"the last in the buffer. Raises :exc:`OverflowError` if *length* is outside "

"the permissible range of values."

msgstr ""

msgid ""

":ref:`Availability <availability>`: most Unix platforms, possibly others."

msgstr ""

msgid ""

"Return the buffer size needed for :meth:`~socket.recvmsg` to receive an "

"ancillary data item with associated data of the given *length*, along with "

"any trailing padding. The buffer space needed to receive multiple items is "

"the sum of the :func:`CMSG_SPACE` values for their associated data lengths. "

"Raises :exc:`OverflowError` if *length* is outside the permissible range of "

"values."

msgstr ""

msgid ""