contact contact

eqpcl utility

» Usage | Notes | Examples | See also
  The eqpcl utility converts PCL documents to PDF or Postscript. It implements a commonly used subset of PCL functionality.

The eqpcl utility internally translates the PCL command sequences and text into Postscript and uses GNU Ghostscript to create the PDF output.


usage: eqpcl [options] [pcl-file ...]

output options:
 -p       create PDF output
 -s       create postscript output
 -a       analyze pcl data (-aa more verbose)
 -g       create postscript and pass to ghostscript

 -c cfg   specify config file (default is eqpcl.cfg, ~/.eqpcl)
 -o out   specify output file (default is stdout)
 -m file  specify PDF marks input file
 -G opt   additional ghostscript options
 -V       output version and exit
Any number of PCL command files may be specified on the command line, which are then combined to a single document, each file separated by a PCL reset. If no file name is present, the input is read from stdin. This allows to use eqpcl in a pipe.

The options are:

The -help option displays a brief help text.

The option -p is is used to create a PDF file as a result. In this case, eqpcl internally creates an intermediate Postscript result which is passed to Ghostscript to create the PDF. The option -pp is is used to create a PDF/A compliant PDF file.

Create Postscript output.

The option -g translates the PCL input and passes it to Ghostscript. This option does NOT create a PDF file but allows to use eqpcl as a simple frontend to Ghostscript (for example, to print the resulting document).

Decode PCL command stream. If specified twice (-aa) the output is more verbose.

-c eqpcl.cfg
The option -c is used to specify a config file that defines some configuration and PCL defaults.

-o file
The option -o is used to specify the name of an output file. If not present, the output is written to stdout so that eqpcl may be used in a pipe.

-m file
The option -m specifies a text file containing PDFmarks. The file content is added verbatim to the postscript output. This allows to specify PDF meta information (such as title, author or bookmarks). This file must comply with the PDFmarks syntax.

-G opt
The -G option allows to specify additional Ghostscript options.


The option -c is used to specify a config file that defines some configuration and PCL defaults.

If no configuration file is specified (-c option):

  1. First, the eqpcl utility will look for a file named eqpcl.cfg in the current directory.

  2. On HP-UX and Linux, the eqpcl utility will then look for a file named .eqpcl in the home directory (~/.eqpcl).

  3. Finally, eqpcl will look for a file named eqpcl.cfg in the etc subdirectory of your Eloquence installation.


eqpcl -c eqpcl.cfg -p -o sample.pdf sample.pcl
This creates a PDF document (sample.pdf) from PCL file sample.pcl. The config file eqpcl.cfg is used.
cat sample.pcl | eqpcl -c eqpcl.cfg -p > sample.pdf
The PCL data is read from stdin and converted to PDF on stdout.
eqpcl -a sample.pcl
Analyze the file sample.pcl. This decodes the PCL commands and text. Outputs the results to stdout.

See also

eqpcl.cfg config file and PCL to PDF conversion (B.08.20 release notes)

  Privacy | Webmaster | Terms of use | Impressum Revision:  2013-04-17  
  Copyright © 2013 Marxmeier Software AG