Menu

printqdc manual

Dirk Krause
← Previous ↑ Home → Next

printqdc — Client to communicate with printqd

Synopsis

printqdc [_options_]

Description

The printqdc program (print quota daemon client) communicates to a printqd daemon.

The program has two modes:

Pipe mode (default)

The program is configured as a filter/pipe either in the LPRng system using

:af=/path.../printqdc

or in the pjsnmp program using

:pjsnmp-accounting-file=|/path.../printqdc

The program reads accounting requests either in LPRng or printqd format from standard input line by line, converts LPRng lines into printqd lines, opens a connection to the printqd daemon, sends the lines, optionally waits for a response and processes the response.
In this mode the program produces not output at all, neither to stdout nor to stderr. The exit status code is set depending on the first request line requiring a response.

Interactive mode (option -i).

In interactive mode all requests and responses are shown on standard output, error messages (if any) are shown on standard error output.
The exit code indicates success or failure (any error occured).
This mode is intended for interactive maintenance operations.


Options

Option Purpose
-i
--interactive
Interactive mode (instead of default pipe mode).
-s path
--socket=path
File name of local UNIX domain socket for communication to printqd.
Default: ${localstatedir}/run/printqd/printqd.sock .
-h name
--host=name
Host name for communication to printqd via network. Requires a port number too.
-p number
--port=number
Port number for communication to printqd via network. Requires a host name too.
--help Show short help text.
--version Show version information.
--license Show license information.

Exit status

In interactive mode: 0 on success, all other status codes indicate an error.

In pipe mode: 0 if printing is allowed by printqd, 3 to remove the job (printing denied), 6 to hold the job (printing denied).


Restrictions

The program is not available on Windows platforms. Printqd and printqdc are add-ons to the LPRng print system which is available for POSIX systems only.

This is a simple program: All texts are shown in English, the program is not relocatable.


Notes

This program uses DK libraries version 4.


Author

Dirk Krause


See also

Program Purpose
LPRng Enhanced print spooler.
[printqd] Print quota daemon for the LPRng print system.
[pjsnmp] Print job transfer filter for the LPRng print system.
[wxpqdic] GUI program to query quota information from printqd.

← Previous ↑ Home → Next

Related

Wiki: pjsnmp
Wiki: printqd
Wiki: printqdc
Wiki: wxpqdic