Provided by: xprint_1.6.0-4_i386 bug

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)