home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xfs.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.0 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XFS(1)                               XFS(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xfs - X font server
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxffss [-config _c_o_n_f_i_g_u_r_a_t_i_o_n___f_i_l_e] [-port _t_c_p___p_o_r_t]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _X_f_s is the X Window System font server.    It supplies fonts
  15.        to X Window System display servers.
  16.  
  17. SSTTAARRTTIINNGG TTHHEE SSEERRVVEERR
  18.        The server is usually run by a system  administrator,  and
  19.        started via boot files like _/_e_t_c_/_r_c_._l_o_c_a_l.  Users may also
  20.        wish to start private font servers for  specific     sets  of
  21.        fonts.
  22.  
  23. OOPPTTIIOONNSS
  24.        --ccoonnffiigg ccoonnffiigguurraattiioonn__ffiillee
  25.            Specifies  the  configuration file the font server
  26.            will use.
  27.  
  28.        --llss lliisstteenn--ssoocckkeett
  29.            Specifies a file descriptor which is  already  set
  30.            up  to  be used as the listen socket.  This option
  31.            is only intended to be used  by    the  font  server
  32.            itself when automatically spawning another copy of
  33.            itself to handle additional connections.
  34.  
  35.        --ppoorrtt ttccpp__ppoorrtt
  36.            Specifies the TCP port number on which the  server
  37.            will listen for connections.
  38.  
  39. SSIIGGNNAALLSS
  40.        _S_I_G_T_E_R_M This causes the font server to exit cleanly.
  41.  
  42.        _S_I_G_U_S_R_1 This signal is used to cause the server to re-read
  43.            its configuration file.
  44.  
  45.        _S_I_G_U_S_R_2 This signal is used to cause the server    to  flush
  46.            any cached data it may have.
  47.  
  48.        _S_I_G_H_U_P  This  signal is used to cause the server to reset,
  49.            closing all active connections and re-reading  the
  50.            configuration file.
  51.  
  52. CCOONNFFIIGGUURRAATTIIOONN
  53.        The  configuration language is a list of keyword and value
  54.        pairs.  Each keyword is followed by an '='  and    then  the
  55.        desired value.
  56.  
  57.        Recognized keywords include:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XFS(1)                               XFS(1)
  71.  
  72.  
  73.        catalogue (list of string)
  74.           Ordered  list  of     font path element names.  Use of
  75.           the keyword "catalogue" is very misleading at  pre-
  76.           sent,  the  current  implementation only supports a
  77.           single catalogue ("all"),     containing  all  of  the
  78.           specified fonts.
  79.  
  80.        alternate-servers (list of string)
  81.           List of alternate servers for this font server.
  82.  
  83.        client-limit (cardinal)
  84.           Number  of  clients  this     font server will support
  85.           before refusing service.    This is useful for tuning
  86.           the load on each individual font server.
  87.  
  88.        clone-self (boolean)
  89.           Whether  this  font  server should attempt to clone
  90.           itself when it reachs the client-limit.
  91.  
  92.        default-point-size (cardinal)
  93.           The default pointsize  (in  decipoints)  for  fonts
  94.           that don't specify.  The default is 120.
  95.  
  96.        default-resolutions (list of resolutions)
  97.           Resolutions  the    server supports by default.  This
  98.           information  may    be  used  as  a     hint  for   pre-
  99.           rendering,  and  substituted for scaled fonts which
  100.           do not specify a resolution.   A    resolution  is    a
  101.           comma-separated pair of x and y resolutions in pix-
  102.           els per inch.  Multiple resolutions  are    separated
  103.           by commas.
  104.  
  105.        error-file (string)
  106.           Filename    of  the     error    file.    All  warnings and
  107.           errors will be logged here.
  108.  
  109.        port (cardinal)
  110.           TCP port on which the server will listen    for  con-
  111.           nections.
  112.  
  113.        use-syslog (boolean)
  114.           Whether  syslog(3)  (on supported systems) is to be
  115.           used for errors.
  116.  
  117.        deferglyphs (string)
  118.           Set the mode for delayed fetching     and  caching  of
  119.           glyphs.    Value  is "none", meaning deferred glyphs
  120.           is disabled, "all", meaning it is enabled     for  all
  121.           fonts,  and  "16",  meaning  it is enabled only for
  122.           16-bits fonts.
  123.  
  124. EEXXAAMMPPLLEE
  125.        #
  126.        # sample font server configuration file
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XFS(1)                               XFS(1)
  137.  
  138.  
  139.        #
  140.  
  141.        # allow a max of 10 clients to connect to this font server
  142.        client-limit = 10
  143.  
  144.        # when a font server reaches its limit, start up a new one
  145.        clone-self = on
  146.  
  147.        # alternate font servers for clients to use
  148.        alternate-servers = hansen:7101,hansen:7102
  149.  
  150.        # where to look for fonts
  151.        # the first is a set of Speedo outlines, the second is a set of
  152.        # misc bitmaps and the last is a set of 100dpi bitmaps
  153.        #
  154.        catalogue = /usr/X11R6/lib/X11/fonts/speedo,
  155.         /usr/X11R6/lib/X11/fonts/misc,
  156.         /usr/X11R6/lib/X11/fonts/100dpi/
  157.  
  158.        # in 12 points, decipoints
  159.        default-point-size = 120
  160.  
  161.        # 100 x 100 and 75 x 75
  162.        default-resolutions = 100,100,75,75
  163.        use-syslog = off
  164.  
  165.  
  166. FFOONNTT SSEERRVVEERR NNAAMMEESS
  167.        One of the following forms can be  used    to  name  a  font
  168.        server that accepts TCP connections:
  169.  
  170.        tcp/_h_o_s_t_n_a_m_e:_p_o_r_t
  171.        tcp/_h_o_s_t_n_a_m_e:_p_o_r_t/_c_a_t_a_l_o_g_u_e_l_i_s_t
  172.  
  173.        The  _h_o_s_t_n_a_m_e  specifies     the  name  (or     decimal  numeric
  174.        address) of the machine on which the font server     is  run-
  175.        ning.   The _p_o_r_t is the decimal TCP port on which the font
  176.        server is listening for    connections.   The  _c_a_t_a_l_o_g_u_e_l_i_s_t
  177.        specifies a list of catalogue names, with '+' as a separa-
  178.        tor.
  179.  
  180.        Examples: _t_c_p_/_f_s_._x_._o_r_g_:_7_1_0_0, _t_c_p_/_1_8_._3_0_._0_._2_1_2_:_7_1_0_1_/_a_l_l.
  181.  
  182.        One of the following forms can be  used    to  name  a  font
  183.        server that accepts DECnet connections:
  184.  
  185.        decnet/_n_o_d_e_n_a_m_e::font$_o_b_j_n_a_m_e
  186.        decnet/_n_o_d_e_n_a_m_e::font$_o_b_j_n_a_m_e/_c_a_t_a_l_o_g_u_e_l_i_s_t
  187.  
  188.        The  _n_o_d_e_n_a_m_e  specifies     the  name  (or     decimal  numeric
  189.        address) of the machine on which the font server     is  run-
  190.        ning.   The  _o_b_j_n_a_m_e  is a normal, case-insensitive DECnet
  191.        object name.  The _c_a_t_a_l_o_g_u_e_l_i_s_t specifies a list of  cata-
  192.        logue names, with '+' as a separator.
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XFS(1)                               XFS(1)
  203.  
  204.  
  205.        Examples:     _D_E_C_n_e_t_/_S_R_V_N_O_D_:_:_F_O_N_T_$_D_E_F_A_U_L_T,         _d_e_c_-
  206.        _n_e_t_/_4_4_._7_0_:_:_f_o_n_t_$_s_p_e_c_i_a_l_/_s_y_m_b_o_l_s.
  207.  
  208. SSEEEE AALLSSOO
  209.        X(1), _T_h_e _X _F_o_n_t _S_e_r_v_i_c_e _P_r_o_t_o_c_o_l,
  210.        _F_o_n_t _s_e_r_v_e_r _i_m_p_l_e_m_e_n_t_a_t_i_o_n _o_v_e_r_v_i_e_w
  211.  
  212. BBUUGGSS
  213.        Multiple catalogues should be supported.
  214.  
  215. AAUUTTHHOORRSS
  216.        Dave Lemke, Network Computing Devices, Inc
  217.        Keith Packard, Massachusetts Institute of Technology
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.