Name

Synopsis

Description

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

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:

export XPSERVERLIST=`/etc/init.d/xprint get_xpserverlist`

Options

: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

${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

Authors

Table of Contents

• Name
• Synopsis
• Description
• Usage
• Options
• Environment
• Files
• See Also
• Authors