.TH LISTEN 8 .SH NAME listen, listen1, tcp7, tcp9, tcp19, tcp21, tcp22, tcp23, tcp25, tcp53, tcp110, tcp113, tcp143, tcp513, tcp515, tcp564, tcp565, tcp566, tcp567, tcp993, tcp1723, tcp17007, tcp17009, tcp17010, tcp17013 \- listen for calls on a network device .SH SYNOPSIS .B aux/listen .RB [ -q ] .RB [ -d .IR srvdir ] .RB [ -t .IR trustsrvdir ] .RB [ -n .IR nsfile ] .RI [ net ] .PP .B aux/listen1 [ .B -tv ] .I addr .I cmd [ .I args... ] .SH DESCRIPTION .I listen listens on a network for inbound calls to local services. .I Net is the network protocol on which to listen, by default .BR /net/tcp . The services available are executable, non-empty files in .I srvdir or .IR trustsrvdir . If neither .I srvdir nor .I trustsrvdir is given, .I listen looks for executable files in .BR /bin/service . Services found in .I srvdir are executed as user .BR none ; services found in .I trustsrvdir are executed as the user who started .IR listen . When the user becomes .BR none , a new name space is created using .BR /lib/namespace , or optionally .IR nsfile . Option .B -q suppresses affirmative log information. .PP Service names are made by concatenating the name of the network with the name of the service or port. For example, an inbound call on the TCP network for port 565 executes service .BR tcp565 . .PP The following services are available in .BR /bin/service . .TF \ tcp00000 .TP .B tcp19 .B chargen service. .TP .B tcp17007 serve a piece of the name space using the Plan 9 file system protocol, with authentication (typically used by .IR cpu (1)). .TP .B tcp564 like 17007, without authentication (used by Unix systems to see Plan 9 files). .TP .B il17008 like 17007, but serves the root of the tree, forgoing the negotiation for which subtree to serve. .TP .B tcp17009 remote execution. .TP .B "tcp17010" server for .IR cpu (1) command. .TP .B "tcp17013" server for old .IR cpu (1) command for compatibility with old clients. .TP .B tcp565 report the address of the incoming call. .TP .B tcp21 FTP daemon .TP .B tcp22 .B ssh `secure shell' encrypted terminal connection or file transfer. .TP .B tcp23 .B telnet terminal connection. .TP .B tcp25 mail delivery. .TP .B tcp513 .B rlogin terminal connection. .TP .B tcp515 LP daemon; see .IR lp (8). .TP .B tcp7 echo any bytes received (bit mirror) .TP .B tcp9 consume any bytes received (bit bucket) .TP .B tcp53 TCP port for DNS. .TP .B tcp110 POP3 port. .TP .B tcp143 IMAP4rev1 port. .TP .B tcp113 .B Ident port (always reports .BR none ). .TP .B tcp567 Plan 9 ticket service. .TP .B tcp1723 PPTP (point-to-point tunnelling protocol) service. .PD .PP The following services are available in .BR /bin/service.auth . .TF \ tcp00000 .TP .B tcp566 check a SecureNet box. .TP .B il566 authentication requests. .TP .B tcp993 Secure IMAP4rev1 port. .PD .PP .I Listen1 is a lightweight listener intended for personal use, modeled from Inferno's .\" write out this way so automatic programs .\" don't try to make it into a real man page reference. \fIlisten\fR(1). announces on .IR address , running .I cmd .I args... for each incoming connection; the network directory is passed in the environment as .BR $net . Option .B -t causes .I listen1 to run as the invoking user; the default is to become .B none before listening. Option .B -v causes verbose logging on standard output. See .B /rc/bin/tlssrvtunnel for an example. .SH FILES .TF /env/sysname .TP .B /net/tcp by convention, TCP device bind point .SH SOURCE The sources to .I listen and .I listen1 are .B /sys/src/cmd/aux/listen.c and .BR /sys/src/cmd/aux/listen1.c . The other commands are .IR rc (1) scripts in .BR /rc/bin/service . .SH "SEE ALSO" .IR authsrv (6), .IR dial (2)