source: general/prog/perl-modules/perl-file-fcntllock.xml@ fd67949

<?xml version="1.0" encoding="UTF-8"?>
<!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 my-download-http "&perl_authors;/id/J/JT/JTT/File-FcntlLock-0.22.tar.gz">
  <!ENTITY my-md5sum "579698d735d864ee403674f1175f789d">
]>

  <!-- Begin File::FcntlLock -->
  <sect2 id="perl-file-fcntllock" xreflabel="File-FcntlLock-&File-FcntlLock-version;">

    <title>File::FcntlLock-&File-FcntlLock-version;</title>

    <indexterm zone="perl-file-fcntllock">
      <primary sortas="a-File-FcntlLock">File::FcntlLock</primary>
    </indexterm>

    <sect3 role="package">
      <title>Introduction to File::FcntlLock</title>

      <para>
        File::FcntlLock is a module to do file locking in an object oriented
        fashion using the <ulink role='man'
        url='&man;fcntl.2'>fcntl(2)</ulink> system call. This allows locks
        on parts of a file as well as on the whole file and overcomes some
        known problems with
        <ulink role='man' url='&man;flock.2'>flock(2)</ulink>, on which
        which Perl's <function>flock()</function> function is based per
        default.
      </para>

      &lfs121_checked;

      <bridgehead renderas="sect4">Package Information</bridgehead>
      <itemizedlist spacing="compact">
        <listitem>
          <para>
            Download (HTTP): <ulink url="&my-download-http;"/>
          </para>
        </listitem>
        <listitem>
          <para>
            Download MD5 sum: &my-md5sum;
          </para>
        </listitem>
      </itemizedlist>
<!-- None that I can find.  bdubbs 11-17-23
      <bridgehead renderas="sect4">File::FcntlLock Dependencies</bridgehead>

      <bridgehead renderas="sect5">Recommended (required for the test suite)</bridgehead>
      <para role="recommended">
        <xref linkend="perl-test-warnings"/>
      </para>
-->
    </sect3>

    <sect3 role="installation">
      <title>Installation of File::FcntlLock</title>

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

    </sect3>

  </sect2>