Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
Xprt(1)			    General Commands Manual		       Xprt(1)

NAME
       Xprt - Print server for X Version 11

SYNOPSIS
       Xprt [-ac] [-audit level] [-pn] [-fp fontpath] [-XpFile file] [-Xp-
	    SpoolerType	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 de-
       vices 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  dis-
	      plays)  typically	 runs  on display :0. If /etc/init.d/xprint is
	      used to invoke Xprt, it may be configured	to  automatically  as-
	      sign 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 mes-
	      sages from the SECURITY extension, if present, including genera-
	      tion and revocation of authorizations and	violations of the  se-
	      curity  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 de-
       scribed 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/Xprint-
       ers
	      `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 auto-
	      matically	supplement the list of printers.

       ${XPCONFIGDIR}/${LANG}/print/attributes/printer,		      ${XPCON-
       FIGDIR}/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 lp-
	      stat(1)  in the Xprinters	file, setting up defaults in `printer'
	      becomes all the more important.

       ${XPCONFIGDIR}/${LANG}/print/attributes/document,	      ${XPCON-
       FIGDIR}/C/print/attributes/document
	      The  `document'  file  specifies the initial document values for
	      any print	jobs. For example, which paper tray to use,  what  de-
	      fault resolution,	etc.

       ${XPCONFIGDIR}/${LANG}/print/attributes/job, ${XPCONFIGDIR}/C/print/at-
       tributes/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,	      ${XPCON-
       FIGDIR}/C/print/models/PSdefault/fonts/fonts.dir,	      ${XPCON-
       FIGDIR}/C/print/models/PSdefault/fonts/9nb00051.pmf,	      ${XPCON-
       FIGDIR}/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,		      ${XPCON-
       FIGDIR}/C/print/ddx-config/raster/pcl,  ${XPCONFIGDIR}/C/print/ddx-con-
       fig/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),	xphel-
       loworld(1),  xpxmhelloworld(1),	xpawhelloworld(1),  xpxthelloworld(1),
       xpsimplehelloworld(1),  Xserver(1),  libXp(3), libXprintUtils(3), libX-
       printAppUtils(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)

NAME | SYNOPSIS | DESCRIPTION | USAGE | OPTIONS | ENVIRONMENT | FILES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Xprt&sektion=1&manpath=FreeBSD+5.4-RELEASE+and+Ports>

home | help