2 Unix SMB/Netbios implementation.
4 Samba memory buffer functions
5 Copyright (C) Andrew Tridgell 1992-1997
6 Copyright (C) Luke Kenneth Casson Leighton 1996-1997
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.
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.
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.
23 extern int DEBUGLEVEL;
28 /*******************************************************************
29 debug output for parsing info.
31 XXXX side-effect of this function is to increase the debug depth XXXX
33 ********************************************************************/
34 void prs_debug(prs_struct *ps, int depth, char *desc, char *fn_name)
36 DEBUG(5+depth, ("%s%06x %s %s\n", tab_depth(depth), ps->offset, fn_name, desc));
39 /*******************************************************************
40 initialise a parse structure
41 ********************************************************************/
42 void prs_init(prs_struct *ps, uint32 size,
43 uint8 align, uint32 margin,
51 mem_buf_init(&(ps->data), margin);
55 mem_alloc_data(ps->data, size);
56 ps->data->offset.start = 0;
57 ps->data->offset.end = 0xffffffff;
61 /*******************************************************************
62 initialise a parse structure
63 ********************************************************************/
64 void prs_mem_free(prs_struct *ps)
66 mem_buf_free(&(ps->data));
69 /*******************************************************************
70 link one parsing structure to another
71 ********************************************************************/
72 void prs_link(prs_struct *prev, prs_struct *ps, prs_struct *next)
74 ps->data->offset.start = prev != NULL ? prev->data->offset.end : 0;
75 ps->data->offset.end = ps->data->offset.start + ps->offset;
76 ps->data->next = next != NULL ? next->data : NULL;
79 /*******************************************************************
80 align a pointer to a multiple of align_offset bytes. looks like it
81 will work for offsets of 0, 2 and 4...
82 ********************************************************************/
83 void prs_align(prs_struct *ps)
85 int mod = ps->offset & (ps->align-1);
86 if (ps->align != 0 && mod != 0)
88 ps->offset += ps->align - mod;
92 /*******************************************************************
93 attempt, if appropriate, to grow a data buffer.
95 depends on the data stream mode (io)
96 ********************************************************************/
97 BOOL prs_grow(prs_struct *ps)
99 return mem_grow_data(&(ps->data), ps->io, ps->offset, False);
103 /*******************************************************************
105 ********************************************************************/
106 BOOL prs_uint8(char *name, prs_struct *ps, int depth, uint8 *data8)
108 char *q = mem_data(&(ps->data), ps->offset);
109 if (q == NULL) return False;
111 DBG_RW_CVAL(name, depth, ps->offset, ps->io, q, *data8)
117 /*******************************************************************
119 ********************************************************************/
120 BOOL prs_uint16(char *name, prs_struct *ps, int depth, uint16 *data16)
122 char *q = mem_data(&(ps->data), ps->offset);
123 if (q == NULL) return False;
125 DBG_RW_SVAL(name, depth, ps->offset, ps->io, q, *data16)
131 /*******************************************************************
133 ********************************************************************/
134 BOOL prs_uint32(char *name, prs_struct *ps, int depth, uint32 *data32)
136 char *q = mem_data(&(ps->data), ps->offset);
137 if (q == NULL) return False;
139 DBG_RW_IVAL(name, depth, ps->offset, ps->io, q, *data32)
146 /******************************************************************
147 stream an array of uint8s. length is number of uint8s
148 ********************************************************************/
149 BOOL prs_uint8s(BOOL charmode, char *name, prs_struct *ps, int depth, uint8 *data8s, int len)
151 char *q = mem_data(&(ps->data), ps->offset);
152 if (q == NULL) return False;
154 DBG_RW_PCVAL(charmode, name, depth, ps->offset, ps->io, q, data8s, len)
160 /******************************************************************
161 stream an array of uint32s. length is number of uint32s
162 ********************************************************************/
163 BOOL prs_uint32s(BOOL charmode, char *name, prs_struct *ps, int depth, uint32 *data32s, int len)
165 char *q = mem_data(&(ps->data), ps->offset);
166 if (q == NULL) return False;
168 DBG_RW_PIVAL(charmode, name, depth, ps->offset, ps->io, q, data32s, len)
169 ps->offset += len * sizeof(uint32);
174 /******************************************************************
175 stream a "not" unicode string, length/buffer specified separately,
177 ********************************************************************/
178 BOOL prs_buffer2(BOOL charmode, char *name, prs_struct *ps, int depth, BUFFER2 *str)
180 char *q = mem_data(&(ps->data), ps->offset);
181 if (q == NULL) return False;
183 DBG_RW_PSVAL(charmode, name, depth, ps->offset, ps->io, q, str->buffer, str->buf_len/2)
184 ps->offset += str->buf_len;
189 /******************************************************************
190 stream a string, length/buffer specified separately,
192 ********************************************************************/
193 BOOL prs_string2(BOOL charmode, char *name, prs_struct *ps, int depth, STRING2 *str)
195 char *q = mem_data(&(ps->data), ps->offset);
196 if (q == NULL) return False;
198 DBG_RW_PCVAL(charmode, name, depth, ps->offset, ps->io, q, str->buffer, str->str_max_len)
199 ps->offset += str->str_str_len * sizeof(uint8);
204 /******************************************************************
205 stream a unicode string, length/buffer specified separately,
207 ********************************************************************/
208 BOOL prs_unistr2(BOOL charmode, char *name, prs_struct *ps, int depth, UNISTR2 *str)
210 char *q = mem_data(&(ps->data), ps->offset);
211 if (q == NULL) return False;
213 DBG_RW_PSVAL(charmode, name, depth, ps->offset, ps->io, q, str->buffer, str->uni_str_len)
214 ps->offset += str->uni_str_len * sizeof(uint16);
219 /******************************************************************
220 stream a unicode string, length/buffer specified separately,
222 ********************************************************************/
223 BOOL prs_unistr3(BOOL charmode, char *name, UNISTR3 *str, prs_struct *ps, int depth)
225 char *q = mem_data(&(ps->data), ps->offset);
226 if (q == NULL) return False;
228 DBG_RW_PSVAL(charmode, name, depth, ps->offset, ps->io, q, str->str.buffer, str->uni_str_len)
229 ps->offset += str->uni_str_len * sizeof(uint16);
234 /*******************************************************************
235 stream a unicode null-terminated string
236 ********************************************************************/
237 BOOL prs_unistr(char *name, prs_struct *ps, int depth, UNISTR *str)
239 char *q = mem_data(&(ps->data), ps->offset);
241 uint8 *start = (uint8*)q;
243 if (q == NULL) return False;
247 RW_SVAL(ps->io, q, str->buffer[i],0);
251 } while ((i < sizeof(str->buffer) / sizeof(str->buffer[0])) &&
252 (str->buffer[i] != 0));
256 dump_data(5+depth, (char *)start, i * 2);
261 /*******************************************************************
262 stream a null-terminated string. len is strlen, and therefore does
263 not include the null-termination character.
265 len == 0 indicates variable length string
266 (up to max size of pstring - 1024 chars).
268 ********************************************************************/
269 BOOL prs_string(char *name, prs_struct *ps, int depth, char *str, uint16 len, uint16 max_buf_size)
271 char *q = mem_data(&(ps->data), ps->offset);
272 uint8 *start = (uint8*)q;
273 int i = -1; /* start off at zero after 1st i++ */
275 if (q == NULL) return False;
281 if (i < len || len == 0)
283 RW_CVAL(ps->io, q, str[i],0);
288 RW_CVAL(ps->io, q, dummy,0);
293 } while (i < max_buf_size && (len == 0 ? str[i] != 0 : i < len) );
297 dump_data(5+depth, (char *)start, i);
302 /*******************************************************************
303 prs_uint16 wrapper. call this and it sets up a pointer to where the
304 uint16 should be stored, or gets the size if reading
305 ********************************************************************/
306 BOOL prs_uint16_pre(char *name, prs_struct *ps, int depth, uint16 *data16, uint32 *offset)
308 (*offset) = ps->offset;
312 return prs_uint16(name, ps, depth, data16);
316 ps->offset += sizeof(uint16);
321 /*******************************************************************
322 prs_uint16 wrapper. call this and it retrospectively stores the size.
323 does nothing on reading, as that is already handled by ...._pre()
324 ********************************************************************/
325 BOOL prs_uint16_post(char *name, prs_struct *ps, int depth, uint16 *data16,
326 uint32 ptr_uint16, uint32 start_offset)
330 /* storing: go back and do a retrospective job. i hate this */
331 uint16 data_size = ps->offset - start_offset;
332 uint32 old_offset = ps->offset;
334 ps->offset = ptr_uint16;
335 prs_uint16(name, ps, depth, &data_size);
336 ps->offset = old_offset;
340 ps->offset = start_offset + (*data16);
345 /*******************************************************************
346 prs_uint32 wrapper. call this and it sets up a pointer to where the
347 uint32 should be stored, or gets the size if reading
348 ********************************************************************/
349 BOOL prs_uint32_pre(char *name, prs_struct *ps, int depth, uint32 *data32, uint32 *offset)
351 (*offset) = ps->offset;
355 return prs_uint32(name, ps, depth, data32);
359 ps->offset += sizeof(uint32);
364 /*******************************************************************
365 prs_uint32 wrapper. call this and it retrospectively stores the size.
366 does nothing on reading, as that is already handled by ...._pre()
367 ********************************************************************/
368 BOOL prs_uint32_post(char *name, prs_struct *ps, int depth, uint32 *data32,
369 uint32 ptr_uint32, uint32 start_offset)
373 /* storing: go back and do a retrospective job. i hate this */
374 uint32 data_size = ps->offset - start_offset;
375 uint32 old_offset = ps->offset;
377 ps->offset = ptr_uint32;
378 prs_uint32(name, ps, depth, &data_size);
379 ps->offset = old_offset;
383 ps->offset = start_offset + (*data32);