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, scalable, 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(1)). 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 alternate 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, separated 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(1), xprehashprinterlist(1),
xphelloworld(1), xpxmhelloworld(1), xpawhelloworld(1),
xpxthelloworld(1), xpsimplehelloworld(1), Xserver(1), libXp(3),
libXprintUtils(3), libXprintAppUtils(3), XmPrintShell(3),
XawPrintShell(3), Xprint FAQ
(http://xprint.mozdev.org/docs/Xprint_FAQ.html), Xprint main site
(http://xprint.mozdev.org/)
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).
25 November 2004 Xprt(1)