Manual Pages for UNIX Operating System command usage for man lpc

SunOS/BSD Compatibility Package Commands                  lpc(1B)



NAME
     lpc - line printer control program

SYNOPSIS
     /usr/ucb/lpc [command [parameter...]]


DESCRIPTION
     The lpc utility controls the operation of local printers.


     Use lpc to perform the following functions:

         o    start or stop a printer,

         o    disable or enable a printer's spooling queue,

         o    rearrange the order of jobs in a print queue, or

         o    display the status of a  printer  print  queue  and
              printer daemon.


     lpc can be run  from  the  command  line  or  interactively.
     Specifying  lpc with the optional command andparameter argu-
     ments causes lpc to interpret the first argument as  an  lpc
     command,  and all other arguments as parameters to that com-
     mand. Specifying lpc without  arguments  causes  it  to  run
     interactively,  prompting  the  user  for  lpc commands with
     lpc>. By redirecting the standard input, lpc can  read  com-
     mands from a file.

USAGE
     lpc commands can be typed in their entirety  or  abbreviated
     to an unambiguous substring. Some lpc commands are available
     to all users; others are available only to super-users.


     All users can execute the following lpc commands:

     ? [command ...] | help [command ...]

         Displays a short description of command. command  is  an
         lpc  command.  If  command  is not specified, displays a
         list of lpc commands.


     exit | quit

         Exits from lpc.





SunOS 5.11          Last change: 10 Dec 2009                    1






SunOS/BSD Compatibility Package Commands                  lpc(1B)



     status [all | printer...]

         Displays the status of print daemons and  print  queues.
         all  specifies  that  this  command  is performed on all
         locally attached printers. printer indicates  this  com-
         mand  is performed on specific printers. Specify printer
         as an atomic name. See printers.conf(4) for  information
         regarding naming conventions for atomic names.



     Only a super-user can execute the following lpc commands:

     abort [all | printer...]

         Terminates an active spooling daemon. Disables  printing
         (by   preventing  new  daemons  from  being  started  by
         lpr(1B)) for printer. all specifies this command is per-
         formed  on  all locally attached printers. printer indi-
         cates this command is performed  on  specific  printers.
         Specify  printer as an atomic name. See printers.conf(4)
         for information regarding naming conventions for  atomic
         names.


     clean [all | printer...]

         Removes files created in the print  spool  directory  by
         the print daemon from printer 's print queue. all speci-
         fies that this  command  is  performed  on  all  locally
         attached printers.printer indicates this command is per-
         formed on  specific  printers.  Specify  printer  as  an
         atomic   name.   See  printers.conf(4)  for  information
         regarding naming conventions for atomic names.


     disable [all | printer ...]

         Turns off the print  queue  for  printer.  Prevents  new
         printer jobs from being entered into the print queue for
         printerby lpr(1B). all specifies that  this  command  is
         performed  on  all  locally  attached  printers. printer
         indicates  this  command  is   performed   on   specific
         printers.   Specify  printer  as  an  atomic  name.  See
         printers.conf(4) for information regarding  naming  con-
         ventions for atomic names.


     down [all | printer ...] [message]

         Turns the queue for printer off and disables printing on
         printer.  Inserts  message  in  the printer status file.



SunOS 5.11          Last change: 10 Dec 2009                    2






SunOS/BSD Compatibility Package Commands                  lpc(1B)



         message does not need to be quoted;  multiple  arguments
         to  message are treated as arguments are to echo(1). Use
         down to take a printer down and inform users. all speci-
         fies  that  this  command  is  performed  on all locally
         attached printers. printer  indicates  this  command  is
         performed  on  specific  printers. Specify printer as an
         atomic  name.  See  printers.conf(4)   for   information
         regarding naming conventions for atomic names.


     enable [all | printer ...]

         Enables lpr(1B) to add new jobs in the spool queue.  all
         specifies  that this command is performed on all locally
         attached printers. printer  indicates  this  command  is
         performed  on  specific  printers. Specify printer as an
         atomic  name.  See  printers.conf(4)   for   information
         regarding naming conventions for atomic names.


     restart [all | printer...]

         Attempts to start a new printer daemon. restart is  use-
         ful  when  a  print  daemon dies unexpectedly and leaves
         jobs in the print queue. all specifies that this command
         is  performed  on all locally attached printers. printer
         indicates that this command  is  performed  on  specific
         printers.   Specify  printer  as  an  atomic  name.  See
         printers.conf(4) for information regarding  naming  con-
         ventions for atomic names.


     start [all | printer...]

         Enables printing.  Starts  a  spooling  daemon  for  the
         printer. all specifies that this command is performed on
         all locally attached  printers.  printer  indicates  the
         command  is  performed  on  specific  printers.  Specify
         printer as an  atomic  name.  See  printers.conf(4)  for
         information  regarding  naming  conventions  for  atomic
         names.


     stop [all | printer...]

         Stops a spooling daemon after the current  job  is  com-
         plete.  Disables  printing  at  that time. all specifies
         that this command is performed on all  locally  attached
         printers. printer indicates this command is performed on
         specific printers. Specify printer as  an  atomic  name.
         See  printers.conf(4)  for  information regarding naming
         conventions for atomic names.



SunOS 5.11          Last change: 10 Dec 2009                    3






SunOS/BSD Compatibility Package Commands                  lpc(1B)



     topq printer[request-ID...] [user ...]

         Moves request-ID or print  jobs  belonging  to  user  on
         printer  to  the  beginning  of the print queue. Specify
         user as a user's  login  name.  Specify  printer  as  an
         atomic   name.   See  printers.conf(4)  for  information
         regarding naming conventions for atomic names.


     up [all | printer ...]

         Turns the queue for printer on and enables  printing  on
         printer.  Deletes the message in the printer status file
         (inserted by down). Use up to undo the effects of  down.
         all  specifies  that  this  command  is performed on all
         locally attached printers. printer indicates  this  com-
         mand  is performed on specific printers. Specify printer
         as an atomic name. See printers.conf(4) for  information
         regarding naming conventions for atomic names.


EXIT STATUS
     The following exit values are returned:

     0           Successful completion.


     non-zero    An error occurred.


FILES
     /etc/printers.conf       System printer configuration  data-
                             base


     $HOME/.printers         User-configurable printer database


     printers.conf.byname    NIS version of /etc/printers.conf


     ou=printers             LDAP version of /etc/printers.conf


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








SunOS 5.11          Last change: 10 Dec 2009                    4






SunOS/BSD Compatibility Package Commands                  lpc(1B)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWlpr-cmds                |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | Standard                    | See standards(5).           |
    |_____________________________|_____________________________|


SEE ALSO
     lpq(1B),   lpr(1B),   lprm(1B),   lpstat(1),    lpsched(1M),
     lpshut(1M), svcadm(1M), printers.conf(4), attributes(5)

DIAGNOSTICS
     Use     the     svcs(1)     utility     to     check      if
     svc:/application/print/server  is running. If it is not run-
     ning, use  svcadm  enable  svc:/application/print/server  to
     start lpsched. See svcadm(1M).

NOTES
     When IPP is in use, the user is prompted for a passphrase if
     the  remote print service is configured to require authenti-
     cation.






























SunOS 5.11          Last change: 10 Dec 2009                    5