2 Unix SMB/CIFS implementation.
6 Copyright (C) Theodore Ts'o 1996, 1997,
7 Copyright (C) Jim McDonough 2002.
8 Copyright (C) Andrew Tridgell 2003.
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
12 the Free Software Foundation; either version 3 of the License, or
13 (at your option) any later version.
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
20 You should have received a copy of the GNU General Public License
21 along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include "lib/util/samba_util.h"
26 #include "lib/util/genrand.h"
27 #include "librpc/ndr/libndr.h"
28 #include "librpc/gen_ndr/ndr_misc.h"
29 #include "lib/util/util_str_hex.h"
31 _PUBLIC_ NTSTATUS
GUID_to_ndr_buf(
32 const struct GUID
*guid
, struct GUID_ndr_buf
*buf
)
34 DATA_BLOB b
= { .data
= buf
->buf
, .length
= sizeof(buf
->buf
), };
35 enum ndr_err_code ndr_err
;
37 ndr_err
= ndr_push_struct_into_fixed_blob(
38 &b
, guid
, (ndr_push_flags_fn_t
)ndr_push_GUID
);
39 return ndr_map_error2ntstatus(ndr_err
);
43 build a NDR blob from a GUID
45 _PUBLIC_ NTSTATUS
GUID_to_ndr_blob(const struct GUID
*guid
, TALLOC_CTX
*mem_ctx
, DATA_BLOB
*b
)
47 struct GUID_ndr_buf buf
= { .buf
= {0}, };
50 status
= GUID_to_ndr_buf(guid
, &buf
);
51 if (!NT_STATUS_IS_OK(status
)) {
55 *b
= data_blob_talloc(mem_ctx
, buf
.buf
, sizeof(buf
.buf
));
56 if (b
->data
== NULL
) {
57 return NT_STATUS_NO_MEMORY
;
64 build a GUID from a NDR data blob
66 _PUBLIC_ NTSTATUS
GUID_from_ndr_blob(const DATA_BLOB
*b
, struct GUID
*guid
)
68 enum ndr_err_code ndr_err
=
69 ndr_pull_struct_blob_all_noalloc(b
, guid
,
70 (ndr_pull_flags_fn_t
)ndr_pull_GUID
);
71 return ndr_map_error2ntstatus(ndr_err
);
76 build a GUID from a string
78 _PUBLIC_ NTSTATUS
GUID_from_data_blob(const DATA_BLOB
*s
, struct GUID
*guid
)
82 if (s
->data
== NULL
) {
83 return NT_STATUS_INVALID_PARAMETER
;
86 if (s
->length
== 36) {
87 ok
= parse_guid_string((char *)s
->data
, guid
);
88 return ok
? NT_STATUS_OK
: NT_STATUS_INVALID_PARAMETER
;
91 if (s
->length
== 38) {
92 if (s
->data
[0] != '{' || s
->data
[37] != '}') {
93 return NT_STATUS_INVALID_PARAMETER
;
95 ok
= parse_guid_string((char *)s
->data
+ 1, guid
);
96 return ok
? NT_STATUS_OK
: NT_STATUS_INVALID_PARAMETER
;
99 if (s
->length
== 32) {
100 uint8_t buf16
[16] = {0};
101 DATA_BLOB blob16
= { .data
= buf16
, .length
= sizeof(buf16
) };
102 size_t rlen
= strhex_to_str((char *)blob16
.data
, blob16
.length
,
103 (const char *)s
->data
, s
->length
);
104 if (rlen
!= blob16
.length
) {
105 return NT_STATUS_INVALID_PARAMETER
;
108 return GUID_from_ndr_blob(&blob16
, guid
);
111 if (s
->length
== 16) {
112 return GUID_from_ndr_blob(s
, guid
);
115 return NT_STATUS_INVALID_PARAMETER
;
119 build a GUID from a string
121 _PUBLIC_ NTSTATUS
GUID_from_string(const char *s
, struct GUID
*guid
)
123 DATA_BLOB blob
= data_blob_string_const(s
);
124 return GUID_from_data_blob(&blob
, guid
);
128 * generate a random GUID
130 _PUBLIC_
struct GUID
GUID_random(void)
134 generate_random_buffer((uint8_t *)&guid
, sizeof(guid
));
135 guid
.clock_seq
[0] = (guid
.clock_seq
[0] & 0x3F) | 0x80;
136 guid
.time_hi_and_version
= (guid
.time_hi_and_version
& 0x0FFF) | 0x4000;
142 * generate an empty GUID
144 _PUBLIC_
struct GUID
GUID_zero(void)
146 return (struct GUID
) { .time_low
= 0 };
149 _PUBLIC_
bool GUID_all_zero(const struct GUID
*u
)
151 if (u
->time_low
!= 0 ||
153 u
->time_hi_and_version
!= 0 ||
154 u
->clock_seq
[0] != 0 ||
155 u
->clock_seq
[1] != 0 ||
156 !all_zero(u
->node
, 6)) {
162 _PUBLIC_
bool GUID_equal(const struct GUID
*u1
, const struct GUID
*u2
)
164 return (GUID_compare(u1
, u2
) == 0);
167 _PUBLIC_
int GUID_compare(const struct GUID
*u1
, const struct GUID
*u2
)
169 if (u1
->time_low
!= u2
->time_low
) {
170 return u1
->time_low
> u2
->time_low
? 1 : -1;
173 if (u1
->time_mid
!= u2
->time_mid
) {
174 return u1
->time_mid
> u2
->time_mid
? 1 : -1;
177 if (u1
->time_hi_and_version
!= u2
->time_hi_and_version
) {
178 return u1
->time_hi_and_version
> u2
->time_hi_and_version
? 1 : -1;
181 if (u1
->clock_seq
[0] != u2
->clock_seq
[0]) {
182 return u1
->clock_seq
[0] > u2
->clock_seq
[0] ? 1 : -1;
185 if (u1
->clock_seq
[1] != u2
->clock_seq
[1]) {
186 return u1
->clock_seq
[1] > u2
->clock_seq
[1] ? 1 : -1;
189 return memcmp(u1
->node
, u2
->node
, 6);
193 its useful to be able to display these in debugging messages
195 _PUBLIC_
char *GUID_string(TALLOC_CTX
*mem_ctx
, const struct GUID
*guid
)
197 struct GUID_txt_buf buf
;
198 return talloc_strdup(mem_ctx
, GUID_buf_string(guid
, &buf
));
202 * Does the same without allocating memory, using the structure buffer.
203 * Useful for debug messages, so that you do not have to talloc_free the result
205 _PUBLIC_
char* GUID_buf_string(const struct GUID
*guid
,
206 struct GUID_txt_buf
*dst
)
211 snprintf(dst
->buf
, sizeof(dst
->buf
),
212 "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x",
213 guid
->time_low
, guid
->time_mid
,
214 guid
->time_hi_and_version
,
217 guid
->node
[0], guid
->node
[1],
218 guid
->node
[2], guid
->node
[3],
219 guid
->node
[4], guid
->node
[5]);
223 _PUBLIC_
char *GUID_string2(TALLOC_CTX
*mem_ctx
, const struct GUID
*guid
)
225 struct GUID_txt_buf buf
;
226 char *ret
= talloc_asprintf(
227 mem_ctx
, "{%s}", GUID_buf_string(guid
, &buf
));
231 _PUBLIC_
char *GUID_hexstring(TALLOC_CTX
*mem_ctx
, const struct GUID
*guid
)
234 DATA_BLOB guid_blob
= { .data
= NULL
};
237 status
= GUID_to_ndr_blob(guid
, mem_ctx
, &guid_blob
);
238 if (NT_STATUS_IS_OK(status
)) {
239 ret
= data_blob_hex_string_upper(mem_ctx
, &guid_blob
);
241 TALLOC_FREE(guid_blob
.data
);
245 _PUBLIC_
bool ndr_policy_handle_empty(const struct policy_handle
*h
)
247 return (h
->handle_type
== 0 && GUID_all_zero(&h
->uuid
));
250 _PUBLIC_
bool ndr_policy_handle_equal(const struct policy_handle
*hnd1
,
251 const struct policy_handle
*hnd2
)
253 if (!hnd1
|| !hnd2
) {
257 return (memcmp(hnd1
, hnd2
, sizeof(*hnd1
)) == 0);