Debian Codegraph @

upstream/debian-unstable/man1/iceauth.1

raw
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