r9385: Remove unused functions
[kamenim/samba.git] / source4 / dsdb / samdb / samdb.c
1 /* 
2    Unix SMB/CIFS implementation.
3
4    interface functions for the sam database
5
6    Copyright (C) Andrew Tridgell 2004
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 #include "includes.h"
24 #include "librpc/gen_ndr/ndr_netlogon.h"
25 #include "librpc/gen_ndr/ndr_misc.h"
26 #include "lib/ldb/include/ldb.h"
27 #include "system/time.h"
28 #include "system/filesys.h"
29 #include "db_wrap.h"
30
31 /*
32   connect to the SAM database
33   return an opaque context pointer on success, or NULL on failure
34  */
35 struct ldb_context *samdb_connect(TALLOC_CTX *mem_ctx)
36 {
37         return ldb_wrap_connect(mem_ctx, lp_sam_url(), 0, NULL);
38 }
39
40 /*
41   search the sam for the specified attributes in a specific domain, filter on
42   objectSid being in domain_sid.
43 */
44 int samdb_search_domain(struct ldb_context *sam_ldb,
45                         TALLOC_CTX *mem_ctx, 
46                         const char *basedn,
47                         struct ldb_message ***res,
48                         const char * const *attrs,
49                         const struct dom_sid *domain_sid,
50                         const char *format, ...)  _PRINTF_ATTRIBUTE(7,8)
51 {
52         va_list ap;
53         int i, count;
54
55         va_start(ap, format);
56         count = gendb_search_v(sam_ldb, mem_ctx, basedn,
57                                res, attrs, format, ap);
58         va_end(ap);
59
60         i=0;
61
62         while (i<count) {
63                 struct dom_sid *entry_sid;
64
65                 entry_sid = samdb_result_dom_sid(mem_ctx, (*res)[i], "objectSid");
66
67                 if ((entry_sid == NULL) ||
68                     (!dom_sid_in_domain(domain_sid, entry_sid))) {
69                         /* Delete that entry from the result set */
70                         (*res)[i] = (*res)[count-1];
71                         count -= 1;
72                         talloc_free(entry_sid);
73                         continue;
74                 }
75                 talloc_free(entry_sid);
76                 i += 1;
77         }
78
79         return count;
80 }
81
82 /*
83   search the sam for a single string attribute in exactly 1 record
84 */
85 const char *samdb_search_string_v(struct ldb_context *sam_ldb,
86                                   TALLOC_CTX *mem_ctx,
87                                   const char *basedn,
88                                   const char *attr_name,
89                                   const char *format, va_list ap) _PRINTF_ATTRIBUTE(5,0)
90 {
91         int count;
92         const char *attrs[2] = { NULL, NULL };
93         struct ldb_message **res = NULL;
94
95         attrs[0] = attr_name;
96
97         count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
98         if (count > 1) {                
99                 DEBUG(1,("samdb: search for %s %s not single valued (count=%d)\n", 
100                          attr_name, format, count));
101         }
102         if (count != 1) {
103                 talloc_free(res);
104                 return NULL;
105         }
106
107         return samdb_result_string(res[0], attr_name, NULL);
108 }
109                                  
110
111 /*
112   search the sam for a single string attribute in exactly 1 record
113 */
114 const char *samdb_search_string(struct ldb_context *sam_ldb,
115                                 TALLOC_CTX *mem_ctx,
116                                 const char *basedn,
117                                 const char *attr_name,
118                                 const char *format, ...) _PRINTF_ATTRIBUTE(5,6)
119 {
120         va_list ap;
121         const char *str;
122
123         va_start(ap, format);
124         str = samdb_search_string_v(sam_ldb, mem_ctx, basedn, attr_name, format, ap);
125         va_end(ap);
126
127         return str;
128 }
129
130 /*
131   search the sam for a dom_sid attribute in exactly 1 record
132 */
133 struct dom_sid *samdb_search_dom_sid(struct ldb_context *sam_ldb,
134                                      TALLOC_CTX *mem_ctx,
135                                      const char *basedn,
136                                      const char *attr_name,
137                                      const char *format, ...) _PRINTF_ATTRIBUTE(5,6)
138 {
139         va_list ap;
140         int count;
141         struct ldb_message **res;
142         const char *attrs[2] = { NULL, NULL };
143         struct dom_sid *sid;
144
145         attrs[0] = attr_name;
146
147         va_start(ap, format);
148         count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
149         va_end(ap);
150         if (count > 1) {                
151                 DEBUG(1,("samdb: search for %s %s not single valued (count=%d)\n", 
152                          attr_name, format, count));
153         }
154         if (count != 1) {
155                 talloc_free(res);
156                 return NULL;
157         }
158         sid = samdb_result_dom_sid(mem_ctx, res[0], attr_name);
159         talloc_free(res);
160         return sid;     
161 }
162
163 /*
164   return the count of the number of records in the sam matching the query
165 */
166 int samdb_search_count(struct ldb_context *sam_ldb,
167                        TALLOC_CTX *mem_ctx,
168                        const char *basedn,
169                        const char *format, ...) _PRINTF_ATTRIBUTE(4,5)
170 {
171         va_list ap;
172         struct ldb_message **res;
173         const char * const attrs[] = { NULL };
174         int ret;
175
176         va_start(ap, format);
177         ret = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
178         va_end(ap);
179
180         return ret;
181 }
182
183
184 /*
185   search the sam for a single integer attribute in exactly 1 record
186 */
187 uint_t samdb_search_uint(struct ldb_context *sam_ldb,
188                          TALLOC_CTX *mem_ctx,
189                          uint_t default_value,
190                          const char *basedn,
191                          const char *attr_name,
192                          const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
193 {
194         va_list ap;
195         int count;
196         struct ldb_message **res;
197         const char *attrs[2] = { NULL, NULL };
198
199         attrs[0] = attr_name;
200
201         va_start(ap, format);
202         count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
203         va_end(ap);
204
205         if (count != 1) {
206                 return default_value;
207         }
208
209         return samdb_result_uint(res[0], attr_name, default_value);
210 }
211
212 /*
213   search the sam for a single signed 64 bit integer attribute in exactly 1 record
214 */
215 int64_t samdb_search_int64(struct ldb_context *sam_ldb,
216                            TALLOC_CTX *mem_ctx,
217                            int64_t default_value,
218                            const char *basedn,
219                            const char *attr_name,
220                            const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
221 {
222         va_list ap;
223         int count;
224         struct ldb_message **res;
225         const char *attrs[2] = { NULL, NULL };
226
227         attrs[0] = attr_name;
228
229         va_start(ap, format);
230         count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
231         va_end(ap);
232
233         if (count != 1) {
234                 return default_value;
235         }
236
237         return samdb_result_int64(res[0], attr_name, default_value);
238 }
239
240 /*
241   search the sam for multipe records each giving a single string attribute
242   return the number of matches, or -1 on error
243 */
244 int samdb_search_string_multiple(struct ldb_context *sam_ldb,
245                                  TALLOC_CTX *mem_ctx,
246                                  const char *basedn,
247                                  const char ***strs,
248                                  const char *attr_name,
249                                  const char *format, ...) _PRINTF_ATTRIBUTE(6,7)
250 {
251         va_list ap;
252         int count, i;
253         const char *attrs[2] = { NULL, NULL };
254         struct ldb_message **res = NULL;
255
256         attrs[0] = attr_name;
257
258         va_start(ap, format);
259         count = gendb_search_v(sam_ldb, mem_ctx, basedn, &res, attrs, format, ap);
260         va_end(ap);
261
262         if (count <= 0) {
263                 return count;
264         }
265
266         /* make sure its single valued */
267         for (i=0;i<count;i++) {
268                 if (res[i]->num_elements != 1) {
269                         DEBUG(1,("samdb: search for %s %s not single valued\n", 
270                                  attr_name, format));
271                         talloc_free(res);
272                         return -1;
273                 }
274         }
275
276         *strs = talloc_array(mem_ctx, const char *, count+1);
277         if (! *strs) {
278                 talloc_free(res);
279                 return -1;
280         }
281
282         for (i=0;i<count;i++) {
283                 (*strs)[i] = samdb_result_string(res[i], attr_name, NULL);
284         }
285         (*strs)[count] = NULL;
286
287         return count;
288 }
289
290 /*
291   pull a uint from a result set. 
292 */
293 uint_t samdb_result_uint(struct ldb_message *msg, const char *attr, uint_t default_value)
294 {
295         return ldb_msg_find_uint(msg, attr, default_value);
296 }
297
298 /*
299   pull a (signed) int64 from a result set. 
300 */
301 int64_t samdb_result_int64(struct ldb_message *msg, const char *attr, int64_t default_value)
302 {
303         return ldb_msg_find_int64(msg, attr, default_value);
304 }
305
306 /*
307   pull a string from a result set. 
308 */
309 const char *samdb_result_string(struct ldb_message *msg, const char *attr, 
310                                 const char *default_value)
311 {
312         return ldb_msg_find_string(msg, attr, default_value);
313 }
314
315 /*
316   pull a rid from a objectSid in a result set. 
317 */
318 uint32_t samdb_result_rid_from_sid(TALLOC_CTX *mem_ctx, struct ldb_message *msg, 
319                                    const char *attr, uint32_t default_value)
320 {
321         struct dom_sid *sid;
322         uint32_t rid;
323
324         sid = samdb_result_dom_sid(mem_ctx, msg, attr);
325         if (sid == NULL) {
326                 return default_value;
327         }
328         rid = sid->sub_auths[sid->num_auths-1];
329         talloc_free(sid);
330         return rid;
331 }
332
333 /*
334   pull a dom_sid structure from a objectSid in a result set. 
335 */
336 struct dom_sid *samdb_result_dom_sid(TALLOC_CTX *mem_ctx, struct ldb_message *msg, 
337                                      const char *attr)
338 {
339         const struct ldb_val *v;
340         struct dom_sid *sid;
341         NTSTATUS status;
342         v = ldb_msg_find_ldb_val(msg, attr);
343         if (v == NULL) {
344                 return NULL;
345         }
346         sid = talloc(mem_ctx, struct dom_sid);
347         if (sid == NULL) {
348                 return NULL;
349         }
350         status = ndr_pull_struct_blob(v, sid, sid, 
351                                       (ndr_pull_flags_fn_t)ndr_pull_dom_sid);
352         if (!NT_STATUS_IS_OK(status)) {
353                 talloc_free(sid);
354                 return NULL;
355         }
356         return sid;
357 }
358
359 /*
360   pull a guid structure from a objectGUID in a result set. 
361 */
362 struct GUID samdb_result_guid(struct ldb_message *msg, const char *attr)
363 {
364         const struct ldb_val *v;
365         NTSTATUS status;
366         struct GUID guid;
367         TALLOC_CTX *mem_ctx;
368
369         ZERO_STRUCT(guid);
370
371         v = ldb_msg_find_ldb_val(msg, attr);
372         if (!v) return guid;
373
374         mem_ctx = talloc_named_const(NULL, 0, "samdb_result_guid");
375         if (!mem_ctx) return guid;
376         status = ndr_pull_struct_blob(v, mem_ctx, &guid, 
377                                       (ndr_pull_flags_fn_t)ndr_pull_GUID);
378         talloc_free(mem_ctx);
379         if (!NT_STATUS_IS_OK(status)) {
380                 return guid;
381         }
382
383         return guid;
384 }
385
386 /*
387   pull a sid prefix from a objectSid in a result set. 
388   this is used to find the domain sid for a user
389 */
390 struct dom_sid *samdb_result_sid_prefix(TALLOC_CTX *mem_ctx, struct ldb_message *msg, 
391                                         const char *attr)
392 {
393         struct dom_sid *sid = samdb_result_dom_sid(mem_ctx, msg, attr);
394         if (!sid || sid->num_auths < 1) return NULL;
395         sid->num_auths--;
396         return sid;
397 }
398
399 /*
400   pull a NTTIME in a result set. 
401 */
402 NTTIME samdb_result_nttime(struct ldb_message *msg, const char *attr, NTTIME default_value)
403 {
404         const char *str = ldb_msg_find_string(msg, attr, NULL);
405         if (!str) return default_value;
406         return nttime_from_string(str);
407 }
408
409 /*
410   pull a uint64_t from a result set. 
411 */
412 uint64_t samdb_result_uint64(struct ldb_message *msg, const char *attr, uint64_t default_value)
413 {
414         return ldb_msg_find_uint64(msg, attr, default_value);
415 }
416
417
418 /*
419   construct the allow_password_change field from the PwdLastSet attribute and the 
420   domain password settings
421 */
422 NTTIME samdb_result_allow_password_change(struct ldb_context *sam_ldb, 
423                                           TALLOC_CTX *mem_ctx, 
424                                           const char *domain_dn, 
425                                           struct ldb_message *msg, 
426                                           const char *attr)
427 {
428         uint64_t attr_time = samdb_result_uint64(msg, attr, 0);
429         int64_t minPwdAge;
430
431         if (attr_time == 0) {
432                 return 0;
433         }
434
435         minPwdAge = samdb_search_int64(sam_ldb, mem_ctx, 0,
436                                        domain_dn, "minPwdAge", "dn=%s", domain_dn);
437
438         /* yes, this is a -= not a += as minPwdAge is stored as the negative
439            of the number of 100-nano-seconds */
440         attr_time -= minPwdAge;
441
442         return attr_time;
443 }
444
445 /*
446   construct the force_password_change field from the PwdLastSet attribute and the 
447   domain password settings
448 */
449 NTTIME samdb_result_force_password_change(struct ldb_context *sam_ldb, 
450                                           TALLOC_CTX *mem_ctx, 
451                                           const char *domain_dn, 
452                                           struct ldb_message *msg, 
453                                           const char *attr)
454 {
455         uint64_t attr_time = samdb_result_uint64(msg, attr, 0);
456         int64_t maxPwdAge;
457
458         if (attr_time == 0) {
459                 return 0;
460         }
461
462         maxPwdAge = samdb_search_int64(sam_ldb, mem_ctx, 0, domain_dn, 
463                                        "maxPwdAge", "dn=%s", domain_dn);
464         if (maxPwdAge == 0) {
465                 return 0;
466         } else {
467                 attr_time -= maxPwdAge;
468         }
469
470         return attr_time;
471 }
472
473 /*
474   pull a samr_Password structutre from a result set. 
475 */
476 struct samr_Password samdb_result_hash(struct ldb_message *msg, const char *attr)
477 {
478         struct samr_Password hash;
479         const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
480         ZERO_STRUCT(hash);
481         if (val) {
482                 memcpy(hash.hash, val->data, MIN(val->length, sizeof(hash.hash)));
483         }
484         return hash;
485 }
486
487 /*
488   pull an array of samr_Password structutres from a result set. 
489 */
490 uint_t samdb_result_hashes(TALLOC_CTX *mem_ctx, struct ldb_message *msg, 
491                            const char *attr, struct samr_Password **hashes)
492 {
493         uint_t count = 0;
494         const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
495         int i;
496
497         *hashes = NULL;
498         if (!val) {
499                 return 0;
500         }
501         count = val->length / 16;
502         if (count == 0) {
503                 return 0;
504         }
505
506         *hashes = talloc_array(mem_ctx, struct samr_Password, count);
507         if (! *hashes) {
508                 return 0;
509         }
510
511         for (i=0;i<count;i++) {
512                 memcpy((*hashes)[i].hash, (i*16)+(char *)val->data, 16);
513         }
514
515         return count;
516 }
517
518 NTSTATUS samdb_result_passwords(TALLOC_CTX *mem_ctx, struct ldb_message *msg, 
519                                 struct samr_Password **lm_pwd, struct samr_Password **nt_pwd) 
520 {
521
522         const char *unicodePwd = samdb_result_string(msg, "unicodePwd", NULL);
523         
524         struct samr_Password *lmPwdHash, *ntPwdHash;
525         if (unicodePwd) {
526                 if (nt_pwd) {
527                         ntPwdHash = talloc(mem_ctx, struct samr_Password);
528                         if (!ntPwdHash) {
529                                 return NT_STATUS_NO_MEMORY;
530                         }
531                         
532                         E_md4hash(unicodePwd, ntPwdHash->hash);
533                         *nt_pwd = ntPwdHash;
534                 }
535
536                 if (lm_pwd) {
537                         BOOL lm_hash_ok;
538                 
539                         lmPwdHash = talloc(mem_ctx, struct samr_Password);
540                         if (!lmPwdHash) {
541                                 return NT_STATUS_NO_MEMORY;
542                         }
543                         
544                         /* compute the new nt and lm hashes */
545                         lm_hash_ok = E_deshash(unicodePwd, lmPwdHash->hash);
546                         
547                         if (lm_hash_ok) {
548                                 *lm_pwd = lmPwdHash;
549                         } else {
550                                 *lm_pwd = NULL;
551                         }
552                 }
553         } else {
554                 if (nt_pwd) {
555                         int num_nt;
556                         num_nt = samdb_result_hashes(mem_ctx, msg, "ntPwdHash", &ntPwdHash);
557                         if (num_nt == 0) {
558                                 *nt_pwd = NULL;
559                         } else if (num_nt > 1) {
560                                 return NT_STATUS_INTERNAL_DB_CORRUPTION;
561                         } else {
562                                 *nt_pwd = &ntPwdHash[0];
563                         }
564                 }
565                 if (lm_pwd) {
566                         int num_lm;
567                         num_lm = samdb_result_hashes(mem_ctx, msg, "lmPwdHash", &lmPwdHash);
568                         if (num_lm == 0) {
569                                 *lm_pwd = NULL;
570                         } else if (num_lm > 1) {
571                                 return NT_STATUS_INTERNAL_DB_CORRUPTION;
572                         } else {
573                                 *lm_pwd = &lmPwdHash[0];
574                         }
575                 }
576                 
577         }
578         return NT_STATUS_OK;
579 }
580
581 /*
582   pull a samr_LogonHours structutre from a result set. 
583 */
584 struct samr_LogonHours samdb_result_logon_hours(TALLOC_CTX *mem_ctx, struct ldb_message *msg, const char *attr)
585 {
586         struct samr_LogonHours hours;
587         const int units_per_week = 168;
588         const struct ldb_val *val = ldb_msg_find_ldb_val(msg, attr);
589         ZERO_STRUCT(hours);
590         hours.bits = talloc_array(mem_ctx, uint8_t, units_per_week);
591         if (!hours.bits) {
592                 return hours;
593         }
594         hours.units_per_week = units_per_week;
595         memset(hours.bits, 0xFF, units_per_week);
596         if (val) {
597                 memcpy(hours.bits, val->data, MIN(val->length, units_per_week));
598         }
599         return hours;
600 }
601
602 /*
603   pull a set of account_flags from a result set. 
604 */
605 uint16_t samdb_result_acct_flags(struct ldb_message *msg, const char *attr)
606 {
607         uint_t userAccountControl = ldb_msg_find_uint(msg, attr, 0);
608         return samdb_uf2acb(userAccountControl);
609 }
610
611 /*
612   copy from a template record to a message
613 */
614 int samdb_copy_template(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, 
615                         struct ldb_message *msg, const char *expression)
616 {
617         struct ldb_message **res, *t;
618         int ret, i, j;
619         
620
621         /* pull the template record */
622         ret = gendb_search(sam_ldb, mem_ctx, NULL, &res, NULL, "%s", expression);
623         if (ret != 1) {
624                 DEBUG(1,("samdb: ERROR: template '%s' matched %d records\n", 
625                          expression, ret));
626                 return -1;
627         }
628         t = res[0];
629
630         for (i=0;i<t->num_elements;i++) {
631                 struct ldb_message_element *el = &t->elements[i];
632                 /* some elements should not be copied from the template */
633                 if (strcasecmp(el->name, "cn") == 0 ||
634                     strcasecmp(el->name, "name") == 0 ||
635                     strcasecmp(el->name, "sAMAccountName") == 0) {
636                         continue;
637                 }
638                 for (j=0;j<el->num_values;j++) {
639                         if (strcasecmp(el->name, "objectClass") == 0 &&
640                             (strcasecmp((char *)el->values[j].data, "Template") == 0 ||
641                              strcasecmp((char *)el->values[j].data, "userTemplate") == 0 ||
642                              strcasecmp((char *)el->values[j].data, "groupTemplate") == 0 ||
643                              strcasecmp((char *)el->values[j].data, "foreignSecurityTemplate") == 0 ||
644                              strcasecmp((char *)el->values[j].data, "aliasTemplate") == 0 || 
645                              strcasecmp((char *)el->values[j].data, "trustedDomainTemplate") == 0 || 
646                              strcasecmp((char *)el->values[j].data, "secretTemplate") == 0)) {
647                                 continue;
648                         }
649                         samdb_msg_add_string(sam_ldb, mem_ctx, msg, el->name, 
650                                              (char *)el->values[j].data);
651                 }
652         }
653
654         return 0;
655 }
656
657
658 /*
659   add a string element to a message
660 */
661 int samdb_msg_add_string(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
662                          const char *attr_name, const char *str)
663 {
664         char *s = talloc_strdup(mem_ctx, str);
665         char *a = talloc_strdup(mem_ctx, attr_name);
666         if (s == NULL || a == NULL) {
667                 return -1;
668         }
669         return ldb_msg_add_string(sam_ldb, msg, a, s);
670 }
671
672 /*
673   add a dom_sid element to a message
674 */
675 int samdb_msg_add_dom_sid(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
676                          const char *attr_name, struct dom_sid *sid)
677 {
678         struct ldb_val v;
679         NTSTATUS status;
680         status = ndr_push_struct_blob(&v, mem_ctx, sid, 
681                                       (ndr_push_flags_fn_t)ndr_push_dom_sid);
682         if (!NT_STATUS_IS_OK(status)) {
683                 return -1;
684         }
685         return ldb_msg_add_value(sam_ldb, msg, attr_name, &v);
686 }
687
688
689 /*
690   add a delete element operation to a message
691 */
692 int samdb_msg_add_delete(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
693                          const char *attr_name)
694 {
695         char *a = talloc_strdup(mem_ctx, attr_name);
696         if (a == NULL) {
697                 return -1;
698         }
699         /* we use an empty replace rather than a delete, as it allows for 
700            samdb_replace() to be used everywhere */
701         return ldb_msg_add_empty(sam_ldb, msg, a, LDB_FLAG_MOD_REPLACE);
702 }
703
704 /*
705   add a add attribute value to a message
706 */
707 int samdb_msg_add_addval(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
708                          const char *attr_name, const char *value)
709 {
710         struct ldb_message_element *el;
711         char *a, *v;
712         int ret;
713         a = talloc_strdup(mem_ctx, attr_name);
714         if (a == NULL)
715                 return -1;
716         v = talloc_strdup(mem_ctx, value);
717         if (v == NULL)
718                 return -1;
719         ret = ldb_msg_add_string(sam_ldb, msg, a, v);
720         if (ret != 0)
721                 return ret;
722         el = ldb_msg_find_element(msg, a);
723         if (el == NULL)
724                 return -1;
725         el->flags = LDB_FLAG_MOD_ADD;
726         return 0;
727 }
728
729 /*
730   add a delete attribute value to a message
731 */
732 int samdb_msg_add_delval(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
733                          const char *attr_name, const char *value)
734 {
735         struct ldb_message_element *el;
736         char *a, *v;
737         int ret;
738         a = talloc_strdup(mem_ctx, attr_name);
739         if (a == NULL)
740                 return -1;
741         v = talloc_strdup(mem_ctx, value);
742         if (v == NULL)
743                 return -1;
744         ret = ldb_msg_add_string(sam_ldb, msg, a, v);
745         if (ret != 0)
746                 return ret;
747         el = ldb_msg_find_element(msg, a);
748         if (el == NULL)
749                 return -1;
750         el->flags = LDB_FLAG_MOD_DELETE;
751         return 0;
752 }
753
754 /*
755   add a uint_t element to a message
756 */
757 int samdb_msg_add_uint(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
758                        const char *attr_name, uint_t v)
759 {
760         const char *s = talloc_asprintf(mem_ctx, "%u", v);
761         return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
762 }
763
764 /*
765   add a (signed) int64_t element to a message
766 */
767 int samdb_msg_add_int64(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
768                         const char *attr_name, int64_t v)
769 {
770         const char *s = talloc_asprintf(mem_ctx, "%lld", v);
771         return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
772 }
773
774 /*
775   add a uint64_t element to a message
776 */
777 int samdb_msg_add_uint64(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
778                         const char *attr_name, uint64_t v)
779 {
780         const char *s = talloc_asprintf(mem_ctx, "%llu", v);
781         return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, s);
782 }
783
784 /*
785   add a samr_Password element to a message
786 */
787 int samdb_msg_add_hash(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
788                        const char *attr_name, struct samr_Password *hash)
789 {
790         struct ldb_val val;
791         val.data = talloc_memdup(mem_ctx, hash->hash, 16);
792         if (!val.data) {
793                 return -1;
794         }
795         val.length = 16;
796         return ldb_msg_add_value(sam_ldb, msg, attr_name, &val);
797 }
798
799 /*
800   add a samr_Password array to a message
801 */
802 int samdb_msg_add_hashes(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
803                          const char *attr_name, struct samr_Password *hashes, uint_t count)
804 {
805         struct ldb_val val;
806         int i;
807         val.data = talloc_array_size(mem_ctx, 16, count);
808         val.length = count*16;
809         if (!val.data) {
810                 return -1;
811         }
812         for (i=0;i<count;i++) {
813                 memcpy(i*16 + (char *)val.data, hashes[i].hash, 16);
814         }
815         return ldb_msg_add_value(sam_ldb, msg, attr_name, &val);
816 }
817
818 /*
819   add a acct_flags element to a message
820 */
821 int samdb_msg_add_acct_flags(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
822                              const char *attr_name, uint32_t v)
823 {
824         return samdb_msg_add_uint(sam_ldb, mem_ctx, msg, attr_name, samdb_acb2uf(v));
825 }
826
827 /*
828   add a logon_hours element to a message
829 */
830 int samdb_msg_add_logon_hours(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
831                               const char *attr_name, struct samr_LogonHours *hours)
832 {
833         struct ldb_val val;
834         val.length = hours->units_per_week / 8;
835         val.data = hours->bits;
836         return ldb_msg_add_value(sam_ldb, msg, attr_name, &val);
837 }
838
839 /*
840   add a general value element to a message
841 */
842 int samdb_msg_add_value(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
843                               const char *attr_name, const struct ldb_val *val)
844 {
845         return ldb_msg_add_value(sam_ldb, msg, attr_name, val);
846 }
847
848 /*
849   sets a general value element to a message
850 */
851 int samdb_msg_set_value(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
852                         const char *attr_name, const struct ldb_val *val)
853 {
854         struct ldb_message_element *el;
855
856         el = ldb_msg_find_element(msg, attr_name);
857         if (el) {
858                 el->num_values = 0;
859         }
860         return ldb_msg_add_value(sam_ldb, msg, attr_name, val);
861 }
862
863 /*
864   set a string element in a message
865 */
866 int samdb_msg_set_string(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
867                          const char *attr_name, const char *str)
868 {
869         struct ldb_message_element *el;
870
871         el = ldb_msg_find_element(msg, attr_name);
872         if (el) {
873                 el->num_values = 0;
874         }
875         return samdb_msg_add_string(sam_ldb, mem_ctx, msg, attr_name, str);
876 }
877
878 /*
879   set a ldaptime element in a message
880 */
881 int samdb_msg_set_ldaptime(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg,
882                            const char *attr_name, time_t t)
883 {
884         char *str = ldap_timestring(mem_ctx, t);
885         if (!str) {
886                 return -1;
887         }
888         return samdb_msg_set_string(sam_ldb, mem_ctx, msg, attr_name, str);
889 }
890
891 /*
892   add a record
893 */
894 int samdb_add(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
895 {
896         return ldb_add(sam_ldb, msg);
897 }
898
899 /*
900   delete a record
901 */
902 int samdb_delete(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, const char *dn)
903 {
904         return ldb_delete(sam_ldb, dn);
905 }
906
907 /*
908   modify a record
909 */
910 int samdb_modify(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
911 {
912         return ldb_modify(sam_ldb, msg);
913 }
914
915 /*
916   replace elements in a record
917 */
918 int samdb_replace(struct ldb_context *sam_ldb, TALLOC_CTX *mem_ctx, struct ldb_message *msg)
919 {
920         int i;
921
922         /* mark all the message elements as LDB_FLAG_MOD_REPLACE */
923         for (i=0;i<msg->num_elements;i++) {
924                 msg->elements[i].flags = LDB_FLAG_MOD_REPLACE;
925         }
926
927         /* modify the samdb record */
928         return samdb_modify(sam_ldb, mem_ctx, msg);
929 }
930
931 /*
932   return a default security descriptor
933 */
934 struct security_descriptor *samdb_default_security_descriptor(TALLOC_CTX *mem_ctx)
935 {
936         struct security_descriptor *sd;
937
938         sd = security_descriptor_initialise(mem_ctx);
939
940         return sd;
941 }