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
82	daniel-mar	5	* Copyright 2017 - 2024 Daniel Marschall, ViaThinkSoft
		6	* Version 2024-03-09
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
72	daniel-mar	23	const AUTO_NEW_UUIDS = 15;
31	daniel-mar	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>
75	daniel-mar	45	<li><a href="#gen_uuidv7"><font color="green">New:</font> Generate Unix Epoch time-based (version 7) UUID</a></li>
		46	<li><a href="#gen_uuidv6"><font color="green">New:</font> Generate reordered Gregorian time-based (version 6) UUID</a></li>
31	daniel-mar	47	<li><a href="#gen_uuidv4">Generate random (version 4) UUID</a></li>
75	daniel-mar	48	<li><a href="#gen_uuidv1">Generate Gregorian time-based (version 1) UUID</a></li>
82	daniel-mar	49	<li><a href="#gen_uuidv8_sqlserver"><font color="green">New:</font> Generate SQL server sortable time-based (version 8) UUID</a></li>
31	daniel-mar	50	</ul></li>
		51	<li><a href="#gen_other_uuid">Generate other UUID types</a><ul>
53	daniel-mar	52	<li><a href="#gen_uuid_ncs">NCS (variant 0) UUID</a></li>
31	daniel-mar	53	<li><a href="#gen_uuidv2">Generate DCE Security (version 2) UUID</a></li>
61	daniel-mar	54	<li><a href="#gen_uuidv35">Generate name-based (version 3 / 5 / <font color="green">New: 8</font>) UUID</a></li>
		55	<li><a href="#gen_uuidv8"><font color="green">New:</font> Generate Custom (version 8) UUID</a></li>
31	daniel-mar	56	</ul></li>
		57	<li><a href="#interpret_uuid">Interpret a UUID</a></li>
41	daniel-mar	58	<li><a href="#interpret_mac">Interpret a MAC address (MAC / EUI / ELI / SAI / AAI)</a><ul>
		59	<li><a href="#gen_aai">Generate an AAI</a></li>
		60	</ul></li>
31	daniel-mar	61	</ul>
2	daniel-mar	62
31	daniel-mar	63	<h2 id="gen_uuid">Generate random and/or time-based UUIDs</h2>
30	daniel-mar	64
75	daniel-mar	65	<h3 id="gen_uuidv7"><font color="green">New:</font> Generate Unix Epoch time-based (version 7) UUID ⭐</h3>
31	daniel-mar	66
72	daniel-mar	67	<p><i>A UUIDv7 measures time in the Unix Epoch with an accuracy
		68	between 1ms and 245ns, depending on how many bits are spent for the timestamp (48-60 bits).
		69	The rest of the UUID (62-74 bits) is filled with random data.
		70	The timestamp is at the front of the UUID, therefore the UUIDs are monotonically increasing,
75	daniel-mar	71	which is good for using them in database indexes.
		72	Since this UUID version does not contain a MAC address, it is also
72	daniel-mar	73	recommended due to the improved privacy.</i></p>
31	daniel-mar	74
35	daniel-mar	75	<script>
		76	function show_uuidv7_info() {
		77	document.getElementById("uuidv7_info_button").style.display = "none";
		78	document.getElementById("uuidv7_info").style.display = "block";
		79	}
		80	</script>
62	daniel-mar	81	<p><a id="uuidv7_info_button" href="javascript:show_uuidv7_info()">Show format</a>
35	daniel-mar	82	<pre id="uuidv7_info" style="display:none">Variant 1, Version 7 UUID:
37	daniel-mar	83	- 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	84	- 4 bit Version (fix 0x7)
70	daniel-mar	85	- 12 bit Data
35	daniel-mar	86	- 2 bit Variant (fix 0b10)
70	daniel-mar	87	- 62 bit Data
35	daniel-mar	88
70	daniel-mar	89	Structure of data (74 bits):
		90	- OPTIONAL : Sub-millisecond timestamp fraction (0-12 bits)
		91	- OPTIONAL : Carefully seeded counter
		92	- Random generated bits for any remaining space
		93
		94	Time resolution for various sub-millisecond bits:
31	daniel-mar	95	<?php
70	daniel-mar	96	for ($num_ms_frac_bits=0; $num_ms_frac_bits<=12; $num_ms_frac_bits++) {
		97	$resolution_ns = 1000000 / pow(2,$num_ms_frac_bits);
		98	if ($resolution_ns >= 1000000) $resolution_ns_hf = ($resolution_ns/1000000)." ms";
		99	else if ($resolution_ns >= 1000) $resolution_ns_hf = ($resolution_ns/1000)." µs";
		100	else $resolution_ns_hf = "$resolution_ns ns";
		101	echo "$num_ms_frac_bits bits fraction = $resolution_ns_hf\n";
		102	}
		103	?>
72	daniel-mar	104
		105	This implementation outputs:
		106	- 12 bits sub-millisecond timestamp (~245ns resolution)
		107	- no counter
		108	- 62 bits random data
