doc: Remove latex to doxygen conversion leftovers in talloc.
[Samba/gbeck.git] / lib / tdr / tdr.c
blob616cc987a932d35fd56896f827b0ad171c257f1b
1 /*
2 Unix SMB/CIFS implementation.
4 TDR (Trivial Data Representation) helper functions
5 Based loosely on ndr.c by Andrew Tridgell.
7 Copyright (C) Jelmer Vernooij 2005
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>.
23 #include "includes.h"
24 #include "system/filesys.h"
25 #include "system/network.h"
26 #include "lib/tdr/tdr.h"
28 #define TDR_BASE_MARSHALL_SIZE 1024
30 #define TDR_PUSH_NEED_BYTES(tdr, n) TDR_CHECK(tdr_push_expand(tdr, tdr->data.length+(n)))
32 #define TDR_PULL_NEED_BYTES(tdr, n) do { \
33 if ((n) > tdr->data.length || tdr->offset + (n) > tdr->data.length) { \
34 return NT_STATUS_BUFFER_TOO_SMALL; \
35 } \
36 } while(0)
38 #define TDR_BE(tdr) ((tdr)->flags & TDR_BIG_ENDIAN)
40 #define TDR_CVAL(tdr, ofs) CVAL(tdr->data.data,ofs)
41 #define TDR_SVAL(tdr, ofs) (TDR_BE(tdr)?RSVAL(tdr->data.data,ofs):SVAL(tdr->data.data,ofs))
42 #define TDR_IVAL(tdr, ofs) (TDR_BE(tdr)?RIVAL(tdr->data.data,ofs):IVAL(tdr->data.data,ofs))
43 #define TDR_SCVAL(tdr, ofs, v) SCVAL(tdr->data.data,ofs,v)
44 #define TDR_SSVAL(tdr, ofs, v) do { if (TDR_BE(tdr)) { RSSVAL(tdr->data.data,ofs,v); } else SSVAL(tdr->data.data,ofs,v); } while (0)
45 #define TDR_SIVAL(tdr, ofs, v) do { if (TDR_BE(tdr)) { RSIVAL(tdr->data.data,ofs,v); } else SIVAL(tdr->data.data,ofs,v); } while (0)
47 /**
48 expand the available space in the buffer to 'size'
50 NTSTATUS tdr_push_expand(struct tdr_push *tdr, uint32_t size)
52 if (talloc_get_size(tdr->data.data) >= size) {
53 return NT_STATUS_OK;
56 tdr->data.data = talloc_realloc(tdr, tdr->data.data, uint8_t, tdr->data.length + TDR_BASE_MARSHALL_SIZE);
58 if (tdr->data.data == NULL)
59 return NT_STATUS_NO_MEMORY;
61 return NT_STATUS_OK;
65 NTSTATUS tdr_pull_uint8(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint8_t *v)
67 TDR_PULL_NEED_BYTES(tdr, 1);
68 *v = TDR_CVAL(tdr, tdr->offset);
69 tdr->offset += 1;
70 return NT_STATUS_OK;
73 NTSTATUS tdr_push_uint8(struct tdr_push *tdr, const uint8_t *v)
75 TDR_PUSH_NEED_BYTES(tdr, 1);
76 TDR_SCVAL(tdr, tdr->data.length, *v);
77 tdr->data.length += 1;
78 return NT_STATUS_OK;
81 NTSTATUS tdr_print_uint8(struct tdr_print *tdr, const char *name, uint8_t *v)
83 tdr->print(tdr, "%-25s: 0x%02x (%u)", name, *v, *v);
84 return NT_STATUS_OK;
87 NTSTATUS tdr_pull_uint16(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint16_t *v)
89 TDR_PULL_NEED_BYTES(tdr, 2);
90 *v = TDR_SVAL(tdr, tdr->offset);
91 tdr->offset += 2;
92 return NT_STATUS_OK;
95 NTSTATUS tdr_pull_uint1632(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint16_t *v)
97 return tdr_pull_uint16(tdr, ctx, v);
100 NTSTATUS tdr_push_uint16(struct tdr_push *tdr, const uint16_t *v)
102 TDR_PUSH_NEED_BYTES(tdr, 2);
103 TDR_SSVAL(tdr, tdr->data.length, *v);
104 tdr->data.length += 2;
105 return NT_STATUS_OK;
108 NTSTATUS tdr_push_uint1632(struct tdr_push *tdr, const uint16_t *v)
110 return tdr_push_uint16(tdr, v);
113 NTSTATUS tdr_print_uint16(struct tdr_print *tdr, const char *name, uint16_t *v)
115 tdr->print(tdr, "%-25s: 0x%02x (%u)", name, *v, *v);
116 return NT_STATUS_OK;
119 NTSTATUS tdr_pull_uint32(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint32_t *v)
121 TDR_PULL_NEED_BYTES(tdr, 4);
122 *v = TDR_IVAL(tdr, tdr->offset);
123 tdr->offset += 4;
124 return NT_STATUS_OK;
127 NTSTATUS tdr_push_uint32(struct tdr_push *tdr, const uint32_t *v)
129 TDR_PUSH_NEED_BYTES(tdr, 4);
130 TDR_SIVAL(tdr, tdr->data.length, *v);
131 tdr->data.length += 4;
132 return NT_STATUS_OK;
135 NTSTATUS tdr_print_uint32(struct tdr_print *tdr, const char *name, uint32_t *v)
137 tdr->print(tdr, "%-25s: 0x%02x (%u)", name, *v, *v);
138 return NT_STATUS_OK;
141 NTSTATUS tdr_pull_charset(struct tdr_pull *tdr, TALLOC_CTX *ctx, const char **v, uint32_t length, uint32_t el_size, charset_t chset)
143 size_t ret;
145 if (length == -1) {
146 switch (chset) {
147 case CH_DOS:
148 length = ascii_len_n((const char*)tdr->data.data+tdr->offset, tdr->data.length-tdr->offset);
149 break;
150 case CH_UTF16:
151 length = utf16_len_n(tdr->data.data+tdr->offset, tdr->data.length-tdr->offset);
152 break;
154 default:
155 return NT_STATUS_INVALID_PARAMETER;
159 if (length == 0) {
160 *v = talloc_strdup(ctx, "");
161 return NT_STATUS_OK;
164 TDR_PULL_NEED_BYTES(tdr, el_size*length);
166 if (!convert_string_talloc(ctx, chset, CH_UNIX, tdr->data.data+tdr->offset, el_size*length, discard_const_p(void *, v), &ret)) {
167 return NT_STATUS_INVALID_PARAMETER;
170 tdr->offset += length * el_size;
172 return NT_STATUS_OK;
175 NTSTATUS tdr_push_charset(struct tdr_push *tdr, const char **v, uint32_t length, uint32_t el_size, charset_t chset)
177 size_t required, size = 0;
178 bool ret;
180 if (length == -1) {
181 length = strlen(*v) + 1; /* Extra element for null character */
184 required = el_size * length;
185 TDR_PUSH_NEED_BYTES(tdr, required);
187 ret = convert_string(CH_UNIX, chset, *v, strlen(*v), tdr->data.data+tdr->data.length, required, &size);
188 if (ret == false) {
189 return NT_STATUS_INVALID_PARAMETER;
192 /* Make sure the remaining part of the string is filled with zeroes */
193 if (size < required) {
194 memset(tdr->data.data+tdr->data.length+size, 0, required-size);
197 tdr->data.length += required;
199 return NT_STATUS_OK;
202 NTSTATUS tdr_print_charset(struct tdr_print *tdr, const char *name, const char **v, uint32_t length, uint32_t el_size, charset_t chset)
204 tdr->print(tdr, "%-25s: %s", name, *v);
205 return NT_STATUS_OK;
209 parse a hyper
211 NTSTATUS tdr_pull_hyper(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint64_t *v)
213 TDR_PULL_NEED_BYTES(tdr, 8);
214 *v = TDR_IVAL(tdr, tdr->offset);
215 *v |= (uint64_t)(TDR_IVAL(tdr, tdr->offset+4)) << 32;
216 tdr->offset += 8;
217 return NT_STATUS_OK;
221 push a hyper
223 NTSTATUS tdr_push_hyper(struct tdr_push *tdr, uint64_t *v)
225 TDR_PUSH_NEED_BYTES(tdr, 8);
226 TDR_SIVAL(tdr, tdr->data.length, ((*v) & 0xFFFFFFFF));
227 TDR_SIVAL(tdr, tdr->data.length+4, ((*v)>>32));
228 tdr->data.length += 8;
229 return NT_STATUS_OK;
233 push a NTTIME
235 NTSTATUS tdr_push_NTTIME(struct tdr_push *tdr, NTTIME *t)
237 TDR_CHECK(tdr_push_hyper(tdr, t));
238 return NT_STATUS_OK;
242 pull a NTTIME
244 NTSTATUS tdr_pull_NTTIME(struct tdr_pull *tdr, TALLOC_CTX *ctx, NTTIME *t)
246 TDR_CHECK(tdr_pull_hyper(tdr, ctx, t));
247 return NT_STATUS_OK;
251 push a time_t
253 NTSTATUS tdr_push_time_t(struct tdr_push *tdr, time_t *t)
255 return tdr_push_uint32(tdr, (uint32_t *)t);
259 pull a time_t
261 NTSTATUS tdr_pull_time_t(struct tdr_pull *tdr, TALLOC_CTX *ctx, time_t *t)
263 uint32_t tt;
264 TDR_CHECK(tdr_pull_uint32(tdr, ctx, &tt));
265 *t = tt;
266 return NT_STATUS_OK;
269 NTSTATUS tdr_print_time_t(struct tdr_print *tdr, const char *name, time_t *t)
271 if (*t == (time_t)-1 || *t == 0) {
272 tdr->print(tdr, "%-25s: (time_t)%d", name, (int)*t);
273 } else {
274 tdr->print(tdr, "%-25s: %s", name, timestring(tdr, *t));
277 return NT_STATUS_OK;
280 NTSTATUS tdr_print_NTTIME(struct tdr_print *tdr, const char *name, NTTIME *t)
282 tdr->print(tdr, "%-25s: %s", name, nt_time_string(tdr, *t));
284 return NT_STATUS_OK;
287 NTSTATUS tdr_print_DATA_BLOB(struct tdr_print *tdr, const char *name, DATA_BLOB *r)
289 tdr->print(tdr, "%-25s: DATA_BLOB length=%u", name, r->length);
290 if (r->length) {
291 dump_data(10, r->data, r->length);
294 return NT_STATUS_OK;
297 #define TDR_ALIGN(l,n) (((l) & ((n)-1)) == 0?0:((n)-((l)&((n)-1))))
300 push a DATA_BLOB onto the wire.
302 NTSTATUS tdr_push_DATA_BLOB(struct tdr_push *tdr, DATA_BLOB *blob)
304 if (tdr->flags & TDR_ALIGN2) {
305 blob->length = TDR_ALIGN(tdr->data.length, 2);
306 } else if (tdr->flags & TDR_ALIGN4) {
307 blob->length = TDR_ALIGN(tdr->data.length, 4);
308 } else if (tdr->flags & TDR_ALIGN8) {
309 blob->length = TDR_ALIGN(tdr->data.length, 8);
312 TDR_PUSH_NEED_BYTES(tdr, blob->length);
314 memcpy(tdr->data.data+tdr->data.length, blob->data, blob->length);
315 return NT_STATUS_OK;
319 pull a DATA_BLOB from the wire.
321 NTSTATUS tdr_pull_DATA_BLOB(struct tdr_pull *tdr, TALLOC_CTX *ctx, DATA_BLOB *blob)
323 uint32_t length;
325 if (tdr->flags & TDR_ALIGN2) {
326 length = TDR_ALIGN(tdr->offset, 2);
327 } else if (tdr->flags & TDR_ALIGN4) {
328 length = TDR_ALIGN(tdr->offset, 4);
329 } else if (tdr->flags & TDR_ALIGN8) {
330 length = TDR_ALIGN(tdr->offset, 8);
331 } else if (tdr->flags & TDR_REMAINING) {
332 length = tdr->data.length - tdr->offset;
333 } else {
334 return NT_STATUS_INVALID_PARAMETER;
337 if (tdr->data.length - tdr->offset < length) {
338 length = tdr->data.length - tdr->offset;
341 TDR_PULL_NEED_BYTES(tdr, length);
343 *blob = data_blob_talloc(tdr, tdr->data.data+tdr->offset, length);
344 tdr->offset += length;
345 return NT_STATUS_OK;
348 struct tdr_push *tdr_push_init(TALLOC_CTX *mem_ctx)
350 struct tdr_push *push = talloc_zero(mem_ctx, struct tdr_push);
352 if (push == NULL)
353 return NULL;
355 return push;
358 struct tdr_pull *tdr_pull_init(TALLOC_CTX *mem_ctx)
360 struct tdr_pull *pull = talloc_zero(mem_ctx, struct tdr_pull);
362 if (pull == NULL)
363 return NULL;
365 return pull;
368 NTSTATUS tdr_push_to_fd(int fd, tdr_push_fn_t push_fn, const void *p)
370 struct tdr_push *push = tdr_push_init(NULL);
372 if (push == NULL)
373 return NT_STATUS_NO_MEMORY;
375 if (NT_STATUS_IS_ERR(push_fn(push, p))) {
376 DEBUG(1, ("Error pushing data\n"));
377 talloc_free(push);
378 return NT_STATUS_UNSUCCESSFUL;
381 if (write(fd, push->data.data, push->data.length) < push->data.length) {
382 DEBUG(1, ("Error writing all data\n"));
383 return NT_STATUS_UNSUCCESSFUL;
386 talloc_free(push);
388 return NT_STATUS_OK;
391 void tdr_print_debug_helper(struct tdr_print *tdr, const char *format, ...)
393 va_list ap;
394 char *s = NULL;
395 int i;
397 va_start(ap, format);
398 vasprintf(&s, format, ap);
399 va_end(ap);
401 for (i=0;i<tdr->level;i++) { DEBUG(0,(" ")); }
403 DEBUG(0,("%s\n", s));
404 free(s);