head	1.1;
branch	1.1.1;
access;
symbols
	iceauth-1-0-11:1.1.1.4
	netbsd-11-0-RC6:1.1.1.3
	netbsd-11-0-RC5:1.1.1.3
	netbsd-11-0-RC4:1.1.1.3
	netbsd-11-0-RC3:1.1.1.3
	netbsd-11-0-RC2:1.1.1.3
	netbsd-11-0-RC1:1.1.1.3
	netbsd-11:1.1.1.3.0.6
	netbsd-11-base:1.1.1.3
	netbsd-10-1-RELEASE:1.1.1.3
	iceauth-1-0-10:1.1.1.3
	netbsd-8-3-RELEASE:1.1.1.2
	netbsd-9-4-RELEASE:1.1.1.3
	netbsd-10-0-RELEASE:1.1.1.3
	netbsd-10-0-RC6:1.1.1.3
	netbsd-10-0-RC5:1.1.1.3
	netbsd-10-0-RC4:1.1.1.3
	netbsd-10-0-RC3:1.1.1.3
	netbsd-10-0-RC2:1.1.1.3
	netbsd-10-0-RC1:1.1.1.3
	netbsd-10:1.1.1.3.0.4
	netbsd-10-base:1.1.1.3
	netbsd-9-3-RELEASE:1.1.1.3
	iceauth-1-0-9:1.1.1.3
	netbsd-9-2-RELEASE:1.1.1.3
	netbsd-9-1-RELEASE:1.1.1.3
	netbsd-8-2-RELEASE:1.1.1.2
	netbsd-9-0-RELEASE:1.1.1.3
	netbsd-9-0-RC2:1.1.1.3
	netbsd-9-0-RC1:1.1.1.3
	netbsd-9:1.1.1.3.0.2
	netbsd-9-base:1.1.1.3
	netbsd-8-1-RELEASE:1.1.1.2
	netbsd-8-1-RC1:1.1.1.2
	netbsd-7-2-RELEASE:1.1.1.1
	netbsd-8-0-RELEASE:1.1.1.2
	netbsd-8-0-RC2:1.1.1.2
	netbsd-8-0-RC1:1.1.1.2
	netbsd-7-1-2-RELEASE:1.1.1.1
	iceauth-1-0-8:1.1.1.3
	netbsd-7-1-1-RELEASE:1.1.1.1
	netbsd-8:1.1.1.2.0.2
	netbsd-8-base:1.1.1.2
	netbsd-7-1:1.1.1.1.0.14
	netbsd-7-1-RELEASE:1.1.1.1
	netbsd-7-1-RC2:1.1.1.1
	netbsd-7-1-RC1:1.1.1.1
	netbsd-7-0-2-RELEASE:1.1.1.1
	netbsd-7-0-1-RELEASE:1.1.1.1
	netbsd-7-0:1.1.1.1.0.12
	netbsd-7-0-RELEASE:1.1.1.1
	netbsd-7-0-RC3:1.1.1.1
	netbsd-7-0-RC2:1.1.1.1
	iceauth-1-0-7:1.1.1.2
	netbsd-7-0-RC1:1.1.1.1
	netbsd-6-0-6-RELEASE:1.1.1.1
	netbsd-6-1-5-RELEASE:1.1.1.1
	netbsd-7:1.1.1.1.0.10
	netbsd-7-base:1.1.1.1
	netbsd-6-1-4-RELEASE:1.1.1.1
	netbsd-6-0-5-RELEASE:1.1.1.1
	riastradh-xf86-video-intel-2-7-1-pre-2-21-15:1.1.1.1
	iceauth-1-0-6:1.1.1.1
	riastradh-drm2:1.1.1.1.0.8
	riastradh-drm2-base:1.1.1.1
	netbsd-6-1-3-RELEASE:1.1.1.1
	netbsd-6-0-4-RELEASE:1.1.1.1
	netbsd-6-1-2-RELEASE:1.1.1.1
	netbsd-6-0-3-RELEASE:1.1.1.1
	netbsd-6-1-1-RELEASE:1.1.1.1
	netbsd-6-1:1.1.1.1.0.6
	netbsd-6-0-2-RELEASE:1.1.1.1
	netbsd-6-1-RELEASE:1.1.1.1
	netbsd-6-1-RC4:1.1.1.1
	netbsd-6-1-RC3:1.1.1.1
	netbsd-6-1-RC2:1.1.1.1
	netbsd-6-1-RC1:1.1.1.1
	netbsd-6-0-1-RELEASE:1.1.1.1
	netbsd-6-0:1.1.1.1.0.4
	netbsd-6-0-RELEASE:1.1.1.1
	netbsd-6-0-RC2:1.1.1.1
	netbsd-6-0-RC1:1.1.1.1
	netbsd-6:1.1.1.1.0.2
	netbsd-6-base:1.1.1.1
	iceauth-1-0-5:1.1.1.1
	xorg:1.1.1;