70	daniel-mar	109	</pre></p>
		110
		111	<?php
31	daniel-mar	112	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	113	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	114
		115	echo '<pre>';
70	daniel-mar	116	for ($i=0; $i<AUTO_NEW_UUIDS; $i++) {
31	daniel-mar	117	$uuid = gen_uuid_v7();
		118	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		119	}
		120	echo '</pre>';
		121	}
		122	?>
		123
2	daniel-mar	124	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	125	<input type="hidden" name="version" value="7">
		126	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
2	daniel-mar	127	</form>
		128
75	daniel-mar	129	<h3 id="gen_uuidv6"><font color="green">New:</font> Generate reordered Gregorian time-based (version 6) UUID ⏰</h3>
2	daniel-mar	130
31	daniel-mar	131	<p><i>Like UUIDv1, this kind of UUID is made of the MAC address of the generating computer,
		132	the time, and a clock sequence. However, the components in UUIDv6 are reordered (time is at the beginning),
75	daniel-mar	133	so that UUIDs are monotonically increasing, which is good for using them in database indexes.</i></p>
2	daniel-mar	134
35	daniel-mar	135	<script>
		136	function show_uuidv6_info() {
		137	document.getElementById("uuidv6_info_button").style.display = "none";
		138	document.getElementById("uuidv6_info").style.display = "block";
		139	}
		140	</script>
62	daniel-mar	141	<p><a id="uuidv6_info_button" href="javascript:show_uuidv6_info()">Show format</a>
35	daniel-mar	142	<pre id="uuidv6_info" style="display:none">Variant 1, Version 6 UUID:
37	daniel-mar	143	- 48 bit High <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	144	- 4 bit Version (fix 0x6)
37	daniel-mar	145	- 12 bit Low <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	146	- 2 bit Variant (fix 0b10)
		147	- 6 bit Clock Sequence High
		148	- 8 bit Clock Sequence Low
		149	- 48 bit MAC Address</pre></p>
		150
31	daniel-mar	151	<?php
		152	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	153	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	154
		155	echo '<pre>';
70	daniel-mar	156	for ($i=0; $i<AUTO_NEW_UUIDS; $i++) {
31	daniel-mar	157	$uuid = gen_uuid_v6();
		158	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		159	}
		160	echo '</pre>';
		161	}
		162	?>
		163
2	daniel-mar	164	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	165	<input type="hidden" name="version" value="6">
		166	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	167	</form>
		168
31	daniel-mar	169	<h3 id="gen_uuidv4">Generate random (version 4) UUID 🎲</h3>
30	daniel-mar	170
35	daniel-mar	171	<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	172
35	daniel-mar	173	<script>
		174	function show_uuidv4_info() {
		175	document.getElementById("uuidv4_info_button").style.display = "none";
		176	document.getElementById("uuidv4_info").style.display = "block";
		177	}
		178	</script>
62	daniel-mar	179	<p><a id="uuidv4_info_button" href="javascript:show_uuidv4_info()">Show format</a>
35	daniel-mar	180	<pre id="uuidv4_info" style="display:none">Variant 1, Version 4 UUID:
		181	- 48 bit Random High
		182	- 4 bit Version (fix 0x4)
		183	- 12 bit Random Mid
		184	- 2 bit Variant (fix 0b10)
		185	- 62 bit Random Low</pre></p>
		186
31	daniel-mar	187	<?php
		188	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	189	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	190
		191	echo '<pre>';
70	daniel-mar	192	for ($i=0; $i<AUTO_NEW_UUIDS; $i++) {
31	daniel-mar	193	$uuid = gen_uuid_v4();
		194	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		195	}
		196	echo '</pre>';
		197	}
		198	?>
		199
30	daniel-mar	200	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	201	<input type="hidden" name="version" value="4">
		202	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	203	</form>
		204
75	daniel-mar	205	<h3 id="gen_uuidv1">Generate Gregorian time-based (version 1) UUID ⏰</h3>
30	daniel-mar	206
31	daniel-mar	207	<p><i>A UUIDv1 is made of the MAC address of the generating computer,
		208	the time, and a clock sequence.</i></p>
30	daniel-mar	209
35	daniel-mar	210	<script>
		211	function show_uuidv1_info() {
		212	document.getElementById("uuidv1_info_button").style.display = "none";
		213	document.getElementById("uuidv1_info").style.display = "block";
		214	}
		215	</script>
62	daniel-mar	216	<p><a id="uuidv1_info_button" href="javascript:show_uuidv1_info()">Show format</a>
35	daniel-mar	217	<pre id="uuidv1_info" style="display:none">Variant 1, Version 1 UUID:
37	daniel-mar	218	- 32 bit Low <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
		219	- 16 bit Mid <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	220	- 4 bit Version (fix 0x1)
37	daniel-mar	221	- 12 bit High <abbr title="Count of 100ns intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	222	- 2 bit Variant (fix 0b10)
		223	- 6 bit Clock Sequence High
		224	- 8 bit Clock Sequence Low
		225	- 48 bit MAC Address</pre></p>
		226
