NAME

       ltpadmin - ION Licklider Transmission Protocol (LTP) administration interface

SYNOPSIS

       ltpadmin [ commands_filename | . ]

DESCRIPTION

       ltpadmin configures, starts, manages, and stops LTP operations for the local ION node.

       It operates in response to LTP configuration commands found in the file commands_filename,
       if provided; if not, ltpadmin prints a simple prompt (:) so that the user may type
       commands directly into standard input.  If commands_filename is a period (.), the effect
       is the same as if a command file containing the single command 'x' were passed to ltpadmin
       -- that is, the ION node's ltpclock task, ltpmeter tasks, and link service adapter tasks
       are stopped.

       The format of commands for commands_filename can be queried from ltpadmin with the 'h' or
       '?' commands at the prompt.  The commands are documented in ltprc(5).

EXIT STATUS

       "0" Successful completion of LTP administration.

EXAMPLES

       ltpadmin
           Enter interactive LTP configuration command entry mode.

       ltpadmin host1.ltp
           Execute all configuration commands in host1.ltp, then terminate immediately.

       ltpadmin .
           Stop all LTP operations on the local node.

FILES

       See ltprc(5) for details of the LTP configuration commands.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       Note: all ION administration utilities expect source file input to be lines of ASCII text
       that are NL-delimited.  If you edit the ltprc file on a Windows machine, be sure to use
       dos2unix to convert it to Unix text format before presenting it to ltpadmin.  Otherwise
       ltpadmin will detect syntax errors and will not function satisfactorily.

       The following diagnostics may be issued to the logfile ion.log:

       ltpadmin can't attach to ION.
           There is no SDR data store for ltpadmin to use.  You should run ionadmin(1) first, to
           set up an SDR data store for ION.

       Can't open command file...
           The commands_filename specified in the command line doesn't exist.

       Various errors that don't cause ltpadmin to fail but are noted in the ion.log log file may
       be caused by improperly formatted commands given at the prompt or in the commands_filename
       file.  Please see ltprc(5) for details.

BUGS

       Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

SEE ALSO

       ltpmeter(1), ltprc(5)