Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

lprrm

Remove jobs from a line printer's spooling queue

Syntax:

lprrm [-Pprinter] [-] [jobnum ...] [user ...]

Runs on:

Neutrino

Options:

-Pprinter
Specify the queue associated with a specific printer; otherwise, the default printer is used.
-
Remove all of the jobs that you own. If the superuser (root) uses this flag, lprrm empties the entire spool queue.
jobnum
Remove the individual job specified by the given job number. You can get this number from the lprq utility.
user
Attempt to remove any jobs queued belonging to that user (or users). This form of invoking lprrm is useful only to the superuser.

Description:

The lprrm utility removes one or more jobs from a printer's spool queue. Since the spooling directory itself is protected from users, lprrm is normally the only way that you can remove a job. The job's owner is determined by the user's login name and hostname on the machine where the lpr command was invoked.


Note: This utility needs to have the setuid (“set user ID”) bit set in its permissions. If you use mkefs, mketfs, or mkifs on a Windows host to include this utility in an image, use the perms attribute to specify its permissions explicitly, and the uid and gid attributes to set the ownership correctly.

Note that if you don't specify any arguments or options, lprrm deletes the currently active job if you own it.

The lprrm utility announces the names of any files it removes and is silent if the queue contains no jobs that match the request list.

The utility kills off an active daemon, if necessary, before removing any spooling files. If a daemon is killed, a new one is automatically restarted upon completion of file removals.

Files:

/etc/printcap
Printer description file.

Environment variables:

PRINTER
An alternate default printer.

Errors:

Permission denied
Displayed when you try to remove print jobs that aren't yours.

Caveats:

Since there are race conditions possible in the update of the lock file, the currently active job may be incorrectly identified.

See also:

lpd, lpr, lprc, lprq, /etc/printcap

Printing chapter of the Neutrino User's Guide