From mboxrd@z Thu Jan 1 00:00:00 1970 From: Matthew Brooks Subject: Re: How to declare a bind mount in the "file-systems" definition? Date: Wed, 22 Apr 2020 12:03:25 -0500 Message-ID: <20200422120325.7bb8f386@mailbox.org> References: <20200319193123.40d51798@mailbox.org> <20200320014155.GA30652@jasmine.lan> <20200320231457.520bf473@mailbox.org> <20200322221210.GA20590@jasmine.lan> <20200326101032.50ba3d9c@mailbox.org> <20200329150109.505f087e@mailbox.org> <20200408165247.GA27150@jasmine.lan> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="MP_/PomdDLkdz_/6QlLazxLZGeS" Return-path: Received: from eggs.gnu.org ([2001:470:142:3::10]:56406) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jRImj-00027I-Ee for help-guix@gnu.org; Wed, 22 Apr 2020 13:03:41 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jRImi-0005Ch-Dg for help-guix@gnu.org; Wed, 22 Apr 2020 13:03:41 -0400 Received: from mout-p-102.mailbox.org ([80.241.56.152]:27306) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_CHACHA20_POLY1305:256) (Exim 4.90_1) (envelope-from ) id 1jRImg-0004ua-Bk for help-guix@gnu.org; Wed, 22 Apr 2020 13:03:40 -0400 In-Reply-To: <20200408165247.GA27150@jasmine.lan> List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+gcggh-help-guix=m.gmane-mx.org@gnu.org Sender: "Help-Guix" To: Leo Famulari Cc: "help-guix@gnu.org" --MP_/PomdDLkdz_/6QlLazxLZGeS Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Disposition: inline Thanks for the help! I've renamed the section and hard wrapped the lines, and updated it to a more recent commit. Let me know if there's anything else I should do. On Wed, 8 Apr 2020 12:52:47 -0400 Leo Famulari wrote: > On Sun, Mar 29, 2020 at 03:01:09PM -0500, Matthew Brooks wrote: > > I can give it a shot. I've whipped up and attached a quick patch that adds a section about bind-mounting. > > I wasn't able to find any info on how to preview the resulting html file though, or on what the preferred writing style is for the cookbook. > > Thanks! > > You can build the cookbook as HTML like this: > > `guix environment --pure guix -- make doc/guix-cookbook.html` > > When building you will see some errors and warnings that need to be > fixed, related to setting up the menu and navigating between sections. > > Lines should be wrapped at 72 characters, except in examples. > > > * Customizing the Kernel:: Creating and using a custom Linux kernel on Guix System. > > +* Bind-mounting file systems:: Setting up a bind-mount in the file-systems definition. > > "Setting up a bind-mount on Guix System" is more general, and thus I > think more appropriate for the table of contents. > > Otherwise LGTM! Can you send a revised patch? --MP_/PomdDLkdz_/6QlLazxLZGeS Content-Type: text/x-patch Content-Transfer-Encoding: quoted-printable Content-Disposition: attachment; filename=cookbook_example_of_bind-mounting.patch diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi index 58a5ba1c80..b4522c0637 100644 --- a/doc/guix-cookbook.texi +++ b/doc/guix-cookbook.texi @@ -1322,6 +1322,7 @@ reference. @menu * Customizing the Kernel:: Creating and using a custom Linux kernel = on Guix System. * Customizing a Window Manager:: Handle customization of a Window manager = on Guix System. +* Setting up a bind-mount on Guix System:: Setting up a bind-mount in the = file-systems definition. @end menu =20 @node Customizing the Kernel @@ -1614,6 +1615,55 @@ Then you need to add the following code to a StumpWM= configuration file (set-font (make-instance 'xft:font :family "DejaVu Sans Mono" :subfamily "= Book" :size 11)) @end lisp =20 +@node Setting up a bind-mount on Guix System +@section Setting up a bind-mount on Guix System + +To bind-mount a file-system, one must first set up some definitions +before the @code{operating-system} section of the system definition. In +this example we will bind-mount a folder from a spinning disk drive to +@code{/tmp}, to save wear and tear on the primary SSD, without +dedicating an entire partition to be mounted as @code{/tmp}. + +First, the source drive that hosts the folder we wish to bind mount +should be defined, so that the bind-mount can depend on it. + +@lisp +(define source-drive ;; "source-drive" can be named anything you want. + (file-system + (device (uuid "UUID goes here")) + (mount-point "/path-to-spinning-disk-goes-here") + (type "ext4"))) ;; Make sure to set this to the appropriate type for y= our drive. +@end lisp + +The source folder must also be defined, so that guix will know it's not +a regular block device, but a folder. +@lisp +(define (%source-directory) "/path-to-spinning-disk-goes-here/tmp") ;; "so= urce-directory" can be named any valid variable name. +@end lisp + +Finally, inside the @code{file-systems} definition, we must add the +mount itself. + +@lisp +(file-systems (cons* + + ...... + + source-drive ;; Must match the name you gave the source dr= ive in the earlier definition. + + (file-system + (device (%source-directory)) ;; Make sure "source-directo= ry" matches your earlier definition. + (mount-point "/tmp") + (type "none") ;; We are mounting a folder, not a partitio= n, so this type needs to be "none" + (flags '(bind-mount)) + (dependencies (list source-drive)) ;; Ensure "source-driv= e" matches what you've named the variable for the drive. + ) + + ...... + + )) +@end lisp + @c ********************************************************************* @node Advanced package management @chapter Advanced package management --MP_/PomdDLkdz_/6QlLazxLZGeS--