Xprt

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: +

export XPSERVERLIST=`/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. +

AUTHORS

+ This manual page was written by + Drew Parsons <dparsons@debian.org> and + Roland Mainz <roland.mainz@nrubsig.org>, + with some help from the man page at + http://www.sins.com.au/unix/manpages/Xprt.html and the XFree86 + man page for Xserver(1). +

Name