iceauth (1)

Leading comments

Copyright 1994, 1998  The Open Group

Permission to use, copy, modify, distribute, and sell this software and its
documentation for any purpose is hereby granted without fee, provided that
the above copyright notice appear in all copies and that both that
copyright notice and this permission notice appear in supporting
documentation.

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS"...

(The comments found at the beginning of the groff file "man1/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