lpr man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

lpr(1B)		   SunOS/BSD Compatibility Package Commands	       lpr(1B)

NAME
       lpr - submit print requests

SYNOPSIS
       /usr/ucb/lpr [-P destination] [-# number] [-C class]
	    [-J job] [-T title] [-i [indent]]
	    [-1 | -2 | -3 | -4 font] [-w cols] [-m] [-h] [-s]
	    [-filter_option] [file]...

DESCRIPTION
       The  lpr	 utility  submits  print requests to a destination. lpr prints
       files (file) and associated information, collectively  called  a	 print
       request. If file is not specified, lpr assumes the standard input.

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

       Print  requests	with  more  than 52 files specified is truncated to 52
       files when the BSD print protocol is used for job submission.

OPTIONS
       The following options are supported:

       -C class

	   Prints class as the job classification on the banner	 page  of  the
	   output.  Enclose  class  in double quotes if it contains blanks. If
	   class is not specified, the name of	the  system  (as  returned  by
	   hostname) is printed as the job classification. See hostname(1).

       -h

	   Suppresses printing of the banner page of the output.

       -i indent

	   Indents  the	 output	 a  specific  number  of SPACE characters. Use
	   indent to indicate the number of SPACE characters to	 be  indented.
	   Specify  indent  as a positive integer. If the optional argument to
	   indent is  not  specified,  then  eight  SPACE  characters  is  the
	   default.  The  -i option is ignored unless it is specified with the
	   -p filter option.

       -J job

	   Prints job as the job name  on  the	banner	page  of  the  output.
	   Enclose  job	 in double quotes if it contains blanks. If job is not
	   specified, file (or in the case of multiple files, the  first  file
	   specified  on  the  command line) is printed as the job name on the
	   banner page of the output.

       -m

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

       -P destination

	   Prints  file	 on a specific printer or class of printers (see lpad‐
	   min(1M)).   Specify	  destination	 using	  atomic,    URI-style
	   (scheme://endpoint), or POSIX-style (server:destination) names. See
	   printers.conf(4) for information regarding destination names.

       -s

	   Prints files by reference rather than copying them. This means that
	   files  should  not be modified or removed until they have completed
	   printing. This option only prevents copying of files when the print
	   queue  is  on  the local machine and the files are specified on the
	   command line.

       -T title

	   Prints a title on the page header of the output. Enclose  title  in
	   double  quotes  if  it  contains  blanks.  The -T option is ignored
	   unless it is specified with the -p filter option.

       -w cols

	   Prints file with pages of a specific width. cols indicates the num‐
	   ber	of  columns wide. The -w option is ignored unless it is speci‐
	   fied with the -p filter option.

       −1|−2|−3|−4 font

	   Mounts the specified font in the font position 1, 2, 3, or 4. Spec‐
	   ify font as a valid font name.

       − filter_option

	   Notifies  the  print spooler that file is not a standard text file.
	   Enables the spooling daemon to use the appropriate filters to print
	   file.

	   filter_options  offer a standard user interface. All filter options
	   might not be available for, or applicable to, all printers.

	   Specify filter_option as a single character.

	   If filter_option is not specified and  the  printer	can  interpret
	   PostScript,	inserting  `%!'	 as  the  first two characters of file
	   causes file to be interpreted as PostScript.

	   The following filter options are supported:

	   c	file contains data produced by cifplot.

	   d	file contains tex data in DVI format from Stanford.

	   f	Interprets the first character of each line as a standard FOR‐
		TRAN carriage control character.

	   g	file contains standard plot data.

	   l	Print control characters and suppress page breaks.

	   n	file contains ditroff data from device independent troff.

	   p	Use pr to format the files. See pr(1).

	   t	file contains troff (cat phototypesetter) binary data.

	   v	file  contains	a raster image. printer must support an appro‐
		priate imaging model such as PostScript in order to print  the
		image.

       -# number

	   Prints  a  specific	number of copies. Specify number as a positive
	   integer. The default for number is 1.

OPERANDS
       The following operand is supported:

       file    The name of the file to be printed. Specify file as a pathname.
	       If file is not specified, lpr uses the standard input.

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

EXIT STATUS
       The following exit values are returned:

       0	   Successful completion.

       non-zero	   An error occurred.

FILES
       /etc/printers.conf      System printer configuration database

       $HOME/.printers	       User-configurable printer database

       ou=printers	       LDAP version of /etc/printers.conf

       printers.conf.byname    NIS version of /etc/printers.conf

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Availability		     │SUNWlpr-cmds		   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stabilitly	     │Standard			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │CSI			     │Enabled. See NOTES	   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       hostname(1), lp(1), lpc(1B),  lpq(1B),  lprm(1B),  lpstat(1),  mail(1),
       pr(1),  troff(1),  lpadmin(1M),	nsswitch.conf(4),  printers(4), print‐
       ers.conf(4), attributes(5), largefile(5), standards(5)

DIAGNOSTICS
       lpr: destination |: unknown destination

	   destination was not found in the LP configuration database. Usually
	   this	 is a typing mistake; however, it can indicate that the desti‐
	   nation does not exist on the	 system.  Use  lpstat  -p  to  display
	   information about the status of the print service.

NOTES
       lpr is CSI-enabled except for the printer name.

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

       When IPP is in use, the user is prompted for a passphrase if the remote
       print service is configured to require authentication.

SunOS 5.11			  10 Dec 2009			       lpr(1B)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net