c和python利用setsockopt获得端口重用

假如端口被socket使用过，并且利用socket.close()来关闭连接，但此时端口还没有释放，要经过一个TIME_WAIT的过程之后才能使用。为了实现端口的马上复用，可以选择setsockopt()函数来达到目的。

python：
import socket
tcp1=socket.socket(socket.AF_INET,socket.SOCK_STREAM)
tcp1.setsockopt(socket.SOL_SOCKET,socket.SO_REUSEADDR,1)
tcp1.bind('1.1.1.1',12345)

此为tcp的例子，udp一样

c：
s = socket(AF_INET, SOCK_STREAM, 0);
/* What you need to do is add the following two line to your code */
unsigned value = 1;
setsockopt(s, SOL_SOCKET, SO_REUSEADDR, &value, sizeof(valu

e));
/* Then do other things */
listen(s, SOMAXCONN);
/* ... */
写Socket程序的时候经常会遇到这个问题：如果自己的程序不小心崩溃了，重新启动程序的时候往往会在bind调用上失败，错误原因为Address Already In Use，往往要等待两分钟才能再次绑定。但是在很多的程序（比如nginx）中好像并不存在这个问题，就算被KILL了也能立刻重启。这个区别还是比较头痛的。
其实我猜Unix Socket编程这样的书上有讨论过这方面的问题，不过我竟然没有这方面的书籍（完全靠man看来也是行不通啊）。我曾经天真的以为，在收到SIGTERM这样的信号的时候把所有套接字全部关闭可以解决问题。后来才发现无济于事。Google了这方面的文章才知道，解决这个问题理论上有三种办法。
1.SOCK_REUSEADDR:曾经在研究内网穿透的时候跟这个东西打过交道。如果一个监听的套接字被设置为允许地址复用，那么套接字绑定到的地址不会被独占，所以必然不会存在Address already in use的问题。而且如果有两个套接字绑定到同一个端口，也只允许一个套接字进行监听，后一个套接字在调用listen的时候会报错。因此这个方案显然是最佳方案。对于完全不知道我在说什么的童鞋，你们只要这么做
s = socket(AF_INET, SOCK_STREAM, 0);
/* What you need to do is add the following two line to your code */
unsigned value = 1;
setsockopt(s, SOL_SOCKET, SO_REUSEADDR, &value, sizeof(value));
/* Then do other things */listen(s, SOMAXCONN);/* ... */
2.不过据说这样的做法容易产生安全性问题，某些操作系统（没有指明Linux或是BSD或是Windows）允许分别属于两个进程的两个套接字绑定到两个地址的同一个端口。大多数程序把套接字绑定到0.0.0.0这个地址上进行监听（也即监听所有网络设备），这种情形下另外一个进程可以绑定到127.0.0.1或者是其他网络设备的IP地址的同一个端口，并进行监听，就可能把外部的连接给拦截下来（因为127.0.0.1这样的IP是属于特定设备的，比0.0.0.0这虚拟设备更specific)。
而解决这个安全性的问题的方法其实也不难（其实换个没问题的操作系统就可以了不是？），只要把套接字绑定绑定到具体的网络设备的IP地址（比如绑定到127.0.0.1，或者a.b.c.d)即可，大不了为每个网络设备建一个套接字。如果实施起来有难度，只能考虑后面的两种方法。
3.让客户端先关闭连接。如果所有的连接关闭事件都在客户端首先发生，那么也不会存在这个问题。不过这种做法可能需要修改协议，而且貌似很容易恶意连接攻击。修改系统TCP超时时间，这种方法很不推荐。

 

原文：http://www.2cto.com/kf/201208/150347.html

 

-----------------------------

附: python  socket模块函数列表---2012-12-09：

socketindex
c:\python27\lib\socket.py

This module provides socket operations and some related functions.
On Unix, it supports IP (Internet Protocol) and Unix domain sockets.
On other systems, it only supports IP. Functions specific for a
socket are available as methods of the socket object.
 
Functions:
 
