From: "Ludovic Courtès" <ludo@gnu.org>
To: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Cc: 55613@debbugs.gnu.org
Subject: [bug#55613] [PATCH] doc: Document how to repair Guix System from a chroot.
Date: Tue, 31 May 2022 16:10:21 +0200 [thread overview]
Message-ID: <87mtexyer6.fsf@gnu.org> (raw)
In-Reply-To: <20220524145738.4547-1-maxim.cournoyer@gmail.com> (Maxim Cournoyer's message of "Tue, 24 May 2022 10:57:38 -0400")
Hi!
Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:
> * doc/guix.texi (System Troubleshooting Tips): New chapter.
That’s a much welcome addition.
Since it’s more informal than the manual, how adding it to the cookbook?
I imagine we could have other troubleshooting subsections.
Some minor typographical comments…
> +@anchor{Manual Installation - Networking}
Usually anchor names are lowercase and without spaces (I’m not sure if
it’s a hard requirement or a convention).
> +@cindex troubleshooting, guix system
“Guix System”
> +Boot the image, and proceed with the graphical text-based installer
> +until your network is configured. Alternatively, you could configure
> +the network manually by following the @pxref{Manual Installation -
> +Networking} section. If you get the error @samp{RTNETLINK answers:
@pxref is for use in a parenthesized expression; it cannot be used in
the middle of a sentence; in fact, no cross-reference markup can be used
in the middle of a sentence, but I recommend checking the manual
(info "(texinfo) Cross References").
> +Switch to a virtual console (tty) if you haven't already by pressing
> +simultaneously the @samp{Control + Alt + F4} keys. Mount your file
Rather @kbd{ctrl-alt-F4}.
> +@example sh
> +# mount /dev/sda2 /mnt
> +@end example
> +
> +@item
> +Mount special block devices and Linux-specific directories:
> +
> +@example sh
> +# mount --bind /proc /mnt/proc
> +# mount --bind /sys /mnt/sys
> +# mount --bind /dev /mnt/dev
> +@end example
I’d remove the “#” prompt from examples, for easier copy/pasting
(assuming that’s an option in those circumstances :-)) and for
consistency.
> +Source your user profile to setup the environment, where
> +@samp{$YOUR_USER} is adjusted to the user name used for the Guix System
> +you are attempting to repair.
> +
> +@example sh
> +sh-5.1# source /home/$YOUR_USER/.guix-profile/etc/profile
You can use a “meta-syntactic variable” for the user name: write
@var{user}, both in the text and example.
> +@item
> +Start a minimal guix-daemon in the background:
s/a minimal guix-daemon/@command{guix-daemon}/
> +@example sh
> +sh-5.1# guix-daemon --build-users-group=guixbuild --disable-chroot &
What’s the rationale for ‘--disable-chroot’? It’s safer to avoid it.
Thanks,
Ludo’.
next prev parent reply other threads:[~2022-05-31 14:12 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-05-24 14:57 [bug#55613] [PATCH] doc: Document how to repair Guix System from a chroot Maxim Cournoyer
2022-05-31 14:10 ` Ludovic Courtès [this message]
2022-06-14 19:22 ` bug#55613: " Maxim Cournoyer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87mtexyer6.fsf@gnu.org \
--to=ludo@gnu.org \
--cc=55613@debbugs.gnu.org \
--cc=maxim.cournoyer@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/guix.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.