ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/pbcdedit/pbcdedit

Comparing pbcdedit/pbcdedit (file contents):
Revision 1.9 by root, Wed Aug 14 22:54:28 2019 UTC vs.
Revision 1.50 by root, Thu Aug 22 07:43:46 2019 UTC

…		…
17	#	17	#
18	# You should have received a copy of the GNU General Public License	18	# You should have received a copy of the GNU General Public License
19	# along with this program. If not, see <https://www.gnu.org/licenses/>.	19	# along with this program. If not, see <https://www.gnu.org/licenses/>.
20	#	20	#
21		21
22	use 5.014; # numerous features needed	22	use 5.016; # numerous features need 5.14, __SUB__ needs 5.16
23		23
24	our $VERSION = '1.0';	24	our $VERSION = '1.3';
25	our $JSON_VERSION = 1; # the versiobn of the json objects generated by this program	25	our $JSON_VERSION = 3; # the version of the json objects generated by this program
		26
		27	our $CHANGELOG = <<EOF;
		28
		29	1.3 Sat Aug 17 07:04:15 CEST 2019
		30	- output of pbcdedit elements --json has changed, as it didn't
		31	take the reorganisation by classes fully into account.
		32	- json schema bumped to 3.
		33	- new "bcd-device" and "bcd-legacy-device" subcommands.
		34	- implement --json option for lsblk.
		35
		36	1.2 Fri Aug 16 00:20:41 CEST 2019
		37	- bcd element names now depend on the bcd object type they are in,
		38	also affects "elements" output.
		39	- json schema bumped to 2.
		40	- new version command.
		41	- numerous minor bugfixes.
		42
		43	EOF
26		44
27	=head1 NAME	45	=head1 NAME
28		46
29	pbcdedit - portable boot configuration data (BCD) store editor	47	pbcdedit - portable boot configuration data (BCD) store editor
30		48
31	=head1 SYNOPSIS	49	=head1 SYNOPSIS
32		50
33	pbcdedit help # output manual page	51	pbcdedit help # output manual page
		52	pbcdedit version # output version and changelog
		53
34	pbcdedit export path/to/BCD # output BCD hive as JSON	54	pbcdedit export path/to/BCD # output BCD hive as JSON
35	pbcdedit import path/to/bcd # convert standard input to BCD hive	55	pbcdedit import path/to/BCD # convert standard input to BCD hive
36	pbcdedit edit path/to/BCD edit-instructions...	56	pbcdedit edit path/to/BCD edit-instructions...
37		57
38	pbcdedit objects # list all supported object aliases and types	58	pbcdedit objects # list all supported object aliases and types
39	pbcdedit elements # list all supported bcd element aliases	59	pbcdedit elements # list all supported bcd element aliases
40		60
…		…
58		78
59	=item Does not rely on Windows	79	=item Does not rely on Windows
60		80
61	As the "portable" in the name implies, this program does not rely on	81	As the "portable" in the name implies, this program does not rely on
62	C<bcdedit> or other windows programs or libraries, it works on any system	82	C<bcdedit> or other windows programs or libraries, it works on any system
63	that supports at least perl version 5.14.	83	that supports at least perl version 5.16.
64		84
65	=item Decodes and encodes BCD device elements	85	=item Decodes and encodes BCD device elements
66		86
67	PBCDEDIT can concisely decode and encode BCD device element contents. This	87	PBCDEDIT can concisely decode and encode BCD device element contents. This
68	is pretty unique, and offers a lot of potential that can't be realised	88	is pretty unique, and offers a lot of potential that can't be realised
…		…
75	sensitive data.	95	sensitive data.
76		96
77	=back	97	=back
78		98
79	The target audience for this program is professionals and tinkerers who	99	The target audience for this program is professionals and tinkerers who
80	are rewady to invest time into learning how it works. It is not an easy	100	are ready to invest time into learning how it works. It is not an easy
81	program to use and requires patience and a good understanding of BCD data	101	program to use and requires patience and a good understanding of BCD
82	stores.	102	stores.
83		103
84		104
85	=head1 SUBCOMMANDS	105	=head1 SUBCOMMANDS
86		106
87	PCBEDIT expects a subcommand as first argument that tells it what to	107	PBCDEDIT expects a subcommand as first argument that tells it what to
88	do. The following subcommands exist:	108	do. The following subcommands exist:
89		109
90	=over	110	=over
91		111
92	=item help	112	=item C<help>
93		113
94	Displays the whole manuale page (this document).	114	Displays the whole manual page (this document).
95		115
		116	=item C<version>
		117
		118	This outputs the PBCDEDIT version, the JSON schema version it uses and the
		119	full log of changes.
		120
96	=item export F<path>	121	=item C<export> F<path>
97		122
98	Reads a BCD data store and writes a JSON representation of it to standard	123	Reads a BCD data store and writes a JSON representation of it to standard
99	output.	124	output.
100		125
101	The format of the data is explained later in this document.	126	The format of the data is explained later in this document.
102		127
103	Example: read a BCD store, modify it wiht an extenral program, write it again.	128	Example: read a BCD store, modify it with an external program, write it
		129	again.
104		130
105	pbcdedit export BCD | modify-json-somehow | pbcdedit import BCD	131	pbcdedit export BCD | modify-json-somehow | pbcdedit import BCD
106		132
107	=item import F<path>	133	=item C<import> F<path>
108		134
109	The reverse of C<export>: Reads a JSON representation of a BCD data store	135	The reverse of C<export>: Reads a JSON representation of a BCD data store
110	from standard input, and creates or replaces the given BCD data store.	136	from standard input, and creates or replaces the given BCD data store.
111		137
112	=item edit F<path> instructions...	138	=item C<edit> F<path> I<instructions...>
113		139
114	Load a BCD data store, apply some instructions to it, and save it again.	140	Load a BCD data store, apply some instructions to it, and save it again.
115		141
116	See the section L<EDITING BCD DATA STORES>, below, for more info.	142	See the section L<EDITING BCD STORES>, below, for more info.
117		143
118	=item parse F<path> instructions...	144	=item C<parse> F<path> I<instructions...>
119		145
120	Same as C<edit>, above, except it doesn't save the data store again. Can	146	Same as C<edit>, above, except it doesn't save the data store again. Can
121	be useful to extract some data from it.	147	be useful to extract some data from it.
122		148
123	=item lsblk	149	=item C<lsblk> [C<--json>]
124		150
125	On a GNU/Linux system, you can get a list of partition device descriptors	151	On a GNU/Linux system, you can get a list of partition device descriptors
126	using this command - the external C<lsblk> command is required, as well as	152	using this command - the external C<lsblk> command is required, as well as
127	a mounted C</sys> file system.	153	a mounted C</sys> file system.
128		154
129	The output will be a list of all partitions in the system and C<partition>	155	The output will be a list of all partitions in the system and C<partition>
130	descriptors for GPT and both C<legacypartition> and C<partition>	156	descriptors for GPT and both C<legacypartition> and C<partition>
131	descritpors for MBR partitions.	157	descriptors for MBR partitions.
132		158
		159	With C<--json> it will print similar informationm as C<lsblk --json>, but
		160	with extra C<bcd_device> and C<bcd_legacy_device> attributes.
		161
		162	=item C<bcd-device> F<path>
		163
		164	Tries to find the BCD device element for the given device, which currently
		165	must be a a partition of some kind. Prints the C<partition=> descriptor as
		166	a result, or nothing. Exit status will be true on success, and false on
		167	failure.
		168
		169	Like C<lsblk>, above, this likely only works on GNU/Linux systems.
		170
		171	Example: print the partition descriptor of tghe partition with label DATA.
		172
		173	$ pbcdedit bcd-device /dev/disk/by-label/DATA
		174	partition=<null>,harddisk,mbr,47cbc08a,213579202560
		175
		176	=item C<bcd-legacy-device> F<path>
		177
		178	Like above, but uses a C<legacypartition> descriptor instead.
		179
133	=item objects [--json]	180	=item C<objects> [C<--json>]
134		181
135	Outputs two tables: a table listing all type aliases with their hex bcd	182	Outputs two tables: a table listing all type aliases with their hex BCD
136	element ID, and all object name aliases with their GUID and default type	183	element ID, and all object name aliases with their GUID and default type
137	(if any).	184	(if any).
138		185
139	With C<--json> it prints similar information as a JSON object, for easier parsing.	186	With C<--json> it prints similar information as a JSON object, for easier parsing.
140		187
141	=item elements [--json]	188	=item C<elements> [C<--json>]
142		189
143	Outputs a table of known element aliases with their hex ID and the format	190	Outputs a table of known element aliases with their hex ID and the format
144	type.	191	type.
145		192
146	With C<--json> it prints similar information as a JSON object, for easier parsing.	193	With C<--json> it prints similar information as a JSON object, for easier parsing.
147		194
148	=item export-regf F<path>	195	=item C<export-regf> F<path>
149		196
150	This has nothing to do with BCD data stores - it takes a registry hive	197	This has nothing to do with BCD stores, but simply exposes PCBEDIT's
		198	internal registry hive reader - it takes a registry hive file as argument
151	file as argument and outputs a JSON representation of it to standard	199	and outputs a JSON representation of it to standard output.
152	output.
153		200
154	Hive versions 1.2 till 1.6 are supported.	201	Hive versions 1.2 till 1.6 are supported.
155		202
156	=item import-regf F<path>	203	=item C<import-regf> F<path>
157		204
158	The reverse of C<export-regf>: reads a JSON representation of a registry	205	The reverse of C<export-regf>: reads a JSON representation of a registry
159	hive from standard input and creates or replaces the registry hive file given as	206	hive from standard input and creates or replaces the registry hive file
160	argument.	207	given as argument.
161		208
162	The written hive will always be in a slightly modified version 1.3	209	The written hive will always be in a slightly modified version 1.3
163	format. It's not the format windows would generate, but it should be	210	format. It's not the format windows would generate, but it should be
164	understood by any conformant hive reader.	211	understood by any conformant hive reader.
165		212
166	Note that the representation chosen by PBCDEDIT currently throws away	213	Note that the representation chosen by PBCDEDIT currently throws away
167	clasname data (often used for feeble attemtps at hiding stuff by	214	classname data (often used for feeble attempts at hiding stuff by
168	Microsoft) and security descriptors, so if you write anything other than	215	Microsoft) and security descriptors, so if you write anything other than
169	a BCD hive you will most likely destroy it.	216	a BCD hive you will most likely destroy it.
170		217
171	=back	218	=back
172		219
173		220
174	=head1 BCD DATA STORE REPRESENTATION FORMAT	221	=head1 BCD STORE REPRESENTATION FORMAT
175		222
176	A BCD data store is represented as a JSON object with one special key,	223	A BCD data store is represented as a JSON object with one special key,
177	C<meta>, and one key per BCD object. That is, each BCD object becomes	224	C<meta>, and one key per BCD object. That is, each BCD object becomes
178	one key-value pair in the object, and an additional key called C<meta>	225	one key-value pair in the object, and an additional key called C<meta>
179	contains meta information.	226	contains meta information.
…		…
215	}	262	}
216		263
217	=head2 Minimal BCD to boot windows	264	=head2 Minimal BCD to boot windows
218		265
219	Experimentally I found the following BCD is the minimum required to	266	Experimentally I found the following BCD is the minimum required to
220	successfully boot any post-XP version of Windows (suitable C<device> and	267	successfully boot any post-XP version of Windows (assuming suitable
221	C<osdevice> values, of course):	268	C<device> and C<osdevice> values, of course, and assuming a BIOS boot -
		269	for UEFI, you should use F<winload.efi> instead of F<winload.exe>):
