lpadmin man page on JazzOS

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

lpadmin(8)			  Apple Inc.			    lpadmin(8)

       lpadmin - configure cups printers and classes

       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -d destination
       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -p printer option(s)
       lpadmin [ -E ] [-U username ] [ -h server[:port] ] -x destination

       lpadmin	configures  printer  and class queues provided by CUPS. It can
       also be used to set the server default printer or class.

       When specified before the -d, -p, or -x options, the -E	option	forces
       encryption when connecting to the server.

       The first form of the command (-d) sets the default printer or class to
       destination.  Subsequent print jobs submitted via the lp(1)  or	lpr(1)
       commands	 will use this destination unless the user specifies otherwise
       with the lpoptions(1) command.

       The second form of the command (-p) configures the named printer.   The
       additional options are described below.

       The  third form of the command (-x) deletes the printer or class desti‐
       nation. Any jobs that are pending for the destination will  be  removed
       and any job that is currently printed will be aborted.

       The following options are recognized when configuring a printer queue:

       -c class
	    Adds  the  named  printer to class.	 If class does not exist it is
	    created automatically.

       -i interface
	    Sets a System V style  interface  script  for  the	printer.  This
	    option  cannot  be	specified with the -P option (PPD file) and is
	    intended for providing support for legacy printer drivers.

       -m model
	    Sets a standard System V interface script or  PPD  file  from  the
	    model directory.

       -o name=value
	    Sets  a  PPD  or server option for the printer. PPD options can be
	    listed using the -l option with the lpoptions(1) command.

       -o job-k-limit=value
	    Sets the kilobyte limit for per-user quotas. The value is an inte‐
	    ger number of kilobytes; one kilobyte is 1024 bytes.

       -o job-page-limit=value
	    Sets  the page limit for per-user quotas. The value is the integer
	    number of pages  that  can	be  printed;  double-sided  pages  are
	    counted as two pages.

       -o job-quota-period=value
	    Sets  the  accounting  period for per-user quotas. The value is an
	    integer number of seconds; 86,400 seconds are in one day.

       -o job-sheets-default=banner

       -o job-sheets-default=banner,banner
	    Sets the default banner page(s) to use for print jobs.

       -o port-monitor=name
	    Sets the binary  communications  program  to  use  when  printing,
	    "none", "bcp", or "tbcp". The default program is "none".

       -o printer-error-policy=name
	    Sets  the  error  policy  to  be  used when the printer backend is
	    unable to send the job to the printer. The name  must  be  one  of
	    "abort-job", "retry-job" or "stop-printer". The default error pol‐
	    icy is "stop-printer".

       -o printer-is-shared=true/false
	    Sets the  printer  to  shared/published  or	 unshared/unpublished.
	    Shared/published  printers	are publically announced by the server
	    on the LAN based on	 the  browsing	configuration  in  cupsd.conf,
	    while unshared/unpublished printers are not announced. The default
	    value is "true".

       -o printer-op-policy=name
	    Sets the IPP operation policy associated  with  the	 printer.  The
	    name  must	be defined in the cupsd.conf in a Policy section.  The
	    default operation policy is "default".

       -r class
	    Removes the named printer from  class.   If	 the  resulting	 class
	    becomes empty it is removed.

       -u allow:user,user,@group

       -u deny:user,user,@group

       -u allow:all

       -u deny:none
	    Sets  user-level  access control on a printer. Names starting with
	    "@" are interpreted as UNIX groups.	 The  latter  two  forms  turn
	    user-level access control off.

       -v "device-uri"
	    Sets the device-uri attribute of the printer queue.	 If device-uri
	    is	a  filename  it	 is  automatically  converted  to   the	  form
	    file:///file/name. Use the lpinfo(8) command to get a list of sup‐
	    ported device URIs and schemes.

       -D "info"
	    Provides a textual description of the printer.

	    Enables the printer and accepts jobs; this is the same as  running
	    the accept(8) and cupsenable(8) programs on the printer.

       -L "location"
	    Provides a textual location of the printer.

       -P ppd-file
	    Specifies  a  PostScript  Printer Description file to use with the
	    printer. If specified, this option overrides the -i option (inter‐
	    face script).

       Unlike  the System V printing system, CUPS allows printer names to con‐
       tain any printable character except SPACE, TAB,	"/",  or  "#".	 Also,
       printer and class names are not case-sensitive.	Finally, the CUPS ver‐
       sion of lpadmin may ask the user for an access  password	 depending  on
       the  printing system configuration. This differs from the System V ver‐
       sion which requires the root user to execute this command.

       The CUPS version of lpadmin does not support all of  the	 System	 V  or
       Solaris printing system configuration options.

       accept(8), cupsenable(8), lpinfo(8), lpoptions(1),

       Copyright 2007 by Apple Inc.

13 July 2006		  Common UNIX Printing System		    lpadmin(8)

List of man pages available for JazzOS

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]
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