source4/lib/ldb/common/ldb_ldif.c

   1 /*
   2    ldb database library
   3
   4    Copyright (C) Andrew Tridgell  2004
   5
   6      ** NOTE! The following LGPL license applies to the ldb
   7      ** library. This does NOT imply that all of Samba is released
   8      ** under the LGPL
   9
  10    This library is free software; you can redistribute it and/or
  11    modify it under the terms of the GNU Lesser General Public
  12    License as published by the Free Software Foundation; either
  13    version 3 of the License, or (at your option) any later version.
  14
  15    This library 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 GNU
  18    Lesser General Public License for more details.
  19
  20    You should have received a copy of the GNU Lesser General Public
  21    License along with this library; if not, see <http://www.gnu.org/licenses/>.
  22 */
  23
  24 /*
  25  *  Name: ldb
  26  *
  27  *  Component: ldif routines
  28  *
  29  *  Description: ldif pack/unpack routines
  30  *
  31  *  Author: Andrew Tridgell
  32  */
  33
  34 /*
  35   see RFC2849 for the LDIF format definition
  36 */
  37
  38 #include "ldb_private.h"
  39 #include "system/locale.h"
  40
  41 /*
  42
  43 */
  44 static int ldb_read_data_file(void *mem_ctx, struct ldb_val *value)
  45 {
  46         struct stat statbuf;
  47         char *buf;
  48         int count, size, bytes;
  49         int ret;
  50         int f;
  51         const char *fname = (const char *)value->data;
  52
  53         if (strncmp(fname, "file://", 7) != 0) {
  54                 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
  55         }
  56         fname += 7;
  57
  58         f = open(fname, O_RDONLY);
  59         if (f == -1) {
  60                 return -1;
  61         }
  62
  63         if (fstat(f, &statbuf) != 0) {
  64                 ret = -1;
  65                 goto done;
  66         }
  67
  68         if (statbuf.st_size == 0) {
  69                 ret = -1;
  70                 goto done;
  71         }
  72
  73         value->data = (uint8_t *)talloc_size(mem_ctx, statbuf.st_size + 1);
  74         if (value->data == NULL) {
  75                 ret = -1;
  76                 goto done;
  77         }
  78         value->data[statbuf.st_size] = 0;
  79
  80         count = 0;
  81         size = statbuf.st_size;
  82         buf = (char *)value->data;
  83         while (count < statbuf.st_size) {
  84                 bytes = read(f, buf, size);
  85                 if (bytes == -1) {
  86                         talloc_free(value->data);
  87                         ret = -1;
  88                         goto done;
  89                 }
  90                 count += bytes;
  91                 buf += bytes;
  92                 size -= bytes;
  93         }
  94
  95         value->length = statbuf.st_size;
  96         ret = statbuf.st_size;
  97
  98 done:
  99         close(f);
 100         return ret;
 101 }
 102
 103 /*
 104   this base64 decoder was taken from jitterbug (written by tridge).
 105   we might need to replace it with a new version
 106 */
 107 int ldb_base64_decode(char *s)
 108 {
 109         const char *b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 110         int bit_offset=0, byte_offset, idx, i, n;
 111         uint8_t *d = (uint8_t *)s;
 112         char *p=NULL;
 113
 114         n=i=0;
 115
 116         while (*s && (p=strchr(b64,*s))) {
 117                 idx = (int)(p - b64);
 118                 byte_offset = (i*6)/8;
 119                 bit_offset = (i*6)%8;
 120                 d[byte_offset] &= ~((1<<(8-bit_offset))-1);
 121                 if (bit_offset < 3) {
 122                         d[byte_offset] |= (idx << (2-bit_offset));
 123                         n = byte_offset+1;
 124                 } else {
 125                         d[byte_offset] |= (idx >> (bit_offset-2));
 126                         d[byte_offset+1] = 0;
 127                         d[byte_offset+1] |= (idx << (8-(bit_offset-2))) & 0xFF;
 128                         n = byte_offset+2;
 129                 }
 130                 s++; i++;
 131         }
 132         if (bit_offset >= 3) {
 133                 n--;
 134         }
 135
 136         if (*s && !p) {
 137                 /* the only termination allowed */
 138                 if (*s != '=') {
 139                         return -1;
 140                 }
 141         }
 142
 143         /* null terminate */
 144         d[n] = 0;
 145         return n;
 146 }
 147
 148
 149 /*
 150   encode as base64
 151   caller frees
 152 */
 153 char *ldb_base64_encode(void *mem_ctx, const char *buf, int len)
 154 {
 155         const char *b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 156         int bit_offset, byte_offset, idx, i;
 157         const uint8_t *d = (const uint8_t *)buf;
 158         int bytes = (len*8 + 5)/6, pad_bytes = (bytes % 4) ? 4 - (bytes % 4) : 0;
 159         char *out;
 160
 161         out = talloc_array(mem_ctx, char, bytes+pad_bytes+1);
 162         if (!out) return NULL;
 163
 164         for (i=0;i<bytes;i++) {
 165                 byte_offset = (i*6)/8;
 166                 bit_offset = (i*6)%8;
 167                 if (bit_offset < 3) {
 168                         idx = (d[byte_offset] >> (2-bit_offset)) & 0x3F;
 169                 } else {
 170                         idx = (d[byte_offset] << (bit_offset-2)) & 0x3F;
 171                         if (byte_offset+1 < len) {
 172                                 idx |= (d[byte_offset+1] >> (8-(bit_offset-2)));
 173                         }
 174                 }
 175                 out[i] = b64[idx];
 176         }
 177
 178         for (;i<bytes+pad_bytes;i++)
 179                 out[i] = '=';
 180         out[i] = 0;
 181
 182         return out;
 183 }
 184
 185 /*
 186   see if a buffer should be base64 encoded
 187 */
 188 int ldb_should_b64_encode(struct ldb_context *ldb, const struct ldb_val *val)
 189 {
 190         unsigned int i;
 191         uint8_t *p = val->data;
 192
 193         if (ldb->flags & LDB_FLG_SHOW_BINARY) {
 194                 return 0;
 195         }
 196
 197         if (val->length == 0) {
 198                 return 0;
 199         }
 200
 201         if (p[0] == ' ' || p[0] == ':') {
 202                 return 1;
 203         }
 204
 205         for (i=0; i<val->length; i++) {
 206                 if (!isprint(p[i]) || p[i] == '\n') {
 207                         return 1;
 208                 }
 209         }
 210         return 0;
 211 }
 212
 213 /* this macro is used to handle the return checking on fprintf_fn() */
 214 #define CHECK_RET do { if (ret < 0) return ret; total += ret; } while (0)
 215
 216 /*
 217   write a line folded string onto a file
 218 */
 219 static int fold_string(int (*fprintf_fn)(void *, const char *, ...), void *private_data,
 220                         const char *buf, size_t length, int start_pos)
 221 {
 222         unsigned int i;
 223         int total=0, ret;
 224
 225         for (i=0;i<length;i++) {
 226                 ret = fprintf_fn(private_data, "%c", buf[i]);
 227                 CHECK_RET;
 228                 if (i != (length-1) && (i + start_pos) % 77 == 0) {
 229                         ret = fprintf_fn(private_data, "\n ");
 230                         CHECK_RET;
 231                 }
 232         }
 233
 234         return total;
 235 }
 236
 237 #undef CHECK_RET
 238
 239 /*
 240   encode as base64 to a file
 241 */
 242 static int base64_encode_f(struct ldb_context *ldb,
 243                            int (*fprintf_fn)(void *, const char *, ...),
 244                            void *private_data,
 245                            const char *buf, int len, int start_pos)
 246 {
 247         char *b = ldb_base64_encode(ldb, buf, len);
 248         int ret;
 249
 250         if (!b) {
 251                 return -1;
 252         }
 253
 254         ret = fold_string(fprintf_fn, private_data, b, strlen(b), start_pos);
 255
 256         talloc_free(b);
 257         return ret;
 258 }
 259
 260
 261 static const struct {
 262         const char *name;
 263         enum ldb_changetype changetype;
 264 } ldb_changetypes[] = {
 265         {"add",    LDB_CHANGETYPE_ADD},
 266         {"delete", LDB_CHANGETYPE_DELETE},
 267         {"modify", LDB_CHANGETYPE_MODIFY},
 268         {NULL, 0}
 269 };
 270
 271 /* this macro is used to handle the return checking on fprintf_fn() */
 272 #define CHECK_RET do { if (ret < 0) { talloc_free(mem_ctx); return ret; } total += ret; } while (0)
 273
 274 /*
 275   write to ldif, using a caller supplied write method
 276 */
 277 int ldb_ldif_write(struct ldb_context *ldb,
 278                    int (*fprintf_fn)(void *, const char *, ...),
 279                    void *private_data,
 280                    const struct ldb_ldif *ldif)
 281 {
 282         TALLOC_CTX *mem_ctx;
 283         unsigned int i, j;
 284         int total=0, ret;
 285         char *p;
 286         const struct ldb_message *msg;
 287
 288         mem_ctx = talloc_named_const(NULL, 0, "ldb_ldif_write");
 289
 290         msg = ldif->msg;
 291         p = ldb_dn_get_extended_linearized(mem_ctx, msg->dn, 1);
 292         ret = fprintf_fn(private_data, "dn: %s\n", p);
 293         talloc_free(p);
 294         CHECK_RET;
 295
 296         if (ldif->changetype != LDB_CHANGETYPE_NONE) {
 297                 for (i=0;ldb_changetypes[i].name;i++) {
 298                         if (ldb_changetypes[i].changetype == ldif->changetype) {
 299                                 break;
 300                         }
 301                 }
 302                 if (!ldb_changetypes[i].name) {
 303                         ldb_debug(ldb, LDB_DEBUG_ERROR, "Error: Invalid ldif changetype %d",
 304                                   ldif->changetype);
 305                         talloc_free(mem_ctx);
 306                         return -1;
 307                 }
 308                 ret = fprintf_fn(private_data, "changetype: %s\n", ldb_changetypes[i].name);
 309                 CHECK_RET;
 310         }
 311
 312         for (i=0;i<msg->num_elements;i++) {
 313                 const struct ldb_schema_attribute *a;
 314
 315                 a = ldb_schema_attribute_by_name(ldb, msg->elements[i].name);
 316
 317                 if (ldif->changetype == LDB_CHANGETYPE_MODIFY) {
 318                         switch (msg->elements[i].flags & LDB_FLAG_MOD_MASK) {
 319                         case LDB_FLAG_MOD_ADD:
 320                                 fprintf_fn(private_data, "add: %s\n",
 321                                            msg->elements[i].name);
 322                                 break;
 323                         case LDB_FLAG_MOD_DELETE:
 324                                 fprintf_fn(private_data, "delete: %s\n",
 325                                            msg->elements[i].name);
 326                                 break;
 327                         case LDB_FLAG_MOD_REPLACE:
 328                                 fprintf_fn(private_data, "replace: %s\n",
 329                                            msg->elements[i].name);
 330                                 break;
 331                         }
 332                 }
 333
 334                 for (j=0;j<msg->elements[i].num_values;j++) {
 335                         struct ldb_val v;
 336                         ret = a->syntax->ldif_write_fn(ldb, mem_ctx, &msg->elements[i].values[j], &v);
 337                         if (ret != LDB_SUCCESS) {
 338                                 v = msg->elements[i].values[j];
 339                         }
 340                         if (ret != LDB_SUCCESS || ldb_should_b64_encode(ldb, &v)) {
 341                                 ret = fprintf_fn(private_data, "%s:: ",
 342                                                  msg->elements[i].name);
 343                                 CHECK_RET;
 344                                 ret = base64_encode_f(ldb, fprintf_fn, private_data,
 345                                                       (char *)v.data, v.length,
 346                                                       strlen(msg->elements[i].name)+3);
 347                                 CHECK_RET;
 348                                 ret = fprintf_fn(private_data, "\n");
 349                                 CHECK_RET;
 350                         } else {
 351                                 ret = fprintf_fn(private_data, "%s: ", msg->elements[i].name);
 352                                 CHECK_RET;
 353                                 if (ldb->flags & LDB_FLG_SHOW_BINARY) {
 354                                         ret = fprintf_fn(private_data, "%*.*s",
 355                                                          v.length, v.length, (char *)v.data);
 356                                 } else {
 357                                         ret = fold_string(fprintf_fn, private_data,
 358                                                           (char *)v.data, v.length,
 359                                                           strlen(msg->elements[i].name)+2);
 360                                 }
 361                                 CHECK_RET;
 362                                 ret = fprintf_fn(private_data, "\n");
 363                                 CHECK_RET;
 364                         }
 365                         if (v.data != msg->elements[i].values[j].data) {
 366                                 talloc_free(v.data);
 367                         }
 368                 }
 369                 if (ldif->changetype == LDB_CHANGETYPE_MODIFY) {
 370                         fprintf_fn(private_data, "-\n");
 371                 }
 372         }
 373         ret = fprintf_fn(private_data,"\n");
 374         CHECK_RET;
 375
 376         talloc_free(mem_ctx);
 377
 378         return total;
 379 }
 380
 381 #undef CHECK_RET
 382
 383
 384 /*
 385   pull a ldif chunk, which is defined as a piece of data ending in \n\n or EOF
 386   this routine removes any RFC2849 continuations and comments
 387
 388   caller frees
 389 */
 390 static char *next_chunk(struct ldb_context *ldb,
 391                         int (*fgetc_fn)(void *), void *private_data)
 392 {
 393         size_t alloc_size=0, chunk_size = 0;
 394         char *chunk = NULL;
 395         int c;
 396         int in_comment = 0;
 397
 398         while ((c = fgetc_fn(private_data)) != EOF) {
 399                 if (chunk_size+1 >= alloc_size) {
 400                         char *c2;
 401                         alloc_size += 1024;
 402                         c2 = talloc_realloc(ldb, chunk, char, alloc_size);
 403                         if (!c2) {
 404                                 talloc_free(chunk);
 405                                 errno = ENOMEM;
 406                                 return NULL;
 407                         }
 408                         chunk = c2;
 409                 }
 410
 411                 if (in_comment) {
 412                         if (c == '\n') {
 413                                 in_comment = 0;
 414                         }
 415                         continue;
 416                 }
 417
 418                 /* handle continuation lines - see RFC2849 */
 419                 if (c == ' ' && chunk_size > 1 && chunk[chunk_size-1] == '\n') {
 420                         chunk_size--;
 421                         continue;
 422                 }
 423
 424                 /* chunks are terminated by a double line-feed */
 425                 if (c == '\n' && chunk_size > 0 && chunk[chunk_size-1] == '\n') {
 426                         chunk[chunk_size-1] = 0;
 427                         return chunk;
 428                 }
 429
 430                 if (c == '#' && (chunk_size == 0 || chunk[chunk_size-1] == '\n')) {
 431                         in_comment = 1;
 432                         continue;
 433                 }
 434
 435                 /* ignore leading blank lines */
 436                 if (chunk_size == 0 && c == '\n') {
 437                         continue;
 438                 }
 439
 440                 chunk[chunk_size++] = c;
 441         }
 442
 443         if (chunk) {
 444                 chunk[chunk_size] = 0;
 445         }
 446
 447         return chunk;
 448 }
 449
 450
 451 /* simple ldif attribute parser */
 452 static int next_attr(void *mem_ctx, char **s, const char **attr, struct ldb_val *value)
 453 {
 454         char *p;
 455         int base64_encoded = 0;
 456         int binary_file = 0;
 457
 458         if (strncmp(*s, "-\n", 2) == 0) {
 459                 value->length = 0;
 460                 *attr = "-";
 461                 *s += 2;
 462                 return 0;
 463         }
 464
 465         p = strchr(*s, ':');
 466         if (!p) {
 467                 return -1;
 468         }
 469
 470         *p++ = 0;
 471
 472         if (*p == ':') {
 473                 base64_encoded = 1;
 474                 p++;
 475         }
 476
 477         if (*p == '<') {
 478                 binary_file = 1;
 479                 p++;
 480         }
 481
 482         *attr = *s;
 483
 484         while (*p == ' ' || *p == '\t') {
 485                 p++;
 486         }
 487
 488         value->data = (uint8_t *)p;
 489
 490         p = strchr(p, '\n');
 491
 492         if (!p) {
 493                 value->length = strlen((char *)value->data);
 494                 *s = ((char *)value->data) + value->length;
 495         } else {
 496                 value->length = p - (char *)value->data;
 497                 *s = p+1;
 498                 *p = 0;
 499         }
 500
 501         if (base64_encoded) {
 502                 int len = ldb_base64_decode((char *)value->data);
 503                 if (len == -1) {
 504                         /* it wasn't valid base64 data */
 505                         return -1;
 506                 }
 507                 value->length = len;
 508         }
 509
 510         if (binary_file) {
 511                 int len = ldb_read_data_file(mem_ctx, value);
 512                 if (len == -1) {
 513                         /* an error occured hile trying to retrieve the file */
 514                         return -1;
 515                 }
 516         }
 517
 518         return 0;
 519 }
 520
 521
 522 /*
 523   free a message from a ldif_read
 524 */
 525 void ldb_ldif_read_free(struct ldb_context *ldb, struct ldb_ldif *ldif)
 526 {
 527         talloc_free(ldif);
 528 }
 529
 530 /*
 531  read from a LDIF source, creating a ldb_message
 532 */
 533 struct ldb_ldif *ldb_ldif_read(struct ldb_context *ldb,
 534                                int (*fgetc_fn)(void *), void *private_data)
 535 {
 536         struct ldb_ldif *ldif;
 537         struct ldb_message *msg;
 538         const char *attr=NULL;
 539         char *chunk=NULL, *s;
 540         struct ldb_val value;
 541         unsigned flags = 0;
 542
 543         value.data = NULL;
 544
 545         ldif = talloc(ldb, struct ldb_ldif);
 546         if (!ldif) return NULL;
 547
 548         ldif->msg = talloc(ldif, struct ldb_message);
 549         if (ldif->msg == NULL) {
 550                 talloc_free(ldif);
 551                 return NULL;
 552         }
 553
 554         ldif->changetype = LDB_CHANGETYPE_NONE;
 555         msg = ldif->msg;
 556
 557         msg->dn = NULL;
 558         msg->elements = NULL;
 559         msg->num_elements = 0;
 560
 561         chunk = next_chunk(ldb, fgetc_fn, private_data);
 562         if (!chunk) {
 563                 goto failed;
 564         }
 565         talloc_steal(ldif, chunk);
 566
 567         s = chunk;
 568
 569         if (next_attr(ldif, &s, &attr, &value) != 0) {
 570                 goto failed;
 571         }
 572
 573         /* first line must be a dn */
 574         if (ldb_attr_cmp(attr, "dn") != 0) {
 575                 ldb_debug(ldb, LDB_DEBUG_ERROR, "Error: First line of ldif must be a dn not '%s'",
 576                           attr);
 577                 goto failed;
 578         }
 579
 580         msg->dn = ldb_dn_from_ldb_val(msg, ldb, &value);
 581
 582         if ( ! ldb_dn_validate(msg->dn)) {
 583                 ldb_debug(ldb, LDB_DEBUG_ERROR, "Error: Unable to parse dn '%s'",
 584                           (char *)value.data);
 585                 goto failed;
 586         }
 587
 588         while (next_attr(ldif, &s, &attr, &value) == 0) {
 589                 const struct ldb_schema_attribute *a;
 590                 struct ldb_message_element *el;
 591                 int ret, empty = 0;
 592
 593                 if (ldb_attr_cmp(attr, "changetype") == 0) {
 594                         int i;
 595                         for (i=0;ldb_changetypes[i].name;i++) {
 596                                 if (ldb_attr_cmp((char *)value.data, ldb_changetypes[i].name) == 0) {
 597                                         ldif->changetype = ldb_changetypes[i].changetype;
 598                                         break;
 599                                 }
 600                         }
 601                         if (!ldb_changetypes[i].name) {
 602                                 ldb_debug(ldb, LDB_DEBUG_ERROR,
 603                                           "Error: Bad ldif changetype '%s'",(char *)value.data);
 604                         }
 605                         flags = 0;
 606                         continue;
 607                 }
 608
 609                 if (ldb_attr_cmp(attr, "add") == 0) {
 610                         flags = LDB_FLAG_MOD_ADD;
 611                         empty = 1;
 612                 }
 613                 if (ldb_attr_cmp(attr, "delete") == 0) {
 614                         flags = LDB_FLAG_MOD_DELETE;
 615                         empty = 1;
 616                 }
 617                 if (ldb_attr_cmp(attr, "replace") == 0) {
 618                         flags = LDB_FLAG_MOD_REPLACE;
 619                         empty = 1;
 620                 }
 621                 if (ldb_attr_cmp(attr, "-") == 0) {
 622                         flags = 0;
 623                         continue;
 624                 }
 625
 626                 if (empty) {
 627                         if (ldb_msg_add_empty(msg, (char *)value.data, flags, NULL) != 0) {
 628                                 goto failed;
 629                         }
 630                         continue;
 631                 }
 632
 633                 el = &msg->elements[msg->num_elements-1];
 634
 635                 a = ldb_schema_attribute_by_name(ldb, attr);
 636
 637                 if (msg->num_elements > 0 && ldb_attr_cmp(attr, el->name) == 0 &&
 638                     flags == el->flags) {
 639                         /* its a continuation */
 640                         el->values =
 641                                 talloc_realloc(msg->elements, el->values,
 642                                                  struct ldb_val, el->num_values+1);
 643                         if (!el->values) {
 644                                 goto failed;
 645                         }
 646                         ret = a->syntax->ldif_read_fn(ldb, el->values, &value, &el->values[el->num_values]);
 647                         if (ret != 0) {
 648                                 goto failed;
 649                         }
 650                         if (value.length == 0) {
 651                                 ldb_debug(ldb, LDB_DEBUG_ERROR,
 652                                           "Error: Attribute value cannot be empty for attribute '%s'", el->name);
 653                                 goto failed;
 654                         }
 655                         if (value.data != el->values[el->num_values].data) {
 656                                 talloc_steal(el->values, el->values[el->num_values].data);
 657                         }
 658                         el->num_values++;
 659                 } else {
 660                         /* its a new attribute */
 661                         msg->elements = talloc_realloc(msg, msg->elements,
 662                                                          struct ldb_message_element,
 663                                                          msg->num_elements+1);
 664                         if (!msg->elements) {
 665                                 goto failed;
 666                         }
 667                         el = &msg->elements[msg->num_elements];
 668                         el->flags = flags;
 669                         el->name = talloc_strdup(msg->elements, attr);
 670                         el->values = talloc(msg->elements, struct ldb_val);
 671                         if (!el->values || !el->name) {
 672                                 goto failed;
 673                         }
 674                         el->num_values = 1;
 675                         ret = a->syntax->ldif_read_fn(ldb, el->values, &value, &el->values[0]);
 676                         if (ret != 0) {
 677                                 goto failed;
 678                         }
 679                         if (value.data != el->values[0].data) {
 680                                 talloc_steal(el->values, el->values[0].data);
 681                         }
 682                         msg->num_elements++;
 683                 }
 684         }
 685
 686         return ldif;
 687
 688 failed:
 689         talloc_free(ldif);
 690         return NULL;
 691 }
 692
 693
 694
 695 /*
 696   a wrapper around ldif_read() for reading from FILE*
 697 */
 698 struct ldif_read_file_state {
 699         FILE *f;
 700 };
 701
 702 static int fgetc_file(void *private_data)
 703 {
 704         struct ldif_read_file_state *state =
 705                 (struct ldif_read_file_state *)private_data;
 706         return fgetc(state->f);
 707 }
 708
 709 struct ldb_ldif *ldb_ldif_read_file(struct ldb_context *ldb, FILE *f)
 710 {
 711         struct ldif_read_file_state state;
 712         state.f = f;
 713         return ldb_ldif_read(ldb, fgetc_file, &state);
 714 }
 715
 716
 717 /*
 718   a wrapper around ldif_read() for reading from const char*
 719 */
 720 struct ldif_read_string_state {
 721         const char *s;
 722 };
 723
 724 static int fgetc_string(void *private_data)
 725 {
 726         struct ldif_read_string_state *state =
 727                 (struct ldif_read_string_state *)private_data;
 728         if (state->s[0] != 0) {
 729                 return *state->s++;
 730         }
 731         return EOF;
 732 }
 733
 734 struct ldb_ldif *ldb_ldif_read_string(struct ldb_context *ldb, const char **s)
 735 {
 736         struct ldif_read_string_state state;
 737         struct ldb_ldif *ldif;
 738         state.s = *s;
 739         ldif = ldb_ldif_read(ldb, fgetc_string, &state);
 740         *s = state.s;
 741         return ldif;
 742 }
 743
 744
 745 /*
 746   wrapper around ldif_write() for a file
 747 */
 748 struct ldif_write_file_state {
 749         FILE *f;
 750 };
 751
 752 static int fprintf_file(void *private_data, const char *fmt, ...) PRINTF_ATTRIBUTE(2, 3);
 753
 754 static int fprintf_file(void *private_data, const char *fmt, ...)
 755 {
 756         struct ldif_write_file_state *state =
 757                 (struct ldif_write_file_state *)private_data;
 758         int ret;
 759         va_list ap;
 760
 761         va_start(ap, fmt);
 762         ret = vfprintf(state->f, fmt, ap);
 763         va_end(ap);
 764         return ret;
 765 }
 766
 767 int ldb_ldif_write_file(struct ldb_context *ldb, FILE *f, const struct ldb_ldif *ldif)
 768 {
 769         struct ldif_write_file_state state;
 770         state.f = f;
 771         return ldb_ldif_write(ldb, fprintf_file, &state, ldif);
 772 }
 773
 774 /*
 775   wrapper around ldif_write() for a string
 776 */
 777 struct ldif_write_string_state {
 778         char *string;
 779 };
 780
 781 static int ldif_printf_string(void *private_data, const char *fmt, ...) PRINTF_ATTRIBUTE(2, 3);
 782
 783 static int ldif_printf_string(void *private_data, const char *fmt, ...)
 784 {
 785         struct ldif_write_string_state *state =
 786                 (struct ldif_write_string_state *)private_data;
 787         va_list ap;
 788         size_t oldlen = talloc_get_size(state->string);
 789         va_start(ap, fmt);
 790
 791         state->string = talloc_vasprintf_append(state->string, fmt, ap);
 792         va_end(ap);
 793         if (!state->string) {
 794                 return -1;
 795         }
 796
 797         return talloc_get_size(state->string) - oldlen;
 798 }
 799
 800 char *ldb_ldif_write_string(struct ldb_context *ldb, TALLOC_CTX *mem_ctx,
 801                             const struct ldb_ldif *ldif)
 802 {
 803         struct ldif_write_string_state state;
 804         state.string = talloc_strdup(mem_ctx, "");
 805         if (!state.string) {
 806                 return NULL;
 807         }
 808         if (ldb_ldif_write(ldb, ldif_printf_string, &state, ldif) == -1) {
 809                 return NULL;
 810         }
 811         return state.string;
 812 }
 813
 814 /*
 815   convenient function to turn a ldb_message into a string. Useful for
 816   debugging
 817  */
 818 char *ldb_ldif_message_string(struct ldb_context *ldb, TALLOC_CTX *mem_ctx,
 819                               enum ldb_changetype changetype,
 820                               const struct ldb_message *msg)
 821 {
 822         struct ldb_ldif ldif;
 823
 824         ldif.changetype = changetype;
 825         ldif.msg = discard_const_p(struct ldb_message, msg);
 826
 827         return ldb_ldif_write_string(ldb, mem_ctx, &ldif);
 828 }