Content-type: text/html Man page of xfs

xfs

Section: (1X)
Updated:
Index Return to Main Contents
 

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 create 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 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: 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 configuration 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. 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 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 .so, the text in between is prepended to the string 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 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", 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;SpeedoRegisterFontFileFunctions


 

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/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


 

Index

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
STARTING THE SERVER
SIGNALS
CONFIGURATION
EXAMPLE
FONT SERVER NAMES
BUGS
SEE ALSO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 02:42:59 GMT, October 02, 2010