# /listsockets

Usage:

/LISTSOCKETS [-sn] [-mstyle] [-Sfield] [-Ttype] [name]

Lists the sockets to which TinyFugue is connected.

Options and arguments:

-s
  short form, list only world names
-n
  print host and port in numeric form
-mstyle
  Use style for pattern matching in other options (default: %{matching}).
-Sfield
  Sort sockets by field. Field may be "name", "type", "character", "host", "port", "lines", "idle", or "-" (don't sort; this is the default). Only the first character is necessary.
-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/c
    an established normal connection
  S/s
    an established connection currently in telnet subnegotiation
  X/x
    an established SSL connection
  O
    an open connectionless socket
  A lowercase state character indicates the connection is using MCCP.
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, 2005 Ken Keys