source4/libcli/dgram/libdgram.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    a raw async NBT DGRAM library
   5
   6    Copyright (C) Andrew Tridgell 2005
   7
   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.
  12
  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.
  17
  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/>.
  20 */
  21
  22 #include "../libcli/netlogon/netlogon.h"
  23
  24 /*
  25   a datagram name request
  26 */
  27 struct nbt_dgram_request {
  28         struct nbt_dgram_request *next, *prev;
  29
  30         /* where to send the request */
  31         struct socket_address *dest;
  32
  33         /* the encoded request */
  34         DATA_BLOB encoded;
  35 };
  36
  37 /*
  38   context structure for operations on dgram packets
  39 */
  40 struct nbt_dgram_socket {
  41         struct socket_context *sock;
  42         struct tevent_context *event_ctx;
  43
  44         /* the fd event */
  45         struct tevent_fd *fde;
  46
  47         /* a queue of outgoing requests */
  48         struct nbt_dgram_request *send_queue;
  49
  50         /* a list of mailslot handlers */
  51         struct dgram_mailslot_handler *mailslot_handlers;
  52
  53         /* what to do with incoming request packets */
  54         struct {
  55                 void (*handler)(struct nbt_dgram_socket *, struct nbt_dgram_packet *,
  56                                 struct socket_address *src);
  57                 void *private_data;
  58         } incoming;
  59 };
  60
  61
  62 /*
  63   the mailslot code keeps a list of mailslot handlers. A mailslot
  64   handler is a function that receives incoming packets for a specific
  65   mailslot name. When a caller needs to send a mailslot and wants to
  66   get a reply then it needs to register itself as listening for
  67   incoming packets on the reply mailslot
  68 */
  69
  70 typedef void (*dgram_mailslot_handler_t)(struct dgram_mailslot_handler *,
  71                                          struct nbt_dgram_packet *,
  72                                          struct socket_address *src);
  73
  74 struct dgram_mailslot_handler {
  75         struct dgram_mailslot_handler *next, *prev;
  76
  77         struct nbt_dgram_socket *dgmsock;
  78         const char *mailslot_name;
  79
  80         dgram_mailslot_handler_t handler;
  81         void *private_data;
  82 };
  83
  84
  85 /* prototypes */
  86 NTSTATUS nbt_dgram_send_raw(struct nbt_dgram_socket *dgmsock,
  87                             struct socket_address *dest,
  88                             const DATA_BLOB pkt_blob);
  89 NTSTATUS nbt_dgram_send(struct nbt_dgram_socket *dgmsock,
  90                         struct nbt_dgram_packet *packet,
  91                         struct socket_address *dest);
  92 NTSTATUS dgram_set_incoming_handler(struct nbt_dgram_socket *dgmsock,
  93                                     void (*handler)(struct nbt_dgram_socket *,
  94                                                     struct nbt_dgram_packet *,
  95                                                     struct socket_address *),
  96                                     void *private_data);
  97 struct nbt_dgram_socket *nbt_dgram_socket_init(TALLOC_CTX *mem_ctx,
  98                                                struct tevent_context *event_ctx);
  99
 100 const char *dgram_mailslot_name(struct nbt_dgram_packet *packet);
 101 struct dgram_mailslot_handler *dgram_mailslot_find(struct nbt_dgram_socket *dgmsock,
 102                                                    const char *mailslot_name);
 103 struct dgram_mailslot_handler *dgram_mailslot_listen(struct nbt_dgram_socket *dgmsock,
 104                                                      const char *mailslot_name,
 105                                                      dgram_mailslot_handler_t handler,
 106                                                      void *private_data);
 107 struct dgram_mailslot_handler *dgram_mailslot_temp(struct nbt_dgram_socket *dgmsock,
 108                                                    const char *mailslot_name,
 109                                                    dgram_mailslot_handler_t handler,
 110                                                    void *private_data);
 111 DATA_BLOB dgram_mailslot_data(struct nbt_dgram_packet *dgram);
 112
 113
 114 NTSTATUS dgram_mailslot_send(struct nbt_dgram_socket *dgmsock,
 115                              enum dgram_msg_type msg_type,
 116                              const char *mailslot_name,
 117                              struct nbt_name *dest_name,
 118                              struct socket_address *dest,
 119                              struct nbt_name *src_name,
 120                              DATA_BLOB *request);
 121
 122 NTSTATUS dgram_mailslot_netlogon_send(struct nbt_dgram_socket *dgmsock,
 123                                       struct nbt_name *dest_name,
 124                                       struct socket_address *dest,
 125                                       const char *mailslot_name,
 126                                       struct nbt_name *src_name,
 127                                       struct nbt_netlogon_packet *request);
 128 NTSTATUS dgram_mailslot_netlogon_reply(struct nbt_dgram_socket *dgmsock,
 129                                        struct nbt_dgram_packet *request,
 130                                        const char *my_netbios_name,
 131                                        const char *mailslot_name,
 132                                        struct nbt_netlogon_response *reply);
 133 NTSTATUS dgram_mailslot_netlogon_parse_request(TALLOC_CTX *mem_ctx,
 134                                                struct nbt_dgram_packet *dgram,
 135                                                struct nbt_netlogon_packet *netlogon);
 136
 137 NTSTATUS dgram_mailslot_netlogon_parse_response(TALLOC_CTX *mem_ctx,
 138                                                 struct nbt_dgram_packet *dgram,
 139                                                 struct nbt_netlogon_response *netlogon);
 140
 141 NTSTATUS dgram_mailslot_browse_send(struct nbt_dgram_socket *dgmsock,
 142                                     struct nbt_name *dest_name,
 143                                     struct socket_address *dest,
 144                                     struct nbt_name *src_name,
 145                                     struct nbt_browse_packet *request);
 146
 147 NTSTATUS dgram_mailslot_browse_reply(struct nbt_dgram_socket *dgmsock,
 148                                      struct nbt_dgram_packet *request,
 149                                      const char *mailslot_name,
 150                                      const char *my_netbios_name,
 151                                      struct nbt_browse_packet *reply);
 152
 153 NTSTATUS dgram_mailslot_browse_parse(struct dgram_mailslot_handler *dgmslot,
 154                                      TALLOC_CTX *mem_ctx,
 155                                      struct nbt_dgram_packet *dgram,
 156                                      struct nbt_browse_packet *pkt);