Bug 67806
| Summary: | [patch] Let 5.x users know how to boot into single user mode in cutting-edge part of handbook. | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | Liam Foy <liamfoy> |
| Component: | Books & Articles | Assignee: | Tom Rhodes <trhodes> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
|
Description
Liam Foy
2004-06-10 20:20:17 UTC
Responsible Changed From-To: freebsd-advocacy->freebsd-docs This is docs@ fodder. Responsible Changed From-To: freebsd-docs->freebsd-doc Just. Don't. Say. Anything. > Patch can be viewed at: http://liamfoy.kerneled.org/fix.diff
When the patch is a minor edit like this one, it usually isn't a very
serious problem to see the entire diff as part of the PR text IMHO :)
: --- /hd3/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml Thu Jun 10 19:51:47 2004
: +++ /hd3/chapter.sgml Thu Jun 10 19:59:56 2004
: @@ -749,8 +749,9 @@
: mode.</para>
:
: <para>Alternatively, reboot the system, and at the boot prompt,
: - enter the <option>-s</option> flag. The system will then boot
: - single user. At the shell prompt you should then run:</para>
: + enter the <option>-s</option> flag (5.x users press 4 at boot
: + up menu). The system will then boot single user. At the shell
: + prompt you should then run:</para>
:
: <screen>&prompt.root; <userinput>fsck -p</userinput>
: &prompt.root; <userinput>mount -u /</userinput>
Two comments:
a. Your editor seems to be inserting trailing whitespace when lines are
wrapped. This means that the lines starting with + in the diff above
insert whitespace that someone will have to delete later.
b. Is "just press 4" some magic key combo for the boot loader of 5.X?
I've been using a lot of different keys: SPACE, RETURN, ESC are a few of
those. There is nothing different to the boot process of 5.X regarding
single-user mode AFAIK.
Did I miss/overlook something?
State Changed From-To: open->feedback I don't think there is any significant difference when booting 5.X into single-user mode. Have I misunderstood your suggestion or the text of your proposed change? Giorgos Keramidas <keramida@FreeBSD.org> writes: > I don't think there is any significant difference when booting 5.X into > single-user mode. Have I misunderstood your suggestion or the text of > your proposed change? There *is* a difference. First of all, the original text is incorrect even for 4.x (it should say "wait until the countdown, press enter, type 'boot -s' and press enter again" since 4.x has /boot/loader). Second, a default 5.x installation has the horrid daemon menu, where you press 4 to get single-user mode (or 6 to get the loader prompt, at which point you type 'boot -s' as in 4.x) DES --=20 Dag-Erling Sm=F8rgrav - des@des.no State Changed From-To: feedback->open Doug-Erling explained to me what I was missing. Put this back into the pool of open PRs. State Changed From-To: open->feedback What do y'all think about the following patch? In case GNATS mangles it, you can fetch it from http://people.FreeBSD.org/~roam/doc/boot-single.patch Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v retrieving revision 1.203 diff -u -r1.203 chapter.sgml --- doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 6 Jul 2004 15:09:54 -0000 1.203 +++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 22 Jul 2004 14:34:13 -0000 @@ -748,9 +748,24 @@ <para>from a running system, which will drop it to single user mode.</para> - <para>Alternatively, reboot the system, and at the boot prompt, - enter the <option>-s</option> flag. The system will then boot - single user. At the shell prompt you should then run:</para> + <para>Alternatively, reboot the system. When the <link + linkend="boot-loader">boot loader</link> starts and displays the + message <quote>Booting [<filename>/kernel</filename>] in 10 + seconds</quote>, press <keycap>Space</keycap> (or any key but + <keycap>Enter</keycap>) to interrupt the countdown and display the + loader prompt, then enter the <command>boot -s</command> command. + The system will then boot in single user mode.</para> + + <note> + <para>If you are using &os.current;, the loader does not display a + countdown, but a full-screen menu instead. Press the appropriate + key to invoke the <quote>Boot &os; in single user mode</quote> + option; it is usually <keycap>4</keycap>, but may differ if you + have customized your loader menu.</para> + </note> + + <para>Once you have dropped the system into single user mode, run the + following commands at the shell prompt:</para> <screen>&prompt.root; <userinput>fsck -p</userinput> &prompt.root; <userinput>mount -u /</userinput> On 2004.07.22 14:41:18 +0000, Peter Pentchev wrote: > What do y'all think about the following patch? Since we are getting closer and closer to 5.X as -STABLE I personally prefer to start making 4.X the exception, rather than the other way around, so 5.X is described and the 4.X behavior is in a "<note>", but that might just be me... > Index: doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml > =================================================================== > RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml,v > retrieving revision 1.203 > diff -u -r1.203 chapter.sgml > --- doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 6 Jul 2004 15:09:54 -0000 1.203 > +++ doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml 22 Jul 2004 14:34:13 -0000 > @@ -748,9 +748,24 @@ > <para>from a running system, which will drop it to single user > mode.</para> > > - <para>Alternatively, reboot the system, and at the boot prompt, > - enter the <option>-s</option> flag. The system will then boot > - single user. At the shell prompt you should then run:</para> > + <para>Alternatively, reboot the system. When the <link > + linkend="boot-loader">boot loader</link> starts and displays the > + message <quote>Booting [<filename>/kernel</filename>] in 10 > + seconds</quote>, press <keycap>Space</keycap> (or any key but > + <keycap>Enter</keycap>) to interrupt the countdown and display the > + loader prompt, then enter the <command>boot -s</command> command. > + The system will then boot in single user mode.</para> > + > + <note> > + <para>If you are using &os.current;, the loader does not display a I think "&os; 5.X" is better since hopefully we should have 5.3-STABLE in a few months. -- Simon L. Nielsen FreeBSD Documentation Team State Changed From-To: feedback->closed Closed. The handbook no longer documents FreeBSD 4.X or 5.X behavior. Older versions of the handbook are available at http://docs.FreeBSD.org. Thanks! Responsible Changed From-To: freebsd-doc->trhodes Over to me. |
