chiark / gitweb /
headers: fix git URLs for source files
[elogind.git] / man / sd_readahead.xml
index 178f907afa95bde3b28d7a62953d7b4d94472a8f..4b8c9575d43a36874a80965861ac060f8754cd1f 100644 (file)
 
         <refnamediv>
                 <refname>sd_readahead</refname>
 
         <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>
                 <funcsynopsis>
         </refnamediv>
 
         <refsynopsisdiv>
                 <funcsynopsis>
-                        <funcsynopsisinfo>#include "sd-daemon.h"</funcsynopsisinfo>
+                        <funcsynopsisinfo>#include "sd-readahead.h"</funcsynopsisinfo>
 
                         <funcprototype>
                                 <funcdef>int <function>sd_readahead</function></funcdef>
 
                         <funcprototype>
                                 <funcdef>int <function>sd_readahead</function></funcdef>
@@ -62,7 +62,7 @@
                 <title>Description</title>
                 <para><function>sd_readahead()</function> may be
                 called by programs involved with early boot-up to
                 <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
                 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
                 <title>Notes</title>
 
                 <para>This function is provided by the reference
                 <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
 
                 <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:
                 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/plain/src/readahead/sd-readahead.c"/>
                 resp. <ulink
                 resp. <ulink
-                url="http://cgit.freedesktop.org/systemd/tree/src/sd-daemon.h"/></para>
+                url="http://cgit.freedesktop.org/systemd/plain/src/systemd/sd-readahead.h"/></para>
 
                 <para><function>sd_readahead()</function> is
                 implemented in the reference implementation's drop-in
 
                 <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
+                <filename>sd-readahead.c</filename> and
+                <filename>sd-readahead.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
                 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>
+                <citerefentry><refentrytitle>sd-readahead</refentrytitle><manvolnum>7</manvolnum></citerefentry></para>
 
                 <para>If -DDISABLE_SYSTEMD is set during compilation
                 this function will always return 0 and otherwise
 
                 <para>If -DDISABLE_SYSTEMD is set during compilation
                 this function will always return 0 and otherwise
@@ -170,7 +170,7 @@ sd_readahead("noreplay");</programlisting>
                 <title>See Also</title>
                 <para>
                         <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                 <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>
                         <citerefentry><refentrytitle>daemon</refentrytitle><manvolnum>7</manvolnum></citerefentry>
                 </para>
         </refsect1>