NAME
aps2file - printing to a file via apsfilter
SYNOPSIS
aps2file [-D] [-Pqueue] [-Zoptions] [-ooutput] [input]
aps2file [-h]
DESCRIPTION
With aps2file you can direct the printer data generated by apsfilter(1)
into an arbitrary file without the use of a spooler.
OPTIONS
-h show help screen
-D enable debug mode
-Pqueue select a printer queue (different from the default one)
-Zoptions use apsfilter command line options (comma-separated list)
-ooutput direct data stream to output (default: stdout)
input read data from input (default: stdin)
Unlike printing with lpr(1), you can only use one input file at a time.
Using aps2file is also the recommended way to create a debugging log of a
failed printing attempt. If you include the -D flag, the apsfilter shell
script will log every command and print it to stderr. To save the output
for inclusion into a bug report, you should therefore use a command of
the sort
aps2file -D -o /dev/null [-P...] [-Z...] [input] 2> log.txt
NOTES
aps2file only works correctly with entries in /etc/printcap that have
been created by /usr/share/apsfilter/SETUP.
FILES
/etc/printcap printer capability data base
/usr/share/apsfilter/bin/apsfilter apsfilter script
SEE ALSO
apsfilter(1), apsfilter-bug(1), apspreview(1), apsfilterrc(5),
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
The aps2file manpage has been written by Michael Loßin <phallobst@web.de>
and first appeared in apsfilter V 7.1.0.