unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



xfs(1X)								      xfs(1X)
X11R6									X11R6



NAME

  xfs, fs - X font server

SYNOPSIS

  xfs [-config configuration_file] [-port tcp_port]

OPTIONS

  -config configuration_file
      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	tcp_port
      Specifies	the TCP	port number on which the server	will listen for	con-
      nections.	The default port number	is 7100.

DESCRIPTION

  xfs is the X Window System font server.  It supplies fonts to	X Window Sys-
  tem 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:

  delete  Disables autostart of	the font server	by removing its	configuration
	  file.

  install Enables autostart of the font	server after each reboot by creating
	  a configuration file.

  start	  Starts the font server.

  stop	  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

  SIGTERM This causes the font server to exit cleanly.

  SIGUSR1 This signal is used to cause the server to re-read its configura-
	  tion 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	key-
  word is followed by an '=' and then the desired value.

  Recognized keywords include:

  cache-config
      The name of a configuration file that defines the	code sets and charac-
      ter 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.

  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 ser-
      vice.  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 do not specify.
      The default is 120.

  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. A resolution is a comma-separated
      pair of x	and y resolutions in pixels per	inch. Multiple resolutions
      are separated by commas.

  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.	 The default
      port number is 7100.

  use-syslog (boolean)
      Whether syslog(3)	on supported systems is	to be used for errors.

  renderers (list of string)
      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 con-
      struct the initialization	routine	name.  For either of the first two
      examples,	the string Type1 would have been extracted and used to con-
      struct 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.

  deferglyphs (string)
      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