error

Исключения этого класса генерируются в случае возникновения ошибок, связанных с сетевым соединением или адресом. Аргументами исключения являются строка, описывающая причину возникновения ошибки, и, возможно, системный код ошибки (см. описание модуля errno).

AF UNIX (UNIX)

AF INET

Эти константы используются в качестве первого аргумента конструктора socket() и указывают семейство, к которому относится адрес соединения (UNIX-соединение или соединение с Internet).

SOCK STREAM SOCK DGRAM

SOCK RAW SOCK RDM SOCK SEQPACKET

Эти константы используются в качестве второго аргумента конструктора socket() и указывают тип соединения (обычно используются только первые два типа).

INADDR * IP *

IPPORT *

IPPROTO *

MSG *

SO *

SOL *

SOMAXCONN

Множество констант такого вида определено в этом модуле и обычно используются в качестве аргументов методов setsockopt() и getsockopt() объектов, представляющих сетевое соединение. Информацию о них Вы можете получить в документации UNIX по сетевым соединениям и протоколу IP.

getfqdn( [name])

Возвращает полное уточненное доменное имя для name. Если аргумент name опущен или является пустой строкой, он считается соответствующим локальному узлу. Для того, чтобы получить полное уточненное имя, проверяется сначала имя узла, возвращаемое функцией gethostbyaddr() , затем псевдонимы, если они имеются. Выбирается первое имя, содержащее точку. В случае, если уточненное имя не доступно, возвращает имя узла. Функция доступна, начиная с версии 2.0.

gethostbyname(hostname)

Возвращает строку, содержащую IP адрес узла с именем hostname. Если строка hostname содержит IP адрес, она возвращается без изменений.

gethostbyname ex( hostname)

Возвращает кортеж ( mainhostname, aliaslist, ipaddrlist) , где mainhostname - основное имя узла, соответствующего hostname, aliaslist - список (возможно пустой) альтернативных имен для того же

адреса и ipaddrlist - список IP адресов для того же интерфейса к тому же узлу (обычно содержит одну строку).

gethostname()

Возвращает строку, содержащую имя узла машины, на которой в данный момент выполняется интерпретатор языка Python. Если Вы хотите получить IP адрес текущей машины, используйте gethostbyname(gethostname()) . Заметим, что функция gethostname() не всегда возвращает полное имя - для этих целей следует использовать getfqdn(gethostname()) .

gethostbyaddr( ip address)

Возвращает кортеж (hostname, aliaslist, ipaddrlist) , где hostname - основное имя узла, соответствующего IP адресу ip address, aliaslist - список (возможно пустой) альтернативных имен для того же адреса и ipaddrlist - список IP адресов для того же интерфейса к тому же узлу (обычно содержит одну строку).

getprotobyname( protocolname)

Возвращает число, подходящее для использования в качестве третьего аргумента функции socket() и соответствующее протоколу с именем protocolname. Это необходимо только, если Вы открываете соединение в "прямом" режиме (SOCK RAW), для остальных типов соединений правильный протокол выбирается автоматически, если соответствующий аргумент опущен или равен нулю.

getservbyname(servicename, protocolname)

Возвращает номер порта для службы с именем servicename и протоколом с именем protocolname. Имя протокола должно быть равным tcp или udp .

socket (family, type [, proto])

Создает новое сетевое соединение и возвращает соответствующий ему объект. family - семейство адресов (AF INET или AF UNIX), type - тип соединения

(одна из констант SOCK *) и proto - номер протокола. Если аргумент proto опущен, протокол выбирается автоматически.

fromfd(fd, family, type [, proto])

Создает объект сетевого соединения из файлового дескриптора fd и возвращает его. Файловый дескриптор должен соответствовать сетевому соединению (однако это не проверяется - последующие операции могут вызвать ошибку, если дескриптор непригоден). Остальные аргументы имеют такое же значение, как и для функции socket() .

ntohl( x)

Преобразует представление 32-битового целого числа с общепринятым в сети порядком следования байтов к представлению с порядком следования байтов на данной машине.

ntohs( x)

Преобразует представление 16-битового целого числа с общепринятым в сети порядком следования байтов к представлению с порядком следования байтов на данной машине.

htonl( x)

Преобразует представление 32-битового целого числа с порядком следования байтов на данной машине к представлению с общепринятым в сети порядком следования байтов.

htons( x)

Преобразует представление 16-битового целого числа с порядком следования байтов на данной машине к представлению с общепринятым в сети порядком следования байтов.

inet aton(ip string)

Возвращает строку из четырех символов, содержащую IP адрес ip string (строка вида 123.45.67.89) в упакованном двоичном виде. Эта функция может быть полезна для связи с программой, использующей стандартную библиотеку языка C.

inet ntoa( packed ip)

Возвращает строку с IP адресом, полученным распаковкой строки из четырех символов packed ip, содержащей упакованное двоичное представление адреса.

SocketType

Тип объекта сетевого соединения, возвращаемого функцией socket() .

Объекты сетевого соединения, возвращаемые функцией socket(), имеют следующие методы:

accept()

Принимает соединение и возвращает пару ( conn, address) , где conn - новый объект сетевого соединения, подходящий для посылки и получения данных, и address - адрес другого конца сетевого соединения. Объект сетевого соединения, к которому применяется метод accept() , должен быть привязан к адресу (метод bind() ) и ожидать соединения (метод listen() ).

bind( address)

Привязывает сетевое соединение к адресу address. Перед вызовом этого метода объект не должен быть привязанным к адресу. Формат аргумента зависит от семейства, к которому относится адрес (см. начало раздела).

close()

Закрывает сетевое соединение, после чего все операции над объектом будут вызывать ошибку. Сетевое соединение автоматически закрывается при достижении нуля количества ссылок на объект сетевого соединения.

connect( address)

Подсоединяется к удаленному узлу с адресом address. Формат аргумента зависит от семейства, к которому относится адрес (см. начало раздела).

connect ex( address)

Работает аналогично методу connect() , но возвращает код ошибки, возвращаемый системной функцией connect() вместо того, чтобы генерировать исключение. Возвращаемое значение равно 0 в случае успешного выполнения операции и