Package: hdparm
Version: 6.3-3
Severity: wishlist
Tags: patch

Please apply the attached patch. It groups the variuos options of hdparm
into logical sections.

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.16jh
Locale: [EMAIL PROTECTED], [EMAIL PROTECTED] (charmap=ISO-8859-15)

Versions of packages hdparm depends on:
ii  libc6                         2.3.6-4    GNU C Library: Shared libraries an
ii  lsb-base                      3.0-16     Linux Standard Base 3.0 init scrip

hdparm recommends no packages.

-- no debconf information
--- hdparm.8.old        2006-03-31 20:06:32.319368250 +0200
+++ hdparm.8    2006-03-31 22:28:55.881307500 +0200
@@ -15,6 +15,157 @@
 When no flags are given,
 .I -acdgkmnru
 is assumed.
+
+.TP
+.SH Show information on hard disk
+
+.TP
+.I -C
+Check the current IDE power mode status, which will always be one of
+.B unknown
+(drive does not support this command),
+.B active/idle
+(normal operation),
+.B standby
+(low power mode, drive has spun down),
+or
+.B sleeping
+(lowest power mode, drive is completely shut down).
+The
+.B -S, -y, -Y,
+and
+.B -Z
+flags can be used to manipulate the IDE power modes.
+
+.TP
+.I -g
+Display the drive geometry (cylinders, heads, sectors),
+the size (in sectors) of the device,
+and the starting offset (in sectors) of the device from
+the beginning of the drive.
+.TP
+.I -i
+Display the identification info that was obtained from the drive at
+.I boot time,
+if available.
+This is a feature of modern IDE drives,
+and may not be supported by older devices.
+The data returned may or may not be current, depending on activity
+since booting the system.
+However, the current multiple sector mode count is always shown.
+For a more detailed interpretation of the identification info,
+refer to
+.I AT Attachment Interface for Disk Drives
+(ANSI ASC X3T9.2 working draft, revision 4a, April 19/93).
+
+.TP
+.I -I
+Request identification info directly from the drive,
+which is displayed in a new expanded format with considerably
+more detail than with the older
+.I -i
+flag.
+
+.TP
+.I -Istdin
+This is a special "no seatbelts" variation on the
+.B -I
+option,
+which accepts a drive identification block as standard input
+instead of using a /dev/hd* parameter.
+The format of this block must be
+.I exactly
+the same as that found in the /proc/ide/*/hd*/identify "files",
+or that produced by the
+.B -Istdout
+option described below.
+This variation is designed for use with collected "libraries" of drive
+identification information, and can also be used on ATAPI
+drives which may give media errors with the standard mechanism.
+.TP
+.I -Istdout
+This option simply dumps the identify data in hex to stdout,
+in a format similar to that from /proc/, and suitable for
+later use with the
+.I -Istdin
+option.
+
+
+.TP
+.I -v 
+Display all settings, except -i (same as -acdgkmnru for IDE, -gr for SCSI or
+-adgr for XT).  This is also the default behaviour when no flags are specified.
+
+
+
+
+.TP
+.SH Power/Noise settings
+.TP
+.I -A
+Disable/enable the IDE drive\'s read-lookahead feature (usually ON by default).
+Usage:
+.B -A0
+(disable) or
+.B -A1
+(enable).
+
+.TP
+.I -M
+Get/set Automatic Acoustic Management (AAM) setting. Most modern harddisk 
drives 
+have the ability to speed down the head movements to reduce their noise output.
+The possible values are between 0 and 254. 128 is the most quiet (and therefore
+slowest) setting and 254 the fastest (and loudest). Some drives have only two 
+levels (quiet / fast), while others may have different levels between 128 and 
254.
+At the moment, most drives only support 3 options, off, quiet, and fast.
+These have been assigned the values 0, 128, and 254 at present, respectively,
+but integer space has been incorporated for future expansion, should this 
change.
+
+.TP
+.I -S
+Set the standby (spindown) timeout for the drive.  This value is used
+by the drive to determine how long to wait (with no disk activity)
+before turning off the spindle motor to save power.  Under such
+circumstances, the drive may take as long as 30 seconds to respond to
+a subsequent disk access, though most drives are much quicker.  The
+encoding of the timeout value is somewhat peculiar.  A value of zero
+means "timeouts are disabled": the device will not automatically enter
+standby mode.  Values from 1 to 240 specify multiples of 5 seconds,
+yielding timeouts from 5 seconds to 20 minutes.  Values from 241 to
+251 specify from 1 to 11 units of 30 minutes, yielding timeouts from
+30 minutes to 5.5 hours.  A value of 252 signifies a timeout of 21
+minutes. A value of 253 sets a vendor-defined timeout period between 8
+and 12 hours, and the value 254 is reserved.  255 is interpreted as 21
+minutes plus 15 seconds.  Note that some older drives may have very
+different interpretations of these values.
+.TP
+.I -y
+Force an IDE drive to immediately enter the low power consumption
+.B standby
+mode, usually causing it to spin down.
+The current power mode status can be checked using the
+.B -C
+flag.
+.TP
+.I -Y
+Force an IDE drive to immediately enter the lowest power consumption
+.B sleep
+mode, causing it to shut down completely.  A hard or soft reset
+is required before the drive can be accessed again
+(the Linux IDE driver will automatically handle issuing a reset if/when 
needed).
+The current power mode status can be checked using the
+.B -C
+flag.
+.TP
+.I -Z
+Disable the automatic power-saving function of certain Seagate drives
+(ST3xxx models?), to prevent them from idling/spinning-down
+at inconvenient times.
+
+
+
+.TP
+.SH Modify Settings of hard disk
 .TP
 .I -a 
 Get/set sector count for filesystem read-ahead.  This is used to improve
