Name
Xprt — Print server for X Version 11
Synopsis
Xprt [-ac] [-audit level] [-pn] [-fp fontpath] [-XpFile file] [-XpSpoolerType spoolername] [:display]
DESCRIPTION
Xprt is the Xprint print server
+ for version 11 of the X Window system for non display devices
+ such as printers and fax machines.
Xprint is an advanced printing system which enables X11
+ applications to use devices like printers, FAX or create
+ documents in formats like PostScript, PCL or PDF. It may be used by
+ clients such as mozilla.
+
Xprint is a very flexible, extensible, scaleable, client/server
+ print system based on ISO 10175 (and some other specs) and the X11
+ rendering protocol.
+ Using Xprint an application can search, query and use devices like
+ printers, FAX machines or create documents in formats like PDF.
+ In particular, an application can seek a printer, query supported
+ attributes (like paper size, trays, fonts etc.), configure the printer
+ device to match it's needs and print on it like on any other X device
+ reusing parts of the code which is used for the video card Xserver.
+
USAGE
+ Although Xprt may be invoked from the command line, it is
+ preferable to run it as a daemon via the init script
+ /etc/init.d/xprint (where this script exists).
+
Client programs such as mozilla will require environment
+ variable ${XPSERVERLIST} to be set, identifying the
+ "display" on which Xprt is running. This variable may be set
+ for all users via /etc/profile (or similar), using
+ /etc/init.d/xprint get_xpserverlist:
+
OPTIONS
Many of Xprt's command line options are shared in common
+ with the usual X servers (see Xserver(1x)).
+ Commonly used options include:
- :display
The X server runs on the given display. If multiple X
+ servers are to run simultaneously on a host, each must
+ have a unique display number. Note that the standard X
+ server (for video displays) typically runs on display
+ :0. If /etc/init.d/xprint is used
+ to invoke Xprt, it may be configured to automatically assign an available
+ display number.
- -ac
disables host-based access control mechanisms. Enables access
+ by any host, and permits any host to modify the access control
+ list. Use with extreme caution. This option exists primarily
+ for running test suites remotely.
- -audit level
sets the audit trail level. The default level is 1, meaning
+ only connection rejections are reported. Level 2 additionally
+ reports all successful connections and disconnects. Level 4
+ enables messages from the SECURITY extension, if present,
+ including generation and revocation of authorizations and
+ violations of the security policy. Level 0 turns off the audit
+ trail. Audit lines are sent as standard error output.
- -fp fontpath
sets the search path for fonts. This path is a comma
+ separated list of directories which Xprt searches for
+ font databases.
- -pn
permits the server to continue running if it fails to
+ establish all of its well-known sockets (connection
+ points for clients), but establishes at least
+ one.
- -XpFile file
Sets an altername Xprinters file (see section FILES).
- -XpSpoolerType spoolername
+ Defines the spooler system to be used for print job spooling.
+ Supported values in xprint.mozdev.org release 009 are:
+
| aix |
| aix4 |
| bsd |
| osf |
| solaris |
| sysv |
| uxp |
| cups |
| lprng |
| other |
| none |
+ (multiple values can be specified, seperated by ':', the first active spooler will be chosen).
+ The default value is platform-specific and can be obtained via
+
Xprt -h
.
+
ENVIRONMENT
+ The following environment variables are recognized by the X print server
+ (environment variables recognized by Xprint clients are described in
+ Xprint(7)):
+
+
- ${XPCONFIGDIR}
This environment variable points to the root
+ of the Xprint server configuration directory hierarchy.
+ If the variable is not defined, the default
+ path is be assumed. The default path may be
+ /usr/X11R6/lib/X11/xserver/,
+ /usr/lib/X11/xserver/,
+ /usr/share/Xprint/xserver/ or
+ /usr/openwin/server/etc/XpConfig, depending on the
+ system, and may be configured in /etc/init.d/xprint.
- ${LANG}
+ This environment variable selects the locale settings used by the Xprint server.
+ Xprt allows language-specific settings (stored in ${XPCONFIGDIR}/${LANG}/print/)
+ which will override the default settings (stored in ${XPCONFIGDIR}/C/print/).
+ If ${LANG} is not set "C" is assumed.
+
FILES
- ${XPCONFIGDIR}/${LANG}/print/Xprinters, ${XPCONFIGDIR}/C/print/Xprinters
+ `Xprinters' is the top most configuration file. It tells
+ Xprt which specific printer names (e.g. mylaser) should
+ be supported, and whether lpstat(1) or other commands
+ should be used to automatically supplement the list of
+ printers.
+
- ${XPCONFIGDIR}/${LANG}/print/attributes/printer, ${XPCONFIGDIR}/C/print/attributes/printer
+ The `printer' file maps printer names to model
+ configurations (see `model-config' below). For example,
+ "mylaser" could be mapped to a "HPDJ1600C", and all other
+ arbitrary printers could be mapped to a default, such as
+ "HPLJ4SI". When depending on lpstat(1) in the Xprinters
+ file, setting up defaults in `printer' becomes all the
+ more important.
+
- ${XPCONFIGDIR}/${LANG}/print/attributes/document, ${XPCONFIGDIR}/C/print/attributes/document
+ The `document' file specifies the initial document values
+ for any print jobs. For example, which paper tray to
+ use, what default resolution, etc.
+
- ${XPCONFIGDIR}/${LANG}/print/attributes/job, ${XPCONFIGDIR}/C/print/attributes/job
+ The `job' file specifies the initial job values for any
+ print jobs. For example, "notification-profile" can be
+ set so that when a print job is successfully sent to a
+ printer, e-mail is sent to the user.
+
- ${XPCONFIGDIR}/C/print/models/PSdefault/model-config, ${XPCONFIGDIR}/C/print/models/PSdefault/fonts/fonts.dir, ${XPCONFIGDIR}/C/print/models/PSdefault/fonts/9nb00051.pmf, ${XPCONFIGDIR}/C/print/models/PSdefault/fonts/9nb00093.pmf
+ The `model-config' file has attributes that describe the
+ printer model's capabilities and default settings.
+ Printer model fonts may also be present. The model-config
+ file also identifies the print ddx driver to be used.
+
+ For each printer model supported, a complete hierarchy of
+ files should exist. In most cases, these files do not
+ need to be modified.
+
- ${XPCONFIGDIR}/C/print/ddx-config/raster/pdf, ${XPCONFIGDIR}/C/print/ddx-config/raster/pcl, ${XPCONFIGDIR}/C/print/ddx-config/raster/postscript
+ The print ddx drivers can have highly specific
+ configuration files to control their behavior. In most
+ cases, these files do not need to be modified.
+
SEE ALSO
Xprint(7), X11(7), xplsprinters(1x), xprehashprinterlist(1x), xphelloworld(1x), xpxmhelloworld(1x), xpawhelloworld(1x), xpxthelloworld(1x), xpsimplehelloworld(1x), Xserver(1x), libXp(3x), libXprintUtils(3x), libXprintAppUtils(3x), XmPrintShell(3x), XawPrintShell(3x), Xprint FAQ (http://xprint.mozdev.org/docs/Xprint_FAQ.html), Xprint main site (http://xprint.mozdev.org/)