Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 132816 - Sparc 'fstab' example does not match partition map
Summary: Sparc 'fstab' example does not match partition map
Status: RESOLVED WONTFIX
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: Sparc All
: Low normal (vote)
Assignee: Docs Team
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-05-09 13:14 UTC by Brooks
Modified: 2006-08-22 16:39 UTC (History)
2 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1 (bugfix-handbook-sparc.xml?part=1&chap=10#doc_chap3,1.05 KB, patch)
2006-05-31 05:07 UTC, Peter Weller (RETIRED)
Details | Diff
Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=10#doc_chap3 (bugfix-handbook-sparc.xml?part=1&chap=10#doc_chap3,1.05 KB, patch)
2006-05-31 05:08 UTC, Peter Weller (RETIRED)
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Brooks 2006-05-09 13:14:01 UTC
The 'fstab' example given at http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1 appears to be a literal cut and paste from the x86 version of the handbook rather than melding with the partition map that was described earlier in the Sparc handbook (http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=4#doc_chap3). 

Namely, the "/boot" partition is not created in the Sparc setup, and the "/usr", "/var", and "/home" partitions are created in fdisk, but not given in the fstab example.

See my comments (MidnightLightning) in the forum at http://forums.gentoo.org/viewtopic-p-3306753.html#3306753 for my analysis of what the fstab should be.

Additionally, the same partition mismatches are found at the very end of the Sparc handbook: the partitions listed in the "umount" command at http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=10#doc_chap3 should match those laid out by the "mount" commands at http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=4#doc_chap5.
Comment 1 Peter Weller (RETIRED) gentoo-dev 2006-05-31 05:07:33 UTC
Created attachment 87973 [details, diff]
Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1
Comment 2 Peter Weller (RETIRED) gentoo-dev 2006-05-31 05:08:39 UTC
Created attachment 87975 [details, diff]
Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=10#doc_chap3
Comment 3 Peter Weller (RETIRED) gentoo-dev 2006-05-31 05:11:16 UTC
Comment on attachment 87973 [details, diff]
Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1

Sorry - attached the wrong file - here's the proper file:





<a name="doc_chap1"></a><p class="chaphead"><span class="chapnum">8.a. </span>Filesystem Information</p>
<a name="doc_chap1_sect1"></a><p class="secthead">What is fstab?</p>

<p>
Under Linux, all partitions used by the system must be listed in
<span class="path">/etc/fstab</span>. This file contains the mountpoints of those partitions
(where they are seen in the file system structure), how they should be mounted
and with what special options (automatically or not, whether users can mount
them or not, etc.)
</p>

<a name="doc_chap1_sect2"></a><p class="secthead">Creating /etc/fstab</p>

<p>
<span class="path">/etc/fstab</span> uses a special syntax. Every line consists of six
fields, separated by whitespace (space(s), tabs or a mixture). Each field has
its own meaning:
</p>

<ul>

<li>
  The first field shows the <b>partition</b> described (the path to the device
  file)
</li>
<li>
  The second field shows the <b>mountpoint</b> at which the partition should be
  mounted
</li>
<li>
  The third field shows the <b>filesystem</b> used by the partition

</li>
<li>
  The fourth field shows the <b>mountoptions</b> used by <span class="code">mount</span> when it
  wants to mount the partition. As every filesystem has its own mountoptions,
  you are encouraged to read the mount man page (<span class="code">man mount</span>) for a full
  listing. Multiple mountoptions are comma-separated.
</li>
<li>
  The fifth field is used by <span class="code">dump</span> to determine if the partition needs to
  be <b>dump</b>ed or not. You can generally leave this as <span class="code">0</span> (zero).

</li>
<li>
  The sixth field is used by <span class="code">fsck</span> to determine the order in which
  filesystems should be <b>check</b>ed if the system wasn't shut down properly.
  The root filesystem should have <span class="code">1</span> while the rest should have <span class="code">2</span>
  (or <span class="code">0</span> if a filesystem check isn't necessary).

</li>
</ul>

<p>
The default <span class="path">/etc/fstab</span> file provided by Gentoo <span class="emphasis">is not a valid
fstab file</span>, so start <span class="code">nano</span> (or your favorite editor) to create your
<span class="path">/etc/fstab</span>:
</p>

<a name="doc_chap_pre1"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 1: Opening /etc/fstab</p></td></tr>
<tr><td bgcolor="#eeeeff"><pre>
# <span class="code-input">nano -w /etc/fstab</span>
</pre></td></tr>
</table>

<p>
Let us take a look at how we write down the options for the <span class="path">/boot</span>
partition. This is just an example, so if the path to your <span class="path">/</span> partition is different, don't copy it verbatim.

</p>

<p>
In our default sparc partitioning example <span class="path">/</span> is the
<span class="path">/dev/sda1</span> partition, with <span class="code">ext2</span> as filesystem.
It needs to be checked during boot, so we would write down:
</p>

<a name="doc_chap_pre2"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 2: An example /boot line for /etc/fstab</p></td></tr>

<tr><td bgcolor="#eeeeff"><pre>
/dev/sda1               /               ext2    defaults                        0 0
</pre></td></tr>
</table>

<p>
Now, to improve performance, most users would want to add the <span class="code">noatime</span>
option as mountoption, which results in a faster system since access times
aren't registered (you don't need those generally anyway):
</p>

<a name="doc_chap_pre3"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 3: An improved /boot line for /etc/fstab</p></td></tr>
<tr><td bgcolor="#eeeeff"><pre>
/dev/sda1               /               ext2    defaults,noatime                0 0
</pre></td></tr>
</table>

<p>
If we continue with this, we would end up with the following lines (for

<span class="path">/</span>, <span class="path">/usr</span>, <span class="path">/var</span>, <span class="path">/home</span> and
the swap partition):
</p>

<a name="doc_chap_pre4"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 4: Three /etc/fstab lines</p></td></tr>
<tr><td bgcolor="#eeeeff"><pre>
/dev/sda1               /               ext2    defaults,noatime                0 0
/dev/sda2               none            swap    sw                              0 0
/dev/sda4               /usr            ext3    defaults,noatime                0 0
/dev/sda5               /var            ext3    defaults,noatime                0 0
/dev/sda6               /home           ext3    defaults,noatime                0 0
</pre></td></tr>
</table>

<p>
To finish up, you should add a rule for <span class="path">/proc</span>, <span class="code">tmpfs</span>

(required) and for your CD-ROM drive (and of course, if you have other
partitions or drives, for those too):
</p>

<a name="doc_chap_pre5"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 5: A full /etc/fstab example</p></td></tr>
<tr><td bgcolor="#eeeeff"><pre>
/dev/sda1               /               ext2    defaults,noatime                0 0
/dev/sda2               none            swap    sw                              0 2
/dev/sda4               /usr            ext3    defaults,noatime                0 0
/dev/sda5               /var            ext3    defaults,noatime                0 0
/dev/sda6               /home           ext3    defaults,noatime                0 0

none                    /proc           proc    defaults                        0 0
none                    /dev/shm        tmpfs   nodev,nosuid,noexec             0 0

/dev/cdroms/cdrom0      /mnt/cdrom      auto    noauto,user                     0 0
</pre></td></tr>
</table>

<p>
<span class="code">auto</span> makes <span class="code">mount</span> guess for the filesystem (recommended for
removable media as they can be created with one of many filesystems) and

<span class="code">user</span> makes it possible for non-root users to mount the CD.
</p>

<p>
Now use the above example to create your <span class="path">/etc/fstab</span>. As a
<b>SPARC</b>-user, you should also add the following line to your
<span class="path">/etc/fstab</span>
too:
</p>

<a name="doc_chap_pre6"></a><table class="ntable" width="100%" cellspacing="0" cellpadding="0" border="0">

<tr><td bgcolor="#7a5ada"><p class="codetitle">Code Listing 6: Adding openprom filesystem to /etc/fstab</p></td></tr>
<tr><td bgcolor="#eeeeff"><pre>
none                    /proc/openprom  openpromfs      defaults                0 0
</pre></td></tr>
</table>

<p>
Double-check your <span class="path">/etc/fstab</span>, save and quit to continue.
</p>
Comment 4 Peter Weller (RETIRED) gentoo-dev 2006-05-31 05:15:36 UTC
Accidently submitted the wrong file twice, if you need the proper file for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1 let me know in #gentoo-doc on freenode
Comment 5 Xavier Neys (RETIRED) gentoo-dev 2006-05-31 05:16:01 UTC
Sorry, but patches against the html are useless
FYI, this part is shared across all arches. Chances are that it does not match all partitioning plans.
Comment 6 Brooks 2006-05-31 07:14:40 UTC
(In reply to comment #5)
> FYI, this part is shared across all arches. Chances are that it does not match
> all partitioning plans.
> 

If it's shared across all arches, why does it end with "handbook_sparc.xml" and the x86 version end with "handbook-x86.xml" in the file name? That seems to say to me that they are separate files, and while it may not be the partitioning scheme that all people choose, if you're going to suggest a partioning scheme earlier in the handbook, it's probably best to carry that through all the way.
Comment 7 Xavier Neys (RETIRED) gentoo-dev 2006-05-31 07:44:58 UTC
Said file is http://sources.gentoo.org/gentoo/xml/htdocs/doc/en/handbook/hb-install-config.xml

Many parts are shared as mentioned at the very beginning of the handbook:
http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=1#doc_chap1_sect4

Conditional tags would help, but until we have anything like it, best we can do  is make it clear it's an example, works with x86/amd64, needs to be adapted to the chosen partitioning plan for other arches.

Comment 8 nm (RETIRED) gentoo-dev 2006-06-18 16:32:19 UTC
neysx is right. there are plenty of other "this is just an example" warnings throughout the rest of the handbooks. as always, users are expected to create settings according to their needs, not strictly to the given examples.
Comment 9 nm (RETIRED) gentoo-dev 2006-08-22 16:39:49 UTC
*** Bug 144771 has been marked as a duplicate of this bug. ***