s4-heimdal: Fix typo in comment.
[Samba/gbeck.git] / lib / tdr / tdr.c
blob95871047b7f3a16793fb805c166211b0e8c605e4
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, false)) {
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 ret, required;
179 if (length == -1) {
180 length = strlen(*v) + 1; /* Extra element for null character */
183 required = el_size * length;
184 TDR_PUSH_NEED_BYTES(tdr, required);
186 ret = convert_string(CH_UNIX, chset, *v, strlen(*v), tdr->data.data+tdr->data.length, required, false);
187 if (ret == -1) {
188 return NT_STATUS_INVALID_PARAMETER;
191 /* Make sure the remaining part of the string is filled with zeroes */
192 if (ret < required) {
193 memset(tdr->data.data+tdr->data.length+ret, 0, required-ret);
196 tdr->data.length += required;
198 return NT_STATUS_OK;
201 NTSTATUS tdr_print_charset(struct tdr_print *tdr, const char *name, const char **v, uint32_t length, uint32_t el_size, charset_t chset)
203 tdr->print(tdr, "%-25s: %s", name, *v);
204 return NT_STATUS_OK;
208 parse a hyper
210 NTSTATUS tdr_pull_hyper(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint64_t *v)
212 TDR_PULL_NEED_BYTES(tdr, 8);
213 *v = TDR_IVAL(tdr, tdr->offset);
214 *v |= (uint64_t)(TDR_IVAL(tdr, tdr->offset+4)) << 32;
215 tdr->offset += 8;
216 return NT_STATUS_OK;
220 push a hyper
222 NTSTATUS tdr_push_hyper(struct tdr_push *tdr, uint64_t *v)
224 TDR_PUSH_NEED_BYTES(tdr, 8);
225 TDR_SIVAL(tdr, tdr->data.length, ((*v) & 0xFFFFFFFF));
226 TDR_SIVAL(tdr, tdr->data.length+4, ((*v)>>32));
227 tdr->data.length += 8;
228 return NT_STATUS_OK;
232 push a NTTIME
234 NTSTATUS tdr_push_NTTIME(struct tdr_push *tdr, NTTIME *t)
236 TDR_CHECK(tdr_push_hyper(tdr, t));
237 return NT_STATUS_OK;
241 pull a NTTIME
243 NTSTATUS tdr_pull_NTTIME(struct tdr_pull *tdr, TALLOC_CTX *ctx, NTTIME *t)
245 TDR_CHECK(tdr_pull_hyper(tdr, ctx, t));
246 return NT_STATUS_OK;
250 push a time_t
252 NTSTATUS tdr_push_time_t(struct tdr_push *tdr, time_t *t)
254 return tdr_push_uint32(tdr, (uint32_t *)t);
258 pull a time_t
260 NTSTATUS tdr_pull_time_t(struct tdr_pull *tdr, TALLOC_CTX *ctx, time_t *t)
262 uint32_t tt;
263 TDR_CHECK(tdr_pull_uint32(tdr, ctx, &tt));
264 *t = tt;
265 return NT_STATUS_OK;
268 NTSTATUS tdr_print_time_t(struct tdr_print *tdr, const char *name, time_t *t)
270 if (*t == (time_t)-1 || *t == 0) {
271 tdr->print(tdr, "%-25s: (time_t)%d", name, (int)*t);
272 } else {
273 tdr->print(tdr, "%-25s: %s", name, timestring(tdr, *t));
276 return NT_STATUS_OK;
279 NTSTATUS tdr_print_NTTIME(struct tdr_print *tdr, const char *name, NTTIME *t)
281 tdr->print(tdr, "%-25s: %s", name, nt_time_string(tdr, *t));
283 return NT_STATUS_OK;
286 NTSTATUS tdr_print_DATA_BLOB(struct tdr_print *tdr, const char *name, DATA_BLOB *r)
288 tdr->print(tdr, "%-25s: DATA_BLOB length=%u", name, r->length);
289 if (r->length) {
290 dump_data(10, r->data, r->length);
293 return NT_STATUS_OK;
296 #define TDR_ALIGN(l,n) (((l) & ((n)-1)) == 0?0:((n)-((l)&((n)-1))))
299 push a DATA_BLOB onto the wire.
301 NTSTATUS tdr_push_DATA_BLOB(struct tdr_push *tdr, DATA_BLOB *blob)
303 if (tdr->flags & TDR_ALIGN2) {
304 blob->length = TDR_ALIGN(tdr->data.length, 2);
305 } else if (tdr->flags & TDR_ALIGN4) {
306 blob->length = TDR_ALIGN(tdr->data.length, 4);
307 } else if (tdr->flags & TDR_ALIGN8) {
308 blob->length = TDR_ALIGN(tdr->data.length, 8);
311 TDR_PUSH_NEED_BYTES(tdr, blob->length);
313 memcpy(tdr->data.data+tdr->data.length, blob->data, blob->length);
314 return NT_STATUS_OK;
318 pull a DATA_BLOB from the wire.
320 NTSTATUS tdr_pull_DATA_BLOB(struct tdr_pull *tdr, TALLOC_CTX *ctx, DATA_BLOB *blob)
322 uint32_t length;
324 if (tdr->flags & TDR_ALIGN2) {
325 length = TDR_ALIGN(tdr->offset, 2);
326 } else if (tdr->flags & TDR_ALIGN4) {
327 length = TDR_ALIGN(tdr->offset, 4);
328 } else if (tdr->flags & TDR_ALIGN8) {
329 length = TDR_ALIGN(tdr->offset, 8);
330 } else if (tdr->flags & TDR_REMAINING) {
331 length = tdr->data.length - tdr->offset;
332 } else {
333 return NT_STATUS_INVALID_PARAMETER;
336 if (tdr->data.length - tdr->offset < length) {
337 length = tdr->data.length - tdr->offset;
340 TDR_PULL_NEED_BYTES(tdr, length);
342 *blob = data_blob_talloc(tdr, tdr->data.data+tdr->offset, length);
343 tdr->offset += length;
344 return NT_STATUS_OK;
347 struct tdr_push *tdr_push_init(TALLOC_CTX *mem_ctx)
349 struct tdr_push *push = talloc_zero(mem_ctx, struct tdr_push);
351 if (push == NULL)
352 return NULL;
354 return push;
357 struct tdr_pull *tdr_pull_init(TALLOC_CTX *mem_ctx)
359 struct tdr_pull *pull = talloc_zero(mem_ctx, struct tdr_pull);
361 if (pull == NULL)
362 return NULL;
364 return pull;
367 NTSTATUS tdr_push_to_fd(int fd, tdr_push_fn_t push_fn, const void *p)
369 struct tdr_push *push = tdr_push_init(NULL);
371 if (push == NULL)
372 return NT_STATUS_NO_MEMORY;
374 if (NT_STATUS_IS_ERR(push_fn(push, p))) {
375 DEBUG(1, ("Error pushing data\n"));
376 talloc_free(push);
377 return NT_STATUS_UNSUCCESSFUL;
380 if (write(fd, push->data.data, push->data.length) < push->data.length) {
381 DEBUG(1, ("Error writing all data\n"));
382 return NT_STATUS_UNSUCCESSFUL;
385 talloc_free(push);
387 return NT_STATUS_OK;
390 void tdr_print_debug_helper(struct tdr_print *tdr, const char *format, ...) _PRINTF_ATTRIBUTE(2,3)
392 va_list ap;
393 char *s = NULL;
394 int i;
396 va_start(ap, format);
397 vasprintf(&s, format, ap);
398 va_end(ap);
400 for (i=0;i<tdr->level;i++) { DEBUG(0,(" ")); }
402 DEBUG(0,("%s\n", s));
403 free(s);