locks; strict;
comment	@.\" @;


1.1
date	2011.07.23.05.54.01;	author mrg;	state Exp;
branches
	1.1.1.1;
next	;

1.1.1.1
date	2011.07.23.05.54.01;	author mrg;	state Exp;
branches;
next	1.1.1.2;

1.1.1.2
date	2015.07.17.03.19.53;	author mrg;	state Exp;
branches;
next	1.1.1.3;
commitid	f8Y7Xes6H0IFsAty;

1.1.1.3
date	2018.03.11.07.23.10;	author mrg;	state Exp;
branches;
next	1.1.1.4;
commitid	wSqiZnuqP8n0H0uA;

1.1.1.4
date	2026.07.12.00.38.32;	author mrg;	state Exp;
branches;
next	;
commitid	ExaBPmqzwazOziNG;


desc
@@


1.1
log
@Initial revision
@
text
@.\" 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", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
.\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
.\" SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall not
.\" be used in advertising or otherwise to promote the sale, use or other
.\" dealing in this Software without prior written authorization from the
.\" The Open Group.
.\"
.TH ICEAUTH 1 __xorgversion__
.SH NAME
iceauth \- ICE authority file utility
.SH SYNOPSIS
.B iceauth
[ \fB\-f\fP \fIauthfile\fP ] [ \fB\-vqib\fP ] [ \fIcommand arg ...\fP ]
.SH DESCRIPTION
.PP
The \fIiceauth\fP 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 \fIiceauth\fP command line, or in scripts.
.SH OPTIONS
.PP
\fB\-f\fP \fIauthfile\fP  Name of the authority file to use. Will default to
             the file currently in use by the session.
.PP
\fB\-v\fP           Turns on extra messages (verbose mode)
.PP
\fB\-q\fP           Turns off extra messages (quiet mode)
.PP
\fB\-i\fP           Ignore the locks on the authority file
.PP
\fB\-b\fP           Break the locks on the authority file
.PP
\fB\-u\fP           Print basic usage instructions
.PP
.SH USAGE
.PP
When \fIiceauth\fP is run it will allow the following set of commands
to be entered interactively or in scripts.
.PP
\fB?\fP
.PP
List available commands.
.PP
\fBhelp\fP
.PP
Print help information. You may supply a command name to \fIhelp\fP to
get specific information about it.
.PP
\fBinfo\fP
.PP
Print information about the entries in the authority file.
.PP
\fBlist\fP
.PP
List (print) entries in the authority file. You may specify optional
modifiers as below to specify which entries are listed.
.PP
\fIlist\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ] [
\fInetid\fP ] [ \fIauthname\fP ]
.PP
\fBadd\fP
.PP
Add an entry to the authority file. This must be in the format
.PP
\fIadd\fP \fIprotocol_name\fP \fIprotocol_data\fP \fInetid\fP \fIauthname\fP \fIauthdata\fP
.PP
\fBremove\fP
.PP
Remove entries from the authority file.
.PP
\fIremove\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ] [
\fInetid\fP ] [ \fIauthname\fP ]
.PP
\fBextract\fP
.PP
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.
.PP
\fIextract\fP \fIfilename\fP [ \fIprotocol_name\fP ] [ \fIprotocol_data\fP ]
[ \fInetid\fP ] [ \fIauthname\fP ]
.PP
\fBmerge\fP
.PP
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:
.PP
\fImerge\fP \fIfilename1\fP [ \fIfilename2\fP ] [ \fIfilename3\fP ] ...
.PP
\fBexit\fP
.PP
Save changes and exit the program.
.PP
\fBquit\fP
.PP
Abort changes and exit the program without saving.
.PP
\fBsource\fP
.PP
Read and execute commands from a file.
.PP
\fIsource\fP \fIfilename\fP
.PP
.SH AUTHOR
Ralph Mor, X Consortium
@


