lpc(1M)            UNIX System V(BSD Compatibility Package)             lpc(1M)


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, rearrange the order of jobs in a queue, or
      display the status of each printer-along with its spooling queue and
      printer daemon.

      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 message does not need to
            be quoted, the remaining arguments are treated like echo(1).  This
            is normally used to take a printer down and let others know why
            (lpq(1) indicates that the printer is down, as does the status
            command).




10/89                                                                    Page 1

lpc(1M)            UNIX System V(BSD Compatibility Package)             lpc(1M)


      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
            The abbreviation you typed matches more than one command.

      ?Invalid command
            You typed a command or abbreviation that was not recognized.



Page 2                                                                    10/89

lpc(1M)            UNIX System V(BSD Compatibility Package)             lpc(1M)


      ?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 indicate 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.































10/89                                                                    Page 3