From a045c75e7f79a6eaa2723683878019c0f1be0a5b Mon Sep 17 00:00:00 2001
From: msiism <msi@malbolge.net>
Date: Thu, 23 May 2019 17:19:11 +0200
Subject: Add instructions for creating bootable flash drive on Linux/BSD

---
 src/install/1_begin.xml | 6 ++++++
 1 file changed, 6 insertions(+)

(limited to 'src')

diff --git a/src/install/1_begin.xml b/src/install/1_begin.xml
index e901a51..2a023fc 100644
--- a/src/install/1_begin.xml
+++ b/src/install/1_begin.xml
@@ -46,6 +46,12 @@
             <para>On Linux or BSD systems, you can use either <command>cdrecord</command> or <command>cdrskin</command> to write the installation image to a CD via the command line. Both commands basically share the same syntax.</para>
             <para>For example, to burn the image onto a CD at a speed of 4 and with verbose command output, run <command>cdrecord -v speed=4 <userinput>[image]</userinput></command> or <command>cdrskin -v speed=4 <userinput>[image]</userinput></command>, replacing <userinput>[image]</userinput> with the file name of the image you want to burn to the CD.</para>
             <para>If there's only one optical disc drive on your system, it should be auto-detected. If not, find the device name using 'dmesg' or 'lsblk' and specify it using the 'dev' option.  For example, if your optical device is <literal>/dev/sr0</literal>, run <command>cdrecord -v dev=/dev/sr0 speed=4 <userinput>[image]</userinput></command>.</para>
+            <para>To write an installation image to a USB flash drive, you can use the <command>dd</command> command.</para>
+            <para>First, you'll need to get the name of the target device. This can be done by looking at the output of <command>dmesg</command> or any program that lists available storage devices (such as <command>lsblk</command> on Linux) before and after connecting the drive to the computer.</para>
+            <para>It's a good idea to double-check if you've got that device name right. Make sure you're using the name of the whole drive (such as, e.g., <literal>/dev/sde</literal>) and not merely that of a partition residing on it (e.g., <literal>/dev/sde1</literal>).</para>
+            <para>Next, make sure the device is not mounted. Then run the <command>dd</command> command and after that the <command>sync</command> command as shown below, replacing <literal>/dev/sdX</literal> with the actual name of the target device and <literal>adelie.iso</literal> with the file name of the image you want to put onto the flash drive. Running these commands may require superuser privileges.</para>
+            <para>Beware that this operation will <emphasis>destroy all data</emphasis> still residing on the target device!</para>
+            <para><command>dd if=adelie.iso of=/dev/sdX bs=4M && sync</command></para>
         </section>
     </section>
 </chapter>
-- 
cgit v1.2.3-70-g09d2