clearlinux/clear-linux-documentation
2
0
Fork 0
mirror of https://github.com/clearlinux/clear-linux-documentation.git synced 2026-08-24 08:48:15 +00:00
Code Issues Packages Projects Releases Wiki Activity

Bootable USB (#436)

Browse Source 
* bootable-usb: Add extra caution about unmount

Not unmounting an USB partition before an image is burned could cause
file system checksum errors leading to other issues (including kernel
panics) when trying to boot from the USB drive. This commit adds an extra
caution note to warn the users about the possible issues they could find
when this step is not followed correctly.

Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>

* bootable-usb: Add o_sync to the dd command

Update the example 'dd' command to burn an image, by adding the 'oflag=sync'
option. This allows to reduce the flashing time in conjunction with the
recommended 'bs=4M', enables a more accurate progress indicator, and allows
to remove the additional sync command, while preserving some cache
optimizations.

Signed-off-by: Jair Gonzalez <jair.de.jesus.gonzalez.plascencia@intel.com>
This commit is contained in:
Jair Gonzalez
2019-03-28 19:45:16 -06:00
committed by michael vincerra
parent 99f9289a67
commit 73e154d072
2 changed files with 11 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
source/clear-linux/get-started/bootable-usb/bootable-usb.rst
+6 -2
View File
@@ -78,7 +78,7 @@ Burn the |CL| image onto a USB drive
├─sda8 8:8 0 30G 0 part /
└─sda6 8:6 0 7.9G 0 part [SWAP]
#. You must unmount a USB drive before you can burn an image onto it. Note that
#. You must unmount a USB drive before burning an image onto it. Note that
some Linux distros automatically mount a USB drive when it is plugged in.
Unmount a USB drive with the :command:`umount` command followed by the device
identifier/partition. For example:
@@ -93,7 +93,11 @@ Burn the |CL| image onto a USB drive
.. code-block:: bash
dd if=./clear-[version number]-[image type] of=<your USB device> bs=4M status=progress && sync
dd if=./clear-[version number]-[image type] of=<your USB device> oflag=sync bs=4M status=progress
.. caution::
|CAUTION-UNMOUNT-USB-PARTITIONS|
.. _bootable-usb-mac:
source/substitutions.txt
+5
View File
@@ -9,3 +9,8 @@
.. |CAUTION-BACKUP-USB| replace::
Burning an image formats the USB drive, and will destroy all pre-existing
content. Back up your data before proceeding.
.. |CAUTION-UNMOUNT-USB-PARTITIONS| replace::
Not fully unmounting the USB drive before burning an image could cause
file system checksum errors in it. If this happens, burn the image again
ensuring all the USB drive partitions are unmounted first.