222		270
223	{	271	{
224	"{bootmgr}" : {	272	"{bootmgr}" : {
225	"resumeobject" : "{45b547a7-8ca6-4417-9eb0-a257b61f35b4}"	273	"default" : "{45b547a7-8ca6-4417-9eb0-a257b61f35b4}"
226	},	274	},
227		275
228	"{45b547a7-8ca6-4417-9eb0-a257b61f35b1}" : {	276	"{45b547a7-8ca6-4417-9eb0-a257b61f35b1}" : {
229	"type" : "application::osloader",	277	"type" : "application::osloader",
230	"description" : "Windows Boot",	278	"description" : "Windows Boot",
…		…
242	=head2 The C<meta> key	290	=head2 The C<meta> key
243		291
244	The C<meta> key is not stored in the BCD data store but is used only	292	The C<meta> key is not stored in the BCD data store but is used only
245	by PBCDEDIT. It is always generated when exporting, and importing will	293	by PBCDEDIT. It is always generated when exporting, and importing will
246	be refused when it exists and the version stored inside doesn't store	294	be refused when it exists and the version stored inside doesn't store
247	the JSON schema version of PBCDEDIT. This ensures that differemt and	295	the JSON schema version of PBCDEDIT. This ensures that different and
248	incompatible versions of PBCDEDIT will not read and misinterüret each	296	incompatible versions of PBCDEDIT will not read and misinterpret each
249	others data.	297	others data.
250		298
251	=head2 The object keys	299	=head2 The object keys
252		300
253	Every other key is a BCD object. There is usually a BCD object for the	301	Every other key is a BCD object. There is usually a BCD object for the
254	boot manager, one for every boot option and a few others that store common	302	boot manager, one for every boot option and a few others that store common
255	settings inherited by these.	303	settings inherited by these.
256		304
257	Each BCD object is represented by a GUID wrapped in curly braces. These	305	Each BCD object is represented by a GUID wrapped in curly braces. These
258	are usually random GUIDs used only to distinguish bCD objects from each	306	are usually random GUIDs used only to distinguish BCD objects from each
259	other. When adding a new boot option, you can simply generate a new GUID.	307	other. When adding a new boot option, you can simply generate a new GUID.
260		308
261	Some of these GUIDs are fixed well known GUIDs which PBCDEDIT will decode	309	Some of these GUIDs are fixed well known GUIDs which PBCDEDIT will decode
262	into human-readable strings such as C<{globalsettings}>, which is the same	310	into human-readable strings such as C<{globalsettings}>, which is the same
263	as C<{7ea2e1ac-2e61-4728-aaa3-896d9d0a9f0e}>.	311	as C<{7ea2e1ac-2e61-4728-aaa3-896d9d0a9f0e}>.
…		…
297	get a list of all BCD elements known to PBCDEDIT by running F<pbcdedit	345	get a list of all BCD elements known to PBCDEDIT by running F<pbcdedit
298	elements>.	346	elements>.
299		347
300	What was said about duplicate keys mapping to the same object is true for	348	What was said about duplicate keys mapping to the same object is true for
301	elements as well, so, again, you should always use the canonical name,	349	elements as well, so, again, you should always use the canonical name,
302	whcih is the human radable alias, if known.	350	which is the human readable alias, if known.
303		351
304	=head3 BCD element types	352	=head3 BCD element types
305		353
306	Each BCD element has a type such as I<string> or I<boolean>. This type	354	Each BCD element has a type such as I<string> or I<boolean>. This type
307	determines how the value is interpreted, and most of them are pretty easy	355	determines how the value is interpreted, and most of them are pretty easy
…		…
319	"description" : "Windows 10",	367	"description" : "Windows 10",
320	"systemroot" : "\\Windows",	368	"systemroot" : "\\Windows",
321		369
322	=item boolean	370	=item boolean
323		371
324	Almost as simnple are booleans, which represent I<true>/I<false>,	372	Almost as simple are booleans, which represent I<true>/I<false>,
325	I<on>/I<off> and similar values. In the JSON form, true is represented	373	I<on>/I<off> and similar values. In the JSON form, true is represented
326	by the number C<1>, and false is represented by the number C<0>. Other	374	by the number C<1>, and false is represented by the number C<0>. Other
327	values will be accepted, but PBCDEDIT doesn't guarantee how these are	375	values will be accepted, but PBCDEDIT doesn't guarantee how these are
328	interpreted.	376	interpreted.
329		377
…		…
333		381
334	"displaybootmenu" : 0,	382	"displaybootmenu" : 0,
335		383
336	=item integer	384	=item integer
337		385
338	Again, very simple, this is a 64 bit integer. IT can be either specified	386	Again, very simple, this is a 64 bit integer. It can be either specified
339	as a decimal number, as a hex number (by prefixing it with C<0x>) or as a	387	as a decimal number, as a hex number (by prefixing it with C<0x>) or as a
340	binatry number (prefix C<0b>).	388	binary number (prefix C<0b>).
341		389
342	For example, the boot C<timeout> is an integer, specifying the automatic	390	For example, the boot C<timeout> is an integer, specifying the automatic
343	boot delay in seconds:	391	boot delay in seconds:
344		392
345	"timeout" : 30,	393	"timeout" : 30,
346		394
347	=item integer list	395	=item integer list
348		396
349	This is a list of 64 bit integers separated by whitespace. It is not used	397	This is a list of 64 bit integers separated by whitespace. It is not used
350	much, so here is a somewhat artificial an untested exanmple of using	398	much, so here is a somewhat artificial an untested example of using
351	C<customactions> to specify a certain custom, eh, action to be executed	399	C<customactions> to specify a certain custom, eh, action to be executed
352	when pressing C<F10> at boot:	400	when pressing C<F10> at boot:
353		401
354	"customactions" : "0x1000044000001 0x54000001",	402	"customactions" : "0x1000044000001 0x54000001",
355		403
356	=item guid	404	=item guid
357		405
358	This represents a single GUID value wrqapped in curly braces. It is used a	406	This represents a single GUID value wrapped in curly braces. It is used a
359	lot to refer from one BCD object to other one.	407	lot to refer from one BCD object to other one.
360		408
361	For example, The C<{bootmgr}> object might refer to a resume boot option	409	For example, The C<{bootmgr}> object might refer to a resume boot option
362	using C<resumeobject>:	410	using C<default>:
363		411
364	"resumeobject" : "{7ae02178-821d-11e7-8813-1c872c5f5ab0}",	412	"default" : "{7ae02178-821d-11e7-8813-1c872c5f5ab0}",
365		413
366	Human readable aliases are used and allowed.	414	Human readable aliases are used and allowed.
367		415
368	=item guid list	416	=item guid list
369		417
370	Similar to te guid type, this represents a list of such GUIDs, separated	418	Similar to the GUID type, this represents a list of such GUIDs, separated
371	by whitespace from each other.	419	by whitespace from each other.
372		420
373	For example, many BCD objects can I<inherit> elements from other BCD	421	For example, many BCD objects can I<inherit> elements from other BCD
374	objects by specifying the GUIDs of those other objects ina GUID list	422	objects by specifying the GUIDs of those other objects in a GUID list
375	called surprisingly called C<inherit>:	423	called surprisingly called C<inherit>:
376		424
377	"inherit" : "{dbgsettings} {emssettings} {badmemory}",	425	"inherit" : "{dbgsettings} {emssettings} {badmemory}",
378		426
379	This example also shows how human readable aliases can be used.	427	This example also shows how human readable aliases can be used.
…		…
385	hacks. Understanding this type took more time than writing all the rest of	433	hacks. Understanding this type took more time than writing all the rest of
386	PBCDEDIT, and because it is so complex, this type has its own subsection	434	PBCDEDIT, and because it is so complex, this type has its own subsection
387	below.	435	below.
388	=back	436	=back
389		437
390	=head4 The BCD "device" element type	438	=head3 The BCD "device" element type
391		439
392	Device elements specify, well, devices. They are used for such diverse	440	Device elements specify, well, devices. They are used for such diverse
393	purposes such as finding a TFTP network boot imagem serial ports or VMBUS	441	purposes such as finding a TFTP network boot image, serial ports or VMBUS
394	devices, but most commonly they are used to specify the disk (harddisk,	442	devices, but most commonly they are used to specify the disk (harddisk,
395	cdrom ramdisk, vhd...) to boot from.	443	cdrom, ramdisk, vhd...) to boot from.
396		444
397	The device element is kind of a mini-language in its own which is much	445	The device element is kind of a mini-language in its own which is much
398	more versatile then the limited windows interface to it - BCDEDIT -	446	more versatile then the limited windows interface to it - BCDEDIT -
399	reveals.	447	reveals.
400		448
…		…
403	element, so almost everything known about it had to be researched first	451	element, so almost everything known about it had to be researched first
404	in the process of writing this script, and consequently, support for BCD	452	in the process of writing this script, and consequently, support for BCD
405	device elements is partial only.	453	device elements is partial only.
406		454
407	On the other hand, the expressive power of PBCDEDIT in specifying devices	455	On the other hand, the expressive power of PBCDEDIT in specifying devices
408	is much bigger than BCDEDIT and therefore more cna be don with it. The	456	is much bigger than BCDEDIT and therefore more can be done with it. The
409	downside is that BCD device elements are much more complicated than what	457	downside is that BCD device elements are much more complicated than what
410	you might think from reading the BCDEDIT documentation.	458	you might think from reading the BCDEDIT documentation.
411		459
412	In other words, simple things are complicated, and complicated things are	460	In other words, simple things are complicated, and complicated things are
413	possible.	461	possible.
414		462
415	Anyway, the general syntax of device elements is an optional GUID,	463	Anyway, the general syntax of device elements is an optional GUID,
416	followed by a device type, optionally followed by hexdecimal flags in	464	followed by a device type, optionally followed by hexadecimal flags in
417	angle brackets, optionally followed by C<=> and a comma-separated list of	465	angle brackets, optionally followed by C<=> and a comma-separated list of
418	arguments, some of which can be (and often are) in turn devices again.	466	arguments, some of which can be (and often are) in turn devices again.
419		467
420	[{GUID}]type[<flags>][=arg,arg...]	468	[{GUID}]type[<flags>][=arg,arg...]
421		469
…		…
447	The types understood and used by PBCDEDIT are as follows (keep in mind	495	The types understood and used by PBCDEDIT are as follows (keep in mind
448	that not of all the following is necessarily supported in PBCDEDIT):	496	that not of all the following is necessarily supported in PBCDEDIT):
449		497
450	=over	498	=over
451		499
452	=item binary=hex...	500	=item C<binary=>I<hex...>
453		501
454	This type isn't actually a real BCD element type, but a fallback for those	502	This type isn't actually a real BCD element type, but a fallback for those
455	cases where PBCDEDIT can't perfectly decode a device element (except for	503	cases where PBCDEDIT can't perfectly decode a device element (except for
456	the leading GUID, which it can always decode). In such cases, it will	504	the leading GUID, which it can always decode). In such cases, it will
457	convert the device into this type with a hexdump of the element data.	505	convert the device into this type with a hexdump of the element data.
458		506
459	=item null	507	=item C<null>
460		508
461	This is another special type - sometimes, a device all zero-filled, which	509	This is another special type - sometimes, a device is all zero-filled,
462	is not valid. This can mark the absence of a device or something PBCDEDIT	510	which is not valid. This can mark the absence of a device or something
463	does not understand, so it decodes it into this special "all zero" type	511	PBCDEDIT does not understand, so it decodes it into this special "all
464	called C<null>.	512	zero" type called C<null>.
465		513
466	It's most commonly found in devices that can use an optional parent	514	It's most commonly found in devices that can use an optional parent
467	device, when no parent device is used.	515	device, when no parent device is used.
468		516
469	=item boot	517	=item C<boot>
470		518
471	Another type without parameters, this refers to the device that was booted	519	Another type without parameters, this refers to the device that was booted
472	from (nowadays typically the EFI system partition).	520	from (nowadays typically the EFI system partition).
473		521
474	=item vmbus=interfacetype,interfaceinstance	522	=item C<vmbus=>I<interfacetype>,I<interfaceinstance>
475		523
476	This specifies a VMBUS device with the given interface type and interface	524	This specifies a VMBUS device with the given interface type and interface
477	instance, both of which are "naked" (no curly braces) GUIDs.	525	instance, both of which are "naked" (no curly braces) GUIDs.
478		526
479	Made-up example (couldn't find a single example on the web):	527	Made-up example (couldn't find a single example on the web):
480		528
481	vmbus=c376c1c3-d276-48d2-90a9-c04748072c60,12345678-a234-b234-c234-d2345678abcd	529	vmbus=c376c1c3-d276-48d2-90a9-c04748072c60,12345678-a234-b234-c234-d2345678abcd
482		530
483	=item partition=<parent>,devicetype,partitiontype,diskid,partitionid	531	=item C<partition=><I<parent>>,I<devicetype>,I<partitiontype>,I<diskid>,I<partitionid>
484		532
485	This designates a specific partition on a block device. C<< <parent>	533	This designates a specific partition on a block device. I<parent> is an
486	>> is an optional parent device on which to search on, and is often	534	optional parent device on which to search on, and is often C<null>. Note
487	C<null>. Note that the anfgle brackets are part of the syntax.	535	that the angle brackets around I<parent> are part of the syntax.
488		536
489	C<devicetypes> is one of C<harddisk>, C<floppy>, C<cdrom>, C<ramdisk>,	537	I<devicetypes> is one of C<harddisk>, C<floppy>, C<cdrom>, C<ramdisk>,
490	C<file> or C<vhd>, where the first three should be self-explaining,	538	C<file> or C<vhd>, where the first three should be self-explaining,
491	C<file> is usually used to locate a device by finding a magic file, and	539	C<file> is usually used to locate a file to be used as a disk image,
492	C<vhd> is used for virtual harddisks - F<.vhd> and F<-vhdx> files.	540	and C<vhd> is used to treat files as virtual harddisks, i.e. F<vhd> and
		541	F<vhdx> files.
493		542
494	The C<partitiontype> is either C<mbr>, C<gpt> or C<raw>, the latter being	543	The I<partitiontype> is either C<mbr>, C<gpt> or C<raw>, the latter being
495	used for devices without partitions, such as cdroms, where the "partition"	544	used for devices without partitions, such as cdroms, where the "partition"
496	is usually the whole device.	545	is usually the whole device.
497		546
498	The C<diskid> identifies the disk or device using a unique signature, and	547	The I<diskid> identifies the disk or device using a unique signature, and
499	the same is true for the C<partitionid>. How these are interpreted depends	548	the same is true for the I<partitionid>. How these are interpreted depends
500	on the C<partitiontype>:	549	on the I<partitiontype>:
501		550
502	=over	551	=over
503		552
504	=item mbr	553	=item C<mbr>
505		554
506	The C<diskid> is the 32 bit disk signature stored at offset 0x1b8 in the	555	The C<diskid> is the 32 bit disk signature stored at offset 0x1b8 in the
507	MBR, interpreted as a 32 bit unsigned little endian integer and written as	556	MBR, interpreted as a 32 bit unsigned little endian integer and written as
508	hex number. That is, the bytes C<01 02 03 04> would become C<04030201>.	557	hex number. That is, the bytes C<01 02 03 04> would become C<04030201>.
509		558
510	Diskpart (using the C<DETAIL> command) and the C<lsblk> comamnd typically	559	Diskpart (using the C<DETAIL> command) and the C<lsblk> command typically
511	found on GNU/Linux systems (using e.g. C<lsblk -o NAME,PARTUUID>) can	560	found on GNU/Linux systems (using e.g. C<lsblk -o NAME,PARTUUID>) can
512	display the disk id.	561	display the I<diskid>.
513		562
514	The C<partitionid> is the byte offset(!) of the partition counting from	563	The I<partitionid> is the byte offset(!) of the partition counting from
515	the beginning of the MBR.	564	the beginning of the MBR.
516		565
517	Example, use the partition on the harddisk with C<diskid> C<47cbc08a>	566	Example, use the partition on the harddisk with I<diskid> C<47cbc08a>
518	starting at sector C<2048> (= 1048576 / 512).	567	starting at sector C<2048> (= 1048576 / 512).
519		568
520	partition=<null>,harddisk,mbr,47cbc08a,1048576	569	partition=<null>,harddisk,mbr,47cbc08a,1048576
521		570
522	=item gpt	571	=item C<gpt>
523		572
524	The C<diskid> is the disk UUID/disk identifier GUID from the partition	573	The I<diskid> is the disk GUID/disk identifier GUID from the partition
525	table (as displayed e.g. by C<gdisk>), and the C<partitionid> is the	574	table (as displayed e.g. by F<gdisk>), and the I<partitionid> is the
526	partition unique GUID (displayed using e.g. the C<gdisk> C<i> command).	575	partition unique GUID (displayed using e.g. the F<gdisk> F<i> command).
527		576
528	Example: use the partition C<76d39e5f-ad1b-407e-9c05-c81eb83b57dd> on GPT	577	Example: use the partition C<76d39e5f-ad1b-407e-9c05-c81eb83b57dd> on GPT
529	disk C<9742e468-9206-48a0-b4e4-c4e9745a356a>.	578	disk C<9742e468-9206-48a0-b4e4-c4e9745a356a>.
530		579
531	partition=<null>,harddisk,gpt,9742e468-9206-48a0-b4e4-c4e9745a356a,76d39e5f-ad1b-407e-9c05-c81eb83b57dd	580	partition=<null>,harddisk,gpt,9742e468-9206-48a0-b4e4-c4e9745a356a,76d39e5f-ad1b-407e-9c05-c81eb83b57dd
532		581
533	=item raw	582	=item C<raw>
534		583
535	Instead of diskid and partitionid, this type only accepts a decimal disk	584	Instead of I<diskid> and I<partitionid>, this type only accepts a decimal
536	number and signifies the whole disk. BCDEDIT cannot display the resulting	585	disk number and signifies the whole disk. BCDEDIT cannot display the
537	device, and I am doubtful whether it has a useful effect.	586	resulting device, and I am doubtful whether it has a useful effect.
538		587
539	=back	588	=back
540		589
541	=item legacypartition=<parent>,devicetype,partitiontype,diskid,partitionid	590	=item C<legacypartition=><I<parent>>,I<devicetype>,I<partitiontype>,I<diskid>,I<partitionid>
542		591
543	This is exactly the same as the C<partition> type, except for a tiny	592	This is exactly the same as the C<partition> type, except for a tiny
544	detail: instead of using the partition start offset, this type uses the	593	detail: instead of using the partition start offset, this type uses the
545	partition number for MBR disks. Behaviour other partition types should be	594	partition number for MBR disks. Behaviour other partition types should be
546	the same.	595	the same.
547		596
548	The partition number starts at C<1> and skips unused partition, so if	597	The partition number starts at C<1> and skips unused partition, so if
549	there are two primary partitions and another partition inside the extended	598	there are two primary partitions and another partition inside the extended
550	partition, the primary partitions are number C<1> and C<2> and the	599	partition, the primary partitions are number C<1> and C<2> and the
551	partition inside the extended partition is number C<3>, rwegardless of any	600	partition inside the extended partition is number C<3>, regardless of any
552	gaps.	601	gaps.
553		602
554	=item locate=<parent>,locatetype,locatearg	603	=item C<locate=><I<parent>>,I<locatetype>,I<locatearg>
555		604
556	This device description will make the bootloader search for a partition	605	This device description will make the bootloader search for a partition
557	with a given path.	606	with a given path.
558		607
559	The C<< <parent> >> device is the device to search on (angle brackets are	608	The I<parent> device is the device to search on (angle brackets are
560	still part of the syntax!) If it is C<< <null> >>, then C<locate> will	609	still part of the syntax!) If it is C<null>, then C<locate> will
561	search all disks it can find.	610	search all disks it can find.
562		611
563	C<locatetype> is either C<element> or C<path>, and merely distinguishes	612	I<locatetype> is either C<element> or C<path>, and merely distinguishes
564	between two different ways to specify the path to search for: C<element>	613	between two different ways to specify the path to search for: C<element>
565	uses an element ID (either as hex or as name) as C<locatearg> and C<path>	614	uses an element ID (either as hex or as name) as I<locatearg> and C<path>
566	uses a relative path as C<locatearg>.	615	uses a relative path as I<locatearg>.
567		616
568	Example: find any partition which has the C<magicfile.xxx> path in the	617	Example: find any partition which has the F<magicfile.xxx> path in the
569	root.	618	root.
570		619
571	locate=<null>,path,\magicfile.xxx	620	locate=<null>,path,\magicfile.xxx
572		621
573	Example: find any partition which has the path specified in the	622	Example: find any partition which has the path specified in the
574	C<systemroot> element (typically C<\Windows>).	623	C<systemroot> element (typically F<\Windows>).
575		624
576	locate=<null>,element,systemroot	625	locate=<null>,element,systemroot
577		626
578	=item block=devicetype,args...	627	=item C<block=>I<devicetype>,I<args...>
579		628
580	Last not least, the most complex type, C<block>, which... specifies block	629	Last not least, the most complex type, C<block>, which... specifies block
581	devices (which could be inside a F<vhdx> file for example).	630	devices (which could be inside a F<vhdx> file for example).
582		631
583	C<devicetypes> is one of C<harddisk>, C<floppy>, C<cdrom>, C<ramdisk>,	632	I<devicetypes> is one of C<harddisk>, C<floppy>, C<cdrom>, C<ramdisk>,
584	C<file> or C<vhd> - the same as for C<partiion=>.	633	C<file> or C<vhd> - the same as for C<partition=>.
585		634
586	The remaining arguments change depending on the C<devicetype>:	635	The remaining arguments change depending on the I<devicetype>:
587		636
588	=over	637	=over
589		638
590	=item block=file,<parent>,path	639	=item C<block=file>,<I<parent>>,I<path>
591		640
592	Interprets the C<< <parent> >> device (typically a partition) as a	641	Interprets the I<parent> device (typically a partition) as a
593	filesystem and specifies a file path inside.	642	filesystem and specifies a file path inside.
594		643
595	=item block=vhd,<parent>	644	=item C<block=vhd>,<I<parent>>
596		645
597	Pretty much just changes the interpretation of C<< <parent> >>, which is	646	Pretty much just changes the interpretation of I<parent>, which is
598	usually a disk image (C<block=file,...)>) to be a F<vhd> or F<vhdx> file.	647	usually a disk image (C<block=file,...)>) to be a F<vhd> or F<vhdx> file.
599		648
600	=item block=ramdisk,<parent>,base,size,offset,path	649	=item C<block=ramdisk>,<I<parent>>,I<base>,I<size>,I<offset>,I<path>
601		650
602	Interprets the C<< <parent> >> device as RAM disk, using the (decimal)	651	Interprets the I<parent> device as RAM disk, using the (decimal)
603	base address, byte size and byte offset inside a file specified by	652	base address, byte size and byte offset inside a file specified by
604	C<path>. The numbers are usually all C<0> because they cna be extracted	653	I<path>. The numbers are usually all C<0> because they can be extracted
605	from the RAM disk image or other parameters.	654	from the RAM disk image or other parameters.
606		655
607	This is most commonly used to boot C<wim> images.	656	This is most commonly used to boot C<wim> images.
608		657
609	=item block=floppy,drivenum	658	=item C<block=floppy>,I<drivenum>
610		659
611	Refers to a removable drive identified by a number. BCDEDIT cannot display	660	Refers to a removable drive identified by a number. BCDEDIT cannot display
612	the resultinfg device, and it is not clear what effect it will have.	661	the resulting device, and it is not clear what effect it will have.
613		662
614	=item block=cdrom,drivenum	663	=item C<block=cdrom>,I<drivenum>
615		664
616	Pretty much the same as C<floppy> but for CD-ROMs.	665	Pretty much the same as C<floppy> but for CD-ROMs.
617		666
618	=item anything else	667	=item anything else
619		668
620	Probably not yet implemented. Tell me of your needs...	669	Probably not yet implemented. Tell me of your needs...
621		670
622	=back	671	=back
623		672
624	=back5 Examples	673	=head4 Examples
625		674
626	This concludes the syntax overview for device elements, but probably	675	This concludes the syntax overview for device elements, but probably
627	leaves many questions open. I can't help with most of them, as I also ave	676	leaves many questions open. I can't help with most of them, as I also have
628	many questions, but I can walk you through some actual examples using mroe	677	many questions, but I can walk you through some actual examples using more
629	complex aspects.	678	complex aspects.
630		679
631	=item locate=<block=vhd,<block=file,<locate=<null>,path,\disk.vhdx>,\disk.vhdx>>,element,path	680	=item C<< locate=<block=vhd,<block=file,<locate=<null>,path,\disk.vhdx>,\disk.vhdx>>,element,path >>
632		681
633	Just like with C declarations, you best treat device descriptors as	682	Just like with C declarations, you best treat device descriptors as
634	instructions to find your device and work your way from the inside out:	683	instructions to find your device and work your way from the inside out:
635		684
636	locate=<null>,path,\disk.vhdx	685	locate=<null>,path,\disk.vhdx
…		…
643	Next, this takes the device locate has found and finds a file called	692	Next, this takes the device locate has found and finds a file called
644	F<\disk.vhdx> on it. This is the same file locate was using, but that is	693	F<\disk.vhdx> on it. This is the same file locate was using, but that is
645	only because we find the device using the same path as finding the disk	694	only because we find the device using the same path as finding the disk
646	image, so this is purely incidental, although quite common.	695	image, so this is purely incidental, although quite common.
647		696
648	Bext, this file will be opened as a virtual disk:	697	Next, this file will be opened as a virtual disk:
649		698
650	block=vhd,<see above>	699	block=vhd,<see above>
651		700
652	And finally, inside this disk, another C<locate> will look for a partition	701	And finally, inside this disk, another C<locate> will look for a partition
653	with a path as specified in the C<path> element, which most likely will be	702	with a path as specified in the C<path> element, which most likely will be
…		…
656	locate=<see above>,element,path	705	locate=<see above>,element,path
657		706
658	As a result, this will boot the first Windows it finds on the first	707	As a result, this will boot the first Windows it finds on the first
659	F<disk.vhdx> disk image it can find anywhere.	708	F<disk.vhdx> disk image it can find anywhere.
660		709
661	=item locate=<block=vhd,<block=file,<partition=<null>,harddisk,mbr,47cbc08a,242643632128>,\win10.vhdx>>,element,path	710	=item C<< locate=<block=vhd,<block=file,<partition=<null>,harddisk,mbr,47cbc08a,242643632128>,\win10.vhdx>>,element,path >>
662		711
663	Pretty much the same as the previous case, but witzh a bit of variance. First, look for a specific partition on	712	Pretty much the same as the previous case, but with a bit of
664	an MBR-partitioned disk:	713	variance. First, look for a specific partition on an MBR-partitioned disk:
665		714
666	partition=<null>,harddisk,mbr,47cbc08a,242643632128	715	partition=<null>,harddisk,mbr,47cbc08a,242643632128
667		716
668	Then open the file F<\win10.vhdx> on that partition:	717	Then open the file F<\win10.vhdx> on that partition:
669		718
…		…
675		724
676	And again the windows loader (or whatever is in C<path>) will be searched:	725	And again the windows loader (or whatever is in C<path>) will be searched:
677		726
678	locate=<see above>,element,path	727	locate=<see above>,element,path
679		728
680	=item {b097d2b2-bc00-11e9-8a9a-525400123456}block<1>=ramdisk,<partition=<null>,harddisk,mbr,47cbc08a,242643632128>,0,0,0,\boot.wim	729	=item C<< {b097d2b2-bc00-11e9-8a9a-525400123456}block<1>=ramdisk,<partition=<null>,harddisk,mbr,47cbc08a,242643632128>,0,0,0,\boot.wim >>
681		730
682	This is quite different. First, it starts with a GUID. This GUID belongs	731	This is quite different. First, it starts with a GUID. This GUID belongs
683	to a BCD object of type C<device>, which has additional parameters:	732	to a BCD object of type C<device>, which has additional parameters:
684		733
685	"{b097d2b2-bc00-11e9-8a9a-525400123456}" : {	734	"{b097d2b2-bc00-11e9-8a9a-525400123456}" : {
…		…
688	"ramdisksdidevice" : "partition=<null>,harddisk,mbr,47cbc08a,1048576",	737	"ramdisksdidevice" : "partition=<null>,harddisk,mbr,47cbc08a,1048576",
689	"ramdisksdipath" : "\boot.sdi"	738	"ramdisksdipath" : "\boot.sdi"
690	},	739	},
691		740
692	I will not go into many details, but this specifies a (presumably empty)	741	I will not go into many details, but this specifies a (presumably empty)
693	template ramdisk image (F<\boot.sdi>) that is used to initiaolize the	742	template ramdisk image (F<\boot.sdi>) that is used to initialize the
694	ramdisk. The F<\boot.wim> file is then extracted into it. As you cna also	743	ramdisk. The F<\boot.wim> file is then extracted into it. As you can also
695	see, this F<.sdi> file resides on a different C<partition>.	744	see, this F<.sdi> file resides on a different C<partition>.
696		745
697	Continuitn, as always, form the inside out, first this device descriptor	746	Continuing, as always, from the inside out, first this device descriptor
698	finds a specific partition:	747	finds a specific partition:
699		748
700	partition=<null>,harddisk,mbr,47cbc08a,242643632128	749	partition=<null>,harddisk,mbr,47cbc08a,242643632128
701		750
702	And then specifies a C<ramdisk> image on this partition:	751	And then specifies a C<ramdisk> image on this partition:
…		…
707	seems to be always there on this kind of entry.	756	seems to be always there on this kind of entry.
708		757
709	If you have some good examples to add here, feel free to mail me.	758	If you have some good examples to add here, feel free to mail me.
710		759
711		760
712	=head1 EDITING BCD DATA STORES	761	=head1 EDITING BCD STORES
713		762
714	The C<edit> and C<parse> subcommands allow you to read a BCD data store	763	The C<edit> and C<parse> subcommands allow you to read a BCD data store
715	and modify it or extract data from it. This is done by exyecuting a series	764	and modify it or extract data from it. This is done by executing a series
716	of "editing instructions" which are explained here.	765	of "editing instructions" which are explained here.
717		766
718	=over	767	=over
719		768
720	=item get I<object> I<element>	769	=item C<get> I<object> I<element>
721		770
722	Reads the BCD element I<element> from the BCD object I<object> and writes	771	Reads the BCD element I<element> from the BCD object I<object> and writes
723	it to standard output, followed by a newline. The I<object> can be a GUID	772	it to standard output, followed by a newline. The I<object> can be a GUID
724	or a human-readable alias, or the special string C<{default}>, which will	773	or a human-readable alias, or the special string C<{default}>, which will
725	refer to the default BCD object.	774	refer to the default BCD object.
726		775
727	Example: find description of the default BCD object.	776	Example: find description of the default BCD object.
728		777
729	pbcdedit parse BCD get "{default}" description	778	pbcdedit parse BCD get "{default}" description
730		779
731	=item set I<object> I<element> I<value>	780	=item C<set> I<object> I<element> I<value>
732		781
733	Similar to C<get>, but sets the element to the given I<value> instead.	782	Similar to C<get>, but sets the element to the given I<value> instead.
734		783
735	Example: change bootmgr default too	784	Example: change the bootmgr default too
736	C<{b097d2ad-bc00-11e9-8a9a-525400123456}>:	785	C<{b097d2ad-bc00-11e9-8a9a-525400123456}>:
737		786
738	pbcdedit edit BCD set "{bootmgr}" resumeobject "{b097d2ad-bc00-11e9-8a9a-525400123456}"	787	pbcdedit edit BCD set "{bootmgr}" default "{b097d2ad-bc00-11e9-8a9a-525400123456}"
739		788
740	=item eval I<perlcode>	789	=item C<eval> I<perlcode>
741		790
742	This takes the next argument, interprets it as Perl code and	791	This takes the next argument, interprets it as Perl code and
743	evaluates it. This allows you to do more complicated modifications or	792	evaluates it. This allows you to do more complicated modifications or
744	extractions.	793	extractions.
745		794
…		…
764	The example given for C<get>, above, could be expressed like this with	813	The example given for C<get>, above, could be expressed like this with
765	C<eval>:	814	C<eval>:
766		815
767	pbcdedit edit BCD eval 'say $BCD->{$DEFAULT}{description}'	816	pbcdedit edit BCD eval 'say $BCD->{$DEFAULT}{description}'
768		817
769	The example given for C<set> could be expresed like this:	818	The example given for C<set> could be expressed like this:
770		819
771	pbcdedit edit BCD eval '$BCD->{$DEFAULT}{resumeobject} = "{b097d2ad-bc00-11e9-8a9a-525400123456}"'	820	pbcdedit edit BCD eval '$BCD->{"{bootmgr}"{default} = "{b097d2ad-bc00-11e9-8a9a-525400123456}"'
772		821
773	=item do I<path>	822	=item C<do> I<path>
774		823
775	Similar to C<eval>, above, but instead of using the argument as perl code,	824	Similar to C<eval>, above, but instead of using the argument as perl code,
776	it loads the perl code from the given file and executes it. This makes it	825	it loads the perl code from the given file and executes it. This makes it
777	easier to write more complicated or larger programs.	826	easier to write more complicated or larger programs.
778		827
779	=back	828	=back
780		829
		830
781	=head1 SEE ALSO	831	=head1 SEE ALSO
782		832
783	For ideas on what you can do, and some introductory material, try	833	For ideas on what you can do with BCD stores in
		834	general, and some introductory material, try
784	L<http://www.mistyprojects.co.uk/documents/BCDEdit/index.html>.	835	L<http://www.mistyprojects.co.uk/documents/BCDEdit/index.html>.
785		836
786	For good reference on BCD objects and elements, see Geoff Chappels pages	837	For good reference on which BCD objects and
		838	elements exist, see Geoff Chappell's pages at
787	at L<http://www.geoffchappell.com/notes/windows/boot/bcd/index.htm>.	839	L<http://www.geoffchappell.com/notes/windows/boot/bcd/index.htm>.
788		840
789	=head1 AUTHOR	841	=head1 AUTHOR
790		842
791	Written by Marc A. Lehmann <pbcdedit@schmorp.de>.	843	Written by Marc A. Lehmann L<pbcdedit@schmorp.de>.
792		844
793	=head1 REPORTING BUGS	845	=head1 REPORTING BUGS
794		846
795	Bugs can be reported dorectly tt he author at L<pcbedit@schmorp.de>.	847	Bugs can be reported directly the author at L<pcbedit@schmorp.de>.
796		848
797	=head1 BUGS AND SHORTCOMINGS	849	=head1 BUGS AND SHORTCOMINGS
798		850
799	This should be a module. Of a series of modules, even.	851	This should be a module. Of a series of modules, even.
800		852
801	Registry code should preserve classname and security descriptor data, and	853	Registry code should preserve classname and security descriptor data, and
802	whatever else is necessary to read and write any registry hive file.	854	whatever else is necessary to read and write any registry hive file.
803		855
804	I am also not happy with device descriptors being strings rather than a	856	I am also not happy with device descriptors being strings rather than a
805	data structure, but strings are probably better for command line usage. In	857	data structure, but strings are probably better for command line usage. In
806	any case,. device descriptors could be converted by simply "splitting" at	858	any case, device descriptors could be converted by simply "splitting" at
807	"=" and "," into an array reference, recursively.	859	"=" and "," into an array reference, recursively.
808		860
809	=head1 HOMEPAGE	861	=head1 HOMEPAGE
810		862
811	Original versions of this program can be found at	863	Original versions of this program can be found at
…		…
818	free to change and redistribute it. There is NO WARRANTY, to the extent	870	free to change and redistribute it. There is NO WARRANTY, to the extent
819	permitted by law.	871	permitted by law.
820		872
821	=cut	873	=cut
822		874
823	BEGIN { require "common/sense.pm"; common::sense->import } # common sense is optional, but recommended	875	# common sense is optional, but recommended
		876	BEGIN { eval { require "common/sense.pm"; } && common::sense->import }
824		877
825	use Data::Dump;	878	no warnings 'portable'; # avoid 32 bit integer warnings
		879
826	use Encode ();	880	use Encode ();
827	use List::Util ();	881	use List::Util ();
828	use IO::Handle ();	882	use IO::Handle ();
829	use Time::HiRes ();	883	use Time::HiRes ();
830		884
…		…
853	or die "$path: short read\n";	907	or die "$path: short read\n";
854		908
855	$buf	909	$buf
856	}	910	}
857		911
858	# sources and resources used for this:	912	# sources and resources used for writing pbcdedit
		913	#