socket() -- create a new socket object
socketpair() -- create a pair of new socket objects [*]
fromfd() -- create a socket object from an open file descriptor [*]
gethostname() -- return the current hostname
gethostbyname() -- map a hostname to its IP number
gethostbyaddr() -- map an IP number or hostname to DNS info
getservbyname() -- map a service name and a protocol name to a port number
getprotobyname() -- map a protocol name (e.g. 'tcp') to a number
ntohs(), ntohl() -- convert 16, 32 bit int from network to host byte order
htons(), htonl() -- convert 16, 32 bit int from host to network byte order
inet_aton() -- convert IP addr string (123.45.67.89) to 32-bit packed format
inet_ntoa() -- convert 32-bit packed format IP to string (123.45.67.89)
ssl() -- secure socket layer support (only available if configured)
socket.getdefaulttimeout() -- get the default timeout value
socket.setdefaulttimeout() -- set the default timeout value
create_connection() -- connects to an address, with an optional timeout and
                       optional source address.
 
 [*] not available on all platforms!
 
Special objects:
 
SocketType -- type object for socket objects
error -- exception raised for I/O errors
has_ipv6 -- boolean value indicating if IPv6 is supported
 
Integer constants:
 
AF_INET, AF_UNIX -- socket domains (first argument to socket() call)
SOCK_STREAM, SOCK_DGRAM, SOCK_RAW -- socket types (second argument)
 
Many other constants may be defined; these may be used in calls to
the setsockopt() and getsockopt() methods.

 
Modules       _socket
_sslerrno
ossys
warnings 

 
Classes       

__builtin__.object

_socketobject

_socketobject

exceptions.IOError(exceptions.EnvironmentError)

error

gaierror

herror

timeout

 
SocketType =class _socketobject(__builtin__.object)   socket([family[, type[, proto]]]) -> socket object
 
Open a socket of the given type.  The family argument specifies the
address family; it defaults to AF_INET.  The type argument specifies
whether this is a stream (SOCK_STREAM, this is the default)
or datagram (SOCK_DGRAM) socket.  The protocol argument defaults to 0,
specifying the default protocol.  Keyword arguments are accepted.
 
A socket object represents one endpoint of a network connection.
 
Methods of socket objects (keyword arguments not allowed):
 
