source: x/installing/xinit.xml@ 8558044

<?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>
    <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;

    &lfs110a_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 -i '/$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>