859	# registry:	914	# registry:
860	# https://github.com/msuhanov/regf/blob/master/Windows%20registry%20file%20format%20specification.md	915	# https://github.com/msuhanov/regf/blob/master/Windows%20registry%20file%20format%20specification.md
861	# http://amnesia.gtisc.gatech.edu/~moyix/suzibandit.ltd.uk/MSc/	916	# http://amnesia.gtisc.gatech.edu/~moyix/suzibandit.ltd.uk/MSc/
862	# bcd:	917	# bcd:
863	# http://www.geoffchappell.com/notes/windows/boot/bcd/index.htm	918	# http://www.geoffchappell.com/notes/windows/boot/bcd/index.htm
…		…
1351	sub BCDE_FORMAT_GUID_LIST () { 0x04000000 }	1406	sub BCDE_FORMAT_GUID_LIST () { 0x04000000 }
1352	sub BCDE_FORMAT_INTEGER () { 0x05000000 }	1407	sub BCDE_FORMAT_INTEGER () { 0x05000000 }
1353	sub BCDE_FORMAT_BOOLEAN () { 0x06000000 }	1408	sub BCDE_FORMAT_BOOLEAN () { 0x06000000 }
1354	sub BCDE_FORMAT_INTEGER_LIST () { 0x07000000 }	1409	sub BCDE_FORMAT_INTEGER_LIST () { 0x07000000 }
1355		1410
1356	sub dec_device;
1357	sub enc_device;
1358
1359	sub enc_integer($) {	1411	sub enc_integer($) {
1360	no warnings 'portable'; # ugh
1361	my $value = shift;	1412	my $value = shift;
1362	$value = oct $value if $value =~ /^0[bBxX]/;	1413	$value = oct $value if $value =~ /^0[bBxX]/;
1363	unpack "H*", pack "Q<", $value	1414	unpack "H*", pack "Q<", $value
1364	}	1415	}
		1416
		1417	sub enc_device($$);
		1418	sub dec_device($$);
