lpadmin man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

lpadmin(1M)		System Administration Commands		   lpadmin(1M)

NAME
       lpadmin - configure the LP print service

SYNOPSIS
       lpadmin -p printer {options}

       lpadmin -x dest

       lpadmin -d [dest]

       lpadmin -S print-wheel -T [-A alert-type] [-W minutes]
	    [-Q requests]

DESCRIPTION
       lpadmin	configures  the	 LP  print  service  by	 defining printers and
       devices. It is used to add and change printers, to remove printers from
       service,	 to  set  or  change the system default destination, to define
       alerts for printer faults, and to mount print wheels.

OPTIONS
       The lpadmin command has options for:

	   o	  Adding or changing a printer

	   o	  Removing a printer destination

	   o	  Setting or changing the system default destination

	   o	  Setting an alert for a print wheel

       The options for each of the above categories are specified in the  fol‐
       lowing subsections.

       Several	options	 support  the  use of lists. A list might contain, for
       example, user names, printers, printer forms, or content types. A  list
       of  multiple items can have the form of either comma-separated names or
       have the entire list enclosed by double quotes  with  a	space  between
       each name. For example, both lists below are acceptable:

	 one,two,three
	 "one two three"

   Adding or Changing a Printer
       The  first  form	 of the lpadmin command (lpadmin -p printer {options})
       configures a new printer or changes the configuration  of  an  existing
       printer. It also starts the print scheduler.

       When  creating a new printer, one of three options (-v, -U, or -s) must
       be supplied. In addition, only one of the following  can	 be  supplied:
       -e,  -i,	 or  -m; if none of these three options is supplied, the model
       standard is used. The -h and -l options are mutually exclusive. Printer
       and  class  names must be no longer than 14 characters and must consist
       entirely of the characters A-Z,	a-z, 0-9, dash (-) and underscore (_).
       If  -s is specified, the following options are invalid: -A, -e, -F, -h,
       -i, -l, -M, -m, -o, -U, -v, and -W.

       The following options can appear in any order.

       -A alert-type [-W minutes]

	   The -A option is used to define an alert that informs the  adminis‐
	   trator  when	 a  printer fault is detected, and periodically there‐
	   after, until the printer fault is cleared by the administrator. The
	   alert-types are:

	   mail		    Send the alert message using mail (see mail(1)) to
			    the administrator.

	   write	    Write the message to the  terminal	on  which  the
			    administrator  is  logged in. If the administrator
			    is logged in on several terminals, one  is	chosen
			    arbitrarily.

	   quiet	    Do not send messages for the current condition. An
			    administrator can use this option  to  temporarily
			    stop  receiving  further  messages	about  a known
			    problem. Once  the	fault  has  been  cleared  and
			    printing  resumes,	messages  are  sent again when
			    another fault occurs with the printer.

	   showfault	    Attempt to execute a fault handler on each	system
			    that  has a print job in the queue. The fault han‐
			    dler is /etc/lp/alerts/printer. It is invoked with
			    three  parameters:	printer_name, date, file_name.
			    The file_name is the name of a file containing the
			    fault message.

	   none		    Do	not  send messages; any existing alert defini‐
			    tion for the printer is removed. No alert is  sent
			    when  the  printer faults until a different alert-
			    type (except quiet) is used.

	   shell-command    Run the shell-command each time the alert needs to
			    be	sent. The shell command should expect the mes‐
			    sage in standard input. If there are blank	spaces
			    embedded  in  the  command, enclose the command in
			    quotes. Notice that the mail and write values  for
			    this  option  are  equivalent  to  the values mail
			    user-name and write user-name respectively,	 where
			    user-name  is the current name for the administra‐
			    tor. This is the login name of the person  submit‐
			    ting this command unless he or she has used the su
			    command to change to another user ID.  If  the  su
			    command  has been used to change the user ID, then
			    the user-name for the new ID is used.

	   list		    Display the type of	 the  alert  for  the  printer
			    fault. No change is made to the alert.

	   When	 a  fault  occurs,  the	 printing subsystem displays a message
	   indicating that printing for a specified printer  has  stopped  and
	   the reason for the stoppage. The message also indicates that print‐
	   ing will restart in a few minutes and that you can enter an	enable
	   command if you want to restart sooner than that.

	   Following a fault that occurs in the middle of a print job, the job
	   is reprinted from the beginning. An exception to this  occurs  when
	   you	enter a command, such as the one shown below, that changes the
	   page list to be printed.

	     % lp -i request-id -P ...

	   For a given print request, the presence  of	multiple  reasons  for
	   failure indicate multiple attempts at printing.

	   The LP print service can detect printer faults only through an ade‐
	   quate 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, instead of a single printer, the keyword all is displayed in an
	   alert, the alert applies to all 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 is sent at
	   intervals specified by minutes.

       -c class

	   Insert printer into the specified class. class  is  created	if  it
	   does not already exist. This option requires the -U dial-info or -v
	   device options.

       -D comment

	   Save this comment for display whenever  a  user  asks  for  a  full
	   description	of  printer (see lpstat(1)). The LP print service does
	   not interpret this comment.

       -e printer

	   Copy the interface program of an existing printer to be the	inter‐
	   face	 program for printer. (Options -i and -m must not be specified
	   with this option.)

       -f allow:form-list
       -f deny:form-list

	   Allow or deny the forms in form-list to be printed on  printer.  By
	   default no forms are allowed on a new printer.

	   For each printer, the LP print service keeps two lists of forms: an
	   ``allow-list'' of forms that can be used with the  printer,	and  a
	   ``deny-list''  of  forms that cannot 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  can  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  cannot  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 charac‐
	   teristics 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, how‐
	   ever, 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  combina‐
	   tion	 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	 does  not have the capabilities needed by the
	   form, the command is rejected.

	   Notice 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.

       -F fault-recovery

	   This option specifies the recovery to be used for any print request
	   that is stopped because of a printer fault, according to the	 value
	   of fault-recovery:

	   continue	Continue  printing on the top of the page where print‐
			ing stopped. This requires a filter to	wait  for  the
			fault to clear before automatically continuing.

	   beginning	Start printing the request again from the beginning.

	   wait		Disable	 printing on printer and wait for the adminis‐
			trator or a user to enable printing again.

			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.

       -h

	   Indicate  that the device associated with the printer is hardwired.
	   If neither of the mutually exclusive options, -h and -l, is	speci‐
	   fied, -h is assumed.

       -i interface

	   Establish  a	 new  interface	 program for printer. interface is the
	   pathname of the new program. (The -e and -m	options	 must  not  be
	   specified with this option.)

       -I content-type-list

	   Allow  printer  to  handle  print  requests	with the content types
	   listed in a content-type-list.

	   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 contain‐
	   ing only printable ASCII characters and the following control char‐
	   acters:

	      Control Char	    Octal Value		       Meaning
	   BACKSPACE		10		      Move back one char, except
						       at beginning of line
	   TAB			11		      Move to next tab stop
	   LINEFEED		12		      Move to beginning of
	    (newline)				       next line
	   FORMFEED		14		      Move to beginning of
						       next page
	   RETURN		15		      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  sim‐
	   ple in the content-type-list.

	   In  addition	 to  content types defined by the print administrator,
	   the type PostScript is recognized  and  supported  by  the  Solaris
	   print subsystem. This includes filters to support PostScript as the
	   printer content type.

	   The type any is recognized as a special  content  type  for	files.
	   When declared as the input type for a printer, it signals the print
	   sub-system not to do any filtering on the file before sending it to
	   the printer.

	   Except  for simple and any, each content-type name is 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.

       -l

	   Indicate that the device associated with printer is a login	termi‐
	   nal.	 The LP scheduler (lpsched) disables all login terminals auto‐
	   matically each time it is started. (The -h option must not be spec‐
	   ified with this option.)

       -m model

	   Select model interface program, provided with the LP print service,
	   for the printer. (Options -e and -i must not be specified with this
	   option.)

       -M -f form-name [-a [-o filebreak]] [-t tray-number]]

	   Mount  the  form form-name on printer. Print requests that need the
	   pre-printed form form-name is printed on printer. If more than  one
	   printer  has	 the form mounted and the user has specified any (with
	   the -d option of the lp command) as the printer  destination,  then
	   the print request is printed on the one printer that also meets the
	   other needs of the request.

	   The page length and width, and character and line pitches needed by
	   the form are compared with those allowed for the printer, by check‐
	   ing 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, pre‐
	   ceded by the same initialization of the physical printer that  pre‐
	   cedes 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  pat‐
	   tern is assumed to correctly fill a form, so no formfeed is added.

	   If the -t tray-number option is specified, printer tray tray-number
	   is 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.

	   Notice the other use of -f without the -M option above.

       -M -S print-wheel

	   Mount the print-wheel on printer.  Print  requests  that  need  the
	   print-wheel	are  printed  on printer. If more than one printer has
	   print-wheel mounted and the user has specified  any	(with  the  -d
	   option  of  the  lp	command)  as the printer destination, then the
	   print request is printed on the one printer	that  also  meets  the
	   other needs of the request.

	   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.

	   Notice  the	other  uses  of	 the  -S  option without the -M option
	   described below.

       -n ppdfilename

	   Specify a PPD file  for  creating  and  modifying  printer  queues.
	   ppdfilename is the full path and file name to the PPD file. Used in
	   conjunction with the -p, -d, -x, or -S options.

       -o option

	   The -o option defines default printer configuration values given to
	   an interface program. The default can be explicitly overwritten for
	   individual requests by the  user  (see  lp(1)),  or	taken  from  a
	   preprinted form description (see lpforms(1M) and lp(1)).

	   There  are  several	options which are predefined by the system. In
	   addition, any number of key-value pairs can	be  defined.  See  the
	   section "Predefined Options Used with the -o Option", below.

       -P paper-name

	   Specify a paper type list that the printer supports.

       -r class

	   Remove  printer  from  the  specified class. If printer is the last
	   member of class, then class is removed.

       -S list

	   Allow either the print wheels or aliases for character  sets	 named
	   in list to be used on the printer.

	   If  the  printer  is a type that takes print wheels, then list is a
	   comma or space separated list of print wheel names. These  are  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 are considered
	   mountable on the printer, and print requests that ask for a partic‐
	   ular print wheel with this printer are rejected.

	   If  the  printer is a type that has selectable character sets, then
	   list is a list of character set name ``mappings'' or aliases.  Each
	   ``mapping''	is  of	the  form known-name=alias 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 is acceptable for the printer. If  list
	   is  the  word none, any existing print wheel lists or character set
	   aliases are removed.

	   Notice the other uses of the -S with the -M option described above.

	   The -T option must be invoked first with lpadmin  to	 identify  the
	   printer type before the -S option can be used.

       -s system-name

	   The	-s  option  can be used for both remote or local printers. For
	   remote printers:

	   -s system-name[!printer-name] (UUCP format)
	   -s printer-name@system-name (RCMD format)

	       Make a remote  printer  (one  that  must	 be  accessed  through
	       another system) accessible to users on your system. system-name
	       is the name of the remote system on which the remote printer is
	       located	it. printer-name is the name used on the remote system
	       for that printer. For example, if you want to  access  printer1
	       on system1 and you want it called printer2 on your system:

		 -p printer2 -s system1!printer1

		 -p printer2 -s printer1@system1

	   -s scheme://end-point (URI format)

	       Make  a	remote	printer	 (one  that  must  be accessed through
	       another system) accessible to users on your  system.  The  sup‐
	       ported schemes include lpd and ipp. Specify URI's using the lpd
	       format as follows:

		 lpd://server/printers/queue[#Solaris]

	       URI's using the ipp format are  defined	by  the	 remote	 print
	       server. They are generally of the format:

		 ipp://server/printers/queue

	       In  either case, server specifies the hostname or IP address of
	       the remote print server, queue specifies the name of the	 print
	       queue  on  the  remote print server, and the optional #Solaris‐
	       specifies that the remote print server is a Solaris server when
	       lpd URI format is being used.

	       For example:

		 -p printer -s lpd://server/printers/queue#Solaris
		 -p printer -s ipp://server/printers/queue

	   For local printers:

	   -s "localhost"    Use  localhost  for the system-name to be used by
			     the print service. In an  environment  where  the
			     nodename  is  variable,  print queues are invali‐
			     dated when the nodename changes. Using  localhost
			     as	 the  system-name  allows  print  queues to be
			     maintained across changing nodenames. The system-
			     name,  as	used by the print service, is only set
			     to	 localhost  when  explicitely  set  with  this
			     option;  by  default, lpadmin sets system-name to
			     nodename. For example, if you want to configure a
			     new  printer  on  the  local  system, and want it
			     called printer3:

			     -p printer3 -s localhost -v device

			     This option should never be  used	when  creating
			     name service maps.

       -T printer-type-list

	   Identify  the  printer  as being of one or more printer-types. Each
	   printer-type is used to extract data from  the  terminfo  database;
	   this	 information is used to initialize the printer before printing
	   each user's request. Some filters might also use a printer-type  to
	   convert  content  for  the printer. If this option is not used, the
	   default printer-type is unknown. No information is  extracted  from
	   terminfo so each user request is printed without first initializing
	   the printer. Also, this option must be used if the following are to
	   work:  -o cpi, -o lpi, -o width, and -o length options of the lpad‐
	   min and lp commands, and the -S and -f options of the lpadmin  com‐
	   mand.

	   If the printer-type-list contains more than one type, then the con‐
	   tent-type-list of the -I option must either be specified as simple,
	   as empty (-I ""), or not specified at all.

       -tnumber-of-trays

	   Specify the number of trays when creating the printer.

       -u allow:login-ID-list
       -u deny:login-ID-list

	   Allow  or deny the users in login-ID-list access to the printer. By
	   default all users are allowed on a new printer.  The	 login-ID-list
	   argument can include any or all of the following constructs:

	   login-ID		   a user on any system

	   system-name!login-ID	   a user on system system-name

	   system-name!all	   all users on system system-name

	   all!login-ID		   a user on all systems

	   all			   all users on all systems

	   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 can  use
	   the	printer,  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 cannot use the printer. All users can be denied access to
	   the printer by specifying  -u  deny:all.  All  users	 can  use  the
	   printer by specifying -u allow:all.

	   The -U option allows your print service to access a remote printer.
	   (It does not enable your print service to access a  remote  printer
	   service.)  Specifically,  -U	 assigns  the  ``dialing'' information
	   dial-info to the printer. dial-info is used with the	 dial  routine
	   to  call the printer. Any network connection supported by the Basic
	   Networking Utilities works. dial-info can be either a phone	number
	   for a modem connection, or a system name for other kinds of connec‐
	   tions. Or, if -U direct is given, no dialing takes  place,  because
	   the	name  direct  is  reserved for a printer that is directly con‐
	   nected. If a system name is given, it is used to search for connec‐
	   tion	 details from the file /etc/uucp/Systems or related files. The
	   Basic Networking Utilities are required to support this option.  By
	   default, -U direct is assumed.

       -v device

	   Associate  a device with printer. device is the path name of a file
	   that is writable by lp. Notice that the same device can be  associ‐
	   ated with more than one printer.

       -v scheme://end-point

	   Associate a network attached device with printer.

	   scheme  is  the  method  or	protocol  used	to  access the network
	   attached device and end-point is the information necessary to  con‐
	   tact	 that  network	attached  device.  Use	of  this device format
	   requires the use of the uri interface script and can only  be  used
	   with the smb scheme at this time.

	   For example:

	     # lpadmin -p queue -v smb://smb-service/printer -m uri

	   See the /usr/sfw/man/man1m/smbspool.1m man page for details.

   Removing a Printer Destination
       The -x dest option removes the destination dest (a printer or a class),
       from the LP print service. If dest is a printer and is the only	member
       of  a class, then the class is deleted, too. If dest is all, all print‐
       ers and classes are removed. If there are no remaining  local  printers
       and the scheduler is still running, the scheduler is shut down.

       No other options are allowed with -x.

   Setting/Changing the System Default Destination
       The  -d [dest] option makes dest (an existing printer or class) the new
       system default destination. If dest is not supplied, then there	is  no
       system default destination. No other options are allowed with -d.

   Setting an Alert for a Print Wheel
       -S print-wheel [-A alert-type] [-W minutes] [-Q requests] -T

	   The	-S print-wheel option is used with the -A alert-type option to
	   define an alert to mount the print wheel when there are jobs queued
	   for it. If this command is not used to arrange alerting for a print
	   wheel, no alert is sent for the print wheel. Notice the  other  use
	   of -A, with the -p option, above.

	   The alert-types are:

	   mail		    Send  the  alert message using the mail command to
			    the administrator.

	   write	    Write the message, using the write command, to the
			    terminal  on which the administrator is logged in.
			    If the administrator is logged in on several  ter‐
			    minals, one is arbitrarily chosen.

	   quiet	    Do not send messages for the current condition. An
			    administrator can use this option  to  temporarily
			    stop  receiving  further  messages	about  a known
			    problem. Once the print-wheel has been mounted and
			    subsequently  unmounted,  messages are sent again‐
			    when the number  of	 print	requests  reaches  the
			    threshold specified by the -Q option.

	   none		    Do	not send messages until the -A option is given
			    again with	a  different  alert-type  (other  than
			    quiet).

	   shell-command    Run the shell-command each time the alert needs to
			    be sent. The shell command should expect the  mes‐
			    sage in standard input. If there are blanks embed‐
			    ded in the command, enclose the command in quotes.
			    Notice  that  the  mail  and write values for this
			    option are equivalent to the values mail user-name
			    and	 write user-name respectively, where user-name
			    is the current name for the administrator. This is
			    the	 login name of the person submitting this com‐
			    mand unless he or she has used the su  command  to
			    change  to	another user ID. If the su command has
			    been used to change the user ID,  then  the	 user-
			    name for the new ID is used.

	   list		    Display  the type of the alert for the print wheel
			    on standard output.	 No  change  is	 made  to  the
			    alert.

	   The message sent appears as follows:

	     The print wheel print-wheel needs to be mounted
	     on the printer(s):
	     printer(integer1requests) integer2 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 integer1
	   listed  next to each printer is the number of requests eligible for
	   the printer. The number integer2 shown after the  printer  list  is
	   the	total  number of requests awaiting the print wheel. It is 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 is sent per need to mount the print wheel. Not specify‐
	   ing the -W option is equivalent to specifying -W once or -W	0.  If
	   minutes  is	a number greater than zero, an alert is sent at inter‐
	   vals specified by minutes.

	   If the -Q option is also given, the alert is 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.

