diff options
author | Bobby Rong <rjl931189261@126.com> | 2021-07-02 22:50:10 +0800 |
---|---|---|
committer | Bobby Rong <rjl931189261@126.com> | 2021-07-02 22:50:10 +0800 |
commit | 5f0e1822e8533a266ef56607d305f657b98f58cd (patch) | |
tree | 2cf87eb07a7b514877267ea9a119b64d83bd3ad0 /nixos/doc/manual/installation | |
parent | 357d2c8f6087685fe35cb1889a005a4dd4cce7b8 (diff) | |
download | nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar.gz nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar.bz2 nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar.lz nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar.xz nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.tar.zst nixlib-5f0e1822e8533a266ef56607d305f657b98f58cd.zip |
nixos: nixos/doc/manual/installation/installing-usb.xml to CommonMark
Diffstat (limited to 'nixos/doc/manual/installation')
-rw-r--r-- | nixos/doc/manual/installation/installing-usb.section.md | 31 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing-usb.xml | 40 | ||||
-rw-r--r-- | nixos/doc/manual/installation/installing.xml | 2 |
3 files changed, 32 insertions, 41 deletions
diff --git a/nixos/doc/manual/installation/installing-usb.section.md b/nixos/doc/manual/installation/installing-usb.section.md new file mode 100644 index 000000000000..ae58c08e5237 --- /dev/null +++ b/nixos/doc/manual/installation/installing-usb.section.md @@ -0,0 +1,31 @@ +# Booting from a USB Drive {#sec-booting-from-usb} + +For systems without CD drive, the NixOS live CD can be booted from a USB +stick. You can use the `dd` utility to write the image: +`dd if=path-to-image of=/dev/sdX`. Be careful about specifying the correct +drive; you can use the `lsblk` command to get a list of block devices. + +::: {.note} +::: {.title} +On macOS +::: + +```ShellSession +$ diskutil list +[..] +/dev/diskN (external, physical): + #: TYPE NAME SIZE IDENTIFIER +[..] +$ diskutil unmountDisk diskN +Unmount of all volumes on diskN was successful +$ sudo dd if=nix.iso of=/dev/rdiskN +``` + +Using the \'raw\' `rdiskN` device instead of `diskN` completes in +minutes instead of hours. After `dd` completes, a GUI dialog \"The disk +you inserted was not readable by this computer\" will pop up, which can +be ignored. +::: + +The `dd` utility will write the image verbatim to the drive, making it +the recommended option for both UEFI and non-UEFI installations. diff --git a/nixos/doc/manual/installation/installing-usb.xml b/nixos/doc/manual/installation/installing-usb.xml deleted file mode 100644 index 83598635acca..000000000000 --- a/nixos/doc/manual/installation/installing-usb.xml +++ /dev/null @@ -1,40 +0,0 @@ -<section xmlns="http://docbook.org/ns/docbook" - xmlns:xlink="http://www.w3.org/1999/xlink" - xmlns:xi="http://www.w3.org/2001/XInclude" - version="5.0" - xml:id="sec-booting-from-usb"> - <title>Booting from a USB Drive</title> - - <para> - For systems without CD drive, the NixOS live CD can be booted from 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/sdX</replaceable></command>. Be careful about specifying - the correct drive; you can use the <command>lsblk</command> command to get a - list of block devices. - <note> - <title>On macOS</title> - <para> -<screen> -<prompt>$ </prompt>diskutil list -[..] -/dev/diskN (external, physical): - #: TYPE NAME SIZE IDENTIFIER -[..] -<prompt>$ </prompt>diskutil unmountDisk diskN -Unmount of all volumes on diskN was successful -<prompt>$ </prompt>sudo dd if=nix.iso of=/dev/rdiskN -</screen> - 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> - </note> - </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. - </para> -</section> diff --git a/nixos/doc/manual/installation/installing.xml b/nixos/doc/manual/installation/installing.xml index f03b9443d23b..f7b527b9cf55 100644 --- a/nixos/doc/manual/installation/installing.xml +++ b/nixos/doc/manual/installation/installing.xml @@ -566,7 +566,7 @@ Retype new UNIX password: ***</screen> <section xml:id="sec-installation-additional-notes"> <title>Additional installation notes</title> - <xi:include href="installing-usb.xml" /> + <xi:include href="../from_md/installation/installing-usb.section.xml" /> <xi:include href="installing-pxe.xml" /> |