NAME¶
apsfilterrc
—
configuration file for magic print filter
SYNOPSIS¶
DESCRIPTION¶
Apsfilterrc
is a configuration file for
printers controlled by the
apsfilter(1) magic
filter.
Every apsfilter printer in
printcap(5) has an
apsfilterrc
file of its own.
There is one global apsfilterrc file that controls print characteristics for all
printer. The printer-specific
apsfilterrc
files have preference over the global one.
Reasons for using an
apsfilterrc
file are if
it turns out, that you have to type in some commandline options too often or
if an application is unable to parameterize the print command, so that you
have to hardcode the print characteristic for such dumb applications.
An enhancement to this concept are user-specific config files, that have
preference over the global and the printer-specific config file. This allows
configuration of print characteristics on a per-user basis.
You should make use of user-specific config files instead of using the
deprecated USE_USER_CODE variable, which compromises system security and is
only an option on a single-user machine, see below.
Capabilities¶
QUALITY
- Select print quality (draft, lo|low, med|medium, hi|high, photo).
SWEEP
- Print uni- or bidirectional (uni, bi).
MEDIA
- Select paper type (plain, coated, glossy, premium, trans).
COLOR
- Select color mode (color|colour, gray|grey, mono).
METHOD
- Choose apsfilters method of data processing (auto, ascii, raw). Automatic
file type recognition and automatic conversion to Postscript is apsfilters
default processing method. If you want to print mostly files `as is', you
can set the default to 'raw', this disables any kind of file type
recognition and conversion. If you want to print mostly everything as
ASCII text, then you can set this option to 'ascii'.
PAPERSIZE
- Set the default paper size (a3, a4, legal, ledger, tabloid).
ASCII_FILTER
- Text file filter to use, when printing ASCII documents (a2ps, mpage,
enscript, recode).
PAPERTRAY
- Paper feed tray number (tray0...tray9).
PRETTY_PRINTING
- a2ps highlight level for pretty-printing when using a2ps or enscript as
ascii filter (0, 1, 2). See also ASCII_FILTER.
ASCII_HEADER
- Whether you want headers in your text prints when using a2ps, mpage or
enscript as ascii filter (header, noheader).
ASCII_BORDER
- Whether you want borders in your text prints when using a2ps, mpage or
enscript as ascii filter (border, noborder).
PS_NUP|ASCII_PPS
- Pages per sheet (1pps, 2pps, 4pps, 8pps).
LANDSCAPE|ASCII_LANDSCAPE
- Paper orientation (landscape, portrait).
PS_BOOK
- Output pages in "book" format, implies commandline options
"2pps,duplex,shortbind". Related options: PS_NUP, ASCII_PPS,
DUPLEX, BINDING.
DUPLEX
- Whether to use duplex mode or not (duplex, simplex).
BINDING
- Paper binding edge (shortbind, longbind).
COPIES
- Number of copies (copies=N).
USE_USER_CODE
- Enabling this option is a big potential security hole !!! If you don't
understand this, DO NOT USE IT. It makes user manageable
apsfilterrc
files possible which will
be sourced (included/executed) during runtime of a printjob under the
permissions of the calling process (lpd). This option is only valid for
typical "single-user" systems, where a user wants direct access
to an apsfilterrc without having to become root to make changes. A more
conveniant way on a multi-user system, where security is an issue, is that
a system administrator creates user-specific
apsfilterrc
files. Additional
informations can be found in the apsfilter handbook and in the apsfilterrc
file together with some examples.
FILES¶
- /etc/apsfilter/apsfilterrc
- apsfilter global config file, settings are
overwriteable by more specific printer config files, see below.
- /etc/apsfilter/QUEUE/apsfilterrc
- apsfilter config file on a per printer queue
basis. This file has preference over the global config file.
- /etc/apsfilter/QUEUE/apsfilterrc.USER
- apsfilter config file on a per user basis
(per print queue). This file has preference over the global and the
printer queue specific config file.
- $HOME/.apsfilter/apsfilterrc.QUEUE
- A user defineable config file on a per
printer queue basis. This file has preference over the global, the printer
queue specific and the central per user config file, which is administered
by a system administrator. Enabling this has a deep impact on your systems
security, should NOT be used, especially on
multi-user systems and is therefore disabled by
default. See comments to USE_USER_CODE variable.
SEE ALSO¶
apsfilter(1),
printcap(5)
BUGS¶
See apsfilter software center -
http://www.apsfilter.org/
- for new versions, bugfixes
and known bugs.
Please use the new tool
apsfilter-bug(1) to release
bug- or problem reports. It automatically presents you a
form
in an editor window which asks you
some standard questions. If you save and quit the editor session, then this
report is sent automatically via
e-mail
to
the proper apsfilter mailinglist.
If apsfilter fails to print something or prints it in a way you wouldn't expect
and you want to report an apsfilter error then please save the debugging
output of one print session using the new
aps2file(1) utility by typing
aps2file -D -Z options file > /dev/null 2>
file.debug
and including the debugging output in the file
file.debug
into the edit session of the
apsfilter-bug
utility, so that it is
included into the mail to the apsfilter mailinglist.
Please note that you need to run /bin/sh (Bourne Shell), bash or a compatible
shell, so that the above mentioned output redirection works. Under C-shell
(/bin/csh) or tcsh it would't work. If you don't know, then simply make sure
you use the Bournce shell by typing
/bin/sh
or
bash
, then you should have no problems
with redirection of
stdout
and
stderr
(> /dev/null 2> file.debug).
DOCUMENTATION¶
See official apsfilter homepage
- http://www.apsfilter.org/handbook.html
- Apsfilter Handbook including the Frequently Asked Questions (FAQ)
USER FORUM¶
Please send questions to the official apsfilter help channel
apsfilter-help@apsfilter.org
. The above
section
BUGS
and the file
HOWTO-BUGREPORTS
tells you how to report
bugs. If you want to know how to troubleshoot your apsfilter installation,
please read the manpage
aps2file(1) and
apsfilter-bug(1) as well as the
Apsfilter Handbook
carefully.
HISTORY¶
Apsfilter
developement started in 1994.
The
apsfilterrc
file on a "per printer
queue" basis appeared in apsfilter 5.4.0.