@@ -27,14 +178,6 @@
 Also, many IDE drives also have a separate built-in read-ahead function,
 which alleviates the need for a filesystem read-ahead in many situations.
 .TP
-.I -A
-Disable/enable the IDE drive\'s read-lookahead feature (usually ON by default).
-Usage:
-.B -A0
-(disable) or
-.B -A1
-(enable).
-.TP
 .I -b
 Get/set bus state.
 .TP
@@ -61,23 +204,6 @@
 interface card only; all (E)IDE drives still have only a 16-bit connection
 over the ribbon cable from the interface card.
 .TP
-.I -C
-Check the current IDE power mode status, which will always be one of
-.B unknown
-(drive does not support this command),
-.B active/idle
-(normal operation),
-.B standby
-(low power mode, drive has spun down),
-or
-.B sleeping
-(lowest power mode, drive is completely shut down).
-The
-.B -S, -y, -Y,
-and
-.B -Z
-flags can be used to manipulate the IDE power modes.
-.TP
 .I -d
 Disable/enable the "using_dma" flag for this drive.  This option now works
 with most combinations of drives and PCI interfaces which support DMA
@@ -114,58 +240,6 @@
 .I -T
 timings.
 .TP
-.I -g
-Display the drive geometry (cylinders, heads, sectors),
-the size (in sectors) of the device,
-and the starting offset (in sectors) of the device from
-the beginning of the drive.
-.TP
-.I -h
-Display terse usage information (help).
-.TP
-.I -i
-Display the identification info that was obtained from the drive at
-.I boot time,
-if available.
-This is a feature of modern IDE drives,
-and may not be supported by older devices.
-The data returned may or may not be current, depending on activity
-since booting the system.
-However, the current multiple sector mode count is always shown.
-For a more detailed interpretation of the identification info,
-refer to
-.I AT Attachment Interface for Disk Drives
-(ANSI ASC X3T9.2 working draft, revision 4a, April 19/93).
-.TP
-.I -I
-Request identification info directly from the drive,
-which is displayed in a new expanded format with considerably
-more detail than with the older
-.I -i
-flag.
-.TP
-.I -Istdin
-This is a special "no seatbelts" variation on the
-.B -I
-option,
-which accepts a drive identification block as standard input
-instead of using a /dev/hd* parameter.
-The format of this block must be
-.I exactly
-the same as that found in the /proc/ide/*/hd*/identify "files",
-or that produced by the
-.B -Istdout
-option described below.
-This variation is designed for use with collected "libraries" of drive
-identification information, and can also be used on ATAPI
-drives which may give media errors with the standard mechanism.
-.TP
-.I -Istdout
-This option simply dumps the identify data in hex to stdout,
-in a format similar to that from /proc/, and suitable for
-later use with the
-.I -Istdin
-option.
 .TP
 .I -k
 Get/set the keep_settings_over_reset flag for the drive.
