lpc(1M-BSD)       MISC. REFERENCE MANUAL PAGES        lpc(1M-BSD)



NAME
     lpc - line printer control program

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

DESCRIPTION
     lpc controls the operation of the printer,  or  of  multiple
     printers.   lpc  commands  can  be  used  to start or stop a
     printer, disable or enable a printer's spooling queue, rear-
     range the order of jobs in a queue, or display the status of
     each printer-along with its spooling queue and printer  dae-
     mon.   With  no arguments, lpc runs interactively, prompting
     with `lpc>'.  If arguments are supplied, lpc interprets  the
     first  as  a command to execute; each subsequent argument is
     taken as a parameter for that command.  The  standard  input
     can  be  redirected  so that lpc reads commands from a file.
     Commands may be abbreviated  to  an  unambiguous  substring.
     Note: the printer parameter is specified just by the name of
     the printer (as lw), not as you would specify it  to  lpr(1)
     or lpq(1) (not as -Plw).
     ?  [command]...
     help [command]...
          Display a short description of each  command  specified
          in  the argument list, or, if no arguments are given, a
          list of the recognized commands.

     abort [all| [printer...]]
          Terminate an active spooling daemon on the  local  host
          immediately  and  then disable printing (preventing new
          daemons from being started by lpr(1)) for the specified
          printers.   The  abort  command can only be used by the
          privileged user.

     clean [all| [printer...]]
          Remove all files created in the spool directory by  the
          daemon from the specified printer queue(s) on the local
          machine.  The clean command can only  be  used  by  the
          privileged user.

     disable [all| [printer...]]
          Turn the specified printer queues off.   This  prevents
          new  printer  jobs from being entered into the queue by
          lpr(1).  The disable command can only be  used  by  the
          privileged user.

     down [all| [printer...]]  [message]
          Turn the specified printer queue off, disable  printing
          and  put  message in the printer status file.  The mes-
          sage does not need to be quoted,  the  remaining  argu-
          ments  are treated like echo(1).  This is normally used
          to take a printer down and let others know why  (lpq(1)



                                                                1

lpc(1M-BSD)       MISC. REFERENCE MANUAL PAGES        lpc(1M-BSD)



          indicates  that the printer is down, as does the status
          command).

     enable [all| [printer...]]
          Enable spooling on  the  local  queue  for  the  listed
          printers,  so that lpr(1) can put new jobs in the spool
          queue.  The enable command can  only  be  used  by  the
          privileged user.

     exit
     quit Exit from lpc.

     restart [all| [printer...]]
          Attempt to start a new printer daemon.  This is  useful
          when  some  abnormal condition causes the daemon to die
          unexpectedly leaving jobs in the queue.   This  command
          can be run by any user.

     start [all| [printer...]]
          Enable printing and start a  spooling  daemon  for  the
          listed printers.  The start command can only be used by
          the privileged user.

     status [all| [printer...]]
          Display the status of daemons and queues on  the  local
          machine.  This command can be run by any user.

     stop [all| [printer...]]
          Stop a spooling daemon after the current job  completes
          and  disable  printing.   The  stop command can only be
          used by the privileged user.

     topq printer [job#...]  [user...]
          Move the print job(s) specified by job# or those job(s)
          belonging  to  user  to  the  top (head) of the printer
          queue.  The topq  command  can  only  be  used  by  the
          privileged user.

     up [all| [printer...]]  Enable everything and  start  a  new
          printer daemon.  Undoes the effects of down.

FILES
     /var/spool/lp/*
     /var/spool/lp/system/pstatus

SEE ALSO
     lpq(1), lpr(1), lprm(1)  echo(1)  in  the  User's  Reference
     Manual.
     lpsched(1M) in the System Administrator's Reference Manual.

DIAGNOSTICS
     ?Ambiguous command



                                                                2

lpc(1M-BSD)       MISC. REFERENCE MANUAL PAGES        lpc(1M-BSD)



          The abbreviation you typed matches more than  one  com-
          mand.

     ?Invalid command
          You typed a command or abbreviation that was not recog-
          nized.

     ?Privileged command
          You  used  a  command  can  be  executed  only  by  the
          privileged user.

     lpc: printer: unknown printer to the print service
          The printer was not found in the System V LP  database.
          Usually this is a typing mistake; however, it may indi-
          cate that the printer does not  exist  on  the  system.
          Use `lptstat -p' to find the reason.

     lpc: error on opening queue to spooler
          The connection to lpsched on the local machine  failed.
          This  usually  means the printer server started at boot
          time has died or is hung.  Check if the printer spooler
          daemon /usr/lib/lp/lpsched is running.

     lpc: Can't send message to LP print service

     lpc: Can't receive message from LP print service
          These indicate that  the  LP  print  service  has  been
          stopped.  Get help from the system administrator.

     lpc: Received unexpected message from LP print service
          It is likely there is an error in this  software.   Get
          help from system administrator.























                                                                3