X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsd_readahead.xml;h=88b135b7ecd4acc035e1d6863c677c7f148d42a6;hp=178f907afa95bde3b28d7a62953d7b4d94472a8f;hb=71e6c1cf47c35cc5a58cefaabe4f6848d6f09501;hpb=6624768c9c39ab409edebe07cb06ecd93cc6f3ed

diff --git a/man/sd_readahead.xml b/man/sd_readahead.xml
index 178f907af..88b135b7e 100644
--- a/man/sd_readahead.xml
+++ b/man/sd_readahead.xml
@@ -44,7 +44,7 @@
 
         <refnamediv>
                 <refname>sd_readahead</refname>
-                <refpurpose>Control ongoing disk read-ahead operations</refpurpose>
+                <refpurpose>Control ongoing disk boot-time read-ahead operations</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
@@ -62,7 +62,7 @@
                 <title>Description</title>
                 <para><function>sd_readahead()</function> may be
                 called by programs involved with early boot-up to
-                control ongoing disk read-ahead operations. It may be
+                control ongoing boot-time disk read-ahead operations. It may be
                 used to terminate read-ahead operations in case an
                 uncommon disk access pattern is to be expected and
                 hence read-ahead replay or collection is unlikely to
@@ -115,36 +115,42 @@
                 <title>Notes</title>
 
                 <para>This function is provided by the reference
-                implementation of APIs for new-style daemons and
-                distributed with the systemd package. The algorithm
-                it implements is simple, and can easily be
-                reimplemented in daemons if it is important to support
-                this interface without using the reference
-                implementation.</para>
+                implementation of APIs for controlling boot-time
+                read-ahead and distributed with the systemd
+                package. The algorithm it implements is simple, and
+                can easily be reimplemented in daemons if it is
+                important to support this interface without using the
+                reference implementation.</para>
 
                 <para>Internally, this function creates a file in
-                <filename>/dev/.systemd/readahead/</filename> which is
+                <filename>/run/systemd/readahead/</filename> which is
                 then used as flag file to notify the read-ahead
                 subsystem.</para>
 
                 <para>For details about the algorithm check the
                 liberally licensed reference implementation sources:
-                <ulink url="http://cgit.freedesktop.org/systemd/tree/src/sd-daemon.c"/>
+                <ulink url="http://cgit.freedesktop.org/systemd/tree/src/sd-readahead.c"/>
                 resp. <ulink
-                url="http://cgit.freedesktop.org/systemd/tree/src/sd-daemon.h"/></para>
+                url="http://cgit.freedesktop.org/systemd/tree/src/sd-readahead.h"/></para>
 
                 <para><function>sd_readahead()</function> is
-                implemented in the reference implementation's drop-in
-                <filename>sd-daemon.c</filename> and
-                <filename>sd-daemon.h</filename> files. It is
-                recommended that applications consuming this API copy
-                the implementation into their source tree. For more
-                details about the reference implementation see
-                <citerefentry><refentrytitle>sd_daemon</refentrytitle><manvolnum>7</manvolnum></citerefentry></para>
-
-                <para>If -DDISABLE_SYSTEMD is set during compilation
-                this function will always return 0 and otherwise
-                become a NOP.</para>
+                implemented in the reference implementation's
+                <filename>sd-readahead.c</filename> and
+                <filename>sd-readahead.h</filename> files. These
+                interfaces are available as shared library, which can
+                be compiled and linked to with the
+                <literal>libsystemd-daemon</literal>
+                <citerefentry><refentrytitle>pkg-config</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                file. Alternatively, applications consuming this API
+                may copy the implementation into their source
+                tree. For more details about the reference
+                implementation see
+                <citerefentry><refentrytitle>sd-readahead</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
+
+                <para>If the reference implementation is used as
+                drop-in files and -DDISABLE_SYSTEMD is set during
+                compilation this function will always return 0 and
+                otherwise become a NOP.</para>
         </refsect1>
 
         <refsect1>
@@ -170,7 +176,7 @@ sd_readahead("noreplay");</programlisting>
                 <title>See Also</title>
                 <para>
                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
-                        <citerefentry><refentrytitle>sd_daemon</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
+                        <citerefentry><refentrytitle>sd-readahead</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
                         <citerefentry><refentrytitle>daemon</refentrytitle><manvolnum>7</manvolnum></citerefentry>
                 </para>
         </refsect1>