WebSVN – uuid_mac_utils – Blame – /trunk/index.php

Rev	Author	Line No.	Line
31	daniel-mar	1	<?php
2	daniel-mar	2
31	daniel-mar	3	/*
		4	* UUID & MAC Utils
		5	* Copyright 2017 - 2023 Daniel Marschall, ViaThinkSoft
67	daniel-mar	6	* Version 2023-09-07
31	daniel-mar	7	*
		8	* Licensed under the Apache License, Version 2.0 (the "License");
		9	* you may not use this file except in compliance with the License.
		10	* You may obtain a copy of the License at
		11	*
		12	* http://www.apache.org/licenses/LICENSE-2.0
		13	*
		14	* Unless required by applicable law or agreed to in writing, software
		15	* distributed under the License is distributed on an "AS IS" BASIS,
		16	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		17	* See the License for the specific language governing permissions and
		18	* limitations under the License.
		19	*/
		20
		21	include_once __DIR__.'/includes/uuid_utils.inc.php';
		22
		23	const AUTO_NEW_UUIDS = 10;
		24
		25	?><!DOCTYPE html>
		26	<html lang="en">
		27
2	daniel-mar	28	<head>
		29	<meta charset="iso-8859-1">
		30	<link rel="stylesheet" type="text/css" href="style.css">
		31	<title>UUID & MAC Utils by Daniel Marschall</title>
35	daniel-mar	32	<meta name=viewport content="width=device-width, initial-scale=1">
2	daniel-mar	33	</head>
		34
		35	<body>
		36
25	daniel-mar	37	<h1>UUID & MAC Utils by Daniel Marschall</h1>
2	daniel-mar	38
12	daniel-mar	39	<p><a href="https://github.com/danielmarschall/uuid_mac_utils/">View the source code</a></p>
2	daniel-mar	40
31	daniel-mar	41	<h2>Overview</h2>
2	daniel-mar	42
31	daniel-mar	43	<ul>
		44	<li><a href="#gen_uuid">Generate random and/or time-based UUIDs</a><ul>
		45	<li><a href="#gen_uuidv7"><font color="green">New:</font> Generate Unix Epoch Time (version 7) UUID</a></li>
		46	<li><a href="#gen_uuidv6"><font color="green">New:</font> Generate reordered time-based (version 6) UUID</a></li>
		47	<li><a href="#gen_uuidv4">Generate random (version 4) UUID</a></li>
		48	<li><a href="#gen_uuidv1">Generate time-based (version 1) UUID</a></li>
		49	</ul></li>
		50	<li><a href="#gen_other_uuid">Generate other UUID types</a><ul>
53	daniel-mar	51	<li><a href="#gen_uuid_ncs">NCS (variant 0) UUID</a></li>
31	daniel-mar	52	<li><a href="#gen_uuidv2">Generate DCE Security (version 2) UUID</a></li>
61	daniel-mar	53	<li><a href="#gen_uuidv35">Generate name-based (version 3 / 5 / <font color="green">New: 8</font>) UUID</a></li>
		54	<li><a href="#gen_uuidv8"><font color="green">New:</font> Generate Custom (version 8) UUID</a></li>
31	daniel-mar	55	</ul></li>
		56	<li><a href="#interpret_uuid">Interpret a UUID</a></li>
41	daniel-mar	57	<li><a href="#interpret_mac">Interpret a MAC address (MAC / EUI / ELI / SAI / AAI)</a><ul>
		58	<li><a href="#gen_aai">Generate an AAI</a></li>
		59	</ul></li>
31	daniel-mar	60	</ul>
2	daniel-mar	61
31	daniel-mar	62	<h2 id="gen_uuid">Generate random and/or time-based UUIDs</h2>
30	daniel-mar	63
62	daniel-mar	64	<h3 id="gen_uuidv7"><font color="green">New:</font> Generate Unix Epoch Time (version 7) UUID ⭐</h3>
31	daniel-mar	65
35	daniel-mar	66	<p><i>A UUIDv7 is made of time and 74 random bits.
31	daniel-mar	67	Since the time is at the beginning, the UUIDs are monotonically increasing.
		68	Due to the missing MAC address, this UUID version is recommended due to
		69	improved privacy.</i></p>
		70
35	daniel-mar	71	<script>
		72	function show_uuidv7_info() {
		73	document.getElementById("uuidv7_info_button").style.display = "none";
		74	document.getElementById("uuidv7_info").style.display = "block";
		75	}
		76	</script>
62	daniel-mar	77	<p><a id="uuidv7_info_button" href="javascript:show_uuidv7_info()">Show format</a>
35	daniel-mar	78	<pre id="uuidv7_info" style="display:none">Variant 1, Version 7 UUID:
37	daniel-mar	79	- 48 bit <abbr title="Count of 1ms intervals passed since 1 Jan 1970 00:00:00 GMT">Unix Time in milliseconds</abbr>
35	daniel-mar	80	- 4 bit Version (fix 0x7)
		81	- 12 bit Random
		82	- 2 bit Variant (fix 0b10)
		83	- 62 bit Random</pre></p>
		84
31	daniel-mar	85	<?php
		86	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	87	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	88
		89	echo '<pre>';
		90	for ($i=0; $i<10; $i++) {
		91	$uuid = gen_uuid_v7();
		92	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		93	}
		94	echo '</pre>';
		95	}
		96	?>
		97
