source: trunk/third/moira/man/eunice.1 @ 24319

Revision 24319, 4.5 KB checked in by broder, 14 years ago (diff)
New Moira snapshot from SVN.
Line 
1.TH MITCH 1 "6 Jan 2010" "MIT Athena"
2\" RCSID: $HeadURL: svn+ssh://svn.mit.edu/moira/trunk/moira/man/mitch.1 $ $Id: mitch.1 3956 2010-01-05 20:56:56Z zacheiss $
3.SH NAME
4eunice \- examine and modify informtion about printers in Moira
5.SH SYNOPSIS
6.B eunice printername [options]
7.SH DESCRIPTION
8.I Eunice
9is a tool for updating information about printers in Moira.  It
10supports all printer modification commands.
11
12If no options are specified, it will assume \fI-info\fR, which will
13result in all information about the specified printer being displayed.
14
15.SH OPTIONS
16
17.IP \fB-info\ \fRor\ \fB-i\fR
18Display information about a printer. This is the default mode if no
19other options are given. The output is similar to that of moira.
20
21.IP \fB-location\ \fIlocation\ \fRor\ \fB-l\ \fIlocation\fR
22Update the location field for the specified printer to \fIlocation\fR.
23.IP \fB-contact\ \fIcontact\ \fRor\ \fB-c\ \fIcontact\fR
24Update the contact field for the specified printer to \fIcontact\fR.
25
26.IP \fB-hostname\ \fIhostname\ \fRor\ \fB-H\ \fIhostname\fR
27Update the hostname for the specified printer to \fIhostname\fR.
28.IP \fB-mac\ \fIhwaddr\ \fRor\ \fB-m\ \fIhwaddr\fR
29Update the Ethernet hardware address for the printer's hostname record
30to \fIhwaddr\fR.  Note that this information is associated with the host
31record, not the print queue record.
32.IP \fB-remotename\ \fIname\ \fRor\ \fB-r\ \fIname\fR
33Update the remote queue name for the specified printer to \fIname\fR.
34.IP \fB-duplex\ \fIname\ \fRor\ \fB-d\ \fIname\fR
35Update the duplex queue name associated with the specific printer to \fIname\fR.
36.IP \fB-printserver\ \fIhostname\ \fRor\ \fB-s\ \fIhostname\fR
37Update the print server for the specific printer to \fIhostname\fR.  The
38print server may first need to be created via the "Print Servers" menu
39in the moira(1) client before queues may be assigned to it.
40
41.IP \fB-type\ \fItype\ \fRor\ \fB-T\ \fItype\fR
42Update the type for the specified printer to \fItype\fR.  Common types
43include CLUSTER, DORM, PRIVATE, and SAP.
44.IP \fB-model\ \fImodel\ \fRor\ \fB-M\ \fImodel\fR
45Update the model field for the specified printer to \fImodel\fR.  The
46model may first need to be created in the Moira aliases table before it
47can be used.
48
49.IP \fB-kerbauth\ \fRor\ \fB-K\fR
50Require Kerberos authentication of print requests.
51.IP \fB-nokerbauth\ \fRor\ \fB-NK\fR
52Do not require Kerberos authentication of print requests.
53.IP \fB-banner\ \fRor\ \fB-b\fR
54Print header pages by default.  They may still be suppressed by
55client configuration.
56.IP \fB-nobanner\ \fRor\ \fB-nb\fR
57Do not print header pages by default.  They may still be enabled by
58client configuration.
59
60.IP \fB-lpcacl\ \fIlist\ \fRor\ \fB-l\ \fIlist\fR
61Set the LPC acl for the specified printer to \fIlist\fR.
62
63.IP \fB-lpracl\ \fIlist\ \fRor\ \fB-ac\ \fIlist\fR
64Set the restrict list for the specified printer to \fIlist\fR.
65
66.IP \fB-verbose\ \fRor\ \fB-v\fR
67Give more information.  With this flag, mitch will display the
68queries it is making to the moira server.
69.IP \fB-noauth\ \fRor\ \fB-n\fR
70Do not attempt to perform Kerberos authentication with the Moira server.
71Most lookup operations should be still possible without tickets.
72.IP \fB-database\ \fIhost:port\ \fRor\ \fB-db\ \fIhost:port\fR
73Use the specified host and port to contact the Moira database instead of
74the default server.  Both may be symbolic names or numbers.  If the
75port is left off, the default Moira server port will be assumed.  The
76database chosen will be the one specified on the command line, specified
77in the MOIRASERVER environment variable, the hesiod "moira" sloc entry,
78or the compiled in default, in that order or preference.
79
80.IP \fB-create\ \fRor\ \fB-C\fR
81This will create the specified printer, with information provided by
82other options.
83.IP \fB-delete\ \fRor\ \fB-D\fR
84This will delete the specified printer.
85.IP \fB-rename\ \fInewname\ \fRor\ \fB-R\ \fInewname\fR
86This will rename the specified printer to \fInewname\fR.
87
88.SH AUTHORS
89Mark Manley, MIT Information Services & Technology.
90.br
91Garry Zacheiss, MIT Information Services & Technology.
92.SH SEE ALSO
93moira(1)
94
95.SH DIAGNOSTICS
96An exit status of 2 indicates a problem contacting the server. An exit
97status of 1 indicates that the arguments could not be parsed or some
98query to the moira server returned an error. An exit status of 0
99indicates that all operations requested completed successfully.
100
101.SH NOTES
102The printer name doesn't actually have to be the first argument, but
103if you put it anywhere else, it's easy to get the other arguments in the
104wrong order and do something other than what you intended.
105
Note: See TracBrowser for help on using the repository browser.