source: general/graphlib/libexif.xml@ eede1a3

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

  <!-- Because the maintainer of libexif is releasing versions in a scheme such
       as this: libexif-0_6_22-release/libexif-0.6.22.tar.xz, let's keep the
       0_6_22 as a separate entity. -->
  <!ENTITY dl-version "0_6_22">

  <!ENTITY libexif-download-http "https://github.com/libexif/libexif/releases/download/libexif-&dl-version;-release/libexif-&libexif-version;.tar.xz">
  <!ENTITY libexif-download-ftp  " ">
  <!ENTITY libexif-md5sum        "1070601438443fdd5b8635565693cf99">
  <!ENTITY libexif-size          "1.3 MB">
  <!ENTITY libexif-buildsize     "21 MB">
  <!ENTITY libexif-time          "0.1 SBU">
]>

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

  <sect1info>
    <date>$Date$</date>
  </sect1info>

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

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

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

    <para>
      The <application>libexif</application> package contains a library for
      parsing, editing, and saving EXIF data. Most digital cameras produce
      EXIF files, which are JPEG files with extra tags that contain information
      about the image. All EXIF tags described in EXIF standard 2.1 are
      supported.
    </para>

    &lfs101_checked;

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

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>
          Required patch:
          <ulink url="&patch-root;/libexif-&libexif-version;-security_fixes-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Optional (to Build Documentation)</bridgehead>
    <para role="optional">
      <xref linkend="doxygen"/> and
      <xref linkend="graphviz"/>
    </para>

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

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


    <para>
      First, apply a patch to fix a security issue (integer overflow leading to
      Out Of Buffer write):
    </para>

<screen><userinput remap="pre">patch -Np1 -i ../libexif-&libexif-version;-security_fixes-1.patch</userinput></screen>


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

<screen><userinput>./configure --prefix=/usr    \
            --disable-static \
            --with-doc-dir=/usr/share/doc/libexif-&libexif-version; &amp;&amp;
make</userinput></screen>

    <para>
      To test the results, issue: <command>make check</command>.
    </para>

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

<screen role="root"><userinput>make install</userinput></screen>

    <para>
      Documentation was built and installed if you have the dependencies
      shown above installed. If you don't have the dependencies installed,
      there is a compressed tarball in the source tree
      <filename class="directory">doc</filename> directory that can be
      unpacked into /usr/share/doc/libexif-&libexif-version;.
    </para>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
      href="../../xincludes/static-libraries.xml"/>

  </sect2>

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

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

      <seglistitem>
        <seg>
          None
        </seg>
        <seg>
          libexif.so
        </seg>
        <seg>
          /usr/include/libexif and
          /usr/share/doc/libexif-&libexif-version;
        </seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="libexif-lib">
        <term><filename class="libraryfile">libexif.so</filename></term>
        <listitem>
          <para>
            contains functions used for parsing, editing, and saving
            EXIF data
          </para>
          <indexterm zone="libexif libexif-lib">
            <primary sortas="c-libexif">libexif.so</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>