source: general/sysutils/hdparm.xml@ 52d29f7

<?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-size "33 KB">
<!ENTITY hdparm-buildsize "257 KB">
<!ENTITY hdparm-time "0.01 SBU">

]>

<sect1 id="hdparm" xreflabel="hdparm-&hdparm-version;">
<?dbhtml filename="hdparm.html"?>
<title>hdparm-&hdparm-version;</title>

<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 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>
                                                                               
<sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/hdparm-&hdparm-version;-glibc_CVS-1.patch"/></para></listitem>
</itemizedlist></sect3>
                                                                               
</sect2>

<sect2>
<title>Installation of <application>hdparm</application></title>
                                                                               
<para>First apply the required patch:</para>
                                                                               
<screen><userinput><command>patch -Np1 -i ../hdparm-&hdparm-version;-glibc_CVS-1.patch</command></userinput></screen>
                                                                               
<para>Install <application>hdparm</application> by running the following commands:</para>
                                                                               
<screen><userinput><command>make &amp;&amp;
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
commands with the following:</para>
                                                                               
<screen><userinput><command>make &amp;&amp;
make binprefix=/usr install</command></userinput></screen>
                                                                               
</sect2>

<sect2>
<title>Contents</title>
                                                                               
<para>The <application>hdparm</application> package contains <command>hdparm</command>.</para>
                                                                               
</sect2>
                                                                               
<sect2><title>Description</title>
                                                                               
<sect3><title>hdparm</title>
<para><command>hdparm</command> 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></sect3>
                                                                               
</sect2>

</sect1>