1.1.1.1
log
@initial import of iceauth-1.0.5.  important changes include:
	support filesystems without link() support
@
text
@@


1.1.1.2
log
@initial import of iceauth-1.0.7
@
text
@a53 2
\fB\-V\fP           Print version and exit
.PP
@


1.1.1.3
log
@initial import of iceauth-1.0.8
@
text
@d30 1
a30 1
[ \fB\-f\fP \fIauthfile\fP ] [ \fB\-vqibuV\fP ] [ \fIcommand arg ...\fP ]
@


1.1.1.4
log
@initial import of iceauth-1.0.11
@
text
@d25 1
a25 1
.TH ICEAUTH 1 2025-04-26 __xorgversion__
d30 1
a30 1
[\fB\-f\fP \fIauthfile\fP] [\fB\-vqibuV\fP] [\fIcommand arg ...\fP]
d32 7
a38 8
The \fBiceauth\fP program is used to edit and display the authorization
information used in connecting with ICE
(the X11 Inter-Client Exchange protocol).
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 \fBiceauth\fP command line, or in scripts.
d40 16
a55 28
.TP 16
.BI \-f " authfile"
Name of the authority file to use.
Will default to the file currently in use by the session.
.TP 16
.B \-v
Turns on extra messages (verbose mode)
.TP 16
.B \-q
Turns off extra messages (quiet mode)
.TP 16
.B \-i
Ignore the locks on the authority file
.TP 16
.B \-b
Break the locks on the authority file
.TP 16
.B \-u
Print basic usage instructions
.TP 16
.B \--help
Print basic usage instructions
.TP 16
.B \-V
Print version and exit
.TP 16
.B \-\-version
Print version and exit
d57 2
a58 1
When \fBiceauth\fP is run it will allow the following set of commands
d60 3
a62 7
Remember that arguments given on the shell command line will be displayed in
shell histories and may be visible to other users via tools such as
.BR ps (1),
thus exposing the value of any cookies or other authentication secrets
provided on the shell command line.
.TP
.B ?
d64 8
a71 7
.TP
.B help
Print help information.
You may supply a command name to \fIhelp\fP
to get specific information about it.
.TP
.B info
d73 17
a89 12
.TP
\fBlist\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
List (print) entries in the authority file.
You may specify optional modifiers to specify which entries are listed.
.TP
\fBadd\fP \fIprotocol_name\fP \fIprotocol_data\fP \fInetid\fP \
\fIauthname\fP \fIauthdata\fP
Add an entry to the authority file.
.TP
\fBremove\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
d91 22
a112 12
.TP
\fBextract\fP \fIfilename\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
Extract entries from the authority file in to a destination file.
You must supply the path to the destination file.
Optional specifiers allow you to narrow which entries are extracted.
.TP
\fBmerge\fP \fIfilename1\fP [\fIfilename2\fP [\fIfilename3\fP]]...
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.
.TP
.B exit
d114 3
a116 2
.TP
.B quit
d118 3
a120 2
.TP
\fBsource\fP \fIfilename\fP
d122 3
@