From 1f408e9dd0d9ca629d615ed2ced226939b49cf91 Mon Sep 17 00:00:00 2001 From: dkf Date: Tue, 1 Oct 2002 10:03:18 +0000 Subject: Mentioned that [socket] takes service names as well as port numbers. It always did, but some people didn't know. --- ChangeLog | 5 +++++ doc/socket.n | 14 ++++++++++---- 2 files changed, 15 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index e82a9c3..63ede3e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,8 @@ +2002-10-01 Donal K. Fellows + + * doc/socket.n: Mentioned that ports may be specified as serivce + names as well as integers. [Bug 616843] + 2002-09-30 Jeff Hobbs * generic/tclCompCmds.c (TclCompileRegexpCmd): correct the 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 -- cgit v0.12