@@ -231,16 +305,6 @@
 Under rare circumstances, such failures can result in
 .B massive filesystem corruption.
 .TP
-.I -M
-Get/set Automatic Acoustic Management (AAM) setting. Most modern harddisk 
drives 
-have the ability to speed down the head movements to reduce their noise output.
-The possible values are between 0 and 254. 128 is the most quiet (and therefore
-slowest) setting and 254 the fastest (and loudest). Some drives have only two 
-levels (quiet / fast), while others may have different levels between 128 and 
254.
-At the moment, most drives only support 3 options, off, quiet, and fast.
-These have been assigned the values 0, 128, and 254 at present, respectively,
-but integer space has been incorporated for future expansion, should this 
change.
-.TP
 .I -n
 Get or set the "ignore write errors" flag in the driver.
 Do NOT play with this without grokking the driver source code first.
@@ -265,19 +329,6 @@
 Set the maximum sector count for the drive\'s internal prefetch mechanism.
 Not all drives support this feature.
 .TP
-.I -q
-Handle the next flag quietly, suppressing normal output.  This is useful
-for reducing screen clutter when running from system startup scripts.
-Not applicable to the
-.I -i
-or
-.I -v
-or
-.I -t
-or
-.I -T
-flags.
-.TP
 .I -Q
 Set tagged queue depth (1 or greater), or turn tagged queuing off (0).
 This only works with the newer 2.5.xx (or later) kernels, and only with
@@ -293,59 +344,6 @@
 .B -U
 option for more information.
 .TP
-.I -S
-Set the standby (spindown) timeout for the drive.  This value is used
-by the drive to determine how long to wait (with no disk activity)
-before turning off the spindle motor to save power.  Under such
-circumstances, the drive may take as long as 30 seconds to respond to
-a subsequent disk access, though most drives are much quicker.  The
-encoding of the timeout value is somewhat peculiar.  A value of zero
-means "timeouts are disabled": the device will not automatically enter
-standby mode.  Values from 1 to 240 specify multiples of 5 seconds,
-yielding timeouts from 5 seconds to 20 minutes.  Values from 241 to
-251 specify from 1 to 11 units of 30 minutes, yielding timeouts from
-30 minutes to 5.5 hours.  A value of 252 signifies a timeout of 21
-minutes. A value of 253 sets a vendor-defined timeout period between 8
-and 12 hours, and the value 254 is reserved.  255 is interpreted as 21
-minutes plus 15 seconds.  Note that some older drives may have very
-different interpretations of these values.
-.TP
-.I -T
-Perform timings of cache reads for benchmark and comparison purposes.
-For meaningful results, this operation should be repeated 2-3 times
-on an otherwise inactive system (no other active processes) with at
-least a couple of megabytes of free memory.  This displays the speed
-of reading directly from the Linux buffer cache without disk access.
-This measurement is essentially an indication of the throughput of the
-processor, cache, and memory of the system under test.
-If the
-.I -t
-flag is also specified, then a correction factor based on the outcome of
-.I -T
-will be incorporated into the result reported for the
-.I -t
-operation.
-.TP
-.I -t
-Perform timings of device reads for benchmark and comparison purposes.
-For meaningful results, this operation should be repeated 2-3 times on
-an otherwise inactive system (no other active processes) with at least a
-couple of megabytes of free memory.  This displays the speed of reading
-through the buffer cache to the disk without any prior caching of data.
-This measurement is an indication of how fast the drive can sustain
-sequential data reads under Linux, without any filesystem overhead.  To
-ensure accurate measurements, the buffer cache is flushed during the
-processing of
-.I -t
-using the BLKFLSBUF ioctl.
-If the
-.I -T
-flag is also specified, then a correction factor based on the outcome of
-.I -T
-will be incorporated into the result reported for the
-.I -t
-operation.
-.TP
 .I -u
 Get/set interrupt-unmask flag for the drive.  A setting of
 .B 1
