AndrewSayers: s/MaybeBoolean/SanitiseBoolean/

2025-09-07T15:14:14Z

s/MaybeBoolean/SanitiseBoolean/

← Older revision		Revision as of 15:14, 7 September 2025
Line 1:		Line 1:
	<pre><onlyinclude>{{#ifeq:{{~~MaybeBoolean~~\|{{{Header\|1}}}}}\|1\|		<pre><onlyinclude>{{#ifeq:{{SanitiseBoolean\|{{{Header\|1}}}}}\|1\|
	Typing the wrong device name can destroy all information on your hard disk, so follow these instructions to select the right device name:		Typing the wrong device name can destroy all information on your hard disk, so follow these instructions to select the right device name:

	}}		}}
	{{#ifeq:{{~~MaybeBoolean~~\|{{{Body\|1}}}}}\|1\|{{#ifeq:{{~~MaybeBoolean~~\|{{{Script\|1}}}}}\|1\|		{{#ifeq:{{SanitiseBoolean\|{{{Body\|1}}}}}\|1\|{{#ifeq:{{SanitiseBoolean\|{{{Script\|1}}}}}\|1\|
	<syntaxhighlight lang="shell">		<syntaxhighlight lang="shell">
	# Make sure your device is disconnected or turned off, then do:		# Make sure your device is disconnected or turned off, then do:
Line 24:		Line 24:
	}}		}}

	{{#ifeq:{{~~MaybeBoolean~~\|{{{Explanation\|1}}}}}\|1\|		{{#ifeq:{{SanitiseBoolean\|{{{Explanation\|1}}}}}\|1\|
	If you did everything right, the <kbd>head</kbd> command should only work when the device is plugged in. You can now use <kbd>$TARGET_DEVICE</kbd> instead of the name of your device in future commands.		If you did everything right, the <kbd>head</kbd> command should only work when the device is plugged in. You can now use <kbd>$TARGET_DEVICE</kbd> instead of the name of your device in future commands.
	}}		}}
	}}		}}

	{{#ifeq:{{~~MaybeBoolean~~\|{{{Footer\|1}}}}}\|1\|		{{#ifeq:{{SanitiseBoolean\|{{{Footer\|1}}}}}\|1\|
	The instructions below often refer to <kbd>$TARGET_DEVICE</kbd>. If you create a variable as described above, you can paste those exact instructions. Otherwise, change <kbd>$TARGET_DEVICE</kbd> to your actual device name.		The instructions below often refer to <kbd>$TARGET_DEVICE</kbd>. If you create a variable as described above, you can paste those exact instructions. Otherwise, change <kbd>$TARGET_DEVICE</kbd> to your actual device name.
	}}</onlyinclude></pre>		}}</onlyinclude></pre>

AndrewSayers: Created page with "

{{#ifeq:{{MaybeBoolean|{{{Header|1}}}}}|1| Typing the wrong device name can destroy all information on your hard disk, so follow these instructions to select the right device name:  }} {{#ifeq:{{MaybeBoolean|{{{Body|1}}}}}|1|{{#ifeq:{{MaybeBoolean|{{{Script|1}}}}}|1|  # Make sure your device is disconnected or turned off, then do: ls /dev/disk/by-id/* | grep -v -- '-part[0-9]*$' | tee /tmp/disks.txt  # Make sure your device..."

2025-09-06T21:54:55Z

Created page with "<pre><onlyinclude>{{#ifeq:{{MaybeBoolean|{{{Header|1}}}}}|1| Typing the wrong device name can destroy all information on your hard disk, so follow these instructions to select the right device name: }} {{#ifeq:{{MaybeBoolean|{{{Body|1}}}}}|1|{{#ifeq:{{MaybeBoolean|{{{Script|1}}}}}|1| <syntaxhighlight lang="shell"> # Make sure your device is disconnected or turned off, then do: ls /dev/disk/by-id/* | grep -v -- '-part[0-9]*$' | tee /tmp/disks.txt # Make sure your device..."

New page

<pre><onlyinclude>{{#ifeq:{{MaybeBoolean|{{{Header|1}}}}}|1|
Typing the wrong device name can destroy all information on your hard disk, so follow these instructions to select the right device name:

}}
{{#ifeq:{{MaybeBoolean|{{{Body|1}}}}}|1|{{#ifeq:{{MaybeBoolean|{{{Script|1}}}}}|1|
<syntaxhighlight lang="shell">
# Make sure your device is disconnected or turned off, then do:
ls /dev/disk/by-id/* | grep -v -- '-part[0-9]*$' | tee /tmp/disks.txt

# Make sure your device is connected and powered up, then do:
ls /dev/disk/by-id/* | grep -v -- '-part[0-9]*$' | diff /tmp/disks.txt -
# You should see something like:
# 10a11
# > /dev/disk/by-id/<identifier-of-your-disk>

# Make a variable with the device from the previous command:
TARGET_DEVICE=/dev/disk/by-id/<identifier-of-your-disk>

# Check you typed it correctly by reading one byte from the disk:
sudo head -c1 "$TARGET_DEVICE" > /dev/null
# Disconnect your device, then try again:
sudo head -c1 "$TARGET_DEVICE" > /dev/null
</syntaxhighlight>
}}

{{#ifeq:{{MaybeBoolean|{{{Explanation|1}}}}}|1|
If you did everything right, the <kbd>head</kbd> command should only work when the device is plugged in. You can now use <kbd>$TARGET_DEVICE</kbd> instead of the name of your device in future commands.
}}
}}

{{#ifeq:{{MaybeBoolean|{{{Footer|1}}}}}|1|
The instructions below often refer to <kbd>$TARGET_DEVICE</kbd>. If you create a variable as described above, you can paste those exact instructions. Otherwise, change <kbd>$TARGET_DEVICE</kbd> to your actual device name.
}}</onlyinclude></pre>
<noinclude>
<templatedata>
{
"params": {
"Header": {
"description": "Whether to include the header section",
"example": "no",
"type": "boolean",
"default": "yes"
},
"Body": {
"description": "Whether to include the body section",
"example": "no",
"type": "boolean",
"default": "yes"
},
"Script": {
"description": "Whether to include the script subsection (top half of the body section)",
"example": "no",
"type": "boolean",
"default": "yes"
},
"Explanation": {
"description": "Whether to include the explanation subsection (bottom half of the body section)",
"example": "no",
"type": "boolean",
"default": "yes"
},
"Footer": {
"description": "Whether to include the footer section",
"example": "no",
"type": "boolean",
"default": "yes"
}
},
"description": "A fairly safe procedure to select a disk, intended for use in HOWTO guides"
}
</templatedata>

Pages sometimes need to ask the user to specify the filename for a physical device, e.g. to reformat that device. Getting this wrong can corrupt the user's hard disk, so this page provides a fairly safe procedure to select the disk.

This template instructs the user to create a variable called <kbd>$TARGET_DEVICE</kbd>. If you change the rest of your page to say e.g. <kbd>some-command $TARGET_DEVICE</kbd> instead of e.g. <kbd>some-command /path/to/your/device</kbd>, readers will be able to directly copy/paste your instructions.
</noinclude>

Template:ChooseADevice - Revision history

AndrewSayers: s/MaybeBoolean/SanitiseBoolean/