31	daniel-mar	227	<?php
		228	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
35	daniel-mar	229	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
31	daniel-mar	230
		231	echo '<pre>';
70	daniel-mar	232	for ($i=0; $i<AUTO_NEW_UUIDS; $i++) {
31	daniel-mar	233	$uuid = gen_uuid_v1();
		234	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		235	}
		236	echo '</pre>';
		237	}
		238	?>
		239
30	daniel-mar	240	<form method="GET" action="interprete_uuid.php">
31	daniel-mar	241	<input type="hidden" name="version" value="1">
		242	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID">
30	daniel-mar	243	</form>
		244
82	daniel-mar	245	<h3 id="gen_uuidv8_sqlserver">Generate SQL server sortable time-based (version 8) UUID</h3>
		246
		247	<p><i>The sorting of SQL Server is rather confusing and incompatible with UUIDv6 and UUIDv7.<br>
		248	Therefore this method developed by <a href="https://www.hickelsoft.de/">HickelSOFT</a>
83	daniel-mar	249	generates UUIDs which are sortable by SQL Server.<br>
		250	They have a time resolution of 1 milliseconds combined with 18 bits of random data.</i><br>
82	daniel-mar	251	<a href="https://gist.github.com/danielmarschall/7fafd270a3bc107d38e8449ce7420c25">C# implementation</a> \|
		252	<a href="https://github.com/danielmarschall/uuid_mac_utils/blob/master/includes/uuid_utils.inc.php">PHP implementation</a>
		253	</p>
		254
		255	<script>
		256	function show_uuidv8_sqlserver_info() {
		257	document.getElementById("uuidv8_sqlserver_info_button").style.display = "none";
		258	document.getElementById("uuidv8_sqlserver_info").style.display = "block";
		259	}
		260	</script>
		261	<p><a id="uuidv8_sqlserver_info_button" href="javascript:show_uuidv8_sqlserver_info()">Show format</a>
83	daniel-mar	262	<pre id="uuidv8_sqlserver_info" style="display:none">Version 2: Resolution of 1 milliseconds, random part of 18 bits, UTC time, 48 bit random "signature", UUIDv8 conform:
82	daniel-mar	263	- 16 bit Random data
84	daniel-mar	264	- 8 bit UTC Milliseconds transformed from 1000ms to 0..255, deviation -2ms..2ms (hex encoded)
82	daniel-mar	265	- 8 bit UTC Seconds (hex encoded)
		266	- 16 bit UTC Minute of the day (1..1440, hex encoded)
		267	- 4 bit UUID version 8
		268	- 12 bit UTC Day of the year (1..366, hex encoded)
		269	- 2 bit UUID Variant (0b10)
		270	- 2 bit Random data
		271	- 12 bit UTC Year (hex encoded)
83	daniel-mar	272	- 48 bit Signature 0x5ce32bd83b96
82	daniel-mar	273
83	daniel-mar	274	Version 1: Resolution of 1 milliseconds, random part of 16 bits, local timezone, 48 zero bit "signature", NOT UUIDv8 conform.
82	daniel-mar	275	- 16 bit Random data
84	daniel-mar	276	- 8 bit Generator's local timezone Milliseconds transformed from 1000ms to 0..255, deviation -4ms..0ms (hex encoded)
82	daniel-mar	277	- 8 bit Generator's local timezone Seconds (BCD encoded)
		278	- 8 bit Generator's local timezone Minute (BCD encoded)
		279	- 8 bit Generator's local timezone Hour (BCD encoded)
		280	- 8 bit Generator's local timezone Day (BCD encoded)
		281	- 8 bit Generator's local timezone Month (BCD encoded)
		282	- 8 bit Generator's local timezone 2-digit year (BCD encoded)
		283	- 8 bit Generator's local timezone 2-digit century (BCD encoded)
		284	- 48 bit Signature 0x000000000000</pre></p>
		285
		286	<?php
		287	if (AUTO_NEW_UUIDS > 0) { /** @phpstan-ignore-line */
		288	echo '<p>Here are '.AUTO_NEW_UUIDS.' UUIDs that were created just for you! (Reload the page to get more)</p>';
		289
		290	echo '<pre>';
		291	for ($i=0; $i<AUTO_NEW_UUIDS; $i++) {
		292	$uuid = gen_uuid_v8_sqlserver_sortable();
		293	echo '<a href="interprete_uuid.php?uuid='.$uuid.'">'.$uuid.'</a><br>';
		294	}
		295	echo '</pre>';
		296	}
		297	?>
		298
		299	<form method="GET" action="interprete_uuid.php">
		300	<input type="hidden" name="version" value="8_sqlserver_v2">
		301	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID (new version)">
		302	</form><br>
		303
		304	<form method="GET" action="interprete_uuid.php">
		305	<input type="hidden" name="version" value="8_sqlserver_v1">
		306	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create and display another UUID (old version)">
		307	</form>
		308
		309
		310
