tjh.dev
doc: add missing section IDs
+2
-2
doc/builders/special/darwin-builder.section.md
+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
-
## Example flake usage
65
+
## Example flake usage {#sec-darwin-builder-example-flake}
66
66
67
67
```
68
68
{
···
120
120
}
121
121
```
122
122
123
-
## Reconfiguring the builder
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
+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
-
### Attributes
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
-
### Attributes
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
-
### Examples
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
-
### Attributes
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
-
### Examples
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
-
### Examples
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
-
### Images
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
-
### Attributes
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
-
### Examples
134
+
### Examples {#vm-tools-diskImageFuns-examples}
135
135
136
136
8GiB image containing Firefox in addition to the default packages:
137
137
```nix