source: postlfs/filesystems/reiser.xml@ 0290a023

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE chapter 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 reiser-download-http "http://ftp.namesys.com/pub/reiserfsprogs/reiserfsprogs-&reiser-version;.tar.gz">
  <!ENTITY reiser-download-ftp "ftp://ftp.namesys.com/pub/reiserfsprogs/reiserfsprogs-&reiser-version;.tar.gz">
  <!ENTITY reiser-size "400 KB">
  <!ENTITY reiser-buildsize "5.8 MB">
  <!ENTITY reiser-time "0.16 SBU">
]>

<sect1 id="reiserfs" xreflabel="ReiserFS-&reiser-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="reiserfs.html"?>
<title>ReiserFS-&reiser-version;</title>

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

<para>The <application>ReiserFS</application> package contains various 
utilities for use with the Reiser file system.</para>

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

</sect2>

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

<para>Install <application>ReiserFS</application> by running the following 
commands:</para>

<screen><userinput><command>./configure --prefix=/usr --sbindir=/sbin &amp;&amp;
make &amp;&amp;
make install &amp;&amp;
ln -sf reiserfsck /sbin/fsck.reiserfs &amp;&amp;
ln -sf mkreiserfs /sbin/mkfs.reiserfs</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><parameter>--prefix=/usr</parameter>: This ensures that
the manual pages are installed in the correct location while still
installing the programs in <filename class="directory">/sbin</filename> as they should
be.</para>

<para><parameter>--sbindir=/sbin</parameter>: This ensures that the
<application>ReiserFS</application> 
utilities are installed in <filename class="directory">/sbin</filename> as they should be.</para>

</sect2>

<sect2>
<title>Contents</title>

<para><application>ReiserFS</application> contains <command>debugreiserfs</command>,
<command>mkreiserfs</command>, <command>reiserfsck</command>,
<command>resize_reiserfs</command> and 
<command>unpack</command>.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>debugreiserfs</title>

<para><command>debugreiserfs</command> can sometimes help to solve problems
with <application>ReiserFS</application> file systems.  If it is called without
options, it prints the super block of any reiserfs file system found on the
device.</para></sect3>

<sect3><title>mkreiserfs</title>
<para><command>mkreiserfs</command> creates a
<application>ReiserFS</application> file system.</para>
</sect3>

<sect3><title>reiserfsck</title>
<para><command>reiserfsck</command> checks a
<application>ReiserFS</application> file system.</para>
</sect3>

<sect3><title>reiserfstune</title>
<para><command>reiserfstune</command> is used for tuning the
<application>ReiserFS</application> journal.  
<emphasis>WARNING</emphasis>: Don't use this utility without first reading the 
man page thoroughly.</para></sect3>

<sect3><title>resize_reiserfs</title>
<para><command>resize_reiserfs</command> is used to resize an unmounted 
<application>ReiserFS</application> file system.</para></sect3>

<sect3><title>unpack</title>
<para>The <command>unpack</command> utility can be used to dump
<application>ReiserFS</application> 
file system information to files for debugging, much like
<command>debugreiserfs</command>.
</para></sect3>

</sect2>

</sect1>