5a7ba7b4012e4a5872ba4f1a8e816585d504632b
[kai/samba.git] / source4 / winbind / wb_server.h
1 /* 
2    Unix SMB/CIFS implementation.
3    Main winbindd server routines
4
5    Copyright (C) Stefan Metzmacher      2005
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 "nsswitch/winbind_nss_config.h"
23 #include "nsswitch/winbind_struct_protocol.h"
24 #include "winbind/idmap.h"
25 #include "libnet/libnet.h"
26
27 #define WINBINDD_SAMBA3_SOCKET "pipe"
28 /* the privileged socket is in smbd_tmp_dir() */
29 #define WINBINDD_SAMBA3_PRIVILEGED_SOCKET "winbind_pipe"
30
31 /* this struct stores global data for the winbind task */
32 struct wbsrv_service {
33         struct task_server *task;
34
35         const struct dom_sid *primary_sid;
36         struct wbsrv_domain *domains;
37         struct idmap_context *idmap_ctx;
38 };
39
40 struct wbsrv_samconn {
41         struct wbsrv_domain *domain;
42         void *private_data;
43
44         struct composite_context (*seqnum_send)(struct wbsrv_samconn *);
45         NTSTATUS (*seqnum_recv)(struct composite_context *, uint64_t *);
46 };
47
48 struct wb_dom_info {
49         const char *name;
50         const char *dns_name;
51         const struct dom_sid *sid;
52
53         int num_dcs;
54         struct nbt_dc_name *dcs;
55 };
56
57 struct wbsrv_domain {
58         struct wbsrv_domain *next, *prev;
59
60         struct wb_dom_info *info;
61
62         /* Details for the server we are currently talking to */
63         const char *dc_address;
64         const char *dc_name;
65
66         struct libnet_context *libnet_ctx;
67
68         struct dcerpc_binding *lsa_binding;
69
70         struct dcerpc_binding *samr_binding;
71
72         struct dcerpc_pipe *netlogon_pipe;
73         struct dcerpc_binding *netlogon_binding;
74 };
75
76 /*
77   state of a listen socket and it's protocol information
78 */
79 struct wbsrv_listen_socket {
80         const char *socket_path;
81         struct wbsrv_service *service;
82         bool privileged;
83 };
84
85 /*
86   state of an open winbind connection
87 */
88 struct wbsrv_connection {
89         /* stream connection we belong to */
90         struct stream_connection *conn;
91
92         /* the listening socket we belong to, it holds protocol hooks */
93         struct wbsrv_listen_socket *listen_socket;
94
95         /* storage for protocol specific data */
96         void *protocol_private_data;
97
98         /* how many calls are pending */
99         uint32_t pending_calls;
100
101         struct packet_context *packet;
102
103         struct loadparm_context *lp_ctx;
104 };
105
106 #define WBSRV_SAMBA3_SET_STRING(dest, src) do { \
107         safe_strcpy(dest, src, sizeof(dest)-1);\
108 } while(0)
109
110 /*
111   state of a pwent query
112 */
113 struct wbsrv_pwent {
114         /* Current UserList structure, contains 1+ user structs */
115         struct libnet_UserList *user_list;
116
117         /* Index of the next user struct in the current UserList struct */
118         uint32_t page_index;
119
120         /* The libnet_ctx to use for the libnet_UserList call */
121         struct libnet_context *libnet_ctx;
122 };
123
124 /*
125   state of one request
126
127   NOTE about async replies:
128    if the backend wants to reply later:
129
130    - it should set the WBSRV_CALL_FLAGS_REPLY_ASYNC flag, and may set a 
131      talloc_destructor on the this structure or on the private_data (if it's a
132      talloc child of this structure), so that wbsrv_terminate_connection
133      called by another call clean up the whole connection correct.
134    - When the backend is ready to reply it should call wbsrv_send_reply(call),
135      wbsrv_send_reply implies talloc_free(call), so the backend should use 
136      talloc_reference(call), if it needs it later. 
137    - If wbsrv_send_reply doesn't return NT_STATUS_OK, the backend function 
138      should call, wbsrv_terminate_connection(call->wbconn, nt_errstr(status));
139      return;
140
141 */
142 struct wbsrv_samba3_call {
143 #define WBSRV_CALL_FLAGS_REPLY_ASYNC 0x00000001
144         uint32_t flags;
145
146         /* the connection the call belongs to */
147         struct wbsrv_connection *wbconn;
148
149         /* the backend should use this event context */
150         struct event_context *event_ctx;
151
152         /* here the backend can store stuff like composite_context's ... */
153         void *private_data;
154
155         /* the request structure of the samba3 protocol */
156         struct winbindd_request request;
157         
158         /* the response structure of the samba3 protocol*/
159         struct winbindd_response response;
160 };
161
162 struct netr_LMSessionKey;
163 struct netr_UserSessionKey;
164 struct winbind_SamLogon;
165
166 #include "winbind/wb_async_helpers.h"
167 #include "winbind/wb_proto.h"