commit 5f0e1822e8533a266ef56607d305f657b98f58cd · pyrox.dev/nixpkgs

+35

nixos/doc/manual/from_md/installation/installing-usb.section.xml

···

       1
       +
       <section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-booting-from-usb">

     

       2
       +
         <title>Booting from a USB Drive</title>

     

       3
       +
         <para>

     

       4
       +
           For systems without CD drive, the NixOS live CD can be booted from a

     

       5
       +
           USB stick. You can use the <literal>dd</literal> utility to write

     

       6
       +
           the image: <literal>dd if=path-to-image of=/dev/sdX</literal>. Be

     

       7
       +
           careful about specifying the correct drive; you can use the

     

       8
       +
           <literal>lsblk</literal> command to get a list of block devices.

     

       9
       +
         </para>

     

       10
       +
         <note>

     

       11
       +
           <title>On macOS</title>

     

       12
       +
           <programlisting>

     

       13
       +
       $ diskutil list

     

       14
       +
       [..]

     

       15
       +
       /dev/diskN (external, physical):

     

       16
       +
          #:                       TYPE NAME                    SIZE       IDENTIFIER

     

       17
       +
       [..]

     

       18
       +
       $ diskutil unmountDisk diskN

     

       19
       +
       Unmount of all volumes on diskN was successful

     

       20
       +
       $ sudo dd if=nix.iso of=/dev/rdiskN

     

       21
       +
       </programlisting>

     

       22
       +
           <para>

     

       23
       +
             Using the 'raw' <literal>rdiskN</literal> device instead of

     

       24
       +
             <literal>diskN</literal> completes in minutes instead of hours.

     

       25
       +
             After <literal>dd</literal> completes, a GUI dialog &quot;The disk

     

       26
       +
             you inserted was not readable by this computer&quot; will pop up,

     

       27
       +
             which can be ignored.

     

       28
       +
           </para>

     

       29
       +
         </note>

     

       30
       +
         <para>

     

       31
       +
           The <literal>dd</literal> utility will write the image verbatim to

     

       32
       +
           the drive, making it the recommended option for both UEFI and

     

       33
       +
           non-UEFI installations.

     

       34
       +
         </para>

     

       35
       +
       </section>

+31

nixos/doc/manual/installation/installing-usb.section.md

···

       1
       +
       # Booting from a USB Drive {#sec-booting-from-usb}

     

       2
       +
       

     

       3
       +
       For systems without CD drive, the NixOS live CD can be booted from a USB

     

       4
       +
       stick. You can use the `dd` utility to write the image:

     

       5
       +
       `dd if=path-to-image of=/dev/sdX`. Be careful about specifying the correct

     

       6
       +
       drive; you can use the `lsblk` command to get a list of block devices.

     

       7
       +
       

     

       8
       +
       ::: {.note}

     

       9
       +
       ::: {.title}

     

       10
       +
       On macOS

     

       11
       +
       :::

     

       12
       +
       

     

       13
       +
       ```ShellSession

     

       14
       +
       $ diskutil list

     

       15
       +
       [..]

     

       16
       +
       /dev/diskN (external, physical):

     

       17
       +
          #:                       TYPE NAME                    SIZE       IDENTIFIER

     

       18
       +
       [..]

     

       19
       +
       $ diskutil unmountDisk diskN

     

       20
       +
       Unmount of all volumes on diskN was successful

     

       21
       +
       $ sudo dd if=nix.iso of=/dev/rdiskN

     

       22
       +
       ```

     

       23
       +
       

     

       24
       +
       Using the \'raw\' `rdiskN` device instead of `diskN` completes in

     

       25
       +
       minutes instead of hours. After `dd` completes, a GUI dialog \"The disk

     

       26
       +
       you inserted was not readable by this computer\" will pop up, which can

     

       27
       +
       be ignored.

     

       28
       +
       :::

     

       29
       +
       

     

       30
       +
       The `dd` utility will write the image verbatim to the drive, making it

     

       31
       +
       the recommended option for both UEFI and non-UEFI installations.

-40

nixos/doc/manual/installation/installing-usb.xml

···

       1
       -
       <section xmlns="http://docbook.org/ns/docbook"

     

       2
       -
                xmlns:xlink="http://www.w3.org/1999/xlink"

     

       3
       -
                xmlns:xi="http://www.w3.org/2001/XInclude"

     

       4
       -
                version="5.0"

     

       5
       -
                xml:id="sec-booting-from-usb">

     

       6
       -
        <title>Booting from a USB Drive</title>

     

       7
       -
       

     

       8
       -
        <para>

     

       9
       -
         For systems without CD drive, the NixOS live CD can be booted from a USB

     

       10
       -
         stick. You can use the <command>dd</command> utility to write the image:

     

       11
       -
         <command>dd if=<replaceable>path-to-image</replaceable>

     

       12
       -
         of=<replaceable>/dev/sdX</replaceable></command>. Be careful about specifying

     

       13
       -
         the correct drive; you can use the <command>lsblk</command> command to get a

     

       14
       -
         list of block devices.

     

       15
       -
         <note>

     

       16
       -
          <title>On macOS</title>

     

       17
       -
          <para>

     

       18
       -
       <screen>

     

       19
       -
       <prompt>$ </prompt>diskutil list

     

       20
       -
       [..]

     

       21
       -
       /dev/diskN (external, physical):

     

       22
       -
          #:                       TYPE NAME                    SIZE       IDENTIFIER

     

       23
       -
       [..]

     

       24
       -
       <prompt>$ </prompt>diskutil unmountDisk diskN

     

       25
       -
       Unmount of all volumes on diskN was successful

     

       26
       -
       <prompt>$ </prompt>sudo dd if=nix.iso of=/dev/rdiskN

     

       27
       -
       </screen>

     

       28
       -
           Using the 'raw' <command>rdiskN</command> device instead of

     

       29
       -
           <command>diskN</command> completes in minutes instead of hours. After

     

       30
       -
           <command>dd</command> completes, a GUI dialog "The disk you inserted was

     

       31
       -
           not readable by this computer" will pop up, which can be ignored.

     

       32
       -
          </para>

     

       33
       -
         </note>

     

       34
       -
        </para>

     

       35
       -
       

     

       36
       -
        <para>

     

       37
       -
         The <command>dd</command> utility will write the image verbatim to the drive,

     

       38
       -
         making it the recommended option for both UEFI and non-UEFI installations.

     

       39
       -
        </para>

     

       40
       -
       </section>

+1 -1

nixos/doc/manual/installation/installing.xml

···

       566
        
        <section xml:id="sec-installation-additional-notes">

     

       567
        
         <title>Additional installation notes</title>

     

       568
        
       

     

       569
       -
         <xi:include href="installing-usb.xml" />

     

       570
        
       

     

       571
        
         <xi:include href="installing-pxe.xml" />

     

       572

···

       566
        
        <section xml:id="sec-installation-additional-notes">

     

       567
        
         <title>Additional installation notes</title>

     

       568
        
       

     

       569
       +
         <xi:include href="../from_md/installation/installing-usb.section.xml" />

     

       570
        
       

     

       571
        
         <xi:include href="installing-pxe.xml" />

     

       572