lp(1)                                 Easy Software Products                                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 ] [ destination-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  print-
            ing. 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 indefinitely, 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  com-
            pleted job.

       -P page-list
            Specifies  which  pages to print in the document. The list can contain a list of num-
            bers 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 command, 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/documentation.html

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



1 May 2003                         Common UNIX Printing System                              lp(1)