1365		1419
1366	our %bcde_dec = (	1420	our %bcde_dec = (
1367	BCDE_FORMAT_DEVICE , \&dec_device,	1421	BCDE_FORMAT_DEVICE , \&dec_device,
1368	# # for round-trip verification	1422	# # for round-trip verification
1369	# BCDE_FORMAT_DEVICE , sub {	1423	# BCDE_FORMAT_DEVICE , sub {
…		…
1379	BCDE_FORMAT_BOOLEAN , sub { shift eq "00" ? 0 : 1 },	1433	BCDE_FORMAT_BOOLEAN , sub { shift eq "00" ? 0 : 1 },
1380	BCDE_FORMAT_INTEGER_LIST, sub { join " ", unpack "Q*", pack "H*", shift }, # not sure if this cna be 4 bytes	1434	BCDE_FORMAT_INTEGER_LIST, sub { join " ", unpack "Q*", pack "H*", shift }, # not sure if this cna be 4 bytes
1381	);	1435	);
1382		1436
1383	our %bcde_enc = (	1437	our %bcde_enc = (
1384	BCDE_FORMAT_DEVICE , sub { binary => enc_device shift },	1438	BCDE_FORMAT_DEVICE , sub { binary => enc_device $_[0], $_[1] },
1385	BCDE_FORMAT_STRING , sub { sz => shift },	1439	BCDE_FORMAT_STRING , sub { sz => shift },
1386	BCDE_FORMAT_GUID , sub { sz => "{" . (dec_guid enc_wguid shift) . "}" },	1440	BCDE_FORMAT_GUID , sub { sz => "{" . (dec_guid enc_wguid shift) . "}" },
1387	BCDE_FORMAT_GUID_LIST , sub { multi_sz => [map "{" . (dec_guid enc_wguid $_) . "}", split /\s+/, shift ] },	1441	BCDE_FORMAT_GUID_LIST , sub { multi_sz => [map "{" . (dec_guid enc_wguid $_) . "}", split /\s+/, shift ] },
1388	BCDE_FORMAT_INTEGER , sub { binary => enc_integer shift },	1442	BCDE_FORMAT_INTEGER , sub { binary => enc_integer shift },
1389	BCDE_FORMAT_BOOLEAN , sub { binary => shift ? "01" : "00" },	1443	BCDE_FORMAT_BOOLEAN , sub { binary => shift ? "01" : "00" },
1390	BCDE_FORMAT_INTEGER_LIST, sub { binary => join "", map enc_integer $_, split /\s+/, shift },	1444	BCDE_FORMAT_INTEGER_LIST, sub { binary => join "", map enc_integer $_, split /\s+/, shift },
1391	);	1445	);
1392		1446
1393	# BCD Elements	1447	# BCD Elements
1394	our %bcde = (	1448	our %bcde_byclass = (
		1449	any => {
1395	0x11000001 => 'device',	1450	0x11000001 => 'device',
1396	0x12000002 => 'path',	1451	0x12000002 => 'path',
1397	0x12000004 => 'description',	1452	0x12000004 => 'description',
1398	0x12000005 => 'locale',	1453	0x12000005 => 'locale',
1399	0x14000006 => 'inherit',	1454	0x14000006 => 'inherit',
1400	0x15000007 => 'truncatememory',	1455	0x15000007 => 'truncatememory',
1401	0x14000008 => 'recoverysequence',	1456	0x14000008 => 'recoverysequence',
1402	0x16000009 => 'recoveryenabled',	1457	0x16000009 => 'recoveryenabled',
1403	0x1700000a => 'badmemorylist',	1458	0x1700000a => 'badmemorylist',
1404	0x1600000b => 'badmemoryaccess',	1459	0x1600000b => 'badmemoryaccess',
1405	0x1500000c => 'firstmegabytepolicy',	1460	0x1500000c => 'firstmegabytepolicy',
1406	0x1500000d => 'relocatephysical',	1461	0x1500000d => 'relocatephysical',
1407	0x1500000e => 'avoidlowmemory',	1462	0x1500000e => 'avoidlowmemory',
1408	0x1600000f => 'traditionalkseg',	1463	0x1600000f => 'traditionalkseg',
1409	0x16000010 => 'bootdebug',	1464	0x16000010 => 'bootdebug',
1410	0x15000011 => 'debugtype',	1465	0x15000011 => 'debugtype',
1411	0x15000012 => 'debugaddress',	1466	0x15000012 => 'debugaddress',
1412	0x15000013 => 'debugport',	1467	0x15000013 => 'debugport',
1413	0x15000014 => 'baudrate',	1468	0x15000014 => 'baudrate',
1414	0x15000015 => 'channel',	1469	0x15000015 => 'channel',
1415	0x12000016 => 'targetname',	1470	0x12000016 => 'targetname',
1416	0x16000017 => 'noumex',	1471	0x16000017 => 'noumex',
1417	0x15000018 => 'debugstart',	1472	0x15000018 => 'debugstart',
1418	0x12000019 => 'busparams',	1473	0x12000019 => 'busparams',
1419	0x1500001a => 'hostip',	1474	0x1500001a => 'hostip',
1420	0x1500001b => 'port',	1475	0x1500001b => 'port',
1421	0x1600001c => 'dhcp',	1476	0x1600001c => 'dhcp',
1422	0x1200001d => 'key',	1477	0x1200001d => 'key',
1423	0x1600001e => 'vm',	1478	0x1600001e => 'vm',
1424	0x16000020 => 'bootems',	1479	0x16000020 => 'bootems',
1425	0x15000022 => 'emsport',	1480	0x15000022 => 'emsport',
1426	0x15000023 => 'emsbaudrate',	1481	0x15000023 => 'emsbaudrate',
1427	0x12000030 => 'loadoptions',	1482	0x12000030 => 'loadoptions',
1428	0x16000040 => 'advancedoptions',	1483	0x16000040 => 'advancedoptions',
1429	0x16000041 => 'optionsedit',	1484	0x16000041 => 'optionsedit',
1430	0x15000042 => 'keyringaddress',	1485	0x15000042 => 'keyringaddress',
1431	0x11000043 => 'bootstatdevice',	1486	0x11000043 => 'bootstatdevice',
1432	0x12000044 => 'bootstatfilepath',	1487	0x12000044 => 'bootstatfilepath',
1433	0x16000045 => 'preservebootstat',	1488	0x16000045 => 'preservebootstat',
1434	0x16000046 => 'graphicsmodedisabled',	1489	0x16000046 => 'graphicsmodedisabled',
1435	0x15000047 => 'configaccesspolicy',	1490	0x15000047 => 'configaccesspolicy',
1436	0x16000048 => 'nointegritychecks',	1491	0x16000048 => 'nointegritychecks',
1437	0x16000049 => 'testsigning',	1492	0x16000049 => 'testsigning',
1438	0x1200004a => 'fontpath',	1493	0x1200004a => 'fontpath',
1439	0x1500004b => 'integrityservices',	1494	0x1500004b => 'integrityservices',
1440	0x1500004c => 'volumebandid',	1495	0x1500004c => 'volumebandid',
1441	0x16000050 => 'extendedinput',	1496	0x16000050 => 'extendedinput',
1442	0x15000051 => 'initialconsoleinput',	1497	0x15000051 => 'initialconsoleinput',
1443	0x15000052 => 'graphicsresolution',	1498	0x15000052 => 'graphicsresolution',
1444	0x16000053 => 'restartonfailure',	1499	0x16000053 => 'restartonfailure',
1445	0x16000054 => 'highestmode',	1500	0x16000054 => 'highestmode',
1446	0x16000060 => 'isolatedcontext',	1501	0x16000060 => 'isolatedcontext',
1447	0x15000065 => 'displaymessage',	1502	0x15000065 => 'displaymessage',
1448	0x15000066 => 'displaymessageoverride',	1503	0x15000066 => 'displaymessageoverride',
1449	0x16000068 => 'nobootuxtext',	1504	0x16000068 => 'nobootuxtext',
1450	0x16000069 => 'nobootuxprogress',	1505	0x16000069 => 'nobootuxprogress',
1451	0x1600006a => 'nobootuxfade',	1506	0x1600006a => 'nobootuxfade',
1452	0x1600006b => 'bootuxreservepooldebug',	1507	0x1600006b => 'bootuxreservepooldebug',
1453	0x1600006c => 'bootuxdisabled',	1508	0x1600006c => 'bootuxdisabled',
1454	0x1500006d => 'bootuxfadeframes',	1509	0x1500006d => 'bootuxfadeframes',
1455	0x1600006e => 'bootuxdumpstats',	1510	0x1600006e => 'bootuxdumpstats',
1456	0x1600006f => 'bootuxshowstats',	1511	0x1600006f => 'bootuxshowstats',
1457	0x16000071 => 'multibootsystem',	1512	0x16000071 => 'multibootsystem',
1458	0x16000072 => 'nokeyboard',	1513	0x16000072 => 'nokeyboard',
1459	0x15000073 => 'aliaswindowskey',	1514	0x15000073 => 'aliaswindowskey',
1460	0x16000074 => 'bootshutdowndisabled',	1515	0x16000074 => 'bootshutdowndisabled',
1461	0x15000075 => 'performancefrequency',	1516	0x15000075 => 'performancefrequency',
1462	0x15000076 => 'securebootrawpolicy',	1517	0x15000076 => 'securebootrawpolicy',
1463	0x17000077 => 'allowedinmemorysettings',	1518	0x17000077 => 'allowedinmemorysettings',
1464	0x15000079 => 'bootuxtransitiontime',	1519	0x15000079 => 'bootuxtransitiontime',
1465	0x1600007a => 'mobilegraphics',	1520	0x1600007a => 'mobilegraphics',
1466	0x1600007b => 'forcefipscrypto',	1521	0x1600007b => 'forcefipscrypto',
1467	0x1500007d => 'booterrorux',	1522	0x1500007d => 'booterrorux',
1468	0x1600007e => 'flightsigning',	1523	0x1600007e => 'flightsigning',
1469	0x1500007f => 'measuredbootlogformat',	1524	0x1500007f => 'measuredbootlogformat',
1470	0x15000080 => 'displayrotation',	1525	0x15000080 => 'displayrotation',
1471	0x15000081 => 'logcontrol',	1526	0x15000081 => 'logcontrol',
1472	0x16000082 => 'nofirmwaresync',	1527	0x16000082 => 'nofirmwaresync',
1473	0x11000084 => 'windowssyspart',	1528	0x11000084 => 'windowssyspart',
1474	0x16000087 => 'numlock',	1529	0x16000087 => 'numlock',
1475	0x22000001 => 'bpbstring',	1530	0x26000202 => 'skipffumode',
		1531	0x26000203 => 'forceffumode',
		1532	0x25000510 => 'chargethreshold',
		1533	0x26000512 => 'offmodecharging',
		1534	0x25000aaa => 'bootflow',
		1535	0x45000001 => 'devicetype',
		1536	0x42000002 => 'applicationrelativepath',
		1537	0x42000003 => 'ramdiskdevicerelativepath',
		1538	0x46000004 => 'omitosloaderelements',
		1539	0x47000006 => 'elementstomigrate',
		1540	0x46000010 => 'recoveryos',
		1541	},
		1542	bootapp => {
		1543	0x26000145 => 'enablebootdebugpolicy',
		1544	0x26000146 => 'enablebootorderclean',
		1545	0x26000147 => 'enabledeviceid',
		1546	0x26000148 => 'enableffuloader',
		1547	0x26000149 => 'enableiuloader',
		1548	0x2600014a => 'enablemassstorage',
		1549	0x2600014b => 'enablerpmbprovisioning',
		1550	0x2600014c => 'enablesecurebootpolicy',
		1551	0x2600014d => 'enablestartcharge',
		1552	0x2600014e => 'enableresettpm',
		1553	},
		1554	bootmgr => {
1476	0x24000001 => 'displayorder',	1555	0x24000001 => 'displayorder',
1477	0x21000001 => 'filedevice',
1478	0x21000001 => 'osdevice',
1479	0x25000001 => 'passcount',
1480	0x26000001 => 'pxesoftreboot',
1481	0x22000002 => 'applicationname',
1482	0x24000002 => 'bootsequence',	1556	0x24000002 => 'bootsequence',
1483	0x22000002 => 'filepath',
1484	0x22000002 => 'systemroot',
1485	0x25000002 => 'testmix',
1486	0x26000003 => 'cacheenable',
1487	0x26000003 => 'customsettings',
1488	0x23000003 => 'default',	1557	0x23000003 => 'default',
1489	0x25000003 => 'failurecount',
1490	0x23000003 => 'resumeobject',
1491	0x26000004 => 'failuresenabled',
1492	0x26000004 => 'pae',
1493	0x26000004 => 'stampdisks',
1494	0x25000004 => 'testtofail',
1495	0x25000004 => 'timeout',	1558	0x25000004 => 'timeout',
1496	0x21000005 => 'associatedosdevice',
1497	0x26000005 => 'cacheenable',
1498	0x26000005 => 'resume',	1559	0x26000005 => 'resume',
1499	0x25000005 => 'stridefailcount',
1500	0x26000006 => 'debugoptionenabled',
1501	0x25000006 => 'invcfailcount',
1502	0x23000006 => 'resumeobject',	1560	0x23000006 => 'resumeobject',
1503	0x25000007 => 'bootux',
1504	0x25000007 => 'matsfailcount',
1505	0x24000007 => 'startupsequence',	1561	0x24000007 => 'startupsequence',
1506	0x25000008 => 'bootmenupolicy',
1507	0x25000008 => 'randfailcount',
1508	0x25000009 => 'chckrfailcount',
1509	0x26000010 => 'detecthal',
1510	0x24000010 => 'toolsdisplayorder',	1562	0x24000010 => 'toolsdisplayorder',
1511	0x22000011 => 'kernel',
1512	0x22000012 => 'hal',
1513	0x22000013 => 'dbgtransport',
1514	0x26000020 => 'displaybootmenu',	1563	0x26000020 => 'displaybootmenu',
1515	0x25000020 => 'nx',
1516	0x26000021 => 'noerrordisplay',	1564	0x26000021 => 'noerrordisplay',
1517	0x25000021 => 'pae',
1518	0x21000022 => 'bcddevice',	1565	0x21000022 => 'bcddevice',
1519	0x26000022 => 'winpe',
1520	0x22000023 => 'bcdfilepath',	1566	0x22000023 => 'bcdfilepath',
1521	0x26000024 => 'hormenabled',	1567	0x26000024 => 'hormenabled',
1522	0x26000024 => 'hormenabled',
1523	0x26000024 => 'nocrashautoreboot',
1524	0x26000025 => 'hiberboot',	1568	0x26000025 => 'hiberboot',
1525	0x26000025 => 'lastknowngood',
1526	0x26000026 => 'oslnointegritychecks',
1527	0x22000026 => 'passwordoverride',	1569	0x22000026 => 'passwordoverride',
1528	0x26000027 => 'osltestsigning',
1529	0x22000027 => 'pinpassphraseoverride',	1570	0x22000027 => 'pinpassphraseoverride',
1530	0x26000028 => 'processcustomactionsfirst',	1571	0x26000028 => 'processcustomactionsfirst',
1531	0x27000030 => 'customactions',	1572	0x27000030 => 'customactions',
1532	0x26000030 => 'nolowmem',
1533	0x26000031 => 'persistbootsequence',	1573	0x26000031 => 'persistbootsequence',
1534	0x25000031 => 'removememory',
1535	0x25000032 => 'increaseuserva',
1536	0x26000032 => 'skipstartupsequence',	1574	0x26000032 => 'skipstartupsequence',
1537	0x25000033 => 'perfmem',
1538	0x22000040 => 'fverecoveryurl',	1575	0x22000040 => 'fverecoveryurl',
1539	0x26000040 => 'vga',
1540	0x22000041 => 'fverecoverymessage',	1576	0x22000041 => 'fverecoverymessage',
		1577	},
		1578	device => {
		1579	0x35000001 => 'ramdiskimageoffset',
		1580	0x35000002 => 'ramdisktftpclientport',
		1581	0x31000003 => 'ramdisksdidevice',
		1582	0x32000004 => 'ramdisksdipath',
		1583	0x35000005 => 'ramdiskimagelength',
		1584	0x36000006 => 'exportascd',
		1585	0x35000007 => 'ramdisktftpblocksize',
		1586	0x35000008 => 'ramdisktftpwindowsize',
		1587	0x36000009 => 'ramdiskmcenabled',
		1588	0x3600000a => 'ramdiskmctftpfallback',
		1589	0x3600000b => 'ramdisktftpvarwindow',
		1590	},
		1591	memdiag => {
		1592	0x25000001 => 'passcount',
		1593	0x25000002 => 'testmix',
		1594	0x25000003 => 'failurecount',
		1595	0x26000003 => 'cacheenable',
		1596	0x25000004 => 'testtofail',
		1597	0x26000004 => 'failuresenabled',
		1598	0x25000005 => 'stridefailcount',
		1599	0x26000005 => 'cacheenable',
		1600	0x25000006 => 'invcfailcount',
		1601	0x25000007 => 'matsfailcount',
		1602	0x25000008 => 'randfailcount',
		1603	0x25000009 => 'chckrfailcount',
		1604	},
		1605	ntldr => {
		1606	0x22000001 => 'bpbstring',
		1607	},
		1608	osloader => {
		1609	0x21000001 => 'osdevice',
		1610	0x22000002 => 'systemroot',
		1611	0x23000003 => 'resumeobject',
		1612	0x26000004 => 'stampdisks',
		1613	0x26000010 => 'detecthal',
		1614	0x22000011 => 'kernel',
		1615	0x22000012 => 'hal',
		1616	0x22000013 => 'dbgtransport',
		1617	0x25000020 => 'nx',
		1618	0x25000021 => 'pae',
		1619	0x26000022 => 'winpe',
		1620	0x26000024 => 'nocrashautoreboot',
		1621	0x26000025 => 'lastknowngood',
		1622	0x26000026 => 'oslnointegritychecks',
		1623	0x26000027 => 'osltestsigning',
		1624	0x26000030 => 'nolowmem',
		1625	0x25000031 => 'removememory',
		1626	0x25000032 => 'increaseuserva',
		1627	0x25000033 => 'perfmem',
		1628	0x26000040 => 'vga',
1541	0x26000041 => 'quietboot',	1629	0x26000041 => 'quietboot',
1542	0x26000042 => 'novesa',	1630	0x26000042 => 'novesa',
1543	0x26000043 => 'novga',	1631	0x26000043 => 'novga',
1544	0x25000050 => 'clustermodeaddressing',	1632	0x25000050 => 'clustermodeaddressing',
1545	0x26000051 => 'usephysicaldestination',	1633	0x26000051 => 'usephysicaldestination',
1546	0x25000052 => 'restrictapiccluster',	1634	0x25000052 => 'restrictapiccluster',
1547	0x22000053 => 'evstore',	1635	0x22000053 => 'evstore',
1548	0x26000054 => 'uselegacyapicmode',	1636	0x26000054 => 'uselegacyapicmode',
1549	0x26000060 => 'onecpu',	1637	0x26000060 => 'onecpu',
1550	0x25000061 => 'numproc',	1638	0x25000061 => 'numproc',
1551	0x26000062 => 'maxproc',	1639	0x26000062 => 'maxproc',
1552	0x25000063 => 'configflags',	1640	0x25000063 => 'configflags',
1553	0x26000064 => 'maxgroup',	1641	0x26000064 => 'maxgroup',
1554	0x26000065 => 'groupaware',	1642	0x26000065 => 'groupaware',
1555	0x25000066 => 'groupsize',	1643	0x25000066 => 'groupsize',
1556	0x26000070 => 'usefirmwarepcisettings',	1644	0x26000070 => 'usefirmwarepcisettings',
1557	0x25000071 => 'msi',	1645	0x25000071 => 'msi',
1558	0x25000072 => 'pciexpress',	1646	0x25000072 => 'pciexpress',
1559	0x25000080 => 'safeboot',	1647	0x25000080 => 'safeboot',
1560	0x26000081 => 'safebootalternateshell',	1648	0x26000081 => 'safebootalternateshell',
1561	0x26000090 => 'bootlog',	1649	0x26000090 => 'bootlog',
1562	0x26000091 => 'sos',	1650	0x26000091 => 'sos',
1563	0x260000a0 => 'debug',	1651	0x260000a0 => 'debug',
1564	0x260000a1 => 'halbreakpoint',	1652	0x260000a1 => 'halbreakpoint',
1565	0x260000a2 => 'useplatformclock',	1653	0x260000a2 => 'useplatformclock',
1566	0x260000a3 => 'forcelegacyplatform',	1654	0x260000a3 => 'forcelegacyplatform',
1567	0x260000a4 => 'useplatformtick',	1655	0x260000a4 => 'useplatformtick',
1568	0x260000a5 => 'disabledynamictick',	1656	0x260000a5 => 'disabledynamictick',
1569	0x250000a6 => 'tscsyncpolicy',	1657	0x250000a6 => 'tscsyncpolicy',
1570	0x260000b0 => 'ems',	1658	0x260000b0 => 'ems',
1571	0x250000c0 => 'forcefailure',	1659	0x250000c0 => 'forcefailure',
1572	0x250000c1 => 'driverloadfailurepolicy',	1660	0x250000c1 => 'driverloadfailurepolicy',
1573	0x250000c2 => 'bootmenupolicy',	1661	0x250000c2 => 'bootmenupolicy',
1574	0x260000c3 => 'onetimeadvancedoptions',	1662	0x260000c3 => 'onetimeadvancedoptions',
1575	0x260000c4 => 'onetimeoptionsedit',	1663	0x260000c4 => 'onetimeoptionsedit',
1576	0x250000e0 => 'bootstatuspolicy',	1664	0x250000e0 => 'bootstatuspolicy',
1577	0x260000e1 => 'disableelamdrivers',	1665	0x260000e1 => 'disableelamdrivers',
1578	0x250000f0 => 'hypervisorlaunchtype',	1666	0x250000f0 => 'hypervisorlaunchtype',
1579	0x220000f1 => 'hypervisorpath',	1667	0x220000f1 => 'hypervisorpath',
1580	0x260000f2 => 'hypervisordebug',	1668	0x260000f2 => 'hypervisordebug',
1581	0x250000f3 => 'hypervisordebugtype',	1669	0x250000f3 => 'hypervisordebugtype',
1582	0x250000f4 => 'hypervisordebugport',	1670	0x250000f4 => 'hypervisordebugport',
1583	0x250000f5 => 'hypervisorbaudrate',	1671	0x250000f5 => 'hypervisorbaudrate',
1584	0x250000f6 => 'hypervisorchannel',	1672	0x250000f6 => 'hypervisorchannel',
1585	0x250000f7 => 'bootux',	1673	0x250000f7 => 'bootux',
1586	0x260000f8 => 'hypervisordisableslat',	1674	0x260000f8 => 'hypervisordisableslat',
1587	0x220000f9 => 'hypervisorbusparams',	1675	0x220000f9 => 'hypervisorbusparams',
1588	0x250000fa => 'hypervisornumproc',	1676	0x250000fa => 'hypervisornumproc',
1589	0x250000fb => 'hypervisorrootprocpernode',	1677	0x250000fb => 'hypervisorrootprocpernode',
1590	0x260000fc => 'hypervisoruselargevtlb',	1678	0x260000fc => 'hypervisoruselargevtlb',
1591	0x250000fd => 'hypervisorhostip',	1679	0x250000fd => 'hypervisorhostip',
1592	0x250000fe => 'hypervisorhostport',	1680	0x250000fe => 'hypervisorhostport',
1593	0x250000ff => 'hypervisordebugpages',	1681	0x250000ff => 'hypervisordebugpages',
1594	0x25000100 => 'tpmbootentropy',	1682	0x25000100 => 'tpmbootentropy',
1595	0x22000110 => 'hypervisorusekey',	1683	0x22000110 => 'hypervisorusekey',
1596	0x22000112 => 'hypervisorproductskutype',	1684	0x22000112 => 'hypervisorproductskutype',
1597	0x25000113 => 'hypervisorrootproc',	1685	0x25000113 => 'hypervisorrootproc',
1598	0x26000114 => 'hypervisordhcp',	1686	0x26000114 => 'hypervisordhcp',
1599	0x25000115 => 'hypervisoriommupolicy',	1687	0x25000115 => 'hypervisoriommupolicy',
1600	0x26000116 => 'hypervisorusevapic',	1688	0x26000116 => 'hypervisorusevapic',
1601	0x22000117 => 'hypervisorloadoptions',	1689	0x22000117 => 'hypervisorloadoptions',
1602	0x25000118 => 'hypervisormsrfilterpolicy',	1690	0x25000118 => 'hypervisormsrfilterpolicy',
1603	0x25000119 => 'hypervisormmionxpolicy',	1691	0x25000119 => 'hypervisormmionxpolicy',
1604	0x2500011a => 'hypervisorschedulertype',	1692	0x2500011a => 'hypervisorschedulertype',
1605	0x25000120 => 'xsavepolicy',	1693	0x25000120 => 'xsavepolicy',
1606	0x25000121 => 'xsaveaddfeature0',	1694	0x25000121 => 'xsaveaddfeature0',
1607	0x25000122 => 'xsaveaddfeature1',	1695	0x25000122 => 'xsaveaddfeature1',
1608	0x25000123 => 'xsaveaddfeature2',	1696	0x25000123 => 'xsaveaddfeature2',
1609	0x25000124 => 'xsaveaddfeature3',	1697	0x25000124 => 'xsaveaddfeature3',
1610	0x25000125 => 'xsaveaddfeature4',	1698	0x25000125 => 'xsaveaddfeature4',
1611	0x25000126 => 'xsaveaddfeature5',	1699	0x25000126 => 'xsaveaddfeature5',
1612	0x25000127 => 'xsaveaddfeature6',	1700	0x25000127 => 'xsaveaddfeature6',
1613	0x25000128 => 'xsaveaddfeature7',	1701	0x25000128 => 'xsaveaddfeature7',
1614	0x25000129 => 'xsaveremovefeature',	1702	0x25000129 => 'xsaveremovefeature',
1615	0x2500012a => 'xsaveprocessorsmask',	1703	0x2500012a => 'xsaveprocessorsmask',
1616	0x2500012b => 'xsavedisable',	1704	0x2500012b => 'xsavedisable',
1617	0x2500012c => 'kerneldebugtype',	1705	0x2500012c => 'kerneldebugtype',
1618	0x2200012d => 'kernelbusparams',	1706	0x2200012d => 'kernelbusparams',
1619	0x2500012e => 'kerneldebugaddress',	1707	0x2500012e => 'kerneldebugaddress',
1620	0x2500012f => 'kerneldebugport',	1708	0x2500012f => 'kerneldebugport',
1621	0x25000130 => 'claimedtpmcounter',	1709	0x25000130 => 'claimedtpmcounter',
1622	0x25000131 => 'kernelchannel',	1710	0x25000131 => 'kernelchannel',
1623	0x22000132 => 'kerneltargetname',	1711	0x22000132 => 'kerneltargetname',
1624	0x25000133 => 'kernelhostip',	1712	0x25000133 => 'kernelhostip',
1625	0x25000134 => 'kernelport',	1713	0x25000134 => 'kernelport',
1626	0x26000135 => 'kerneldhcp',	1714	0x26000135 => 'kerneldhcp',
1627	0x22000136 => 'kernelkey',	1715	0x22000136 => 'kernelkey',
1628	0x22000137 => 'imchivename',	1716	0x22000137 => 'imchivename',
1629	0x21000138 => 'imcdevice',	1717	0x21000138 => 'imcdevice',
1630	0x25000139 => 'kernelbaudrate',	1718	0x25000139 => 'kernelbaudrate',
1631	0x22000140 => 'mfgmode',	1719	0x22000140 => 'mfgmode',
1632	0x26000141 => 'event',	1720	0x26000141 => 'event',
1633	0x25000142 => 'vsmlaunchtype',	1721	0x25000142 => 'vsmlaunchtype',
1634	0x25000144 => 'hypervisorenforcedcodeintegrity',	1722	0x25000144 => 'hypervisorenforcedcodeintegrity',
1635	0x26000145 => 'enablebootdebugpolicy',
1636	0x26000146 => 'enablebootorderclean',
1637	0x26000147 => 'enabledeviceid',
1638	0x26000148 => 'enableffuloader',
1639	0x26000149 => 'enableiuloader',
1640	0x2600014a => 'enablemassstorage',
1641	0x2600014b => 'enablerpmbprovisioning',
1642	0x2600014c => 'enablesecurebootpolicy',
1643	0x2600014d => 'enablestartcharge',
1644	0x2600014e => 'enableresettpm',
1645	0x21000150 => 'systemdatadevice',	1723	0x21000150 => 'systemdatadevice',
1646	0x21000151 => 'osarcdevice',	1724	0x21000151 => 'osarcdevice',
1647	0x21000153 => 'osdatadevice',	1725	0x21000153 => 'osdatadevice',
1648	0x21000154 => 'bspdevice',	1726	0x21000154 => 'bspdevice',
1649	0x21000155 => 'bspfilepath',	1727	0x21000155 => 'bspfilepath',
1650	0x26000202 => 'skipffumode',	1728	},
1651	0x26000203 => 'forceffumode',	1729	resume => {
1652	0x25000510 => 'chargethreshold',	1730	0x21000001 => 'filedevice',
1653	0x26000512 => 'offmodecharging',	1731	0x22000002 => 'filepath',
1654	0x25000aaa => 'bootflow',	1732	0x26000003 => 'customsettings',
1655	0x35000001 => 'ramdiskimageoffset',	1733	0x26000004 => 'pae',
1656	0x35000002 => 'ramdisktftpclientport',	1734	0x21000005 => 'associatedosdevice',
1657	0x31000003 => 'ramdisksdidevice',	1735	0x26000006 => 'debugoptionenabled',
1658	0x32000004 => 'ramdisksdipath',	1736	0x25000007 => 'bootux',
1659	0x35000005 => 'ramdiskimagelength',	1737	0x25000008 => 'bootmenupolicy',
1660	0x36000006 => 'exportascd',	1738	0x26000024 => 'hormenabled',
1661	0x35000007 => 'ramdisktftpblocksize',	1739	},
1662	0x35000008 => 'ramdisktftpwindowsize',	1740	startup => {
1663	0x36000009 => 'ramdiskmcenabled',	1741	0x26000001 => 'pxesoftreboot',
1664	0x3600000a => 'ramdiskmctftpfallback',	1742	0x22000002 => 'applicationname',
1665	0x3600000b => 'ramdisktftpvarwindow',	1743	},
1666	0x45000001 => 'devicetype',
1667	0x42000002 => 'applicationrelativepath',
1668	0x42000003 => 'ramdiskdevicerelativepath',
1669	0x46000004 => 'omitosloaderelements',
1670	0x47000006 => 'elementstomigrate',
1671	0x46000010 => 'recoveryos',
1672	);	1744	);
1673		1745
1674	our %rbcde = reverse %bcde;	1746	# mask, value => class
		1747	our @bcde_typeclass = (
		1748	[0x00000000, 0x00000000, 'any'],
		1749	[0xf00fffff, 0x1000000a, 'bootapp'],
		1750	[0xf0ffffff, 0x2020000a, 'bootapp'],
		1751	[0xf00fffff, 0x10000001, 'bootmgr'],
		1752	[0xf00fffff, 0x10000002, 'bootmgr'],
		1753	[0xf0ffffff, 0x20200001, 'bootmgr'],
		1754	[0xf0ffffff, 0x20200002, 'bootmgr'],
		1755	[0xf0f00000, 0x20300000, 'device'],
		1756	[0xf0000000, 0x30000000, 'device'],
		1757	[0xf00fffff, 0x10000005, 'memdiag'],
		1758	[0xf0ffffff, 0x20200005, 'memdiag'],
		1759	[0xf00fffff, 0x10000006, 'ntldr'],
		1760	[0xf00fffff, 0x10000007, 'ntldr'],
		1761	[0xf0ffffff, 0x20200006, 'ntldr'],
		1762	[0xf0ffffff, 0x20200007, 'ntldr'],
		1763	[0xf00fffff, 0x10000003, 'osloader'],
		1764	[0xf0ffffff, 0x20200003, 'osloader'],
		1765	[0xf00fffff, 0x10000004, 'resume'],
		1766	[0xf0ffffff, 0x20200004, 'resume'],
		1767	[0xf00fffff, 0x10000009, 'startup'],
		1768	[0xf0ffffff, 0x20200009, 'startup'],
		1769	);
