source: postlfs/config/lsb-release.xml@ 13e5884

<?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">
  <!ENTITY lsb-release-download-http "&sourceforge-repo2;/projects/lsb/files/lsb_release/&lsb-release-version;/lsb-release-&lsb-release-version;.tar.gz">
  <!ENTITY lsb-release-download-ftp  " ">
  <!ENTITY lsb-release-md5sum        "30537ef5a01e0ca94b7b8eb6a36bb1e4">
  <!ENTITY lsb-release-size          "12 KB">
  <!ENTITY lsb-release-buildsize     "80 KB">
  <!ENTITY lsb-release-time          "less than 0.1 SBU">

  %general-entities;
]>

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

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

  <title>lsb_release-&lsb-release-version;</title>

  <indexterm zone="lsb-release">
    <primary sortas="a-lsb-release">lsb_release</primary>
  </indexterm>

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

    <para>The <application>lsb_release</application> script gives information
    about the Linux Standards Base (LSB) status of the distribution.</para>

    &lfs77_checked;

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

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

  </sect2>

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

    <para>First fix a minor display problem:</para>

<screen><userinput>sed -i "s|n/a|unavailable|" lsb_release</userinput></screen>

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

<screen><userinput>./help2man -N --include ./lsb_release.examples \
              --alt_version_key=program_version ./lsb_release > lsb_release.1</userinput></screen>

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

<screen role="root"><userinput>install -v -m 644 lsb_release.1 /usr/share/man/man1/lsb_release.1 &amp;&amp;
install -v -m 755 lsb_release /usr/bin/lsb_release</userinput></screen>

  </sect2>

  <sect2>
      <title>Configuration Information</title>

      <para>
        The configuration for this package was done in 
        <ulink url="&lfs-website;/lfs/view/stable/chapter09/theend.html">LFS</ulink>.  
        The file <filename>/etc/lsb-release</filename> should already exist.
        Be sure that the DISTRIB_CODENAME entry has been set properly.
      </para>

      <para>
        Add the current package version to <filename>/etc/lsb-release</filename>.
        As the <systemitem class="username">root</systemitem> user:
      </para>

<screen><userinput>echo 'LSB_VERSION="&lsb-release-version;"' >> /etc/lsb-release</userinput></screen>

  </sect2>

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

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

      <seglistitem>
        <seg>lsb_release</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="lsb_release-prog">
        <term><command>lsb_release</command></term>
        <listitem>
          <para>is a script to give LSB data.</para>
          <indexterm zone="lsb-release lsb_release-prog">
            <primary sortas="b-lsb-release">lsb_release</primary>
          </indexterm>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect2>

</sect1>