FS(1)                       X Version 11(Release 5)                       FS(1)


NAME
      fs - X font server

SYNOPSIS
      fs [-config configuration_file] [-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 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.

OPTIONS
      -config configurationfile
              Specifies the configuration file the font server 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


10/89                                                                    Page 1

FS(1)                       X Version 11(Release 5)                       FS(1)


            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
            reachs 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,


Page 2                                                                    10/89

FS(1)                       X Version 11(Release 5)                       FS(1)


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

      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.

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


10/89                                                                    Page 3