1675		1770
		1771	our %rbcde_byclass;
		1772
		1773	while (my ($k, $v) = each %bcde_byclass) {
		1774	$rbcde_byclass{$k} = { reverse %$v };
		1775	}
		1776
		1777	# decodes (numerical elem, type) to name
1676	sub dec_bcde_id($) {	1778	sub dec_bcde_id($$) {
		1779	for my $class (@bcde_typeclass) {
		1780	if (($_[1] & $class->[0]) == $class->[1]) {
		1781	if (my $id = $bcde_byclass{$class->[2]}{$_[0]}) {
		1782	return $id;
		1783	}
		1784	}
		1785	}
		1786
1677	$bcde{$_[0]} // sprintf "custom:%08x", $_[0]	1787	sprintf "custom:%08x", $_[0]
1678	}	1788	}
1679		1789
		1790	# encodes (elem as name, type)
1680	sub enc_bcde_id($) {	1791	sub enc_bcde_id($$) {
1681	$_[0] =~ /^custom:([0-9a-fA-F]{8}$)/	1792	$_[0] =~ /^custom:(?:0x)?([0-9a-fA-F]{8}$)/
1682	? hex $1	1793	and return hex $1;
1683	: $rbcde{$_[0]}	1794
		1795	for my $class (@bcde_typeclass) {
		1796	if (($_[1] & $class->[0]) == $class->[1]) {
		1797	if (my $value = $rbcde_byclass{$class->[2]}{$_[0]}) {
		1798	return $value;
		1799	}
		1800	}
		1801	}
		1802
		1803	undef
1684	}	1804	}
1685		1805
1686	# decode/encode bcd device element - the horror, no documentaion	1806	# decode/encode bcd device element - the horror, no documentaion
1687	# whatsoever, supercomplex, superinconsistent.	1807	# whatsoever, supercomplex, superinconsistent.
1688		1808
…		…
1692		1812
1693	our $NULL_DEVICE = "\x00" x 16;	1813	our $NULL_DEVICE = "\x00" x 16;
1694		1814
1695	# biggest bitch to decode, ever	1815	# biggest bitch to decode, ever
1696	# this decoded a device portion after the GUID	1816	# this decoded a device portion after the GUID
1697	sub dec_device_($);	1817	sub dec_device_($$);
1698	sub dec_device_($) {	1818	sub dec_device_($$) {
1699	my ($device) = @_;	1819	my ($device, $type) = @_;
1700		1820
1701	my $res;	1821	my $res;
1702		1822
1703	my ($type, $flags, $length, $pad) = unpack "VVVV", substr $device, 0, 4 * 4, "";	1823	my ($type, $flags, $length, $pad) = unpack "VVVV", substr $device, 0, 4 * 4, "";
1704		1824
…		…
1749		1869
1750	my $partid = $parttype eq "gpt" ? dec_guid $partdata	1870	my $partid = $parttype eq "gpt" ? dec_guid $partdata
1751	: $type eq "partition" ? unpack "Q<", $partdata # byte offset to partition start	1871	: $type eq "partition" ? unpack "Q<", $partdata # byte offset to partition start
1752	: unpack "L<", $partdata; # partition number, one-based	1872	: unpack "L<", $partdata; # partition number, one-based
1753		1873
1754	(my $parent, $device) = dec_device_ $device;	1874	(my $parent, $device) = dec_device_ $device, $type;
1755		1875
1756	$res .= "=";	1876	$res .= "=";
1757	$res .= "<$parent>";	1877	$res .= "<$parent>";
1758	$res .= ",$blocktype,$parttype,$diskid,$partid";	1878	$res .= ",$blocktype,$parttype,$diskid,$partid";
1759		1879
…		…
1779	or die "unsupported file descriptor version '$fver'\n";	1899	or die "unsupported file descriptor version '$fver'\n";
1780		1900
1781	$ftype == 5	1901	$ftype == 5
1782	or die "unsupported file descriptor path type '$type'\n";	1902	or die "unsupported file descriptor path type '$type'\n";
1783		1903
1784	(my $parent, $path) = dec_device_ $path;	1904	(my $parent, $path) = dec_device_ $path, $type;
1785		1905
1786	$path = $dec_path->($path, "file device without path");	1906	$path = $dec_path->($path, "file device without path");
1787		1907
1788	($parent, $path)	1908	($parent, $path)
1789	};	1909	};
…		…
1795		1915
1796	} elsif ($blocktype eq "vhd") {	1916	} elsif ($blocktype eq "vhd") {
1797	$device =~ s/^\x00{20}//s	1917	$device =~ s/^\x00{20}//s
1798	or die "virtualdisk has non-zero fields I don't understand\n";	1918	or die "virtualdisk has non-zero fields I don't understand\n";
1799		1919
1800	(my $parent, $device) = dec_device_ $device;	1920	(my $parent, $device) = dec_device_ $device, $type;
1801		1921
1802	$res .= "=vhd,<$parent>";	1922	$res .= "=vhd,<$parent>";
1803		1923
1804	} elsif ($blocktype eq "ramdisk") {	1924	} elsif ($blocktype eq "ramdisk") {
1805	my ($base, $size, $offset) = unpack "Q< Q< L<", substr $device, 0, 8 + 8 + 4, "";	1925	my ($base, $size, $offset) = unpack "Q< Q< L<", substr $device, 0, 8 + 8 + 4, "";
…		…
1818	my ($mode, $elem, $parent) = unpack "VVV", substr $device, 0, 4 * 3, "";	1938	my ($mode, $elem, $parent) = unpack "VVV", substr $device, 0, 4 * 3, "";
1819		1939
1820	if ($parent) {	1940	if ($parent) {
1821	# not sure why this is an offset - it must come after the path	1941	# not sure why this is an offset - it must come after the path
1822	$parent = substr $device, $parent - 4 * 3 - 4 * 4, 1e9, "";	1942	$parent = substr $device, $parent - 4 * 3 - 4 * 4, 1e9, "";
1823	($parent, my $tail) = dec_device_ $parent;	1943	($parent, my $tail) = dec_device_ $parent, $type;
1824	0 == length $tail	1944	0 == length $tail
1825	or die "trailing data after locate device parent\n";	1945	or die "trailing data after locate device parent\n";
1826	} else {	1946	} else {
1827	$parent = "null";	1947	$parent = "null";
1828	}	1948	}
…		…
1834		1954
1835	if ($mode == 0) { # "Element"	1955	if ($mode == 0) { # "Element"
1836	!length $path	1956	!length $path
1837	or die "device locate mode 0 having non-empty path ($mode, $elem, $path)\n";	1957	or die "device locate mode 0 having non-empty path ($mode, $elem, $path)\n";
1838		1958
1839	$elem = dec_bcde_id $elem;	1959	$elem = dec_bcde_id $elem, $type;
1840	$res .= "element,$elem";	1960	$res .= "element,$elem";
1841		1961
1842	} elsif ($mode == 1) { # "String"	1962	} elsif ($mode == 1) { # "String"
1843	!$elem	1963	!$elem
1844	or die "device locate mode 1 having non-zero element\n";	1964	or die "device locate mode 1 having non-zero element\n";
…		…
1869		1989
1870	($res, $tail)	1990	($res, $tail)
1871	}	1991	}
1872		1992
1873	# decode a full binary BCD device descriptor	1993	# decode a full binary BCD device descriptor
1874	sub dec_device($) {	1994	sub dec_device($$) {
1875	my ($device) = @_;	1995	my ($device, $type) = @_;
1876		1996
1877	$device = pack "H*", $device;	1997	$device = pack "H*", $device;
1878		1998
1879	my $guid = dec_guid substr $device, 0, 16, "";	1999	my $guid = dec_guid substr $device, 0, 16, "";
1880	$guid = $guid eq "00000000-0000-0000-0000-000000000000"	2000	$guid = $guid eq "00000000-0000-0000-0000-000000000000"
1881	? "" : "{$guid}";	2001	? "" : "{$guid}";
1882		2002
1883	eval {	2003	eval {
1884	my ($dev, $tail) = dec_device_ $device;	2004	my ($dev, $tail) = dec_device_ $device, $type;
1885		2005
1886	$tail eq ""	2006	$tail eq ""
1887	or die "unsupported trailing data after device descriptor\n";	2007	or die "unsupported trailing data after device descriptor\n";
1888		2008
1889	"$guid$dev"	2009	"$guid$dev"
…		…
1901		2021
1902	undef	2022	undef
1903	}	2023	}
1904		2024
1905	# encode the device portion after the GUID	2025	# encode the device portion after the GUID
1906	sub enc_device_;	2026	sub enc_device_($$);
1907	sub enc_device_ {	2027	sub enc_device_($$) {
1908	my ($device) = @_;	2028	my ($device, $type) = @_;
1909		2029
1910	my $enc_path = sub {	2030	my $enc_path = sub {
1911	my $path = shift;	2031	my $path = shift;
1912	$path =~ s/\//\\/g;	2032	$path =~ s/\//\\/g;
1913	(Encode::encode "UTF-16LE", $path) . "\x00\x00"	2033	(Encode::encode "UTF-16LE", $path) . "\x00\x00"
…		…
1931		2051
1932	my $parse_parent = sub {	2052	my $parse_parent = sub {
1933	my $parent;	2053	my $parent;
1934		2054
1935	if (s/^<//) {	2055	if (s/^<//) {
1936	($parent, $_) = enc_device_ $_;	2056	($parent, $_) = enc_device_ $_, $type;
1937	s/^>//	2057	s/^>//
1938	or die "$device: syntax error: parent device not followed by '>'\n";	2058	or die "$device: syntax error: parent device not followed by '>'\n";
1939	} else {	2059	} else {
1940	$parent = $NULL_DEVICE;	2060	$parent = $NULL_DEVICE;
1941	}	2061	}
…		…
2029		2149
2030	s/^,//	2150	s/^,//
2031	or die "$_: missing comma after locate parent device\n";	2151	or die "$_: missing comma after locate parent device\n";
2032		2152
2033	if (s/^element,//) {	2153	if (s/^element,//) {
2034	s/^([0-9a-z]+)//i	2154	s/^([0-9a-z:]+)//i
2035	or die "$_ locate element must be either name or 8-digit hex id\n";	2155	or die "$_ locate element must be either name or 8-digit hex id\n";
2036	$elem = enc_bcde_id $1;	2156	$elem = enc_bcde_id $1, $type;
2037	$mode = 0;	2157	$mode = 0;
2038	$path = $enc_path->("");	2158	$path = $enc_path->("");
2039		2159
2040	} elsif (s/^path,//) {	2160	} elsif (s/^path,//) {
2041	$mode = 1;	2161	$mode = 1;
…		…
2120	);	2240	);
2121	}	2241	}
2122	}	2242	}
2123		2243
2124	# encode a full binary BCD device descriptor	2244	# encode a full binary BCD device descriptor
2125	sub enc_device {	2245	sub enc_device($$) {
2126	my ($device) = @_;	2246	my ($device, $type) = @_;
2127		2247
2128	my $guid = "\x00" x 16;	2248	my $guid = "\x00" x 16;
2129		2249
2130	if ($device =~ s/^\{([A-Za-z0-9\-]+)\}//) {	2250	if ($device =~ s/^\{([A-Za-z0-9\-]+)\}//) {
2131	$guid = enc_guid $1	2251	$guid = enc_guid $1
2132	or die "$device: does not start with valid guid\n";	2252	or die "$device: does not start with valid guid\n";
2133	}	2253	}
2134		2254
2135	my ($descriptor, $tail) = enc_device_ $device;	2255	my ($descriptor, $tail) = enc_device_ $device, $type;
2136		2256
2137	length $tail	2257	length $tail
2138	and die "$device: garbage after device descriptor\n";	2258	and die "$device: garbage after device descriptor\n";
2139		2259
2140	unpack "H*", $guid . $descriptor	2260	unpack "H*", $guid . $descriptor
…		…
2155	$k = $bcd_objects{$k} // $k;	2275	$k = $bcd_objects{$k} // $k;
2156		2276
2157	my $type = $v->{Description}[0]{Type}[1];	2277	my $type = $v->{Description}[0]{Type}[1];
2158		2278
2159	if ($type != $bcd_object_types{$k}) {	2279	if ($type != $bcd_object_types{$k}) {
2160	$type = $bcd_types{$type} // sprintf "0x%08x", $type;	2280	$kv{type} = $bcd_types{$type} // sprintf "0x%08x", $type;
2161	$kv{type} = $type;
2162	}	2281	}
2163		2282
2164	my $elems = $v->{Elements}[1];	2283	my $elems = $v->{Elements}[1];
2165		2284
2166	while (my ($k, $v) = each %$elems) {	2285	while (my ($k, $v) = each %$elems) {
2167	my $k = hex $k;	2286	my $k = hex $k;
2168		2287
2169	my $v = $bcde_dec{$k & BCDE_FORMAT}->($v->[0]{Element}[1]);	2288	my $v = $bcde_dec{$k & BCDE_FORMAT}->($v->[0]{Element}[1], $type);
2170	my $k = dec_bcde_id $k;	2289	my $k = dec_bcde_id $k, $type;
2171		2290
2172	$kv{$k} = $v;	2291	$kv{$k} = $v;
2173	}	2292	}
2174		2293
2175	$bcd{$k} = \%kv;	2294	$bcd{$k} = \%kv;
…		…
2216	my %elem;	2335	my %elem;
2217		2336
2218	while (my ($k, $v) = each %$v) {	2337	while (my ($k, $v) = each %$v) {
2219	next if $k eq "type";	2338	next if $k eq "type";
2220		2339
2221	$k = (enc_bcde_id $k) // die "$k: invalid bcde element name or id\n";	2340	$k = (enc_bcde_id $k, $type) // die "$k: invalid bcde element name or id\n";
2222	$elem{sprintf "%08x", $k} = [{	2341	$elem{sprintf "%08x", $k} = [{
2223	Element => [ ($bcde_enc{$k & BCDE_FORMAT} // die "$k: unable to encode unknown bcd element type}")->($v)]	2342	Element => [ ($bcde_enc{$k & BCDE_FORMAT} // die "$k: unable to encode unknown bcd element type}")->($v)]
2224	}];	2343	}];
2225	}	2344	}
2226		2345
…		…
2242	Objects => [undef, \%objects],	2361	Objects => [undef, \%objects],
2243	}]]	2362	}]]
2244	}	2363	}
2245		2364
2246	#############################################################################	2365	#############################################################################
		2366	# edit instructions