PREDEFINED OPTIONS USED WITH THE -o OPTION
       A  number  of options, described below, are predefined for use with -o.
       These options are used for adjusting  printer  capabilities,  adjusting
       printer	port  characteristics,	configuring network printers, and con‐
       trolling the use of banner. The -o  also	 supports  an  arbitrary  key‐
       word=value format, which is referred to below as an undefined option.

   Adjusting Printer Capabilities
       The  length,  width, cpi, and lpi parameters can be used in conjunction
       with the -o option to adjust printer capabilities. The  format  of  the
       parameters and their values is as follows:

	 length=scaled-decimal-number
	 width=scaled-decimal-number
	 cpi=scaled-decimal-number
	 lpi=scaled-decimal-number

       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  cen‐
       timeters	 (marked with a trailing c); numbers that show sizes in inches
       (marked with a trailing i); and numbers that show sizes in units appro‐
       priate  to use (without a trailing letter), that is, lines, characters,
       lines per inch, or characters per inch.

       The option values must agree with the capabilities of the type of phys‐
       ical printer, as defined in the terminfo database for the printer type.
       If they do not, the command is rejected.

       The defaults are defined	 in  the  terminfo  entry  for	the  specified
       printer type. The defaults can be reset by:

	 lpadmin -p printername -o length=
	 lpadmin -p printername -o width=
	 lpadmin -p printername -o cpi=
	 lpadmin -p printername -o lpi=

   Adjusting Printer Port Characteristics
       You  use	 the  stty  keyword in conjunction with the o option to adjust
       printer port characteristics. The general form of the stty  portion  of
       the command is:

	 stty="'stty-option-list'"

       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.

       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'"

       The default can be reset by:

	 lpadmin -p printername -o stty=

   Configuring Network Printers
       The  dest,  protocol,  bsdctrl, and timeout parameters are used in con‐
       junction with the -o option to configure network printers.  The	format
       of these keywords and their assigned values is as follows:

	 dest=string protocol=string bsdctrl=string \
	      timeout=non-negative-integer-seconds

       These  four  options  are  provided  to	support network printing. Each
       option is passed directly to the interface program;  any	 checking  for
       allowed values is done there.

       The  value  of  dest  is	 the  name  of the destination for the network
       printer; the semantics for value dest are dependent on the printer  and
       the configuration. There is no default.

       The  value  of  option  protocol sets the over-the-wire protocol to the
       printer. The default for option protocol is bsd. The  value  of	option
       bsdctrl	sets  the  print order of control and data files (BSD protocol
       only); the default for this option is control file first. The value  of
       option timeout sets the seed value for backoff time when the printer is
       busy. The default value for the	timeout	 option	 is  10	 seconds.  The
       defaults can be reset by:

	 lpadmin -p printername -o protocol=
	 lpadmin -p printername -o bsdctrl=
	 lpadmin -p printername -o timeout=

   Controlling the Use of the Banner Page
       Use the following commands to control the use of the banner page:

	 lpadmin -p printer -o nobanner
	 lpadmin -p printer -o banner
	 lpadmin -p printer -o banner=always
	 lpadmin -p printer -o banner=never
	 lpadmin -p printer -o banner=optional

       The  first  and fifth commands (-o nobanner and -o banner=optional) are
       equivalent. The default is to print the	banner	page,  unless  a  user
       specifies -o nobanner on an lp command line.

       The  second  and	 third	commands  (-o banner and -o banner=always) are
       equivalent. Both cause a banner page to be printed always,  even	 if  a
       user specifies lp -o nobanner. The root user can override this command.

       The  fourth  command (-o banner=never) causes a banner page never to be
       printed, even if a user specifies lp -o banner. The root user can over‐
       ride this command.

   Undefined Options
       The  -o option supports the use of arbitrary, user-defined options with
       the following format:

       key=value

	   Each key=value is passed directly to	 the  interface	 program.  Any
	   checking for allowed values is done in the interface program.

	   Any	default values for a given key=value option are defined in the
	   interface program. If a default is provided, it  can	 be  reset  by
	   typing the key without any value:

	     lpadmin -p printername -o key=

       lpadmin -p printer -o foo | nofoo

	   Sets boolean values foo=true | foo=false.