2	daniel-mar	98	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	99	<input type="hidden" name="version" value="7">
		100	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
2	daniel-mar	101	</form>
		102
32	daniel-mar	103	<h3 id="gen_uuidv6"><font color="green">New:</font> Generate reordered time-based (version 6) UUID ⏰</h3>
2	daniel-mar	104
31	daniel-mar	105	<p><i>Like UUIDv1, this kind of UUID is made of the MAC address of the generating computer,
		106	the time, and a clock sequence. However, the components in UUIDv6 are reordered (time is at the beginning),
		107	so that UUIDs are monotonically increasing.</i></p>
2	daniel-mar	108
35	daniel-mar	109	<script>
		110	function show_uuidv6_info() {
		111	document.getElementById("uuidv6_info_button").style.display = "none";
		112	document.getElementById("uuidv6_info").style.display = "block";
		113	}
		114	</script>
62	daniel-mar	115	<p><a id="uuidv6_info_button" href="javascript:show_uuidv6_info()">Show format</a>
35	daniel-mar	116	<pre id="uuidv6_info" style="display:none">Variant 1, Version 6 UUID:
37	daniel-mar	117	- 48 bit High <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	118	- 4 bit Version (fix 0x6)
37	daniel-mar	119	- 12 bit Low <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	120	- 2 bit Variant (fix 0b10)
		121	- 6 bit Clock Sequence High
		122	- 8 bit Clock Sequence Low
		123	- 48 bit MAC Address</pre></p>
		124
31	daniel-mar	125	<?php
		126	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	127	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	128
		129	echo '<pre>';
		130	for ($i=0; $i<10; $i++) {
		131	$uuid = gen_uuid_v6();
		132	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		133	}
		134	echo '</pre>';
		135	}
		136	?>
		137
2	daniel-mar	138	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	139	<input type="hidden" name="version" value="6">
		140	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	141	</form>
		142
31	daniel-mar	143	<h3 id="gen_uuidv4">Generate random (version 4) UUID 🎲</h3>
30	daniel-mar	144
35	daniel-mar	145	<p><i>A UUIDv4 is made of 122 random bits. No other information is encoded in this kind of UUID.</i></p>
30	daniel-mar	146
35	daniel-mar	147	<script>
		148	function show_uuidv4_info() {
		149	document.getElementById("uuidv4_info_button").style.display = "none";
		150	document.getElementById("uuidv4_info").style.display = "block";
		151	}
		152	</script>
62	daniel-mar	153	<p><a id="uuidv4_info_button" href="javascript:show_uuidv4_info()">Show format</a>
35	daniel-mar	154	<pre id="uuidv4_info" style="display:none">Variant 1, Version 4 UUID:
		155	- 48 bit Random High
		156	- 4 bit Version (fix 0x4)
		157	- 12 bit Random Mid
		158	- 2 bit Variant (fix 0b10)
		159	- 62 bit Random Low</pre></p>
		160
31	daniel-mar	161	<?php
		162	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	163	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	164
		165	echo '<pre>';
		166	for ($i=0; $i<10; $i++) {
		167	$uuid = gen_uuid_v4();
		168	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		169	}
		170	echo '</pre>';
		171	}
		172	?>
		173
30	daniel-mar	174	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	175	<input type="hidden" name="version" value="4">
		176	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	177	</form>
		178
32	daniel-mar	179	<h3 id="gen_uuidv1">Generate time-based (version 1) UUID ⏰</h3>
30	daniel-mar	180
31	daniel-mar	181	<p><i>A UUIDv1 is made of the MAC address of the generating computer,
		182	the time, and a clock sequence.</i></p>
30	daniel-mar	183
35	daniel-mar	184	<script>
		185	function show_uuidv1_info() {
		186	document.getElementById("uuidv1_info_button").style.display = "none";
		187	document.getElementById("uuidv1_info").style.display = "block";
		188	}
		189	</script>
62	daniel-mar	190	<p><a id="uuidv1_info_button" href="javascript:show_uuidv1_info()">Show format</a>
35	daniel-mar	191	<pre id="uuidv1_info" style="display:none">Variant 1, Version 1 UUID:
37	daniel-mar	192	- 32 bit Low <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
		193	- 16 bit Mid <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	194	- 4 bit Version (fix 0x1)
37	daniel-mar	195	- 12 bit High <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	196	- 2 bit Variant (fix 0b10)
		197	- 6 bit Clock Sequence High
		198	- 8 bit Clock Sequence Low
		199	- 48 bit MAC Address</pre></p>
		200
31	daniel-mar	201	<?php
		202	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	203	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	204
		205	echo '<pre>';
		206	for ($i=0; $i<10; $i++) {
		207	$uuid = gen_uuid_v1();
		208	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		209	}
		210	echo '</pre>';
		211	}
		212	?>
		213
30	daniel-mar	214	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	215	<input type="hidden" name="version" value="1">
		216	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	217	</form>
		218
31	daniel-mar	219	<h2 id="gen_other_uuid">Generate other UUID types</h2>
30	daniel-mar	220
47	daniel-mar	221	<p><i>The following types of UUIDs are less common and/or require special knowledge. Please only use the following
30	daniel-mar	222	generators if you know what you are doing.</i></p>
		223
