source4/librpc/ndr/ndr.c

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    libndr interface
   5
   6    Copyright (C) Andrew Tridgell 2003
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 2 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program; if not, write to the Free Software
  20    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  21 */
  22
  23 /*
  24   this provides the core routines for NDR parsing functions
  25
  26   see http://www.opengroup.org/onlinepubs/9629399/chap14.htm for details
  27   of NDR encoding rules
  28 */
  29
  30 #include "includes.h"
  31 #include "dlinklist.h"
  32
  33 #define NDR_BASE_MARSHALL_SIZE 1024
  34
  35 /*
  36   work out the number of bytes needed to align on a n byte boundary
  37 */
  38 size_t ndr_align_size(uint32_t offset, size_t n)
  39 {
  40         if ((offset & (n-1)) == 0) return 0;
  41         return n - (offset & (n-1));
  42 }
  43
  44 /*
  45   initialise a ndr parse structure from a data blob
  46 */
  47 struct ndr_pull *ndr_pull_init_blob(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx)
  48 {
  49         struct ndr_pull *ndr;
  50
  51         ndr = talloc_zero(mem_ctx, struct ndr_pull);
  52         if (!ndr) return NULL;
  53
  54         ndr->data = blob->data;
  55         ndr->data_size = blob->length;
  56
  57         return ndr;
  58 }
  59
  60 /*
  61   create an ndr sub-context based on an existing context. The new context starts
  62   at the current offset, with the given size limit
  63 */
  64 NTSTATUS ndr_pull_subcontext(struct ndr_pull *ndr, struct ndr_pull *ndr2, uint32_t size)
  65 {
  66         NDR_PULL_NEED_BYTES(ndr, size);
  67         *ndr2 = *ndr;
  68         ndr2->data += ndr2->offset;
  69         ndr2->offset = 0;
  70         ndr2->data_size = size;
  71         ndr2->flags = ndr->flags;
  72         return NT_STATUS_OK;
  73 }
  74
  75
  76 /*
  77   advance by 'size' bytes
  78 */
  79 NTSTATUS ndr_pull_advance(struct ndr_pull *ndr, uint32_t size)
  80 {
  81         ndr->offset += size;
  82         if (ndr->offset > ndr->data_size) {
  83                 return ndr_pull_error(ndr, NDR_ERR_BUFSIZE,
  84                                       "ndr_pull_advance by %u failed",
  85                                       size);
  86         }
  87         return NT_STATUS_OK;
  88 }
  89
  90 /*
  91   set the parse offset to 'ofs'
  92 */
  93 NTSTATUS ndr_pull_set_offset(struct ndr_pull *ndr, uint32_t ofs)
  94 {
  95         ndr->offset = ofs;
  96         if (ndr->offset > ndr->data_size) {
  97                 return ndr_pull_error(ndr, NDR_ERR_BUFSIZE,
  98                                       "ndr_pull_set_offset %u failed",
  99                                       ofs);
 100         }
 101         return NT_STATUS_OK;
 102 }
 103
 104 /* save the offset/size of the current ndr state */
 105 void ndr_pull_save(struct ndr_pull *ndr, struct ndr_pull_save *save)
 106 {
 107         save->offset = ndr->offset;
 108         save->data_size = ndr->data_size;
 109 }
 110
 111 /* restore the size/offset of a ndr structure */
 112 void ndr_pull_restore(struct ndr_pull *ndr, struct ndr_pull_save *save)
 113 {
 114         ndr->offset = save->offset;
 115         ndr->data_size = save->data_size;
 116 }
 117
 118
 119 /* create a ndr_push structure, ready for some marshalling */
 120 struct ndr_push *ndr_push_init_ctx(TALLOC_CTX *mem_ctx)
 121 {
 122         struct ndr_push *ndr;
 123
 124         ndr = talloc_zero(mem_ctx, struct ndr_push);
 125         if (!ndr) {
 126                 return NULL;
 127         }
 128
 129         ndr->flags = 0;
 130         ndr->alloc_size = NDR_BASE_MARSHALL_SIZE;
 131         ndr->data = talloc_array(ndr, uint8_t, ndr->alloc_size);
 132         if (!ndr->data) {
 133                 return NULL;
 134         }
 135
 136         return ndr;
 137 }
 138
 139
 140 /* create a ndr_push structure, ready for some marshalling */
 141 struct ndr_push *ndr_push_init(void)
 142 {
 143         return ndr_push_init_ctx(NULL);
 144 }
 145
 146 /* free a ndr_push structure */
 147 void ndr_push_free(struct ndr_push *ndr)
 148 {
 149         talloc_free(ndr);
 150 }
 151
 152
 153 /* return a DATA_BLOB structure for the current ndr_push marshalled data */
 154 DATA_BLOB ndr_push_blob(struct ndr_push *ndr)
 155 {
 156         DATA_BLOB blob;
 157         blob.data = ndr->data;
 158         blob.length = ndr->offset;
 159         return blob;
 160 }
 161
 162
 163 /*
 164   expand the available space in the buffer to 'size'
 165 */
 166 NTSTATUS ndr_push_expand(struct ndr_push *ndr, uint32_t size)
 167 {
 168         if (ndr->alloc_size >= size) {
 169                 return NT_STATUS_OK;
 170         }
 171
 172         ndr->alloc_size += NDR_BASE_MARSHALL_SIZE;
 173         if (size > ndr->alloc_size) {
 174                 ndr->alloc_size = size;
 175         }
 176         ndr->data = talloc_realloc(ndr, ndr->data, uint8_t, ndr->alloc_size);
 177         if (!ndr->data) {
 178                 return ndr_push_error(ndr, NDR_ERR_ALLOC, "Failed to push_expand to %u",
 179                                       ndr->alloc_size);
 180         }
 181
 182         return NT_STATUS_OK;
 183 }
 184
 185 /*
 186   set the push offset to 'ofs'
 187 */
 188 NTSTATUS ndr_push_set_offset(struct ndr_push *ndr, uint32_t ofs)
 189 {
 190         NDR_CHECK(ndr_push_expand(ndr, ofs));
 191         ndr->offset = ofs;
 192         return NT_STATUS_OK;
 193 }
 194
 195 /*
 196   push a generic array
 197 */
 198 NTSTATUS ndr_push_array(struct ndr_push *ndr, int ndr_flags, void *base,
 199                         size_t elsize, uint32_t count,
 200                         NTSTATUS (*push_fn)(struct ndr_push *, int, void *))
 201 {
 202         int i;
 203         char *p = base;
 204         if (!(ndr_flags & NDR_SCALARS)) goto buffers;
 205         for (i=0;i<count;i++) {
 206                 NDR_CHECK(push_fn(ndr, NDR_SCALARS, p));
 207                 p += elsize;
 208         }
 209         if (!(ndr_flags & NDR_BUFFERS)) goto done;
 210 buffers:
 211         p = base;
 212         for (i=0;i<count;i++) {
 213                 NDR_CHECK(push_fn(ndr, NDR_BUFFERS, p));
 214                 p += elsize;
 215         }
 216 done:
 217         return NT_STATUS_OK;
 218 }
 219
 220 /*
 221   pull a constant sized array
 222 */
 223 NTSTATUS ndr_pull_array(struct ndr_pull *ndr, int ndr_flags, void *base,
 224                         size_t elsize, uint32_t count,
 225                         NTSTATUS (*pull_fn)(struct ndr_pull *, int, void *))
 226 {
 227         int i;
 228         char *p;
 229         p = base;
 230         if (!(ndr_flags & NDR_SCALARS)) goto buffers;
 231         for (i=0;i<count;i++) {
 232                 NDR_CHECK(pull_fn(ndr, NDR_SCALARS, p));
 233                 p += elsize;
 234         }
 235         if (!(ndr_flags & NDR_BUFFERS)) goto done;
 236 buffers:
 237         p = base;
 238         for (i=0;i<count;i++) {
 239                 NDR_CHECK(pull_fn(ndr, NDR_BUFFERS, p));
 240                 p += elsize;
 241         }
 242 done:
 243         return NT_STATUS_OK;
 244 }
 245
 246 /*
 247   pull a constant size array of structures
 248 */
 249 NTSTATUS ndr_pull_struct_array(struct ndr_pull *ndr, uint32_t count,
 250                                size_t elsize, void **info,
 251                                NTSTATUS (*pull_fn)(struct ndr_pull *, int, void *))
 252 {
 253         int i;
 254         char *base;
 255
 256         NDR_ALLOC_N_SIZE(ndr, *info, count, elsize);
 257         base = (char *)*info;
 258
 259         for (i = 0; i < count; i++) {
 260                 ndr->data += ndr->offset;
 261                 ndr->offset = 0;
 262                 NDR_CHECK(pull_fn(ndr, NDR_SCALARS|NDR_BUFFERS, &base[count * elsize]));
 263         }
 264
 265         return NT_STATUS_OK;
 266 }
 267
 268 /*
 269   print a generic array
 270 */
 271 void ndr_print_array(struct ndr_print *ndr, const char *name, void *base,
 272                      size_t elsize, uint32_t count,
 273                      void (*print_fn)(struct ndr_print *, const char *, void *))
 274 {
 275         int i;
 276         char *p = base;
 277         ndr->print(ndr, "%s: ARRAY(%d)", name, count);
 278         ndr->depth++;
 279         for (i=0;i<count;i++) {
 280                 char *idx=NULL;
 281                 asprintf(&idx, "[%d]", i);
 282                 if (idx) {
 283                         print_fn(ndr, idx, p);
 284                         free(idx);
 285                 }
 286                 p += elsize;
 287         }
 288         ndr->depth--;
 289 }
 290
 291
 292
 293 void ndr_print_debug_helper(struct ndr_print *ndr, const char *format, ...) _PRINTF_ATTRIBUTE(2,3)
 294 {
 295         va_list ap;
 296         char *s = NULL;
 297         int i;
 298
 299         va_start(ap, format);
 300         vasprintf(&s, format, ap);
 301         va_end(ap);
 302
 303         for (i=0;i<ndr->depth;i++) {
 304                 DEBUG(0,("    "));
 305         }
 306
 307         DEBUG(0,("%s\n", s));
 308         free(s);
 309 }
 310
 311 /*
 312   a useful helper function for printing idl structures via DEBUG()
 313 */
 314 void ndr_print_debug(ndr_print_fn_t fn, const char *name, void *ptr)
 315 {
 316         struct ndr_print *ndr;
 317
 318         ndr = talloc(NULL, struct ndr_print);
 319         if (!ndr) return;
 320         ndr->print = ndr_print_debug_helper;
 321         ndr->depth = 1;
 322         ndr->flags = 0;
 323         fn(ndr, name, ptr);
 324         talloc_free(ndr);
 325 }
 326
 327
 328 /*
 329   a useful helper function for printing idl unions via DEBUG()
 330 */
 331 void ndr_print_union_debug(ndr_print_union_fn_t fn, const char *name, uint32_t level, void *ptr)
 332 {
 333         struct ndr_print *ndr;
 334
 335         ndr = talloc(NULL, struct ndr_print);
 336         if (!ndr) return;
 337         ndr->print = ndr_print_debug_helper;
 338         ndr->depth = 1;
 339         ndr->flags = 0;
 340         fn(ndr, name, level, ptr);
 341         talloc_free(ndr);
 342 }
 343
 344 /*
 345   a useful helper function for printing idl function calls via DEBUG()
 346 */
 347 void ndr_print_function_debug(ndr_print_function_t fn, const char *name, int flags, void *ptr)
 348 {
 349         struct ndr_print *ndr;
 350
 351         ndr = talloc(NULL, struct ndr_print);
 352         if (!ndr) return;
 353         ndr->print = ndr_print_debug_helper;
 354         ndr->depth = 1;
 355         ndr->flags = 0;
 356         fn(ndr, name, flags, ptr);
 357         talloc_free(ndr);
 358 }
 359
 360 void ndr_set_flags(uint32_t *pflags, uint32_t new_flags)
 361 {
 362         /* the big/little endian flags are inter-dependent */
 363         if (new_flags & LIBNDR_FLAG_LITTLE_ENDIAN) {
 364                 (*pflags) &= ~LIBNDR_FLAG_BIGENDIAN;
 365         }
 366         if (new_flags & LIBNDR_FLAG_BIGENDIAN) {
 367                 (*pflags) &= ~LIBNDR_FLAG_LITTLE_ENDIAN;
 368         }
 369         (*pflags) |= new_flags;
 370 }
 371
 372 static NTSTATUS ndr_map_error(enum ndr_err_code err)
 373 {
 374         switch (err) {
 375         case NDR_ERR_BUFSIZE:
 376                 return NT_STATUS_BUFFER_TOO_SMALL;
 377         case NDR_ERR_TOKEN:
 378                 return NT_STATUS_INTERNAL_ERROR;
 379         case NDR_ERR_ALLOC:
 380                 return NT_STATUS_NO_MEMORY;
 381         case NDR_ERR_ARRAY_SIZE:
 382                 return NT_STATUS_ARRAY_BOUNDS_EXCEEDED;
 383         default:
 384                 break;
 385         }
 386
 387         /* we should all error codes to different status codes */
 388         return NT_STATUS_INVALID_PARAMETER;
 389 }
 390
 391 /*
 392   return and possibly log an NDR error
 393 */
 394 NTSTATUS ndr_pull_error(struct ndr_pull *ndr,
 395                         enum ndr_err_code err, const char *format, ...) _PRINTF_ATTRIBUTE(3,4)
 396 {
 397         char *s=NULL;
 398         va_list ap;
 399
 400         va_start(ap, format);
 401         vasprintf(&s, format, ap);
 402         va_end(ap);
 403
 404         DEBUG(3,("ndr_pull_error(%u): %s\n", err, s));
 405
 406         free(s);
 407
 408         return ndr_map_error(err);
 409 }
 410
 411 /*
 412   return and possibly log an NDR error
 413 */
 414 NTSTATUS ndr_push_error(struct ndr_push *ndr, enum ndr_err_code err, const char *format, ...)  _PRINTF_ATTRIBUTE(3,4)
 415 {
 416         char *s=NULL;
 417         va_list ap;
 418
 419         va_start(ap, format);
 420         vasprintf(&s, format, ap);
 421         va_end(ap);
 422
 423         DEBUG(3,("ndr_push_error(%u): %s\n", err, s));
 424
 425         free(s);
 426
 427         return ndr_map_error(err);
 428 }
 429
 430
 431 /*
 432   handle subcontext buffers, which in midl land are user-marshalled, but
 433   we use magic in pidl to make them easier to cope with
 434 */
 435 static NTSTATUS ndr_pull_subcontext_header(struct ndr_pull *ndr,
 436                                            size_t sub_size,
 437                                            struct ndr_pull *ndr2)
 438 {
 439         ndr2->flags = ndr->flags;
 440
 441         switch (sub_size) {
 442         case 0: {
 443                 uint32_t size = ndr->data_size - ndr->offset;
 444                 if (size == 0) return NT_STATUS_OK;
 445                 NDR_CHECK(ndr_pull_subcontext(ndr, ndr2, size));
 446                 break;
 447         }
 448
 449         case 2: {
 450                 uint16_t size;
 451                 NDR_CHECK(ndr_pull_uint16(ndr, &size));
 452                 if (size == 0) return NT_STATUS_OK;
 453                 NDR_CHECK(ndr_pull_subcontext(ndr, ndr2, size));
 454                 break;
 455         }
 456
 457         case 4: {
 458                 uint32_t size;
 459                 NDR_CHECK(ndr_pull_uint32(ndr, &size));
 460                 if (size == 0) return NT_STATUS_OK;
 461                 NDR_CHECK(ndr_pull_subcontext(ndr, ndr2, size));
 462                 break;
 463         }
 464         default:
 465                 return ndr_pull_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext size %d",
 466                                       sub_size);
 467         }
 468         return NT_STATUS_OK;
 469 }
 470
 471 /*
 472   handle subcontext buffers, which in midl land are user-marshalled, but
 473   we use magic in pidl to make them easier to cope with
 474 */
 475 NTSTATUS ndr_pull_subcontext_fn(struct ndr_pull *ndr, size_t sub_size,
 476                                 void *base, ndr_pull_fn_t fn)
 477 {
 478         struct ndr_pull *ndr2;
 479         NDR_ALLOC(ndr, ndr2);
 480         NDR_CHECK(ndr_pull_subcontext_header(ndr, sub_size, ndr2));
 481         NDR_CHECK(fn(ndr2, base));
 482         if (sub_size) {
 483                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->data_size));
 484         } else {
 485                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->offset));
 486         }
 487         return NT_STATUS_OK;
 488 }
 489
 490
 491 NTSTATUS ndr_pull_subcontext_flags_fn(struct ndr_pull *ndr, size_t sub_size,
 492                                       void *base, ndr_pull_flags_fn_t fn)
 493 {
 494         struct ndr_pull *ndr2;
 495         NDR_ALLOC(ndr, ndr2);
 496         NDR_CHECK(ndr_pull_subcontext_header(ndr, sub_size, ndr2));
 497         NDR_CHECK(fn(ndr2, NDR_SCALARS|NDR_BUFFERS, base));
 498         if (sub_size) {
 499                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->data_size));
 500         } else {
 501                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->offset));
 502         }
 503         return NT_STATUS_OK;
 504 }
 505
 506 NTSTATUS ndr_pull_subcontext_union_fn(struct ndr_pull *ndr, size_t sub_size,
 507                                       uint32_t level, void *base, ndr_pull_union_fn_t fn)
 508 {
 509         struct ndr_pull *ndr2;
 510
 511         NDR_ALLOC(ndr, ndr2);
 512         NDR_CHECK(ndr_pull_subcontext_header(ndr, sub_size, ndr2));
 513         NDR_CHECK(fn(ndr2, NDR_SCALARS|NDR_BUFFERS, level, base));
 514         if (sub_size) {
 515                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->data_size));
 516         } else {
 517                 NDR_CHECK(ndr_pull_advance(ndr, ndr2->offset));
 518         }
 519         return NT_STATUS_OK;
 520 }
 521
 522
 523 /*
 524   push a subcontext header
 525 */
 526 static NTSTATUS ndr_push_subcontext_header(struct ndr_push *ndr,
 527                                            size_t sub_size,
 528                                            struct ndr_push *ndr2)
 529 {
 530         switch (sub_size) {
 531         case 0:
 532                 break;
 533
 534         case 2:
 535                 NDR_CHECK(ndr_push_uint16(ndr, ndr2->offset));
 536                 break;
 537
 538         case 4:
 539                 NDR_CHECK(ndr_push_uint32(ndr, ndr2->offset));
 540                 break;
 541
 542         default:
 543                 return ndr_push_error(ndr, NDR_ERR_SUBCONTEXT, "Bad subcontext size %d",
 544                                       sub_size);
 545         }
 546         return NT_STATUS_OK;
 547 }
 548
 549 /*
 550   handle subcontext buffers, which in midl land are user-marshalled, but
 551   we use magic in pidl to make them easier to cope with
 552 */
 553 NTSTATUS ndr_push_subcontext_fn(struct ndr_push *ndr, size_t sub_size,
 554                                 void *base, ndr_push_fn_t fn)
 555 {
 556         struct ndr_push *ndr2;
 557
 558         ndr2 = ndr_push_init_ctx(ndr);
 559         if (!ndr2) return NT_STATUS_NO_MEMORY;
 560
 561         ndr2->flags = ndr->flags;
 562         NDR_CHECK(fn(ndr2, base));
 563         NDR_CHECK(ndr_push_subcontext_header(ndr, sub_size, ndr2));
 564         NDR_CHECK(ndr_push_bytes(ndr, ndr2->data, ndr2->offset));
 565         return NT_STATUS_OK;
 566 }
 567
 568 /*
 569   handle subcontext buffers for function that take a flags arg
 570 */
 571 NTSTATUS ndr_push_subcontext_flags_fn(struct ndr_push *ndr, size_t sub_size,
 572                                       void *base, ndr_push_flags_fn_t fn)
 573 {
 574         struct ndr_push *ndr2;
 575
 576         ndr2 = ndr_push_init_ctx(ndr);
 577         if (!ndr2) return NT_STATUS_NO_MEMORY;
 578
 579         ndr2->flags = ndr->flags;
 580         NDR_CHECK(fn(ndr2, NDR_SCALARS|NDR_BUFFERS, base));
 581         NDR_CHECK(ndr_push_subcontext_header(ndr, sub_size, ndr2));
 582         NDR_CHECK(ndr_push_bytes(ndr, ndr2->data, ndr2->offset));
 583         return NT_STATUS_OK;
 584 }
 585
 586 /*
 587   handle subcontext buffers for function that take a union
 588 */
 589 NTSTATUS ndr_push_subcontext_union_fn(struct ndr_push *ndr, size_t sub_size,
 590                                       uint32_t level, void *base, ndr_push_union_fn_t fn)
 591 {
 592         struct ndr_push *ndr2;
 593
 594         ndr2 = ndr_push_init_ctx(ndr);
 595         if (!ndr2) return NT_STATUS_NO_MEMORY;
 596
 597         ndr2->flags = ndr->flags;
 598         NDR_CHECK(fn(ndr2, NDR_SCALARS|NDR_BUFFERS, level, base));
 599         NDR_CHECK(ndr_push_subcontext_header(ndr, sub_size, ndr2));
 600         NDR_CHECK(ndr_push_bytes(ndr, ndr2->data, ndr2->offset));
 601         return NT_STATUS_OK;
 602 }
 603
 604
 605 /*
 606   mark the start of a structure
 607 */
 608 NTSTATUS ndr_pull_struct_start(struct ndr_pull *ndr)
 609 {
 610         return NT_STATUS_OK;
 611 }
 612
 613 /*
 614   mark the end of a structure
 615 */
 616 void ndr_pull_struct_end(struct ndr_pull *ndr)
 617 {
 618 }
 619
 620 /*
 621   mark the start of a structure
 622 */
 623 NTSTATUS ndr_push_struct_start(struct ndr_push *ndr)
 624 {
 625         return NT_STATUS_OK;
 626 }
 627
 628 /*
 629   mark the end of a structure
 630 */
 631 void ndr_push_struct_end(struct ndr_push *ndr)
 632 {
 633 }
 634
 635 /*
 636   store a token in the ndr context, for later retrieval
 637 */
 638 static NTSTATUS ndr_token_store(TALLOC_CTX *mem_ctx,
 639                                 struct ndr_token_list **list,
 640                                 const void *key,
 641                                 uint32_t value)
 642 {
 643         struct ndr_token_list *tok;
 644         tok = talloc(mem_ctx, struct ndr_token_list);
 645         if (tok == NULL) {
 646                 return NT_STATUS_NO_MEMORY;
 647         }
 648         tok->key = key;
 649         tok->value = value;
 650         DLIST_ADD((*list), tok);
 651         return NT_STATUS_OK;
 652 }
 653
 654 /*
 655   retrieve a token from a ndr context
 656 */
 657 static NTSTATUS ndr_token_retrieve(struct ndr_token_list **list, const void *key, uint32_t *v)
 658 {
 659         struct ndr_token_list *tok;
 660         for (tok=*list;tok;tok=tok->next) {
 661                 if (tok->key == key) {
 662                         DLIST_REMOVE((*list), tok);
 663                         *v = tok->value;
 664                         return NT_STATUS_OK;
 665                 }
 666         }
 667         return ndr_map_error(NDR_ERR_TOKEN);
 668 }
 669
 670 /*
 671   peek at but don't removed a token from a ndr context
 672 */
 673 static uint32_t ndr_token_peek(struct ndr_token_list **list, const void *key)
 674 {
 675         struct ndr_token_list *tok;
 676         for (tok=*list;tok;tok=tok->next) {
 677                 if (tok->key == key) {
 678                         return tok->value;
 679                 }
 680         }
 681         return 0;
 682 }
 683
 684 /*
 685   pull an array size field and add it to the array_size_list token list
 686 */
 687 NTSTATUS ndr_pull_array_size(struct ndr_pull *ndr, const void *p)
 688 {
 689         uint32_t size;
 690         NDR_CHECK(ndr_pull_uint32(ndr, &size));
 691         return ndr_token_store(ndr, &ndr->array_size_list, p, size);
 692 }
 693
 694 /*
 695   get the stored array size field
 696 */
 697 uint32_t ndr_get_array_size(struct ndr_pull *ndr, const void *p)
 698 {
 699         return ndr_token_peek(&ndr->array_size_list, p);
 700 }
 701
 702 /*
 703   check the stored array size field
 704 */
 705 NTSTATUS ndr_check_array_size(struct ndr_pull *ndr, void *p, uint32_t size)
 706 {
 707         uint32_t stored;
 708         NDR_CHECK(ndr_token_retrieve(&ndr->array_size_list, p, &stored));
 709         if (stored != size) {
 710                 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
 711                                       "Bad array size - got %u expected %u\n",
 712                                       stored, size);
 713         }
 714         return NT_STATUS_OK;
 715 }
 716
 717 /*
 718   pull an array length field and add it to the array_length_list token list
 719 */
 720 NTSTATUS ndr_pull_array_length(struct ndr_pull *ndr, const void *p)
 721 {
 722         uint32_t length, offset;
 723         NDR_CHECK(ndr_pull_uint32(ndr, &offset));
 724         if (offset != 0) {
 725                 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
 726                                       "non-zero array offset %u\n", offset);
 727         }
 728         NDR_CHECK(ndr_pull_uint32(ndr, &length));
 729         return ndr_token_store(ndr, &ndr->array_length_list, p, length);
 730 }
 731
 732 /*
 733   get the stored array length field
 734 */
 735 uint32_t ndr_get_array_length(struct ndr_pull *ndr, const void *p)
 736 {
 737         return ndr_token_peek(&ndr->array_length_list, p);
 738 }
 739
 740 /*
 741   check the stored array length field
 742 */
 743 NTSTATUS ndr_check_array_length(struct ndr_pull *ndr, void *p, uint32_t length)
 744 {
 745         uint32_t stored;
 746         NDR_CHECK(ndr_token_retrieve(&ndr->array_length_list, p, &stored));
 747         if (stored != length) {
 748                 return ndr_pull_error(ndr, NDR_ERR_ARRAY_SIZE,
 749                                       "Bad array length - got %u expected %u\n",
 750                                       stored, length);
 751         }
 752         return NT_STATUS_OK;
 753 }
 754
 755 /*
 756   pull a relative object - stage1
 757   called during SCALARS processing
 758 */
 759 NTSTATUS ndr_pull_relative1(struct ndr_pull *ndr, const void *p, uint32_t rel_offset)
 760 {
 761         if (ndr->flags & LIBNDR_FLAG_RELATIVE_CURRENT) {
 762                 return ndr_token_store(ndr, &ndr->relative_list, p,
 763                                        rel_offset + ndr->offset - 4);
 764         } else {
 765                 return ndr_token_store(ndr, &ndr->relative_list, p, rel_offset);
 766         }
 767 }
 768
 769 /*
 770   pull a relative object - stage2
 771   called during BUFFERS processing
 772 */
 773 NTSTATUS ndr_pull_relative2(struct ndr_pull *ndr, const void *p)
 774 {
 775         uint32_t rel_offset;
 776         NDR_CHECK(ndr_token_retrieve(&ndr->relative_list, p, &rel_offset));
 777         return ndr_pull_set_offset(ndr, rel_offset);
 778 }
 779
 780 /*
 781   push a relative object - stage1
 782   this is called during SCALARS processing
 783 */
 784 NTSTATUS ndr_push_relative1(struct ndr_push *ndr, const void *p)
 785 {
 786         if (p == NULL) {
 787                 NDR_CHECK(ndr_push_uint32(ndr, 0));
 788                 return NT_STATUS_OK;
 789         }
 790         NDR_CHECK(ndr_push_align(ndr, 4));
 791         NDR_CHECK(ndr_token_store(ndr, &ndr->relative_list, p, ndr->offset));
 792         return ndr_push_uint32(ndr, 0xFFFFFFFF);
 793 }
 794
 795 /*
 796   push a relative object - stage2
 797   this is called during buffers processing
 798 */
 799 NTSTATUS ndr_push_relative2(struct ndr_push *ndr, const void *p)
 800 {
 801         struct ndr_push_save save;
 802         if (p == NULL) {
 803                 return NT_STATUS_OK;
 804         }
 805         NDR_CHECK(ndr_push_align(ndr, 4));
 806         ndr_push_save(ndr, &save);
 807         NDR_CHECK(ndr_token_retrieve(&ndr->relative_list, p, &ndr->offset));
 808         if (ndr->flags & LIBNDR_FLAG_RELATIVE_CURRENT) {
 809                 NDR_CHECK(ndr_push_uint32(ndr, save.offset - ndr->offset));
 810         } else {
 811                 NDR_CHECK(ndr_push_uint32(ndr, save.offset));
 812         }
 813         ndr_push_restore(ndr, &save);
 814         return NT_STATUS_OK;
 815 }
 816
 817
 818 /*
 819   pull a union from a blob using NDR
 820 */
 821 NTSTATUS ndr_pull_union_blob(DATA_BLOB *blob, TALLOC_CTX *mem_ctx, uint32_t level, void *p,
 822                              ndr_pull_union_fn_t fn)
 823 {
 824         struct ndr_pull *ndr;
 825         ndr = ndr_pull_init_blob(blob, mem_ctx);
 826         if (!ndr) {
 827                 return NT_STATUS_NO_MEMORY;
 828         }
 829         return fn(ndr, NDR_SCALARS|NDR_BUFFERS, level, p);
 830 }
 831
 832 /*
 833   pull a struct from a blob using NDR
 834 */
 835 NTSTATUS ndr_pull_struct_blob(const DATA_BLOB *blob, TALLOC_CTX *mem_ctx, void *p,
 836                               ndr_pull_flags_fn_t fn)
 837 {
 838         struct ndr_pull *ndr;
 839         ndr = ndr_pull_init_blob(blob, mem_ctx);
 840         if (!ndr) {
 841                 return NT_STATUS_NO_MEMORY;
 842         }
 843         return fn(ndr, NDR_SCALARS|NDR_BUFFERS, p);
 844 }
 845
 846 /*
 847   push a struct to a blob using NDR
 848 */
 849 NTSTATUS ndr_push_struct_blob(DATA_BLOB *blob, TALLOC_CTX *mem_ctx, void *p,
 850                               ndr_push_flags_fn_t fn)
 851 {
 852         NTSTATUS status;
 853         struct ndr_push *ndr;
 854         ndr = ndr_push_init_ctx(mem_ctx);
 855         if (!ndr) {
 856                 return NT_STATUS_NO_MEMORY;
 857         }
 858         status = fn(ndr, NDR_SCALARS|NDR_BUFFERS, p);
 859         if (!NT_STATUS_IS_OK(status)) {
 860                 return status;
 861         }
 862
 863         *blob = ndr_push_blob(ndr);
 864
 865         return NT_STATUS_OK;
 866 }
 867
 868 /*
 869   generic ndr_size_*() handler for structures
 870 */
 871 size_t ndr_size_struct(const void *p, int flags, ndr_push_flags_fn_t push)
 872 {
 873         struct ndr_push *ndr;
 874         NTSTATUS status;
 875         size_t ret;
 876
 877         ndr = ndr_push_init_ctx(NULL);
 878         if (!ndr) return 0;
 879         ndr->flags |= flags;
 880         status = push(ndr, NDR_SCALARS|NDR_BUFFERS, discard_const(p));
 881         if (!NT_STATUS_IS_OK(status)) {
 882                 return 0;
 883         }
 884         ret = ndr->offset;
 885         talloc_free(ndr);
 886         return ret;
 887 }
 888
 889 /*
 890   generic ndr_size_*() handler for unions
 891 */
 892 size_t ndr_size_union(const void *p, int flags, uint32_t level, ndr_push_union_fn_t push)
 893 {
 894         struct ndr_push *ndr;
 895         NTSTATUS status;
 896         size_t ret;
 897
 898         ndr = ndr_push_init_ctx(NULL);
 899         if (!ndr) return 0;
 900         ndr->flags |= flags;
 901         status = push(ndr, NDR_SCALARS|NDR_BUFFERS, level, discard_const(p));
 902         if (!NT_STATUS_IS_OK(status)) {
 903                 return 0;
 904         }
 905         ret = ndr->offset;
 906         talloc_free(ndr);
 907         return ret;
 908 }