31	daniel-mar	311	<h2 id="gen_other_uuid">Generate other UUID types</h2>
30	daniel-mar	312
47	daniel-mar	313	<p><i>The following types of UUIDs are less common and/or require special knowledge. Please only use the following
30	daniel-mar	314	generators if you know what you are doing.</i></p>
		315
53	daniel-mar	316	<h3 id="gen_uuid_ncs">NCS (variant 0) UUID</h3>
30	daniel-mar	317
53	daniel-mar	318	<p>The <abbr title="Network Computing System">NCS</abbr> UUIDs are a legacy format
		319	initially designed by Apollo Computer that cannot be generated anymore, because the
30	daniel-mar	320	amount of available timestamp bits was exhausted on <strong>5 September 2015</strong>.
53	daniel-mar	321	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	322	<a href="interprete_uuid.php?uuid=ffffffff-ffff-0000-027f-000001000000"><code>ffffffff-ffff-0000-027f-000001000000</code></a>.</p>
30	daniel-mar	323
35	daniel-mar	324	<script>
		325	function show_uuidnce_info() {
		326	document.getElementById("uuidnce_info_button").style.display = "none";
		327	document.getElementById("uuidnce_info").style.display = "block";
		328	}
		329	</script>
62	daniel-mar	330	<p><a id="uuidnce_info_button" href="javascript:show_uuidnce_info()">Show format</a>
35	daniel-mar	331	<pre id="uuidnce_info" style="display:none">Variant 0 UUID:
37	daniel-mar	332	- 32 bit High <abbr title="Count of 4µs intervals passed since 1 Jan 1980 00:00:00 GMT">Time</abbr>
		333	- 16 bit Low <abbr title="Count of 4µs intervals passed since 1 Jan 1980 00:00:00 GMT">Time</abbr>
35	daniel-mar	334	- 16 bit Reserved
		335	- 1 bit Variant (fix 0b0)
37	daniel-mar	336	- 7 bit <abbr title="socket_$unspec (0x0)
		337	socket_$unix (0x1)
		338	socket_$internet (0x2)
		339	socket_$implink (0x3)
		340	socket_$pup (0x4)
		341	socket_$chaos (0x5)
		342	socket_$ns (0x6)
		343	socket_$nbs (0x7)
		344	socket_$ecma (0x8)
		345	socket_$datakit (0x9)
		346	socket_$ccitt (0xA)
		347	socket_$sna (0xB)
		348	socket_$unspec2 (0xC)
		349	socket_$dds (0xD)">Family</abbr>
35	daniel-mar	350	- 56 bit Node</pre></p>
		351
31	daniel-mar	352	<h3 id="gen_uuidv2">Generate DCE Security (version 2) UUID</h3>
30	daniel-mar	353
37	daniel-mar	354	<p><i>An UUIDv2 contains information about the creator (person, group, or organization), the generating system (MAC address), and time.
35	daniel-mar	355	The creator information replaced parts of the time bits, therefore the time resolution is very low.</i></p>
		356
		357	<script>
		358	function show_uuidv2_info() {
		359	document.getElementById("uuidv2_info_button").style.display = "none";
		360	document.getElementById("uuidv2_info").style.display = "block";
		361	}
		362	</script>
62	daniel-mar	363	<p><a id="uuidv2_info_button" href="javascript:show_uuidv2_info()">Show format</a>
35	daniel-mar	364	<pre id="uuidv2_info" style="display:none">Variant 1, Version 2 UUID:
		365	- 32 bit Local Domain Number
37	daniel-mar	366	- 16 bit Mid <abbr title="Count of 429.4967296s intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	367	- 4 bit Version (fix 0x2)
37	daniel-mar	368	- 12 bit High <abbr title="Count of 429.4967296s intervals passed since 15 Oct 1582 00:00:00 GMT">Time</abbr>
35	daniel-mar	369	- 2 bit Variant (fix 0b10)
		370	- 6 bit Clock Sequence
37	daniel-mar	371	- 8 bit <abbr title="0 = person
		372	1 = group
		373	2 = org
		374	3-255 = site-defined">Local Domain</abbr>
35	daniel-mar	375	- 48 bit MAC Address</pre></p>
		376
30	daniel-mar	377	<form method="GET" action="interprete_uuid.php">
2	daniel-mar	378	<input type="hidden" name="version" value="2">
35	daniel-mar	379	<label>Domain (8 bits):</label><select name="domain_choose" id="dce_domain_choice" onchange="javascript:dce_domain_choose();">
34	daniel-mar	380	<option value="uid">Person (e.g. POSIX UID)</option>
		381	<option value="gid">Group (e.g. POSIX GID)</option>
		382	<option value="org">Organization</option>