2247		2367
2248	sub bcd_edit_eval {	2368	sub bcd_edit_eval {
2249	package pbcdedit;	2369	package pbcdedit;
2250		2370
2251	our ($PATH, $BCD, $DEFAULT);	2371	our ($PATH, $BCD, $DEFAULT);
…		…
2255	}	2375	}
2256		2376
2257	sub bcd_edit {	2377	sub bcd_edit {
2258	my ($path, $bcd, @insns) = @_;	2378	my ($path, $bcd, @insns) = @_;
2259		2379
2260	my $default = $bcd->{"{bootmgr}"}{resumeobject};	2380	my $default = $bcd->{"{bootmgr}"}{default};
2261		2381
2262	# prepare "officially visible" variables	2382	# prepare "officially visible" variables
2263	local $pbcdedit::PATH = $path;	2383	local $pbcdedit::PATH = $path;
2264	local $pbcdedit::BCD = $bcd;	2384	local $pbcdedit::BCD = $bcd;
2265	local $pbcdedit::DEFAULT = $default;	2385	local $pbcdedit::DEFAULT = $default;
…		…
2269		2389
2270	if ($insn eq "get") {	2390	if ($insn eq "get") {
2271	my $object = shift @insns;	2391	my $object = shift @insns;
2272	my $elem = shift @insns;	2392	my $elem = shift @insns;
2273		2393
2274	$object = $default if $object eq "{default}";	2394	$object = $object eq "{default}" ? $default : dec_wguid enc_wguid $object;
2275		2395
2276	print $bcd->{$object}{$elem}, "\n";	2396	print $bcd->{$object}{$elem}, "\n";
2277		2397
2278	} elsif ($insn eq "set") {	2398	} elsif ($insn eq "set") {
2279	my $object = shift @insns;	2399	my $object = shift @insns;
2280	my $elem = shift @insns;	2400	my $elem = shift @insns;
2281	my $value = shift @insns;	2401	my $value = shift @insns;
2282		2402
2283	$object = $default if $object eq "{default}";	2403	$object = $object eq "{default}" ? $default : dec_wguid enc_wguid $object;
2284		2404
2285	$bcd->{$object}{$elem} = $value;	2405	$bcd->{$object}{$elem} = $value;
2286		2406
2287	} elsif ($insn eq "eval") {	2407	} elsif ($insn eq "eval") {
2288	bcd_edit_eval shift @insns;	2408	my $perl = shift @insns;
		2409	bcd_edit_eval "#line 1 'eval'\n$perl";
2289		2410
2290	} elsif ($insn eq "do") {	2411	} elsif ($insn eq "do") {
2291	my $path = shift @insns;	2412	my $path = shift @insns;
2292	my $file = file_load $path;	2413	my $file = file_load $path;
2293	bcd_edit_eval "#line 1 '$path'\n$file";	2414	bcd_edit_eval "#line 1 '$path'\n$file";
…		…
2298	}	2419	}
2299		2420
2300	}	2421	}
2301		2422
2302	#############################################################################	2423	#############################################################################
		2424	# other utilities
