| 1 |
.\" Copyright 1994, 1998 The Open Group |
| 2 |
.\" |
| 3 |
.\" Permission to use, copy, modify, distribute, and sell this software and its |
| 4 |
.\" documentation for any purpose is hereby granted without fee, provided that |
| 5 |
.\" the above copyright notice appear in all copies and that both that |
| 6 |
.\" copyright notice and this permission notice appear in supporting |
| 7 |
.\" documentation. |
| 8 |
.\" |
| 9 |
.\" The above copyright notice and this permission notice shall be included in |
| 10 |
.\" all copies or substantial portions of the Software. |
| 11 |
.\" |
| 12 |
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR |
| 13 |
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, |
| 14 |
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL |
| 15 |
.\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, |
| 16 |
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF |
| 17 |
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE |
| 18 |
.\" SOFTWARE. |
| 19 |
.\" |
| 20 |
.\" Except as contained in this notice, the name of The Open Group shall not |
| 21 |
.\" be used in advertising or otherwise to promote the sale, use or other |
| 22 |
.\" dealing in this Software without prior written authorization from the |
| 23 |
.\" The Open Group. |
| 24 |
.\" |
| 25 |
.TH ICEAUTH 1 "iceauth 1.0.10" "X Version 11" |
| 26 |
.SH NAME |
| 27 |
iceauth \- ICE authority file utility |
| 28 |
.SH SYNOPSIS |
| 29 |
.B iceauth |
| 30 |
[ \fB\-f\fP \fIauthfile\fP ] [ \fB\-vqibuV\fP ] [ \fIcommand arg ...\fP ] |
| 31 |
.SH DESCRIPTION |
| 32 |
.PP |
| 33 |
The \fIiceauth\fP program is used to edit and display the authorization |
| 34 |
information used in connecting with ICE. This program is usually |
| 35 |
used to extract authorization records from one machine and merge them in on |
| 36 |
another (as is the case when using remote logins or granting access to |
| 37 |
other users). Commands (described below) may be entered interactively, |
| 38 |
on the \fIiceauth\fP command line, or in scripts. |
| 39 |
.SH OPTIONS |
| 40 |
.PP |
| 41 |
\fB\-f\fP \fIauthfile\fP Name of the authority file to use. Will default to |
| 42 |
the file currently in use by the session. |
| 43 |
.PP |
| 44 |
\fB\-v\fP Turns on extra messages (verbose mode) |
| 45 |
.PP |
| 46 |
\fB\-q\fP Turns off extra messages (quiet mode) |
| 47 |
.PP |
| 48 |
\fB\-i\fP Ignore the locks on the authority file |
| 49 |
.PP |
| 50 |
\fB\-b\fP Break the locks on the authority file |
| 51 |
.PP |
| 52 |
\fB\-u\fP Print basic usage instructions |
| 53 |
.PP |
| 54 |
\fB\-V\fP Print version and exit |
| 55 |
.PP |
| 56 |
.SH USAGE |
| 57 |
.PP |
| 58 |
When \fIiceauth\fP is run it will allow the following set of commands |
| 59 |
to be entered interactively or in scripts. |
| 60 |
.PP |
| 61 |
\fB?\fP |
| 62 |
.PP |
| 63 |
List available commands. |
| 64 |
.PP |
| 65 |
\fBhelp\fP |
| 66 |
.PP |
| 67 |
Print help information. You may supply a command name to \fIhelp\fP to |
| 68 |
get specific information about it. |
| 69 |
.PP |
| 70 |
\fBinfo\fP |
| 71 |
.PP |
| 72 |
Print information about the entries in the authority file. |
| 73 |
.PP |
| 74 |
\fBlist\fP |
| 75 |
.PP |
| 76 |
List (print) entries in the authority file. You may specify optional |
| 77 |
modifiers as below to specify which entries are listed. |
| 78 |
.PP |
| 79 |
\fIlist\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ] [ |
| 80 |
\fInetid\fP ] [ \fIauthname\fP ] |
| 81 |
.PP |
| 82 |
\fBadd\fP |
| 83 |
.PP |
| 84 |
Add an entry to the authority file. This must be in the format |
| 85 |
.PP |
| 86 |
\fIadd\fP \fIprotocol_name\fP \fIprotocol_data\fP \fInetid\fP \fIauthname\fP \fIauthdata\fP |
| 87 |
.PP |
| 88 |
\fBremove\fP |
| 89 |
.PP |
| 90 |
Remove entries from the authority file. |
| 91 |
.PP |
| 92 |
\fIremove\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ] [ |
| 93 |
\fInetid\fP ] [ \fIauthname\fP ] |
| 94 |
.PP |
| 95 |
\fBextract\fP |
| 96 |
.PP |
| 97 |
Extract entries from the authority file in to a destination file. You |
| 98 |
must supply the path to the destination to this command as in the |
| 99 |
following format. Optional specifiers allow you to narrow which |
| 100 |
entries are extracted. |
| 101 |
.PP |
| 102 |
\fIextract\fP \fIfilename\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ] |
| 103 |
[ \fInetid\fP ] [ \fIauthname\fP ] |
| 104 |
.PP |
| 105 |
\fBmerge\fP |
| 106 |
.PP |
| 107 |
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: |
| 108 |
.PP |
| 109 |
\fImerge\fP \fIfilename1\fP [ \fIfilename2\fP ] [ \fIfilename3\fP ] ... |
| 110 |
.PP |
| 111 |
\fBexit\fP |
| 112 |
.PP |
| 113 |
Save changes and exit the program. |
| 114 |
.PP |
| 115 |
\fBquit\fP |
| 116 |
.PP |
| 117 |
Abort changes and exit the program without saving. |
| 118 |
.PP |
| 119 |
\fBsource\fP |
| 120 |
.PP |
| 121 |
Read and execute commands from a file. |
| 122 |
.PP |
| 123 |
\fIsource\fP \fIfilename\fP |
| 124 |
.PP |
| 125 |
.SH AUTHOR |
| 126 |
Ralph Mor, X Consortium |