@table @samp
@item ABORT
If there is a call currently active, this will abort that call, and
perform the clean up necessary to allow a new outgoing call.
@item ANNOUNCE user[@@machine][ tty]
Send a talk announcement to the specified user.  They will not be able
to connect to you.  The response message is printed in the log.
@item AUXILIARY UID RUID REQUEST
Using UID (a newly created user id) attach it to a NEW connection to
RUID, an already connected user.  This becomes and AUXILIARY connection
between a parent process (emacs) and an existing remote user (who must
be running emacs).  This connection is made using REQUEST, a single word
representing the function to be run on the remote side in tyrant mode.
This could be used between differing controlling processes for other
purposes.
@item CALL UID user[@@machine][ tty]
Go through the talk protocol to attach to user.  UID is a user ID which
is received by creating a TCP connection to the gtalk process through
the local port.
@item CLEAN
Go through all devices, and user structures, and remove all structures
labeled as DEAD.
@item CONNECT UID socket user[@@machine][ tty]
If the socket of another talk process is available, we can use this
command to simply connect there directly.
@item FILTER UID filter_type
Enable a filter.  Currently, the only filters are ``None'' and
``ROT13''.
@item DELETE announce|invite [host]
Send a DELETE command to host, and print the response message.
@item ECHO
This command simply echoes whatever you type right back.  Useful if you
are unsure gtalk is responding to typed commands.
@item HANGUP UID
This command will hang up on the user specified by UID, where UID is
received when a TCP connection is made to the local port.
@item HELP
Print out help for each command.
@item LEAVE user[@@machine][ tty]
This command will leave an invite for user on your machine.  The
response message is printed out.
@item LOOKUP user[@@machine][ tty]
This command will request a lookup response to see if you are invited by
user.  The response message is printed out.
@item LOAD [file]
This command reads in the specified file of host names (and versions).
If file is not specified, the default hosts file @file{~/.hosts.talk} is
read instead.
@item QUERY
This test command sends a QUERY message to the GNU talk daemon, which
asks for whoever may be calling you at the moment.  Used for testing
purposes.
@item QUIT
This closes all ports and exits the gtalk process.
@item READ [SCRIPT]
Reads the SCRIPT parameter, as though it were more gtalk commands.  If
SCRIPT is not specified, then the default startup file @file{~/.gtalkrc}
is read instead.
@item REPLY UID
Attaches the given UID to whoever happens to be ringing you at this
time.  The protocol asks for whoever is calling, and this command
reports back the name and machine of the person to connect to.
@item ROUTE NETWORKMASK ADDRESS
When sending a UDP packet to a remote talk daemon, the return address is
usually the host id generated from the `hostname' command.  If you have
dial-up dynamic IP, or multiple networks, you may need to use these
filters.  @var{NETWORKMASK} is a mask one might see displayed from the
route command.  The default route (Specified when using the 
@code{--defaultroute} command line parameter) is @code{0.0.0.0}.  If you
have a local network being masqueraded to the Internet, you might add a
route like this:
@example
route 192.168.1.0 myhostname-eth0
@end example
which says that any host matching the first 3 numbers shall be given the
ethernet address, and not the internet address of your dual IP machine.
@item SENDFILE UID <file>
Sends the file specified to user with UID.  This uses a separate TCP
socket to transfer the data.  If the remote has set any associations,
then a special application may be started to view the datafile.
@item SET [OPTIONS]
This command lets you SET some feature or variable.  See the table of
SET options after this table.
@item SHOW [OPTION]
This command will print out information relating to the OPTION
parameter.  The information provided could be an internal list, or the
value of some variable.
@item START UID ALIAS
This command attempts to start an application with ALIAS with user
specified by UID.  Gtalk will create a TCP socket between you and UID,
and then fork the subprocess.  These subprocesses must know that they
are being started in this way.  See the programs test_*.c for how to use
different proxies.  The "SET SHARED" command to learn how to create
aliases.
@item TEST [VERBOSE]
Execute a test for the current system.  This is usually used during
building to aid in configuration and make sure nothing is installed
unless the binary works.  Typing this command will automagically test
the system for all known talk protocols including the GNU protocol, BSD
4.3 talk, and the talk version commonly found on Suns.  The optional
VERBOSE flag turns verbosity on just before the test, and also prints
the runtime status.  The test is described more elsewhere.
@item WAIT UID user[@@machine][ tty]
If we have a method to communicate with another emacs talk process,
(such as @code{etalk-mail}) then we may not wish to use the TALK
protocol.  In this case, wait will simply hang out and wait for another
process to connect to it via this user id.
@end table

The command @samp{SET} can be used with the following optionas of
sub-commands.
@table @asis
@item ACCEPTTCP < NEVER | QUERY | ALWAYS >
Specifies what to do when unsolicited new connections arrive.  If NEVER
is specified, gtalk will emediatly reject them.  If QUERY is specified,
the user is asked (This is the default), and ALWAYS will always allow
the connection.
@item APPLICATION <name>
This option lets you dynamically change the name of the application.  It
defaults to nothing.  If the remote user you are talking to has gtalkd
isntalled, then this name will be displayed when the deamon prints a
message, such as: respond with "booger zappo@@choochoo.ultranet.com"
instead of: respond with "talk zappo@@choochoo.ultranet.com"
@item ASSOCIATION <suffix> <program>
Associated the specified suffix, such as @samp{.gif} with a unix program
designed to interpret that type of file, such as @samp{xv}.  If a data
file is sent, these associations are checked to decide how to display
the transferred data.
@item CLEANUP < MANUAL | AUTO >
The default is AUTO.  This defines how internal object cleanup is
maintained.  Objects include user objects, and device objects which are
created and freed dynamically during normal usage.  If Manual is
selected, objects are not deleted when they are no longer used, but are
instead kept until CLEAN is entered on the command line.  If AUTO is
selected, then objects are deleted when they are no longer used.
@item FILTERDEFAULT <filter method>
Sets the default filter used for all new connections.
It can be one of the available methods built into the executable.
@item DOWNPATH <path>
Specify the download path to use when files are transferred.  The
default is @file{/tmp}.
@item EIGHTBIT [ ON | OFF ]
Toggle, enable, or disable eightbit characters from the keyboard.
Enabled eightbit means that keyboard entered characters with the highbit
set are not interpreted as META keys.  Under X, meta keys (regular keys
during which META is pressed) are still accepted, but are instead
translated into the ESC <key> combination.
@item EDITCHAR 123
This changes the active edit characters used in the gtalk process.
Sequences such as @samp{^H} will parsed to ASCII(8).  The order is
1 DELETE-CHAR, 2 DELETE-LINE, 3 DELETE-WORD.
@item HELP
Print out help for each command.
@item NAME <new name>
Set the name you wish to use.  This name is what is printed in the gtalk
request message.
@item RINGER [ ON | OFF ]
This command will set the ringer on or off.  This creates the
@file{~/.ringer} file read by the GNU talk daemon which allows it to
connect to you.  If ON or OFF is not specified, then the ringer status
is toggled.
@comment FIX THIS
@item SHARED ALIAS <proxy> <display requirements> COMMAND
Creates an association between ALIAS and a complex command which
describes how to start the subprocess.  PROXY is one of NONE, TO_ONE,
and TO_N.  This specifies what role gtalk must take.  TO_ONE and TO_N
have not yet been defined.  Display Requirements can be one of NONE,
KEYBOARD, TTY, X.  KEYBOARD means that the subprocess only needs
keyboard input, which is skimmed from the gtalk interface.  TTY means an
xterm is started with this process in it, and X means that the DISPLAY
environment variable needs to be set to get it to work.
@item VERBOSE [Verbosity level]
Toggles the verbosity of the program.  This includes the printing of
statuses of all daemon related messages, plus other useful stuff.  An
optional parameter will set the value of the verbosity flag to the
desired level.
@end table

This table shows all the options available when using the @samp{SHOW} command.
@table @asis
@item ASSOCIATIONS
Display a list of all currently active associations for transferred file
types.
@item COPYRIGHT
This will display the copyright information for gtalk.  It's the typical
message found at the beginning of GNU source code.
@item DEVICES
This command will print a formatted list of all devices created within
the context of this talk process.  It will contain TCP and UDP sockets
active or closed to remote and local machines.
@item HELP
Print out help for each command.
@item HOSTS
This prints a list of all hosts read into the program, and their known
statistics, including if they were read from a local, or system RC file,
or added at run time.
@item JOBS
Lists all active jobs controlled by gtalk.  These includes any associated
viewers for transferred data files.
@item ROUTE
Display all active routes used for making announcements.
@item SHARED
List all the definitions of shared applications.
@item STATUS
Print out the compile status, and all run time statuses that might prove
interesting.
@item USERS
This prints a formatted list of all user structures created which have
not been cleaned.
@item VERSION
Display the current running version of GTALK.  It is the same string
printed when gtalk starts.
@end table

The @samp{SHOW} commands @samp{DEVICE}, @samp{HOSTS} and @samp{USER} are
useful when debugging, and interesting to view statistically.  The
commands @samp{ANNOUNCE}, @samp{DELETE}, @samp{LEAVE}, @samp{LOOKUP},
and @samp{QUERY} are academically for testing functions for the TALK
protocol, but can prove useful when debugging talk servers and the like.
The @samp{ECHO} command is purely debugging, and is handy when you just
want to verify that the process is alive.

The @samp{TEST} command is for the @samp{check:} rule in the
@file{Makefile} to provide configuration aid.  It can also be accessed
from the command line via: @samp{gtalk -t}

When applicable, the UID command is the username of the person you wish
to specify.  If gtalk is run as an inferious process, it means the user
identifier (a simple integer) used as the handle to the parent process.

Some commands are available only if gtalk is built with debugging
options turned on.  These include ANNOUNCE, DELETE, LEAVE, LOOKUP, and
QUERY.

Some commands are only useful when run under emacs, and are used by
emacs to control normal talk behavior.