2303		2425
2304	# json to stdout	2426	# json to stdout
2305	sub prjson($) {	2427	sub prjson($) {
2306	print $json_coder->encode ($_[0]);	2428	print $json_coder->encode ($_[0]);
2307	}	2429	}
…		…
2311	my $json;	2433	my $json;
2312	1 while read STDIN, $json, 65536, length $json;	2434	1 while read STDIN, $json, 65536, length $json;
2313	$json_coder->decode ($json)	2435	$json_coder->decode ($json)
2314	}	2436	}
2315		2437
2316	# all subcommands	2438	sub lsblk() {
		2439	my $lsblk = $json_coder->decode (scalar qx<lsblk --json -o PATH,KNAME,MAJ:MIN,TYPE,PTTYPE,PTUUID,PARTUUID,LABEL,FSTYPE>);
		2440
		2441	for my $dev (@{ $lsblk->{blockdevices} }) {
		2442	if ($dev->{type} eq "part") {
		2443	if ($dev->{pttype} eq "gpt") {
		2444	$dev->{bcd_device} = "partition=<null>,harddisk,gpt,$dev->{ptuuid},$dev->{partuuid}";
		2445	} elsif ($dev->{pttype} eq "dos") { # why not "mbr" :(
		2446	if ($dev->{partuuid} =~ /^([0-9a-f]{8})-([0-9a-f]{2})\z/i) {
		2447	my ($diskid, $partno) = ($1, hex $2);
		2448	$dev->{bcd_legacy_device} = "legacypartition=<null>,harddisk,mbr,$diskid,$partno";
		2449	if (open my $fh, "/sys/class/block/$dev->{kname}/start") {
		2450	my $start = 512 * readline $fh;
		2451	$dev->{bcd_device} = "partition=<null>,harddisk,mbr,$diskid,$start";
		2452	}
		2453	}
		2454	}
		2455	}
		2456	}
		2457
		2458	$lsblk->{blockdevices}
		2459	}
		2460
		2461	sub prdev($$) {
		2462	my ($path, $attribute) = @_;
		2463
		2464	# rather than stat'ing and guessing how devices are encoded, we use lsblk for this
		2465	# unfortunately, there doesn't seem to be a way to restrict lsblk to just oned evice,
		2466	# so we always assume the first one is it.
		2467	my $mm = $json_coder->decode (scalar qx<lsblk -o MAJ:MIN -J \Q$path\E>)->{blockdevices}[0]{"maj:min"};
		2468
		2469	my $lsblk = lsblk;
		2470
		2471	for my $dev (@$lsblk) {
		2472	if ($dev->{"maj:min"} eq $mm && $dev->{$attribute}) {
		2473	say $dev->{$attribute};
		2474	exit 0;
		2475	}
		2476	}
		2477
		2478	exit 1;
		2479	}
		2480
		2481	#############################################################################
		2482	# command line parser
		2483
