commit 830f5b33ddfbfa8d8864a6724fcac87f893ec88a · pyrox.dev/nixpkgs

+2 -2

doc/builders/special/darwin-builder.section.md

···

       62
       62
        
       $ sudo launchctl kickstart -k system/org.nixos.nix-daemon

     

       63
       63
        
       ```

     

       64
       64
        
       

     

       65
       65
       -
       ## Example flake usage

     

       65
       65
       +
       ## Example flake usage {#sec-darwin-builder-example-flake}

     

       66
       66
        
       

     

       67
       67
        
       ```

     

       68
       68
        
       {

     
···

       120
       120
        
       }

     

       121
       121
        
       ```

     

       122
       122
        
       

     

       123
       123
       -
       ## Reconfiguring the builder

     

       123
       123
       +
       ## Reconfiguring the builder {#sec-darwin-builder-reconfiguring}

     

       124
       124
        
       

     

       125
       125
        
       Initially you should not change the builder configuration else you will not be

     

       126
       126
        
       able to use the binary cache. However, after you have the builder running locally

+9 -9

doc/builders/special/vm-tools.section.md

···

       6
       6
        
       

     

       7
       7
        
       A bash script fragment that produces a disk image at `destination`.

     

       8
       8
        
       

     

       9
       9
       -
       ### Attributes

     

       9
       9
       +
       ### Attributes {#vm-tools-createEmptyImage-attributes}

     

       10
       10
        
       

     

       11
       11
        
       * `size`. The disk size, in MiB.

     

       12
       12
        
       * `fullName`. Name that will be written to `${destination}/nix-support/full-name`.

     
···

       20
       20
        
       

     

       21
       21
        
       If the build fails and Nix is run with the `-K/--keep-failed` option, a script `run-vm` will be left behind in the temporary build directory that allows you to boot into the VM and debug it interactively.

     

       22
       22
        
       

     

       23
       23
       -
       ### Attributes

     

       23
       23
       +
       ### Attributes {#vm-tools-runInLinuxVM-attributes}

     

       24
       24
        
       

     

       25
       25
        
       * `preVM` (optional). Shell command to be evaluated *before* the VM is started (i.e., on the host).

     

       26
       26
        
       * `memSize` (optional, default `512`). The memory size of the VM in MiB.

     

       27
       27
        
       * `diskImage` (optional). A file system image to be attached to `/dev/sda`.

     

       28
       28
        
         Note that currently we expect the image to contain a filesystem, not a full disk image with a partition table etc.

     

       29
       29
        
       

     

       30
       30
       -
       ### Examples

     

       30
       30
       +
       ### Examples {#vm-tools-runInLinuxVM-examples}

     

       31
       31
        
       

     

       32
       32
        
       Build the derivation hello inside a VM:

     

       33
       33
        
       ```nix

     
···

       56
       56
        
       

     

       57
       57
        
       Takes a file, such as an ISO, and extracts its contents into the store.

     

       58
       58
        
       

     

       59
       59
       -
       ### Attributes

     

       59
       59
       +
       ### Attributes {#vm-tools-extractFs-attributes}

     

       60
       60
        
       

     

       61
       61
        
       * `file`. Path to the file to be extracted.

     

       62
       62
        
         Note that currently we expect the image to contain a filesystem, not a full disk image with a partition table etc.

     

       63
       63
        
       * `fs` (optional). Filesystem of the contents of the file.

     

       64
       64
        
       

     

       65
       65
       -
       ### Examples

     

       65
       65
       +
       ### Examples {#vm-tools-extractFs-examples}

     

       66
       66
        
       

     

       67
       67
        
       Extract the contents of an ISO file:

     

       68
       68
        
       ```nix

     
···

       82
       82
        
       

     

       83
       83
        
       Generate a script that can be used to run an interactive session in the given image.

     

       84
       84
        
       

     

       85
       85
       -
       ### Examples

     

       85
       85
       +
       ### Examples {#vm-tools-makeImageTestScript-examples}

     

       86
       86
        
       

     

       87
       87
        
       Create a script for running a Fedora 27 VM:

     

       88
       88
        
       ```nix

     
···

       100
       100
        
       

     

       101
       101
        
       A set of functions that build a predefined set of minimal Linux distributions images.

     

       102
       102
        
       

     

       103
       103
       -
       ### Images

     

       103
       103
       +
       ### Images {#vm-tools-diskImageFuns-images}

     

       104
       104
        
       

     

       105
       105
        
       * Fedora

     

       106
       106
        
         * `fedora26x86_64`

     
···

       126
       126
        
         * `debian11i386`

     

       127
       127
        
         * `debian11x86_64`

     

       128
       128
        
       

     

       129
       129
       -
       ### Attributes

     

       129
       129
       +
       ### Attributes {#vm-tools-diskImageFuns-attributes}

     

       130
       130
        
       

     

       131
       131
        
       * `size` (optional, defaults to `4096`). The size of the image, in MiB.

     

       132
       132
        
       * `extraPackages` (optional). A list names of additional packages from the distribution that should be included in the image.

     

       133
       133
        
       

     

       134
       134
       -
       ### Examples

     

       134
       134
       +
       ### Examples {#vm-tools-diskImageFuns-examples}

     

       135
       135
        
       

     

       136
       136
        
       8GiB image containing Firefox in addition to the default packages:

     

       137
       137
        
       ```nix