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.
Created attachment 87973 [details, diff] Proposed fix for http://www.gentoo.org/doc/en/handbook/handbook-sparc.xml?part=1&chap=8#doc_chap1
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 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>
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
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.
(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.
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.
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.
*** Bug 144771 has been marked as a duplicate of this bug. ***