2	daniel-mar	383	<option value="site">Site-defined</option>
62	daniel-mar	384	</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	385	<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	386	<font color="red">Warning</font>: The timestamp has an accuracy of 7:10 minutes,
30	daniel-mar	387	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	388	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create UUIDv2">
2	daniel-mar	389	</form>
		390	<script>
		391	function dce_domain_choose() {
		392	var ns = document.getElementById('dce_domain_choice').value;
		393	if (ns == "uid") {
		394	document.getElementById('dce_domain').value = "0";
		395	}
		396	if (ns == "gid") {
		397	document.getElementById('dce_domain').value = "1";
		398	}
		399	if (ns == "org") {
		400	document.getElementById('dce_domain').value = "2";
		401	}
		402	if (ns == "site") {
		403	document.getElementById('dce_domain').value = "";
		404	}
		405	}
		406	dce_domain_choose();
		407	</script>
		408
61	daniel-mar	409	<h3 id="gen_uuidv35">Generate name-based (version 3 / 5 / <font color="green">New: 8</font>) UUID</h3>
2	daniel-mar	410
57	daniel-mar	411	<p><i>An UUIDv3 is made out of a MD5 hash and an UUIDv5 is made out of a SHA1 hash.
		412	The revision of RFC4122 also contains an example for a custom UUIDv8 that
72	daniel-mar	413	uses modern hash algorithms.</i></p>
35	daniel-mar	414
		415	<script>
		416	function show_uuidv35_info() {
		417	document.getElementById("uuidv35_info_button").style.display = "none";
		418	document.getElementById("uuidv35_info").style.display = "block";
		419	}
		420	</script>
62	daniel-mar	421	<p><a id="uuidv35_info_button" href="javascript:show_uuidv35_info()">Show format</a>
58	daniel-mar	422	<pre id="uuidv35_info" style="display:none">Variant 1, Version 3/5/8 UUID:
35	daniel-mar	423	- 48 bit Hash High
58	daniel-mar	424	- 4 bit Version (fix 0x3, 0x5, or 0x8)
35	daniel-mar	425	- 12 bit Hash Mid
		426	- 2 bit Variant (fix 0b10)
62	daniel-mar	427	- 62 bit Hash Low
35	daniel-mar	428
62	daniel-mar	429
75	daniel-mar	430	<u>As shown in <a href="https://datatracker.ietf.org/doc/draft-ietf-uuidrev-rfc4122bis/">draft-ietf-uuidrev-rfc4122bis-12</a> Appendix C.2:</u>
69	daniel-mar	431	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[<i>NameSpaceUuid</i>] \|\| <i>Data</i> )).
67	daniel-mar	432
62	daniel-mar	433	</pre></p>
		434
35	daniel-mar	435	<style>
		436	label {
		437	width:120px;
		438	text-align:left;
		439	margin-right: 20px;
		440	display:inline-block;
		441	}
		442	</style>
		443
2	daniel-mar	444	<form method="GET" action="interprete_uuid.php">
59	daniel-mar	445	<label>Hash algorithm:</label><select name="version" id="nb_version" onchange="javascript:nb_version_choose();">
		446	<?php
67	daniel-mar	447
75	daniel-mar	448	echo "\t\t<option disabled>--- UUIDv3 (defined in RFC 4122) ---</option>\n";
67	daniel-mar	449	echo "\t\t<option value=\"3\">MD5</option>\n";
75	daniel-mar	450	echo "\t\t<option disabled>--- UUIDv5 (defined in RFC 4122) ---</option>\n";
67	daniel-mar	451	echo "\t\t<option value=\"5\" selected>SHA1</option>\n";
75	daniel-mar	452	echo "\t\t<option disabled>--- UUIDv8 (shown in Internet Draft 12, Appendix C.2) ---</option>\n";
69	daniel-mar	453	$tmp = [];
		454	$algos = hash_algos();
		455	$algos[] = 'shake128';
		456	$algos[] = 'shake256';
		457	foreach ($algos as $algo) {
		458	if ($algo == 'md5') continue; // use UUIDv3 instead
		459	if ($algo == 'sha1') continue; // use UUIDv5 instead
		460	$friendlyName = strtoupper($algo);
		461
		462	if ($algo == 'shake128') $bits = 999;
		463	else if ($algo == 'shake256') $bits = 999;
		464	else $bits = strlen(hash($algo, '', true)) * 8;
75	daniel-mar	465	if ($bits < 128) $friendlyName .= " (Small hash size! $bits bits)"; // <-- this is not described in Appendix C.2
69	daniel-mar	466
82	daniel-mar	467	$tmp[$friendlyName] = '<option value="8_namebased_'.$algo.'">'.htmlentities($friendlyName).'</option>';
69	daniel-mar	468	}
		469	natsort($tmp);
		470	foreach ($tmp as $html) {
		471	echo "\t\t$html\n";
		472	}
		473
59	daniel-mar	474	?>
75	daniel-mar	475	</select><br>
35	daniel-mar	476	<label>Namespace:</label><select name="namespace_choose" id="nb_nsc" onchange="javascript:nb_ns_choose();">
2	daniel-mar	477	<option value="dns">DNS</option>
		478	<option value="url">URL</option>
		479	<option value="oid">OID</option>
		480	<option value="x500">X.500 DN</option>
