lp(p)                 Easy Software Products                lp(p)



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(e) ]
       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 ] [ id ] [ destination ] [ des-
       tination-id ]

DESCRIPTION
       lp submits files for printing or alters a pending job.

       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.

       -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  environ-
            ment 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  (high-
            est). The default priority is 50.

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

       -t name
            Sets the job name.

       -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.

       -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 command, matching the IPP job priority val-
       ues (1-100) instead of the Solaris values (0-39).

SEE ALSO
       lpstat(t),   CUPS  Software  Users  Manual,  http://local-
       host:631/documentation.html

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



25 September 2001  Common UNIX Printing System              lp(p)