diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2002-10-01 10:03:18 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2002-10-01 10:03:18 (GMT) |
| commit | 1f408e9dd0d9ca629d615ed2ced226939b49cf91 (patch) | |
| tree | d9c4a121b7deb311371cf6549523beb76df83dee /doc | |
| parent | f2bbcb665622b4587e54b7b109f8011a9787baac (diff) | |
| download | tcl-1f408e9dd0d9ca629d615ed2ced226939b49cf91.zip tcl-1f408e9dd0d9ca629d615ed2ced226939b49cf91.tar.gz tcl-1f408e9dd0d9ca629d615ed2ced226939b49cf91.tar.bz2 | |
Mentioned that [socket] takes service names as well as port numbers.
It always did, but some people didn't know.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/socket.n | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/doc/socket.n b/doc/socket.n index 4fe53f4..51332f7 100644 --- a/doc/socket.n +++ b/doc/socket.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: socket.n,v 1.6 2001/09/19 10:57:32 dkf Exp $ +'\" RCS: @(#) $Id: socket.n,v 1.7 2002/10/01 10:03:19 dkf Exp $ .so man.macros .TH socket n 8.0 Tcl "Tcl Built-In Commands" .BS @@ -37,7 +37,9 @@ connection is opened and the command returns a channel identifier that can be used for both reading and writing. \fIPort\fR and \fIhost\fR specify a port to connect to; there must be a server accepting connections on -this port. \fIPort\fR is an integer port number and \fIhost\fR +this port. \fIPort\fR is an integer port number +(or service name, where supported and understood by the host operating +system) and \fIhost\fR is either a domain-style name such as \fBwww.sunlabs.com\fR or a numerical IP address such as \fB127.0.0.1\fR. Use \fIlocalhost\fR to refer to the host on which the command is invoked. @@ -53,7 +55,9 @@ interfaces. If the option is omitted then the client-side interface will be chosen by the system software. .TP \fB\-myport\fI port\fR -\fIPort\fR specifies an integer port number to use for the client's +\fIPort\fR specifies an integer port number (or service name, where +supported and understood by the host operating system) to use for the +client's side of the connection. If this option is omitted, the client's port number will be chosen at random by the system software. .TP @@ -71,7 +75,9 @@ returns immediately and \fBfblocked\fR on the socket returns 1. .SH "SERVER SOCKETS" .PP If the \fB\-server\fR option is specified then the new socket -will be a server for the port given by \fIport\fR. +will be a server for the port given by \fIport\fR (either an integer +or a service name, where supported and understood by the host +operating system). Tcl will automatically accept connections to the given port. For each connection Tcl will create a new channel that may be used to communicate with the client. Tcl then invokes \fIcommand\fR |