source: BOOK/final-system/x86_64-64/bin86.xml@ 1acf708

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>
<sect1 id="ch-system-bin86" role="wrap">
  <?dbhtml filename="bin86.html"?>

  <title>Bin86-&bin86-version;</title>

  <indexterm zone="ch-system-bin86">
    <primary sortas="a-Bin86">Bin86</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Bin86 package contains an assembler and linker to produce
      16 or 32-bit 8086 machine code.</para>

    <segmentedlist>
      <segtitle>&dependencies;</segtitle>

      <seglistitem>
        <seg>Bash, Binutils, Coreutils, GCC, Glibc, Make
        </seg>
      </seglistitem>
    </segmentedlist>

  </sect2>


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

    <para os="a">We are building bin86 because it is required to
      compile lilo, and at the moment no other bootloader builds and runs
      on a pure64 system. If your machine has multiple systems (i.e. x86
      or multilib) you may prefer to use the bootloader from those
      systems, such as grub.</para>

    <para os="p1">This patch updates bin86 to compile on x86_64:</para>

<screen os="p2"><userinput>patch -Np1 -i ../&bin86-x86_64-patch;</userinput></screen>

    <para os="c">Compile the package:</para>

<screen os="d"><userinput>make</userinput></screen>

    <para os="e">Install the package:</para>

<screen os="f"><userinput>make PREFIX=/usr install</userinput></screen>

  </sect2>

  <sect2 id="contents-bin86" role="content">
    <title>Contents of Bin86</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>

      <seglistitem>
        <seg>as86, ld86, nm86, objdump86, size86</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="as86">
        <term><command>as86</command></term>
        <listitem>
          <para>An 8086 assembler</para>
          <indexterm zone="ch-system-bin86 as86">
            <primary sortas="b-as86">as86</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ld86">
        <term><command>ld86</command></term>
        <listitem>
          <para>A linker for the object files produced by as86</para>
          <indexterm zone="ch-system-bin86 ld86">
            <primary sortas="b-ld86">ld86</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="nm86">
        <term><command>nm86</command></term>
        <listitem>
          <para>Symbolic link to objdump86</para>
          <indexterm zone="ch-system-bin86 nm86">
            <primary sortas="b-nm86">nm86</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="objdump86">
        <term><command>objdump86</command></term>
        <listitem>
          <para>A utility to examine and report on the output from as86 and ld86</para>
          <indexterm zone="ch-system-bin86 objdump86">
            <primary sortas="b-objdump86">objdump86</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="size86">
        <term><command>size86</command></term>
        <listitem>
          <para>Symbolic link to objdump86</para>
          <indexterm zone="ch-system-bin86 size86">
            <primary sortas="b-size86">size86</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>