source: clfs-embedded/BOOK/beyond-clfs/common/dropbear.xml@ b327081

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

<sect1 id="ch-bclfs-dropbear" role="wrap">
  <?dbhtml filename="dropbear.html"?>

  <title>Dropbear-&dropbear-version;</title>

  <indexterm zone="ch-bclfs-dropbear">
    <primary sortas="a-Dropbear">Dropbear</primary>
  </indexterm>

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

    <para>Dropbear is a relatively small SSH 2 server and client. Dropbear has a small
     memory footprint suitable for memory-constrained environments, while still having
     the same features as OpenSSH. It does not depend on OpenSSL and it has a MIT
     style license. Optionally it can even be made smaller.
     </para>

  </sect2>

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

    <para os="p1">Dropbear doesn't accept our ${CLFS_TARGET} by default, so a patch is needed to make it recognise it:</para>

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

    <para os="p3">Dropbear incorrectly calls ld instead of gcc for linking, so fix it:</para>

    <screen os="p4"><userinput>cp Makefile.in{,.orig}
sed -e s/@LD@/@CC@/ Makefile.in.orig > Makefile.in</userinput></screen>

    <para os="a">Configure dropbear:</para>

<screen os="b"><userinput>CC="${CC} ${BUILD}" ./configure --prefix=/usr --host=${CLFS_TARGET}</userinput></screen>

    <para os="c">Now we will utilize /dev/urandom instead of /dev/random. To allow
    this to be utilized we use the following sed:</para>

<screen os="d"><userinput>cp -v options.h options.h.backup
sed -e "s@/dev/random@/dev/urandom@" options.h.backup > options.h</userinput></screen>

    <note os="e">
      <para>We are just telling dropbear to use the default configuration.
      For those for more adventureous, edit options.h to further configure dropbear.</para>
    </note>

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

<screen os="g"><userinput>make MULTI=1 PROGRAMS="dropbear dbclient dropbearkey dropbearconvert scp"</userinput></screen>

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

<screen os="i"><userinput>make MULTI=1 PROGRAMS="dropbear dbclient dropbearkey dropbearconvert scp" \
    install DESTDIR=${CLFS}
ln -svf ../../usr/bin/dropbearmulti ${CLFS}/usr/sbin/dropbear
ln -svf ../../usr/bin/dropbearmulti ${CLFS}/usr/bin/dbclient
ln -svf ../../usr/bin/dropbearmulti ${CLFS}/usr/bin/dropbearkey
ln -svf ../../usr/bin/dropbearmulti ${CLFS}/usr/bin/dropbearconvert
ln -svf ../../usr/bin/dropbearmulti ${CLFS}/usr/bin/scp</userinput></screen>

    <para os="j">Create the directory for the dropbear key files:</para>

<screen os="k"><userinput>install -dv ${CLFS}/etc/ssh</userinput></screen>

  </sect2>

  <sect2 id="contents-dropbear" role="content">
    <title>Contents of Dropbear</title>

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

      <seglistitem>
        <seg>To be Written</seg>
      </seglistitem>
    </segmentedlist>

  </sect2>

</sect1>