From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20=C4=8Cech?= Subject: [PATCH 2/2] doc: Document extra-packages argument of base-initrd. Date: Tue, 2 Aug 2016 09:43:18 +0200 Message-ID: <20160802074318.2572-3-sleep_walker@gnu.org> References: <87a8gwxzm4.fsf@igalia.com> <20160802074318.2572-1-sleep_walker@gnu.org> Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:51493) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bUUTj-00028z-JP for guix-devel@gnu.org; Tue, 02 Aug 2016 03:51:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bUUTc-0001Mm-4n for guix-devel@gnu.org; Tue, 02 Aug 2016 03:51:06 -0400 In-Reply-To: <20160802074318.2572-1-sleep_walker@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: guix-devel@gnu.org * doc/guix.texi(Initial RAM Disk): Describe extra-modules parameter in definition of base-initrd. Mention it under example of use of extra-packges. --- doc/guix.texi | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/doc/guix.texi b/doc/guix.texi index 786fe55..27a4cea 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -10183,6 +10183,9 @@ system declaration like this: rest))) @end example +In a similar way you can add programs to packed into initrd using +@code{#:extra-packages}. + The @code{base-initrd} procedure also handles common use cases that involves using the system as a QEMU guest, or as a ``live'' system with volatile root file system. @@ -10233,7 +10236,7 @@ further. @deffn {Monadic Procedure} base-initrd @var{file-systems} @ [#:qemu-networking? #f] [#:virtio? #t] [#:volatile-root? #f] @ - [#:extra-modules '()] [#:mapped-devices '()] + [#:extra-packages '()] [#:extra-modules '()] [#:mapped-devices '()] Return a monadic derivation that builds a generic initrd. @var{file-systems} is a list of file systems to be mounted by the initrd, possibly in addition to the root file system specified on the kernel command line via @code{--root}. @@ -10251,6 +10254,11 @@ The initrd is automatically populated with all the kernel modules necessary for @var{file-systems} and for the given options. However, additional kernel modules can be listed in @var{extra-modules}. They will be added to the initrd, and loaded at boot time in the order in which they appear. + +Additional packages can be added through @var{extra-packages}. This is +useful mostly for development and debugging purposes but it can also be +used to extend set of commands available in case of interactive +recovery. @end deffn Needless to say, the initrds we produce and use embed a -- 2.9.2