iceauth(1)

NAME

   iceauth - ICE authority file utility

SYNOPSIS

   iceauth [ -f authfile ] [ -vqib ] [ command arg ... ]

DESCRIPTION

   The  iceauth  program  is  used  to  edit and display the authorization
   information used in connecting with ICE.  This program is usually  used
   to  extract authorization records from one machine and merge them in on
   another (as is the case when using remote logins or granting access  to
   other users).  Commands (described below) may be entered interactively,
   on the iceauth command line, or in scripts.

OPTIONS

   -f authfile  Name of the authority file to use. Will default to
                the file currently in use by the session.

   -v           Turns on extra messages (verbose mode)

   -q           Turns off extra messages (quiet mode)

   -i           Ignore the locks on the authority file

   -b           Break the locks on the authority file

   -u           Print basic usage instructions

   -V           Print version and exit

USAGE

   When iceauth is run it will allow the following set of commands  to  be
   entered interactively or in scripts.

   ?

   List available commands.

   help

   Print  help  information.  You may supply a command name to help to get
   specific information about it.

   info

   Print information about the entries in the authority file.

   list

   List (print) entries in the authority file. You  may  specify  optional
   modifiers as below to specify which entries are listed.

   list [ protocol_name ] [ protocol_data ] [ netid ] [ authname ]

   add

   Add an entry to the authority file. This must be in the format

   add protocol_name protocol_data netid authname authdata

   remove

   Remove entries from the authority file.

   remove [ protocol_name ] [ protocol_data ] [ netid ] [ authname ]

   extract

   Extract  entries  from the authority file in to a destination file. You
   must supply the path to the destination  to  this  command  as  in  the
   following format. Optional specifiers allow you to narrow which entries
   are extracted.

   extract filename [ protocol_name ]  [  protocol_data  ]  [  netid  ]  [
   authname ]

   merge

   Merge entries from other files in to the authority file selected by the
   program. You may supply any number of file paths  to  this  command  as
   follows:

   merge filename1 [ filename2 ] [ filename3 ] ...

   exit

   Save changes and exit the program.

   quit

   Abort changes and exit the program without saving.

   source

   Read and execute commands from a file.

   source filename

AUTHOR

   Ralph Mor, X Consortium

---

Free and Open Source Software