53	daniel-mar	224	<h3 id="gen_uuid_ncs">NCS (variant 0) UUID</h3>
30	daniel-mar	225
53	daniel-mar	226	<p>The <abbr title="Network Computing System">NCS</abbr> UUIDs are a legacy format
		227	initially designed by Apollo Computer that cannot be generated anymore, because the
30	daniel-mar	228	amount of available timestamp bits was exhausted on <strong>5 September 2015</strong>.
53	daniel-mar	229	As an example, here is the last possible NCS UUID (all bits of the timestamp are set to 1) for IP address 127.0.0.1:
34	daniel-mar	230	<a href="interprete_uuid.php?uuid=ffffffff-ffff-0000-027f-000001000000"><code>ffffffff-ffff-0000-027f-000001000000</code></a>.</p>
30	daniel-mar	231
35	daniel-mar	232	<script>
		233	function show_uuidnce_info() {
		234	document.getElementById("uuidnce_info_button").style.display = "none";
		235	document.getElementById("uuidnce_info").style.display = "block";
		236	}
		237	</script>
62	daniel-mar	238	<p><a id="uuidnce_info_button" href="javascript:show_uuidnce_info()">Show format</a>
35	daniel-mar	239	<pre id="uuidnce_info" style="display:none">Variant 0 UUID:
37	daniel-mar	240	- 32 bit High <abbr title="Count of 4µs intervals passed since 1 Jan 1980 00:00:00 GMT">Time</abbr>
		241	- 16 bit Low <abbr title="Count of 4µs intervals passed since 1 Jan 1980 00:00:00 GMT">Time</abbr>
35	daniel-mar	242	- 16 bit Reserved
		243	- 1 bit Variant (fix 0b0)
37	daniel-mar	244	- 7 bit <abbr title="socket_$unspec (0x0)
		245	socket_$unix (0x1)
		246	socket_$internet (0x2)
		247	socket_$implink (0x3)
		248	socket_$pup (0x4)
		249	socket_$chaos (0x5)
		250	socket_$ns (0x6)
		251	socket_$nbs (0x7)
		252	socket_$ecma (0x8)
		253	socket_$datakit (0x9)
		254	socket_$ccitt (0xA)
		255	socket_$sna (0xB)
		256	socket_$unspec2 (0xC)
		257	socket_$dds (0xD)">Family</abbr>
35	daniel-mar	258	- 56 bit Node</pre></p>
		259
31	daniel-mar	260	<h3 id="gen_uuidv2">Generate DCE Security (version 2) UUID</h3>
30	daniel-mar	261
37	daniel-mar	262	<p><i>An UUIDv2 contains information about the creator (person, group, or organization), the generating system (MAC address), and time.
35	daniel-mar	263	The creator information replaced parts of the time bits, therefore the time resolution is very low.</i></p>
		264
		265	<script>
		266	function show_uuidv2_info() {
		267	document.getElementById("uuidv2_info_button").style.display = "none";
		268	document.getElementById("uuidv2_info").style.display = "block";
		269	}
		270	</script>
62	daniel-mar	271	<p><a id="uuidv2_info_button" href="javascript:show_uuidv2_info()">Show format</a>
35	daniel-mar	272	<pre id="uuidv2_info" style="display:none">Variant 1, Version 2 UUID:
		273	- 32 bit Local Domain Number
37	daniel-mar	274	- 16 bit Mid <abbr title="Count of 429.4967296s intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	275	- 4 bit Version (fix 0x2)
37	daniel-mar	276	- 12 bit High <abbr title="Count of 429.4967296s intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	277	- 2 bit Variant (fix 0b10)
		278	- 6 bit Clock Sequence
37	daniel-mar	279	- 8 bit <abbr title="0 = person
		280	1 = group
		281	2 = org
		282	3-255 = site-defined">Local Domain</abbr>
35	daniel-mar	283	- 48 bit MAC Address</pre></p>
		284
30	daniel-mar	285	<form method="GET" action="interprete_uuid.php">
2	daniel-mar	286	<input type="hidden" name="version" value="2">
35	daniel-mar	287	<label>Domain (8 bits):</label><select name="domain_choose" id="dce_domain_choice" onchange="javascript:dce_domain_choose();">
34	daniel-mar	288	<option value="uid">Person (e.g. POSIX UID)</option>
		289	<option value="gid">Group (e.g. POSIX GID)</option>
		290	<option value="org">Organization</option>
2	daniel-mar	291	<option value="site">Site-defined</option>
62	daniel-mar	292	</select> = Address Family ID: <input type="number" min="0" max="255" name="dce_domain" value="" id="dce_domain" style="width:50px" pattern="[0-9]+"> (decimal notation)<br>
35	daniel-mar	293	<label>Value (32 bits):</label><input type="number" min="0" max="4294967295" name="dce_id" value="0" id="dce_id" style="width:200px" pattern="[0-9]+"> (decimal notation)<br>
37	daniel-mar	294	<font color="red">Warning</font>: The timestamp has an accuracy of 7:10 minutes,
30	daniel-mar	295	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	296	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create UUIDv2">
2	daniel-mar	297	</form>
		298	<script>
		299	function dce_domain_choose() {
		300	var ns = document.getElementById('dce_domain_choice').value;
		301	if (ns == "uid") {
		302	document.getElementById('dce_domain').value = "0";
		303	}
		304	if (ns == "gid") {
		305	document.getElementById('dce_domain').value = "1";
		306	}
		307	if (ns == "org") {
		308	document.getElementById('dce_domain').value = "2";
		309	}
		310	if (ns == "site") {
		311	document.getElementById('dce_domain').value = "";
		312	}
		313	}
		314	dce_domain_choose();
		315	</script>
		316
