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.


socket() -- create a new socket object
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() -- mape 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

(*) not available on all platforms!)

Special objects:

SocketType -- type object for socket objects
error -- exception raised for I/O errors

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.


 class error(exceptions.Exception)
           no doc string

fromfd(no arg info)
fromfd(fd, family, type[, proto]) -> socket object
Create a socket object from the given file descriptor.
The remaining arguments are the same as for socket().
gethostbyaddr(no arg info)
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(no arg info)
gethostbyname(host) -> address
Return the IP address (a string of the form '') for a host.
gethostbyname_ex(no arg info)
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(no arg info)
gethostname() -> string
Return the current host name.
getprotobyname(no arg info)
getprotobyname(name) -> integer
Return the protocol number for the named protocol.  (Rarely used.)
getservbyname(no arg info)
getservbyname(servicename, protocolname) -> integer
Return a port number from a service name and protocol name.
The protocol name should be 'tcp' or 'udp'.
htonl(no arg info)
htonl(integer) -> integer
Convert a 32-bit integer from host to network byte order.
htons(no arg info)
htons(integer) -> integer
Convert a 16-bit integer from host to network byte order.
ntohl(no arg info)
ntohl(integer) -> integer
Convert a 32-bit integer from network to host byte order.
ntohs(no arg info)
ntohs(integer) -> integer
Convert a 16-bit integer from network to host byte order.
socket(no arg info)
socket(family, type[, proto]) -> socket object
Open a socket of the given type.  The family argument specifies the
address family; it is normally AF_INET, sometimes AF_UNIX.
The type argument specifies whether this is a stream (SOCK_STREAM)
or datagram (SOCK_DGRAM) socket.  The protocol argument defaults to 0,
specifying the default protocol.