# /listsockets

Usage:

/LISTSOCKETS [-s] [-mstyle] [-Ttype] [name]

Lists the sockets to which TinyFugue is connected.

Options and arguments:

-s
  short form, list only world names
-mstyle
  Use style for pattern matching in other options (default: %{matching}).
-Ttype
  list only worlds with a type matching the pattern type.
name
  list only worlds with a name matching the pattern name.

The output will look something like this (unless the -s option is given):

         LINES IDLE TYPE      NAME            HOST                       PORT
       10+  48  13h tiny.muck Cave            tcp.com                    2283
    *  foregnd   1m tiny.mush DeepSeas        muds.okstate.edu           6250
             0   7s telnet    whitehouse.gov, whitehouse.gov             smtp
     ?       0  15s tiny      SlowMUD         slow.machine.com           4201

The columns and their meanings are:

unlabeled first column
  "*" marks the current socket.
unlabeled second column
  the state of the socket is one of:
  !
    dead
  ?
    hostname lookup or network connection is incomplete
  C
    an established normal connection
  c
    an established normal connection with MCCP
  X
    an established SSL connection
  x
    an established SSL connection with MCCP
  O
    an open connectionless socket
unlabeled third column
  "P" if the connection is proxied
LINES
  for a background socket, the number of old (seen) and new (unseen) lines past the bottom of the socket's window (ignoring any limit that may be in effect on that window); or, "foregnd" for a foreground socket.
IDLE
  how long since the last text was received on the socket.
TYPE
  the type of the world (set with /addworld -T).
NAME
  the name of the world associated with the socket.
HOST
  the host to which the socket is connected.
PORT
  the port to which the socket is connected.

The return value of /listsockets is the number of sockets listed.

See: sockets, %background, /connect, /fg, nactive(), idle()

Back to index
Back to tf home page

Copyright © 1995, 1996, 1997, 1998, 1999, 2002, 2003, 2004 Ken Keys