Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Apropos / Subsearch:
optional field

xfs(1X)								      xfs(1X)
X11R6									X11R6


  xfs, fs - X font server


  xfs [-config configuration_file] [-port tcp_port]


  -config configuration_file
      Specifies	the configuration file the font	server will use.

  -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	con-
      nections.	The default port number	is 7100.


  xfs is the X Window System font server.  It supplies fonts to	X Window Sys-
  tem display servers.


  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.

  On Tru64 UNIX	systems, when the optional worldwide language-support subsets
  are installed, the /sbin/init.d/xfs script is	available to create and
  delete configuration file information	for xfs	or to manually start and stop
  the server. The script command line has the following	syntax:

  /sbin/init.d/xfs operation

  The operation	argument is one	of the following keywords:

  delete  Disables autostart of	the font server	by removing its	configuration

  install Enables autostart of the font	server after each reboot by creating
	  a configuration file.

  start	  Starts the font server.

  stop	  Stops	the font server.

  The /sbin/init.d/xfs script is provided mainly for use with the wwpsof
  print	filter,	which uses the X font server to	access bitmap fonts that the
  filter converts to PostScript	encoding. See wwpsof(8)	for more information
  about	this print filter.


  SIGTERM This causes the font server to exit cleanly.

  SIGUSR1 This signal is used to cause the server to re-read its configura-
	  tion 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.


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

  Recognized keywords include:

      The name of a configuration file that defines the	code sets and charac-
      ter associations for glyph caching when the font server is reading
      fonts from another font server.  The default cache-config	file is
      /usr/var/X11/fs/fs_cache_config.	If this	configuration file is defined
      or if the	default	fs_cache_config	file exists, glyph caching will	be
      enabled when the font server is reading from a font server for those
      fonts whose code sets are	specified in the file.

  catalogue (list of string)
      Ordered list of font path	element	names. Use of the keyword "catalogue"
      is very misleading at present, the current implementation	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 ser-
      vice.  This is useful for	tuning the load	on each	individual font

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

  default-point-size (cardinal)
      The default pointsize (in	decipoints) for	fonts that do not specify.
      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

  port (cardinal)
      TCP port on which	the server will	listen for connections.	 The default
      port number is 7100.

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

  renderers (list of string)
      A	list of	font renderer libraries.  Each entry is	a library name that
      can optionally be	followed by a semi-colon (;) and the name of the
      library's	initialization routine.	 The following examples	show three
      valid ways to format a renderers list entry:




      If the initialization routine is not specified, an attempt is made to
      construct	the routine name from the library name.	 If the	name of	the
      library begins with the string libfr_ and	ends with .so, the text	in
      between is prepended to the string RegisterFontFileFunctions to con-
      struct the initialization	routine	name.  For either of the first two
      examples,	the string Type1 would have been extracted and used to con-
      struct the routine name Type1RegisterFontFileFunctions.

      This initialization routine registers the	font formats that it can
      render in	exactly	the same manner	as the statically linked renderers in
      the X11R6	sample implementation.

  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


       # 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,

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

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

       # dynamically loaded renderers
       renderers = libfr_Type1.so;Type1RegisterFontFileFunctions,


  One of the following forms can be used to name a font	server that accepts
  TCP connections:


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

  Examples: tcp/fs.x.org:7100, tcp/

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


  The nodename specifies the name (or decimal numeric address) of the machine
  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/symbols.


  Multiple catalogues should be	supported.


  X(1X), Font server implementation overview


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