u-boot/lib/uuid.c

1 // SPDX-License-Identifier: GPL-2.0+
15  * UUID - Universally Unique IDentifier - 128 bits unique number.
19  *        - time, MAC address(v1),
20  *        - user ID(v2),
21  *        - MD5 of name or URL(v3),
22  *        - random data(v4),
23  *        - SHA-1 of name or URL(v5),
26  * timestamp - 60-bit: time_low, time_mid, time_hi_and_version
27  * version   - 4 bit (bit 4 through 7 of the time_hi_and_version)
28  * clock seq - 14 bit: clock_seq_hi_and_reserved, clock_seq_low
29  * variant:  - bit 6 and 7 of clock_seq_hi_and_reserved
30  * node      - 48 bit
36  * 4B-2B-2B-2B-6B (big endian - network byte order)
41  * xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
44  * where x is a hexadecimal character. Fields are separated by '-'s.
46  * to little endian and be means it should be converted to big endian.
53  * xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
68 			valid = (uuid[i] == '-');  in uuid_str_valid()
98  * uuid_guid_get_bin() - this function get GUID bin for string
100  * @param guid_str - pointer to partition type string
101  * @param guid_bin - pointer to allocated array for big endian output [16B]
113 	return -ENODEV;  in uuid_guid_get_bin()
117  * uuid_guid_get_str() - this function get string for GUID.
119  * @param guid_bin - pointer to string with partition type guid [16B]
120  * @param guid_str - pointer to allocated partition type string [7B]
133 	return -ENODEV;  in uuid_guid_get_str()
138  * uuid_str_to_bin() - convert string UUID or GUID to big endian binary data.
140  * @param uuid_str - pointer to UUID or GUID string [37B] or GUID shorcut
141  * @param uuid_bin - pointer to allocated array for big endian output [16B]
142  * @str_format     - UUID string format: 0 - UUID; 1 - GUID
155 		return -EINVAL;  in uuid_str_to_bin()
188  * uuid_bin_to_str() - convert big endian binary data to string UUID or GUID.
190  * @param uuid_bin - pointer to binary data of UUID (big endian) [16B]
191  * @param uuid_str - pointer to allocated array for output string [37B]
192  * @str_format     - UUID string format: 0 - UUID; 1 - GUID
204 	 * UUID and GUID bin data - always in big endian:  in uuid_bin_to_str()
205 	 * 4B-2B-2B-2B-6B  in uuid_bin_to_str()
221 			*uuid_str++ = '-';  in uuid_bin_to_str()
228  * gen_rand_uuid() - this function generates a random binary UUID version 4.
232  * @param uuid_bin - pointer to allocated array [16B]. Output is in big endian.
257  * gen_rand_uuid_str() - this function generates UUID v4 (random) in two string
260  * @param uuid_str - pointer to allocated array [37B].
261  * @param          - uuid output type: UUID - 0, GUID - 1
267 	/* Generate UUID (big endian) */  in gen_rand_uuid_str()
299 	   "UUID - generate random Universally Unique Identifier",
307 	   "GUID - generate Globally Unique Identifier based on random UUID",