home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat1 / xinit.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.3 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XINIT(1)                         XINIT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        xinit - X Window System initializer
  9.  
  10. SSYYNNOOPPSSIISS
  11.        xxiinniitt  [     [ _c_l_i_e_n_t ] _o_p_t_i_o_n_s ] [ ---- [ _s_e_r_v_e_r ] [ _d_i_s_p_l_a_y ]
  12.        _o_p_t_i_o_n_s ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.        The _x_i_n_i_t program is used to start  the    X  Window  System
  16.        server  and  a first client program on systems that cannot
  17.        start X directly from _/_e_t_c_/_i_n_i_t or  in  environments  that
  18.        use  multiple  window  systems.     When  this  first client
  19.        exits, _x_i_n_i_t will kill the X server and then terminate.
  20.  
  21.        If no specific client program  is  given     on  the  command
  22.        line, _x_i_n_i_t will look for a file in the user's home direc-
  23.        tory called _._x_i_n_i_t_r_c to run as a shell script to start  up
  24.        client  programs.   If no such file exists, _x_i_n_i_t will use
  25.        the following as a default:
  26.  
  27.         xterm  -geometry  +1+1  -n    login  -display     :0
  28.  
  29.  
  30.        If no specific server program  is  given     on  the  command
  31.        line, _x_i_n_i_t will look for a file in the user's home direc-
  32.        tory called _._x_s_e_r_v_e_r_r_c to run as a shell script    to  start
  33.        up the server.  If no such file exists, _x_i_n_i_t will use the
  34.        following as a default:
  35.  
  36.         X  :0
  37.  
  38.        Note that this assumes that there is a program named _X  in
  39.        the  current  search  path.   However, servers are usually
  40.        named _X_d_i_s_p_l_a_y_t_y_p_e where _d_i_s_p_l_a_y_t_y_p_e is the type of graph-
  41.        ics  display  which  is    driven    by this server.     The site
  42.        administrator should, therefore, make a link to the appro-
  43.        priate  type  of     server on the machine, or create a shell
  44.        script that runs _x_i_n_i_t with the appropriate server.
  45.  
  46.        An important point is  that  programs  which  are  run  by
  47.        _._x_i_n_i_t_r_c     should     be  run in the background if they do not
  48.        exit right away, so that they don't prevent other programs
  49.        from  starting  up.   However, the last long-lived program
  50.        started (usually a window manager  or  terminal    emulator)
  51.        should  be left in the foreground so that the script won't
  52.        exit (which indicates that the user is done and that _x_i_n_i_t
  53.        should exit).
  54.  
  55.        An  alternate client and/or server may be specified on the
  56.        command line.  The desired client program  and  its  argu-
  57.        ments  should be given as the first command line arguments
  58.        to _x_i_n_i_t.  To specify a particular  server  command  line,
  59.        append a double dash (--) to the _x_i_n_i_t command line (after
  60.        any client and arguments) followed by the  desired  server
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XINIT(1)                         XINIT(1)
  71.  
  72.  
  73.        command.
  74.  
  75.        Both  the  client program name and the server program name
  76.        must begin with a slash (/) or a period    (.).   Otherwise,
  77.        they  are  treated as an arguments to be appended to their
  78.        respective startup lines.  This makes it possible  to  add
  79.        arguments  (for example, foreground and background colors)
  80.        without having to retype the whole command line.
  81.  
  82.        If an explicit server name is  not  given  and  the  first
  83.        argument     following  the     double dash (--) is a colon fol-
  84.        lowed by a digit, _x_i_n_i_t will use that number as    the  dis-
  85.        play  number instead of zero.  All remaining arguments are
  86.        appended to the server command line.
  87.  
  88.  
  89. EEXXAAMMPPLLEESS
  90.        Below are several examples of how command  line    arguments
  91.        in _x_i_n_i_t are used.
  92.  
  93.        xxiinniitt   This  will  start  up a server named _X and run the
  94.            user's _._x_i_n_i_t_r_c, if it exists, or  else    start  an
  95.            _x_t_e_r_m.
  96.  
  97.        xxiinniitt ---- //uussrr//XX1111RR66//bbiinn//XXqqddssss  ::11
  98.            This  is     how  one  could start a specific type of
  99.            server on an alternate display.
  100.  
  101.        xxiinniitt --ggeeoommeettrryy ==8800xx6655++1100++1100 --ffnn 88xx1133 --jj --ffgg wwhhiittee --bbgg
  102.            nnaavvyy
  103.            This  will  start  up  a     server named _X, and will
  104.            append the given arguments to  the  default  _x_t_e_r_m
  105.            command.     It will ignore _._x_i_n_i_t_r_c.
  106.  
  107.        xxiinniitt --ee wwiiddggeettss ---- ..//XXssuunn --ll --cc
  108.            This will use the command _._X_s_u_n _-_l _-_c to start the
  109.            server and will append the arguments _-_e _w_i_d_g_e_t_s to
  110.            the default _x_t_e_r_m command.
  111.  
  112.        xxiinniitt //uussrr//uuccbb//rrsshh ffaasstthhoosstt ccppuuppiigg --ddiissppllaayy wwss::11 ----  ::11 --aa
  113.            22 --tt 55
  114.            This will start a server named _X on display 1 with
  115.            the arguments _-_a _2 _-_t _5.     It  will  then     start    a
  116.            remote  shell  on the machine ffaasstthhoosstt in which it
  117.            will run the command _c_p_u_p_i_g, telling it to display
  118.            back on the local workstation.
  119.  
  120.        Below  is  a  sample _._x_i_n_i_t_r_c that starts a clock, several
  121.        terminals, and leaves the window manager     running  as  the
  122.        ``last''     application.    Assuming  that the window manager
  123.        has been configured properly, the user  then  chooses  the
  124.        ``Exit'' menu item to shut down X.
  125.  
  126.            xrdb -load $HOME/.Xresources
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XINIT(1)                         XINIT(1)
  137.  
  138.  
  139.            xsetroot -solid gray &
  140.            xclock -g 50x50-0+0 -bw 0 &
  141.            xload -g 50x50-50+0 -bw 0 &
  142.            xterm -g 80x24+0+0 &
  143.            xterm -g 80x24+0-0 &
  144.            twm
  145.  
  146.        Sites  that  want  to  create a common startup environment
  147.        could simply create a default _._x_i_n_i_t_r_c that  references    a
  148.        site-wide startup file:
  149.  
  150.            #!/bin/sh
  151.            . /usr/local/lib/site.xinitrc
  152.  
  153.        Another    approach  is  to write a script that starts _x_i_n_i_t
  154.        with a specific shell script.  Such  scripts  are  usually
  155.        named  _x_1_1,  _x_s_t_a_r_t, or _s_t_a_r_t_x and are a convenient way to
  156.        provide a simple interface for novice users:
  157.  
  158.            #!/bin/sh
  159.            xinit /usr/local/lib/site.xinitrc -- /usr/X11R6/bin/X bc
  160.  
  161.  
  162. EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS
  163.        DDIISSPPLLAAYY          This variable gets set to the name  of  the
  164.               display to which clients should connect.
  165.  
  166.        XXIINNIITTRRCC          This  variable  specifies an init file con-
  167.               taining shell commands to start up the ini-
  168.               tial  windows.  By default, _._x_i_n_i_t_r_c in the
  169.               home directory will be used.
  170.  
  171. FFIILLEESS
  172.        _._x_i_n_i_t_r_c          default client script
  173.  
  174.        _x_t_e_r_m          client to run if _._x_i_n_i_t_r_c does not exist
  175.  
  176.        _._x_s_e_r_v_e_r_r_c     default server script
  177.  
  178.        _X          server to run if _._x_s_e_r_v_e_r_r_c does not exist
  179.  
  180. SSEEEE AALLSSOO
  181.        _X(1), _s_t_a_r_t_x(1), _X_s_e_r_v_e_r(1), _x_t_e_r_m(1)
  182.  
  183. AAUUTTHHOORR
  184.        Bob Scheifler, MIT Laboratory for Computer Science
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.