source: x/installing/xinit.xml@ f58cd213

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY xinit-download-http "&xorg-download-http;/app/xinit-&xinit-version;.tar.bz2">
  <!ENTITY xinit-download-ftp  "&xorg-download-ftp;/app/xinit-&xinit-version;.tar.bz2">
  <!ENTITY xinit-md5sum        "6d506ab2efc17a08e87778654e099d37">
  <!ENTITY xinit-size          "178 KB">
  <!ENTITY xinit-buildsize     "1.5 MB">
  <!ENTITY xinit-time          "less than 0.1 SBU">
]>

<sect1 id="xinit" xreflabel="xinit-&xinit-version;">
  <?dbhtml filename="xinit.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>xinit-&xinit-version;</title>

  <indexterm zone="xinit">
    <primary sortas="a-xinit">xinit</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to xinit</title>

    <para>The <application>xinit</application> package contains a usable script
    to start the xserver.</para>

    &not-katamari;

    &lfs90_checked;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <ulink url="&xinit-download-http;"/></para>
      </listitem>
      <listitem>
        <para>Download (FTP): <ulink url="&xinit-download-ftp;"/></para>
      </listitem>
      <listitem>
        <para>Download MD5 sum: &xinit-md5sum;</para>
      </listitem>
      <listitem>
        <para>Download size: &xinit-size;</para>
      </listitem>
      <listitem>
        <para>Estimated disk space required: &xinit-buildsize;</para>
      </listitem>
      <listitem>
        <para>Estimated build time: &xinit-time;</para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">xinit Dependencies</bridgehead>

    <bridgehead renderas="sect4">Required</bridgehead>
    <para role="required">
      <xref linkend="xorg7-lib"/>
    </para>

    <bridgehead renderas="sect4">Recommended (runtime only)</bridgehead>
    <para role="recommended">
      <xref role="runtime" linkend="twm"/>, 
      <xref role="runtime" linkend="xclock"/>, and
      <xref role="runtime" linkend="xterm2"/> (used in the default <filename>
      xinitrc</filename> file)
    </para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/xinit"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of xinit</title>

    <para>Install <application>xinit</application> by running the
    following commands:</para>

<screen><userinput>./configure $XORG_CONFIG --with-xinitdir=/etc/X11/app-defaults &amp;&amp;
make</userinput></screen>

    <para>This package does not come with a test suite.</para>

    <para>Now, as the <systemitem class="username">root</systemitem>
    user:</para>

<screen role="root"><userinput>make install &amp;&amp;
ldconfig</userinput></screen>

    <note revision='sysv'>

      <para>If starting Xorg from the command line, the default instructions
      above starts Xorg on the current virtual terminal.  It may be convenient
      to see Xorg and associated application messages on the current virtual
      terminal, normally tty1, and start the graphical environment on the first
      available unused virtual terminal, normally tty7.  To do this, set the suid bit
      on the Xorg application as the  <systemitem
      class="username">root</systemitem> user:</para>
     
<screen role="nodump"><userinput>chmod u+s $XORG_PREFIX/libexec/Xorg</userinput></screen>

      <para>At this point you can start Xorg on virtual terminal 7 with 
      <command>startx &lt;client arguments&gt; -- vt7</command>.  Now
      you can toggle between tty1 and tty7 with the Ctrl-Alt-F1 and 
      Ctrl-Alt-F7 key combinations.</para>
      
      <para>To automatically start Xorg on the first available virtual terminal,
      modify the <command>startx</command> script as the  <systemitem
      class="username">root</systemitem> user with:</para>
      
<screen role="nodump"><userinput>sed -e '/$serverargs $vtarg/ s/serverargs/: #&amp;/' $XORG_PREFIX/bin/startx</userinput></screen>

      <para>After this change, the virtual terminal does not need to be 
      specified on the startx command line.</para>

    </note>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>xinit and startx</seg>
        <seg>None</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="startx">
        <term><command>startx</command></term>
        <listitem>
          <para>initializes an X session.</para>
          <indexterm zone="xinit startx">
            <primary sortas="b-startx">startx</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="xinit-bin">
        <term><command>xinit</command></term>
        <listitem>
          <para>is the X Window System initializer.</para>
          <indexterm zone="xinit xinit">
            <primary sortas="b-xinit">xinit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>
  </sect2>

</sect1>