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  speci-
	   fied,  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 lpadmin(1M)). Specify destination using	atomic,  URI-style  (scheme://end-
	   point), 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 number of columns wide. The -w option is ignored unless it is  specified
	   with the -p filter option.

       -1|-2|-3|-4 font

	   Mounts the specified font in the font position 1, 2, 3, or 4. Specify 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(R), 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 FORTRAN carriage control character.

	   g	file contains standard plot data produced by plot(1B) routines.

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

       printers.org_dir        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), plot(1B), pr(1), troff(1), lpadmin(1M), nsswitch.conf(4), printers(4),
       printers.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,
       PostScript) 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							    2 Jun 2006								   lpr(1B)