lp - submit print request


     lp [-c] [-m] [-p] [-s] [-w] [-d destination]  [-f form-name]
     [-H special-handling] [-n number] [-o option] [-P page-list]
     [-q priority-level]  [-S character-set  |  print-wheel]   [-
     t title] [ -T content-type [-r]] [-y mode-list] [file...]

     lp  -i request-ID...   [-c]   [-m]   [-p]   [-s]   [-w]   [-
     d destination]   [-f form-name]   [-H special-handling]   [-
     n number] [-o option] [-P page-list] [-q priority-level]  [-
     S character-set | print-wheel]  [-t title] [ -T content-type
     [-r]] [-y mode-list]


     The lp utility submits  print  requests  to  a  destination.
     There are two formats of the lp command.

     The first form of lp  prints  files  (file)  and  associated
     information  (collectively  called a print request). If file
     is not specified, lp  assumes  the  standard  input.  Use  a
     hyphen  (-)  with  file to specify the standard input. Files
     are printed in the order in which they appear on the command

     The second form of lp changes print  request  options.  This
     form  of  lp  can  only  be  used on a Solaris 2.6 Operating
     Environment or compatible versions of the LP  print  server.
     The  print  request  identified  by  request-ID  is  changed
     according to the printing options  specified.  The  printing
     options  available are the same as those with the first form
     of the lp. If the request has finished printing when the  lp
     command  is executed, the change is rejected. If the request
     is in the process of printing, it will be stopped  and  res-
     tarted  from  the  beginning  (unless the -P option has been

     The print client  commands  locate  destination  information
     using  the  "printers"  database in the name service switch.
     See nsswitch.conf(4), printers(4), and printers.conf(4)  for


     Printers that have a 4.x or BSD-based print server  are  not
     configured  to  handle  BSD  protocol extensions. lp handles
     print requests sent to such  destinations  differently  (see

     The following options are supported:

     -c    Copies file before printing.
           Unless -c is specified, users should  not  remove  any
           file  before the print request has completely printed.
           Changes made to file after the print request  is  made
           but  before  it  is  printed  will be reflected in the
           printed output. file will be  linked  (as  opposed  to

     -d destination
           Prints file on a specific destination. The  -d  option
           is  used  to  set the destination only when the job is
           first created. (Note: To move existing jobs to a  dif-
           ferent  destination,  see lpmove(1M).) destination can
           be either a  printer  or  a  class  of  printers  (see
           lpadmin(1M)).   Specify   destination   using  atomic,
           POSIX-style (server:destination), or Federated  Naming
           Service  (FNS)  (.../service/printer/...)  names.  See
           printers.conf(4) for information regarding the  naming
           conventions  for atomic and FNS names and standards(5)
           for information regarding POSIX.

     -f form-name
           Prints file on form-name. The LP print service ensures
           that  the  form  is  mounted on the printer. The print
           request is rejected if the  printer does  not  support
           form-name, if form-name is not defined for the system,
           or if the user is not allowed to  use  form-name  (see

     -H special-handling
           Prints the print request according  to  the  value  of
           special-handling.   The   following   special-handling
           values are acceptable:

           hold  Do not print the print request  until  notified.
                 If  printing  has  already begun, stop it. Other
                 print requests will go ahead of a  request  that
                 has  been put on hold (held print request) until
                 the print request is resumed.

                 Resume  a  held  print  request.  If  the  print
                 request had begun to print when held, it will be
                 the next print request  printed,  unless  it  is
                 superseded by an immediate print request.

                 Print the print request next. If more  than  one
                 print request is assigned, the most recent print
                 request is printed next. If a print  request  is
                 currently  printing  on  the  desired printer, a
                 hold  request  must  be  issued  to  allow   the
                 immediate   request   to  print.  The  immediate
                 request is only available to LP administrators.

     -i request-ID
           Changes options for the print  request  identified  by
           request-ID.  There  must  be  a  space  between -i and
           request-ID. This option applies only to jobs that  are
           in a local queue on a print server.

     -m    Sends mail after file has printed  (see  mail(1)).  By
           default,  no  mail is sent upon normal completion of a
           print request.

     -n number
           Prints a specific number of copies  of  file.  Specify
           number as a digit. The default for number is 1.

     -o option
           Specifies printer-dependent options.  Specify  several
           options  by  specifying  -o  option multiple times (-o
           option  -o  option  -o  option  ).   Printer-dependent
           options  may  also be specified using the -o keyletter
           once, followed by a list of options enclosed in double
           quotes  (-o  "  option  option option"). The following
           options are valid:

                 Does not print a banner page with  the  request.
                 This option can be disallowed by the LP adminis-

                 Prints multiple files without inserting  a  form
                 feed between them.

           length=numberi | numberc | number
                 Prints  the  print  request  with  pages  of   a
                 specific   length  in  inches,  centimeters,  or
                 number of lines. Append the letter i for  inches
                 or  c  for  centimenters to number. Indicate the
                 number of  lines  by  specifying  number  alone.
                 length=66  indicates  a page length of 66 lines.
                 length=11i indicates a page length of 11 inches.
                 length=27.94c  indicates  a page length of 27.94

                 This option may not be used with the -f option.

           width=numberi | numberc | number
                 Prints  the  print  request  with  pages  of   a
                 specific width in inches, centimeters, or number
                 of columns. Append the letter i for inches or  c
                 for  centimeters  to number. Indicate the number
                 of columns by specifying number alone.  width=65
                 indicates a page width of 65 columns. width=6.5i
                 indicates a page width of 6.5 inches.  width=10c
                 indicates a page width of 10 centimeters.

                 This option may not be used with the -f option.

                 Prints the print request with the line pitch set
                 to  number  lines  in  an  inch.  Use  number to
                 specify the number of lines in an inch.

                 This option may not be used with the -f option.

                 Prints the  print  request  with  the  character
                 pitch  set  to number characters in an inch. Use
                 number to specify the number of characters in an
                 inch.  Use  pica  to set character pitch to pica
                 (10 characters per inch), or elite to set  char-
                 acter  pitch  to  elite (12 characters per inch)
                 Use compressed to set character pitch to as many
                 characters  as  the printer can handle. There is
                 no standard number of characters  per  inch  for
                 all  printers;  see  the  terminfo database (see
                 terminfo(4)) for the default character pitch for
                 your  printer.  This option may not be used with
                 the -f option.

                 Prints the request using a list of options valid
                 for  the  stty command (see stty(1). Enclose the
                 list  in  single  quotes  (`')  if  it  contains

     -P page-list
           Prints the pages specified in page-list  in  ascending
           order.  Specify  page-list  as  a of range of numbers,
           single page number, or a combination of both.

           The -P option can only be used if there  is  a  filter
           available  to  handle it; otherwise, the print request
           will be rejected.

     -p    Enables  notification  on  completion  of  the   print
           request.  Delivery of the notification is dependent on
           additional software.

     -q priority-level
           Assigns the print request  a  priority  in  the  print
           queue.  Specify  priority-level  as an integer between
           from 0 and 39. Use 0 to indicate the highest priority;
           39  to indicate the lowest priority. If no priority is
           specified, the default priority for a print service is
           assigned by the LP administrator. The LP administrator
           may also  assign  a  default  priority  to  individual

     -s    Suppresses the display of messages sent from lp.

     -S character-set |

     -S print-wheel
           Prints the request using the character-set  or  print-
           wheel.  If a form was requested and requires a charac-
           ter set or print wheel other than  the  one  specified
           with  the -S option, the request is rejected. Printers
           using mountable print wheels or  font  cartridges  use
           the  print wheel or font cartridge mounted at the time
           of the print request, unless the -S option  is  speci-

           Printers Using Print Wheels: If print wheel is not one
           listed  by  the LP administrator as acceptable for the
           printer the request is rejected unless the print wheel
           is already mounted on the printer.

           Printers Using Selectable  or  Programmable  Character
           Sets:  If  the -S option is not specified, lp uses the
           standard  character  set.  If  character-set  is   not
           defined  in the terminfo database for the printer (see
           terminfo(4)), or is not an alias  defined  by  the  LP
           administrator, the request is rejected.

     -t title
           Prints a title on  the  banner  page  of  the  output.
           Enclose  title  in  quotes  if  it contains blanks. If
           title is not not specified, the name of  the  file  is
           printed on the banner page.

     -T content-type [-r]
           Prints the request on a printer that can  support  the
           specified  content-type.  If  no  printer accepts this
           type directly, a filter will be used  to  convert  the
           content  into  an acceptable type. If the -r option is
           specified, a filter will not be used. If -r is  speci-
           fied,   and   no   printer  accepts  the  content-type
           directly, the request is rejected. If the content-type
           is  not  acceptable to any printer, either directly or
           with a filter, the request is rejected.

     -w    Writes a message on  the  user's  terminal  after  the
           files have been printed. If the user is not logged in,
           then mail will be sent instead.

     -y mode-list
           Prints the request according  to  the  printing  modes
           listed  in mode-list. The allowed values for mode-list
           are locally defined.

           This option may be used only  if  there  is  a  filter
           available  to  handle it; otherwise, the print request
           will be rejected.


     The following operand is supported:

     file  The name of the file to be printed. Specify file as  a
           pathname  or  as a hyphen (-) to indicate the standard
           input. If file is not specified, lp uses the  standard


     See largefile(5) for the description of the behavior  of  lp
     when encountering files greater than or equal to 2 Gbyte ( 2
    **31 bytes).


     See environ(5) for descriptions of the following environment
     variables  that  affect  the  execution of lp: LANG, LC_ALL,

           Determine the format and contents  of  date  and  time
           strings displayed in the lp banner page, if any.

           Determine the destination. If the  LPDEST  environment
           variable  is not set, the PRINTER environment variable
           shall be used. The -d  dest  option  takes  precedence
           over  LPDEST.  Results  are  undefined  when -d is not
           specified and LPDEST contains a value that  is  not  a
           valid destination name.

           Determine the output device  or  destination.  If  the
           LPDEST  and PRINTER environment variables are not set,
           an unspecified output device  is  used.  The  -d  dest
           option  and the LPDEST environment variable shall take
           precedence over PRINTER. Results are undefined when -d
           is  not  specified,  LPDEST is unset, and PRINTER con-
           tains a value that is not a valid device  or  destina-
           tion name.

     TZ    Determine the timezone used to calculate date and time
           strings displayed in the lp banner page, if any. If TZ
           is unset or  null,  an  unspecified  default  timezone
           shall be used.


     The following exit values are returned:

     0     Successful completion.

           An error occurred.


           LP print queue.

           User-configurable printer database.

           System printer configuration database.

           NIS version of /etc/printers.conf.

           NIS+ version of /etc/printers.conf.

           FNS version of /etc/printers.conf.


     See attributes(5) for descriptions of the  following  attri-

    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | Availability                | SUNWpcu                     |
    | CSI                         | Enabled (see NOTES)         |
    | Interface Stability         | Standard                    |


     cancel(1), enable(1), lpq(1B), lpr(1B), lprm(1B), lpstat(1),
     mail(1),    postprint(1),    pr(1),   stty(1),   accept(1M),
     lpadmin(1M),    lpfilter(1M),    lpforms(1M),    lpmove(1M),
     lpsched(1M),    lpshut(1M),    lpsystem(1M),    lpusers(1M),
     nsswitch.conf(4),   printers(4),   printers.conf(4),    ter-
     minfo(4),  attributes(5),   environ(5),  largefile(5), stan-


     CSI-capability assumes that printer names  are  composed  of
     ASCII characters.

     Print jobs are assumed to contain one  type  of  data.  That
     type  of  data  is  either  specified on the command line or
     autodetected (simple, PostScript) based on the  contents  of
     the first file in the job.

     Printers that have a 4.x or BSD-based print server. are  not
     configured  to  handle  BSD  protocol extensions. lp handles
     print requests sent to such printers in the following ways:

     1. Print requests with more than 52 filenames will be  trun-
        cated to 52 files. lp displays a warning message.

     2. The -f, -H, -o, -P, -p, -q, -S, -T, and  -y  options  may
        require  a  protocol extension to pass to a print server.
        If lp cannot handle the  print  request,  it  displays  a
        warning message.

        LP administrators enable protocol extensions by setting a
        printer's  bsdaddr  entry in /etc/printers.conf. Changing
        the bsdaddr entry in /etc/printers.conf to:


        generates a set of BSD print protocol extensions that can
        be  processed by a Solaris print server. lp supports only
        Solaris protocol extensions at this time.

Man(1) output converted with man2html