lp(1)

NAME
     lp - print files
     cancel - cancel jobs

SYNOPSIS
     lp  [ -E ] [ -c ] [ -d destination ] [ -h server ] [ -m ] [ -n num-copies [
     -o option ] [ -q priority ] [ -s ] [ -t title ] [ -H handling ] [ -P  page-
     list ] [ file(s) ]
     lp  [ -E ] [ -c ] [ -h server ] [ -i job-id ] [ -n num-copies [ -o option ]
     [ -q priority ] [ -t title ] [ -H handling ] [ -P page-list ]
     cancel [ -a ] [ -h server ] [ -u username ] [ id ] [ destination ] [ desti-
     nation-id ]

DESCRIPTION
     lp submits files for printing or alters a pending job. Use  a  filename  of
     "-" to force printing from the standard input.

     cancel cancels existing print jobs. The -a option will remove all jobs from
     the specified destination.

OPTIONS
     The following options are recognized by lp:

     -E
          Forces encryption when connecting to the server.

     -c
          This  option  is provided for backwards-compatibility only. On systems
          that support it, this option forces the print file to be copied to the
          spool directory before printing. In CUPS, print files are always  sent
          to the scheduler via IPP which has the same effect.

     -d destination
          Prints files to the named printer.

     -h hostname
          Specifies the print server hostname. The default is "localhost" or the
          value of the CUPS_SERVER environment variable.

     -i job-id
          Specifies an existing job to modify.

     -m
          Send email when the job is completed (not supported CUPS 1.1.)

     -n copies
          Sets the number of copies to print from 1 to 100.

     -o option
          Sets a job option.

     -q priority
          Sets  the  job  priority from 1 (lowest) to 100 (highest). The default
          priority is 50.

     -s
          Do not report the resulting job IDs (silent mode.)

     -t name
          Sets the job name.

     -u username
          Cancels jobs owned by username.

     -H handling
          Specifies when the job should be printed. A value  of  immediate  will
          print  the file immediately, a value of hold will hold the job indefi-
          nitely, and a time value (HH:MM) will hold the job until the specified
          time. Use a value of resume with the -i option to resume a  held  job.
          Use a value of restart with the -i option to restart a completed job.

     -P page-list
          Specifies which pages to print in the document. The list can contain a
          list of numbers and ranges (#-#) separated by commas (e.g. 1,3-5,16).

COMPATIBILITY
     Unlike  the  System V printing system, CUPS allows printer names to contain
     any printable character except SPACE and TAB. Also, printer and class names
     are not case-sensitive.

     The "m" option is not functional in CUPS 1.1.

     The "q" option accepts a different range of values than the Solaris lp com-
     mand, matching the IPP job priority values (1-100) instead of  the  Solaris
     values (0-39).

NOTES
     Administrators wishing to prevent unauthorized cancellation of jobs via the
     -u option should password-protect the /jobs location in cupsd.conf(5).

SEE ALSO
     lpstat(1),  CUPS  Software  Users  Manual,  http://localhost:631/documenta-
     tion.html

COPYRIGHT
     Copyright 1993-2005 by Easy Software Products, All Rights Reserved.