summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1994-08-05 13:37:36 (GMT)
committerGuido van Rossum <guido@python.org>1994-08-05 13:37:36 (GMT)
commit781db5d0bb24889dbcd06203b38d4eb886d45f87 (patch)
treef91908f914f83c6c533a8760617579470ab558fd
parent3d0df46fffd07aacfd46a9e1b345588756385f38 (diff)
downloadcpython-781db5d0bb24889dbcd06203b38d4eb886d45f87.zip
cpython-781db5d0bb24889dbcd06203b38d4eb886d45f87.tar.gz
cpython-781db5d0bb24889dbcd06203b38d4eb886d45f87.tar.bz2
* Doc/libsocket.tex (subsection{Socket Object Methods}):
documented gethostname() and a few misc things
-rw-r--r--Doc/lib/libsocket.tex15
-rw-r--r--Doc/libsocket.tex15
2 files changed, 24 insertions, 6 deletions
diff --git a/Doc/lib/libsocket.tex b/Doc/lib/libsocket.tex
index 7596a86..f051be8 100644
--- a/Doc/lib/libsocket.tex
+++ b/Doc/lib/libsocket.tex
@@ -54,14 +54,18 @@ call, similar to the value accompanying \code{posix.error}.
\begin{datadesc}{AF_UNIX}
\dataline{AF_INET}
These constants represent the address (and protocol) families,
-used for the first argument to \code{socket()}.
+used for the first argument to \code{socket()}. If the \code{AF_UNIX}
+constant is not defined then this protocol is unsupported.
\end{datadesc}
\begin{datadesc}{SOCK_STREAM}
\dataline{SOCK_DGRAM}
+\dataline{SOCK_RAW}
+\dataline{SOCK_RDM}
+\dataline{SOCK_SEQPACKET}
These constants represent the socket types,
used for the second argument to \code{socket()}.
-(There are other types, but only \code{SOCK_STREAM} and
+(Only \code{SOCK_STREAM} and
\code{SOCK_DGRAM} appear to be generally useful.)
\end{datadesc}
@@ -71,6 +75,11 @@ returned as a string, e.g., \code{'100.50.200.5'}. If the host name
is an IP address itself it is returned unchanged.
\end{funcdesc}
+\begin{funcdesc}{gethostname}{}
+Return the current host's canonical name, as a string
+(e.g. \code{'voorn.cwi.nl'}).
+\end{funcdesc}
+
\begin{funcdesc}{getservbyname}{servicename\, protocolname}
Translate an Internet service name and protocol name to a port number
for that service. The protocol name should be \code{'tcp'} or
@@ -139,7 +148,7 @@ with \code{select}.
Return the remote address to which the socket is connected. This is
useful to find out the port number of a remote IP socket, for instance.
(The format of the address returned depends on the address family --
-see above.)
+see above.) On some systems this function is not supported.
\end{funcdesc}
\begin{funcdesc}{getsockname}{}
diff --git a/Doc/libsocket.tex b/Doc/libsocket.tex
index 7596a86..f051be8 100644
--- a/Doc/libsocket.tex
+++ b/Doc/libsocket.tex
@@ -54,14 +54,18 @@ call, similar to the value accompanying \code{posix.error}.
\begin{datadesc}{AF_UNIX}
\dataline{AF_INET}
These constants represent the address (and protocol) families,
-used for the first argument to \code{socket()}.
+used for the first argument to \code{socket()}. If the \code{AF_UNIX}
+constant is not defined then this protocol is unsupported.
\end{datadesc}
\begin{datadesc}{SOCK_STREAM}
\dataline{SOCK_DGRAM}
+\dataline{SOCK_RAW}
+\dataline{SOCK_RDM}
+\dataline{SOCK_SEQPACKET}
These constants represent the socket types,
used for the second argument to \code{socket()}.
-(There are other types, but only \code{SOCK_STREAM} and
+(Only \code{SOCK_STREAM} and
\code{SOCK_DGRAM} appear to be generally useful.)
\end{datadesc}
@@ -71,6 +75,11 @@ returned as a string, e.g., \code{'100.50.200.5'}. If the host name
is an IP address itself it is returned unchanged.
\end{funcdesc}
+\begin{funcdesc}{gethostname}{}
+Return the current host's canonical name, as a string
+(e.g. \code{'voorn.cwi.nl'}).
+\end{funcdesc}
+
\begin{funcdesc}{getservbyname}{servicename\, protocolname}
Translate an Internet service name and protocol name to a port number
for that service. The protocol name should be \code{'tcp'} or
@@ -139,7 +148,7 @@ with \code{select}.
Return the remote address to which the socket is connected. This is
useful to find out the port number of a remote IP socket, for instance.
(The format of the address returned depends on the address family --
-see above.)
+see above.) On some systems this function is not supported.
\end{funcdesc}
\begin{funcdesc}{getsockname}{}