accept() -- accept a connection, returning new socket and client address
bind(addr) -- bind the socket to a local address
close() -- close the socket
connect(addr) -- connect the socket to a remote address
connect_ex(addr) -- connect, return an error code instead of an exception
dup() -- return a new socket object identical to the current one [*]
fileno() -- return underlying file descriptor
getpeername() -- return remote address [*]
getsockname() -- return local address
getsockopt(level, optname[, buflen]) -- get socket options
gettimeout() -- return timeout or None
listen(n) -- start listening for incoming connections
makefile([mode, [bufsize]]) -- return a file object for the socket [*]
recv(buflen[, flags]) -- receive data
recv_into(buffer[, nbytes[, flags]]) -- receive data (into a buffer)
recvfrom(buflen[, flags]) -- receive data and sender's address
recvfrom_into(buffer[, nbytes, [, flags])
  -- receive data and sender's address (into a buffer)
sendall(data[, flags]) -- send all data
send(data[, flags]) -- send data, may not send all of it
sendto(data[, flags], addr) -- send data to a given address
setblocking(0 | 1) -- set or clear the blocking I/O flag
setsockopt(level, optname, value) -- set socket options
settimeout(None | float) -- set or clear the timeout
shutdown(how) -- shut down traffic in one or both directions
 
 [*] not available on all platforms!
  Methods defined here:

__init__(self, family=2, type=1, proto=0, _sock=None)

accept(self)

accept() -> (socket object, address info)
 
Wait for an incoming connection.  Return a new socket representing the
connection, and the address of the client.  For IP sockets, the address
info is a pair (hostaddr, port).

bind(...)

bind(address)
 
Bind the socket to a local address.  For IP sockets, the address is a
pair (host, port); the host must refer to the local host. For raw packet
sockets the address is a tuple (ifname, proto [,pkttype [,hatype]])

close(self, _closedsocket=<class 'socket._closedsocket'>, _delegate_methods=('recv', 'recvfrom', 'recv_into', 'recvfrom_into', 'send', 'sendto'), setattr=<built-in function setattr>)

close()
 
Close the socket.  It cannot be used after this call.

connect(...)

connect(address)
 
Connect the socket to a remote address.  For IP sockets, the address
is a pair (host, port).

connect_ex(...)

connect_ex(address) -> errno
 
This is like connect(address), but returns an error code (the errno value)
instead of raising an exception when an error occurs.

dup(self)

dup() -> socket object
 
Return a new socket object connected to the same system resource.

fileno(...)

fileno() -> integer
 
Return the integer file descriptor of the socket.

getpeername(...)

getpeername() -> address info
 
Return the address of the remote endpoint.  For IP sockets, the address
info is a pair (hostaddr, port).

getsockname(...)

getsockname() -> address info
 
Return the address of the local endpoint.  For IP sockets, the address
info is a pair (hostaddr, port).

getsockopt(...)

getsockopt(level, option[, buffersize]) -> value
 
Get a socket option.  See the Unix manual for level and option.
If a nonzero buffersize argument is given, the return value is a
string of that length; otherwise it is an integer.

gettimeout(...)

gettimeout() -> timeout
 
Returns the timeout in seconds (float) associated with socket 
operations. A timeout of None indicates that timeouts on socket 
operations are disabled.

ioctl(...)

ioctl(cmd, option) -> long
 
Control the socket with WSAIoctl syscall. Currently supported 'cmd' values are
SIO_RCVALL:  'option' must be one of the socket.RCVALL_* constants.
SIO_KEEPALIVE_VALS:  'option' is a tuple of (onoff, timeout, interval).

listen(...)

listen(backlog)
 
Enable a server to accept connections.  The backlog argument must be at
least 0 (if it is lower, it is set to 0); it specifies the number of
unaccepted connections that the system will allow before refusing new
connections.

makefile(self, mode='r', bufsize=-1)

makefile([mode[, bufsize]]) -> file object
 
Return a regular file object corresponding to the socket.  The mode
and bufsize arguments are as for the built-in open() function.

sendall(...)

sendall(data[, flags])
 
Send a data string to the socket.  For the optional flags
argument, see the Unix manual.  This calls send() repeatedly
until all data is sent.  If an error occurs, it's impossible
to tell how much data has been sent.

setblocking(...)

setblocking(flag)
 
Set the socket to blocking (flag is true) or non-blocking (false).
setblocking(True) is equivalent to settimeout(None);
setblocking(False) is equivalent to settimeout(0.0).

setsockopt(...)

setsockopt(level, option, value)
 
Set a socket option.  See the Unix manual for level and option.
The value argument can either be an integer or a string.

settimeout(...)

settimeout(timeout)
 
Set a timeout on socket operations.  'timeout' can be a float,
giving in seconds, or None.  Setting a timeout of None disables
the timeout feature and is equivalent to setblocking(1).
Setting a timeout of zero is the same as setblocking(0).

shutdown(...)

shutdown(flag)
 
Shut down the reading side of the socket (flag == SHUT_RD), the writing side
of the socket (flag == SHUT_WR), or both ends (flag == SHUT_RDWR).

---

Data descriptors defined here:

__weakref__

list of weak references to the object (if defined)

family

the socket family

proto

the socket protocol

recv

recv_into

recvfrom

recvfrom_into

send

sendto

type

the socket type

 
class error(exceptions.IOError)    

Method resolution order:

error

exceptions.IOError

exceptions.EnvironmentError

exceptions.StandardError

exceptions.Exception

exceptions.BaseException

__builtin__.object

---

Data descriptors defined here:

__weakref__

list of weak references to the object (if defined)

---

Methods inherited from exceptions.IOError:

__init__(...)

x.__init__(...) initializes x; see help(type(x)) for signature

---

Data and other attributes inherited from exceptions.IOError:

__new__ = <built-in method __new__ of type object>

T.__new__(S, ...) -> a new object with type S, a subtype of T

---

Methods inherited from exceptions.EnvironmentError:

__reduce__(...)

__str__(...)

x.__str__() <==> str(x)

---

Data descriptors inherited from exceptions.EnvironmentError:

errno

exception errno

filename

exception filename

strerror

exception strerror

---

Methods inherited from exceptions.BaseException:

__delattr__(...)

x.__delattr__('name') <==> del x.name

__getattribute__(...)

x.__getattribute__('name') <==> x.name

__getitem__(...)

x.__getitem__(y) <==> x[y]

__getslice__(...)

x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.

__repr__(...)

x.__repr__() <==> repr(x)

__setattr__(...)

x.__setattr__('name', value) <==> x.name = value

__setstate__(...)

__unicode__(...)

---

Data descriptors inherited from exceptions.BaseException:

__dict__

args

message

 
classgaierror(error)    

Method resolution order:

gaierror

error

exceptions.IOError

exceptions.EnvironmentError

exceptions.StandardError

exceptions.Exception

exceptions.BaseException

__builtin__.object

---

Data descriptors inherited from error:

__weakref__

list of weak references to the object (if defined)

---

Methods inherited from exceptions.IOError:

__init__(...)

x.__init__(...) initializes x; see help(type(x)) for signature

---

Data and other attributes inherited from exceptions.IOError:

__new__ = <built-in method __new__ of type object>

T.__new__(S, ...) -> a new object with type S, a subtype of T

---

Methods inherited from exceptions.EnvironmentError:

__reduce__(...)

__str__(...)

x.__str__() <==> str(x)

---

Data descriptors inherited from exceptions.EnvironmentError:

errno

exception errno

filename

exception filename

strerror

exception strerror

---

Methods inherited from exceptions.BaseException:

__delattr__(...)

x.__delattr__('name') <==> del x.name

__getattribute__(...)

x.__getattribute__('name') <==> x.name

__getitem__(...)

x.__getitem__(y) <==> x[y]

__getslice__(...)

x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.

__repr__(...)

x.__repr__() <==> repr(x)

__setattr__(...)

x.__setattr__('name', value) <==> x.name = value

__setstate__(...)

__unicode__(...)

---

Data descriptors inherited from exceptions.BaseException:

__dict__

args

message

 
class herror(error)    

Method resolution order:

herror

error

exceptions.IOError

exceptions.EnvironmentError

exceptions.StandardError

exceptions.Exception

exceptions.BaseException

__builtin__.object

---

Data descriptors inherited from error:

__weakref__

list of weak references to the object (if defined)

---

Methods inherited from exceptions.IOError:

__init__(...)

x.__init__(...) initializes x; see help(type(x)) for signature

---

Data and other attributes inherited from exceptions.IOError:

__new__ = <built-in method __new__ of type object>

T.__new__(S, ...) -> a new object with type S, a subtype of T

---

Methods inherited from exceptions.EnvironmentError:

__reduce__(...)

__str__(...)

x.__str__() <==> str(x)

---

Data descriptors inherited from exceptions.EnvironmentError:

errno

exception errno

filename

exception filename

strerror

exception strerror

---

Methods inherited from exceptions.BaseException:

__delattr__(...)

x.__delattr__('name') <==> del x.name

__getattribute__(...)

x.__getattribute__('name') <==> x.name

__getitem__(...)

x.__getitem__(y) <==> x[y]

__getslice__(...)

x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.

__repr__(...)

x.__repr__() <==> repr(x)

__setattr__(...)

x.__setattr__('name', value) <==> x.name = value

__setstate__(...)

__unicode__(...)

---

Data descriptors inherited from exceptions.BaseException:

__dict__

args

message

 
socket =class _socketobject(__builtin__.object)   socket([family[, type[, proto]]]) -> socket object
 
Open a socket of the given type.  The family argument specifies the
address family; it defaults to AF_INET.  The type argument specifies
whether this is a stream (SOCK_STREAM, this is the default)
or datagram (SOCK_DGRAM) socket.  The protocol argument defaults to 0,
specifying the default protocol.  Keyword arguments are accepted.
 
A socket object represents one endpoint of a network connection.
 
Methods of socket objects (keyword arguments not allowed):
 
accept() -- accept a connection, returning new socket and client address
bind(addr) -- bind the socket to a local address
close() -- close the socket
connect(addr) -- connect the socket to a remote address
connect_ex(addr) -- connect, return an error code instead of an exception
dup() -- return a new socket object identical to the current one [*]
fileno() -- return underlying file descriptor
getpeername() -- return remote address [*]
getsockname() -- return local address
getsockopt(level, optname[, buflen]) -- get socket options
gettimeout() -- return timeout or None
listen(n) -- start listening for incoming connections
makefile([mode, [bufsize]]) -- return a file object for the socket [*]
recv(buflen[, flags]) -- receive data
recv_into(buffer[, nbytes[, flags]]) -- receive data (into a buffer)
recvfrom(buflen[, flags]) -- receive data and sender's address
recvfrom_into(buffer[, nbytes, [, flags])
  -- receive data and sender's address (into a buffer)
sendall(data[, flags]) -- send all data
send(data[, flags]) -- send data, may not send all of it
sendto(data[, flags], addr) -- send data to a given address
setblocking(0 | 1) -- set or clear the blocking I/O flag
setsockopt(level, optname, value) -- set socket options
settimeout(None | float) -- set or clear the timeout
shutdown(how) -- shut down traffic in one or both directions
 
 [*] not available on all platforms!
  Methods defined here:

__init__(self, family=2, type=1, proto=0, _sock=None)

accept(self)

accept() -> (socket object, address info)
 
Wait for an incoming connection.  Return a new socket representing the
connection, and the address of the client.  For IP sockets, the address
info is a pair (hostaddr, port).

bind(...)

bind(address)
 
Bind the socket to a local address.  For IP sockets, the address is a
pair (host, port); the host must refer to the local host. For raw packet
sockets the address is a tuple (ifname, proto [,pkttype [,hatype]])

close(self, _closedsocket=<class 'socket._closedsocket'>, _delegate_methods=('recv', 'recvfrom', 'recv_into', 'recvfrom_into', 'send', 'sendto'), setattr=<built-in function setattr>)

close()
 
Close the socket.  It cannot be used after this call.

connect(...)

connect(address)
 
Connect the socket to a remote address.  For IP sockets, the address
is a pair (host, port).

connect_ex(...)

connect_ex(address) -> errno
 
This is like connect(address), but returns an error code (the errno value)
instead of raising an exception when an error occurs.

dup(self)

dup() -> socket object
 
Return a new socket object connected to the same system resource.

fileno(...)

fileno() -> integer
 
Return the integer file descriptor of the socket.

getpeername(...)

getpeername() -> address info
 
Return the address of the remote endpoint.  For IP sockets, the address
info is a pair (hostaddr, port).

getsockname(...)

getsockname() -> address info
 
Return the address of the local endpoint.  For IP sockets, the address
info is a pair (hostaddr, port).

getsockopt(...)

getsockopt(level, option[, buffersize]) -> value
 
Get a socket option.  See the Unix manual for level and option.
If a nonzero buffersize argument is given, the return value is a
string of that length; otherwise it is an integer.

gettimeout(...)

gettimeout() -> timeout
 
Returns the timeout in seconds (float) associated with socket 
operations. A timeout of None indicates that timeouts on socket 
operations are disabled.

ioctl(...)

ioctl(cmd, option) -> long
 
Control the socket with WSAIoctl syscall. Currently supported 'cmd' values are
SIO_RCVALL:  'option' must be one of the socket.RCVALL_* constants.
SIO_KEEPALIVE_VALS:  'option' is a tuple of (onoff, timeout, interval).

listen(...)

listen(backlog)
 
Enable a server to accept connections.  The backlog argument must be at
least 0 (if it is lower, it is set to 0); it specifies the number of
unaccepted connections that the system will allow before refusing new
connections.

makefile(self, mode='r', bufsize=-1)

makefile([mode[, bufsize]]) -> file object
 
Return a regular file object corresponding to the socket.  The mode
and bufsize arguments are as for the built-in open() function.

sendall(...)

sendall(data[, flags])
 
Send a data string to the socket.  For the optional flags
argument, see the Unix manual.  This calls send() repeatedly
until all data is sent.  If an error occurs, it's impossible
to tell how much data has been sent.

setblocking(...)

setblocking(flag)
 
Set the socket to blocking (flag is true) or non-blocking (false).
setblocking(True) is equivalent to settimeout(None);
setblocking(False) is equivalent to settimeout(0.0).

setsockopt(...)

setsockopt(level, option, value)
 
Set a socket option.  See the Unix manual for level and option.
The value argument can either be an integer or a string.

settimeout(...)

settimeout(timeout)
 
Set a timeout on socket operations.  'timeout' can be a float,
giving in seconds, or None.  Setting a timeout of None disables
the timeout feature and is equivalent to setblocking(1).
Setting a timeout of zero is the same as setblocking(0).

shutdown(...)

shutdown(flag)
 
Shut down the reading side of the socket (flag == SHUT_RD), the writing side
of the socket (flag == SHUT_WR), or both ends (flag == SHUT_RDWR).

---

Data descriptors defined here:

__weakref__

list of weak references to the object (if defined)

family

the socket family

proto

the socket protocol

recv

recv_into

recvfrom

recvfrom_into

send

sendto

type

the socket type

 
class timeout(error)    

Method resolution order:

timeout

error

exceptions.IOError

exceptions.EnvironmentError

exceptions.StandardError

exceptions.Exception

exceptions.BaseException

__builtin__.object

---

Data descriptors inherited from error:

__weakref__

list of weak references to the object (if defined)

---

Methods inherited from exceptions.IOError:

__init__(...)

x.__init__(...) initializes x; see help(type(x)) for signature

---

Data and other attributes inherited from exceptions.IOError:

__new__ = <built-in method __new__ of type object>

T.__new__(S, ...) -> a new object with type S, a subtype of T

---

Methods inherited from exceptions.EnvironmentError:

__reduce__(...)

__str__(...)

x.__str__() <==> str(x)

---

Data descriptors inherited from exceptions.EnvironmentError:

errno

exception errno

filename

exception filename

strerror

exception strerror

---

Methods inherited from exceptions.BaseException:

__delattr__(...)

x.__delattr__('name') <==> del x.name

__getattribute__(...)

x.__getattribute__('name') <==> x.name

__getitem__(...)

x.__getitem__(y) <==> x[y]

__getslice__(...)

x.__getslice__(i, j) <==> x[i:j]
 
Use of negative indices is not supported.

__repr__(...)

x.__repr__() <==> repr(x)

__setattr__(...)

x.__setattr__('name', value) <==> x.name = value

__setstate__(...)

__unicode__(...)

---

Data descriptors inherited from exceptions.BaseException:

__dict__

args

message

 
Functions       

create_connection(address, timeout=<object object>, source_address=None)

Connect to *address* and return the socket object.
 
Convenience function.  Connect to *address* (a 2-tuple ``(host,
port)``) and return the socket object.  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.  If *source_address* is set it must be a tuple of (host, port)
for the socket to bind as a source address before making the connection.
An host of '' or port 0 tells the OS to use the default.

getaddrinfo(...)

getaddrinfo(host, port [, family, socktype, proto, flags])
    -> list of (family, socktype, proto, canonname, sockaddr)
 
Resolve host and port into addrinfo struct.

getdefaulttimeout(...)

getdefaulttimeout() -> timeout
 
Returns the default timeout in seconds (float) for new socket objects.
A value of None indicates that new socket objects have no timeout.
When the socket module is first imported, the default is None.

getfqdn(name='')

Get fully qualified domain name from name.
 
An empty argument is interpreted as meaning the local host.
 
First the hostname returned by gethostbyaddr() is checked, then
possibly existing aliases. In case no FQDN is available, hostname
from gethostname() is returned.

gethostbyaddr(...)

gethostbyaddr(host) -> (name, aliaslist, addresslist)
 
Return the true host name, a list of aliases, and a list of IP addresses,
for a host.  The host argument is a string giving a host name or IP number.

gethostbyname(...)

gethostbyname(host) -> address
 
Return the IP address (a string of the form '255.255.255.255') for a host.

gethostbyname_ex(...)

gethostbyname_ex(host) -> (name, aliaslist, addresslist)
 
Return the true host name, a list of aliases, and a list of IP addresses,
for a host.  The host argument is a string giving a host name or IP number.

gethostname(...)

gethostname() -> string
 
Return the current host name.

getnameinfo(...)

getnameinfo(sockaddr, flags) --> (host, port)
 
Get host and port for a sockaddr.

getprotobyname(...)

getprotobyname(name) -> integer
 
Return the protocol number for the named protocol.  (Rarely used.)

getservbyname(...)

getservbyname(servicename[, protocolname]) -> integer
 
Return a port number from a service name and protocol name.
The optional protocol name, if given, should be 'tcp' or 'udp',
otherwise any protocol will match.

getservbyport(...)

getservbyport(port[, protocolname]) -> string
 
Return the service name from a port number and protocol name.
The optional protocol name, if given, should be 'tcp' or 'udp',
otherwise any protocol will match.

htonl(...)

htonl(integer) -> integer
 
Convert a 32-bit integer from host to network byte order.

htons(...)

htons(integer) -> integer
 
Convert a 16-bit integer from host to network byte order.

inet_aton(...)

inet_aton(string) -> packed 32-bit IP representation
 
Convert an IP address in string format (123.45.67.89) to the 32-bit packed
binary format used in low-level network functions.

inet_ntoa(...)

inet_ntoa(packed_ip) -> ip_address_string
 
Convert an IP address from 32-bit packed binary format to string format

ntohl(...)

ntohl(integer) -> integer
 
Convert a 32-bit integer from network to host byte order.

ntohs(...)

ntohs(integer) -> integer
 
Convert a 16-bit integer from network to host byte order.

setdefaulttimeout(...)

setdefaulttimeout(timeout)
 
Set the default timeout in seconds (float) for new socket objects.
A value of None indicates that new socket objects have no timeout.
When the socket module is first imported, the default is None.

 
Data       AF_APPLETALK = 16
AF_DECnet = 12
AF_INET = 2
AF_INET6 = 23
AF_IPX = 6
AF_IRDA = 26
AF_SNA = 11
AF_UNSPEC = 0
AI_ADDRCONFIG = 1024
AI_ALL = 256
AI_CANONNAME = 2
AI_NUMERICHOST = 4
AI_NUMERICSERV = 8
AI_PASSIVE = 1
AI_V4MAPPED = 2048
CAPI = <capsule object "_socket.CAPI">
EAI_AGAIN = 11002
EAI_BADFLAGS = 10022
EAI_FAIL = 11003
EAI_FAMILY = 10047
EAI_MEMORY = 8
EAI_NODATA = 11001
EAI_NONAME = 11001
EAI_SERVICE = 10109
EAI_SOCKTYPE = 10044
INADDR_ALLHOSTS_GROUP = -536870911
INADDR_ANY = 0
INADDR_BROADCAST = -1
INADDR_LOOPBACK = 2130706433
INADDR_MAX_LOCAL_GROUP = -536870657
INADDR_NONE = -1
INADDR_UNSPEC_GROUP = -536870912
IPPORT_RESERVED = 1024
IPPORT_USERRESERVED = 5000
IPPROTO_ICMP = 1
IPPROTO_IP = 0
IPPROTO_RAW = 255
IPPROTO_TCP = 6
IPPROTO_UDP = 17
IPV6_CHECKSUM = 26
IPV6_DONTFRAG = 14
IPV6_HOPLIMIT = 21
IPV6_HOPOPTS = 1
IPV6_JOIN_GROUP = 12
IPV6_LEAVE_GROUP = 13
IPV6_MULTICAST_HOPS = 10
IPV6_MULTICAST_IF = 9
IPV6_MULTICAST_LOOP = 11
IPV6_PKTINFO = 19
IPV6_RECVRTHDR = 38
IPV6_RTHDR = 32
IPV6_UNICAST_HOPS = 4
IPV6_V6ONLY = 27
IP_ADD_MEMBERSHIP = 12
IP_DROP_MEMBERSHIP = 13
IP_HDRINCL = 2
IP_MULTICAST_IF = 9
IP_MULTICAST_LOOP = 11
IP_MULTICAST_TTL = 10
IP_OPTIONS = 1
IP_RECVDSTADDR = 25
IP_TOS = 3
IP_TTL = 4
MSG_CTRUNC = 512
MSG_DONTROUTE = 4
MSG_OOB = 1
MSG_PEEK = 2
MSG_TRUNC = 256
NI_DGRAM = 16
NI_MAXHOST = 1025
NI_MAXSERV = 32
NI_NAMEREQD = 4
NI_NOFQDN = 1
NI_NUMERICHOST = 2
NI_NUMERICSERV = 8
RCVALL_MAX = 3
RCVALL_OFF = 0
RCVALL_ON = 1
RCVALL_SOCKETLEVELONLY = 2
SHUT_RD = 0
SHUT_RDWR = 2
SHUT_WR = 1
SIO_KEEPALIVE_VALS = 2550136836L
SIO_RCVALL = 2550136833L
SOCK_DGRAM = 2
SOCK_RAW = 3
SOCK_RDM = 4
SOCK_SEQPACKET = 5
SOCK_STREAM = 1
SOL_IP = 0
SOL_SOCKET = 65535
SOL_TCP = 6
SOL_UDP = 17
SOMAXCONN = 2147483647
SO_ACCEPTCONN = 2
SO_BROADCAST = 32
SO_DEBUG = 1
SO_DONTROUTE = 16
SO_ERROR = 4103
SO_EXCLUSIVEADDRUSE = -5
SO_KEEPALIVE = 8
SO_LINGER = 128
SO_OOBINLINE = 256
SO_RCVBUF = 4098
SO_RCVLOWAT = 4100
SO_RCVTIMEO = 4102
SO_REUSEADDR = 4
SO_SNDBUF = 4097
SO_SNDLOWAT = 4099
SO_SNDTIMEO = 4101
SO_TYPE = 4104
SO_USELOOPBACK = 64
TCP_MAXSEG = 4
TCP_NODELAY = 1
__all__ = ['getfqdn', 'create_connection', 'AF_APPLETALK', 'AF_DECnet', 'AF_INET', 'AF_INET6', 'AF_IPX', 'AF_IRDA', 'AF_SNA', 'AF_UNSPEC', 'AI_ADDRCONFIG', 'AI_ALL', 'AI_CANONNAME', 'AI_NUMERICHOST', 'AI_NUMERICSERV', 'AI_PASSIVE', 'AI_V4MAPPED', 'CAPI', 'EAI_AGAIN', 'EAI_BADFLAGS', ...]
errorTab = {10004: 'The operation was interrupted.', 10009: 'A bad file handle was passed.', 10013: 'Permission denied.', 10014: 'A fault occurred on the network??', 10022: 'An invalid operation was attempted.', 10035: 'The socket operation would block', 10036: 'A blocking operation is already in progress.', 10048: 'The network address is in use.', 10054: 'The connection has been reset.', 10058: 'The network has been shut down.', ...}
has_ipv6 = True