klpr(1) - Linux man page

Name

klpr - Krause's lpr clone

Synopsis

klpr [<options>] [<file(s)>]

Description

The klpr programs sends a file to a print server. Depending on the print server type ( LPR , LPRng or raw socket) the file is either spooled for printing or printed directly.

Options

-S server

connects to the specified print server host. The server can be specified either by hostname or IP address. If this option is not used and there is no host name given using the -P option the program tries to find a default print host in the following places:

the " PRINTHOST " environment variable,

the "/yalc/print-host" user preference

the "/print-host" registry entry in HKCU/Software/DKrause/Yalc

the "/yalc/print-host" system preference

the "/print-host" registry entry in HKLM/Software/DKrause/Yalc

Alternative option: -H server

Long option: --server=server

-P printer

chooses a print queue. The print queue can be specified as alias, or using queue@host or host%port.

If the -P option is not used the program searches for a printer name in the following places:

the " NGPRINTER ", " NPRINTER ", " LPDEST " and " PRINTER " environment variables,

the "/yalc/default-printer" user preference,

the "/default-printer" registry entry in HKCU/Software/DKrause/Yanolc,

the "/yalc/default-printer" system preference,

the "/default-printer" registry entry in HKLM/Software/DKrause/Yanolc.

If the queue name doest not contain a host information, the print server host information is retrieved from the -S option.

Long option: --printer=printer

-U user

assigns the specified user name to the print job. This option can only be used by users listed in the "xusers" section for the printer or the print server.

Long option: --username=user

-C class

specifies a print job class.

Long option: --class=class

File type options:

-l

Literal file (binary file, raw print data), print "as is".

Long option: --literally

-c

Cifplot file.

Long option --cifplot

-d

DVI file (created by LaTeX or troff).

Long option: --dvi

-g

Plot file.

Long option: --plot

-n

Device-independent troff file.

Long option: --dvi-troff

-p

Output file created by troff.

Long option: --troff

-r

Raster file.

Long option: --raster

-e

enable banner page printing.

Long option: --header=boolean

-j width

indent all lines by width spaces.

Long option: --indent=width

-J job-name

specifies a job name for banner page printing.

Long option: --jobname=name

-K number

specifies the number of copies.

Alternative option: -# number

Long option: --copies=number

-m mail-address

sends e-mail to the specified address after printing.

Long option: --mail=address

-Q queue-name

uses the queue-name for the control file.

This option is not implemented here. In LPRng this option adds a control file entry ''original queue name''.

-R user-name

uses the specified name for accounting.

This option is not implemented here. In LPRng this option would charge the named user for the print job.

-T job-title

specifies the job title for the banner page.

Long option: --jobtitle=title

-V

switches the program to verbose output (this option is not implemented here, it is ignored silently).

Long option: --verbose=boolean

-w width

specifies the line length for the "pr" filter.

Long option: --width=width

-o options

adds further filter options.

Return Value

On success the program returns exit code 0, a positive value is returned on errors.

Files

The yanolc.cfg file is used to configure print queues.

Restrictions

Some options (encryption, authentication...) found in LPRng are not implemented in yanolc. There are no plans to do so.

Notes

Users should not rely on automatic conversions for the different file types.

Print server administrators might have turned automated conversions off for security reasons.

See Also

http://dktools.sourceforge.net/yanolc.html

Author

Dirk Krause

Copyright And License

Copyright © 2001-2008, Dirk Krause All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above
  copyright notice, this list of conditions and the
  following disclaimer.

* Redistributions in binary form must reproduce the above
  copyright notice, this list of conditions and the following
  disclaimer in the documentation and/or other materials
  provided with the distribution.

* Neither the name of the Dirk Krause nor the names of
  contributors may be used to endorse or promote products
  derived from this software without specific prior written
  permission.