unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lpc(8)								       lpc(8)



NAME

  lpc -	Line printer control program

SYNOPSIS

  lpc [command[argument...]]

DESCRIPTION

  The lpc command is used by the system	administrator to control the opera-
  tion of the line printer system. For each line printer configured in the
  /etc/printcap	file, the lpc command may be used for disabling	or enabling a
  printer; disabling or	enabling the printer spooling queue; rearranging the
  order	of jobs	in a spooling queue or finding the status of printers, their
  associated spooling queues, and the printer daemons.

  Without arguments, lpc prompts for commands from the standard	input. When
  arguments are	supplied, lpc interprets the first argument as a command and
  any remaining	arguments as command parameters.  The standard input may be
  redirected so	that lpc reads commands	from a file. The following is the
  list of recognized lpc commands:

  ? [command ...]
      Prints a short description of each command specified in the argument
      list or, when no arguments are supplied, a list of the recognized	com-
      mands.

  help [command	...]
      Prints a short description of each command specified in the argument
      list or, when no arguments are supplied, a list of the recognized	com-
      mands.

  abort	[all | printer ...]
      Terminates an active spooling daemon running on the local	host, and
      then disables printing. This prevents new	daemons	from being started by
      lpr or lp	for the	specified printers.

  clean	[all |	printer	...]
      Removes any temporary files, data	files, and control files that cannot
      be printed (files	that do	not form a complete printer job) from the
      specified	printer	queue(s) on the	local machine.

  disable [all |  printer ...]
      Turns the	specified printer queues off. This prevents new	printer	jobs
      from being entered into the queue	by lpr or lp.

  down [all |  printer ...]  message ...
      Turns the	specified printer queue	off, disables printing,	and puts a
      message in the printer status file. The message does not need to be
      quoted because remaining arguments are treated the same as echo. The
      down command is normally used to take a printer down and let others
      know why.	(The lpq command indicates that	the printer is down and
      prints a status message.)

  enable [all |	printer	...]
      Enables spooling on the local queue for the listed printers. This
      allows lpr or lp to put new jobs in the spool queue.

  exit
      Exit from	lpc.

  quit
      Exit from	lpc.

  restart [all | printer ...]
      Attempts to start	a new printer daemon. This is useful when some abnor-
      mal condition causes the daemon to terminate unexpectedly	and leave
      jobs in the queue.  lpq reports that there is no daemon present when
      this condition occurs.  When a daemon is stuck, you must first kill it
      and then restart.

  start	[all |	printer	...]
      Enables printing and starts a spooling daemon for	the listed printers.

  status [printer ...]
      Displays the status of daemons and queues	on the local machine. When
      printer name parameters are not supplied,	information about all
      printers is provided.

  stop [ all | printer ...]
      Stops a spooling daemon after the	current	job has	completed and dis-
      ables printing.

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

  up [all |  printer ...]
      Enables all printing and starts a	new printer daemon. Cancels the
      effect of	the down command.

RESTRICTIONS

  Normally, the	clean subcommand allows	you to remove all print	jobs on	the
  system or all	jobs on	a specified printer.  However, clean does not remove
  the jobs in the spooling queues. Therefore, you should use the lprm command
  on a printer-by-printer basis	to remove the jobs you want to eliminate.

ERRORS

  The following	diagnostic messages are	possible.

  ?Ambiguous command
      Abbreviation matches more	than one command.

  ?Invalid command
      No match was found.

  Privileged command
      Command may be executed by the superuser only.

FILES

  /usr/sbin/lpc
      Specifies	the command path

  /etc/printcap
      Specifies	the printer description	file

  /usr/spool/*
      Specifies	print spool directories

  /usr/spool/*/lock
      Specifies	the lock file for queue	control


SEE ALSO

  Commands: cancel(1), lp(1), lpd(8), lpr(1), lpq(1), lprm(1), lpstat(1)

  Files: printcap(4)