[moira.git] / man / mrtest.8

.TH MRTEST 8 "25 Jan 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
mrtest \- perform Moira operations manually
.SH SYNOPSIS
.B mrtest
.SH DESCRIPTION
.I mrtest
allows one to perform by hand all operations allowed in the Moira
protocol.  There are no command line options, as commands are given to
a prompt within the program.  Control operations are:
.TP
.B connect [server]
make a network connection to the Moira server.  The server
specification is optional.  If present, it is of the form
hostname:portname.  The portname is optional as well, and if specified
will be looked up in
.B /etc/services.
If no server is specified, then the server will be found from the
MOIRASERVER environment variable, the "moira" sloc entry in hesiod, or
the compiled in default, in that order.
.TP
.B disconnect
break the network connection to the Moira server.
.TP
.B host
show the name of the host the client is connected to.
.TP
.B script inputfile [outputfile]
read commands from 
.I inputfile.
If
.I outputfile
is specified, output will be redirected there while
commands are read from
.I inputfile.
The script file may contain comments consisting of lines starting
with a percent sign.  Script files may also recursively perform other
script commands up to 8 scripts deep.
.TP
.B list_requests
lists all of the 
.I mrtest
commands.
.TP
.B quit
exits the program.
.PP
Moira protocol operations include:
.TP
.B noop
does "no operation" to the server, just making sure the server is
still there.
.TP
.B auth
sends
.I Kerberos
tickets to the server to authenticate the user.
.TP
.B motd
gets the current message of the day from the server.
.TP
.B query query_handle [query arguments ...]
performs a query operation on the server.  All of the real work is
done in queries.  There are over 100 queries, each of which requires
different arguments.  the arguments should be placed on the line
following the name of the query, separated by whitespace.
.TP
.B access query_handle [query arguments ...]
performs an authorization check on a query without actually executing
the query.  The arguments are the same as those in the
.B query
command described above.
.SH SEE ALSO
The Project Athena Technical Plan section on Moira for a list of queries
and their arguments, and a description of the protocol this
implements.
Commit	Line	Data
b5d539b4	1	.TH MRTEST 8 "25 Jan 1988" "Project Athena"
d91c7811	2	\" RCSID: $Header$
d91c7811	3	.SH NAME
b5d539b4	4	mrtest \- perform Moira operations manually
d91c7811	5	.SH SYNOPSIS
b5d539b4	6	.B mrtest
d91c7811	7	.SH DESCRIPTION
b5d539b4	8	.I mrtest
b5d539b4	9	allows one to perform by hand all operations allowed in the Moira
d91c7811	10	protocol. There are no command line options, as commands are given to
	11	a prompt within the program. Control operations are:
	12	.TP
b3da4492	13	.B connect [server]
b5d539b4	14	make a network connection to the Moira server. The server
	15	specification is optional. If present, it is of the form
	16	hostname:portname. The portname is optional as well, and if specified
	17	will be looked up in
	18	.B /etc/services.
	19	If no server is specified, then the server will be found from the
	20	MOIRASERVER environment variable, the "moira" sloc entry in hesiod, or
	21	the compiled in default, in that order.
d91c7811	22	.TP
d91c7811	23	.B disconnect
b5d539b4	24	break the network connection to the Moira server.
d91c7811	25	.TP
1e56b68c	26	.B host
	27	show the name of the host the client is connected to.
	28	.TP
d91c7811	29	.B script inputfile [outputfile]
d91c7811	30	read commands from
227344f4	31	.I inputfile.
	32	If
	33	.I outputfile
	34	is specified, output will be redirected there while
d91c7811	35	commands are read from
d91c7811	36	.I inputfile.
227344f4	37	The script file may contain comments consisting of lines starting
	38	with a percent sign. Script files may also recursively perform other
	39	script commands up to 8 scripts deep.
d91c7811	40	.TP
	41	.B list_requests
	42	lists all of the
b5d539b4	43	.I mrtest
227344f4	44	commands.
d91c7811	45	.TP
	46	.B quit
	47	exits the program.
	48	.PP
b5d539b4	49	Moira protocol operations include:
d91c7811	50	.TP
	51	.B noop
	52	does "no operation" to the server, just making sure the server is
	53	still there.
	54	.TP
	55	.B auth
	56	sends
	57	.I Kerberos
	58	tickets to the server to authenticate the user.
	59	.TP
7ba00193	60	.B motd
	61	gets the current message of the day from the server.
	62	.TP
d91c7811	63	.B query query_handle [query arguments ...]
	64	performs a query operation on the server. All of the real work is
	65	done in queries. There are over 100 queries, each of which requires
	66	different arguments. the arguments should be placed on the line
	67	following the name of the query, separated by whitespace.
	68	.TP
b3da4492	69	.B access query_handle [query arguments ...]
d91c7811	70	performs an authorization check on a query without actually executing
	71	the query. The arguments are the same as those in the
	72	.B query
	73	command described above.
d91c7811	74	.SH SEE ALSO
b5d539b4	75	The Project Athena Technical Plan section on Moira for a list of queries
b3da4492	76	and their arguments, and a description of the protocol this
d91c7811	77	implements.