61	daniel-mar	317	<h3 id="gen_uuidv35">Generate name-based (version 3 / 5 / <font color="green">New: 8</font>) UUID</h3>
2	daniel-mar	318
57	daniel-mar	319	<p><i>An UUIDv3 is made out of a MD5 hash and an UUIDv5 is made out of a SHA1 hash.
		320	The revision of RFC4122 also contains an example for a custom UUIDv8 that
59	daniel-mar	321	allows SHA2, SHA3 and SHAKE hash algorithms. ViaThinkSoft added more hash
61	daniel-mar	322	algorithms and assigned Hash Space IDs to them.</i></p>
35	daniel-mar	323
		324	<script>
		325	function show_uuidv35_info() {
		326	document.getElementById("uuidv35_info_button").style.display = "none";
		327	document.getElementById("uuidv35_info").style.display = "block";
		328	}
		329	</script>
62	daniel-mar	330	<p><a id="uuidv35_info_button" href="javascript:show_uuidv35_info()">Show format</a>
58	daniel-mar	331	<pre id="uuidv35_info" style="display:none">Variant 1, Version 3/5/8 UUID:
35	daniel-mar	332	- 48 bit Hash High
58	daniel-mar	333	- 4 bit Version (fix 0x3, 0x5, or 0x8)
35	daniel-mar	334	- 12 bit Hash Mid
		335	- 2 bit Variant (fix 0b10)
62	daniel-mar	336	- 62 bit Hash Low
35	daniel-mar	337
62	daniel-mar	338
		339
		340	<u>Overview of namebased UUIDs:</u>
		341	UUIDv3(<i>NamespaceUuid</i>, <i>Data</i>) := <abbr title="Adds UUID variant 0b10 and version 3">ConvertRawBytesToUuid_v3</abbr>(MD5( Binary[<i>NameSpaceUuid</i>] \|\| <i>Data</i> )).
		342	UUIDv5(<i>NamespaceUuid</i>, <i>Data</i>) := <abbr title="Adds UUID variant 0b10 and version 5">ConvertRawBytesToUuid_v5</abbr>(SHA1( Binary[<i>NameSpaceUuid</i>] \|\| <i>Data</i> )).
		343	UUIDv8(<i>HashAlgo</i>, <i>NameSpaceUuid</i>, <i>Data</i>) := <abbr title="Adds UUID variant 0b10 and version 8">ConvertRawBytesToUuid_v8</abbr>(<i>HashAlgo</i>( Binary[HashSpaceUuid<<i>HashAlgo</i>>] \|\| Binary[<i>NameSpaceUuid</i>] \|\| <i>Data</i> )).
		344
66	daniel-mar	345	<u>As defined by <a href="https://datatracker.ietf.org/doc/rfc4122/">RFC4122</a> Appendix C / <a href="https://datatracker.ietf.org/doc/draft-ietf-uuidrev-rfc4122bis/">draft-ietf-uuidrev-rfc4122bis-11</a> Appendix A:</u><!-- TODO: When new RFC is published, replace the RFC number -->
62	daniel-mar	346	NameSpaceUuid<DNS> := "6ba7b810-9dad-11d1-80b4-00c04fd430c8".
		347	NameSpaceUuid<URL> := "6ba7b811-9dad-11d1-80b4-00c04fd430c8".
		348	NameSpaceUuid<OID> := "6ba7b812-9dad-11d1-80b4-00c04fd430c8".
		349	NameSpaceUuid<X500> := "6ba7b814-9dad-11d1-80b4-00c04fd430c8".
		350
67	daniel-mar	351	<u>As defined by <a href="https://datatracker.ietf.org/doc/draft-ietf-uuidrev-rfc4122bis/">draft-ietf-uuidrev-rfc4122bis-11</a> Appendix B:</u>
66	daniel-mar	352	<?php
62	daniel-mar	353
66	daniel-mar	354	$tmp = [];
		355	foreach (get_uuidv8_hash_space_ids() as list($algo,$space,$friendlyName,$author,$available)) {
		356	if (strpos($author,'ViaThinkSoft') === false) {
		357	$line = str_pad('HashSpaceUuid<'.htmlentities($friendlyName).'>', 34, ' ', STR_PAD_RIGHT);
		358	$line .= ':= "'.$space.'".';
		359	if (!$available) $line .= " (Currently not available on this system)";
		360	$line .= "\n";
67	daniel-mar	361	if (isset($tmp[$friendlyName])) continue; // Ignore "Internet Draft 12 Proposal"
66	daniel-mar	362	$tmp[$friendlyName] = $line;
		363	}
		364	}
		365	ksort($tmp);
		366	foreach ($tmp as $line) {
		367	echo $line;
		368	}
		369
		370	?>
		371
