1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/* SPDX-License-Identifier: LGPL-2.1-or-later */
#ifndef __NM_UUID_H__
#define __NM_UUID_H__
typedef struct _NMUuid {
guint8 uuid[16];
} NMUuid;
#define NM_UUID_INIT_ZERO() ((NMUuid){.uuid = {0}})
/* Beware, the 16 macro arguments are two hex-digits, not plain numbers. The macro
* will automatically add the "0x". In particular, "09" is not an octal number, it's
* 0x09. This oddity is so that the arguments look very much like the UUID in string form. */
#define NM_UUID_INIT(a0, a1, a2, a3, a4, a5, a6, a7, a8, a9, a10, a11, a12, a13, a14, a15) \
((NMUuid){ \
.uuid = {(0x##a0), \
(0x##a1), \
(0x##a2), \
(0x##a3), \
(0x##a4), \
(0x##a5), \
(0x##a6), \
(0x##a7), \
(0x##a8), \
(0x##a9), \
(0x##a10), \
(0x##a11), \
(0x##a12), \
(0x##a13), \
(0x##a14), \
(0x##a15)}, \
})
char *nm_uuid_unparse_case(const NMUuid *uuid, char out_str[static 37], gboolean upper_case);
static inline char *
nm_uuid_unparse(const NMUuid *uuid, char out_str[static 37])
{
return nm_uuid_unparse_case(uuid, out_str, FALSE);
}
gboolean nm_uuid_parse_full(const char *str, NMUuid *out_uuid, gboolean *out_is_normalized);
static inline NMUuid *
nm_uuid_parse(const char *str, NMUuid *out_uuid)
{
nm_assert(out_uuid);
if (!nm_uuid_parse_full(str, out_uuid, NULL))
return NULL;
return out_uuid;
}
NMUuid *nm_uuid_generate_random(NMUuid *out_uuid);
gboolean nm_uuid_is_null(const NMUuid *uuid);
/*****************************************************************************/
static inline gboolean
nm_uuid_is_valid(const char *str)
{
return str && nm_uuid_parse_full(str, NULL, NULL);
}
gboolean nm_uuid_is_normalized_full(const char *str);
static inline gboolean
nm_uuid_is_normalized(const char *str)
{
gboolean is_normalized;
return str && nm_uuid_parse_full(str, NULL, &is_normalized) && is_normalized;
}
/*****************************************************************************/
gboolean nm_uuid_is_valid_nmlegacy(const char *str);
gboolean nm_uuid_is_valid_nm(const char *str,
gboolean *out_normalized,
char *out_normalized_str /* [static 37] */);
/*****************************************************************************/
char *nm_uuid_generate_random_str(char buf[static 37]);
#define nm_uuid_generate_random_str_arr(buf) \
({ \
G_STATIC_ASSERT(sizeof(buf) == G_N_ELEMENTS(buf) && sizeof(buf) >= 37); \
nm_uuid_generate_random_str(buf); \
})
#define nm_uuid_generate_random_str_a() (nm_uuid_generate_random_str(g_alloca(37)))
#define nm_uuid_generate_random_str_malloc() (nm_uuid_generate_random_str(g_new(char, 37)))
/*****************************************************************************/
extern const NMUuid nm_uuid_ns_zero;
extern const NMUuid nm_uuid_ns_1;
#define NM_UUID_NS_ZERO "00000000-0000-0000-0000-000000000000"
#define NM_UUID_NS_1 "b425e9fb-7598-44b4-9e3b-5a2e3aaa4905"
/*****************************************************************************/
typedef enum {
NM_UUID_TYPE_LEGACY = 0,
NM_UUID_TYPE_VERSION3 = 3,
NM_UUID_TYPE_VERSION5 = 5,
} NMUuidType;
NMUuid *nm_uuid_generate_from_string(NMUuid *uuid,
const char *s,
gssize slen,
NMUuidType uuid_type,
const NMUuid *type_args);
char *nm_uuid_generate_from_string_str(const char *s,
gssize slen,
NMUuidType uuid_type,
const NMUuid *type_args);
char *nm_uuid_generate_from_strings_strv(NMUuidType uuid_type,
const NMUuid *type_args,
const char *const *strv);
#define nm_uuid_generate_from_strings(uuid_type, type_args, ...) \
nm_uuid_generate_from_strings_strv((uuid_type), (type_args), NM_MAKE_STRV(__VA_ARGS__))
#define nm_uuid_generate_from_strings_v3(...) \
nm_uuid_generate_from_strings(NM_UUID_TYPE_VERSION3, &nm_uuid_ns_1, __VA_ARGS__)
/*****************************************************************************/
#endif /* __NM_UUID_H__ */
|
