disk-utils/elvtune.8

   1 .\" -*- nroff -*-
   2 .TH ELVTUNE 8 "14 March 2000" "Version 1.0"
   3 .SH NAME
   4 elvtune \- I/O elevator tuner
   5 .SH SYNOPSIS
   6 .B elvtune
   7 .RB [ \-r
   8 .IR r_lat ]
   9 .RB [ \-w
  10 .IR w_lat ]
  11 .RB [ \-b
  12 .IR b_max ]
  13 .IR device ...
  14 .br
  15 .B elvtune \-h
  16 .br
  17 .B elvtune \-v
  18 .SH DESCRIPTION
  19 .B elvtune
  20 allows to tune the I/O elevator per blockdevice queue basis. The
  21 tuning can be safely done at runtime. Tuning the elevator means
  22 being able to change disk performance and interactiveness. In the
  23 output of elvtune the address of the queue tuned will be shown
  24 and it can be considered as a queue ID.
  25 For example multiple partitions in the same harddisk will
  26 share the same queue and so tuning one partition will be
  27 like tuning the whole HD.
  28 .SH OPTIONS
  29 .TP
  30 .BI -r \ r_lat
  31 set the max latency that the I/O scheduler will provide on
  32 each read.
  33 .TP
  34 .BI -w \ w_lat
  35 set the max latency that the I/O scheduler will provide on
  36 each write.
  37 .TP
  38 .BI -b \ b_max
  39 max coalescing factor allowed on writes when there are reads
  40 pending in the queue.
  41 .TP
  42 .BI -h
  43 help.
  44 .TP
  45 .BI -v
  46 version.
  47 .SH NOTE
  48 Actually the only fields tunable are those relative
  49 to the IO scheduler. It's not possible to select
  50 a one-way or two-way elevator yet.
  51 .PP
  52 For logical blockdevices like LVM the tuning has to
  53 be done on the
  54 .I physical
  55 devices. Tuning the queue of the LVM logical device
  56 is useless.
  57 .SH RETURN VALUE
  58 0 on success and 1 on failure.
  59 .SH HISTORY
  60 Ioctls for tuning elevator behaviour were added in Linux 2.3.99-pre1.
  61 .SH AUTHORS
  62 Andrea Arcangeli <andrea@suse.de> SuSE
  63 .SH AVAILABILITY
  64 The elvtune command is part of the util-linux-ng package and is available from
  65 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.