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         const char *priv_socket_path;
  40 };
  41
  42 struct wbsrv_samconn {
  43         struct wbsrv_domain *domain;
  44         void *private_data;
  45
  46         struct composite_context (*seqnum_send)(struct wbsrv_samconn *);
  47         NTSTATUS (*seqnum_recv)(struct composite_context *, uint64_t *);
  48 };
  49
  50 struct wb_dom_info {
  51         const char *name;
  52         const char *dns_name;
  53         const struct dom_sid *sid;
  54
  55         int num_dcs;
  56         struct nbt_dc_name *dcs;
  57 };
  58
  59 struct wbsrv_domain {
  60         struct wbsrv_domain *next, *prev;
  61
  62         struct wb_dom_info *info;
  63
  64         /* Details for the server we are currently talking to */
  65         const char *dc_address;
  66         const char *dc_name;
  67
  68         struct libnet_context *libnet_ctx;
  69
  70         struct dcerpc_binding *lsa_binding;
  71
  72         struct dcerpc_binding *samr_binding;
  73
  74         struct dcerpc_pipe *netlogon_pipe;
  75         struct dcerpc_binding *netlogon_binding;
  76 };
  77
  78 /*
  79   state of a listen socket and it's protocol information
  80 */
  81 struct wbsrv_listen_socket {
  82         const char *socket_path;
  83         struct wbsrv_service *service;
  84         bool privileged;
  85 };
  86
  87 /*
  88   state of an open winbind connection
  89 */
  90 struct wbsrv_connection {
  91         /* stream connection we belong to */
  92         struct stream_connection *conn;
  93
  94         /* the listening socket we belong to, it holds protocol hooks */
  95         struct wbsrv_listen_socket *listen_socket;
  96
  97         /* storage for protocol specific data */
  98         void *protocol_private_data;
  99
 100         /* how many calls are pending */
 101         uint32_t pending_calls;
 102
 103         struct tstream_context *tstream;
 104
 105         struct tevent_queue *send_queue;
 106
 107         struct loadparm_context *lp_ctx;
 108 };
 109
 110 #define WBSRV_SAMBA3_SET_STRING(dest, src) do { \
 111         safe_strcpy(dest, src, sizeof(dest)-1);\
 112 } while(0)
 113
 114 /*
 115   state of a pwent query
 116 */
 117 struct wbsrv_pwent {
 118         /* Current UserList structure, contains 1+ user structs */
 119         struct libnet_UserList *user_list;
 120
 121         /* Index of the next user struct in the current UserList struct */
 122         uint32_t page_index;
 123
 124         /* The libnet_ctx to use for the libnet_UserList call */
 125         struct libnet_context *libnet_ctx;
 126 };
 127 /*
 128   state of a grent query
 129 */
 130 struct wbsrv_grent {
 131         /* Current UserList structure, contains 1+ user structs */
 132         struct libnet_GroupList *group_list;
 133
 134         /* Index of the next user struct in the current UserList struct */
 135         uint32_t page_index;
 136
 137         /* The libnet_ctx to use for the libnet_UserList call */
 138         struct libnet_context *libnet_ctx;
 139 };
 140
 141 /*
 142   state of one request
 143
 144   NOTE about async replies:
 145    if the backend wants to reply later:
 146
 147    - it should set the WBSRV_CALL_FLAGS_REPLY_ASYNC flag, and may set a
 148      talloc_destructor on the this structure or on the private_data (if it's a
 149      talloc child of this structure), so that wbsrv_terminate_connection
 150      called by another call clean up the whole connection correct.
 151    - When the backend is ready to reply it should call wbsrv_send_reply(call),
 152      wbsrv_send_reply implies talloc_free(call), so the backend should use
 153      talloc_reference(call), if it needs it later.
 154    - If wbsrv_send_reply doesn't return NT_STATUS_OK, the backend function
 155      should call, wbsrv_terminate_connection(call->wbconn, nt_errstr(status));
 156      return;
 157
 158 */
 159 struct wbsrv_samba3_call {
 160 #define WBSRV_CALL_FLAGS_REPLY_ASYNC 0x00000001
 161         uint32_t flags;
 162
 163         /* the connection the call belongs to */
 164         struct wbsrv_connection *wbconn;
 165
 166         /* here the backend can store stuff like composite_context's ... */
 167         void *private_data;
 168
 169         /* the request structure of the samba3 protocol */
 170         struct winbindd_request request;
 171
 172         /* the response structure of the samba3 protocol*/
 173         struct winbindd_response response;
 174
 175         DATA_BLOB in;
 176         DATA_BLOB out;
 177         struct iovec out_iov[1];
 178 };
 179
 180 struct netr_LMSessionKey;
 181 struct netr_UserSessionKey;
 182 struct winbind_SamLogon;
 183
 184 #include "winbind/wb_async_helpers.h"
 185 #include "winbind/wb_proto.h"