76	daniel-mar	481	<option value="r74n">R74n Namespace</option>
35	daniel-mar	482	<!-- <option value="oidplus_ns">OIDplus ns only</option> -->
		483	<!-- <option value="oidplus_ns_val">OIDplus ns+val</option> -->
28	daniel-mar	484	<!-- <option value="oidplus_pubkey">OIDplus pubkey</option> -->
2	daniel-mar	485	<option value="other">Other</option>
59	daniel-mar	486	</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	487	<label>Value:</label><input type="text" name="nb_val" value="" id="nb_val" style="width:300px"><br>
30	daniel-mar	488	<font color="red">Warning</font>: These UUIDs do not contain a timestamp,
		489	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	490	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" id="nb_create_btn" value="Create UUID">
2	daniel-mar	491	</form>
		492	<script>
59	daniel-mar	493	function nb_version_choose() {
		494	var ver = document.getElementById('nb_version').value;
		495	document.getElementById('nb_create_btn').value = 'Create UUIDv' + ver.substr(0,1);
		496	}
35	daniel-mar	497	function nb_ns_textchange() {
		498	var ns = document.getElementById('nb_ns').value.toLowerCase();
		499	if (ns == "6ba7b810-9dad-11d1-80b4-00c04fd430c8") {
		500	if (document.getElementById('nb_nsc').value != "dns") {
		501	document.getElementById('nb_nsc').value = "dns";
57	daniel-mar	502	document.getElementById('nb_val').value = "www.example.com";
35	daniel-mar	503	}
		504	}
		505	else if (ns == "6ba7b811-9dad-11d1-80b4-00c04fd430c8") {
		506	if (document.getElementById('nb_nsc').value != "url") {
		507	document.getElementById('nb_nsc').value = "url";
57	daniel-mar	508	document.getElementById('nb_val').value = "http://www.example.com/";
35	daniel-mar	509	}
		510	}
		511	else if (ns == "6ba7b812-9dad-11d1-80b4-00c04fd430c8") {
		512	if (document.getElementById('nb_nsc').value != "oid") {
		513	document.getElementById('nb_nsc').value = "oid";
		514	document.getElementById('nb_val').value = "2.999";
		515	}
		516	}
		517	else if (ns == "6ba7b814-9dad-11d1-80b4-00c04fd430c8") {
		518	if (document.getElementById('nb_nsc').value != "x500") {
		519	document.getElementById('nb_nsc').value = "x500";
		520	document.getElementById('nb_val').value = "UID=jsmith,DC=example,DC=net";
		521	}
		522	}
76	daniel-mar	523	else if (ns == "ca069732-780c-11ee-b962-000000000074") { // https://r74n.com/id/uuid
		524	if (document.getElementById('nb_nsc').value != "r74n") {
		525	document.getElementById('nb_nsc').value = "r74n";
		526	document.getElementById('nb_val').value = "ants";
		527	}
		528	}
35	daniel-mar	529	else {
		530	if (document.getElementById('nb_nsc').value != "other") {
		531	document.getElementById('nb_nsc').value = "other";
		532	document.getElementById('nb_val').value = "";
		533	}
		534	}
		535	}