67	daniel-mar	372	<u>As defined in <a href="https://github.com/ietf-wg-uuidrev/rfc4122bis/issues/143#issuecomment-1709117798">Internet Draft 12 Proposal</a>:</u>
		373	HashSpaceUuid<<i>HashAlgo</i>> := UUIDv5(NS_OID, OID[<i>HashAlgo</i>]).
		374	which results in the following UUIDs:
		375	<?php
		376
		377	$tmp = [];
		378	foreach (get_uuidv8_hash_space_ids() as list($algo,$space,$friendlyName,$author,$available)) {
		379	if (strpos($author,'ViaThinkSoft') === false) {
		380	$line = str_pad('HashSpaceUuid<'.htmlentities($friendlyName).'>', 34, ' ', STR_PAD_RIGHT);
		381	$line .= ':= "'.$space.'".';
		382	if (!$available) $line .= " (Currently not available on this system)";
		383	$line .= "\n";
		384	$tmp[$friendlyName] = $line;
		385	}
		386	}
		387	ksort($tmp);
		388	foreach ($tmp as $line) {
		389	echo $line;
		390	}
		391
		392	?>
		393
62	daniel-mar	394	<u>As defined by ViaThinkSoft for all other algorithms:</u>
		395	HashSpaceUuid<<i>HashAlgo</i>> := UUIDv5("1ee317e2-1853-64b2-8fe9-3c4a92df8582", <a href="https://www.php.net/manual/de/function.hash-algos.php">PhpName</a>[<i>HashAlgo</i>]).
		396	which results in the following UUIDs:
		397	<?php
		398
		399	$tmp = [];
		400	foreach (get_uuidv8_hash_space_ids() as list($algo,$space,$friendlyName,$author,$available)) {
66	daniel-mar	401	if (strpos($author,'ViaThinkSoft') !== false) {
		402	$line = str_pad('HashSpaceUuid<'.htmlentities($friendlyName).'>', 34, ' ', STR_PAD_RIGHT);
		403	$line .= ':= "'.$space.'".';
		404	if (!$available) $line .= " (Currently not available on this system)";
		405	$line .= "\n";
		406	$tmp[$friendlyName] = $line;
		407	}
62	daniel-mar	408	}
		409	ksort($tmp);
		410	foreach ($tmp as $line) {
		411	echo $line;
		412	}
		413
		414	?>
		415
		416
		417	</pre></p>
		418
35	daniel-mar	419	<style>
		420	label {
		421	width:120px;
		422	text-align:left;
		423	margin-right: 20px;
		424	display:inline-block;
		425	}
		426	</style>
		427
2	daniel-mar	428	<form method="GET" action="interprete_uuid.php">
59	daniel-mar	429	<label>Hash algorithm:</label><select name="version" id="nb_version" onchange="javascript:nb_version_choose();">
		430	<?php
67	daniel-mar	431
		432	echo "\t\t<option disabled>--- UUIDv3 (RFC 4122) ---</option>\n";
		433	echo "\t\t<option value=\"3\">MD5</option>\n";
		434	echo "\t\t<option disabled>--- UUIDv5 (RFC 4122) ---</option>\n";
		435	echo "\t\t<option value=\"5\" selected>SHA1</option>\n";
		436
		437	$categories = [];
62	daniel-mar	438	foreach (get_uuidv8_hash_space_ids() as list($algo,$space,$friendlyName,$author,$available)) {
67	daniel-mar	439	if (!in_array($author, $categories)) $categories[] = $author;
		440	}
		441	sort($categories);
		442
		443	foreach ($categories as $category) {
		444	echo "\t\t<option disabled>--- UUIDv8 (defined by ".htmlentities($category).") ---</option>\n";
		445	$tmp = [];
		446	foreach (get_uuidv8_hash_space_ids() as list($algo,$space,$friendlyName,$author,$available)) {
		447	if ($author != $category) continue;
		448	if ($available) {
		449	$tmp[$friendlyName] = '<option value="8_namebased_'.$space.'">'.htmlentities($friendlyName).'</option>';
		450	}
62	daniel-mar	451	}
67	daniel-mar	452	ksort($tmp);
		453	foreach ($tmp as $html) {
		454	echo "\t\t$html\n";
		455	}
59	daniel-mar	456	}
		457	?>
		458	</select><font size="-1"><span id="nb_hash_info"></span></font><br>
35	daniel-mar	459	<label>Namespace:</label><select name="namespace_choose" id="nb_nsc" onchange="javascript:nb_ns_choose();">
2	daniel-mar	460	<option value="dns">DNS</option>
		461	<option value="url">URL</option>
		462	<option value="oid">OID</option>
		463	<option value="x500">X.500 DN</option>
35	daniel-mar	464	<!-- <option value="oidplus_ns">OIDplus ns only</option> -->
		465	<!-- <option value="oidplus_ns_val">OIDplus ns+val</option> -->
28	daniel-mar	466	<!-- <option value="oidplus_pubkey">OIDplus pubkey</option> -->
2	daniel-mar	467	<option value="other">Other</option>
59	daniel-mar	468	</select> = Namespace UUID: <input type="text" name="nb_ns" value="" id="nb_ns" style="width:270px" onchange="javascript:nb_ns_textchange();" pattern="[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}"><br>
35	daniel-mar	469	<label>Value:</label><input type="text" name="nb_val" value="" id="nb_val" style="width:300px"><br>
30	daniel-mar	470	<font color="red">Warning</font>: These UUIDs do not contain a timestamp,
		471	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	472	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" id="nb_create_btn" value="Create UUID">
2	daniel-mar	473	</form>
		474	<script>
