selftest: add save.env.sh helper script.
[Samba.git] / librpc / ndr / ndr.c
blobf66029ab2cba174310794eb0e7d6206bff89dced
1 /*
2 Unix SMB/CIFS implementation.
4 libndr interface
6 Copyright (C) Andrew Tridgell 2003
7 Copyright (C) Jelmer Vernooij 2005-2008
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 this provides the core routines for NDR parsing functions
26 see http://www.opengroup.org/onlinepubs/9629399/chap14.htm for details
27 of NDR encoding rules
30 #include "includes.h"
31 #include "librpc/ndr/libndr.h"
32 #include "../lib/util/dlinklist.h"
34 #define NDR_BASE_MARSHALL_SIZE 1024
36 /* this guid indicates NDR encoding in a protocol tower */
37 const struct ndr_syntax_id ndr_transfer_syntax_ndr = {
38 { 0x8a885d04, 0x1ceb, 0x11c9, {0x9f, 0xe8}, {0x08,0x00,0x2b,0x10,0x48,0x60} },
42 const struct ndr_syntax_id ndr_transfer_syntax_ndr64 = {
43 { 0x71710533, 0xbeba, 0x4937, {0x83, 0x19}, {0xb5,0xdb,0xef,0x9c,0xcc,0x36} },
47 const struct ndr_syntax_id ndr_syntax_id_null = {
48 { 0, 0, 0, { 0, 0 }, { 0, 0, 0, 0, 0, 0 } },
53 work out the number of bytes needed to align on a n byte boundary
55 _PUBLIC_ size_t ndr_align_size(uint32_t offset, size_t n)
57 if ((offset & (n-1)) == 0) return 0;
58 return n - (offset & (n-1));
62 initialise a ndr parse structure from a data blob
64 _PUBLIC_ struct ndr_pull *ndr_pull_init_blob(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx)
66 struct ndr_pull *ndr;
68 ndr = talloc_zero(mem_ctx, struct ndr_pull);
69 if (!ndr) return NULL;
70 ndr->current_mem_ctx = mem_ctx;
72 ndr->data = blob->data;
73 ndr->data_size = blob->length;
75 return ndr;
78 _PUBLIC_ enum ndr_err_code ndr_pull_append(struct ndr_pull *ndr, DATA_BLOB *blob)
80 enum ndr_err_code ndr_err;
81 DATA_BLOB b;
82 uint32_t append = 0;
83 bool ok;
85 if (blob->length == 0) {
86 return NDR_ERR_SUCCESS;
89 ndr_err = ndr_token_retrieve(&ndr->array_size_list, ndr, &append);
90 if (ndr_err == NDR_ERR_TOKEN) {
91 append = 0;
92 ndr_err = NDR_ERR_SUCCESS;
94 NDR_CHECK(ndr_err);
96 if (ndr->data_size == 0) {
97 ndr->data = NULL;
98 append = UINT32_MAX;
101 if (append == UINT32_MAX) {
103 * append == UINT32_MAX means that
104 * ndr->data is either NULL or a valid
105 * talloc child of ndr, which means
106 * we can use data_blob_append() without
107 * data_blob_talloc() of the existing callers data
109 b = data_blob_const(ndr->data, ndr->data_size);
110 } else {
111 b = data_blob_talloc(ndr, ndr->data, ndr->data_size);
112 if (b.data == NULL) {
113 return ndr_pull_error(ndr, NDR_ERR_ALLOC, "%s", __location__);
117 ok = data_blob_append(ndr, &b, blob->data, blob->length);
118 if (!ok) {
119 return ndr_pull_error(ndr, NDR_ERR_ALLOC, "%s", __location__);
122 ndr->data = b.data;
123 ndr->data_size = b.length;
125 return ndr_token_store(ndr, &ndr->array_size_list, ndr, UINT32_MAX);
128 _PUBLIC_ enum ndr_err_code ndr_pull_pop(struct ndr_pull *ndr)
130 uint32_t skip = 0;
131 uint32_t append = 0;
133 if (ndr->relative_base_offset != 0) {
134 return ndr_pull_error(ndr, NDR_ERR_RELATIVE,
135 "%s", __location__);
137 if (ndr->relative_highest_offset != 0) {
138 return ndr_pull_error(ndr, NDR_ERR_RELATIVE,
139 "%s", __location__);
141 if (ndr->relative_list != NULL) {
142 return ndr_pull_error(ndr, NDR_ERR_RELATIVE,
143 "%s", __location__);
145 if (ndr->relative_base_list != NULL) {
146 return ndr_pull_error(ndr, NDR_ERR_RELATIVE,
147 "%s", __location__);
151 * we need to keep up to 7 bytes
152 * in order to get the aligment right.
154 skip = ndr->offset & 0xFFFFFFF8;
156 if (skip == 0) {
157 return NDR_ERR_SUCCESS;
160 ndr->offset -= skip;
161 ndr->data_size -= skip;
163 append = ndr_token_peek(&ndr->array_size_list, ndr);
164 if (append != UINT32_MAX) {
166 * here we assume, that ndr->data is not a
167 * talloc child of ndr.
169 ndr->data += skip;
170 return NDR_ERR_SUCCESS;
173 memmove(ndr->data, ndr->data + skip, ndr->data_size);
175 ndr->data = talloc_realloc(ndr, ndr->data, uint8_t, ndr->data_size);
176 if (ndr->data_size != 0 && ndr->data == NULL) {
177 return ndr_pull_error(ndr, NDR_ERR_ALLOC, "%s", __location__);
180 return NDR_ERR_SUCCESS;
184 advance by 'size' bytes
186 _PUBLIC_ enum ndr_err_code ndr_pull_advance(struct ndr_pull *ndr, uint32_t size)
188 ndr->offset += size;
189 if (ndr->offset > ndr->data_size) {
190 return ndr_pull_error(ndr, NDR_ERR_BUFSIZE,
191 "ndr_pull_advance by %u failed",
192 size);
194 return NDR_ERR_SUCCESS;
198 set the parse offset to 'ofs'
200 static enum ndr_err_code ndr_pull_set_offset(struct ndr_pull *ndr, uint32_t ofs)
202 ndr->offset = ofs;
203 if (ndr->offset > ndr->data_size) {
204 return ndr_pull_error(ndr, NDR_ERR_BUFSIZE,
205 "ndr_pull_set_offset %u failed",
206 ofs);
208 return NDR_ERR_SUCCESS;
211 /* create a ndr_push structure, ready for some marshalling */
212 _PUBLIC_ struct ndr_push *ndr_push_init_ctx(TALLOC_CTX *mem_ctx)
214 struct ndr_push *ndr;
216 ndr = talloc_zero(mem_ctx, struct ndr_push);
217 if (!ndr) {
218 return NULL;
221 ndr->flags = 0;
222 ndr->alloc_size = NDR_BASE_MARSHALL_SIZE;
223 ndr->data = talloc_array(ndr, uint8_t, ndr->alloc_size);
224 if (!ndr->data) {
225 talloc_free(ndr);
226 return NULL;
229 return ndr;
232 /* return a DATA_BLOB structure for the current ndr_push marshalled data */
233 _PUBLIC_ DATA_BLOB ndr_push_blob(struct ndr_push *ndr)
235 DATA_BLOB blob;
236 blob = data_blob_const(ndr->data, ndr->offset);
237 if (ndr->alloc_size > ndr->offset) {
238 ndr->data[ndr->offset] = 0;
240 return blob;
245 expand the available space in the buffer to ndr->offset + extra_size
247 _PUBLIC_ enum ndr_err_code ndr_push_expand(struct ndr_push *ndr, uint32_t extra_size)
249 uint32_t size = extra_size + ndr->offset;
251 if (size < ndr->offset) {
252 /* extra_size overflowed the offset */
253 return ndr_push_error(ndr, NDR_ERR_BUFSIZE, "Overflow in push_expand to %u",
254 size);
257 if (ndr->alloc_size > size) {
258 return NDR_ERR_SUCCESS;
261 ndr->alloc_size += NDR_BASE_MARSHALL_SIZE;
262 if (size+1 > ndr->alloc_size) {
263 ndr->alloc_size = size+1;
265 ndr->data = talloc_realloc(ndr, ndr->data, uint8_t, ndr->alloc_size);
266 if (!ndr->data) {
267 return ndr_push_error(ndr, NDR_ERR_ALLOC, "Failed to push_expand to %u",
268 ndr->alloc_size);
271 return NDR_ERR_SUCCESS;
274 _PUBLIC_ void ndr_print_debugc_helper(struct ndr_print *ndr, const char *format, ...)
276 va_list ap;
277 char *s = NULL;
278 uint32_t i;
279 int ret;
280 int dbgc_class;
282 va_start(ap, format);
283 ret = vasprintf(&s, format, ap);
284 va_end(ap);
286 if (ret == -1) {
287 return;
290 dbgc_class = *(int *)ndr->private_data;
292 if (ndr->no_newline) {
293 DEBUGADDC(dbgc_class, 1,("%s", s));
294 free(s);
295 return;
298 for (i=0;i<ndr->depth;i++) {
299 DEBUGADDC(dbgc_class, 1,(" "));
302 DEBUGADDC(dbgc_class, 1,("%s\n", s));
303 free(s);
306 _PUBLIC_ void ndr_print_debug_helper(struct ndr_print *ndr, const char *format, ...)
308 va_list ap;
309 char *s = NULL;
310 uint32_t i;
311 int ret;
313 va_start(ap, format);
314 ret = vasprintf(&s, format, ap);
315 va_end(ap);
317 if (ret == -1) {
318 return;
321 if (ndr->no_newline) {
322 DEBUGADD(1,("%s", s));
323 free(s);
324 return;
327 for (i=0;i<ndr->depth;i++) {
328 DEBUGADD(1,(" "));
331 DEBUGADD(1,("%s\n", s));
332 free(s);
335 _PUBLIC_ void ndr_print_printf_helper(struct ndr_print *ndr, const char *format, ...)
337 va_list ap;
338 uint32_t i;
340 if (!ndr->no_newline) {
341 for (i=0;i<ndr->depth;i++) {
342 printf(" ");
346 va_start(ap, format);
347 vprintf(format, ap);
348 va_end(ap);
349 if (!ndr->no_newline) {
350 printf("\n");
354 _PUBLIC_ void ndr_print_string_helper(struct ndr_print *ndr, const char *format, ...)
356 va_list ap;
357 uint32_t i;
359 if (!ndr->no_newline) {
360 for (i=0;i<ndr->depth;i++) {
361 ndr->private_data = talloc_asprintf_append_buffer(
362 (char *)ndr->private_data, " ");
366 va_start(ap, format);
367 ndr->private_data = talloc_vasprintf_append_buffer((char *)ndr->private_data,
368 format, ap);
369 va_end(ap);
370 if (!ndr->no_newline) {
371 ndr->private_data = talloc_asprintf_append_buffer((char *)ndr->private_data,
372 "\n");
377 a useful helper function for printing idl structures via DEBUGC()
379 _PUBLIC_ void ndr_print_debugc(int dbgc_class, ndr_print_fn_t fn, const char *name, void *ptr)
381 struct ndr_print *ndr;
383 DEBUGC(dbgc_class, 1,(" "));
385 ndr = talloc_zero(NULL, struct ndr_print);
386 if (!ndr) return;
387 ndr->private_data = &dbgc_class;
388 ndr->print = ndr_print_debugc_helper;
389 ndr->depth = 1;
390 ndr->flags = 0;
391 fn(ndr, name, ptr);
392 talloc_free(ndr);
396 a useful helper function for printing idl structures via DEBUG()
398 _PUBLIC_ void ndr_print_debug(ndr_print_fn_t fn, const char *name, void *ptr)
400 struct ndr_print *ndr;
402 DEBUG(1,(" "));
404 ndr = talloc_zero(NULL, struct ndr_print);
405 if (!ndr) return;
406 ndr->print = ndr_print_debug_helper;
407 ndr->depth = 1;
408 ndr->flags = 0;
409 fn(ndr, name, ptr);
410 talloc_free(ndr);
414 a useful helper function for printing idl unions via DEBUG()
416 _PUBLIC_ void ndr_print_union_debug(ndr_print_fn_t fn, const char *name, uint32_t level, void *ptr)
418 struct ndr_print *ndr;
420 DEBUG(1,(" "));
422 ndr = talloc_zero(NULL, struct ndr_print);
423 if (!ndr) return;
424 ndr->print = ndr_print_debug_helper;
425 ndr->depth = 1;
426 ndr->flags = 0;
427 ndr_print_set_switch_value(ndr, ptr, level);
428 fn(ndr, name, ptr);
429 talloc_free(ndr);
433 a useful helper function for printing idl function calls via DEBUG()
435 _PUBLIC_ void ndr_print_function_debug(ndr_print_function_t fn, const char *name, int flags, void *ptr)
437 struct ndr_print *ndr;
439 DEBUG(1,(" "));
441 ndr = talloc_zero(NULL, struct ndr_print);
442 if (!ndr) return;
443 ndr->print = ndr_print_debug_helper;
444 ndr->depth = 1;
445 ndr->flags = 0;
447 fn(ndr, name, flags, ptr);
448 talloc_free(ndr);
452 a useful helper function for printing idl structures to a string
454 _PUBLIC_ char *ndr_print_struct_string(TALLOC_CTX *mem_ctx, ndr_print_fn_t fn, const char *name, void *ptr)
456 struct ndr_print *ndr;
457 char *ret = NULL;
459 ndr = talloc_zero(mem_ctx, struct ndr_print);
460 if (!ndr) return NULL;
461 ndr->private_data = talloc_strdup(ndr, "");
462 if (!ndr->private_data) {
463 goto failed;
465 ndr->print = ndr_print_string_helper;
466 ndr->depth = 1;
467 ndr->flags = 0;
469 fn(ndr, name, ptr);
470 ret = talloc_steal(mem_ctx, (char *)ndr->private_data);
471 failed:
472 talloc_free(ndr);
473 return ret;
477 a useful helper function for printing idl unions to a string
479 _PUBLIC_ char *ndr_print_union_string(TALLOC_CTX *mem_ctx, ndr_print_fn_t fn, const char *name, uint32_t level, void *ptr)
481 struct ndr_print *ndr;
482 char *ret = NULL;
484 ndr = talloc_zero(mem_ctx, struct ndr_print);
485 if (!ndr) return NULL;
486 ndr->private_data = talloc_strdup(ndr, "");
487 if (!ndr->private_data) {
488 goto failed;
490 ndr->print = ndr_print_string_helper;
491 ndr->depth = 1;
492 ndr->flags = 0;
493 ndr_print_set_switch_value(ndr, ptr, level);
494 fn(ndr, name, ptr);
495 ret = talloc_steal(mem_ctx, (char *)ndr->private_data);
496 failed:
497 talloc_free(ndr);
498 return ret;
502 a useful helper function for printing idl function calls to a string
504 _PUBLIC_ char *ndr_print_function_string(TALLOC_CTX *mem_ctx,
505 ndr_print_function_t fn, const char *name,
506 int flags, void *ptr)
508 struct ndr_print *ndr;
509 char *ret = NULL;
511 ndr = talloc_zero(mem_ctx, struct ndr_print);
512 if (!ndr) return NULL;
513 ndr->private_data = talloc_strdup(ndr, "");
514 if (!ndr->private_data) {
515 goto failed;
517 ndr->print = ndr_print_string_helper;
518 ndr->depth = 1;
519 ndr->flags = 0;
520 fn(ndr, name, flags, ptr);
521 ret = talloc_steal(mem_ctx, (char *)ndr->private_data);
522 failed:
523 talloc_free(ndr);
524 return ret;
527 _PUBLIC_ void ndr_set_flags(uint32_t *pflags, uint32_t new_flags)
529 /* the big/little endian flags are inter-dependent */
530 if (new_flags & LIBNDR_FLAG_LITTLE_ENDIAN) {
531 (*pflags) &= ~LIBNDR_FLAG_BIGENDIAN;
532 (*pflags) &= ~LIBNDR_FLAG_NDR64;
534 if (new_flags & LIBNDR_FLAG_BIGENDIAN) {
535 (*pflags) &= ~LIBNDR_FLAG_LITTLE_ENDIAN;
536 (*pflags) &= ~LIBNDR_FLAG_NDR64;
538 if (new_flags & LIBNDR_ALIGN_FLAGS) {
539 /* Ensure we only have the passed-in
540 align flag set in the new_flags,
541 remove any old align flag. */
542 (*pflags) &= ~LIBNDR_ALIGN_FLAGS;
544 if (new_flags & LIBNDR_FLAG_NO_RELATIVE_REVERSE) {
545 (*pflags) &= ~LIBNDR_FLAG_RELATIVE_REVERSE;
547 (*pflags) |= new_flags;
551 return and possibly log an NDR error
553 _PUBLIC_ enum ndr_err_code ndr_pull_error(struct ndr_pull *ndr,
554 enum ndr_err_code ndr_err,
555 const char *format, ...)
557 char *s=NULL;
558 va_list ap;
559 int ret;
561 if (ndr->flags & LIBNDR_FLAG_INCOMPLETE_BUFFER) {
562 switch (ndr_err) {
563 case NDR_ERR_BUFSIZE:
564 return NDR_ERR_INCOMPLETE_BUFFER;
565 default:
566 break;
570 va_start(ap, format);
571 ret = vasprintf(&s, format, ap);
572 va_end(ap);
574 if (ret == -1) {
575 return NDR_ERR_ALLOC;
578 DEBUG(1,("ndr_pull_error(%u): %s\n", ndr_err, s));
580 free(s);
582 return ndr_err;
586 return and possibly log an NDR error
588 _PUBLIC_ enum ndr_err_code ndr_push_error(struct ndr_push *ndr,
589 enum ndr_err_code ndr_err,
590 const char *format, ...)
592 char *s=NULL;
593 va_list ap;
594 int ret;
596 va_start(ap, format);
597 ret = vasprintf(&s, format, ap);
598 va_end(ap);
600 if (ret == -1) {
601 return NDR_ERR_ALLOC;
604 DEBUG(1,("ndr_push_error(%u): %s\n", ndr_err, s));
606 free(s);
608 return ndr_err;
612 handle subcontext buffers, which in midl land are user-marshalled, but
613 we use magic in pidl to make them easier to cope with
615 _PUBLIC_ enum ndr_err_code ndr_pull_subcontext_start(struct ndr_pull *ndr,
616 struct ndr_pull **_subndr,
617 size_t header_size,
618 ssize_t size_is)
620 struct ndr_pull *subndr;
621 uint32_t r_content_size;
622 bool force_le = false;
623 bool force_be = false;
625 switch (header_size) {
626 case 0: {
627 uint32_t content_size = ndr->data_size - ndr->offset;
628 if (size_is >= 0) {
629 content_size = size_is;
631 r_content_size = content_size;
632 break;
635 case 2: {
636 uint16_t content_size;
637 NDR_CHECK(ndr_pull_uint16(ndr, NDR_SCALARS, &content_size));
638 if (size_is >= 0 && size_is != content_size) {
639 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext (PULL) size_is(%d) (0x%04x) mismatch content_size %d (0x%04x)",
640 (int)size_is, (int)size_is,
641 (int)content_size,
642 (int)content_size);
644 r_content_size = content_size;
645 break;
648 case 4: {
649 uint32_t content_size;
650 NDR_CHECK(ndr_pull_uint3264(ndr, NDR_SCALARS, &content_size));
651 if (size_is >= 0 && size_is != content_size) {
652 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext (PULL) size_is(%d) (0x%08x) mismatch content_size %d (0x%08x)",
653 (int)size_is, (int)size_is,
654 (int)content_size,
655 (int)content_size);
657 r_content_size = content_size;
658 break;
660 case 0xFFFFFC01: {
662 * Common Type Header for the Serialization Stream
663 * See [MS-RPCE] 2.2.6 Type Serialization Version 1
665 uint8_t version;
666 uint8_t drep;
667 uint16_t hdrlen;
668 uint32_t filler;
669 uint32_t content_size;
670 uint32_t reserved;
672 /* version */
673 NDR_CHECK(ndr_pull_uint8(ndr, NDR_SCALARS, &version));
675 if (version != 1) {
676 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT,
677 "Bad subcontext (PULL) Common Type Header version %d != 1",
678 (int)version);
682 * 0x10 little endian
683 * 0x00 big endian
685 NDR_CHECK(ndr_pull_uint8(ndr, NDR_SCALARS, &drep));
686 if (drep == 0x10) {
687 force_le = true;
688 } else if (drep == 0x00) {
689 force_be = true;
690 } else {
691 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT,
692 "Bad subcontext (PULL) Common Type Header invalid drep 0x%02X",
693 (unsigned int)drep);
696 /* length of the "Private Header for Constructed Type" */
697 NDR_CHECK(ndr_pull_uint16(ndr, NDR_SCALARS, &hdrlen));
698 if (hdrlen != 8) {
699 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT,
700 "Bad subcontext (PULL) Common Type Header length %d != 8",
701 (int)hdrlen);
704 /* filler should be ignored */
705 NDR_CHECK(ndr_pull_uint32(ndr, NDR_SCALARS, &filler));
708 * Private Header for Constructed Type
710 /* length - will be updated latter */
711 NDR_CHECK(ndr_pull_uint32(ndr, NDR_SCALARS, &content_size));
712 if (size_is >= 0 && size_is != content_size) {
713 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext (PULL) size_is(%d) mismatch content_size %d",
714 (int)size_is, (int)content_size);
716 /* the content size must be a multiple of 8 */
717 if ((content_size % 8) != 0) {
718 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT,
719 "Bad subcontext (PULL) size_is(%d) not padded to 8 content_size %d",
720 (int)size_is, (int)content_size);
722 r_content_size = content_size;
724 /* reserved */
725 NDR_CHECK(ndr_pull_uint32(ndr, NDR_SCALARS, &reserved));
726 break;
728 case 0xFFFFFFFF:
730 * a shallow copy like subcontext
731 * useful for DCERPC pipe chunks.
733 subndr = talloc_zero(ndr, struct ndr_pull);
734 NDR_ERR_HAVE_NO_MEMORY(subndr);
736 subndr->flags = ndr->flags;
737 subndr->current_mem_ctx = ndr->current_mem_ctx;
738 subndr->data = ndr->data;
739 subndr->offset = ndr->offset;
740 subndr->data_size = ndr->data_size;
742 *_subndr = subndr;
743 return NDR_ERR_SUCCESS;
745 default:
746 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext (PULL) header_size %d",
747 (int)header_size);
750 NDR_PULL_NEED_BYTES(ndr, r_content_size);
752 subndr = talloc_zero(ndr, struct ndr_pull);
753 NDR_ERR_HAVE_NO_MEMORY(subndr);
754 subndr->flags = ndr->flags & ~LIBNDR_FLAG_NDR64;
755 subndr->current_mem_ctx = ndr->current_mem_ctx;
757 subndr->data = ndr->data + ndr->offset;
758 subndr->offset = 0;
759 subndr->data_size = r_content_size;
761 if (force_le) {
762 ndr_set_flags(&ndr->flags, LIBNDR_FLAG_LITTLE_ENDIAN);
763 } else if (force_be) {
764 ndr_set_flags(&ndr->flags, LIBNDR_FLAG_BIGENDIAN);
767 *_subndr = subndr;
768 return NDR_ERR_SUCCESS;
771 _PUBLIC_ enum ndr_err_code ndr_pull_subcontext_end(struct ndr_pull *ndr,
772 struct ndr_pull *subndr,
773 size_t header_size,
774 ssize_t size_is)
776 uint32_t advance;
777 uint32_t highest_ofs;
779 if (header_size == 0xFFFFFFFF) {
780 advance = subndr->offset - ndr->offset;
781 } else if (size_is >= 0) {
782 advance = size_is;
783 } else if (header_size > 0) {
784 advance = subndr->data_size;
785 } else {
786 advance = subndr->offset;
789 if (subndr->offset > ndr->relative_highest_offset) {
790 highest_ofs = subndr->offset;
791 } else {
792 highest_ofs = subndr->relative_highest_offset;
794 if (!(subndr->flags & LIBNDR_FLAG_SUBCONTEXT_NO_UNREAD_BYTES)) {
796 * avoid an error unless SUBCONTEXT_NO_UNREAD_BYTES is specified
798 highest_ofs = advance;
800 if (highest_ofs < advance) {
801 return ndr_pull_error(subndr, NDR_ERR_UNREAD_BYTES,
802 "not all bytes consumed ofs[%u] advance[%u]",
803 highest_ofs, advance);
806 NDR_CHECK(ndr_pull_advance(ndr, advance));
807 return NDR_ERR_SUCCESS;
810 _PUBLIC_ enum ndr_err_code ndr_push_subcontext_start(struct ndr_push *ndr,
811 struct ndr_push **_subndr,
812 size_t header_size,
813 ssize_t size_is)
815 struct ndr_push *subndr;
817 subndr = ndr_push_init_ctx(ndr);
818 NDR_ERR_HAVE_NO_MEMORY(subndr);
819 subndr->flags = ndr->flags & ~LIBNDR_FLAG_NDR64;
821 if (size_is > 0) {
822 NDR_CHECK(ndr_push_zero(subndr, size_is));
823 subndr->offset = 0;
824 subndr->relative_end_offset = size_is;
827 *_subndr = subndr;
828 return NDR_ERR_SUCCESS;
832 push a subcontext header
834 _PUBLIC_ enum ndr_err_code ndr_push_subcontext_end(struct ndr_push *ndr,
835 struct ndr_push *subndr,
836 size_t header_size,
837 ssize_t size_is)
839 ssize_t padding_len;
841 if (size_is >= 0) {
842 padding_len = size_is - subndr->offset;
843 if (padding_len < 0) {
844 return ndr_push_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext (PUSH) content_size %d is larger than size_is(%d)",
845 (int)subndr->offset, (int)size_is);
847 subndr->offset = size_is;
850 switch (header_size) {
851 case 0:
852 break;
854 case 2:
855 NDR_CHECK(ndr_push_uint16(ndr, NDR_SCALARS, subndr->offset));
856 break;
858 case 4:
859 NDR_CHECK(ndr_push_uint3264(ndr, NDR_SCALARS, subndr->offset));
860 break;
862 case 0xFFFFFC01:
864 * Common Type Header for the Serialization Stream
865 * See [MS-RPCE] 2.2.6 Type Serialization Version 1
867 padding_len = NDR_ROUND(subndr->offset, 8) - subndr->offset;
868 if (padding_len > 0) {
869 NDR_CHECK(ndr_push_zero(subndr, padding_len));
872 /* version */
873 NDR_CHECK(ndr_push_uint8(ndr, NDR_SCALARS, 1));
876 * 0x10 little endian
877 * 0x00 big endian
879 NDR_CHECK(ndr_push_uint8(ndr, NDR_SCALARS, NDR_BE(ndr)?0x00:0x10));
881 /* length of the "Private Header for Constructed Type" */
882 NDR_CHECK(ndr_push_uint16(ndr, NDR_SCALARS, 8));
884 /* filler */
885 NDR_CHECK(ndr_push_uint32(ndr, NDR_SCALARS, 0xCCCCCCCC));
888 * Private Header for Constructed Type
890 /* length - will be updated latter */
891 NDR_CHECK(ndr_push_uint32(ndr, NDR_SCALARS, subndr->offset));
893 /* reserved */
894 NDR_CHECK(ndr_push_uint32(ndr, NDR_SCALARS, 0));
895 break;
897 default:
898 return ndr_push_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext header size %d",
899 (int)header_size);
902 NDR_CHECK(ndr_push_bytes(ndr, subndr->data, subndr->offset));
903 return NDR_ERR_SUCCESS;
907 store a token in the ndr context, for later retrieval
909 _PUBLIC_ enum ndr_err_code ndr_token_store(TALLOC_CTX *mem_ctx,
910 struct ndr_token_list **list,
911 const void *key,
912 uint32_t value)
914 struct ndr_token_list *tok;
915 tok = talloc(mem_ctx, struct ndr_token_list);
916 NDR_ERR_HAVE_NO_MEMORY(tok);
917 tok->key = key;
918 tok->value = value;
919 DLIST_ADD((*list), tok);
920 return NDR_ERR_SUCCESS;
924 retrieve a token from a ndr context, using cmp_fn to match the tokens
926 _PUBLIC_ enum ndr_err_code ndr_token_retrieve_cmp_fn(struct ndr_token_list **list, const void *key, uint32_t *v,
927 comparison_fn_t _cmp_fn, bool _remove_tok)
929 struct ndr_token_list *tok;
930 for (tok=*list;tok;tok=tok->next) {
931 if (_cmp_fn && _cmp_fn(tok->key,key)==0) goto found;
932 else if (!_cmp_fn && tok->key == key) goto found;
934 return NDR_ERR_TOKEN;
935 found:
936 *v = tok->value;
937 if (_remove_tok) {
938 DLIST_REMOVE((*list), tok);
939 talloc_free(tok);
941 return NDR_ERR_SUCCESS;
945 retrieve a token from a ndr context
947 _PUBLIC_ enum ndr_err_code ndr_token_retrieve(struct ndr_token_list **list, const void *key, uint32_t *v)
949 return ndr_token_retrieve_cmp_fn(list, key, v, NULL, true);
953 peek at but don't removed a token from a ndr context
955 _PUBLIC_ uint32_t ndr_token_peek(struct ndr_token_list **list, const void *key)
957 struct ndr_token_list *tok;
958 for (tok = *list; tok; tok = tok->next) {
959 if (tok->key == key) {
960 return tok->value;
963 return 0;
967 pull an array size field and add it to the array_size_list token list
969 _PUBLIC_ enum ndr_err_code ndr_pull_array_size(struct ndr_pull *ndr, const void *p)
971 uint32_t size;
972 NDR_CHECK(ndr_pull_uint3264(ndr, NDR_SCALARS, &size));
973 return ndr_token_store(ndr, &ndr->array_size_list, p, size);
977 get the stored array size field
979 _PUBLIC_ uint32_t ndr_get_array_size(struct ndr_pull *ndr, const void *p)
981 return ndr_token_peek(&ndr->array_size_list, p);
985 check the stored array size field
987 _PUBLIC_ enum ndr_err_code ndr_check_array_size(struct ndr_pull *ndr, void *p, uint32_t size)
989 uint32_t stored;
990 stored = ndr_token_peek(&ndr->array_size_list, p);
991 if (stored != size) {
992 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
993 "Bad array size - got %u expected %u\n",
994 stored, size);
996 return NDR_ERR_SUCCESS;
1000 pull an array length field and add it to the array_length_list token list
1002 _PUBLIC_ enum ndr_err_code ndr_pull_array_length(struct ndr_pull *ndr, const void *p)
1004 uint32_t length, offset;
1005 NDR_CHECK(ndr_pull_uint3264(ndr, NDR_SCALARS, &offset));
1006 if (offset != 0) {
1007 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
1008 "non-zero array offset %u\n", offset);
1010 NDR_CHECK(ndr_pull_uint3264(ndr, NDR_SCALARS, &length));
1011 return ndr_token_store(ndr, &ndr->array_length_list, p, length);
1015 get the stored array length field
1017 _PUBLIC_ uint32_t ndr_get_array_length(struct ndr_pull *ndr, const void *p)
1019 return ndr_token_peek(&ndr->array_length_list, p);
1023 check the stored array length field
1025 _PUBLIC_ enum ndr_err_code ndr_check_array_length(struct ndr_pull *ndr, void *p, uint32_t length)
1027 uint32_t stored;
1028 stored = ndr_token_peek(&ndr->array_length_list, p);
1029 if (stored != length) {
1030 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
1031 "Bad array length - got %u expected %u\n",
1032 stored, length);
1034 return NDR_ERR_SUCCESS;
1037 _PUBLIC_ enum ndr_err_code ndr_push_pipe_chunk_trailer(struct ndr_push *ndr, int ndr_flags, uint32_t count)
1039 if (ndr->flags & LIBNDR_FLAG_NDR64) {
1040 int64_t tmp = 0 - (int64_t)count;
1041 uint64_t ncount = tmp;
1043 NDR_CHECK(ndr_push_hyper(ndr, ndr_flags, ncount));
1046 return NDR_ERR_SUCCESS;
1049 _PUBLIC_ enum ndr_err_code ndr_check_pipe_chunk_trailer(struct ndr_pull *ndr, int ndr_flags, uint32_t count)
1051 if (ndr->flags & LIBNDR_FLAG_NDR64) {
1052 int64_t tmp = 0 - (int64_t)count;
1053 uint64_t ncount1 = tmp;
1054 uint64_t ncount2;
1056 NDR_CHECK(ndr_pull_hyper(ndr, ndr_flags, &ncount2));
1057 if (ncount1 == ncount2) {
1058 return NDR_ERR_SUCCESS;
1061 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
1062 "Bad pipe trailer[%lld should be %lld] size was %lu\"",
1063 (unsigned long long)ncount2,
1064 (unsigned long long)ncount1,
1065 (unsigned long)count);
1068 return NDR_ERR_SUCCESS;
1072 store a switch value
1074 _PUBLIC_ enum ndr_err_code ndr_push_set_switch_value(struct ndr_push *ndr, const void *p, uint32_t val)
1076 return ndr_token_store(ndr, &ndr->switch_list, p, val);
1079 _PUBLIC_ enum ndr_err_code ndr_pull_set_switch_value(struct ndr_pull *ndr, const void *p, uint32_t val)
1081 return ndr_token_store(ndr, &ndr->switch_list, p, val);
1084 _PUBLIC_ enum ndr_err_code ndr_print_set_switch_value(struct ndr_print *ndr, const void *p, uint32_t val)
1086 return ndr_token_store(ndr, &ndr->switch_list, p, val);
1090 retrieve a switch value
1092 _PUBLIC_ uint32_t ndr_push_get_switch_value(struct ndr_push *ndr, const void *p)
1094 return ndr_token_peek(&ndr->switch_list, p);
1097 _PUBLIC_ uint32_t ndr_pull_get_switch_value(struct ndr_pull *ndr, const void *p)
1099 return ndr_token_peek(&ndr->switch_list, p);
1102 _PUBLIC_ uint32_t ndr_print_get_switch_value(struct ndr_print *ndr, const void *p)
1104 return ndr_token_peek(&ndr->switch_list, p);
1107 /* retrieve a switch value and remove it from the list */
1108 _PUBLIC_ uint32_t ndr_pull_steal_switch_value(struct ndr_pull *ndr, const void *p)
1110 enum ndr_err_code status;
1111 uint32_t v;
1113 status = ndr_token_retrieve(&ndr->switch_list, p, &v);
1114 if (!NDR_ERR_CODE_IS_SUCCESS(status)) {
1115 return 0;
1118 return v;
1122 pull a struct from a blob using NDR
1124 _PUBLIC_ enum ndr_err_code ndr_pull_struct_blob(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx, void *p,
1125 ndr_pull_flags_fn_t fn)
1127 struct ndr_pull *ndr;
1128 ndr = ndr_pull_init_blob(blob, mem_ctx);
1129 NDR_ERR_HAVE_NO_MEMORY(ndr);
1130 NDR_CHECK_FREE(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1131 talloc_free(ndr);
1132 return NDR_ERR_SUCCESS;
1136 pull a struct from a blob using NDR - failing if all bytes are not consumed
1138 _PUBLIC_ enum ndr_err_code ndr_pull_struct_blob_all(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx,
1139 void *p, ndr_pull_flags_fn_t fn)
1141 struct ndr_pull *ndr;
1142 uint32_t highest_ofs;
1143 ndr = ndr_pull_init_blob(blob, mem_ctx);
1144 NDR_ERR_HAVE_NO_MEMORY(ndr);
1145 NDR_CHECK_FREE(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1146 if (ndr->offset > ndr->relative_highest_offset) {
1147 highest_ofs = ndr->offset;
1148 } else {
1149 highest_ofs = ndr->relative_highest_offset;
1151 if (highest_ofs < ndr->data_size) {
1152 enum ndr_err_code ret;
1153 ret = ndr_pull_error(ndr, NDR_ERR_UNREAD_BYTES,
1154 "not all bytes consumed ofs[%u] size[%u]",
1155 highest_ofs, ndr->data_size);
1156 talloc_free(ndr);
1157 return ret;
1159 talloc_free(ndr);
1160 return NDR_ERR_SUCCESS;
1164 pull a struct from a blob using NDR - failing if all bytes are not consumed
1166 This only works for structures with NO allocated memory, like
1167 objectSID and GUID. This helps because we parse these a lot.
1169 _PUBLIC_ enum ndr_err_code ndr_pull_struct_blob_all_noalloc(const DATA_BLOB *blob,
1170 void *p, ndr_pull_flags_fn_t fn)
1173 * We init this structure on the stack here, to avoid a
1174 * talloc() as otherwise this call to the fn() is assured not
1175 * to be doing any allocation, eg SIDs and GUIDs.
1177 * This allows us to keep the safety of the PIDL-generated
1178 * code without the talloc() overhead.
1180 struct ndr_pull ndr = {
1181 .data = blob->data,
1182 .data_size = blob->length,
1183 .current_mem_ctx = (void *)-1
1185 uint32_t highest_ofs;
1186 NDR_CHECK(fn(&ndr, NDR_SCALARS|NDR_BUFFERS, p));
1187 if (ndr.offset > ndr.relative_highest_offset) {
1188 highest_ofs = ndr.offset;
1189 } else {
1190 highest_ofs = ndr.relative_highest_offset;
1192 if (highest_ofs < ndr.data_size) {
1193 enum ndr_err_code ret;
1194 ret = ndr_pull_error(&ndr, NDR_ERR_UNREAD_BYTES,
1195 "not all bytes consumed ofs[%u] size[%u]",
1196 highest_ofs, ndr.data_size);
1197 return ret;
1199 return NDR_ERR_SUCCESS;
1203 pull a union from a blob using NDR, given the union discriminator
1205 _PUBLIC_ enum ndr_err_code ndr_pull_union_blob(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx,
1206 void *p,
1207 uint32_t level, ndr_pull_flags_fn_t fn)
1209 struct ndr_pull *ndr;
1210 ndr = ndr_pull_init_blob(blob, mem_ctx);
1211 NDR_ERR_HAVE_NO_MEMORY(ndr);
1212 NDR_CHECK_FREE(ndr_pull_set_switch_value(ndr, p, level));
1213 NDR_CHECK_FREE(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1214 talloc_free(ndr);
1215 return NDR_ERR_SUCCESS;
1219 pull a union from a blob using NDR, given the union discriminator,
1220 failing if all bytes are not consumed
1222 _PUBLIC_ enum ndr_err_code ndr_pull_union_blob_all(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx,
1223 void *p,
1224 uint32_t level, ndr_pull_flags_fn_t fn)
1226 struct ndr_pull *ndr;
1227 uint32_t highest_ofs;
1228 ndr = ndr_pull_init_blob(blob, mem_ctx);
1229 NDR_ERR_HAVE_NO_MEMORY(ndr);
1230 NDR_CHECK_FREE(ndr_pull_set_switch_value(ndr, p, level));
1231 NDR_CHECK_FREE(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1232 if (ndr->offset > ndr->relative_highest_offset) {
1233 highest_ofs = ndr->offset;
1234 } else {
1235 highest_ofs = ndr->relative_highest_offset;
1237 if (highest_ofs < ndr->data_size) {
1238 enum ndr_err_code ret;
1239 ret = ndr_pull_error(ndr, NDR_ERR_UNREAD_BYTES,
1240 "not all bytes consumed ofs[%u] size[%u]",
1241 highest_ofs, ndr->data_size);
1242 talloc_free(ndr);
1243 return ret;
1245 talloc_free(ndr);
1246 return NDR_ERR_SUCCESS;
1250 push a struct to a blob using NDR
1252 _PUBLIC_ enum ndr_err_code ndr_push_struct_blob(DATA_BLOB *blob, TALLOC_CTX *mem_ctx, const void *p, ndr_push_flags_fn_t fn)
1254 struct ndr_push *ndr;
1255 ndr = ndr_push_init_ctx(mem_ctx);
1256 NDR_ERR_HAVE_NO_MEMORY(ndr);
1258 NDR_CHECK(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1260 *blob = ndr_push_blob(ndr);
1261 talloc_steal(mem_ctx, blob->data);
1262 talloc_free(ndr);
1264 return NDR_ERR_SUCCESS;
1268 push a union to a blob using NDR
1270 _PUBLIC_ enum ndr_err_code ndr_push_union_blob(DATA_BLOB *blob, TALLOC_CTX *mem_ctx, void *p,
1271 uint32_t level, ndr_push_flags_fn_t fn)
1273 struct ndr_push *ndr;
1274 ndr = ndr_push_init_ctx(mem_ctx);
1275 NDR_ERR_HAVE_NO_MEMORY(ndr);
1277 NDR_CHECK(ndr_push_set_switch_value(ndr, p, level));
1278 NDR_CHECK(fn(ndr, NDR_SCALARS|NDR_BUFFERS, p));
1280 *blob = ndr_push_blob(ndr);
1281 talloc_steal(mem_ctx, blob->data);
1282 talloc_free(ndr);
1284 return NDR_ERR_SUCCESS;
1288 generic ndr_size_*() handler for structures
1290 _PUBLIC_ size_t ndr_size_struct(const void *p, int flags, ndr_push_flags_fn_t push)
1292 struct ndr_push *ndr;
1293 enum ndr_err_code status;
1294 size_t ret;
1296 /* avoid recursion */
1297 if (flags & LIBNDR_FLAG_NO_NDR_SIZE) return 0;
1299 ndr = ndr_push_init_ctx(NULL);
1300 if (!ndr) return 0;
1301 ndr->flags |= flags | LIBNDR_FLAG_NO_NDR_SIZE;
1302 status = push(ndr, NDR_SCALARS|NDR_BUFFERS, discard_const(p));
1303 if (!NDR_ERR_CODE_IS_SUCCESS(status)) {
1304 talloc_free(ndr);
1305 return 0;
1307 ret = ndr->offset;
1308 talloc_free(ndr);
1309 return ret;
1313 generic ndr_size_*() handler for unions
1315 _PUBLIC_ size_t ndr_size_union(const void *p, int flags, uint32_t level, ndr_push_flags_fn_t push)
1317 struct ndr_push *ndr;
1318 enum ndr_err_code status;
1319 size_t ret;
1321 /* avoid recursion */
1322 if (flags & LIBNDR_FLAG_NO_NDR_SIZE) return 0;
1324 ndr = ndr_push_init_ctx(NULL);
1325 if (!ndr) return 0;
1326 ndr->flags |= flags | LIBNDR_FLAG_NO_NDR_SIZE;
1328 status = ndr_push_set_switch_value(ndr, p, level);
1329 if (!NDR_ERR_CODE_IS_SUCCESS(status)) {
1330 talloc_free(ndr);
1331 return 0;
1333 status = push(ndr, NDR_SCALARS|NDR_BUFFERS, p);
1334 if (!NDR_ERR_CODE_IS_SUCCESS(status)) {
1335 talloc_free(ndr);
1336 return 0;
1338 ret = ndr->offset;
1339 talloc_free(ndr);
1340 return ret;
1344 get the current base for relative pointers for the push
1346 _PUBLIC_ uint32_t ndr_push_get_relative_base_offset(struct ndr_push *ndr)
1348 return ndr->relative_base_offset;
1352 restore the old base for relative pointers for the push
1354 _PUBLIC_ void ndr_push_restore_relative_base_offset(struct ndr_push *ndr, uint32_t offset)
1356 ndr->relative_base_offset = offset;
1360 setup the current base for relative pointers for the push
1361 called in the NDR_SCALAR stage
1363 _PUBLIC_ enum ndr_err_code ndr_push_setup_relative_base_offset1(struct ndr_push *ndr, const void *p, uint32_t offset)
1365 ndr->relative_base_offset = offset;
1366 return ndr_token_store(ndr, &ndr->relative_base_list, p, offset);
1370 setup the current base for relative pointers for the push
1371 called in the NDR_BUFFERS stage
1373 _PUBLIC_ enum ndr_err_code ndr_push_setup_relative_base_offset2(struct ndr_push *ndr, const void *p)
1375 return ndr_token_retrieve(&ndr->relative_base_list, p, &ndr->relative_base_offset);
1379 push a relative object - stage1
1380 this is called during SCALARS processing
1382 _PUBLIC_ enum ndr_err_code ndr_push_relative_ptr1(struct ndr_push *ndr, const void *p)
1384 if (p == NULL) {
1385 NDR_CHECK(ndr_push_uint32(ndr, NDR_SCALARS, 0));
1386 return NDR_ERR_SUCCESS;
1388 NDR_CHECK(ndr_push_align(ndr, 4));
1389 NDR_CHECK(ndr_token_store(ndr, &ndr->relative_list, p, ndr->offset));
1390 return ndr_push_uint32(ndr, NDR_SCALARS, 0xFFFFFFFF);
1394 push a short relative object - stage1
1395 this is called during SCALARS processing
1397 _PUBLIC_ enum ndr_err_code ndr_push_short_relative_ptr1(struct ndr_push *ndr, const void *p)
1399 if (p == NULL) {
1400 NDR_CHECK(ndr_push_uint16(ndr, NDR_SCALARS, 0));
1401 return NDR_ERR_SUCCESS;
1403 NDR_CHECK(ndr_push_align(ndr, 2));
1404 NDR_CHECK(ndr_token_store(ndr, &ndr->relative_list, p, ndr->offset));
1405 return ndr_push_uint16(ndr, NDR_SCALARS, 0xFFFF);
1408 push a relative object - stage2
1409 this is called during buffers processing
1411 static enum ndr_err_code ndr_push_relative_ptr2(struct ndr_push *ndr, const void *p)
1413 uint32_t save_offset;
1414 uint32_t ptr_offset = 0xFFFFFFFF;
1415 if (p == NULL) {
1416 return NDR_ERR_SUCCESS;
1418 save_offset = ndr->offset;
1419 NDR_CHECK(ndr_token_retrieve(&ndr->relative_list, p, &ptr_offset));
1420 if (ptr_offset > ndr->offset) {
1421 return ndr_push_error(ndr, NDR_ERR_BUFSIZE,
1422 "ndr_push_relative_ptr2 ptr_offset(%u) > ndr->offset(%u)",
1423 ptr_offset, ndr->offset);
1425 ndr->offset = ptr_offset;
1426 if (save_offset < ndr->relative_base_offset) {
1427 return ndr_push_error(ndr, NDR_ERR_BUFSIZE,
1428 "ndr_push_relative_ptr2 save_offset(%u) < ndr->relative_base_offset(%u)",
1429 save_offset, ndr->relative_base_offset);
1431 NDR_CHECK(ndr_push_uint32(ndr, NDR_SCALARS, save_offset - ndr->relative_base_offset));
1432 ndr->offset = save_offset;
1433 return NDR_ERR_SUCCESS;
1436 push a short relative object - stage2
1437 this is called during buffers processing
1439 _PUBLIC_ enum ndr_err_code ndr_push_short_relative_ptr2(struct ndr_push *ndr, const void *p)
1441 uint32_t save_offset;
1442 uint32_t ptr_offset = 0xFFFF;
1443 if (p == NULL) {
1444 return NDR_ERR_SUCCESS;
1446 save_offset = ndr->offset;
1447 NDR_CHECK(ndr_token_retrieve(&ndr->relative_list, p, &ptr_offset));
1448 if (ptr_offset > ndr->offset) {
1449 return ndr_push_error(ndr, NDR_ERR_BUFSIZE,
1450 "ndr_push_short_relative_ptr2 ptr_offset(%u) > ndr->offset(%u)",
1451 ptr_offset, ndr->offset);
1453 ndr->offset = ptr_offset;
1454 if (save_offset < ndr->relative_base_offset) {
1455 return ndr_push_error(ndr, NDR_ERR_BUFSIZE,
1456 "ndr_push_relative_ptr2 save_offset(%u) < ndr->relative_base_offset(%u)",
1457 save_offset, ndr->relative_base_offset);
1459 NDR_CHECK(ndr_push_uint16(ndr, NDR_SCALARS, save_offset - ndr->relative_base_offset));
1460 ndr->offset = save_offset;
1461 return NDR_ERR_SUCCESS;
1465 push a relative object - stage2 start
1466 this is called during buffers processing
1468 _PUBLIC_ enum ndr_err_code ndr_push_relative_ptr2_start(struct ndr_push *ndr, const void *p)
1470 if (p == NULL) {
1471 return NDR_ERR_SUCCESS;
1473 if (!(ndr->flags & LIBNDR_FLAG_RELATIVE_REVERSE)) {
1474 uint32_t relative_offset;
1475 size_t pad;
1476 size_t align = 1;
1478 if (ndr->offset < ndr->relative_base_offset) {
1479 return ndr_push_error(ndr, NDR_ERR_BUFSIZE,
1480 "ndr_push_relative_ptr2_start ndr->offset(%u) < ndr->relative_base_offset(%u)",
1481 ndr->offset, ndr->relative_base_offset);
1484 relative_offset = ndr->offset - ndr->relative_base_offset;
1486 if (ndr->flags & LIBNDR_FLAG_NOALIGN) {
1487 align = 1;
1488 } else if (ndr->flags & LIBNDR_FLAG_ALIGN2) {
1489 align = 2;
1490 } else if (ndr->flags & LIBNDR_FLAG_ALIGN4) {
1491 align = 4;
1492 } else if (ndr->flags & LIBNDR_FLAG_ALIGN8) {
1493 align = 8;
1496 pad = ndr_align_size(relative_offset, align);
1497 if (pad) {
1498 NDR_CHECK(ndr_push_zero(ndr, pad));
1501 return ndr_push_relative_ptr2(ndr, p);
1503 if (ndr->relative_end_offset == -1) {
1504 return ndr_push_error(ndr, NDR_ERR_RELATIVE,
1505 "ndr_push_relative_ptr2_start RELATIVE_REVERSE flag set and relative_end_offset %d",
1506 ndr->relative_end_offset);
1508 NDR_CHECK(ndr_token_store(ndr, &ndr->relative_begin_list, p, ndr->offset));
1509 return NDR_ERR_SUCCESS;
1513 push a relative object - stage2 end
1514 this is called during buffers processing
1516 _PUBLIC_ enum ndr_err_code ndr_push_relative_ptr2_end(struct ndr_push *ndr, const void *p)
1518 uint32_t begin_offset = 0xFFFFFFFF;
1519 ssize_t len;
1520 uint32_t correct_offset = 0;
1521 uint32_t align = 1;
1522 uint32_t pad = 0;
1524 if (p == NULL) {
1525 return NDR_ERR_SUCCESS;
1528 if (!(ndr->flags & LIBNDR_FLAG_RELATIVE_REVERSE)) {
1529 return NDR_ERR_SUCCESS;
1532 if (ndr->flags & LIBNDR_FLAG_NO_NDR_SIZE) {
1533 /* better say more than calculation a too small buffer */
1534 NDR_PUSH_ALIGN(ndr, 8);
1535 return NDR_ERR_SUCCESS;
1538 if (ndr->relative_end_offset < ndr->offset) {
1539 return ndr_push_error(ndr, NDR_ERR_RELATIVE,
1540 "ndr_push_relative_ptr2_end:"
1541 "relative_end_offset %u < offset %u",
1542 ndr->relative_end_offset, ndr->offset);
1545 NDR_CHECK(ndr_token_retrieve(&ndr->relative_begin_list, p, &begin_offset));
1547 /* we have marshalled a buffer, see how long it was */
1548 len = ndr->offset - begin_offset;
1550 if (len < 0) {
1551 return ndr_push_error(ndr, NDR_ERR_RELATIVE,
1552 "ndr_push_relative_ptr2_end:"
1553 "offset %u - begin_offset %u < 0",
1554 ndr->offset, begin_offset);
1557 if (ndr->relative_end_offset < len) {
1558 return ndr_push_error(ndr, NDR_ERR_RELATIVE,
1559 "ndr_push_relative_ptr2_end:"
1560 "relative_end_offset %u < len %lld",
1561 ndr->offset, (long long)len);
1564 /* the reversed offset is at the end of the main buffer */
1565 correct_offset = ndr->relative_end_offset - len;
1567 if (ndr->flags & LIBNDR_FLAG_NOALIGN) {
1568 align = 1;
1569 } else if (ndr->flags & LIBNDR_FLAG_ALIGN2) {
1570 align = 2;
1571 } else if (ndr->flags & LIBNDR_FLAG_ALIGN4) {
1572 align = 4;
1573 } else if (ndr->flags & LIBNDR_FLAG_ALIGN8) {
1574 align = 8;
1577 pad = ndr_align_size(correct_offset, align);
1578 if (pad) {
1579 correct_offset += pad;
1580 correct_offset -= align;
1583 if (correct_offset < begin_offset) {
1584 return ndr_push_error(ndr, NDR_ERR_RELATIVE,
1585 "ndr_push_relative_ptr2_end: "
1586 "correct_offset %u < begin_offset %u",
1587 correct_offset, begin_offset);
1590 if (len > 0) {
1591 uint32_t clear_size = correct_offset - begin_offset;
1593 clear_size = MIN(clear_size, len);
1595 /* now move the marshalled buffer to the end of the main buffer */
1596 memmove(ndr->data + correct_offset, ndr->data + begin_offset, len);
1598 if (clear_size) {
1599 /* and wipe out old buffer within the main buffer */
1600 memset(ndr->data + begin_offset, '\0', clear_size);
1604 /* and set the end offset for the next buffer */
1605 ndr->relative_end_offset = correct_offset;
1607 /* finally write the offset to the main buffer */
1608 ndr->offset = correct_offset;
1609 NDR_CHECK(ndr_push_relative_ptr2(ndr, p));
1611 /* restore to where we were in the main buffer */
1612 ndr->offset = begin_offset;
1614 return NDR_ERR_SUCCESS;
1618 get the current base for relative pointers for the pull
1620 _PUBLIC_ uint32_t ndr_pull_get_relative_base_offset(struct ndr_pull *ndr)
1622 return ndr->relative_base_offset;
1626 restore the old base for relative pointers for the pull
1628 _PUBLIC_ void ndr_pull_restore_relative_base_offset(struct ndr_pull *ndr, uint32_t offset)
1630 ndr->relative_base_offset = offset;
1634 setup the current base for relative pointers for the pull
1635 called in the NDR_SCALAR stage
1637 _PUBLIC_ enum ndr_err_code ndr_pull_setup_relative_base_offset1(struct ndr_pull *ndr, const void *p, uint32_t offset)
1639 ndr->relative_base_offset = offset;
1640 return ndr_token_store(ndr, &ndr->relative_base_list, p, offset);
1644 setup the current base for relative pointers for the pull
1645 called in the NDR_BUFFERS stage
1647 _PUBLIC_ enum ndr_err_code ndr_pull_setup_relative_base_offset2(struct ndr_pull *ndr, const void *p)
1649 return ndr_token_retrieve(&ndr->relative_base_list, p, &ndr->relative_base_offset);
1653 pull a relative object - stage1
1654 called during SCALARS processing
1656 _PUBLIC_ enum ndr_err_code ndr_pull_relative_ptr1(struct ndr_pull *ndr, const void *p, uint32_t rel_offset)
1658 rel_offset += ndr->relative_base_offset;
1659 if (rel_offset > ndr->data_size) {
1660 return ndr_pull_error(ndr, NDR_ERR_BUFSIZE,
1661 "ndr_pull_relative_ptr1 rel_offset(%u) > ndr->data_size(%u)",
1662 rel_offset, ndr->data_size);
1664 return ndr_token_store(ndr, &ndr->relative_list, p, rel_offset);
1668 pull a relative object - stage2
1669 called during BUFFERS processing
1671 _PUBLIC_ enum ndr_err_code ndr_pull_relative_ptr2(struct ndr_pull *ndr, const void *p)
1673 uint32_t rel_offset;
1674 NDR_CHECK(ndr_token_retrieve(&ndr->relative_list, p, &rel_offset));
1675 return ndr_pull_set_offset(ndr, rel_offset);
1678 const static struct {
1679 enum ndr_err_code err;
1680 const char *string;
1681 } ndr_err_code_strings[] = {
1682 { NDR_ERR_SUCCESS, "Success" },
1683 { NDR_ERR_ARRAY_SIZE, "Bad Array Size" },
1684 { NDR_ERR_BAD_SWITCH, "Bad Switch" },
1685 { NDR_ERR_OFFSET, "Offset Error" },
1686 { NDR_ERR_RELATIVE, "Relative Pointer Error" },
1687 { NDR_ERR_CHARCNV, "Character Conversion Error" },
1688 { NDR_ERR_LENGTH, "Length Error" },
1689 { NDR_ERR_SUBCONTEXT, "Subcontext Error" },
1690 { NDR_ERR_COMPRESSION, "Compression Error" },
1691 { NDR_ERR_STRING, "String Error" },
1692 { NDR_ERR_VALIDATE, "Validate Error" },
1693 { NDR_ERR_BUFSIZE, "Buffer Size Error" },
1694 { NDR_ERR_ALLOC, "Allocation Error" },
1695 { NDR_ERR_RANGE, "Range Error" },
1696 { NDR_ERR_TOKEN, "Token Error" },
1697 { NDR_ERR_IPV4ADDRESS, "IPv4 Address Error" },
1698 { NDR_ERR_INVALID_POINTER, "Invalid Pointer" },
1699 { NDR_ERR_UNREAD_BYTES, "Unread Bytes" },
1700 { NDR_ERR_NDR64, "NDR64 assertion error" },
1701 { NDR_ERR_INCOMPLETE_BUFFER, "Incomplete Buffer" },
1702 { 0, NULL }
1705 _PUBLIC_ const char *ndr_map_error2string(enum ndr_err_code ndr_err)
1707 int i;
1708 for (i = 0; ndr_err_code_strings[i].string != NULL; i++) {
1709 if (ndr_err_code_strings[i].err == ndr_err)
1710 return ndr_err_code_strings[i].string;
1712 return "Unknown error";