@@ -384,15 +382,6 @@
 some user-donated scripts for hot-swapping on the UltraBay of a ThinkPad 600E.
 Use at your own risk.
 .TP
-.I -v 
-Display all settings, except -i (same as -acdgkmnru for IDE, -gr for SCSI or
--adgr for XT).  This is also the default behaviour when no flags are specified.
-.TP
-.I -w
-Perform a device reset (DANGEROUS).  Do NOT use this option.
-It exists for unlikely situations where a reboot might otherwise be
-required to get a confused drive back into a useable state.
-.TP
 .I -W
 Disable/enable the IDE drive\'s write-caching feature
 (default state is undeterminable; manufacturer/model specific).
@@ -436,33 +425,74 @@
 For multiword DMA, the value used is the desired DMA mode number
 plus 32.  for UltraDMA, the value is the desired UltraDMA mode number
 plus 64.
+
+
+
 .TP
-.I -y
-Force an IDE drive to immediately enter the low power consumption
-.B standby
-mode, usually causing it to spin down.
-The current power mode status can be checked using the
-.B -C
-flag.
+.SH Miscelleneous
 .TP
-.I -Y
-Force an IDE drive to immediately enter the lowest power consumption
-.B sleep
-mode, causing it to shut down completely.  A hard or soft reset
-is required before the drive can be accessed again
-(the Linux IDE driver will automatically handle issuing a reset if/when 
needed).
-The current power mode status can be checked using the
-.B -C
-flag.
+.I -h
+Display terse usage information (help).
+.TP
+.I -q
+Handle the next flag quietly, suppressing normal output.  This is useful
+for reducing screen clutter when running from system startup scripts.
+Not applicable to the
+.I -i
+or
+.I -v
+or
+.I -t
+or
+.I -T
+flags.
 .TP
 .I -z
 Force a kernel re-read of the partition table of the specified device(s).
 .TP
-.I -Z
-Disable the automatic power-saving function of certain Seagate drives
-(ST3xxx models?), to prevent them from idling/spinning-down
-at inconvenient times.
+.I -T
+Perform timings of cache reads for benchmark and comparison purposes.
+For meaningful results, this operation should be repeated 2-3 times
+on an otherwise inactive system (no other active processes) with at
+least a couple of megabytes of free memory.  This displays the speed
+of reading directly from the Linux buffer cache without disk access.
+This measurement is essentially an indication of the throughput of the
+processor, cache, and memory of the system under test.
+If the
+.I -t
+flag is also specified, then a correction factor based on the outcome of
+.I -T
+will be incorporated into the result reported for the
+.I -t
+operation.
+.TP
+.I -t
+Perform timings of device reads for benchmark and comparison purposes.
+For meaningful results, this operation should be repeated 2-3 times on
+an otherwise inactive system (no other active processes) with at least a
+couple of megabytes of free memory.  This displays the speed of reading
+through the buffer cache to the disk without any prior caching of data.
+This measurement is an indication of how fast the drive can sustain
+sequential data reads under Linux, without any filesystem overhead.  To
+ensure accurate measurements, the buffer cache is flushed during the
+processing of
+.I -t
+using the BLKFLSBUF ioctl.
+If the
+.I -T
+flag is also specified, then a correction factor based on the outcome of
+.I -T
+will be incorporated into the result reported for the
+.I -t
+operation.
+.TP
+.I -w
+Perform a device reset (DANGEROUS).  Do NOT use this option.
+It exists for unlikely situations where a reboot might otherwise be
+required to get a confused drive back into a useable state.
 .TP
+
+
 .SH ATA Security Feature Set
 .PP
 These switches are DANGEROUS to experiment with, and might not work with every

Reply via email to