diff options
author | Vincent Murphy <vdm@vdm.ie> | 2018-01-06 18:13:58 +0000 |
---|---|---|
committer | GitHub <noreply@github.com> | 2018-01-06 18:13:58 +0000 |
commit | bd09ef9c218af99600184d4d87e9d320d5c004be (patch) | |
tree | 2059e474968822adbf6fdf5866bda4f3c301058a /nixos | |
parent | f95d92ee96a837d081a131d9666ddbd1a6967676 (diff) |
Update macos USB instructions
"Ejecting" from the Finder ejects the entire device which is then not available for dd. diskutil unmountDisk does the right thing. Furthermore writing to diskN instead of rdiskN failed to complete even after waiting >10 minutes.
Diffstat (limited to 'nixos')
-rw-r--r-- | nixos/doc/manual/installation/installing-usb.xml | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/nixos/doc/manual/installation/installing-usb.xml b/nixos/doc/manual/installation/installing-usb.xml index 31d51816e39b0..122a4745f1948 100644 --- a/nixos/doc/manual/installation/installing-usb.xml +++ b/nixos/doc/manual/installation/installing-usb.xml @@ -11,10 +11,24 @@ a USB stick. You can use the <command>dd</command> utility to write the image: <command>dd if=<replaceable>path-to-image</replaceable> of=<replaceable>/dev/sdb</replaceable></command>. Be careful about specifying the correct drive; you can use the <command>lsblk</command> command to get a list of -block devices. If you're on macOS you can run <command>diskutil list</command> -to see the list of devices; the device you'll use for the USB must be ejected -before writing the image.</para> +block devices.</para> +<para>On macOS: +<programlisting> +$ diskutil list +[..] +/dev/diskN (external, physical): + #: TYPE NAME SIZE IDENTIFIER +[..] +$ diskutil unmountDisk diskN +Unmount of all volumes on diskN was successful +$ sudo dd bs=1m if=nix.iso of=/dev/rdiskN +</programlisting> +Using the 'raw' <command>rdiskN</command> device instead of <command>diskN</command> +completes in minutes instead of hours. After <command>dd</command> completes, a GUI +dialog "The disk you inserted was not readable by this computer" will pop up, which +can be ignored.</para> + <para>The <command>dd</command> utility will write the image verbatim to the drive, making it the recommended option for both UEFI and non-UEFI installations. For non-UEFI installations, you can alternatively use |