2 Unix SMB/CIFS implementation.
4 a raw async NBT library
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/>.
25 #include "librpc/gen_ndr/nbt.h"
26 #include "librpc/ndr/libndr.h"
29 possible states for pending requests
31 enum nbt_request_state
{NBT_REQUEST_SEND
,
40 struct nbt_name_request
{
41 struct nbt_name_request
*next
, *prev
;
43 enum nbt_request_state state
;
47 /* the socket this was on */
48 struct nbt_name_socket
*nbtsock
;
50 /* where to send the request */
51 struct socket_address
*dest
;
53 /* timeout between retries */
56 /* how many retries to send on timeout */
59 /* whether we have received a WACK */
62 /* the timeout event */
63 struct timed_event
*te
;
65 /* the name transaction id */
71 /* the encoded request */
74 /* shall we allow multiple replies? */
75 bool allow_multiple_replies
;
77 unsigned int num_replies
;
78 struct nbt_name_reply
{
79 struct nbt_name_packet
*packet
;
80 struct socket_address
*dest
;
83 /* information on what to do on completion */
85 void (*fn
)(struct nbt_name_request
*);
93 context structure for operations on name queries
95 struct nbt_name_socket
{
96 struct socket_context
*sock
;
97 struct event_context
*event_ctx
;
99 struct smb_iconv_convenience *iconv_convenience;
101 /* a queue of requests pending to be sent */
102 struct nbt_name_request
*send_queue
;
105 struct fd_event
*fde
;
107 /* mapping from name_trn_id to pending event */
108 struct idr_context
*idr
;
110 /* how many requests are waiting for a reply */
111 uint16_t num_pending
;
113 /* what to do with incoming request packets */
115 void (*handler
)(struct nbt_name_socket
*, struct nbt_name_packet
*,
116 struct socket_address
*);
120 /* what to do with unexpected replies */
122 void (*handler
)(struct nbt_name_socket
*, struct nbt_name_packet
*,
123 struct socket_address
*);
129 /* a simple name query */
130 struct nbt_name_query
{
132 struct nbt_name name
;
133 const char *dest_addr
;
137 int timeout
; /* in seconds */
141 const char *reply_from
;
142 struct nbt_name name
;
144 const char **reply_addrs
;
148 /* a simple name status query */
149 struct nbt_name_status
{
151 struct nbt_name name
;
152 const char *dest_addr
;
154 int timeout
; /* in seconds */
158 const char *reply_from
;
159 struct nbt_name name
;
160 struct nbt_rdata_status status
;
164 /* a name registration request */
165 struct nbt_name_register
{
167 struct nbt_name name
;
168 const char *dest_addr
;
172 bool register_demand
;
176 int timeout
; /* in seconds */
180 const char *reply_from
;
181 struct nbt_name name
;
182 const char *reply_addr
;
187 /* a send 3 times then demand name broadcast name registration */
188 struct nbt_name_register_bcast
{
190 struct nbt_name name
;
191 const char *dest_addr
;
200 /* wins name register with multiple wins servers to try and multiple
201 addresses to register */
202 struct nbt_name_register_wins
{
204 struct nbt_name name
;
205 const char **wins_servers
;
207 const char **addresses
;
212 const char *wins_server
;
219 /* a name refresh request */
220 struct nbt_name_refresh
{
222 struct nbt_name name
;
223 const char *dest_addr
;
229 int timeout
; /* in seconds */
233 const char *reply_from
;
234 struct nbt_name name
;
235 const char *reply_addr
;
240 /* wins name refresh with multiple wins servers to try and multiple
241 addresses to register */
242 struct nbt_name_refresh_wins
{
244 struct nbt_name name
;
245 const char **wins_servers
;
247 const char **addresses
;
252 const char *wins_server
;
258 /* a name release request */
259 struct nbt_name_release
{
261 struct nbt_name name
;
262 const char *dest_addr
;
267 int timeout
; /* in seconds */
271 const char *reply_from
;
272 struct nbt_name name
;
273 const char *reply_addr
;
278 struct nbt_name_socket
*nbt_name_socket_init(TALLOC_CTX
*mem_ctx
,
279 struct event_context
*event_ctx
);
281 struct smb_iconv_convenience *iconv_convenience);*/
282 struct nbt_name_request
*nbt_name_query_send(struct nbt_name_socket
*nbtsock
,
283 struct nbt_name_query
*io
);
284 NTSTATUS
nbt_name_query_recv(struct nbt_name_request
*req
,
285 TALLOC_CTX
*mem_ctx
, struct nbt_name_query
*io
);
286 NTSTATUS
nbt_name_query(struct nbt_name_socket
*nbtsock
,
287 TALLOC_CTX
*mem_ctx
, struct nbt_name_query
*io
);
288 struct nbt_name_request
*nbt_name_status_send(struct nbt_name_socket
*nbtsock
,
289 struct nbt_name_status
*io
);
290 NTSTATUS
nbt_name_status_recv(struct nbt_name_request
*req
,
291 TALLOC_CTX
*mem_ctx
, struct nbt_name_status
*io
);
292 NTSTATUS
nbt_name_status(struct nbt_name_socket
*nbtsock
,
293 TALLOC_CTX
*mem_ctx
, struct nbt_name_status
*io
);
295 NTSTATUS
nbt_name_dup(TALLOC_CTX
*mem_ctx
, struct nbt_name
*name
, struct nbt_name
*newname
);
296 NTSTATUS
nbt_name_to_blob(TALLOC_CTX
*mem_ctx
, DATA_BLOB
*blob
, struct nbt_name
*name
);
297 NTSTATUS
nbt_name_from_blob(TALLOC_CTX
*mem_ctx
, const DATA_BLOB
*blob
, struct nbt_name
*name
);
298 void nbt_choose_called_name(TALLOC_CTX
*mem_ctx
, struct nbt_name
*n
, const char *name
, int type
);
299 char *nbt_name_string(TALLOC_CTX
*mem_ctx
, const struct nbt_name
*name
);
300 NTSTATUS
nbt_name_register(struct nbt_name_socket
*nbtsock
,
301 TALLOC_CTX
*mem_ctx
, struct nbt_name_register
*io
);
302 NTSTATUS
nbt_name_refresh(struct nbt_name_socket
*nbtsock
,
303 TALLOC_CTX
*mem_ctx
, struct nbt_name_refresh
*io
);
304 NTSTATUS
nbt_name_release(struct nbt_name_socket
*nbtsock
,
305 TALLOC_CTX
*mem_ctx
, struct nbt_name_release
*io
);
306 NTSTATUS
nbt_name_register_wins(struct nbt_name_socket
*nbtsock
,
308 struct nbt_name_register_wins
*io
);
309 NTSTATUS
nbt_name_refresh_wins(struct nbt_name_socket
*nbtsock
,
311 struct nbt_name_refresh_wins
*io
);
312 NTSTATUS
nbt_name_register_recv(struct nbt_name_request
*req
,
313 TALLOC_CTX
*mem_ctx
, struct nbt_name_register
*io
);
314 struct nbt_name_request
*nbt_name_register_send(struct nbt_name_socket
*nbtsock
,
315 struct nbt_name_register
*io
);
316 NTSTATUS
nbt_name_release_recv(struct nbt_name_request
*req
,
317 TALLOC_CTX
*mem_ctx
, struct nbt_name_release
*io
);
319 struct nbt_name_request
*nbt_name_release_send(struct nbt_name_socket
*nbtsock
,
320 struct nbt_name_release
*io
);
322 NTSTATUS
nbt_name_refresh_recv(struct nbt_name_request
*req
,
323 TALLOC_CTX
*mem_ctx
, struct nbt_name_refresh
*io
);
325 NTSTATUS
nbt_set_incoming_handler(struct nbt_name_socket
*nbtsock
,
326 void (*handler
)(struct nbt_name_socket
*, struct nbt_name_packet
*,
327 struct socket_address
*),
329 NTSTATUS
nbt_name_reply_send(struct nbt_name_socket
*nbtsock
,
330 struct socket_address
*dest
,
331 struct nbt_name_packet
*request
);
334 NDR_SCALAR_PROTO(wrepl_nbt_name
, const struct nbt_name
*);
335 NDR_SCALAR_PROTO(nbt_string
, const char *);
336 NDR_BUFFER_PROTO(nbt_name
, struct nbt_name
);
337 NTSTATUS
nbt_rcode_to_ntstatus(uint8_t rcode
);
339 struct composite_context
;
340 struct composite_context
*nbt_name_register_bcast_send(struct nbt_name_socket
*nbtsock
,
341 struct nbt_name_register_bcast
*io
);
342 NTSTATUS
nbt_name_register_bcast_recv(struct composite_context
*c
);
343 struct composite_context
*nbt_name_register_wins_send(struct nbt_name_socket
*nbtsock
,
344 struct nbt_name_register_wins
*io
);
345 NTSTATUS
nbt_name_refresh_wins_recv(struct composite_context
*c
, TALLOC_CTX
*mem_ctx
,
346 struct nbt_name_refresh_wins
*io
);
347 struct composite_context
*nbt_name_refresh_wins_send(struct nbt_name_socket
*nbtsock
,
348 struct nbt_name_refresh_wins
*io
);
349 NTSTATUS
nbt_name_register_wins_recv(struct composite_context
*c
, TALLOC_CTX
*mem_ctx
,
350 struct nbt_name_register_wins
*io
);
353 #endif /* __LIBNBT_H__ */