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

FreeBSD Manual Pages

  
 
  

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

NAME
       xfs - X font server

SYNOPSIS
       xfs   [-config  configuration_file]  [-daemon]  [-droppriv]  [-ls  lis-
       ten_socket] [-nodaemon] [-port tcp_port]	[-user username]

DESCRIPTION
       Xfs is the X Window System font server.	It supplies fonts to X	Window
       System display servers.

STARTING THE SERVER
       The  server  is	usually	run by a system	administrator, and started via
       boot files like /etc/rc.local.  Users may also wish  to	start  private
       font servers for	specific sets of fonts.

OPTIONS
       -config configuration_file
	       Specifies  the configuration file the font server will use.  If
	       this  parameter	 is   not   specified,	 the   default	 file,
	       /usr/X11R6/lib/X11/fs/config will be used.

       -ls listen_socket
	       Specifies  a file descriptor which is already set up to be used
	       as the listen socket.  This option is only intended to be  used
	       by  the	font server itself when	automatically spawning another
	       copy of itself to handle	additional connections.

       -port tcp_port
	       Specifies the TCP port number on	which the server  will	listen
	       for connections.	 The default port number is 7100.

       -daemon Instructs  xfs to fork and go into the background automatically
	       at startup  If this option is not specified, xfs	will run as  a
	       regular process (unless xfs was built to	daemonize by default).

       -droppriv
	       If  specified,  xfs  will  attempt to run as user and group xfs
	       (unless the -user option	is used). This	has  been  implemented
	       for security reasons, as	xfs may	have undiscovered buffer over-
	       flows or	other paths for	possible exploit, both local  and  re-
	       mote.   With this option, you may also wish to specify "no-lis-
	       ten = tcp" in the config	file, which ensures that xfs will  not
	       to use a	TCP port at all.

       -nodaemon
	       When  xfs  is built to daemonize	(run in	the background)	by de-
	       fault, this prevents that  and  starts  xfs  up	as  a  regular
	       process.

       -user username
	       This  is	 equivalent  to	 -droppriv except that xfs will	run as
	       user username.

SIGNALS
       SIGTERM This causes the font server to exit cleanly.

       SIGUSR1 This signal is used to cause the	server to re-read its configu-
	       ration file.

       SIGUSR2 This  signal  is	 used  to cause	the server to flush any	cached
	       data it may have.

       SIGHUP  This signal is used to cause the	server to reset,  closing  all
	       active connections and re-reading the configuration file.

CONFIGURATION
       The  configuration language is a	list of	keyword	and value pairs.  Each
       keyword is followed by an '=' and then the desired value.

       Recognized keywords include:

       catalogue (list of string)
	      Ordered list of font path	element	names.	 Use  of  the  keyword
	      "catalogue" is very misleading at	present, the current implemen-
	      tation only supports a single catalogue ("all"), containing  all
	      of the specified fonts.

       alternate-servers (list of string)
	      List of alternate	servers	for this font server.

       client-limit (cardinal)
	      Number  of clients this font server will support before refusing
	      service.	This is	useful for tuning the load on each  individual
	      font server.

       clone-self (boolean)
	      Whether  this font server	should attempt to clone	itself when it
	      reachs the client-limit.

       default-point-size (cardinal)
	      The default pointsize (in	decipoints) for	fonts that don't spec-
	      ify.  The	default	is 120.

       default-resolutions (list of resolutions)
	      Resolutions  the	server	supports by default.  This information
	      may be used as a hint for	 pre-rendering,	 and  substituted  for
	      scaled fonts which do not	specify	a resolution.  A resolution is
	      a	comma-separated	pair of	x and  y  resolutions  in  pixels  per
	      inch.  Multiple resolutions are separated	by commas.

       error-file (string)
	      Filename	of  the	 error	file.  All warnings and	errors will be
	      logged here.

       no-listen (trans-type)
	      Disable a	transport  type. For example, TCP/IP  connections  can
	      be disabled with no-listen tcp

       port (cardinal)
	      TCP port on which	the server will	listen for connections.

       use-syslog (boolean)
	      Whether  syslog(3)  (on supported	systems) is to be used for er-
	      rors.

       deferglyphs (string)
	      Set the mode for delayed fetching	and caching of glyphs.	 Value
	      is  "none",  meaning deferred glyphs is disabled,	"all", meaning
	      it is enabled for	all fonts, and "16",  meaning  it  is  enabled
	      only for 16-bits fonts.

EXAMPLE
       #
       # sample	font server configuration file
       #

       # allow a max of	10 clients to connect to this font server
       client-limit = 10

       # when a	font server reaches its	limit, start up	a new one
       clone-self = on

       # alternate font	servers	for clients to use
       alternate-servers = hansen:7101,hansen:7102

       # where to look for fonts
       # the first is a	set of Speedo outlines,	the second is a	set of
       # misc bitmaps and the last is a	set of 100dpi bitmaps
       #
       catalogue = /usr/X11R6/lib/X11/fonts/speedo,
	    /usr/X11R6/lib/X11/fonts/misc,
	    /usr/X11R6/lib/X11/fonts/100dpi/

       # in 12 points, decipoints
       default-point-size = 120

       # 100 x 100 and 75 x 75
       default-resolutions = 100,100,75,75
       use-syslog = off

FONT SERVER NAMES
       One  of	the following forms can	be used	to name	a font server that ac-
       cepts TCP connections:

	   tcp/hostname:port
	   tcp/hostname:port/cataloguelist

       The hostname specifies the name (or decimal numeric address) of the ma-
       chine on	which the font server is running.  The port is the decimal TCP
       port on which the font server is	listening for connections.  The	 cata-
       loguelist specifies a list of catalogue names, with '+' as a separator.

       Examples: tcp/fs.x.org:7100, tcp/18.30.0.212:7101/all.

       One  of	the following forms can	be used	to name	a font server that ac-
       cepts DECnet connections:

	   decnet/nodename::font$objname
	   decnet/nodename::font$objname/cataloguelist

       The nodename specifies the name (or decimal numeric address) of the ma-
       chine  on  which	 the font server is running.  The objname is a normal,
       case-insensitive	DECnet object name.   The  cataloguelist  specifies  a
       list of catalogue names,	with '+' as a separator.

       Examples:  DECnet/SRVNOD::FONT$DEFAULT, decnet/44.70::font$special/sym-
       bols.

SEE ALSO
       X(7), The X Font	Service	Protocol,
       Font server implementation overview

BUGS
       Multiple	catalogues should be supported.

AUTHORS
       Dave Lemke, Network Computing Devices, Inc
       Keith Packard, Massachusetts Institute of Technology

XFree86				 Version 4.7.0				XFS(1)

NAME | SYNOPSIS | DESCRIPTION | STARTING THE SERVER | OPTIONS | SIGNALS | CONFIGURATION | EXAMPLE | FONT SERVER NAMES | SEE ALSO | BUGS | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xfs&sektion=1&manpath=XFree86+4.7.0>

home | help