2317	our %CMD = (	2484	our %CMD = (
2318	help => sub {	2485	help => sub {
2319	require Pod::Usage;	2486	require Pod::Usage;
2320	Pod::Usage::pod2usage (-verbose => 2);	2487	Pod::Usage::pod2usage (-verbose => 2);
2321	},	2488	},
…		…
2346		2513
2347	print "\n";	2514	print "\n";
2348		2515
2349	printf "%-39s %-23s %s\n", "Object GUID", "Alias", "(Hex) Default Type";	2516	printf "%-39s %-23s %s\n", "Object GUID", "Alias", "(Hex) Default Type";
2350	for my $name (sort keys %rbcd_objects) {	2517	for my $name (sort keys %rbcd_objects) {
2351	my $guid = $rbcd_objects{$name};	2518	my $guid = $rbcd_objects{$name};
2352	my $type = $bcd_object_types{$name};	2519	my $type = $bcd_object_types{$name};
2353	my $tname = $bcd_types{$type};	2520	my $tname = $bcd_types{$type};
2354		2521
2355	$type = $type ? sprintf "(%08x) %s", $type, $tname : "-";	2522	$type = $type ? sprintf "(%08x) %s", $type, $tname : "-";
2356		2523
2357	printf "%-39s %-23s %s\n", $guid, $name, $type;	2524	printf "%-39s %-23s %s\n", $guid, $name, $type;
…		…
2371	BCDE_FORMAT_GUID_LIST , "guid list",	2538	BCDE_FORMAT_GUID_LIST , "guid list",
2372	BCDE_FORMAT_INTEGER , "integer",	2539	BCDE_FORMAT_INTEGER , "integer",
2373	BCDE_FORMAT_BOOLEAN , "boolean",	2540	BCDE_FORMAT_BOOLEAN , "boolean",
2374	BCDE_FORMAT_INTEGER_LIST, "integer list",	2541	BCDE_FORMAT_INTEGER_LIST, "integer list",
2375	);	2542	);
2376	my %rbcde = reverse %bcde;
2377	$_ = sprintf "%08x", $_ for values %rbcde;
2378		2543
2379	my %element;	2544	my @element;
2380		2545
		2546	for my $class (sort keys %rbcde_byclass) {
		2547	my $rbcde = $rbcde_byclass{$class};
		2548
2381	unless ($json) {	2549	unless ($json) {
2382	print "\n";	2550	print "\n";
		2551	printf "Elements applicable to class(es): $class\n";
2383	printf "%-9s %-12s %s\n", "Element", "Format", "Name Alias";	2552	printf "%-9s %-12s %s\n", "Element", "Format", "Name Alias";
2384	}	2553	}
2385	for my $name (sort keys %rbcde) {	2554	for my $name (sort keys %$rbcde) {
2386	my $id = $rbcde{$name};	2555	my $id = $rbcde->{$name};
2387	my $format = $format_name{(hex $id) & BCDE_FORMAT};	2556	my $format = $format_name{$id & BCDE_FORMAT};
2388		2557
2389	if ($json) {	2558	if ($json) {
2390	$element{$id} = [$format, $name];	2559	push @element, [$class, $id * 1, $format, $name];
2391	} else {	2560	} else {
		2561	$id = sprintf "%08x", $id;
2392	printf "%-9s %-12s %s\n", $id, $format, $name;	2562	printf "%-9s %-12s %s\n", $id, $format, $name;
		2563	}
2393	}	2564	}
2394	}	2565	}
2395	print "\n" unless $json;	2566	print "\n" unless $json;
2396		2567
2397	prjson {	2568	prjson {
2398	version => $JSON_VERSION,	2569	version => $JSON_VERSION,
2399	element => \%element,	2570	element => \@element,
		2571	class => \@bcde_typeclass,
2400	} if $json;	2572	} if $json;
2401		2573
2402	},	2574	},
2403		2575
2404	export => sub {	2576	export => sub {
…		…
2430	"import-regf" => sub {	2602	"import-regf" => sub {
2431	regf_save shift, rdjson;	2603	regf_save shift, rdjson;
2432	},	2604	},
2433		2605
2434	lsblk => sub {	2606	lsblk => sub {
		2607	my $json = $_[0] eq "--json";
		2608
		2609	my $lsblk = lsblk;
		2610
		2611	if ($json) {
		2612	prjson $lsblk;
		2613	} else {
2435	printf "%-10s %-8.8s %-6.6s %-3s %s\n", "DEVICE", "LABEL", "FSTYPE", "PT", "DEVICE DESCRIPTOR";	2614	printf "%-10s %-8.8s %-6.6s %-3s %s\n", "DEVICE", "LABEL", "FSTYPE", "PT", "DEVICE DESCRIPTOR";
2436		2615	for my $dev (@$lsblk) {
2437	my $lsblk = $json_coder->decode (scalar qx<lsblk --json -o PATH,KNAME,TYPE,PTTYPE,PTUUID,PARTUUID,LABEL,FSTYPE>);	2616	for my $bcd ($dev->{bcd_device}, $dev->{bcd_legacy_device}) {
2438
2439	for my $dev (@{ $lsblk->{blockdevices} }) {
2440	my $pr = sub {
2441	printf "%-10s %-8.8s %-6.6s %-3s %s\n",	2617	printf "%-10s %-8.8s %-6.6s %-3s %s\n",
2442	$dev->{path}, $dev->{label}, $dev->{fstype}, $dev->{pttype}, $_[0];	2618	$dev->{path}, $dev->{label}, $dev->{fstype}, $dev->{pttype}, $bcd
2443	};
2444
2445	if ($dev->{type} eq "part") {
2446	if ($dev->{pttype} eq "gpt") {
2447	$pr->("partition=<null>,harddisk,gpt,$dev->{ptuuid},$dev->{partuuid}");
2448	} elsif ($dev->{pttype} eq "dos") { # why not "mbr" :(
2449	if ($dev->{partuuid} =~ /^([0-9a-f]{8})-([0-9a-f]{2})\z/i) {
2450	my ($diskid, $partno) = ($1, hex $2);
2451	$pr->("legacypartition=<null>,harddisk,mbr,$diskid,$partno");
2452	if (open my $fh, "/sys/class/block/$dev->{kname}/start") {
2453	my $start = 512 * readline $fh;
2454	$pr->("partition=<null>,harddisk,mbr,$diskid,$start");
2455	}	2619	if $bcd;
2456	}
2457	}	2620	}
2458	}	2621	}
2459	}	2622	}
2460	},	2623	},
		2624
		2625	"bcd-device" => sub {
		2626	prdev shift, "bcd_device";
		2627	},
		2628
		2629	"bcd-legacy-device" => sub {
		2630	prdev shift, "bcd_legacy_device";
		2631	},
		2632
		2633	version => sub {
		2634	print "\n",
		2635	"PBCDEDIT version $VERSION, copyright 2019 Marc A. Lehmann <pbcdedit\@schmorp.de>.\n",
		2636	"JSON schema version: $JSON_VERSION\n",
		2637	"Licensed under the GNU General Public License Version 3.0, or any later version.\n",
		2638	"\n",
		2639	$CHANGELOG,
		2640	"\n";
		2641	},
2461	);	2642	);
2462		2643
2463	my $cmd = shift;	2644	my $cmd = shift;
2464		2645
2465	unless (exists $CMD{$cmd}) {	2646	unless (exists $CMD{$cmd}) {

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines
>	Changed lines