xfs(1X) 																   xfs(1X)

NAME

       xfs, fs - X font server

SYNOPSIS

       xfs [-config configuration_file] [-port tcp_port]

OPTIONS

       Specifies  the  configuration  file the font server will use.  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.	Specifies the TCP port number on which the server will listen for connections. The default port number is 7100.

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.

       On Tru64 UNIX systems, when the optional worldwide language-support subsets are installed, the /sbin/init.d/xfs script is available to cre-
       ate  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: Disables autostart of the font server by removing its configuration file.  Enables
       autostart of the font server after each reboot by creating a configuration file.  Starts the font server.  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.

SIGNALS

       This causes the font server to exit cleanly.  This signal is used to cause the server to re-read its configuration file.   This	signal	is
       used  to  cause the server to flush any cached data it may have.  This signal is used to cause the server to reset, closing all active con-
       nections 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: The name of a configuration file that defines the code sets and character 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 con-
       figuration 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.  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 spec-
       ified  fonts.   List  of  alternate servers for this font server.  Number of clients this font server will support before refusing service.
       This is useful for tuning the load on each individual font server.  Whether this font server should attempt to clone itself when it reaches
       the  client-limit.   The default pointsize (in decipoints) for fonts that do not specify.  The default is 120.  Resolutions the server sup-
       ports by default. This information may be used as a hint for pre-rendering, and substituted for scaled fonts which do not specify a resolu-
       tion.  A  resolution  is  a  comma-separated  pair of x and y resolutions in pixels per inch. Multiple resolutions are separated by commas.
       Filename of the error file.  All warnings and errors will be logged here.  TCP port on which the server will listen for	connections.   The
       default	port  number  is 7100.	Whether syslog(3) on supported systems is to be used for errors.  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 fol-
       lowing examples show three valid ways to format a renderers list entry:

		   libfr_Type1.so

		   /usr/shlib/X11/libfr_Type1.so

		   libfr_Type1.so;Type1RegisterFontFileFunctions

	      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 RegisterFontFileFunctions to construct the initialization  routine  name.
	      For  either of the first two examples, the string Type1 would have been extracted and used to construct the routine name Type1Regis-
	      terFontFileFunctions.

	      This initialization routine registers the font formats that it can render in exactly the same manner as the statically  linked  ren-
	      derers  in  the  X11R6  sample  implementation.	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

       #  dynamically loaded renderers renderers = libfr_Type1.so;Type1RegisterFontFileFunctions,      libfr_Speedo.so;SpeedoRegisterFontFileFunc-
       tions

FONT SERVER NAMES

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

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

       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 sepa-
       rator.

       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 accepts DECnet connections:

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

       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.

BUGS

       Multiple catalogues should be supported.

SEE ALSO

       X(1X), Font server implementation overview

AUTHORS

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

																	   xfs(1X)