klpc(1) - Linux man page

Name

klpc - Control LPRng print queues

Synopsis

klpc [<arguments>]

Description

The klpc program performs control operations on a LPRng print server.

Commands

klpc start printer

starts or restarts a print queue.
klpc stop printer: stops a print queue.
klpc enable printer: enables spooling to a print queue.
klpc disable printer: disables spooling to a print queue.
klpc abort printer: kills and unspools the current job on a print queue.
klpc kill printer: restarts a print queue.
klpc topq printer job: moves a job to the top of the queue (makes it the next job to be printed).
klpc status printer: displays status of daemon and print queue.
klpc hold printer job(s): holds the specified jobs in the queue until they are released (holding means keeping the job in the queue but not printing it).
klpc holdall printer: holds all jobs in the specified queue.
klpc release printer job(s): releases the specified job(s).
klpc move job(s) printer: moves the print job(s) to another queue.
klpc active printer: checks a queue response.
klpc lpd printer: print the PID of the lpd daemon serving the specified queue.

Options

-H server

specifies the LPRng host to connect to.

Return Value

The program returns exit status code 0 on success, any other value indicates an error.

Restrictions

In contrast to the lpc program from LPRng this clone does not have an interactive mode. You have to specify the control operations as command line arguments.

Author

Dirk Krause

Copyright And License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above
  copyright notice, this list of conditions and the
  following disclaimer.

* Redistributions in binary form must reproduce the above
  copyright notice, this list of conditions and the following
  disclaimer in the documentation and/or other materials
  provided with the distribution.

* Neither the name of the Dirk Krause nor the names of
  contributors may be used to endorse or promote products
  derived from this software without specific prior written
  permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS " AS IS " AND ANY EXPRESS OR IMPLIED WARRANTIES , INCLUDING , BUT NOT LIMITED TO , THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED . IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT , INDIRECT , INCIDENTAL , SPECIAL , EXEMPLARY , OR CONSEQUENTIAL DAMAGES ( INCLUDING , BUT NOT LIMITED TO , PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES ; LOSS OF USE , DATA , OR PROFITS ; OR BUSINESS INTERRUPTION ) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY , WHETHER IN CONTRACT , STRICT LIABILITY , OR TORT ( INCLUDING NEGLIGENCE OR OTHERWISE ) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE , EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE .

Pod Errors

Hey! The above document had some coding errors, which are explained below:

Around line 15:: '=item' outside of any '=over'
Around line 76:: You forgot a '=back' before '=head1'