Provided by: x11-xserver-utils_7.6+3_i386 bug


       iceauth - ICE authority file utility


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


       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.


       -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


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


       List available commands.


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


       Print information about the entries in the authority file.


       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 an entry to the authority file. This must be in the format

       add protocol_name protocol_data netid authname authdata


       Remove entries from the authority file.

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


       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 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

       merge filename1 [ filename2 ] [ filename3 ] ...


       Save changes and exit the program.


       Abort changes and exit the program without saving.


       Read and execute commands from a file.

       source filename


       Ralph Mor, X Consortium