source: general/sysutils/hdparm.xml@ 23460a6

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY hdparm-download-http "http://www.ibiblio.org/pub/Linux/system/hardware/hdparm-&hdparm-version;.tar.gz">
<!ENTITY hdparm-download-ftp " ">
<!ENTITY hdparm-md5sum "a4187336bc79a8538549e18540313ffd">
<!ENTITY hdparm-size "38 KB">
<!ENTITY hdparm-buildsize "404 KB">
<!ENTITY hdparm-time "0.01 SBU">
]>

<sect1 id="hdparm" xreflabel="hdparm-&hdparm-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="hdparm.html"?>
<title>hdparm-&hdparm-version;</title>
<indexterm zone="hdparm">
<primary sortas="a-Hdparm">Hdparm</primary>
</indexterm>

<sect2>
<title>Introduction to <application>hdparm</application></title>

<para>The <application>hdparm</application> package contains a utility that is 
useful for controlling <acronym>ATA</acronym>/<acronym>IDE</acronym> 
controllers and hard drives both to increase performance and sometimes to 
increase stability.</para>

<warning><para>As well as being useful, incorrect usage of
<application>hdparm</application> can destroy your information and in
rare cases, drives. Use with caution and make sure you know what you are
doing. If in doubt, we recommend you leave the default kernel parameters
alone.</para></warning>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): 
<ulink url="&hdparm-download-http;"/></para></listitem>
<listitem><para>Download (FTP): 
<ulink url="&hdparm-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: 
&hdparm-md5sum;</para></listitem>
<listitem><para>Download size: 
&hdparm-size;</para></listitem>
<listitem><para>Estimated disk space required: 
&hdparm-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&hdparm-time;</para></listitem></itemizedlist>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>hdparm</application></title>

<para>Build <application>hdparm</application> by running the following 
command:</para>

<screen><userinput><command>make</command></userinput></screen>

<para>As the root user, install <application>hdparm</application>:</para>

<screen><userinput role='root'><command>make install</command></userinput></screen>

<para>Note that by default, <command>hdparm</command> is installed in
<filename class="directory">/sbin</filename> as some systems may require it
during the boot process before <filename class="directory">/usr</filename>
is mounted.  If you wish to install <command>hdparm</command> under the
<filename class="directory">/usr</filename> hierarchy, then replace the above
command with the following:</para>

<screen><userinput role='root'><command>make binprefix=/usr install</command></userinput></screen>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>

<seglistitem>
<seg>hdparm</seg>
<seg>None</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="hdparm-prog">
<term><command>hdparm</command></term>
<listitem><para>provides a command-line interface to various hard disk ioctls 
supported by the stock Linux <acronym>ATA</acronym>/<acronym>IDE</acronym> 
device driver subsystem.</para>
<indexterm zone="hdparm hdparm-prog">
<primary sortas="b-hdparm">hdparm</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>