59	daniel-mar	475	function nb_version_choose() {
		476	var ver = document.getElementById('nb_version').value;
		477	document.getElementById('nb_create_btn').value = 'Create UUIDv' + ver.substr(0,1);
		478	var x = ver.split('_namebased_');
		479	if (x.length == 2) {
61	daniel-mar	480	document.getElementById('nb_hash_info').innerHTML = ' (UUIDv8 Hash Space ID: ' + x[1] + ')';
59	daniel-mar	481	} else {
		482	document.getElementById('nb_hash_info').innerHTML = '';
		483	}
		484
		485	}
35	daniel-mar	486	function nb_ns_textchange() {
		487	var ns = document.getElementById('nb_ns').value.toLowerCase();
		488	if (ns == "6ba7b810-9dad-11d1-80b4-00c04fd430c8") {
		489	if (document.getElementById('nb_nsc').value != "dns") {
		490	document.getElementById('nb_nsc').value = "dns";
57	daniel-mar	491	document.getElementById('nb_val').value = "www.example.com";
35	daniel-mar	492	}
		493	}
		494	else if (ns == "6ba7b811-9dad-11d1-80b4-00c04fd430c8") {
		495	if (document.getElementById('nb_nsc').value != "url") {
		496	document.getElementById('nb_nsc').value = "url";
57	daniel-mar	497	document.getElementById('nb_val').value = "http://www.example.com/";
35	daniel-mar	498	}
		499	}
		500	else if (ns == "6ba7b812-9dad-11d1-80b4-00c04fd430c8") {
		501	if (document.getElementById('nb_nsc').value != "oid") {
		502	document.getElementById('nb_nsc').value = "oid";
		503	document.getElementById('nb_val').value = "2.999";
		504	}
		505	}
		506	else if (ns == "6ba7b814-9dad-11d1-80b4-00c04fd430c8") {
		507	if (document.getElementById('nb_nsc').value != "x500") {
		508	document.getElementById('nb_nsc').value = "x500";
		509	document.getElementById('nb_val').value = "UID=jsmith,DC=example,DC=net";
		510	}
		511	}
		512	else {
		513	if (document.getElementById('nb_nsc').value != "other") {
		514	document.getElementById('nb_nsc').value = "other";
		515	document.getElementById('nb_val').value = "";
		516	}
		517	}
		518	}
2	daniel-mar	519	function nb_ns_choose() {
		520	var ns = document.getElementById('nb_nsc').value;
		521	if (ns == "dns") {
		522	document.getElementById('nb_ns').value = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
57	daniel-mar	523	document.getElementById('nb_val').value = "www.example.com";
2	daniel-mar	524	}
35	daniel-mar	525	else if (ns == "url") {
2	daniel-mar	526	document.getElementById('nb_ns').value = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
57	daniel-mar	527	document.getElementById('nb_val').value = "http://www.example.com/";
2	daniel-mar	528	}
35	daniel-mar	529	else if (ns == "oid") {
2	daniel-mar	530	document.getElementById('nb_ns').value = "6ba7b812-9dad-11d1-80b4-00c04fd430c8";
		531	document.getElementById('nb_val').value = "2.999";
		532	}
35	daniel-mar	533	else if (ns == "x500") {
2	daniel-mar	534	document.getElementById('nb_ns').value = "6ba7b814-9dad-11d1-80b4-00c04fd430c8";
		535	document.getElementById('nb_val').value = "UID=jsmith,DC=example,DC=net";
		536	}
35	daniel-mar	537	/*
		538	else if (ns == "oidplus_ns") {
2	daniel-mar	539	document.getElementById('nb_ns').value = "0943e3ce-4b79-11e5-b742-78e3b5fc7f22";
		540	document.getElementById('nb_val').value = "ipv4";
		541	}
35	daniel-mar	542	else if (ns == "oidplus_ns_val") {
2	daniel-mar	543	document.getElementById('nb_ns').value = "ad1654e6-7e15-11e4-9ef6-78e3b5fc7f22";
		544	document.getElementById('nb_val').value = "ipv4:8.8.8.8";
		545	}
35	daniel-mar	546	else if (ns == "oidplus_ns_pubkey") {
28	daniel-mar	547	document.getElementById('nb_ns').value = "fd16965c-8bab-11ed-8744-3c4a92df8582";
31	daniel-mar	548	document.getElementById('nb_val').value = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqg/PnsC1WX3C1/mUSLuk0DIaDHtEsxBnG0auYJRJ1hBtbUUvItbK0odlKrX2SFo1MJJpu/SSxTzAgqkKZsZe3cCFkgA1svfuH9i94oGLjJ4n0kRJEGlanCmGndJBfIqGDJaQE2BJ8tLxeBrpkd9l0KvJsjhRmqJAb9KYK3KYFsWvT+wyjD3UJ1eHcgLbF/Qb3cwMU/u7Fs7ZpsNMW4phDPlsYsk9XHFpJ1/UCj6G53mYRfOC/ouDdGShlbVLB15s0V95QpnU/7lL8mJ2lE+sTZekGNBA4XbJv2gs21cR4E8zc/z+NyZS7117DYZoJqrAN8sKz6xGoKgQF6wueCK5qQIDAQAB";
28	daniel-mar	549	}
		550	*/
35	daniel-mar	551	else if (ns == "other") {
2	daniel-mar	552	document.getElementById('nb_ns').value = "";
		553	document.getElementById('nb_val').value = "";
		554	}
		555	}
59	daniel-mar	556	nb_version_choose();
2	daniel-mar	557	nb_ns_choose();
		558	</script>
		559