2	daniel-mar	536	function nb_ns_choose() {
		537	var ns = document.getElementById('nb_nsc').value;
		538	if (ns == "dns") {
		539	document.getElementById('nb_ns').value = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
57	daniel-mar	540	document.getElementById('nb_val').value = "www.example.com";
2	daniel-mar	541	}
35	daniel-mar	542	else if (ns == "url") {
2	daniel-mar	543	document.getElementById('nb_ns').value = "6ba7b811-9dad-11d1-80b4-00c04fd430c8";
57	daniel-mar	544	document.getElementById('nb_val').value = "http://www.example.com/";
2	daniel-mar	545	}
35	daniel-mar	546	else if (ns == "oid") {
2	daniel-mar	547	document.getElementById('nb_ns').value = "6ba7b812-9dad-11d1-80b4-00c04fd430c8";
		548	document.getElementById('nb_val').value = "2.999";
		549	}
35	daniel-mar	550	else if (ns == "x500") {
2	daniel-mar	551	document.getElementById('nb_ns').value = "6ba7b814-9dad-11d1-80b4-00c04fd430c8";
		552	document.getElementById('nb_val').value = "UID=jsmith,DC=example,DC=net";
		553	}
76	daniel-mar	554	else if (ns == "r74n") { // https://r74n.com/id/uuid
		555	document.getElementById('nb_ns').value = "ca069732-780c-11ee-b962-000000000074";
		556	document.getElementById('nb_val').value = "ants";
		557	}
35	daniel-mar	558	/*
		559	else if (ns == "oidplus_ns") {
2	daniel-mar	560	document.getElementById('nb_ns').value = "0943e3ce-4b79-11e5-b742-78e3b5fc7f22";
		561	document.getElementById('nb_val').value = "ipv4";
		562	}
35	daniel-mar	563	else if (ns == "oidplus_ns_val") {
2	daniel-mar	564	document.getElementById('nb_ns').value = "ad1654e6-7e15-11e4-9ef6-78e3b5fc7f22";
		565	document.getElementById('nb_val').value = "ipv4:8.8.8.8";
		566	}
35	daniel-mar	567	else if (ns == "oidplus_ns_pubkey") {
28	daniel-mar	568	document.getElementById('nb_ns').value = "fd16965c-8bab-11ed-8744-3c4a92df8582";
31	daniel-mar	569	document.getElementById('nb_val').value = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqg/PnsC1WX3C1/mUSLuk0DIaDHtEsxBnG0auYJRJ1hBtbUUvItbK0odlKrX2SFo1MJJpu/SSxTzAgqkKZsZe3cCFkgA1svfuH9i94oGLjJ4n0kRJEGlanCmGndJBfIqGDJaQE2BJ8tLxeBrpkd9l0KvJsjhRmqJAb9KYK3KYFsWvT+wyjD3UJ1eHcgLbF/Qb3cwMU/u7Fs7ZpsNMW4phDPlsYsk9XHFpJ1/UCj6G53mYRfOC/ouDdGShlbVLB15s0V95QpnU/7lL8mJ2lE+sTZekGNBA4XbJv2gs21cR4E8zc/z+NyZS7117DYZoJqrAN8sKz6xGoKgQF6wueCK5qQIDAQAB";
28	daniel-mar	570	}
		571	*/
35	daniel-mar	572	else if (ns == "other") {
2	daniel-mar	573	document.getElementById('nb_ns').value = "";
		574	document.getElementById('nb_val').value = "";
		575	}
		576	}
59	daniel-mar	577	nb_version_choose();
2	daniel-mar	578	nb_ns_choose();
		579	</script>
		580
61	daniel-mar	581	<h3 id="gen_uuidv8"><font color="green">New:</font> Generate Custom (version 8) UUID</h3>
34	daniel-mar	582
37	daniel-mar	583	<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	584
		585	<script>
		586	function show_uuidv8_info() {
		587	document.getElementById("uuidv8_info_button").style.display = "none";
		588	document.getElementById("uuidv8_info").style.display = "block";
		589	}
65	daniel-mar	590	function uuidv8_changedec(block, len) {
		591	var x = document.getElementById("v8_block"+block+"_dec").value;
		592	if (x.trim() == "") x = 0;
		593	x = parseInt(x);
		594	if (isNaN(x)) {
		595	x = "???";
		596	} else {
		597	x = x.toString(16).padStart(len, '0');
		598	if ((len > 0) && (x.length > len)) x = "Overflow";
		599	}
		600	document.getElementById("v8_block"+block+"_hex").value = x;
		601	}
		602	function uuidv8_changehex(block, len) {
		603	var x = document.getElementById("v8_block"+block+"_hex").value;
		604	if (x.trim() == "") x = 0;
		605	x = parseInt(x, 16);
		606	if (isNaN(x)) {
		607	x = "???";
		608	} else {
		609	x = x.toString().padStart(len, '0');
		610	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)
		611	}
		612	document.getElementById("v8_block"+block+"_dec").value = x;
		613	}
35	daniel-mar	614	</script>
62	daniel-mar	615	<p><a id="uuidv8_info_button" href="javascript:show_uuidv8_info()">Show format</a>
35	daniel-mar	616	<pre id="uuidv8_info" style="display:none">Variant 1, Version 8 UUID:
63	daniel-mar	617	- 48 bit Custom data [Block 1+2]
35	daniel-mar	618	- 4 bit Version (fix 0x8)
63	daniel-mar	619	- 12 bit Custom data [Block 3]
35	daniel-mar	620	- 2 bit Variant (fix 0b10)
63	daniel-mar	621	- 62 bit Custom data [Block 4+5]</pre></p>
35	daniel-mar	622
34	daniel-mar	623	<form method="GET" action="interprete_uuid.php">
		624	<input type="hidden" name="version" value="8">
65	daniel-mar	625
		626	<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
		627	<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>
		628
		629	<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
		630	<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>
		631
		632	<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
		633	<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>
		634
		635	<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
		636	<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>
		637
		638	<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
		639	<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>
		640
34	daniel-mar	641	<font color="red">Warning</font>: These UUIDs do not contain a timestamp,
		642	therefore the uniqueness of these UUIDs is not guaranteed!<br><br>
59	daniel-mar	643	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Create UUIDv8">
34	daniel-mar	644	</form>
		645
