Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
APS2FILE(1)		  BSD General Commands Manual		   APS2FILE(1)

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/local/share/apsfilter/SETUP.

FILES
     /etc/printcap			       printer capability data base
     /usr/local/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 ver-
     sions, bugfixes and known bugs.

     Please use	the new	tool apsfilter-bug(1) to release bug- or problem re-
     ports. It automatically presents you a form in an editor window which
     asks you some standard questions.	If you save and	quit the editor	ses-
     sion, 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 de-
     bugging output of one print session using the new aps2file(1) utility by
     typing aps2file -D	-Z options file	> /dev/null 2> file.debug and includ-
     ing 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	com-
     patible shell, so that the	above mentioned	output redirection works. Un-
     der 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	care-
     fully.

HISTORY
     The aps2file manpage has been written by Michael Lossin <phal-
     lobst@web.de> and first appeared in apsfilter V 7.1.0.

BSD				 Dec 19, 2001				   BSD

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | FILES | SEE ALSO | BUGS | DOCUMENTATION | USER FORUM | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=aps2file&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help