<commit_before><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>
<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>
  </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><commit_msg>nixos/doc: bs=1000000 for dd args (#54280)<commit_after><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>
<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=1000000 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>
  </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>
{'fraction_non_alphanumeric': 0.11776187378009109, 'fraction_numerical': 0.014313597918022121, 'mean_word_length': 3.2531120331950207, 'pattern_counts': {'":': 0, '<': 71, '<?xml version=': 0, '>': 71, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 8}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3100248', 'n_tokens_mistral': 1022, 'n_tokens_neox': 945, 'n_words': 318}