61	daniel-mar	560	<h3 id="gen_uuidv8"><font color="green">New:</font> Generate Custom (version 8) UUID</h3>
34	daniel-mar	561
37	daniel-mar	562	<p><i>UUIDv8 is made of 122 bits application-specific / custom data. The other 6 bits are used to specify the variant and version of the UUID, to make it RFC-compatible.</i></p>
35	daniel-mar	563
		564	<script>
		565	function show_uuidv8_info() {
		566	document.getElementById("uuidv8_info_button").style.display = "none";
		567	document.getElementById("uuidv8_info").style.display = "block";
		568	}
65	daniel-mar	569	function uuidv8_changedec(block, len) {
		570	var x = document.getElementById("v8_block"+block+"_dec").value;
		571	if (x.trim() == "") x = 0;
		572	x = parseInt(x);
		573	if (isNaN(x)) {
		574	x = "???";
		575	} else {
		576	x = x.toString(16).padStart(len, '0');
		577	if ((len > 0) && (x.length > len)) x = "Overflow";
		578	}
		579	document.getElementById("v8_block"+block+"_hex").value = x;
		580	}
		581	function uuidv8_changehex(block, len) {
		582	var x = document.getElementById("v8_block"+block+"_hex").value;
		583	if (x.trim() == "") x = 0;
		584	x = parseInt(x, 16);
		585	if (isNaN(x)) {
		586	x = "???";
		587	} else {
		588	x = x.toString().padStart(len, '0');
		589	if ((len > 0) && (x.length > len)) x = "Overflow"; // Note: For block 3/4, the overflow actually happens at 12/14 bits, not at 4 nibbles (16 bits)
		590	}
		591	document.getElementById("v8_block"+block+"_dec").value = x;
		592	}
35	daniel-mar	593	</script>
62	daniel-mar	594	<p><a id="uuidv8_info_button" href="javascript:show_uuidv8_info()">Show format</a>
35	daniel-mar	595	<pre id="uuidv8_info" style="display:none">Variant 1, Version 8 UUID:
63	daniel-mar	596	- 48 bit Custom data [Block 1+2]
35	daniel-mar	597	- 4 bit Version (fix 0x8)
63	daniel-mar	598	- 12 bit Custom data [Block 3]
35	daniel-mar	599	- 2 bit Variant (fix 0b10)
63	daniel-mar	600	- 62 bit Custom data [Block 4+5]</pre></p>
35	daniel-mar	601
34	daniel-mar	602	<form method="GET" action="interprete_uuid.php">
		603	<input type="hidden" name="version" value="8">
65	daniel-mar	604
		605	<label>Block 1 (32 bits):</label>0x<input type="text" name="block1" value="00000000" maxlength="8" id="v8_block1_hex" onkeyup="uuidv8_changehex(1, 0)" style="width:150px" pattern="[0-9a-fA-F]+"> = Decimal
		606	<input type="number" name="block1dec" value="0" min="0" maxlength="20" id="v8_block1_dec" onmouseup="uuidv8_changedec(1, 8)" onkeyup="uuidv8_changedec(1, 8)" style="width:150px"><br>
		607
		608	<label>Block 2 (16 bits):</label>0x<input type="text" name="block2" value="0000" maxlength="4" id="v8_block2_hex" onkeyup="uuidv8_changehex(2, 0)" style="width:150px" pattern="[0-9a-fA-F]+"> = Decimal
		609	<input type="number" name="block2dec" value="0" min="0" maxlength="20" id="v8_block2_dec" onmouseup="uuidv8_changedec(2, 4)" onkeyup="uuidv8_changedec(2, 4)" style="width:150px"><br>
		610
		611	<label>Block 3 (<abbr title="The high 4 bits are occupied by the UUID version = 8">12 bits</abbr>):</label>0x<input type="text" name="block3" value="0000" maxlength="4" id="v8_block3_hex" onkeyup="uuidv8_changehex(3, 0)" style="width:150px" pattern="[0-9a-fA-F]+"> = Decimal
		612	<input type="number" name="block3dec" value="0" min="0" maxlength="20" id="v8_block3_dec" onmouseup="uuidv8_changedec(3, 4)" onkeyup="uuidv8_changedec(3, 4)" style="width:150px"><br>
		613
		614	<label>Block 4 (<abbr title="The high 2 bits are occupied by the UUID variant = 0b10">14 bits</abbr>):</label>0x<input type="text" name="block4" value="0000" maxlength="4" id="v8_block4_hex" onkeyup="uuidv8_changehex(4, 0)" style="width:150px" pattern="[0-9a-fA-F]+"> = Decimal
		615	<input type="number" name="block4dec" value="0" min="0" maxlength="20" id="v8_block4_dec" onmouseup="uuidv8_changedec(4, 4)" onkeyup="uuidv8_changedec(4, 4)" style="width:150px"><br>
		616
		617	<label>Block 5 (48 bits):</label>0x<input type="text" name="block5" value="000000000000" maxlength="12" id="v8_block5_hex" onkeyup="uuidv8_changehex(5, 0)" style="width:150px" pattern="[0-9a-fA-F]+"> = Decimal
		618	<input type="number" name="block5dec" value="0" min="0" maxlength="20" id="v8_block5_dec" onmouseup="uuidv8_changedec(5, 12)" onkeyup="uuidv8_changedec(5, 12)" style="width:150px"><br>
		619
