FS(1) X11 R4.11MU05 FS(1)
NAME
fs - X font server
SYNOPSIS
fs [-config configurationfile] [-port tcpport]
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, someone with appropriate privilege will need to
add it. (See NOTE for information on appropriate privilege.)
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 will use.
The default file is /var/X11/fs/config.
-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. The default connection port for font
services is port 7000.
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.
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
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.
NOTE
On a generic DG/UX system, appropriate privilege is granted by having
an effective UID of 0 (root). See the appropriateprivilege(5) man
page for more information.
On a system with DG/UX information security, appropriate privilege is
granted by having one or more specific capabilities enabled in the
effective capability set of the user. See the capdefaults(5) man
page for more information.
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 NAMES
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)