EXAMPLES
       In the following examples, prtr can be any name up to 14 characters and
       can be the same name as the ping(1M) name.

       Example 1 Configuring an HP Postscript Printer with a Jet  Direct  Net‐
       work Interface

       The  following  example	configures an HP postscript printer with a jet
       direct network interface:

	 example# lpadmin -p prtr -v /dev/null -m netstandard \
		   -o dest=ping_name_of_prtr:9100 -o protocol=tcp -T PS -I \
		    postscript
	 example# enable prtr
	 example# accept prtr

       Example 2 Configuring a Standard Postscript Network Printer

       The following example configures a standard postscript network printer:

	 example# lpadmin -p prtr -v /dev/null -m netstandard \
		  -o dest=ping_name_of_prtr -T PS -I postscript
	 example# enable prtr
	 example# accept prtr

EXIT STATUS
       The following exit values are returned:

       0	   Successful completion.

       non-zero	   An error occurred.

FILES
       /var/spool/lp/*

       /etc/lp

       /etc/lp/alerts/printer	 Fault handler for lpadmin

       /etc/printers.conf	 System printer configuration database

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬───────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	     ATTRIBUTE VALUE	     │
       ├─────────────────────────────┼───────────────────────────────┤
       │Availability		     │print/lp/print-client-commands │
       ├─────────────────────────────┼───────────────────────────────┤
       │Interface Stability	     │Obsolete			     │
       └─────────────────────────────┴───────────────────────────────┘

SEE ALSO
       enable(1), lp(1), lpstat(1), mail(1), stty(1), accept(1M), lpforms(1M),
       lpsched(1M),    lpsystem(1M),	ping(1M),   dial(3NSL),	  terminfo(4),
       attributes(5)

NOTES
       When using lpadmin to provide access to a remote printer,  remote  con‐
       figuration  data	 is stored in /etc/printers.conf. This data includes a
       bsdaddr and a printer-uri-supported attribute. The data	in  this  file
       can  be	shared through the use of a network name service or replicated
       across multiple systems. If the data is shared, it is important to make
       sure that the bsdaddr and printer-uri-supported contain hostname infor‐
       mation that is correctly resolved on all hosts sharing this data. Also,
       the  printer-uri-supported  is  the preferred means of accessing remote
       print service. The bsdaddr is supplied for backward compatability  with
       Solaris 2.6-10 systems.

SunOS 5.11			  24 May 2006			   lpadmin(1M)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net