home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xserver.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  19.8 KB  |  595 lines
  1.  
  2.  
  3.  
  4. XSERVER(1)                           XSERVER(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        Xserver - X Window System display server
  9.  
  10. SSYYNNOOPPSSIISS
  11.        XX [option ...]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        _X  is  the  generic  name  for the X Window System display
  15.        server.    It is frequently a link or a copy of  the  appro-
  16.        priate  server binary for driving the most frequently used
  17.        server on a given machine.
  18.  
  19. SSTTAARRTTIINNGG TTHHEE SSEERRVVEERR
  20.        The X server is usually started from the X Display Manager
  21.        program    _x_d_m_(_1_).     This utility is run from the system boot
  22.        files and  takes     care  of  keeping  the     server     running,
  23.        prompting for usernames and passwords, and starting up the
  24.        user sessions.
  25.  
  26.        Installations that run more than     one  window  system  may
  27.        need to use the _x_i_n_i_t_(_1_) utility instead of _x_d_m.     However,
  28.        _x_i_n_i_t is to be considered  a  tool  for    building  startup
  29.        scripts    and  is     not intended for use by end users.  Site
  30.        administrators are ssttrroonnggllyy urged to  use  _x_d_m,    or  build
  31.        other interfaces for novice users.
  32.  
  33.        The  X  server  may  also be started directly by the user,
  34.        though this method is usually reserved for testing and  is
  35.        not  recommended for normal operation.  On some platforms,
  36.        the user must have  special  permission    to  start  the    X
  37.        server,    often  because    access    to  certain devices (e.g.
  38.        /dev/mouse) is restricted.
  39.  
  40.        When the X server starts up, it typically takes    over  the
  41.        display.      If  you are running on a workstation whose con-
  42.        sole is the display, you may not be able to log    into  the
  43.        console while the server is running.
  44.  
  45. OOPPTTIIOONNSS
  46.        All  of    the  X    servers accept the following command line
  47.        options:
  48.  
  49.        ::_d_i_s_p_l_a_y_n_u_m_b_e_r
  50.            the X server  runs  as  the  given  _d_i_s_p_l_a_y_n_u_m_b_e_r,
  51.            which  by default is 0.    If multiple X servers are
  52.            to run simultaneously on a host, each must have    a
  53.            unique display number.  See the DISPLAY NAMES sec-
  54.            tion of the _X_(_1_) manual page to learn how to spec-
  55.            ify  which  display  number  clients should try to
  56.            use.
  57.  
  58.        --aa _n_u_m_b_e_r
  59.            sets pointer acceleration (i.e. the ratio  of  how
  60.            much  is     reported  to  how much the user actually
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSERVER(1)                           XSERVER(1)
  71.  
  72.  
  73.            moved the pointer).
  74.  
  75.        --aacc     disables     host-based  access  control  mechanisms.
  76.            Enables    access    by any host, and permits any host
  77.            to modify  the  access  control    list.    Use  with
  78.            extreme caution.     This option exists primarily for
  79.            running test suites remotely.
  80.  
  81.        --aauuddiitt _l_e_v_e_l
  82.            Sets the audit trail level.  The default level  is
  83.            1,   meaning   only   connection      rejections  are
  84.            reported.  Level 2 additionally reports    all  suc-
  85.            cessful    connections  and  disconnects.     Level    0
  86.            turns off the audit trail.  Audit lines    are  sent
  87.            as standard error output.
  88.  
  89.        --aauutthh _a_u_t_h_o_r_i_z_a_t_i_o_n_-_f_i_l_e
  90.            Specifies  a  file  which contains a collection of
  91.            authorization records used to authenticate access.
  92.            See also the _x_d_m and _X_s_e_c_u_r_i_t_y manual pages.
  93.  
  94.        bbcc      disables     certain kinds of error checking, for bug
  95.            compatibility with  previous  releases  (e.g.,  to
  96.            work  around  bugs  in R2 and R3 xterms and toolk-
  97.            its).  Deprecated.
  98.  
  99.        --bbss     disables backing store support on all screens.
  100.  
  101.        --cc      turns off key-click.
  102.  
  103.        cc _v_o_l_u_m_e
  104.            sets key-click volume (allowable range: 0-100).
  105.  
  106.        --cccc _c_l_a_s_s
  107.            sets the visual class for the root window of color
  108.            screens.      The  class  numbers are as specified in
  109.            the X protocol.    Not obeyed by all servers.
  110.  
  111.        --ccoo _f_i_l_e_n_a_m_e
  112.            sets name of RGB color database.     The  default  is
  113.            <XRoot>/lib/X11/rgb,  where  <XRoot> refers to the
  114.            root of the X11 install tree.
  115.  
  116.        --ccoonnffiigg _f_i_l_e_n_a_m_e
  117.            reads more options from the given  file.      Options
  118.            in  the    file  may  be  separated  by  newlines if
  119.            desired.     If a '#' character appears  on     a  line,
  120.            all characters between it and the next newline are
  121.            ignored, providing a simple  commenting    facility.
  122.            The  --ccoonnffiigg option itself may appear in the file.
  123.  
  124.        --ccoorree   causes the server to generate a core dump on fatal
  125.            errors.
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSERVER(1)                           XSERVER(1)
  137.  
  138.  
  139.        --ddppii _r_e_s_o_l_u_t_i_o_n
  140.            sets  the  resolution  of  the screen, in dots per
  141.            inch.  To be used when the server cannot determine
  142.            the screen size from the hardware.
  143.  
  144.        --ddeeffeerrggllyypphhss _w_h_i_c_h_f_o_n_t_s
  145.            specifies  the types of fonts for which the server
  146.            should attempt  to  use    deferred  glyph     loading.
  147.            _w_h_i_c_h_f_o_n_t_s  can    be  all     (all  fonts),    none  (no
  148.            fonts), or 16 (16 bit fonts only).
  149.  
  150.        --ff _v_o_l_u_m_e
  151.            sets feep (bell) volume (allowable range:  0-100).
  152.  
  153.        --ffcc _c_u_r_s_o_r_F_o_n_t
  154.            sets default cursor font.
  155.  
  156.        --ffnn _f_o_n_t
  157.            sets the default font.
  158.  
  159.        --ffpp _f_o_n_t_P_a_t_h
  160.            sets  the  search  path for fonts.  This path is a
  161.            comma separated list of directories  which  the    X
  162.            server searches for font databases.
  163.  
  164.        --hheellpp   prints a usage message.
  165.  
  166.        --II      causes  all remaining command line arguments to be
  167.            ignored.
  168.  
  169.        --kkbb     disables the XKEYBOARD extension if present.
  170.  
  171.        --pp _m_i_n_u_t_e_s
  172.            sets screen-saver pattern cycle time in minutes.
  173.  
  174.        --ppnn     permits the server to continue running if it fails
  175.            to  establish  all of its well-known sockets (con-
  176.            nection points for clients),  but  establishes  at
  177.            least one.
  178.  
  179.        --rr      turns off auto-repeat.
  180.  
  181.        rr       turns on auto-repeat.
  182.  
  183.        --ss _m_i_n_u_t_e_s
  184.            sets screen-saver timeout time in minutes.
  185.  
  186.        --ssuu     disables save under support on all screens.
  187.  
  188.        --tt _n_u_m_b_e_r
  189.            sets  pointer  acceleration  threshold  in  pixels
  190.            (i.e. after how many pixels  pointer  acceleration
  191.            should take effect).
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XSERVER(1)                           XSERVER(1)
  203.  
  204.  
  205.        --tteerrmmiinnaattee
  206.            causes  the  server  to terminate at server reset,
  207.            instead of continuing to run.
  208.  
  209.        --ttoo _s_e_c_o_n_d_s
  210.            sets default connection timeout in seconds.
  211.  
  212.        --ttsstt    disables     all  testing  extensions  (e.g.,  XTEST,
  213.            XTrap, XTestExtension1).
  214.  
  215.        ttttyy_x_x   ignored, for servers started the ancient way (from
  216.            init).
  217.  
  218.        vv       sets video-off screen-saver preference.
  219.  
  220.        --vv      sets video-on screen-saver preference.
  221.  
  222.        --wwmm     forces the default backing-store of all windows to
  223.            be  WhenMapped.    This is a backdoor way of getting
  224.            backing-store to apply to all  windows.     Although
  225.            all  mapped  windows  will have backing store, the
  226.            backing store  attribute     value    reported  by  the
  227.            server  for a window will be the last value estab-
  228.            lished by a client.  If it has never been set by a
  229.            client,    the server will report the default value,
  230.            NotUseful.  This behavior is  required  by  the    X
  231.            protocol,  which     allows     the server to exceed the
  232.            client's backing store expectations but    does  not
  233.            provide    a way to tell the client that it is doing
  234.            so.
  235.  
  236.        --xx _e_x_t_e_n_s_i_o_n
  237.            loads the specified extension at init.  This is    a
  238.            no-op for most implementations.
  239.  
  240. SSEERRVVEERR DDEEPPEENNDDEENNTT OOPPTTIIOONNSS
  241.        Some X servers accept the following options:
  242.  
  243.        --lldd _k_i_l_o_b_y_t_e_s
  244.            sets  the  data    space  limit of the server to the
  245.            specified number of kilobytes.  A  value     of  zero
  246.            makes  the  data     size  as large as possible.  The
  247.            default value of -1 leaves the  data  space  limit
  248.            unchanged.
  249.  
  250.        --llff _f_i_l_e_s
  251.            sets  the number-of-open-files limit of the server
  252.            to the specified number.     A value  is  zero  makes
  253.            the limit as large as possible.    The default value
  254.            of -1 leaves the limit unchanged.
  255.  
  256.        --llss _k_i_l_o_b_y_t_e_s
  257.            sets the stack space limit of the  server  to  the
  258.            specified  number  of  kilobytes.  A value of zero
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. XSERVER(1)                           XSERVER(1)
  269.  
  270.  
  271.            makes the stack size as large  as  possible.   The
  272.            default    value  of -1 leaves the stack space limit
  273.            unchanged.
  274.  
  275.        --llooggoo   turns on the X Window System logo display  in  the
  276.            screen-saver.  There is currently no way to change
  277.            this from a client.
  278.  
  279.        nnoollooggoo  turns off the X Window System logo display in  the
  280.            screen-saver.  There is currently no way to change
  281.            this from a client.
  282.  
  283. XXDDMMCCPP OOPPTTIIOONNSS
  284.        X servers that support XDMCP have the  following     options.
  285.        See  the     _X _D_i_s_p_l_a_y _M_a_n_a_g_e_r _C_o_n_t_r_o_l _P_r_o_t_o_c_o_l specification
  286.        for more information.
  287.  
  288.        --qquueerryy _h_o_s_t_-_n_a_m_e
  289.            Enable XDMCP and send Query packets to the  speci-
  290.            fied host.
  291.  
  292.        --bbrrooaaddccaasstt
  293.            Enable  XDMCP and broadcast BroadcastQuery packets
  294.            to the network.    The first responding display man-
  295.            ager will be chosen for the session.
  296.  
  297.        --iinnddiirreecctt _h_o_s_t_-_n_a_m_e
  298.            Enable XDMCP and send IndirectQuery packets to the
  299.            specified host.
  300.  
  301.        --ppoorrtt _p_o_r_t_-_n_u_m
  302.            Use an alternate port number  for  XDMCP     packets.
  303.            Must be specified before any -query, -broadcast or
  304.            -indirect options.
  305.  
  306.        --ccllaassss _d_i_s_p_l_a_y_-_c_l_a_s_s
  307.            XDMCP has an additional display qualifier used  in
  308.            resource      lookup  for  display-specific     options.
  309.            This option sets that  value,  by  default  it  is
  310.            "MIT-Unspecified" (not a very useful value).
  311.  
  312.        --ccooookkiiee _x_d_m_-_a_u_t_h_-_b_i_t_s
  313.            When  testing  XDM-AUTHENTICATION-1, a private key
  314.            is shared between  the  server  and  the     manager.
  315.            This  option  sets  the value of that private data
  316.            (not that it is very private, being on the command
  317.            line!).
  318.  
  319.        --ddiissppllaayyIIDD _d_i_s_p_l_a_y_-_i_d
  320.            Yet  another XDMCP specific value, this one allows
  321.            the display manager to identify    each  display  so
  322.            that it can locate the shared key.
  323.  
  324.  
  325.  
  326.  
  327.  
  328. X Version 11           Release 6.1                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. XSERVER(1)                           XSERVER(1)
  335.  
  336.  
  337. XXKKEEYYBBOOAARRDD OOPPTTIIOONNSS
  338.        X  servers that support the XKEYBOARD extension accept the
  339.        following options:
  340.  
  341.        --xxkkbbddiirr _d_i_r_e_c_t_o_r_y
  342.            base directory for keyboard layout files
  343.  
  344.        --xxkkbbmmaapp _f_i_l_e_n_a_m_e
  345.            keyboard description to load on startup
  346.  
  347.        [[++--]]aacccceessssxx
  348.            enable(+) or disable(-) AccessX key sequences
  349.  
  350.        --aarr11 _m_i_l_l_i_s_e_c_o_n_d_s
  351.            sets the length of time in milliseconds that a key
  352.            must be depressed before autorepeat starts
  353.  
  354.        --aarr22 _m_i_l_l_i_s_e_c_o_n_d_s
  355.            sets  the  length  of  time  in    milliseconds that
  356.            should    elapse      between    autorepeat-generated
  357.            keystrokes
  358.  
  359.        Many   servers  also  have  device-specific  command  line
  360.        options.     See the manual pages for the individual  servers
  361.        for more details.
  362.  
  363. NNEETTWWOORRKK CCOONNNNEECCTTIIOONNSS
  364.        The  X  server supports client connections via a platform-
  365.        dependent subset of the following transport types:  TCPIP,
  366.        Unix Domain sockets, DECnet, and several varieties of SVR4
  367.        local connections.  See the DISPLAY NAMES section  of  the
  368.        _X_(_1_)  manual  page to learn how to specify which transport
  369.        type clients should try to use.
  370.  
  371. SSEECCUURRIITTYY
  372.        The X server implements a platform-dependent subset of the
  373.        following   authorization  protocols:  MIT-MAGIC-COOKIE-1,
  374.        XDM-AUTHORIZATION-1, SUN-DES-1, and  MIT-KERBEROS-5.   See
  375.        the _X_s_e_c_u_r_i_t_y_(_1_) manual page for information on the opera-
  376.        tion of these protocols.
  377.  
  378.        Authorization data required  by    the  above  protocols  is
  379.        passed  to  the    server    in  a private file named with the
  380.        --aauutthh command line option.  Each time the server is  about
  381.        to  accept the first connection after a reset (or when the
  382.        server is starting), it reads this  file.   If  this  file
  383.        contains     any authorization records, the local host is not
  384.        automatically allowed  access  to  the  server,    and  only
  385.        clients    which  send one of the authorization records con-
  386.        tained in the file in  the  connection  setup  information
  387.        will  be     allowed  access.   See the _X_a_u manual page for a
  388.        description of  the  binary  format  of    this  file.   See
  389.        _x_a_u_t_h_(_1_) for maintenance of this file, and distribution of
  390.        its contents to remote hosts.
  391.  
  392.  
  393.  
  394. X Version 11           Release 6.1                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. XSERVER(1)                           XSERVER(1)
  401.  
  402.  
  403.        The X server also uses a host-based  access  control  list
  404.        for  deciding  whether  or  not to accept connections from
  405.        clients on a particular machine.     If no    other  authoriza-
  406.        tion mechanism is being used, this list initially consists
  407.        of the host on which the server is running as well as  any
  408.        machines     listed in the file _/_e_t_c_/_Xnn_._h_o_s_t_s, where nn is the
  409.        display number of the  server.    Each  line  of    the  file
  410.        should    contain      either   an    Internet  hostname  (e.g.
  411.        expo.lcs.mit.edu) or a DECnet  hostname    in  double  colon
  412.        format  (e.g.  hydra::).      There     should     be no leading or
  413.        trailing spaces on any lines.  For example:
  414.  
  415.            joesworkstation
  416.            corporate.company.com
  417.            star::
  418.            bigcpu::
  419.  
  420.        Users can add or remove hosts from this list and enable or
  421.        disable    access    control     using the _x_h_o_s_t command from the
  422.        same machine as the server.
  423.  
  424.        The X protocol intrinsically does not have any  notion  of
  425.        window  operation permissions or place any restrictions on
  426.        what a client can do; if a program can connect to  a  dis-
  427.        play, it has full run of the screen.  Sites that have bet-
  428.        ter authentication and authorization systems might wish to
  429.        make  use  of the hooks in the libraries and the server to
  430.        provide additional security models.
  431.  
  432. SSIIGGNNAALLSS
  433.        The X server attaches special  meaning  to  the    following
  434.        signals:
  435.  
  436.        _S_I_G_H_U_P  This  signal causes the server to close all exist-
  437.            ing connections, free all resources,  and  restore
  438.            all  defaults.    It is sent by the display manager
  439.            whenever the main user's main application (usually
  440.            an  _x_t_e_r_m  or  window  manager) exits to force the
  441.            server to clean up and prepare for the next  user.
  442.  
  443.        _S_I_G_T_E_R_M This signal causes the server to exit cleanly.
  444.  
  445.        _S_I_G_U_S_R_1 This  signal is used quite differently from either
  446.            of the above.  When the server starts,  it  checks
  447.            to  see    if  it    has  inherited SIGUSR1 as SIG_IGN
  448.            instead of the usual SIG_DFL.  In this  case,  the
  449.            server sends a SIGUSR1 to its parent process after
  450.            it has set up the various connection schemes.  _X_d_m
  451.            uses  this feature to recognize when connecting to
  452.            the server is possible.
  453.  
  454. FFOONNTTSS
  455.        The X server can obtain fonts from directories and/or from
  456.        font  servers.    The  list of directories and font servers
  457.  
  458.  
  459.  
  460. X Version 11           Release 6.1                7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. XSERVER(1)                           XSERVER(1)
  467.  
  468.  
  469.        the X server uses when trying to open a font is controlled
  470.        by the _f_o_n_t _p_a_t_h.
  471.  
  472.        The  default  font  path     is "<XRoot>/lib/X11/fonts/misc/,
  473.        <XRoot>/lib/X11/fonts/Speedo/,
  474.        <XRoot>/lib/X11/fonts/Type1/,
  475.        <XRoot>/lib/X11/fonts/75dpi/,
  476.        <XRoot>/lib/X11/fonts/100dpi/  where <XRoot> refers to the
  477.        root of the X11 install tree.
  478.  
  479.        The font path can be set with the --ffpp option or by _x_s_e_t_(_1_)
  480.        after the server has started.
  481.  
  482. FFIILLEESS
  483.        /etc/Xnn.hosts             Initial  access control list
  484.                      for display number nn
  485.  
  486.        <XRoot>/lib/X11/fonts/misc,
  487.                      <XRoot>/lib/X11/fonts/75dpi,
  488.                      <XRoot>/lib/X11/fonts/100dpi
  489.                      Bitmap font directories
  490.  
  491.        <XRoot>/lib/X11/fonts/Speedo, <XRoot>/lib/X11/fonts/Type1
  492.                      Outline font directories
  493.  
  494.        <XRoot>/lib/X11/fonts/PEX     PEX font directories
  495.  
  496.        <XRoot>/lib/X11/rgb.txt         Color database
  497.  
  498.        /tmp/.X11-unix/Xnn         Unix domain socket for  dis-
  499.                      play number nn
  500.  
  501.        /tmp/rcXnn             Kerberos  5 replay cache for
  502.                      display number nn
  503.  
  504.        /usr/adm/Xnnmsgs             Error log file  for  display
  505.                      number nn if run from _i_n_i_t_(_8_)
  506.  
  507.        <XRoot>/lib/X11/xdm/xdm-errors
  508.                      Default error  log     file  if
  509.                      the   server   is    run  from
  510.                      _x_d_m_(_1_)
  511.  
  512.        Note: <XRoot> refers to the root of the X11 install  tree.
  513.  
  514. SSEEEE AALLSSOO
  515.        General information: X(1)
  516.  
  517.        Protocols:  _X  _W_i_n_d_o_w  _S_y_s_t_e_m _P_r_o_t_o_c_o_l_, _T_h_e _X _F_o_n_t _S_e_r_v_i_c_e
  518.        _P_r_o_t_o_c_o_l_, _X _D_i_s_p_l_a_y _M_a_n_a_g_e_r _C_o_n_t_r_o_l _P_r_o_t_o_c_o_l
  519.  
  520.        Fonts:  bdftopcf(1),  mkfontdir(1),  xfs(1),  xlsfonts(1),
  521.        xfontsel(1),  xfd(1),  _X     _L_o_g_i_c_a_l _F_o_n_t _D_e_s_c_r_i_p_t_i_o_n _C_o_n_v_e_n_-
  522.        _t_i_o_n_s
  523.  
  524.  
  525.  
  526. X Version 11           Release 6.1                8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. XSERVER(1)                           XSERVER(1)
  533.  
  534.  
  535.        Security: Xsecurity(1), xauth(1), Xau(1), xdm(1), xhost(1)
  536.  
  537.        Starting the server: xdm(1), xinit(1)
  538.  
  539.        Controlling the server once started: xset(1), xsetroot(1),
  540.        xhost(1)
  541.  
  542.        Server-specific man pages:  Xdec(1),  XmacII(1),     Xsun(1),
  543.        Xnest(1),     Xvfb(1),      XF86_Accel(1),    XF86_Mono(1),
  544.        XF86_SVGA(1), XF86_VGA16(1), XFree86(1)
  545.  
  546.        Server internal documentation: _D_e_f_i_n_i_t_i_o_n _o_f  _t_h_e  _P_o_r_t_i_n_g
  547.        _L_a_y_e_r  _f_o_r _t_h_e _X _v_1_1 _S_a_m_p_l_e _S_e_r_v_e_r_, _S_t_r_a_t_e_g_i_e_s _f_o_r _P_o_r_t_i_n_g
  548.        _t_h_e _X _v_1_1 _S_a_m_p_l_e _S_e_r_v_e_r_, _G_o_d_z_i_l_l_a_'_s _G_u_i_d_e _t_o _P_o_r_t_i_n_g _t_h_e _X
  549.        _V_1_1 _S_a_m_p_l_e _S_e_r_v_e_r
  550.  
  551. AAUUTTHHOORRSS
  552.        The  sample  server  was originally written by Susan Ange-
  553.        branndt, Raymond Drewry, Philip Karlton, and Todd  Newman,
  554.        from  Digital  Equipment     Corporation, with support from a
  555.        large cast.  It has since been  extensively  rewritten  by
  556.        Keith Packard and Bob Scheifler, from MIT.
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592. X Version 11           Release 6.1                9
  593.  
  594.  
  595.