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)