LDP/LDP/guide/docbook/EVMSUG/appx-jfs.xml

147 lines
4.0 KiB
XML

<appendix id="jfsfsim"><title>JFS file system interface module</title>
<para>
The JFS FSIM lets EVMS users create and manage JFS file systems from
within the EVMS interfaces. In order to use the JFS FSIM, version 1.0.9 or
later of the JFS utilities must be installed on your system. The latest
version of JFS can be found at
<ulink url="http://oss.software.ibm.com/jfs/">http://oss.software.ibm.com/jfs/</ulink>.
</para>
<sect1 id="createjfsfsim"><title>Creating JFS file systems</title>
<para>
JFS file systems can be created with <command>mkfs</command> on any EVMS
or compatibility volume (at least 16 MB in size) that does not already
have a file system. The following options are available for creating
JFS file systems:</para>
<variablelist>
<varlistentry><term>badblocks</term>
<listitem>
<para>Perform a read-only check for bad blocks on the volume
before creating the file system. The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>caseinsensitive</term>
<listitem>
<para>Mark the file system as case-insensitive (for OS/2 compatibility).
The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>vollabel</term>
<listitem>
<para>Specify a volume label for the file system. The default is none.
</para>
</listitem>
</varlistentry>
<varlistentry><term>journalvol</term>
<listitem>
<para>Specify the volume to use for an external journal. This option
is only available with version 1.0.20 or later of the JFS utilities.
The default is none.
</para>
</listitem>
</varlistentry>
<varlistentry><term>logsize</term>
<listitem>
<para>
Specify the inline log size (in MB). This option is only available if
the journalvol option is not set. The default is 0.4% of the size of
the volume up to 32 MB.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="checkjfsfsim"><title>Checking JFS file systems</title>
<para>
The following options are available for checking JFS file systems with
<command>fsck</command>:
</para>
<variablelist>
<varlistentry><term>force</term>
<listitem>
<para>Force a complete file system check, even if the file system is
already marked clean. The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>readonly</term>
<listitem>
<para>Check the file system is in read-only mode. Report but do not
fix errors. If the file system is mounted, this option is
automatically selected. The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>omitlog</term>
<listitem>
<para>Omit replaying the transaction log. This option should only
be specified if the log is corrupt. The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>verbose</term>
<listitem>
<para>Display details and debugging information during the check.
The default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term>version</term>
<listitem>
<para>Display the version of <filename>fsck.jfs</filename> and exit without
checking the file system. The default is false.</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="removejfsfsim"><title>Removing JFS file systems</title>
<para>
A JFS file system can be removed from its volume if the file system is
unmounted. This operation involves erasing the superblock from the volume
so the file system will not be recognized in the future. There are no
options available for removing file systems.
</para>
</sect1>
<sect1 id="expandjfsfsim"><title>Expanding JFS file systems</title>
<para>
A JFS file system is automatically expanded when its volume is expanded.
However, JFS only allows the volume to be expanded if it is mounted,
because JFS performs all of its expansions online. In addition, JFS only
allows expansions if version 1.0.21 or later of the JFS utilities are
installed.
</para>
</sect1>
<sect1 id="shrinkjfsfsim"><title>Shrinking JFS file systems</title>
<para>
At this time, JFS does not support shrinking its file systems.
Hence, volumes with JFS file systems cannot be shrunk.
</para>
</sect1>
</appendix>