xfs(1X)xfs(1X)NAME
xfs, fs - X font server
SYNOPSISxfs [-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.
DESCRIPTIONxfs 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 connec‐
tions 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 configu‐
ration 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 specified 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 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. Multi‐
ple 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 following 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 rou‐
tine 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. Set the mode for
delayed fetching and caching of glyphs. Value is "none", mean‐
ing 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 bit‐
maps # 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;Type1Regis‐
terFontFileFunctions, 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$obj‐
name/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/sym‐
bols.
BUGS
Multiple catalogues should be supported.
SEE ALSOX(1X), Font server implementation overview
AUTHORS
Dave Lemke, Network Computing Devices, Inc
Keith Packard, Massachusetts Institute of Technology
xfs(1X)