31	daniel-mar	646	<h2 id="interpret_uuid">Interpret a UUID</h2>
2	daniel-mar	647
30	daniel-mar	648	<p>You can enter a UUID in the following notations:</p>
2	daniel-mar	649
		650	<ul>
		651	<li>Classic notation (case insensitive, curly braces optional): <code>9e83839a-5967-11e4-8c1c-78e3b5fc7f22</code></li>
		652	<li>As OID: <code>2.25.210700883446948645633376489934419689250</code></li>
		653	</ul>
		654
		655	<p>The script will output:</p>
		656
		657	<ul>
		658	<li>Notation as UUID and OID</li>
35	daniel-mar	659	<li>Version, variant, and additional data (date and time, clock sequence, node id, etc.)</li>
2	daniel-mar	660	</ul>
		661
30	daniel-mar	662	<p>Please enter a UUID or UUID OID:</p>
2	daniel-mar	663
		664	<form method="GET" action="interprete_uuid.php">
32	daniel-mar	665	<input type="text" name="uuid" value="" style="width:300px"> <input type="submit" value="Interprete">
2	daniel-mar	666	</form>
		667
31	daniel-mar	668	<h2 id="interpret_mac">Interpret a MAC address (<abbr title="Media Access Control">MAC</abbr> /
26	daniel-mar	669	<abbr title="Extended Unique Identifier">EUI</abbr> /
		670	<abbr title="Extended Local Identifier">ELI</abbr> /
		671	<abbr title="Standard Assigned Identifier">SAI</abbr> /
		672	<abbr title="Administratively Assigned Identifier">AAI</abbr>)</h2>
2	daniel-mar	673
30	daniel-mar	674	<p>You can enter a UUID in the following notations:</p>
2	daniel-mar	675
		676	<ul>
		677	<li><code>AA-BB-CC-DD-EE-FF</code></li>
		678	<li><code>AA:BB:CC:DD:EE:FF</code></li>
		679	<li><code>AABBCC.DDEEFF</code> (case insensitive)</li>
16	daniel-mar	680	<li><code>AA-BB-CC-DD-EE-FF-11-22</code> (EUI-64)</li>
		681	<li><code>AA:BB:CC:DD:EE:FF-11-22</code> (EUI-64)</li>
		682	<li><code>fe80::1322:33ff:fe44:5566</code> (IPv6 Link Local / EUI-64)</li>
2	daniel-mar	683	</ul>
		684
		685	<p>The script will output:</p>
		686
		687	<ul>
		688	<li>Information about the I/G and U/L flags.</li>
		689	<li>Information about the entry in the IEEE registry, if available.</li>
		690	<li>Information about the registrant, if available.</li>
		691	</ul>
		692
29	daniel-mar	693	<p>Please enter a MAC (EUI, ELI, SAI, AAI), or IPv6-Link-Local address:</p>
2	daniel-mar	694
		695	<form method="GET" action="interprete_mac.php">
32	daniel-mar	696	<input type="text" name="mac" value="" style="width:250px"> <input type="submit" value="Interprete">
2	daniel-mar	697	</form>
		698
62	daniel-mar	699	<h3 id="gen_aai">Generate an <abbr title="Administratively Assigned Identifier">AAI</abbr></h3>
41	daniel-mar	700
		701	<p><i>An Administratively Assigned Identifier (AAI) is a MAC address which can be locally defined
		702	by applications or an administrator. Unlike the EUI, an AAI is NOT worldwide unique.</i></p>
		703
		704	<form method="GET" action="interprete_mac.php">
		705	<input type="hidden" name="aai_gen" value="1">
		706	<input type="hidden" name="aai_gen_bits" value="48">
		707	<input type="hidden" name="aai_gen_multicast" value="0">
		708	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate AAI-48">
		709	</form>
		710
		711	<br>
		712
		713	<form method="GET" action="interprete_mac.php">
		714	<input type="hidden" name="aai_gen" value="1">
		715	<input type="hidden" name="aai_gen_bits" value="64">
		716	<input type="hidden" name="aai_gen_multicast" value="0">
		717	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate AAI-64">
		718	</form>
		719
		720	<p>The following options are rather unusual, but are implemented for the sake of completeness:</p>
		721
		722	<form method="GET" action="interprete_mac.php">
		723	<input type="hidden" name="aai_gen" value="1">
		724	<input type="hidden" name="aai_gen_bits" value="48">
		725	<input type="hidden" name="aai_gen_multicast" value="1">
		726	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate Multicast AAI-48">
		727	</form>
		728
		729	<br>
		730
		731	<form method="GET" action="interprete_mac.php">
		732	<input type="hidden" name="aai_gen" value="1">
		733	<input type="hidden" name="aai_gen_bits" value="64">
		734	<input type="hidden" name="aai_gen_multicast" value="1">
		735	<input type="hidden" name="uuid" value="CREATE"> <input type="submit" value="Generate Multicast AAI-64">
		736	</form>
		737
22	daniel-mar	738	<br><br><br>
		739
2	daniel-mar	740	</body>
		741
		742	</html>

Subversion Repositories uuid_mac_utils

uuid_mac_utils/trunk/index.php – Rev 84