34	daniel-mar	620	<font color="red">Warning</font>: These UUIDs do not contain a timestamp,
		621	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	622	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create UUIDv8">
34	daniel-mar	623	</form>
		624
31	daniel-mar	625	<h2 id="interpret_uuid">Interpret a UUID</h2>
2	daniel-mar	626
30	daniel-mar	627	<p>You can enter a UUID in the following notations:</p>
2	daniel-mar	628
		629	<ul>
		630	<li>Classic notation (case insensitive, curly braces optional): <code>9e83839a-5967-11e4-8c1c-78e3b5fc7f22</code></li>
		631	<li>As OID: <code>2.25.210700883446948645633376489934419689250</code></li>
		632	</ul>
		633
		634	<p>The script will output:</p>
		635
		636	<ul>
		637	<li>Notation as UUID and OID</li>
35	daniel-mar	638	<li>Version, variant, and additional data (date and time, clock sequence, node id, etc.)</li>
2	daniel-mar	639	</ul>
		640
30	daniel-mar	641	<p>Please enter a UUID or UUID OID:</p>
2	daniel-mar	642
		643	<form method="GET" action="interprete_uuid.php">
32	daniel-mar	644	<input type="text" name="uuid" value="" style="width:300px"> <input type="submit" value="Interprete">
2	daniel-mar	645	</form>
		646
31	daniel-mar	647	<h2 id="interpret_mac">Interpret a MAC address (<abbr title="Media Access Control">MAC</abbr> /
26	daniel-mar	648	<abbr title="Extended Unique Identifier">EUI</abbr> /
		649	<abbr title="Extended Local Identifier">ELI</abbr> /
		650	<abbr title="Standard Assigned Identifier">SAI</abbr> /
		651	<abbr title="Administratively Assigned Identifier">AAI</abbr>)</h2>
2	daniel-mar	652
30	daniel-mar	653	<p>You can enter a UUID in the following notations:</p>
2	daniel-mar	654
		655	<ul>
		656	<li><code>AA-BB-CC-DD-EE-FF</code></li>
		657	<li><code>AA:BB:CC:DD:EE:FF</code></li>
		658	<li><code>AABBCC.DDEEFF</code> (case insensitive)</li>
16	daniel-mar	659	<li><code>AA-BB-CC-DD-EE-FF-11-22</code> (EUI-64)</li>
		660	<li><code>AA:BB:CC:DD:EE:FF-11-22</code> (EUI-64)</li>
		661	<li><code>fe80::1322:33ff:fe44:5566</code> (IPv6 Link Local / EUI-64)</li>
2	daniel-mar	662	</ul>
		663
		664	<p>The script will output:</p>
		665
		666	<ul>
		667	<li>Information about the I/G and U/L flags.</li>
		668	<li>Information about the entry in the IEEE registry, if available.</li>
		669	<li>Information about the registrant, if available.</li>
		670	</ul>
		671
29	daniel-mar	672	<p>Please enter a MAC (EUI, ELI, SAI, AAI), or IPv6-Link-Local address:</p>
2	daniel-mar	673
		674	<form method="GET" action="interprete_mac.php">
32	daniel-mar	675	<input type="text" name="mac" value="" style="width:250px"> <input type="submit" value="Interprete">
2	daniel-mar	676	</form>
		677
62	daniel-mar	678	<h3 id="gen_aai">Generate an <abbr title="Administratively Assigned Identifier">AAI</abbr></h3>
41	daniel-mar	679
		680	<p><i>An Administratively Assigned Identifier (AAI) is a MAC address which can be locally defined
		681	by applications or an administrator. Unlike the EUI, an AAI is NOT worldwide unique.</i></p>
		682
		683	<form method="GET" action="interprete_mac.php">
		684	<input type="hidden" name="aai_gen" value="1">
		685	<input type="hidden" name="aai_gen_bits" value="48">
		686	<input type="hidden" name="aai_gen_multicast" value="0">
		687	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate AAI-48">
		688	</form>
		689
		690	<br>
		691
		692	<form method="GET" action="interprete_mac.php">
		693	<input type="hidden" name="aai_gen" value="1">
		694	<input type="hidden" name="aai_gen_bits" value="64">
		695	<input type="hidden" name="aai_gen_multicast" value="0">
		696	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate AAI-64">
		697	</form>
		698
		699	<p>The following options are rather unusual, but are implemented for the sake of completeness:</p>
		700
		701	<form method="GET" action="interprete_mac.php">
		702	<input type="hidden" name="aai_gen" value="1">
		703	<input type="hidden" name="aai_gen_bits" value="48">
		704	<input type="hidden" name="aai_gen_multicast" value="1">
		705	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate Multicast AAI-48">
		706	</form>
		707
		708	<br>
		709
		710	<form method="GET" action="interprete_mac.php">
		711	<input type="hidden" name="aai_gen" value="1">
		712	<input type="hidden" name="aai_gen_bits" value="64">
		713	<input type="hidden" name="aai_gen_multicast" value="1">
		714	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate Multicast AAI-64">
		715	</form>
		716
		717
22	daniel-mar	718	<br><br><br>
		719
2	daniel-mar	720	</body>
		721
		722	</html>

Subversion Repositories uuid_mac_utils

uuid_mac_utils/trunk/index.php – Rev 67