lpc(1M)                                                   lpc(1M)



     NAME
          lpc - line-printer control program

     SYNOPSIS
          /etc/lpc [ command [ argument ... ] ]

     DESCRIPTION
          lpc is used by the system administrator to control the
          operation of the line-printer system. For each line printer
          configured in /etc/printcap, lpc may be used to:

          ⊕    disable or enable a printer

          ⊕    disable or enable a printer's spooling queue

          ⊕    rearrange the order of jobs in a spooling queue

          ⊕    find the status of printers, and their associated
               spooling queues and printer dameons

          Without any arguments, lpc prompts for commands from the
          standard input.  If arguments are supplied, lpc interprets
          the first argument as a command and each remaining argument
          as a parameter to command.  The standard input may be
          redirected causing lpc to read commands from a file.  Com-
          mands may be abbreviated.  The following is the list of
          recognized commands:

          ? [ command ... ]

          help [ command ... ]
               Print a short description of each command specified in
               the argument list, or if no arguments are given, print
               a list of the recognized commands.

          abort { all | printer ... }
               Terminate an active spooling daemon on the local host
               immediately and then disable printing for the specified
               printers.  (To prevent new daemons from being started
               by lpr.)

          clean { all | printer ... }
               Remove any temporary files, data files, and control
               files that cannot be printed from the specified printer
               queue(s) on the local machine.  (For example, do this
               so as not to form a complete printer job.)

          disable { all | printer ... }
               Turn off the spooling queues for the specified
               printers.  This command prevents lpr from entering new
               printer jobs in the queue.




     April, 1990                                                     1

     lpc(1M)                                                   lpc(1M)



          down { all | printer } message ...
               Turn off the spooling queue for the specified printers,
               disable printing, and put message in the printer status
               file. The message doesn't need to be quoted.  The
               remaining arguments are treated like echo(1).  This
               command is normally used to take a printer down and let
               others know why.  lpq indicates the printer is down and
               prints the status message.

          enable { all | printer ... }
               Enable spooling on the local queue for the listed
               printers. This command allows lpr to put new jobs in
               the spool queue.

          exit

          quit
               Exit from lpc.

          restart { all | printer ... }
               Attempt to start a new printer daemon. This command is
               useful when some abnormal condition causes the daemon
               to die unexpectedly and leaves jobs in the queue.  lpq
               reports that no daemon is present when this condition
               occurs. If the user is the super-user, try to abort the
               current daemon first, that is, kill and restart a stuck
               daemon.

          start { all | printer ... }
               Enable printing and start a spooling daemon for the
               listed printers.

          status { all | printer ... }
               Display the status of daemons and queues on the local
               machine.

          stop { all | printer ... }
               Stop a spooling daemon after the current job completes
               and disable printing.

          topq printer [ jobnum ... ] [ user ... ]
               Place the jobs in the order listed at the top of the
               printer queue.

          up { all | printer ... }
               Enable everything and start a new printer daemon. Un-
               does the effects of down.

     FILES
          /etc/printcap           Printer description file
          /usr/spool/*            Spool directories
          /usr/spool/*/lock       Lock file for queue control



     2                                                     April, 1990

     lpc(1M)                                                   lpc(1M)



     SEE ALSO
          lpd(1M), lpr(1), lpq(1), lprm(1), printcap(4).

     DIAGNOSTICS
          Here are some of the common error messages and a brief ex-
          planation of each:

          ?Ambiguous command
               The abreviation matches more than one command.

          ?Invalid command
               No match was found.

          ?Privileged command
               The command can be executed by root only.








































     April, 1990                                                     3