FS(1) X Version 11 (Release 5) FS(1)
NAME
fs - X font server
SYNOPSIS
fs [-config configuration_file] [-port tcp_port]
DESCRIPTION
Fs is the X Window System font server. It supplies fonts to
X Window System display servers.
STARTING THE SERVER
The server is usually invoked from a system initialization
file. There are several available and it is up to the site
administrator to determine the best location. Among the
possible start up files are: /etc/inittab or the
/etc/init.d/* directory. Users may also wish to start
private font servers for specific sets of fonts.
/etc/inittab
If a line similar to the following does not exist in
/etc/inittab, you will need to become super-user to
add it.
fs:34:once:/usr/bin/X11/fs
This will start /usr/bin/X11/fs when run level (init
level) 3 or 4 is reached. "once" means that the font
server will not automatically be restarted after an
abnormal termination.
/etc/init.d/* Directory
Some sites may prefer to place the invocation of the
font server in /etc/init.d/<scriptfile>. Where
<scriptfile> is the name of the RC (Run Command)
script that contains the server invocation. To
follow the above example, links would have to be
created from /etc/rc3.d/ and /etc/rc4.d/ to
/etc/init.d/<scriptfile>. A sample script could
contain:
#
# initialization script for the X11 font server
#
/usr/bin/X11/fs
The system management guides have more precise information
on system utility initialization methods.
OPTIONS
-config configurationfile
Specifies the configuration file the font server
Licensed material--property of copyright holder(s) Page 1
FS(1) X Version 11 (Release 5) FS(1)
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 tcpport
Specifies the TCP port number on which the server
will listen for connections.
SIGNALS
SIGTERM This causes the font server to exit cleanly.
SIGUSR1 This signal is used to cause the server to re-read
its configuration 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 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 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 reaches the client-limit.
Licensed material--property of copyright holder(s) Page 2
FS(1) X Version 11 (Release 5) FS(1)
default-point-size (cardinal)
The default pointsize (in decipoints) for fonts that
don't specify.
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.
error-file (string)
Filename of the error file. All warnings and errors
will be logged here.
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 errors.
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:7001,hansen:7002
# 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/lib/fonts/speedo,
/usr/lib/X11/ncd/fonts/misc,
/usr/lib/X11/ncd/fonts/100dpi/
# in 12 points, decipoints
default-point-size = 120
# 100 x 100 and 75 x 75
default-resolutions = 100,100,75,75
FONT SERVER NAMES
Licensed material--property of copyright holder(s) Page 3
FS(1) X Version 11 (Release 5) FS(1)
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 separator.
Examples: tcp/expo.lcs.mit.edu:7000,
tcp/18.30.0.212:7001/all.
FILES
/usr/lib/X11/fs/config
Default font server configuration file. See OPTIONS
above.
/usr/lib/X11/fs/fs-errors
Default font server error file. See CONFIGURATION
above.
SEE ALSO
X(1), Font server implementation overview
BUGS
Multiple catalogues should be supported.
COPYRIGHT
Copyright 1991, Network Computing Devices, Inc Copyright
1991, Massachusetts Institute of Technology
See X(1) for a full statement of rights and permissions.
AUTHORS
Dave Lemke, Network Computing Devices, Inc
Keith Packard, Massachusetts Institute of Technology
Licensed material--property of copyright holder(s) Page 4