2 Unix SMB/CIFS implementation.
4 manipulate nbt name structures
6 Copyright (C) Andrew Tridgell 2005
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 3 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, see <http://www.gnu.org/licenses/>.
23 see rfc1002 for the detailed format of compressed names
27 #include "librpc/gen_ndr/ndr_nbt.h"
28 #include "librpc/gen_ndr/ndr_misc.h"
29 #include "system/locale.h"
31 /* don't allow an unlimited number of name components */
32 #define MAX_COMPONENTS 10
37 _PUBLIC_
void ndr_print_nbt_string(struct ndr_print
*ndr
, const char *name
, const char *s
)
39 ndr_print_string(ndr
, name
, s
);
43 pull one component of a nbt_string
45 static enum ndr_err_code
ndr_pull_component(struct ndr_pull
*ndr
,
51 unsigned int loops
= 0;
53 if (*offset
>= ndr
->data_size
) {
54 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
55 "BAD NBT NAME component");
57 len
= ndr
->data
[*offset
];
60 *max_offset
= MAX(*max_offset
, *offset
);
62 return NDR_ERR_SUCCESS
;
64 if ((len
& 0xC0) == 0xC0) {
65 /* its a label pointer */
66 if (1 + *offset
>= ndr
->data_size
) {
67 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
68 "BAD NBT NAME component");
70 *max_offset
= MAX(*max_offset
, *offset
+ 2);
71 *offset
= ((len
&0x3F)<<8) | ndr
->data
[1 + *offset
];
72 *max_offset
= MAX(*max_offset
, *offset
);
76 if ((len
& 0xC0) != 0) {
77 /* its a reserved length field */
78 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
79 "BAD NBT NAME component");
81 if (*offset
+ len
+ 2 > ndr
->data_size
) {
82 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
83 "BAD NBT NAME component");
85 *component
= (uint8_t*)talloc_strndup(ndr
, (const char *)&ndr
->data
[1 + *offset
], len
);
86 NDR_ERR_HAVE_NO_MEMORY(*component
);
88 *max_offset
= MAX(*max_offset
, *offset
);
89 return NDR_ERR_SUCCESS
;
92 /* too many pointers */
93 return ndr_pull_error(ndr
, NDR_ERR_STRING
, "BAD NBT NAME component");
97 pull a nbt_string from the wire
99 _PUBLIC_
enum ndr_err_code
ndr_pull_nbt_string(struct ndr_pull
*ndr
, int ndr_flags
, const char **s
)
101 uint32_t offset
= ndr
->offset
;
102 uint32_t max_offset
= offset
;
103 unsigned num_components
;
106 if (!(ndr_flags
& NDR_SCALARS
)) {
107 return NDR_ERR_SUCCESS
;
112 /* break up name into a list of components */
113 for (num_components
=0;num_components
<MAX_COMPONENTS
;num_components
++) {
114 uint8_t *component
= NULL
;
115 NDR_CHECK(ndr_pull_component(ndr
, &component
, &offset
, &max_offset
));
116 if (component
== NULL
) break;
118 name
= talloc_asprintf_append_buffer(name
, ".%s", component
);
119 NDR_ERR_HAVE_NO_MEMORY(name
);
121 name
= (char *)component
;
124 if (num_components
== MAX_COMPONENTS
) {
125 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
126 "BAD NBT NAME too many components");
128 if (num_components
== 0) {
129 name
= talloc_strdup(ndr
, "");
130 NDR_ERR_HAVE_NO_MEMORY(name
);
134 ndr
->offset
= max_offset
;
136 return NDR_ERR_SUCCESS
;
140 push a nbt string to the wire
142 _PUBLIC_
enum ndr_err_code
ndr_push_nbt_string(struct ndr_push
*ndr
, int ndr_flags
, const char *s
)
144 if (!(ndr_flags
& NDR_SCALARS
)) {
145 return NDR_ERR_SUCCESS
;
149 enum ndr_err_code ndr_err
;
154 /* see if we have pushed the remaing string allready,
155 * if so we use a label pointer to this string
157 ndr_err
= ndr_token_retrieve_cmp_fn(&ndr
->nbt_string_list
, s
, &offset
, (comparison_fn_t
)strcmp
, false);
158 if (NDR_ERR_CODE_IS_SUCCESS(ndr_err
)) {
161 if (offset
> 0x3FFF) {
162 return ndr_push_error(ndr
, NDR_ERR_STRING
,
163 "offset for nbt string label pointer %u[%08X] > 0x00003FFF",
167 b
[0] = 0xC0 | (offset
>>8);
168 b
[1] = (offset
& 0xFF);
170 return ndr_push_bytes(ndr
, b
, 2);
173 complen
= strcspn(s
, ".");
175 /* we need to make sure the length fits into 6 bytes */
176 if (complen
> 0x3F) {
177 return ndr_push_error(ndr
, NDR_ERR_STRING
,
178 "component length %u[%08X] > 0x0000003F",
179 (unsigned)complen
, (unsigned)complen
);
182 compname
= talloc_asprintf(ndr
, "%c%*.*s",
183 (unsigned char)complen
,
184 (unsigned char)complen
,
185 (unsigned char)complen
, s
);
186 NDR_ERR_HAVE_NO_MEMORY(compname
);
188 /* remember the current componemt + the rest of the string
189 * so it can be reused later
191 NDR_CHECK(ndr_token_store(ndr
, &ndr
->nbt_string_list
, s
, ndr
->offset
));
193 /* push just this component into the blob */
194 NDR_CHECK(ndr_push_bytes(ndr
, (const uint8_t *)compname
, complen
+1));
195 talloc_free(compname
);
201 /* if we reach the end of the string and have pushed the last component
202 * without using a label pointer, we need to terminate the string
204 return ndr_push_bytes(ndr
, (const uint8_t *)"", 1);
209 decompress a 'compressed' name component
211 static bool decompress_name(char *name
, enum nbt_name_type
*type
)
214 for (i
=0;name
[2*i
];i
++) {
215 uint8_t c1
= name
[2*i
];
216 uint8_t c2
= name
[1+(2*i
)];
217 if (c1
< 'A' || c1
> 'P' ||
218 c2
< 'A' || c2
> 'P') {
221 name
[i
] = ((c1
-'A')<<4) | (c2
-'A');
225 *type
= (enum nbt_name_type
)(name
[15]);
229 *type
= NBT_NAME_CLIENT
;
232 /* trim trailing spaces */
233 for (;i
>0 && name
[i
-1]==' ';i
--) {
242 compress a name component
244 static uint8_t *compress_name(TALLOC_CTX
*mem_ctx
,
245 const uint8_t *name
, enum nbt_name_type type
)
251 if (strlen((const char *)name
) > 15) {
255 cname
= talloc_array(mem_ctx
, uint8_t, 33);
256 if (cname
== NULL
) return NULL
;
258 for (i
=0;name
[i
];i
++) {
259 cname
[2*i
] = 'A' + (name
[i
]>>4);
260 cname
[1+2*i
] = 'A' + (name
[i
]&0xF);
262 if (strcmp((const char *)name
, "*") == 0) {
268 cname
[2*i
] = 'A' + (pad_char
>>4);
269 cname
[1+2*i
] = 'A' + (pad_char
&0xF);
273 cname
[2*i
] = 'A' + (pad_char
>>4);
274 cname
[1+2*i
] = 'A' + (pad_char
&0xF);
282 pull a nbt name from the wire
284 _PUBLIC_
enum ndr_err_code
ndr_pull_nbt_name(struct ndr_pull
*ndr
, int ndr_flags
, struct nbt_name
*r
)
291 if (!(ndr_flags
& NDR_SCALARS
)) {
292 return NDR_ERR_SUCCESS
;
295 NDR_CHECK(ndr_pull_nbt_string(ndr
, ndr_flags
, &s
));
297 scope
= (uint8_t *)strchr(s
, '.');
300 r
->scope
= talloc_strdup(ndr
->current_mem_ctx
, (const char *)&scope
[1]);
301 NDR_ERR_HAVE_NO_MEMORY(r
->scope
);
306 cname
= discard_const_p(char, s
);
308 /* the first component is limited to 16 bytes in the DOS charset,
309 which is 32 in the 'compressed' form */
310 if (strlen(cname
) > 32) {
311 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
312 "NBT NAME cname > 32");
315 /* decompress the first component */
316 ok
= decompress_name(cname
, &r
->type
);
318 return ndr_pull_error(ndr
, NDR_ERR_STRING
,
319 "NBT NAME failed to decompress");
322 r
->name
= talloc_strdup(ndr
->current_mem_ctx
, cname
);
323 NDR_ERR_HAVE_NO_MEMORY(r
->name
);
327 return NDR_ERR_SUCCESS
;
331 push a nbt name to the wire
333 _PUBLIC_
enum ndr_err_code
ndr_push_nbt_name(struct ndr_push
*ndr
, int ndr_flags
, const struct nbt_name
*r
)
335 uint8_t *cname
, *fullname
;
336 enum ndr_err_code ndr_err
;
338 if (!(ndr_flags
& NDR_SCALARS
)) {
339 return NDR_ERR_SUCCESS
;
342 if (strlen(r
->name
) > 15) {
343 return ndr_push_error(ndr
, NDR_ERR_STRING
,
344 "nbt_name longer as 15 chars: %s",
348 cname
= compress_name(ndr
, (const uint8_t *)r
->name
, r
->type
);
349 NDR_ERR_HAVE_NO_MEMORY(cname
);
352 fullname
= (uint8_t *)talloc_asprintf(ndr
, "%s.%s", cname
, r
->scope
);
353 NDR_ERR_HAVE_NO_MEMORY(fullname
);
359 ndr_err
= ndr_push_nbt_string(ndr
, ndr_flags
, (const char *)fullname
);
366 copy a nbt name structure
368 _PUBLIC_ NTSTATUS
nbt_name_dup(TALLOC_CTX
*mem_ctx
, struct nbt_name
*name
, struct nbt_name
*newname
)
371 newname
->name
= talloc_strdup(mem_ctx
, newname
->name
);
372 NT_STATUS_HAVE_NO_MEMORY(newname
->name
);
373 newname
->scope
= talloc_strdup(mem_ctx
, newname
->scope
);
375 NT_STATUS_HAVE_NO_MEMORY(newname
->scope
);
381 push a nbt name into a blob
383 _PUBLIC_ NTSTATUS
nbt_name_to_blob(TALLOC_CTX
*mem_ctx
, struct smb_iconv_convenience
*iconv_convenience
, DATA_BLOB
*blob
, struct nbt_name
*name
)
385 enum ndr_err_code ndr_err
;
387 ndr_err
= ndr_push_struct_blob(blob
, mem_ctx
, iconv_convenience
, name
, (ndr_push_flags_fn_t
)ndr_push_nbt_name
);
388 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err
)) {
389 return ndr_map_error2ntstatus(ndr_err
);
396 pull a nbt name from a blob
398 _PUBLIC_ NTSTATUS
nbt_name_from_blob(TALLOC_CTX
*mem_ctx
, const DATA_BLOB
*blob
, struct nbt_name
*name
)
400 enum ndr_err_code ndr_err
;
402 ndr_err
= ndr_pull_struct_blob(blob
, mem_ctx
, NULL
, name
,
403 (ndr_pull_flags_fn_t
)ndr_pull_nbt_name
);
404 if (!NDR_ERR_CODE_IS_SUCCESS(ndr_err
)) {
405 return ndr_map_error2ntstatus(ndr_err
);
413 choose a name to use when calling a server in a NBT session request.
414 we use heuristics to see if the name we have been given is a IP
415 address, or a too-long name. If it is then use *SMBSERVER, or a
418 _PUBLIC_
void nbt_choose_called_name(TALLOC_CTX
*mem_ctx
,
419 struct nbt_name
*n
, const char *name
, int type
)
424 if ((name
== NULL
) || is_ipaddress(name
)) {
425 n
->name
= "*SMBSERVER";
428 if (strlen(name
) > 15) {
429 const char *p
= strchr(name
, '.');
432 n
->name
= "*SMBSERVER";
435 s
= talloc_strndup(mem_ctx
, name
, PTR_DIFF(p
, name
));
436 n
->name
= talloc_strdup_upper(mem_ctx
, s
);
440 n
->name
= talloc_strdup_upper(mem_ctx
, name
);
445 escape a string into a form containing only a small set of characters,
446 the rest is hex encoded. This is similar to URL encoding
448 static const char *nbt_hex_encode(TALLOC_CTX
*mem_ctx
, const char *s
)
452 const char *valid_chars
= "_-.$@ ";
453 #define NBT_CHAR_ALLOW(c) (isalnum((unsigned char)c) || strchr(valid_chars, c))
455 for (len
=i
=0;s
[i
];i
++,len
++) {
456 if (!NBT_CHAR_ALLOW(s
[i
])) {
461 ret
= talloc_array(mem_ctx
, char, len
+1);
462 if (ret
== NULL
) return NULL
;
464 for (len
=i
=0;s
[i
];i
++) {
465 if (NBT_CHAR_ALLOW(s
[i
])) {
468 snprintf(&ret
[len
], 4, "%%%02x", (unsigned char)s
[i
]);
479 form a string for a NBT name
481 _PUBLIC_
char *nbt_name_string(TALLOC_CTX
*mem_ctx
, const struct nbt_name
*name
)
483 TALLOC_CTX
*tmp_ctx
= talloc_new(mem_ctx
);
486 ret
= talloc_asprintf(mem_ctx
, "%s<%02x>-%s",
487 nbt_hex_encode(tmp_ctx
, name
->name
),
489 nbt_hex_encode(tmp_ctx
, name
->scope
));
491 ret
= talloc_asprintf(mem_ctx
, "%s<%02x>",
492 nbt_hex_encode(tmp_ctx
, name
->name
),
495 talloc_free(tmp_ctx
);
500 pull a nbt name, WINS Replication uses another on wire format for nbt name
502 _PUBLIC_
enum ndr_err_code
ndr_pull_wrepl_nbt_name(struct ndr_pull
*ndr
, int ndr_flags
, const struct nbt_name
**_r
)
506 uint32_t namebuf_len
;
508 if (!(ndr_flags
& NDR_SCALARS
)) {
509 return NDR_ERR_SUCCESS
;
512 NDR_CHECK(ndr_pull_align(ndr
, 4));
513 NDR_CHECK(ndr_pull_uint32(ndr
, NDR_SCALARS
, &namebuf_len
));
514 if (namebuf_len
< 1 || namebuf_len
> 255) {
515 return ndr_pull_error(ndr
, NDR_ERR_ALLOC
, "value out of range");
517 NDR_PULL_ALLOC_N(ndr
, namebuf
, namebuf_len
);
518 NDR_CHECK(ndr_pull_array_uint8(ndr
, NDR_SCALARS
, namebuf
, namebuf_len
));
520 if ((namebuf_len
% 4) == 0) {
522 * [MS-WINSRA] — v20091104 was wrong
523 * regarding section "2.2.10.1 Name Record"
525 * If the name buffer is already 4 byte aligned
526 * Windows (at least 2003 SP1 and 2008) add 4 extra
527 * bytes. This can happen when the name has a scope.
530 NDR_CHECK(ndr_pull_uint32(ndr
, NDR_SCALARS
, &pad
));
533 NDR_PULL_ALLOC(ndr
, r
);
535 /* oh wow, what a nasty bug in windows ... */
536 if (namebuf
[0] == 0x1b && namebuf_len
>= 16) {
537 namebuf
[0] = namebuf
[15];
541 if (namebuf_len
< 17) {
544 r
->name
= talloc_strndup(r
, (char *)namebuf
, namebuf_len
);
545 if (!r
->name
) return ndr_pull_error(ndr
, NDR_ERR_ALLOC
, "out of memory");
549 talloc_free(namebuf
);
551 return NDR_ERR_SUCCESS
;
554 r
->type
= namebuf
[15];
557 trim_string((char *)namebuf
, NULL
, " ");
558 r
->name
= talloc_strdup(r
, (char *)namebuf
);
559 if (!r
->name
) return ndr_pull_error(ndr
, NDR_ERR_ALLOC
, "out of memory");
561 if (namebuf_len
> 17) {
562 r
->scope
= talloc_strndup(r
, (char *)(namebuf
+16), namebuf_len
-17);
563 if (!r
->scope
) return ndr_pull_error(ndr
, NDR_ERR_ALLOC
, "out of memory");
568 talloc_free(namebuf
);
570 return NDR_ERR_SUCCESS
;
574 push a nbt name, WINS Replication uses another on wire format for nbt name
576 _PUBLIC_
enum ndr_err_code
ndr_push_wrepl_nbt_name(struct ndr_push
*ndr
, int ndr_flags
, const struct nbt_name
*r
)
579 uint32_t namebuf_len
;
581 uint32_t scope_len
= 0;
584 return ndr_push_error(ndr
, NDR_ERR_INVALID_POINTER
,
585 "wrepl_nbt_name NULL pointer");
588 if (!(ndr_flags
& NDR_SCALARS
)) {
589 return NDR_ERR_SUCCESS
;
592 _name_len
= strlen(r
->name
);
593 if (_name_len
> 15) {
594 return ndr_push_error(ndr
, NDR_ERR_STRING
,
595 "wrepl_nbt_name longer as 15 chars: %s",
600 scope_len
= strlen(r
->scope
);
602 if (scope_len
> 238) {
603 return ndr_push_error(ndr
, NDR_ERR_STRING
,
604 "wrepl_nbt_name scope longer as 238 chars: %s",
608 namebuf
= (uint8_t *)talloc_asprintf(ndr
, "%-15s%c%s",
610 (r
->scope
?r
->scope
:""));
611 if (!namebuf
) return ndr_push_error(ndr
, NDR_ERR_ALLOC
, "out of memory");
613 namebuf_len
= strlen((char *)namebuf
) + 1;
616 * we need to set the type here, and use a place-holder in the talloc_asprintf()
617 * as the type can be 0x00, and then the namebuf_len = strlen(namebuf); would give wrong results
619 namebuf
[15] = r
->type
;
621 /* oh wow, what a nasty bug in windows ... */
622 if (r
->type
== 0x1b) {
623 namebuf
[15] = namebuf
[0];
627 NDR_CHECK(ndr_push_align(ndr
, 4));
628 NDR_CHECK(ndr_push_uint32(ndr
, NDR_SCALARS
, namebuf_len
));
629 NDR_CHECK(ndr_push_array_uint8(ndr
, NDR_SCALARS
, namebuf
, namebuf_len
));
631 if ((namebuf_len
% 4) == 0) {
633 * [MS-WINSRA] — v20091104 was wrong
634 * regarding section "2.2.10.1 Name Record"
636 * If the name buffer is already 4 byte aligned
637 * Windows (at least 2003 SP1 and 2008) add 4 extra
638 * bytes. This can happen when the name has a scope.
640 NDR_CHECK(ndr_push_zero(ndr
, 4));
643 talloc_free(namebuf
);
644 return NDR_ERR_SUCCESS
;
647 _PUBLIC_
void ndr_print_wrepl_nbt_name(struct ndr_print
*ndr
, const char *name
, const struct nbt_name
*r
)
649 char *s
= nbt_name_string(ndr
, r
);
650 ndr_print_string(ndr
, name
, s
);
654 _PUBLIC_
enum ndr_err_code
ndr_push_nbt_res_rec(struct ndr_push
*ndr
, int ndr_flags
, const struct nbt_res_rec
*r
)
657 uint32_t _flags_save_STRUCT
= ndr
->flags
;
658 ndr_set_flags(&ndr
->flags
, LIBNDR_PRINT_ARRAY_HEX
);
659 if (ndr_flags
& NDR_SCALARS
) {
660 NDR_CHECK(ndr_push_align(ndr
, 4));
661 NDR_CHECK(ndr_push_nbt_name(ndr
, NDR_SCALARS
, &r
->name
));
662 NDR_CHECK(ndr_push_nbt_qtype(ndr
, NDR_SCALARS
, r
->rr_type
));
663 NDR_CHECK(ndr_push_nbt_qclass(ndr
, NDR_SCALARS
, r
->rr_class
));
664 NDR_CHECK(ndr_push_uint32(ndr
, NDR_SCALARS
, r
->ttl
));
665 NDR_CHECK(ndr_push_set_switch_value(ndr
, &r
->rdata
, ((((r
->rr_type
) == NBT_QTYPE_NETBIOS
) && ((r
->rdata
).data
.length
== 2))?0:r
->rr_type
)));
666 NDR_CHECK(ndr_push_nbt_rdata(ndr
, NDR_SCALARS
, &r
->rdata
));
668 if (ndr_flags
& NDR_BUFFERS
) {
670 ndr
->flags
= _flags_save_STRUCT
;
672 return NDR_ERR_SUCCESS
;