The following printer options may appear in any order.
The message sent appears as follows:
to change the page list to print, the current request will be reprinted from the beginning.
The reason(s) it stopped (multiple reasons indicate reprinted attempts):
The LP print service can detect printer faults only through an adequate fast filter and only when the standard interface program or a suitable customized interface program is used. Furthermore, the level of recovery after a fault depends on the capabilities of the filter.
If the printer is all, the alerting defined in this command applies to all existing printers.
If the -W option is not used to arrange fault alerting for printer, the default procedure is to mail one message to the administrator of printer per fault. This is equivalent to specifying -W once or -W 0. If minutes is a number greater than zero, an alert will be sent at intervals specified by minutes.
During the wait, the administrator or the user who submitted the stopped print request can issue a change request that specifies where printing should resume. (See the -i option of the lp command.) If no change request is made before printing is enabled, printing resumes at the top of the page where stopped, if the filter allows; otherwise, the request is printed from the beginning.
For each printer, the LP print service keeps two lists of forms: an ``allow-list'' of forms that may be used with the printer, and a ``deny-list'' of forms that may not be used with the printer. With the -f allow option, the forms listed are added to the allow-list and removed from the deny-list. With the -f deny option, the forms listed are added to the deny-list and removed from the allow-list.
If the allow-list is not empty, only the forms in the list may be used on the printer, regardless of the contents of the deny-list. If the allow-list is empty, but the deny-list is not, the forms in the deny-list may not be used with the printer. All forms can be excluded from a printer by specifying -f deny:all. All forms can be used on a printer (provided the printer can handle all the characteristics of each form) by specifying -f allow:all.
The LP print service uses this information as a set of guidelines for determining where a form can be mounted. Administrators, however, are not restricted from mounting a form on any printer. If mounting a form on a particular printer is in disagreement with the information in the allow-list or deny-list, the administrator is warned but the mount is accepted. Nonetheless, if a user attempts to issue a print or change request for a form and printer combination that is in disagreement with the information, the request is accepted only if the form is currently mounted on the printer. If the form is later unmounted before the request can print, the request is canceled and the user is notified by mail.
If the administrator tries to specify a form as acceptable for use on a printer that doesn't have the capabilities needed by the form, the command is rejected.
Note the other use of -f, with the -M option, below.
The -T option must be invoked first with lpadmin to identify the printer type before the -f option can be used.
The type simple is recognized as the default content type for files in the UNIX system. A simple type of file is a data stream containing only printable ASCII characters and the following control characters.
Control Character Octal Value Meaning backspace $10 sub 8$ move back one character, except at beginning of line tab $11 sub 8$ move to next tab stop linefeed (newline) $12 sub 8$ move to beginning of next line form feed $14 sub 8$ move to beginning of next page carriage return $15 sub 8$ move to beginning of current line
To prevent the print service from considering simple a valid type for the printer, specify either an explicit value (such as the printer type) in the content-type-list, or an empty list. If you do want simple included along with other types, you must include simple in the content-type-list.
Except for simple, each content-type name is freely determined by the administrator. If the printer type is specified by the -T option, then the printer type is implicitly considered to be also a valid content type.
The page length and width, and character and line pitches needed by the form are compared with those allowed for the printer, by checking the capabilities in the terminfo database for the type of printer. If the form requires attributes that are not available with the printer, the administrator is warned but the mount is accepted. If the form lists a print wheel as mandatory, but the print wheel mounted on the printer is different, the administrator is also warned but the mount is accepted.
If the -a option is given, an alignment pattern is printed, preceded by the same initialization of the physical printer that precedes a normal print request, with one exception: no banner page is printed. Printing is assumed to start at the top of the first page of the form. After the pattern is printed, the administrator can adjust the mounted form in the printer and press return for another alignment pattern (no initialization this time), and can continue printing as many alignment patterns as desired. The administrator can quit the printing of alignment patterns by typing q.
If the -o filebreak option is given, a formfeed is inserted between each copy of the alignment pattern. By default, the alignment pattern is assumed to correctly fill a form, so no formfeed is added.
If the -t tray-number option is specified, printer tray tray-number will used.
A form is ``unmounted'' either by mounting a new form in its place or by using the -f none option. By default, a new printer has no form mounted.
Note the other use of -f without the -M option above.
If the print-wheel is not listed as acceptable for the printer, the administrator is warned but the mount is accepted. If the printer does not take print wheels, the command is rejected.
A print wheel is ``unmounted'' either by mounting a new print wheel in its place or by using the option -S none. By default, a new printer has no print wheel mounted.
Note the other uses of the -S option without the -M option described below.
length=scaled-decimal-number width=scaled-decimal-number cpi=scaled-decimal-number lpi=scaled-decimal-number stty='stty-option-list'
The term scaled-decimal-number refers to a non-negative number used to indicate a unit of size. The type of unit is shown by a ``trailing'' letter attached to the number. Three types of scaled decimal numbers can be used with the LP print service: numbers that show sizes in centimeters (marked with a trailing c); numbers that show sizes in inches (marked with a trailing i); and numbers that show sizes in units appropriate to use (without a trailing letter), that is, lines, characters, lines per inch, or characters per inch.
The first four default option values must agree with the capabilities of the type of physical printer, as defined in the terminfo database for the printer type. If they do not, the command is rejected.
The stty-option-list is not checked for allowed values, but is passed directly to the stty program by the standard interface program. Any error messages produced by stty when a request is processed (by the standard interface program) are mailed to the user submitting the request.
For each option not specified, the defaults for the following attributes are defined in the terminfo entry for the specified printer type.
length width cpi lpi
The default for stty is
stty='9600 cs8 -cstopb -parenb ixon -ixany opost -olcuc onlcr -ocrnl -onocr -onlret -ofill nl0 cr0 tab0 bs0 vt0 ff0'
You can set any of the -o options to the default values (which vary for different types of printers), by typing them without assigned values, as follows:
length= width= cpi= lpi= stty=
If the printer is a type that takes print wheels, then list is a comma or space separated list of print wheel names. (Enclose the list with quotes if it contains blank spaces.) These will be the only print wheels considered mountable on the printer. (You can always force a different print wheel to be mounted.) Until the option is used to specify a list, no print wheels will be considered mountable on the printer, and print requests that ask for a particular print wheel with this printer will be rejected.
If the printer is a type that has selectable character sets, then list is a comma or blank separated list of character set name ``mappings'' or aliases. (Enclose the list with quotes if it contains blank spaces.) Each ``mapping'' is of the form
The known-name is a character set number preceded by cs (such as cs3 for character set three) or a character set name from the terminfo database entry csnm. See terminfo.4 If this option is not used to specify a list, only the names already known from the terminfo database or numbers with a prefix of cs will be acceptable for the printer.
If list is the word none, any existing print wheel lists or character set aliases will be removed.
Note the other uses of the -S with the -M option described above.
option must be invoked first with
to identify the printer type
option can be used.
-p $printer sub 2$ -s $system sub 1$!$printer sub 1$
If the printer-type-list contains more than one type, then the content-type-list of the -I option must either be specified as simple, as empty (-I ""), or not specified at all.
For each printer, the LP print service keeps two lists of users: an ``allow-list'' of people allowed to use the printer, and a ``deny-list'' of people denied access to the printer. With the -u allow option, the users listed are added to the allow-list and removed from the deny-list. With the -u deny option, the users listed are added to the deny-list and removed from the allow-list.
If the allow-list is not empty,
only the users in the list may use
regardless of the contents of the deny-list.
If the allow-list is empty,
but the deny-list is not,
the users in the deny-list
may not use the printer.
All users can be denied access to the printer
by specifying -u deny:all.
All users may use the printer
by specifying -u allow:all.
The alert-types are:
The message sent appears as follows:
The print wheel print-wheel needs to be mounted on the printer(s): printer ($integer sub 1$ requests) $integer sub 2$ print requests await this print wheel.
The printers listed are those that the administrator had earlier specified were candidates for this print wheel. The number $integer sub 1$ listed next to each printer is the number of requests eligible for the printer. The number $integer sub 2$ shown after the printer list is the total number of requests awaiting the print wheel. It will be less than the sum of the other numbers if some requests can be handled by more than one printer.
If the print-wheel is all, the alerting defined in this command applies to all print wheels already defined to have an alert.
If the -W option is not given, the default procedure is that only one message will be sent per need to mount the print wheel. Not specifying the -W option is equivalent to specifying -W once or -W 0. If minutes is a number greater than zero, an alert will be sent at intervals specified by minutes.
If the -Q option is also given, the alert will be sent when a certain number (specified by the argument requests) of print requests that need the print wheel are waiting. If the -Q option is not given, or requests is 1 or any (which are both the default), a message is sent as soon as anyone submits a print request for the print wheel when it is not mounted.
Created by unroff & hp-tools. © by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97