7a222e06524a8c015dc5fe38bc44409cd8d4f0fb
[bbaumbach/samba-autobuild/.git] / source4 / libcli / cldap / cldap.h
1 /*
2    Unix SMB/CIFS implementation.
3
4    a async CLDAP 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 "lib/util/asn1.h"
23 #include "librpc/gen_ndr/nbt.h"
24
25 struct ldap_message;
26
27 enum cldap_request_state {CLDAP_REQUEST_SEND, 
28                           CLDAP_REQUEST_WAIT, 
29                           CLDAP_REQUEST_DONE,
30                           CLDAP_REQUEST_ERROR};
31
32 /*
33   a cldap request packet
34 */
35 struct cldap_request {
36         struct cldap_request *next, *prev;
37
38         struct cldap_socket *cldap;
39
40         enum cldap_request_state state;
41         NTSTATUS status;
42
43         /* where to send the request */
44         struct socket_address *dest;
45
46         /* timeout between retries (seconds) */
47         int timeout;
48         int num_retries;
49
50         bool is_reply;
51
52         /* the ldap message_id */
53         int message_id;
54
55         struct timed_event *te;
56
57         /* the encoded request */
58         DATA_BLOB encoded;
59
60         /* the reply data */
61         struct asn1_data *asn1;
62
63         /* information on what to do on completion */
64         struct {
65                 void (*fn)(struct cldap_request *);
66                 void *private;
67         } async;
68 };
69
70 /*
71   context structure for operations on cldap packets
72 */
73 struct cldap_socket {
74         struct socket_context *sock;
75         struct event_context *event_ctx;
76
77         /* the fd event */
78         struct fd_event *fde;
79
80         /* a queue of outgoing requests */
81         struct cldap_request *send_queue;
82
83         /* mapping from message_id to pending request */
84         struct idr_context *idr;
85
86         /* what to do with incoming request packets */
87         struct {
88                 void (*handler)(struct cldap_socket *, struct ldap_message *, 
89                                 struct socket_address *);
90                 void *private;
91         } incoming;
92 };
93
94
95 /*
96  a general cldap search request  
97 */
98 struct cldap_search {
99         struct {
100                 const char *dest_address;
101                 uint16_t dest_port;
102                 const char *filter;
103                 const char **attributes;
104                 int timeout;
105                 int retries;
106         } in;
107         struct {
108                 struct ldap_SearchResEntry *response;
109                 struct ldap_Result         *result;
110         } out;
111 };
112
113 struct cldap_socket *cldap_socket_init(TALLOC_CTX *mem_ctx, 
114                                        struct event_context *event_ctx);
115 NTSTATUS cldap_set_incoming_handler(struct cldap_socket *cldap,
116                                     void (*handler)(struct cldap_socket *, struct ldap_message *, 
117                                                     struct socket_address *),
118                                     void *private);
119 struct cldap_request *cldap_search_send(struct cldap_socket *cldap, 
120                                         struct cldap_search *io);
121 NTSTATUS cldap_search_recv(struct cldap_request *req, TALLOC_CTX *mem_ctx, 
122                            struct cldap_search *io);
123 NTSTATUS cldap_search(struct cldap_socket *cldap, TALLOC_CTX *mem_ctx, 
124                       struct cldap_search *io);
125
126
127 /*
128   a general cldap reply
129 */
130 struct cldap_reply {
131         uint32_t messageid;
132         struct socket_address *dest;
133         struct ldap_SearchResEntry *response;
134         struct ldap_Result         *result;
135 };
136
137 NTSTATUS cldap_reply_send(struct cldap_socket *cldap, struct cldap_reply *io);
138
139 NTSTATUS cldap_empty_reply(struct cldap_socket *cldap, 
140                            uint32_t message_id,
141                            struct socket_address *src);
142 NTSTATUS cldap_error_reply(struct cldap_socket *cldap, 
143                            uint32_t message_id,
144                            struct socket_address *src,
145                            int resultcode,
146                            const char *errormessage);
147
148 /*
149   a netlogon cldap request  
150 */
151 struct cldap_netlogon {
152         struct {
153                 const char *dest_address;
154                 uint16_t dest_port;
155                 const char *realm;
156                 const char *host;
157                 const char *user;
158                 const char *domain_guid;
159                 const char *domain_sid;
160                 int acct_control;
161                 uint32_t version;
162         } in;
163         struct {
164                 union nbt_cldap_netlogon netlogon;
165         } out;
166 };
167
168 struct cldap_request *cldap_netlogon_send(struct cldap_socket *cldap, 
169                                           struct cldap_netlogon *io);
170 NTSTATUS cldap_netlogon_recv(struct cldap_request *req, 
171                              TALLOC_CTX *mem_ctx, 
172                              struct cldap_netlogon *io);
173 NTSTATUS cldap_netlogon(struct cldap_socket *cldap, 
174                         TALLOC_CTX *mem_ctx, struct cldap_netlogon *io);
175 NTSTATUS cldap_netlogon_reply(struct cldap_socket *cldap, 
176                               uint32_t message_id,
177                               struct socket_address *src,
178                               uint32_t version,
179                               union nbt_cldap_netlogon *netlogon);