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