socket.md

1> **Источник:** https://python-all.ru/3.6/library/socket.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 18.1. [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket) – Низкоуровневый сетевой интерфейс89**Исходный код:** [Lib/socket.py](https://python-all.ru/src/3.6/Lib/socket.py)1011---1213Этот модуль предоставляет доступ к интерфейсу *сокетов* BSD. Он доступен во всех современных системах Unix, Windows, MacOS и, возможно, на других платформах.1415> **Примечание**16>17> Некоторые аспекты поведения могут зависеть от платформы, поскольку вызовы выполняются через API сокетов операционной системы.1819Интерфейс Python представляет собой прямую трансляцию системных вызовов Unix и библиотечного интерфейса сокетов в объектно-ориентированный стиль Python: функция [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket) возвращает *объект сокета*, методы которого реализуют различные системные вызовы сокетов. Типы параметров несколько более высокоуровневые, чем в интерфейсе C: как и при операциях `read()` и `write()` с файлами Python, выделение буфера при операциях приёма происходит автоматически, а длина буфера неявно задаётся при отправке.2021> **См. также**22>23> **Модуль [`socketserver`](https://python-all.ru/3.6/library/socketserver.html#module-socketserver)**24>25> Классы, упрощающие написание сетевых серверов.26>27> **Модуль [`ssl`](https://python-all.ru/3.6/library/ssl.html#module-ssl)**28>29> Обёртка TLS/SSL для объектов сокетов.3031## 18.1.1. Семейства сокетов3233В зависимости от системы и параметров сборки этим модулем поддерживаются различные семейства сокетов.3435Формат адреса, требуемый для конкретного объекта сокета, автоматически выбирается на основе семейства адресов, указанного при создании объекта сокета. Адреса сокетов представляются следующим образом:3637- Адрес сокета [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX), привязанного к узлу файловой системы, представляется в виде строки с использованием кодировки файловой системы и обработчика ошибок `'surrogateescape'` (см. [**PEP 383**](https://python-all.ru/3.6/library/socket.html)). Адрес в абстрактном пространстве имён Linux возвращается как [байтоподобный объект](https://python-all.ru/3.6/glossary.html#term-bytes-like-object) с начальным нулевым байтом; обратите внимание, что сокеты в этом пространстве имён могут взаимодействовать с обычными файловыми сокетами, поэтому программы, предназначенные для работы в Linux, возможно, должны работать с обоими типами адресов. Строка или байтоподобный объект могут использоваться для любого из этих типов адресов при передаче в качестве аргумента.3839  > Изменено в версии 3.3: Ранее предполагалось, что пути сокетов [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX) используют кодировку UTF-8.40  >41  > Изменено в версии 3.5: Теперь принимается записываемый [байтоподобный объект](https://python-all.ru/3.6/glossary.html#term-bytes-like-object).4243- Пара `(host, port)` используется для семейства адресов [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET), где *host* – строка, представляющая либо имя узла в нотации интернет-домена например `'daring.cwi.nl'`, либо IPv4-адрес, например `'100.50.200.5'`, а *port* – целое число.4445  - Для IPv4-адресов вместо адреса хоста принимаются две специальные формы: `''` представляет `INADDR_ANY`, что используется для привязки ко всем интерфейсам, а строка `'<broadcast>'` представляет `INADDR_BROADCAST`. Такое поведение несовместимо с IPv6, поэтому, возможно, следует избегать их, если предполагается поддержка IPv6 в программах на Python.46- Для семейства адресов [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6) используется четырёхэлементный кортеж `(host, port, flowinfo, scopeid)`, где *flowinfo* и *scopeid* представляют члены `sin6_flowinfo` и `sin6_scope_id` в `struct sockaddr_in6` в C. Для методов модуля [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket) *flowinfo* и *scopeid* можно опускать только для обратной совместимости. Однако учтите, что опускание *scopeid* может вызвать проблемы при работе с scoped IPv6-адресами.47- Сокеты `AF_NETLINK` представляются в виде пар `(pid, groups)`.48- Поддержка TIPC только в Linux доступна через семейство адресов `AF_TIPC`. TIPC – это открытый сетевой протокол, не основанный на IP, предназначенный для использования в кластерных средах. Адреса представляются кортежем, и поля зависят от типа адреса. Общий вид кортежа: `(addr_type, v1, v2, v3 [, scope])`, где:4950  - *addr\_type* – одно из значений `TIPC_ADDR_NAMESEQ`, `TIPC_ADDR_NAME` или `TIPC_ADDR_ID`.51  - *scope* – одно из значений `TIPC_ZONE_SCOPE`, `TIPC_CLUSTER_SCOPE` и `TIPC_NODE_SCOPE`.52  - Если *addr\_type* равно `TIPC_ADDR_NAME`, то *v1* – тип сервера, *v2* – идентификатор порта, а *v3* должно быть 0.5354    Если *addr\_type* равно `TIPC_ADDR_NAMESEQ`, то *v1* – тип сервера, *v2* – нижний номер порта, а *v3* – верхний номер порта.5556    Если *addr\_type* равно `TIPC_ADDR_ID`, то *v1* – узел, *v2* – ссылка, а *v3* должно быть установлено в 0.57- Кортеж `(interface, )` используется для семейства адресов [`AF_CAN`](https://python-all.ru/3.6/library/socket.html#socket.AF_CAN), где *interface* – строка, представляющая имя сетевого интерфейса, например `'can0'`. Имя сетевого интерфейса `''` может использоваться для приёма пакетов от всех сетевых интерфейсов данного семейства.58- Строка или кортеж `(id, unit)` используется для протокола `SYSPROTO_CONTROL` семейства `PF_SYSTEM`. Строка – это имя управления ядра с динамически назначаемым ID. Кортеж можно использовать, если ID и номер модуля управления ядра известны или используется зарегистрированный ID.5960  Новое в версии 3.3.61- `AF_BLUETOOTH` поддерживает следующие протоколы и форматы адресов:6263  - `BTPROTO_L2CAP` принимает `(bdaddr, psm)`, где `bdaddr` – адрес Bluetooth в виде строки, а `psm` – целое число.64  - `BTPROTO_RFCOMM` принимает `(bdaddr, channel)`, где `bdaddr` – это Bluetooth-адрес в виде строки, а `channel` – целое число.65  - `BTPROTO_HCI` принимает `(device_id,)`, где `device_id` – это либо целое число, либо строка с Bluetooth-адресом интерфейса. (Зависит от ОС: NetBSD и DragonFlyBSD ожидают Bluetooth-адрес, все остальные – целое число.)6667    Изменено в версии 3.2: Добавлена поддержка NetBSD и DragonFlyBSD.68  - `BTPROTO_SCO` принимает `bdaddr`, где `bdaddr` – это объект [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes), содержащий Bluetooth-адрес в строковом формате (например, `b'12:23:34:45:56:67'`). Этот протокол не поддерживается в FreeBSD.69- [`AF_ALG`](https://python-all.ru/3.6/library/socket.html#socket.AF_ALG) – это интерфейс на основе сокетов, доступный только в Linux, для работы с криптографией ядра. Сокет алгоритма настраивается кортежем из двух-четырёх элементов `(type, name [, feat [, mask]])`, где:7071  - *type* – тип алгоритма в виде строки, напр. `aead`, `hash`, `skcipher` или `rng`.72  - *name* – имя алгоритма и режим работы в виде строки, напр. `sha256`, `hmac(sha256)`, `cbc(aes)` или `drbg_nopr_ctr_aes256`.73  - *feat* и *mask* – это 32-битные целые числа без знака.7475  Доступность: Linux 2.6.38, некоторые типы алгоритмов требуют более новых ядер.7677  Новое в версии 3.6.78- [`AF_PACKET`](https://python-all.ru/3.6/library/socket.html#socket.AF_PACKET) представляет собой низкоуровневый интерфейс для прямого доступа к сетевым устройствам. Пакеты представлены кортежем `(ifname, proto[, pkttype[, hatype[, addr]]])`, где:7980  - *ifname* – строка, задающая имя устройства.81  - *proto* – целое число в порядке байт сети, указывающее номер протокола Ethernet.82  - *pkttype* – необязательное целое число, задающее тип пакета:8384    - `PACKET_HOST` (по умолчанию) – пакет, адресованный локальному хосту.85    - `PACKET_BROADCAST` – широковещательный пакет физического уровня.86    - `PACKET_MULTIHOST` – пакет, отправленный на многоадресный адрес физического уровня.87    - `PACKET_OTHERHOST` – пакет, предназначенный другому хосту, но перехваченный драйвером устройства в неразборчивом режиме (promiscuous).88    - `PACKET_OUTGOING` – пакет, отправленный с локального хоста и возвращённый обратно на пакетный сокет.89  - *hatype* – необязательное целое число, задающее тип аппаратного адреса ARP.90  - *addr* – необязательный байтоподобный объект, задающий аппаратный физический адрес; его интерпретация зависит от устройства.9192Если в части *узел* адреса сокета IPv4/v6 указано имя узла, программа может демонстрировать недетерминированное поведение, так как Python использует первый адрес, возвращённый при разрешении DNS. Адрес сокета будет разрешаться по-разному в фактический IPv4/v6-адрес в зависимости от результатов разрешения DNS и/или конфигурации узла. Для детерминированного поведения используйте числовой адрес в части *узел*.9394Все ошибки порождают исключения. Могут возникать обычные исключения для неверных типов аргументов и нехватки памяти; начиная с Python 3.3, ошибки, связанные с семантикой сокетов или адресов, порождают [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError) или один из его подклассов (раньше они порождали [`socket.error`](https://python-all.ru/3.6/library/socket.html#socket.error)).9596Неблокирующий режим поддерживается через [`setblocking()`](https://python-all.ru/3.6/library/socket.html#socket.socket.setblocking). Его обобщение на основе тайм-аутов поддерживается через [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout).9798## 18.1.2. Содержание модуля99100Модуль [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket) экспортирует следующие элементы.101102### 18.1.2.1. Исключения103104#### `exception socket.error`105106Устаревший псевдоним [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).107108Изменено в версии 3.3: В соответствии с [**PEP 3151**](https://python-all.ru/3.6/library/socket.html) этот класс стал псевдонимом [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).109110#### `exception socket.herror`111112Подкласс [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), это исключение возникает при ошибках, связанных с адресами, т.е. для функций, использующих *h\_errno* в POSIX C API, включая [`gethostbyname_ex()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyname_ex) и [`gethostbyaddr()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyaddr). Сопутствующее значение – пара `(h_errno, string)`, представляющая ошибку, возвращённую библиотечным вызовом. *h\_errno* – числовое значение, а *строка* представляет описание *h\_errno*, возвращаемое функцией языка C `hstrerror()`.113114Изменено в версии 3.3: Этот класс стал подклассом [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).115116#### `exception socket.gaierror`117118Подкласс [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), это исключение возникает при ошибках, связанных с адресами, функциями [`getaddrinfo()`](https://python-all.ru/3.6/library/socket.html#socket.getaddrinfo) и [`getnameinfo()`](https://python-all.ru/3.6/library/socket.html#socket.getnameinfo). Сопутствующее значение – пара `(error, string)`, представляющая ошибку, возвращённую библиотечным вызовом. *строка* представляет описание *error*, возвращаемое функцией языка C `gai_strerror()`. Числовое значение *error* будет соответствовать одной из констант `EAI_*`, определённых в этом модуле.119120Изменено в версии 3.3: Этот класс стал подклассом [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).121122#### `exception socket.timeout`123124Подкласс [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), это исключение возникает при возникновении тайм-аута на сокете, для которого тайм-ауты были включены с помощью предыдущего вызова [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout) (или неявно через [`setdefaulttimeout()`](https://python-all.ru/3.6/library/socket.html#socket.setdefaulttimeout)). Сопутствующее значение – строка, которая в настоящее время всегда равна «timed out».125126Изменено в версии 3.3: Этот класс стал подклассом [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).127128### 18.1.2.2. Константы129130> Константы AF\_\* и SOCK\_\* теперь являются `AddressFamily` и `SocketKind` [`IntEnum`](https://python-all.ru/3.6/library/enum.html#enum.IntEnum) коллекциями.131>132> Новое в версии 3.4.133134#### `socket.AF_UNIX`135136#### `socket.AF_INET`137138#### `socket.AF_INET6`139140Эти константы представляют семейства адресов (и протоколов), используемые для первого аргумента [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket). Если константа [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX) не определена, то данный протокол не поддерживается. В зависимости от системы могут быть доступны дополнительные константы.141142#### `socket.SOCK_STREAM`143144#### `socket.SOCK_DGRAM`145146#### `socket.SOCK_RAW`147148#### `socket.SOCK_RDM`149150#### `socket.SOCK_SEQPACKET`151152Эти константы представляют типы сокетов, которые используются для второго аргумента [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket). В зависимости от системы могут быть доступны и другие константы. (Обычно полезны только [`SOCK_STREAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_STREAM) и [`SOCK_DGRAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_DGRAM).)153154#### `socket.SOCK_CLOEXEC`155156#### `socket.SOCK_NONBLOCK`157158Эти две константы, если они определены, можно комбинировать с типами сокетов, что позволяет устанавливать некоторые флаги атомарно (тем самым избегая возможных состояний гонки и необходимости отдельных вызовов).159160> **См. также**161>162> [Безопасная обработка файловых дескрипторов](https://python-all.ru/3.6/library/socket.html) для более подробного объяснения.163164Доступность: Linux \>= 2.6.27.165166Новое в версии 3.2.167168#### `SO_*`169170#### `socket.SOMAXCONN`171172#### `MSG_*`173174#### `SOL_*`175176#### `SCM_*`177178#### `IPPROTO_*`179180#### `IPPORT_*`181182#### `INADDR_*`183184#### `IP_*`185186#### `IPV6_*`187188#### `EAI_*`189190#### `AI_*`191192#### `NI_*`193194#### `TCP_*`195196Многие константы этих форм, описанные в документации Unix по сокетам и/или протоколу IP, также определены в модуле socket. Они обычно используются в аргументах методов `setsockopt()` и `getsockopt()` объектов сокетов. В большинстве случаев определены только те символы, которые есть в заголовочных файлах Unix; для некоторых символов предоставлены значения по умолчанию.197198Изменено в версии 3.6: добавлены `SO_DOMAIN`, `SO_PROTOCOL`, `SO_PEERSEC`, `SO_PASSSEC`, `TCP_USER_TIMEOUT`, `TCP_CONGESTION`.199200Изменено в версии 3.6.5: В Windows `TCP_FASTOPEN`, `TCP_KEEPCNT` появляются, если среда выполнения Windows поддерживает.201202#### `socket.AF_CAN`203204#### `socket.PF_CAN`205206#### `SOL_CAN_*`207208#### `CAN_*`209210Множество констант такого вида, описанных в документации Linux, также определены в модуле socket.211212Доступность: Linux \>= 2.6.25.213214Новое в версии 3.3.215216#### `socket.CAN_BCM`217218#### `CAN_BCM_*`219220CAN\_BCM в семействе протоколов CAN – это протокол broadcast manager (BCM). Константы broadcast manager, описанные в документации Linux, также определены в модуле socket.221222Доступность: Linux \>= 2.6.25.223224Новое в версии 3.4.225226#### `socket.CAN_RAW_FD_FRAMES`227228Включает поддержку CAN FD в сокете CAN\_RAW. По умолчанию отключено. Это позволяет вашему приложению отправлять как CAN, так и CAN FD кадры; однако, при чтении из сокета необходимо принимать как CAN, так и CAN FD кадры.229230Эта константа описана в документации Linux.231232Доступность: Linux \>= 3.6.233234Новое в версии 3.5.235236#### `socket.AF_PACKET`237238#### `socket.PF_PACKET`239240#### `PACKET_*`241242Множество констант такого вида, описанных в документации Linux, также определены в модуле socket.243244Доступность: Linux \>= 2.2.245246#### `socket.AF_RDS`247248#### `socket.PF_RDS`249250#### `socket.SOL_RDS`251252#### `RDS_*`253254Множество констант такого вида, описанных в документации Linux, также определены в модуле socket.255256Доступность: Linux \>= 2.6.30.257258Новое в версии 3.3.259260#### `socket.SIO_RCVALL`261262#### `socket.SIO_KEEPALIVE_VALS`263264#### `socket.SIO_LOOPBACK_FAST_PATH`265266#### `RCVALL_*`267268Константы для Windows’ WSAIoctl(). Эти константы используются в качестве аргументов метода [`ioctl()`](https://python-all.ru/3.6/library/socket.html#socket.socket.ioctl) объектов сокетов.269270Изменено в версии 3.6: добавлен `SIO_LOOPBACK_FAST_PATH`.271272#### `TIPC_*`273274Константы, связанные с TIPC, соответствующие тем, что экспортируются C API сокетов. Дополнительную информацию см. в документации TIPC.275276#### `socket.AF_ALG`277278#### `socket.SOL_ALG`279280#### `ALG_*`281282Константы для криптографии ядра Linux.283284Доступность: Linux \>= 2.6.38.285286Новое в версии 3.6.287288#### `socket.AF_LINK`289290Доступность: BSD, OSX.291292Новое в версии 3.4.293294#### `socket.has_ipv6`295296Эта константа содержит логическое значение, указывающее, поддерживается ли IPv6 на данной платформе.297298#### `socket.BDADDR_ANY`299300#### `socket.BDADDR_LOCAL`301302Это строковые константы, содержащие Bluetooth-адреса со специальным значением. Например, [`BDADDR_ANY`](https://python-all.ru/3.6/library/socket.html#socket.BDADDR_ANY) можно использовать для указания любого адреса при задании сокета привязки с помощью `BTPROTO_RFCOMM`.303304#### `socket.HCI_FILTER`305306#### `socket.HCI_TIME_STAMP`307308#### `socket.HCI_DATA_DIR`309310Для использования с `BTPROTO_HCI`. [`HCI_FILTER`](https://python-all.ru/3.6/library/socket.html#socket.HCI_FILTER) недоступен в NetBSD или DragonFlyBSD. [`HCI_TIME_STAMP`](https://python-all.ru/3.6/library/socket.html#socket.HCI_TIME_STAMP) и [`HCI_DATA_DIR`](https://python-all.ru/3.6/library/socket.html#socket.HCI_DATA_DIR) недоступны в FreeBSD, NetBSD или DragonFlyBSD.311312### 18.1.2.3. Функции313314#### 18.1.2.3.1. Создание сокетов315316Все следующие функции создают [объекты сокетов](https://python-all.ru/3.6/library/socket.html#socket-objects).317318#### `socket.socket(family=AF_INET, type=SOCK_STREAM, proto=0, fileno=None)`319320Создает новый сокет с указанным семейством адресов, типом сокета и номером протокола. Семейство адресов должно быть [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET) (по умолчанию), [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6), [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX), [`AF_CAN`](https://python-all.ru/3.6/library/socket.html#socket.AF_CAN), [`AF_PACKET`](https://python-all.ru/3.6/library/socket.html#socket.AF_PACKET) или [`AF_RDS`](https://python-all.ru/3.6/library/socket.html#socket.AF_RDS). Тип сокета должен быть [`SOCK_STREAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_STREAM) (по умолчанию), [`SOCK_DGRAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_DGRAM), [`SOCK_RAW`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_RAW) или, возможно, одной из других констант `SOCK_`. Номер протокола обычно равен нулю и может быть опущен или, в случае, когда семейство адресов [`AF_CAN`](https://python-all.ru/3.6/library/socket.html#socket.AF_CAN), протокол должен быть `CAN_RAW` или [`CAN_BCM`](https://python-all.ru/3.6/library/socket.html#socket.CAN_BCM). Если указан *fileno*, остальные аргументы игнорируются, и возвращается сокет с заданным файловым дескриптором. В отличие от [`socket.fromfd()`](https://python-all.ru/3.6/library/socket.html#socket.fromfd), *fileno* вернет тот же сокет, а не его копию. Это может помочь закрыть отсоединенный сокет с помощью [`socket.close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close).321322Новый созданный сокет [ненаследуемый](https://python-all.ru/3.6/library/os.html#fd-inheritance).323324Изменено в версии 3.3: Добавлено семейство AF\_CAN. Добавлено семейство AF\_RDS.325326Изменено в версии 3.4: Добавлен протокол CAN\_BCM.327328Изменено в версии 3.4: Возвращаемый сокет теперь ненаследуемый.329330#### `socket.socketpair([family[, type[, proto]]])`331332Создаёт пару связанных объектов сокетов, используя заданное семейство адресов, тип сокета и номер протокола. Семейство адресов, тип сокета и номер протокола те же, что и для функции [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket) выше. Семейство по умолчанию – [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX), если оно определено на платформе; в противном случае по умолчанию используется [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET).333334Новые созданные сокеты [ненаследуемые](https://python-all.ru/3.6/library/os.html#fd-inheritance).335336Изменено в версии 3.2: Возвращаемые объекты сокетов теперь поддерживают полный API сокетов, а не подмножество.337338Изменено в версии 3.4: Возвращаемые сокеты теперь являются ненаследуемыми.339340Изменено в версии 3.5: Добавлена поддержка Windows.341342#### `socket.create_connection(address[, timeout[, source_address]])`343344Подключается к TCP-службе, прослушивающей *адрес* в интернете (кортеж из двух элементов `(host, port)`), и возвращает объект сокета. Это функция более высокого уровня, чем [`socket.connect()`](https://python-all.ru/3.6/library/socket.html#socket.socket.connect): если *host* – нечисловое имя узла, он будет пытаться разрешить его как для [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET), так и для [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6), а затем пытаться подключаться ко всем возможным адресам по очереди, пока подключение не установится. Это упрощает написание клиентов, совместимых как с IPv4, так и с IPv6.345346Передача необязательного параметра *timeout* установит тайм-аут для экземпляра сокета перед попыткой подключения. Если *timeout* не указан, используется глобальная настройка тайм-аута по умолчанию, возвращаемая [`getdefaulttimeout()`](https://python-all.ru/3.6/library/socket.html#socket.getdefaulttimeout).347348Если указан, *source\_address* должен быть кортежем из двух элементов `(host, port)`, к которому сокет должен привязаться как к своему исходному адресу перед подключением. Если хост или порт равны '' или 0 соответственно, будет использовано поведение ОС по умолчанию.349350Изменено в версии 3.2: Добавлен параметр *source\_address*.351352#### `socket.fromfd(fd, family, type, proto=0)`353354Дублирует файловый дескриптор *fd* (целое число, возвращаемое методом `fileno()` объекта файла) и создаёт объект сокета из результата. Семейство адресов, тип сокета и номер протокола такие же, как для функции [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket) выше. Файловый дескриптор должен указывать на сокет, но это не проверяется – последующие операции с объектом могут завершиться ошибкой, если файловый дескриптор некорректен. Эта функция требуется редко, но может использоваться для получения или установки параметров сокета, переданного программе как стандартный ввод или вывод (например, сервер, запущенный демоном inet в Unix). Предполагается, что сокет находится в блокирующем режиме.355356Новый созданный сокет [ненаследуемый](https://python-all.ru/3.6/library/os.html#fd-inheritance).357358Изменено в версии 3.4: Возвращаемый сокет теперь ненаследуемый.359360#### `socket.fromshare(data)`361362Создаёт экземпляр сокета из данных, полученных из метода [`socket.share()`](https://python-all.ru/3.6/library/socket.html#socket.socket.share). Предполагается, что сокет находится в блокирующем режиме.363364Доступность: Windows.365366Новое в версии 3.3.367368#### `socket.SocketType`369370Это объект типа Python, представляющий тип объекта сокета. Он аналогичен `type(socket(...))`.371372#### 18.1.2.3.2. Другие функции373374Модуль [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket) также предоставляет различные сетевые службы:375376#### `socket.getaddrinfo(host, port, family=0, type=0, proto=0, flags=0)`377378Преобразует аргументы *host*/*port* в последовательность кортежей из 5 элементов, содержащих все необходимые аргументы для создания сокета, подключенного к этому сервису. *host* – это доменное имя, строковое представление IPv4/v6-адреса или `None`. *port* – это строковое имя службы, такое как `'http'`, числовой номер порта или `None`. Передавая `None` в качестве значения *host* и *port*, можно передать `NULL` в базовый C API.379380Аргументы *family*, *type* и *proto* можно указать необязательно, чтобы сузить список возвращаемых адресов. Передача нуля в качестве значения каждого из этих аргументов выбирает полный диапазон результатов. Аргумент *flags* может быть одной или несколькими константами из `AI_*` и будет влиять на то, как вычисляются и возвращаются результаты. Например, `AI_NUMERICHOST` отключит разрешение доменных имён и вызовет исключение, если *host* является доменным именем.381382Функция возвращает список кортежей из 5 элементов со следующей структурой:383384`(family, type, proto, canonname, sockaddr)`385386В этих кортежах *family*, *type*, *proto* – целые числа, предназначенные для передачи в функцию [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket). *canonname* будет строкой, представляющей каноническое имя *хоста*, если `AI_CANONNAME` является частью аргумента *flags*; в противном случае *canonname* будет пустым. *sockaddr* – это кортеж, описывающий адрес сокета, формат которого зависит от возвращённого *family* (`(address, port)` 2-кортеж для [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET), `(address, port, flow info, scope id)` 4-кортеж для [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6)) и предназначен для передачи в метод [`socket.connect()`](https://python-all.ru/3.6/library/socket.html#socket.socket.connect).387388В следующем примере получается информация об адресе для гипотетического TCP-подключения к `example.org` на порту 80 (результаты могут отличаться на вашей системе, если IPv6 не включён):389390```python391>>> socket.getaddrinfo("example.org", 80, proto=socket.IPPROTO_TCP)392[(<AddressFamily.AF_INET6: 10>, <SocketType.SOCK_STREAM: 1>,393 6, '', ('2606:2800:220:1:248:1893:25c8:1946', 80, 0, 0)),394 (<AddressFamily.AF_INET: 2>, <SocketType.SOCK_STREAM: 1>,395 6, '', ('93.184.216.34', 80))]396```397398Изменено в версии 3.2: теперь параметры можно передавать в виде именованных аргументов.399400#### `socket.getfqdn([name])`401402Возвращает полностью определённое доменное имя для *name*. Если *name* опущен или пуст, он интерпретируется как локальный хост. Для поиска полного имени сначала проверяется имя хоста, возвращаемое [`gethostbyaddr()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyaddr), затем, если доступны, псевдонимы хоста. Выбирается первое имя, содержащее точку. Если полностью определённое доменное имя недоступно, возвращается имя хоста, полученное от [`gethostname()`](https://python-all.ru/3.6/library/socket.html#socket.gethostname).403404#### `socket.gethostbyname(hostname)`405406Преобразует имя хоста в формат IPv4-адреса. IPv4-адрес возвращается в виде строки, например `'100.50.200.5'`. Если имя хоста само является IPv4-адресом, оно возвращается без изменений. См. [`gethostbyname_ex()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyname_ex) для более полного интерфейса. [`gethostbyname()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyname) не поддерживает разрешение имён IPv6, вместо него для поддержки двойного стека IPv4/v6 следует использовать [`getaddrinfo()`](https://python-all.ru/3.6/library/socket.html#socket.getaddrinfo).407408#### `socket.gethostbyname_ex(hostname)`409410Преобразует имя хоста в формат IPv4-адреса (расширенный интерфейс). Возвращает тройку `(hostname, aliaslist, ipaddrlist)`, где *hostname* – основное имя хоста, отвечающее на заданный *ip\_address*; *aliaslist* – (возможно пустой) список альтернативных имён хоста для того же адреса; и *ipaddrlist* – список IPv4-адресов для того же интерфейса на том же хосте (часто, но не всегда, один адрес). [`gethostbyname_ex()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyname_ex) не поддерживает разрешение имён IPv6, а для поддержки IPv4/IPv6 двойного стека следует использовать [`getaddrinfo()`](https://python-all.ru/3.6/library/socket.html#socket.getaddrinfo).411412#### `socket.gethostname()`413414Возвращает строку, содержащую имя хоста машины, на которой в данный момент выполняется интерпретатор Python.415416Примечание: [`gethostname()`](https://python-all.ru/3.6/library/socket.html#socket.gethostname) не всегда возвращает полное доменное имя; для этого используйте [`getfqdn()`](https://python-all.ru/3.6/library/socket.html#socket.getfqdn).417418#### `socket.gethostbyaddr(ip_address)`419420Возвращает кортеж `(hostname, aliaslist, ipaddrlist)`, где *hostname* – это основное имя хоста, соответствующее заданному *ip\_address*, *aliaslist* – (возможно пустой) список альтернативных имён хоста для того же адреса, а *ipaddrlist* – список IPv4/v6-адресов для того же интерфейса на том же хосте (скорее всего, содержащий только один адрес). Чтобы найти полностью определённое доменное имя, используйте функцию [`getfqdn()`](https://python-all.ru/3.6/library/socket.html#socket.getfqdn). [`gethostbyaddr()`](https://python-all.ru/3.6/library/socket.html#socket.gethostbyaddr) поддерживает как IPv4, так и IPv6.421422#### `socket.getnameinfo(sockaddr, flags)`423424Преобразует адрес сокета *sockaddr* в кортеж из двух элементов `(host, port)`. В зависимости от настроек *flags* результат может содержать полное доменное имя или числовое представление адреса в *host*. Аналогично, *port* может содержать строковое имя порта или числовой номер порта.425426#### `socket.getprotobyname(protocolname)`427428Преобразует имя интернет-протокола (например, `'icmp'`) в константу, пригодную для передачи в качестве (необязательного) третьего аргумента функции [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket). Обычно это требуется только для сокетов, открытых в «сыром» режиме ([`SOCK_RAW`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_RAW)); для обычных режимов сокетов правильный протокол выбирается автоматически, если протокол опущен или равен нулю.429430#### `socket.getservbyname(servicename[, protocolname])`431432Преобразует имя интернет-службы и имя протокола в номер порта для этой службы. Необязательное имя протокола, если указано, должно быть `'tcp'` или `'udp'`, в противном случае подойдет любой протокол.433434#### `socket.getservbyport(port[, protocolname])`435436Преобразует номер порта интернет-службы и имя протокола в имя службы для этой службы. Необязательное имя протокола, если указано, должно быть `'tcp'` или `'udp'`, в противном случае подойдет любой протокол.437438#### `socket.ntohl(x)`439440Преобразует 32-битные положительные целые числа из сетевого порядка байтов в порядок байтов хоста. На машинах, где порядок байтов хоста совпадает с сетевым, эта операция ничего не делает; в противном случае выполняется перестановка 4 байтов.441442#### `socket.ntohs(x)`443444Преобразует 16-битные положительные целые числа из сетевого порядка байтов в порядок байтов хоста. На машинах, где порядок байтов хоста совпадает с сетевым, эта функция ничего не делает; в противном случае она выполняет обмен двух байтов.445446#### `socket.htonl(x)`447448Преобразует 32-битные положительные целые числа из порядка байтов хоста в сетевой порядок. На машинах, где порядок байтов хоста совпадает с сетевым, эта функция ничего не делает; в противном случае она выполняет обмен четырёх байтов.449450#### `socket.htons(x)`451452Преобразует 16-битные положительные целые числа из порядка байтов хоста в сетевой порядок. На машинах, где порядок байтов хоста совпадает с сетевым, эта функция ничего не делает; в противном случае она выполняет обмен двух байтов.453454#### `socket.inet_aton(ip_string)`455456Преобразует IPv4-адрес из строкового формата с точками (например, ‘123.45.67.89’) в 32-битный упакованный двоичный формат в виде объекта bytes длиной четыре символа. Это полезно при взаимодействии с программой, использующей стандартную библиотеку C и требующей объекты типа `struct in_addr`, который является C-типом для 32-битного упакованного двоичного представления, возвращаемого этой функцией.457458[`inet_aton()`](https://python-all.ru/3.6/library/socket.html#socket.inet_aton) также принимает строки с менее чем тремя точками; подробнее см. на странице руководства Unix *inet(3)*.459460Если переданная функции строка IPv4-адреса недопустима, будет возбуждено [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError). Обратите внимание: что именно считается допустимым, зависит от нижележащей C-реализации `inet_aton()`.461462[`inet_aton()`](https://python-all.ru/3.6/library/socket.html#socket.inet_aton) не поддерживает IPv6; для поддержки двойного стека IPv4/IPv6 следует использовать [`inet_pton()`](https://python-all.ru/3.6/library/socket.html#socket.inet_pton).463464#### `socket.inet_ntoa(packed_ip)`465466Преобразует 32-битный упакованный IPv4-адрес ([объект, подобный bytes](https://python-all.ru/3.6/glossary.html#term-bytes-like-object) длиной четыре байта) в стандартное строковое представление с точками (например, ‘123.45.67.89’). Это полезно при взаимодействии с программой, использующей стандартную библиотеку C и требующей объекты типа `struct in_addr`, который является C-типом для 32-битных упакованных двоичных данных, принимаемых этой функцией в качестве аргумента.467468Если переданная функции последовательность байтов имеет длину не ровно 4 байта, будет возбуждено [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError). [`inet_ntoa()`](https://python-all.ru/3.6/library/socket.html#socket.inet_ntoa) не поддерживает IPv6; для поддержки двойного стека IPv4/IPv6 следует использовать [`inet_ntop()`](https://python-all.ru/3.6/library/socket.html#socket.inet_ntop).469470Изменено в версии 3.5: Теперь принимается записываемый [байтоподобный объект](https://python-all.ru/3.6/glossary.html#term-bytes-like-object).471472#### `socket.inet_pton(address_family, ip_string)`473474Преобразует IP-адрес из строкового формата, специфичного для семейства адресов, в упакованный двоичный формат. [`inet_pton()`](https://python-all.ru/3.6/library/socket.html#socket.inet_pton) полезен, когда библиотека или сетевой протокол требует объект типа `struct in_addr` (аналогично [`inet_aton()`](https://python-all.ru/3.6/library/socket.html#socket.inet_aton)) или `struct in6_addr`.475476В настоящее время поддерживаемые значения для *address\_family*: [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET) и [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6). Если строка IP-адреса *ip\_string* недопустима, будет возбуждено [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError). Обратите внимание: что именно считается допустимым, зависит как от значения *address\_family*, так и от нижележащей реализации `inet_pton()`.477478Доступность: Unix (возможно, не все платформы), Windows.479480Изменено в версии 3.4: Добавлена поддержка Windows481482#### `socket.inet_ntop(address_family, packed_ip)`483484Преобразует упакованный IP-адрес ([объект, подобный bytes](https://python-all.ru/3.6/glossary.html#term-bytes-like-object) некоторой длины) в стандартное строковое представление, специфичное для семейства адресов (например, `'7.10.0.5'` или `'5aef:2b::8'`). [`inet_ntop()`](https://python-all.ru/3.6/library/socket.html#socket.inet_ntop) полезен, когда библиотека или сетевой протокол возвращает объект типа `struct in_addr` (аналогично [`inet_ntoa()`](https://python-all.ru/3.6/library/socket.html#socket.inet_ntoa)) или `struct in6_addr`.485486В настоящее время поддерживаемые значения для *address\_family*: [`AF_INET`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET) и [`AF_INET6`](https://python-all.ru/3.6/library/socket.html#socket.AF_INET6). Если объект bytes *packed\_ip* имеет неправильную длину для указанного семейства адресов, будет возбуждено [`ValueError`](https://python-all.ru/3.6/library/exceptions.html#ValueError). [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError) возбуждается при ошибках вызова [`inet_ntop()`](https://python-all.ru/3.6/library/socket.html#socket.inet_ntop).487488Доступность: Unix (возможно, не все платформы), Windows.489490Изменено в версии 3.4: Добавлена поддержка Windows491492Изменено в версии 3.5: Теперь принимается записываемый [байтоподобный объект](https://python-all.ru/3.6/glossary.html#term-bytes-like-object).493494#### `socket.CMSG_LEN(length)`495496Return 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 [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) to receive a single item of ancillary data, but [**RFC 3542**](https://python-all.ru/3.6/library/socket.html) requires portable applications to use [`CMSG_SPACE()`](https://python-all.ru/3.6/library/socket.html#socket.CMSG_SPACE) and thus include space for padding, even when the item will be the last in the buffer. Raises [`OverflowError`](https://python-all.ru/3.6/library/exceptions.html#OverflowError) if *length* is outside the permissible range of values.497498Доступность: большинство платформ Unix, возможно, и другие.499500Новое в версии 3.3.501502#### `socket.CMSG_SPACE(length)`503504Возвращает размер буфера, необходимый для [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) для приёма одного вспомогательного элемента данных с соответствующими данными заданной *length*, включая любое завершающее выравнивание. Пространство буфера, необходимое для приёма нескольких элементов, представляет собой сумму значений [`CMSG_SPACE()`](https://python-all.ru/3.6/library/socket.html#socket.CMSG_SPACE) для длин их соответствующих данных. Возбуждает [`OverflowError`](https://python-all.ru/3.6/library/exceptions.html#OverflowError), если *length* выходит за допустимый диапазон значений.505506Обратите внимание, что некоторые системы могут поддерживать вспомогательные данные, не предоставляя эту функцию. Также обратите внимание, что установка размера буфера с использованием результатов этой функции может не точно ограничить объём принимаемых вспомогательных данных, поскольку дополнительные данные могут поместиться в область выравнивания.507508Доступность: большинство платформ Unix, возможно, и другие.509510Новое в версии 3.3.511512#### `socket.getdefaulttimeout()`513514Возвращает тайм-аут по умолчанию в секундах (число с плавающей запятой) для новых объектов сокетов. Значение `None` означает, что новые объекты сокетов не имеют тайм-аута. При первом импорте модуля socket значение по умолчанию равно `None`.515516#### `socket.setdefaulttimeout(timeout)`517518Устанавливает тайм-аут по умолчанию в секундах (число с плавающей точкой) для новых объектов сокета. При первом импорте модуля socket значением по умолчанию является `None`. Возможные значения и их смысл описаны в [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout).519520#### `socket.sethostname(name)`521522Устанавливает имя узла (hostname) машины равным *name*. Если прав недостаточно, будет возбуждено исключение [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError).523524Доступность: Unix.525526Новое в версии 3.3.527528#### `socket.if_nameindex()`529530Возвращает список кортежей с информацией о сетевых интерфейсах (индекс в виде целого числа, имя в виде строки). [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError) в случае неудачного системного вызова.531532Доступность: Unix.533534Новое в версии 3.3.535536#### `socket.if_nametoindex(if_name)`537538Возвращает номер индекса сетевого интерфейса, соответствующий имени интерфейса. [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), если интерфейс с таким именем не существует.539540Доступность: Unix.541542Новое в версии 3.3.543544#### `socket.if_indextoname(if_index)`545546Возвращает имя сетевого интерфейса, соответствующее номеру индекса интерфейса. [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError), если интерфейс с таким индексом не существует.547548Доступность: Unix.549550Новое в версии 3.3.551552## 18.1.3. Сокетные объекты553554Объекты сокетов имеют следующие методы. За исключением [`makefile()`](https://python-all.ru/3.6/library/socket.html#socket.socket.makefile), они соответствуют системным вызовам Unix, применимым к сокетам.555556Изменено в версии 3.2: Добавлена поддержка протокола [менеджера контекста](https://python-all.ru/3.6/glossary.html#term-context-manager). Выход из менеджера контекста эквивалентен вызову [`close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close).557558#### `socket.accept()`559560Принимает соединение. Сокет должен быть привязан к адресу и находиться в режиме прослушивания. Возвращаемое значение – пара `(conn, address)`, где *conn* – это *новый* объект сокета, пригодный для отправки и получения данных по соединению, а *address* – адрес, привязанный к сокету на другом конце соединения.561562Новый созданный сокет [ненаследуемый](https://python-all.ru/3.6/library/os.html#fd-inheritance).563564Изменено в версии 3.4: Сокет теперь ненаследуемый.565566Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).567568#### `socket.bind(address)`569570Привязывает сокет к *address*. Сокет не должен быть уже привязан. (Формат *address* зависит от семейства адресов – см. выше.)571572#### `socket.close()`573574Помечает сокет как закрытый. Базовый системный ресурс (например, файловый дескриптор) также закрывается, когда все файловые объекты из [`makefile()`](https://python-all.ru/3.6/library/socket.html#socket.socket.makefile) будут закрыты. Как только это происходит, все последующие операции с объектом сокета будут завершаться ошибкой. Удалённая сторона больше не получит данных (после сброса поставленных в очередь данных).575576Сокеты автоматически закрываются при сборке мусора, но рекомендуется явно [`close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close) их закрывать или использовать оператор [`with`](https://python-all.ru/3.6/reference/compound_stmts.html#with) вокруг них.577578Изменено в версии 3.6: Теперь [`OSError`](https://python-all.ru/3.6/library/exceptions.html#OSError) возбуждается, если при выполнении `close()` возникает ошибка.579580> **Примечание**581>582> [`close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close) освобождает ресурс, связанный с соединением, но не обязательно немедленно закрывает соединение. Если требуется своевременно закрыть соединение, вызовите [`shutdown()`](https://python-all.ru/3.6/library/socket.html#socket.socket.shutdown) перед [`close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close).583584#### `socket.connect(address)`585586Подключается к удалённому сокету по адресу *address*. (Формат *address* зависит от семейства адресов – см. выше.)587588Если соединение прерывается сигналом, метод ожидает его завершения или вызывает исключение [`socket.timeout`](https://python-all.ru/3.6/library/socket.html#socket.timeout) по таймауту, если обработчик сигнала не возбуждает исключение, а сокет является блокирующим или имеет таймаут. Для неблокирующих сокетов метод вызывает исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError), если соединение прерывается сигналом (или исключение, возбуждённое обработчиком сигнала).589590Изменено в версии 3.5: Теперь метод ждёт завершения соединения вместо возбуждения исключения [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError), если соединение прервано сигналом, обработчик сигнала не вызывает исключение, а сокет является блокирующим или имеет тайм-аут (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).591592#### `socket.connect_ex(address)`593594Как и `connect(address)`, но возвращает индикатор ошибки вместо возбуждения исключения для ошибок, возвращаемых вызовом `connect()` на уровне C (другие проблемы, например «хост не найден», по-прежнему могут вызывать исключения). Индикатор ошибки равен `0`, если операция выполнена успешно, в противном случае – значению переменной `errno`. Это удобно, например, для поддержки асинхронных подключений.595596#### `socket.detach()`597598Переводит объект сокета в закрытое состояние без фактического закрытия базового файлового дескриптора. Файловый дескриптор возвращается и может быть повторно использован для других целей.599600Новое в версии 3.2.601602#### `socket.dup()`603604Дублирует сокет.605606Новый созданный сокет [ненаследуемый](https://python-all.ru/3.6/library/os.html#fd-inheritance).607608Изменено в версии 3.4: Сокет теперь ненаследуемый.609610#### `socket.fileno()`611612Возвращает файловый дескриптор сокета (небольшое целое число) или -1 в случае ошибки. Это полезно с [`select.select()`](https://python-all.ru/3.6/library/select.html#select.select).613614В Windows небольшое целое число, возвращаемое этим методом, нельзя использовать там, где может быть использован файловый дескриптор (например, [`os.fdopen()`](https://python-all.ru/3.6/library/os.html#os.fdopen)). В Unix такого ограничения нет.615616#### `socket.get_inheritable()`617618Получить [наследуемый флаг](https://python-all.ru/3.6/library/os.html#fd-inheritance) файлового дескриптора сокета или handle сокета: `True`, если сокет может наследоваться в дочерних процессах, `False`, если не может.619620Новое в версии 3.4.621622#### `socket.getpeername()`623624Возвращает удалённый адрес, к которому подключён сокет. Это полезно, например, для определения номера порта удалённого сокета IPv4/v6. (Формат возвращаемого адреса зависит от семейства адресов – см. выше.) На некоторых системах эта функция не поддерживается.625626#### `socket.getsockname()`627628Возвращает собственный адрес сокета. Это полезно, например, для определения номера порта сокета IPv4/v6. (Формат возвращаемого адреса зависит от семейства адресов – см. выше.)629630#### `socket.getsockopt(level, optname[, buflen])`631632Возвращает значение указанной опции сокета (см. страницу руководства Unix *getsockopt(2)*). Необходимые символьные константы (`SO_*` и т.д.) определены в этом модуле. Если *buflen* отсутствует, предполагается целочисленная опция и функция возвращает её целочисленное значение. Если *buflen* присутствует, он задаёт максимальную длину буфера для получения опции, и этот буфер возвращается в виде объекта bytes. Вызывающий код должен сам декодировать содержимое буфера (см. опциональный встроенный модуль [`struct`](https://python-all.ru/3.6/library/struct.html#module-struct) для способа декодирования структур C, закодированных как строки байтов).633634#### `socket.gettimeout()`635636Возвращает тайм-аут в секундах (число с плавающей точкой), связанный с операциями сокета, или `None`, если тайм-аут не установлен. Это отражает последний вызов [`setblocking()`](https://python-all.ru/3.6/library/socket.html#socket.socket.setblocking) или [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout).637638#### `socket.ioctl(control, option)`639640**Платформа**641642Windows643644Метод [`ioctl()`](https://python-all.ru/3.6/library/socket.html#socket.socket.ioctl) является ограниченным интерфейсом к системному интерфейсу WSAIoctl. За дополнительной информацией обратитесь к [документации Win32](https://python-all.ru/3.6/library/socket.html).645646На других платформах можно использовать общие функции [`fcntl.fcntl()`](https://python-all.ru/3.6/library/fcntl.html#fcntl.fcntl) и [`fcntl.ioctl()`](https://python-all.ru/3.6/library/fcntl.html#fcntl.ioctl); они принимают объект сокета в качестве первого аргумента.647648В настоящее время поддерживаются только следующие управляющие коды: `SIO_RCVALL`, `SIO_KEEPALIVE_VALS` и `SIO_LOOPBACK_FAST_PATH`.649650Изменено в версии 3.6: добавлен `SIO_LOOPBACK_FAST_PATH`.651652#### `socket.listen([backlog])`653654Включает возможность сервера принимать соединения. Если указан *backlog*, он должен быть не менее 0 (если меньше, устанавливается в 0); он задаёт количество непринятых соединений, которые система разрешит до отказа в новых соединениях. Если не указан, выбирается разумное значение по умолчанию.655656Изменено в версии 3.5: Параметр *backlog* теперь необязателен.657658#### `socket.makefile(mode='r', buffering=None, *, encoding=None, errors=None, newline=None)`659660Возвращает [файловый объект](https://python-all.ru/3.6/glossary.html#term-file-object), связанный с сокетом. Точный возвращаемый тип зависит от аргументов, переданных в [`makefile()`](https://python-all.ru/3.6/library/socket.html#socket.socket.makefile). Эти аргументы интерпретируются так же, как и встроенной функцией [`open()`](https://python-all.ru/3.6/library/functions.html#open), за исключением того, что единственные поддерживаемые значения *режима* – `'r'` (по умолчанию), `'w'` и `'b'`.661662Сокет должен быть в блокирующем режиме; можно установить тайм-аут, но при его срабатывании внутренний буфер файлового объекта может оказаться в несогласованном состоянии.663664Закрытие файлового объекта, возвращённого [`makefile()`](https://python-all.ru/3.6/library/socket.html#socket.socket.makefile), не закроет исходный сокет, если только все остальные файловые объекты не будут закрыты и для объекта сокета не будет вызван [`socket.close()`](https://python-all.ru/3.6/library/socket.html#socket.socket.close).665666> **Примечание**667>668> В Windows файлоподобный объект, созданный [`makefile()`](https://python-all.ru/3.6/library/socket.html#socket.socket.makefile), нельзя использовать там, где ожидается файловый объект с дескриптором файла, например, в аргументах потока [`subprocess.Popen()`](https://python-all.ru/3.6/library/subprocess.html#subprocess.Popen).669670#### `socket.recv(bufsize[, flags])`671672Получает данные из сокета. Возвращает объект bytes с полученными данными. Максимальный объём данных за одно получение задаётся параметром *bufsize*. Значение необязательного аргумента *flags* описано на странице руководства Unix *recv(2)*; по умолчанию он равен нулю.673674> **Примечание**675>676> Для наилучшего соответствия реальным характеристикам оборудования и сети значение *bufsize* должно быть относительно небольшой степенью двойки, например, 4096.677678Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).679680#### `socket.recvfrom(bufsize[, flags])`681682Получает данные из сокета. Возвращает пару `(bytes, address)`, где *bytes* – объект bytes с полученными данными, а *address* – адрес сокета, отправившего данные. Значение необязательного аргумента *flags* описано на странице руководства Unix *recv(2)*; по умолчанию он равен нулю. (Формат *address* зависит от семейства адресов – см. выше.)683684Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).685686#### `socket.recvmsg(bufsize[, ancbufsize[, flags]])`687688Принимает обычные данные (до *bufsize* байт) и вспомогательные данные из сокета. Аргумент *ancbufsize* задаёт размер внутреннего буфера для приёма вспомогательных данных в байтах; по умолчанию равен 0, то есть вспомогательные данные приниматься не будут. Подходящие размеры буфера для вспомогательных данных можно вычислить с помощью [`CMSG_SPACE()`](https://python-all.ru/3.6/library/socket.html#socket.CMSG_SPACE) или [`CMSG_LEN()`](https://python-all.ru/3.6/library/socket.html#socket.CMSG_LEN); данные, не помещающиеся в буфер, могут быть усечены или отброшены. Аргумент *flags* по умолчанию равен 0 и имеет тот же смысл, что и для [`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv).689690Возвращаемое значение – кортеж из 4 элементов: `(data, ancdata, msg_flags, address)`. Элемент *data* – это объект [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes), содержащий принятые невспомогательные данные. Элемент *ancdata* – это список из нуля или более кортежей `(cmsg_level, cmsg_type, cmsg_data)`, представляющих принятые вспомогательные данные (управляющие сообщения): *cmsg\_level* и *cmsg\_type* – целые числа, задающие уровень протокола и тип протокола соответственно, а *cmsg\_data* – объект [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes) с соответствующими данными. Элемент *msg\_flags* – побитовое ИЛИ различных флагов, указывающих на состояние принятого сообщения; подробнее см. в системной документации. Если принимающий сокет не подключён, *address* – это адрес отправляющего сокета (если доступен); в противном случае его значение не определено.691692В некоторых системах [`sendmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.sendmsg) и [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) можно использовать для передачи файловых дескрипторов между процессами через [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX)-сокет. Когда этот механизм используется (он часто ограничен [`SOCK_STREAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_STREAM)-сокетами), [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) вернет во вспомогательных данных элементы вида `(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)`, где *fds* – это объект [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes), представляющий новые файловые дескрипторы в виде двоичного массива нативного типа C `int`. Если [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) возбуждает исключение после возврата системного вызова, он сначала попытается закрыть все файловые дескрипторы, полученные через этот механизм.693694Некоторые системы не указывают усечённую длину частично принятых вспомогательных данных. Если элемент, по-видимому, выходит за конец буфера, [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg) выдаст [`RuntimeWarning`](https://python-all.ru/3.6/library/exceptions.html#RuntimeWarning) и вернёт ту его часть, которая находится в буфере, при условии, что она не была усечена до начала соответствующих данных.695696В системах, поддерживающих механизм `SCM_RIGHTS`, следующая функция будет принимать до *maxfds* файловых дескрипторов, возвращая данные сообщения и список, содержащий дескрипторы (игнорируя неожиданные ситуации, такие как приём посторонних управляющих сообщений). См. также [`sendmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.sendmsg).697698```python699import socket, array700701def recv_fds(sock, msglen, maxfds):702    fds = array.array("i")   # Массив целых чисел703    msg, ancdata, flags, addr = sock.recvmsg(msglen, socket.CMSG_LEN(maxfds * fds.itemsize))704    for cmsg_level, cmsg_type, cmsg_data in ancdata:705        if (cmsg_level == socket.SOL_SOCKET and cmsg_type == socket.SCM_RIGHTS):706            # Добавить данные, игнорируя любые усечённые целые числа в конце.707            fds.fromstring(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds.itemsize)])708    return msg, list(fds)709```710711Доступность: большинство платформ Unix, возможно, и другие.712713Новое в версии 3.3.714715Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).716717#### `socket.recvmsg_into(buffers[, ancbufsize[, flags]])`718719Принимает обычные и вспомогательные данные из сокета, действуя как [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg), но разбрасывает невспомогательные данные по нескольким буферам вместо возврата нового объекта bytes. Аргумент *buffers* должен быть итерируемым объектом, содержащим объекты, предоставляющие буферы для записи (например, объекты [`bytearray`](https://python-all.ru/3.6/library/stdtypes.html#bytearray)); они будут заполняться последовательными фрагментами невспомогательных данных, пока все данные не будут записаны или буферы не закончатся. Операционная система может установить ограничение (значение [`sysconf()`](https://python-all.ru/3.6/library/os.html#os.sysconf) `SC_IOV_MAX`) на количество используемых буферов. Аргументы *ancbufsize* и *flags* имеют тот же смысл, что и для [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg).720721Возвращаемое значение – кортеж из 4 элементов: `(nbytes, ancdata, msg_flags, address)`, где *nbytes* – общее количество байт невспомогательных данных, записанных в буферы, а *ancdata*, *msg\_flags* и *address* такие же, как для [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg).722723Пример:724725```python726>>> import socket727>>> s1, s2 = socket.socketpair()728>>> b1 = bytearray(b'----')729>>> b2 = bytearray(b'0123456789')730>>> b3 = bytearray(b'--------------')731>>> s1.send(b'Mary had a little lamb')73222733>>> s2.recvmsg_into([b1, memoryview(b2)[2:9], b3])734(22, [], 0, None)735>>> [b1, b2, b3]736[bytearray(b'Mary'), bytearray(b'01 had a 9'), bytearray(b'little lamb---')]737```738739Доступность: большинство платформ Unix, возможно, и другие.740741Новое в версии 3.3.742743#### `socket.recvfrom_into(buffer[, nbytes[, flags]])`744745Получает данные из сокета, записывая их в *buffer* вместо создания новой строки байтов. Возвращает пару `(nbytes, address)`, где *nbytes* – количество полученных байтов, а *address* – адрес сокета, отправившего данные. Значение необязательного аргумента *flags* описано на странице руководства Unix *recv(2)*; по умолчанию он равен нулю. (Формат *address* зависит от семейства адресов – см. выше.)746747#### `socket.recv_into(buffer[, nbytes[, flags]])`748749Получает из сокета до *nbytes* байтов, сохраняя данные в буфер, а не создавая новую строку байтов. Если *nbytes* не указан (или равен 0), принимает столько байтов, сколько помещается в переданный буфер. Возвращает количество полученных байтов. Значение необязательного аргумента *flags* описано на странице руководства Unix *recv(2)*; по умолчанию он равен нулю.750751#### `socket.send(bytes[, flags])`752753Отправляет данные в сокет. Сокет должен быть подключён к удалённому сокету. Необязательный аргумент *flags* имеет тот же смысл, что и для [`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) выше. Возвращает количество отправленных байтов. Приложения обязаны проверять, что все данные были отправлены; если передана только часть данных, приложение должно попытаться отправить оставшиеся. Дополнительную информацию по этой теме можно найти в [Socket Programming HOWTO](https://python-all.ru/3.6/howto/sockets.html#socket-howto).754755Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).756757#### `socket.sendall(bytes[, flags])`758759Отправляет данные в сокет. Сокет должен быть подключён к удалённому сокету. Необязательный аргумент *flags* имеет тот же смысл, что и для [`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) выше. В отличие от [`send()`](https://python-all.ru/3.6/library/socket.html#socket.socket.send), этот метод продолжает отправлять данные из *bytes*, пока не будут отправлены все данные или не произойдёт ошибка. При успехе возвращается `None`. В случае ошибки выбрасывается исключение, и невозможно определить, сколько данных, если вообще, было успешно отправлено.760761Изменено в версии 3.5: Тайм-аут сокета больше не сбрасывается при каждой успешной отправке данных. Теперь тайм-аут сокета – это максимальная общая продолжительность для отправки всех данных.762763Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).764765#### `socket.sendto(bytes, address)`766767#### `socket.sendto(bytes, flags, address)`768769Отправляет данные в сокет. Сокет не должен быть подключён к удалённому сокету, поскольку целевой сокет задаётся параметром *address*. Необязательный аргумент *flags* имеет тот же смысл, что и для [`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) выше. Возвращает количество отправленных байтов. (Формат *address* зависит от семейства адресов – см. выше.)770771Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).772773#### `socket.sendmsg(buffers[, ancdata[, flags[, address]]])`774775Отправляет обычные и вспомогательные данные в сокет, собирая невспомогательные данные из серии буферов и объединяя их в одно сообщение. Аргумент *buffers* задаёт невспомогательные данные как итерируемый объект из [bytes-подобных объектов](https://python-all.ru/3.6/glossary.html#term-bytes-like-object) (например, объекты [`bytes`](https://python-all.ru/3.6/library/stdtypes.html#bytes)); операционная система может установить ограничение (значение [`sysconf()`](https://python-all.ru/3.6/library/os.html#os.sysconf) `SC_IOV_MAX`) на количество буферов, которые можно использовать. Аргумент *ancdata* задаёт вспомогательные данные (управляющие сообщения) как итерируемый объект из нуля или более кортежей `(cmsg_level, cmsg_type, cmsg_data)`, где *cmsg\_level* и *cmsg\_type* – целые числа, определяющие уровень протокола и тип протокола соответственно, а *cmsg\_data* – bytes-подобный объект, содержащий соответствующие данные. Обратите внимание, что некоторые системы (в частности, системы без [`CMSG_SPACE()`](https://python-all.ru/3.6/library/socket.html#socket.CMSG_SPACE)) могут поддерживать отправку только одного управляющего сообщения за вызов. Аргумент *flags* по умолчанию равен 0 и имеет то же значение, что и для [`send()`](https://python-all.ru/3.6/library/socket.html#socket.socket.send). Если *address* указан и не равен `None`, он устанавливает адрес назначения для сообщения. Возвращаемое значение – количество отправленных байтов невспомогательных данных.776777Следующая функция отправляет список файловых дескрипторов *fds* через сокет [`AF_UNIX`](https://python-all.ru/3.6/library/socket.html#socket.AF_UNIX) в системах, поддерживающих механизм `SCM_RIGHTS`. См. также [`recvmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recvmsg).778779```python780import socket, array781782def send_fds(sock, msg, fds):783    return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array.array("i", fds))])784```785786Доступность: большинство платформ Unix, возможно, и другие.787788Новое в версии 3.3.789790Изменено в версии 3.5: Если системный вызов прерван и обработчик сигнала не вызывает исключение, метод теперь повторяет системный вызов вместо того, чтобы вызывать исключение [`InterruptedError`](https://python-all.ru/3.6/library/exceptions.html#InterruptedError) (см. [**PEP 475**](https://python-all.ru/3.6/library/socket.html) с обоснованием).791792#### `socket.sendmsg_afalg([msg, ]*, op[, iv[, assoclen[, flags]]])`793794Специализированная версия [`sendmsg()`](https://python-all.ru/3.6/library/socket.html#socket.socket.sendmsg) для сокета [`AF_ALG`](https://python-all.ru/3.6/library/socket.html#socket.AF_ALG). Устанавливает режим, IV, длину связанных данных AEAD и флаги для сокета [`AF_ALG`](https://python-all.ru/3.6/library/socket.html#socket.AF_ALG).795796Доступность: Linux \>= 2.6.38797798Новое в версии 3.6.799800#### `socket.sendfile(file, offset=0, count=None)`801802Отправляет файл до достижения EOF, используя высокопроизводительный [`os.sendfile`](https://python-all.ru/3.6/library/os.html#os.sendfile), и возвращает общее количество отправленных байтов. *file* должен быть обычным файловым объектом, открытым в двоичном режиме. Если [`os.sendfile`](https://python-all.ru/3.6/library/os.html#os.sendfile) недоступен (например, в Windows) или *file* не является обычным файлом, вместо него будет использован [`send()`](https://python-all.ru/3.6/library/socket.html#socket.socket.send). *offset* указывает, откуда начинать чтение файла. Если указан, *count* – это общее количество байтов для передачи, в отличие от отправки файла до EOF. Позиция файла обновляется при возврате, а также в случае ошибки, и тогда [`file.tell()`](https://python-all.ru/3.6/library/io.html#io.IOBase.tell) можно использовать для определения количества отправленных байтов. Сокет должен быть типа [`SOCK_STREAM`](https://python-all.ru/3.6/library/socket.html#socket.SOCK_STREAM). Неблокирующие сокеты не поддерживаются.803804Новое в версии 3.5.805806#### `socket.set_inheritable(inheritable)`807808Устанавливает [флаг наследования](https://python-all.ru/3.6/library/os.html#fd-inheritance) файлового дескриптора сокета или дескриптора сокета.809810Новое в версии 3.4.811812#### `socket.setblocking(flag)`813814Устанавливает блокирующий или неблокирующий режим сокета: если *flag* равен false, сокет переводится в неблокирующий режим, иначе в блокирующий.815816Этот метод является сокращённой записью для определённых вызовов [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout):817818- `sock.setblocking(True)` эквивалентен `sock.settimeout(None)`819- `sock.setblocking(False)` эквивалентен `sock.settimeout(0.0)`820821#### `socket.settimeout(value)`822823Устанавливает тайм-аут для блокирующих операций с сокетом. Аргумент *value* может быть неотрицательным числом с плавающей запятой, задающим секунды, или `None`. Если задано ненулевое значение, последующие операции с сокетом будут вызывать исключение [`timeout`](https://python-all.ru/3.6/library/socket.html#socket.timeout), если время тайм-аута *value* истекло до завершения операции. Если задан ноль, сокет переводится в неблокирующий режим. Если задан `None`, сокет переводится в блокирующий режим.824825Для получения дополнительной информации обратитесь к [заметкам о тайм-аутах сокетов](https://python-all.ru/3.6/library/socket.html#socket-timeouts).826827#### `socket.setsockopt(level, optname, value: int)`828829#### `socket.setsockopt(level, optname, value: buffer)`830831#### `socket.setsockopt(level, optname, None, optlen: int)`832833Устанавливает значение указанной опции сокета (см. справочную страницу Unix *setsockopt(2)*). Необходимые символические константы определены в модуле [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket) (`SO_*` и т.д.). Значение может быть целым числом, `None` или [байтоподобным объектом](https://python-all.ru/3.6/glossary.html#term-bytes-like-object), представляющим буфер. В последнем случае вызывающий должен гарантировать, что байтовая строка содержит правильные биты (см. встроенный модуль [`struct`](https://python-all.ru/3.6/library/struct.html#module-struct) для способа кодирования структур C в виде байтовых строк). Когда значение равно `None`, требуется аргумент optlen. Это эквивалентно вызову C-функции setsockopt с optval=NULL и optlen=optlen.834835Изменено в версии 3.5: Теперь принимается записываемый [байтоподобный объект](https://python-all.ru/3.6/glossary.html#term-bytes-like-object).836837Изменено в версии 3.6: Добавлена форма setsockopt(level, optname, None, optlen: int).838839#### `socket.shutdown(how)`840841Завершает одну или обе половины соединения. Если *how* равен `SHUT_RD`, дальнейшие приёмы запрещены. Если *how* равен `SHUT_WR`, дальнейшие отправки запрещены. Если *how* равен `SHUT_RDWR`, дальнейшие отправки и приёмы запрещены.842843#### `socket.share(process_id)`844845Дублирует сокет и подготавливает его для совместного использования с целевым процессом. Целевому процессу должен быть предоставлен идентификатор *process\_id*. Полученный bytes-объект затем может быть передан целевому процессу с помощью какой-либо формы межпроцессного взаимодействия, и сокет может быть воссоздан там с помощью [`fromshare()`](https://python-all.ru/3.6/library/socket.html#socket.fromshare). После вызова этого метода сокет можно безопасно закрыть, так как операционная система уже продублировала его для целевого процесса.846847Доступность: Windows.848849Новое в версии 3.3.850851Обратите внимание, что методы `read()` и `write()` отсутствуют; вместо них используйте [`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) и [`send()`](https://python-all.ru/3.6/library/socket.html#socket.socket.send) без аргумента *flags*.852853Объекты сокетов также имеют следующие (только для чтения) атрибуты, соответствующие значениям, переданным конструктору [`socket`](https://python-all.ru/3.6/library/socket.html#socket.socket).854855#### `socket.family`856857Семейство сокета.858859#### `socket.type`860861Тип сокета.862863#### `socket.proto`864865Протокол сокета.866867## 18.1.4. Примечания по тайм-аутам сокетов868869Объект сокета может находиться в одном из трех режимов: блокирующем, неблокирующем или режиме тайм-аута. По умолчанию сокеты всегда создаются в блокирующем режиме, но это можно изменить, вызвав [`setdefaulttimeout()`](https://python-all.ru/3.6/library/socket.html#socket.setdefaulttimeout).870871- В *блокирующем режиме* операции блокируются до завершения или пока система не вернет ошибку (например, истекло время соединения).872- В *неблокирующем режиме* операции завершаются ошибкой (с ошибкой, которая, к сожалению, зависит от системы), если их невозможно выполнить немедленно: функции из [`select`](https://python-all.ru/3.6/library/select.html#module-select) можно использовать, чтобы узнать, когда и готов ли сокет к чтению или записи.873- В *режиме тайм-аута* операции завершаются ошибкой, если их нельзя выполнить в течение заданного для сокета тайм-аута (возникает исключение [`timeout`](https://python-all.ru/3.6/library/socket.html#socket.timeout)) или если система возвращает ошибку.874875> **Примечание**876>877> На уровне операционной системы сокеты в *режиме тайм-аута* внутренне устанавливаются в неблокирующий режим. Кроме того, блокирующий режим и режим тайм-аута разделяются между файловыми дескрипторами и объектами сокетов, относящимися к одной сетевой конечной точке. Эта деталь реализации может иметь заметные последствия, если, например, вы решите использовать [`fileno()`](https://python-all.ru/3.6/library/socket.html#socket.socket.fileno) сокета.878879### 18.1.4.1. Тайм-ауты и метод `connect`880881Операция [`connect()`](https://python-all.ru/3.6/library/socket.html#socket.socket.connect) также подчиняется настройке тайм-аута, и в целом рекомендуется вызывать [`settimeout()`](https://python-all.ru/3.6/library/socket.html#socket.socket.settimeout) перед вызовом [`connect()`](https://python-all.ru/3.6/library/socket.html#socket.socket.connect) или передавать параметр тайм-аута в [`create_connection()`](https://python-all.ru/3.6/library/socket.html#socket.create_connection). Однако сетевая подсистема системы также может вернуть собственную ошибку тайм-аута соединения независимо от любых настроек тайм-аута сокета Python.882883### 18.1.4.2. Тайм-ауты и метод `accept`884885Если [`getdefaulttimeout()`](https://python-all.ru/3.6/library/socket.html#socket.getdefaulttimeout) не равно [`None`](https://python-all.ru/3.6/library/constants.html#None), сокеты, возвращаемые методом [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept), наследуют этот тайм-аут. В противном случае поведение зависит от настроек слушающего сокета:886887- если слушающий сокет находится в *блокирующем режиме* или в *режиме тайм-аута*, то сокет, возвращаемый [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept), находится в *блокирующем режиме*;888- если слушающий сокет находится в *неблокирующем режиме*, то будет ли сокет, возвращаемый [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept), в блокирующем или неблокирующем режиме, зависит от операционной системы. Если вы хотите обеспечить кроссплатформенное поведение, рекомендуется вручную переопределить этот параметр.889890## 18.1.5. Пример891892Вот четыре минимальных примера программ, использующих протокол TCP/IP: сервер, который отправляет обратно все полученные данные (обслуживая только одного клиента), и использующий его клиент. Обратите внимание, что сервер должен выполнить последовательность [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket), [`bind()`](https://python-all.ru/3.6/library/socket.html#socket.socket.bind), [`listen()`](https://python-all.ru/3.6/library/socket.html#socket.socket.listen), [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept) (возможно, повторяя [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept) для обслуживания более одного клиента), в то время как клиенту нужна только последовательность [`socket()`](https://python-all.ru/3.6/library/socket.html#socket.socket), [`connect()`](https://python-all.ru/3.6/library/socket.html#socket.socket.connect). Также обратите внимание, что сервер не вызывает [`sendall()`](https://python-all.ru/3.6/library/socket.html#socket.socket.sendall)/[`recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) на сокете, который слушает, а на новом сокете, возвращённом [`accept()`](https://python-all.ru/3.6/library/socket.html#socket.socket.accept).893894Первые два примера поддерживают только IPv4.895896```python897# Программа эхо-сервера898import socket899900HOST = ''                 # Символическое имя, обозначающее все доступные интерфейсы901PORT = 50007              # Произвольный непривилегированный порт902with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:903    s.bind((HOST, PORT))904    s.listen(1)905    conn, addr = s.accept()906    with conn:907        print('Connected by', addr)908        while True:909            data = conn.recv(1024)910            if not data: break911            conn.sendall(data)912```913914```python915# Программа эхо-клиента916import socket917918HOST = 'daring.cwi.nl'    # Удалённый хост919PORT = 50007              # Тот же порт, что и у сервера920with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:921    s.connect((HOST, PORT))922    s.sendall(b'Hello, world')923    data = s.recv(1024)924print('Received', repr(data))925```926927Следующие два примера идентичны двум предыдущим, но поддерживают как IPv4, так и IPv6. Серверная сторона будет прослушивать первое доступное семейство адресов (ей следовало бы прослушивать оба). На большинстве систем, готовых к IPv6, IPv6 будет иметь приоритет, и сервер может не принимать IPv4-трафик. Клиентская сторона попытается подключиться ко всем адресам, полученным в результате разрешения имен, и отправляет трафик на первый успешно подключенный.928929```python930# Программа эхо-сервера931import socket932import sys933934HOST = None               # Символическое имя, обозначающее все доступные интерфейсы935PORT = 50007              # Произвольный непривилегированный порт936s = None937for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC,938                              socket.SOCK_STREAM, 0, socket.AI_PASSIVE):939    af, socktype, proto, canonname, sa = res940    try:941        s = socket.socket(af, socktype, proto)942    except OSError as msg:943        s = None944        continue945    try:946        s.bind(sa)947        s.listen(1)948    except OSError as msg:949        s.close()950        s = None951        continue952    break953if s is None:954    print('could not open socket')955    sys.exit(1)956conn, addr = s.accept()957with conn:958    print('Connected by', addr)959    while True:960        data = conn.recv(1024)961        if not data: break962        conn.send(data)963```964965```python966# Программа эхо-клиента967import socket968import sys969970HOST = 'daring.cwi.nl'    # Удалённый хост971PORT = 50007              # Тот же порт, что и у сервера972s = None973for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, socket.SOCK_STREAM):974    af, socktype, proto, canonname, sa = res975    try:976        s = socket.socket(af, socktype, proto)977    except OSError as msg:978        s = None979        continue980    try:981        s.connect(sa)982    except OSError as msg:983        s.close()984        s = None985        continue986    break987if s is None:988    print('could not open socket')989    sys.exit(1)990with s:991    s.sendall(b'Hello, world')992    data = s.recv(1024)993print('Received', repr(data))994```995996Следующий пример показывает, как написать очень простой снифер сети с помощью сырых сокетов в Windows. Для изменения интерфейса пример требует прав администратора:997998```python999import socket10001001# общедоступный сетевой интерфейс1002HOST = socket.gethostbyname(socket.gethostname())10031004# создать сырой сокет и привязать его к общедоступному интерфейсу1005s = socket.socket(socket.AF_INET, socket.SOCK_RAW, socket.IPPROTO_IP)1006s.bind((HOST, 0))10071008# Включать IP-заголовки1009s.setsockopt(socket.IPPROTO_IP, socket.IP_HDRINCL, 1)10101011# принять все пакеты1012s.ioctl(socket.SIO_RCVALL, socket.RCVALL_ON)10131014# принять пакет1015print(s.recvfrom(65565))10161017# неразборчивый режим отключён1018s.ioctl(socket.SIO_RCVALL, socket.RCVALL_OFF)1019```10201021Последний пример показывает, как использовать интерфейс сокетов для обмена данными с сетью CAN с помощью протокола сырых сокетов. Чтобы вместо этого использовать CAN с протоколом широковещательного менеджера, откройте сокет:10221023```python1024socket.socket(socket.AF_CAN, socket.SOCK_DGRAM, socket.CAN_BCM)1025```10261027После привязки (`CAN_RAW`) или подключения ([`CAN_BCM`](https://python-all.ru/3.6/library/socket.html#socket.CAN_BCM)) сокета можно использовать операции [`socket.send()`](https://python-all.ru/3.6/library/socket.html#socket.socket.send) и [`socket.recv()`](https://python-all.ru/3.6/library/socket.html#socket.socket.recv) (и их аналоги) с объектом сокета как обычно.10281029Для этого примера могут потребоваться особые привилегии:10301031```python1032import socket1033import struct10341035# Упаковка/распаковка CAN-фреймов (см. 'struct can_frame' в <linux/can.h>)10361037can_frame_fmt = "=IB3x8s"1038can_frame_size = struct.calcsize(can_frame_fmt)10391040def build_can_frame(can_id, data):1041    can_dlc = len(data)1042    data = data.ljust(8, b'\x00')1043    return struct.pack(can_frame_fmt, can_id, can_dlc, data)10441045def dissect_can_frame(frame):1046    can_id, can_dlc, data = struct.unpack(can_frame_fmt, frame)1047    return (can_id, can_dlc, data[:can_dlc])10481049# создать сырой сокет и привязать его к интерфейсу 'vcan0'1050s = socket.socket(socket.AF_CAN, socket.SOCK_RAW, socket.CAN_RAW)1051s.bind(('vcan0',))10521053while True:1054    cf, addr = s.recvfrom(can_frame_size)10551056    print('Received: can_id=%x, can_dlc=%x, data=%s' % dissect_can_frame(cf))10571058    try:1059        s.send(cf)1060    except OSError:1061        print('Error sending CAN frame')10621063    try:1064        s.send(build_can_frame(0x01, b'\x01\x02\x03'))1065    except OSError:1066        print('Error sending CAN frame')1067```10681069Запуск примера несколько раз со слишком маленькой задержкой между выполнениями может привести к этой ошибке:10701071```python1072OSError: [Errno 98] Address already in use1073```10741075Это связано с тем, что предыдущее выполнение оставило сокет в состоянии `TIME_WAIT`, и его нельзя сразу использовать повторно.10761077Существует флаг [`socket`](https://python-all.ru/3.6/library/socket.html#module-socket), который можно установить, чтобы предотвратить это, `socket.SO_REUSEADDR`:10781079```python1080s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)1081s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)1082s.bind((HOST, PORT))1083```10841085Флаг `SO_REUSEADDR` указывает ядру переиспользовать локальный сокет в состоянии `TIME_WAIT`, не дожидаясь истечения его естественного тайм-аута.10861087> **См. также**1088>1089> Для ознакомления с программированием сокетов (на C) см. следующие статьи:1090>1091> - *Вводное руководство по межпроцессному взаимодействию в 4.3BSD*, Стюарт Сечрест1092> - *Продвинутое руководство по межпроцессному взаимодействию в 4.3BSD*, Сэмюэл Дж. Леффлер и др.1093>1094> Оба находятся в UNIX Programmer’s Manual, Supplementary Documents 1 (разделы PS1:7 и PS1:8). Справочные материалы по сокетным системным вызовам для конкретных платформ также являются ценным источником информации о деталях семантики сокетов. Для Unix обращайтесь к страницам руководства; для Windows – к спецификации WinSock (или Winsock 2). Для API с поддержкой IPv6 читателю может быть полезно обратиться к [**RFC 3493**](https://python-all.ru/3.6/library/socket.html) под названием Basic Socket Interface Extensions for IPv6.1095