From d6bc8348d5be8576a475ac8ced2b0146e60fb71f Mon Sep 17 00:00:00 2001 From: Daniel Buch Date: Tue, 26 Aug 2014 21:17:22 +0200 Subject: readahead: wipe out readahead --- man/sd-daemon.xml | 1 - man/sd-login.xml | 1 - man/sd-readahead.xml | 117 ------------------ man/sd_readahead.xml | 178 --------------------------- man/systemd-notify.xml | 11 -- man/systemd-readahead-replay.service.xml | 203 ------------------------------- 6 files changed, 511 deletions(-) delete mode 100644 man/sd-readahead.xml delete mode 100644 man/sd_readahead.xml delete mode 100644 man/systemd-readahead-replay.service.xml (limited to 'man') diff --git a/man/sd-daemon.xml b/man/sd-daemon.xml index d78a1151c5..5f331e740a 100644 --- a/man/sd-daemon.xml +++ b/man/sd-daemon.xml @@ -140,7 +140,6 @@ systemd.service5, systemd.socket5, fprintf3, - sd-readahead3, pkg-config1 diff --git a/man/sd-login.xml b/man/sd-login.xml index d8d45048ed..f21170db16 100644 --- a/man/sd-login.xml +++ b/man/sd-login.xml @@ -131,7 +131,6 @@ sd_get_seats3, sd_login_monitor_new3, sd-daemon3, - sd-readahead3, pkg-config1 diff --git a/man/sd-readahead.xml b/man/sd-readahead.xml deleted file mode 100644 index bcc46b24d8..0000000000 --- a/man/sd-readahead.xml +++ /dev/null @@ -1,117 +0,0 @@ - - - - - - - - - sd-readahead - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - sd-readahead - 3 - - - - sd-readahead - Reference implementation of APIs for - controlling boot-time read-ahead - - - - - #include "sd-readahead.h" - - - - - Description - - sd-readahead.c and - sd-readahead.h provide a - reference implementation for APIs for controlling boot-time - read-ahead, as implemented by the read-ahead subsystem - of the - systemd1 - init system. - - See - sd_readahead3 - for more information about the function - implemented. - - - - Notes - - This interface is provided by the reference - implementation of APIs for controlling boot-time - read-ahead and distributed with the systemd - package. The algorithms it implements are simple, and - can easily be reimplemented in daemons if it is - important to support this interface without using the - reference implementation. See the respective function - man pages for details. - - In addition, for details about the algorithms, - check the liberally licensed reference implementation - sources: - - and - - These APIs are implemented in the reference - implementation's drop-in - sd-readahead.c and - sd-readahead.h files. It is - recommended that applications consuming these APIs copy - the implementation into their source tree, either - verbatim or in excerpts. These interfaces are - currently not available in a dynamic library. - - The functions provided by this interface become - NOPs when -DDISABLE_SYSTEMD is set during - compilation. In addition, if - sd-readhead.c is compiled on - non-Linux systems it becomes NOPs. - - - - See Also - - systemd1, - sd_readahead3, - sd-daemon3 - - - - diff --git a/man/sd_readahead.xml b/man/sd_readahead.xml deleted file mode 100644 index 98272997cb..0000000000 --- a/man/sd_readahead.xml +++ /dev/null @@ -1,178 +0,0 @@ - - - - - - - - - sd_readahead - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - sd_readahead - 3 - - - - sd_readahead - Control ongoing disk boot-time read-ahead operations - - - - - #include "sd-readahead.h" - - - int sd_readahead - const char *action - - - - - - Description - sd_readahead() may be - called by programs involved with early boot-up to - 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 - have the desired speed-up effect on the current or - future boot-ups. - - The action should be one - of the following strings: - - - - cancel - - Terminates read-ahead - data collection, and drops all - read-ahead data collected during this - boot-up. - - - - done - - Terminates read-ahead - data collection, but keeps all - read-ahead data collected during this - boot-up around for use during - subsequent boot-ups. - - - - noreplay - - Terminates read-ahead - replay. - - - - - - - - Return Value - - On failure, these calls return a negative - errno-style error code. It is generally recommended to - ignore the return value of this call. - - - - Notes - - This function is provided by the reference - 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. - - Internally, this function creates a file in - /run/systemd/readahead/ which is - then used as flag file to notify the read-ahead - subsystem. - - For details about the algorithm check the - liberally licensed reference implementation sources: - - and - - sd_readahead() is - implemented in the reference implementation's drop-in - sd-readahead.c and - sd-readahead.h files. It is - recommended that applications consuming this API copy - the implementation into their source tree. For more - details about the reference implementation, see - sd-readahead3 - - If -DDISABLE_SYSTEMD is set during compilation, - this function will always return 0 and otherwise - become a NOP. - - - - Examples - - - Cancelling all read-ahead operations - - During boots where SELinux has to - relabel the file system hierarchy, it will - create a large amount of disk accesses that - are not necessary during normal boots. Hence - it is a good idea to disable both read-ahead replay and read-ahead collection. - - - sd_readahead("cancel"); -sd_readahead("noreplay"); - - - - - - See Also - - systemd1, - sd-readahead3, - daemon7 - - - - diff --git a/man/systemd-notify.xml b/man/systemd-notify.xml index 69baae0dce..684f490099 100644 --- a/man/systemd-notify.xml +++ b/man/systemd-notify.xml @@ -141,17 +141,6 @@ sd_booted3. - - - - Controls disk - read-ahead operations. The argument - must be a string, and either "cancel", - "done" or "noreplay". For details - about the semantics of this option see - sd_readahead3. - - diff --git a/man/systemd-readahead-replay.service.xml b/man/systemd-readahead-replay.service.xml deleted file mode 100644 index 669fe78942..0000000000 --- a/man/systemd-readahead-replay.service.xml +++ /dev/null @@ -1,203 +0,0 @@ - - - - - - - - - systemd-readahead-replay.service - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - systemd-readahead-replay.service - 8 - - - - systemd-readahead-replay.service - systemd-readahead-collect.service - systemd-readahead-done.service - systemd-readahead-done.timer - systemd-readahead - Disk read ahead logic - - - - systemd-readahead-replay.service - systemd-readahead-collect.service - systemd-readahead-done.service - systemd-readahead-done.timer - - /usr/lib/systemd/systemd-readahead/systemd-readahead - OPTIONS - COMMAND - DIRECTORY | FILE - - - - - Description - - systemd-readahead-collect.service - is a service that collects disk usage patterns at boot - time. systemd-readahead-replay.service - is a service that replays this access data collected - at the subsequent boot. Since disks tend to be - magnitudes slower than RAM, this is intended to improve - boot speeds by pre-loading early at boot all data on - disk that is known to be read for the complete boot - process. - - systemd-readahead-done.service - is executed a short while after boot completed and signals - systemd-readahead-collect.service - to end data collection. On this signal, this service - will then sort the collected disk accesses and store - information about them in - /.readahead. - - Normally, both - systemd-readahead-collect.service - and - systemd-readahead-replay.service - are activated at boot so that access patterns from the - preceding boot are replayed and new data collected - for the subsequent boot. However, on read-only media - where the collected data cannot be stored, it might - be a good idea to disable - systemd-readahead-collect.service. - - On rotating media, when replaying disk accesses - at early boot, - systemd-readahead-replay.service - will order read requests by their location on disk. On - non-rotating media, they will be ordered by their - original access timestamp. If the file system supports - it, - systemd-readahead-collect.service - will also defragment and rearrange files on disk to - optimize subsequent boot times. - - - - Options - - systemd-readahead understands - the following options: - - - - - - Maximum number of - files to read ahead. Only valid - for thes collect - command. - - - - - - Maximum size of files - in bytes to read ahead. Only valid - for the collect - and replay - commands. - - - - - - Maximum time in microseconds - to spend collecting data. Only valid - for the collect - command. - - - - - - - - - - Commands - - The following commands are understood by - systemd-readahead: - - collect - [DIRECTORY] - - Collect read-ahead data on - early boot. When terminating, it will - write out a pack file to the indicated - directory containing the read-ahead - data. - - - - - replay - [DIRECTORY] - - Perform read-ahead on the - specified directory tree. - - - - - analyze - [FILE] - - Dumps the content of the - read-ahead pack file to the - terminal. For each file, the - output lists approximately how - much will be read ahead by - the replay - command. - - - - - - - - See Also - - systemd1 - - - - -- cgit v1.2.3-54-g00ecf