as discussed on irc, this is a small patch that allows a few more
[sfrench/samba-autobuild/.git] / source3 / nsswitch / winbindd_nss.h
1 /* 
2    Unix SMB/CIFS implementation.
3
4    Winbind daemon for ntdom nss module
5
6    Copyright (C) Tim Potter 2000
7    
8    This library is free software; you can redistribute it and/or
9    modify it under the terms of the GNU Library General Public
10    License as published by the Free Software Foundation; either
11    version 2 of the License, or (at your option) any later version.
12    
13    This library 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 GNU
16    Library General Public License for more details.
17    
18    You should have received a copy of the GNU Library General Public
19    License along with this library; if not, write to the
20    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
21    Boston, MA  02111-1307, USA.   
22 */
23
24 #ifndef SAFE_FREE
25 #define SAFE_FREE(x) do { if(x) {free(x); x=NULL;} } while(0)
26 #endif
27
28 #ifndef _WINBINDD_NTDOM_H
29 #define _WINBINDD_NTDOM_H
30
31 #define WINBINDD_SOCKET_NAME "pipe"            /* Name of PF_UNIX socket */
32 #define WINBINDD_SOCKET_DIR  "/tmp/.winbindd"  /* Name of PF_UNIX dir */
33 #define WINBINDD_PRIV_SOCKET_SUBDIR "winbindd_privileged" /* name of subdirectory of lp_lockdir() to hold the 'privileged' pipe */
34 #define WINBINDD_DOMAIN_ENV  "WINBINDD_DOMAIN" /* Environment variables */
35 #define WINBINDD_DONT_ENV    "_NO_WINBINDD"
36
37 /* Update this when you change the interface.  */
38
39 #define WINBIND_INTERFACE_VERSION 8
40
41 /* Socket commands */
42
43 enum winbindd_cmd {
44
45         WINBINDD_INTERFACE_VERSION,    /* Always a well known value */
46
47         /* Get users and groups */
48
49         WINBINDD_GETPWNAM,
50         WINBINDD_GETPWUID,
51         WINBINDD_GETGRNAM,
52         WINBINDD_GETGRGID,
53         WINBINDD_GETGROUPS,
54
55         /* Enumerate users and groups */
56
57         WINBINDD_SETPWENT,
58         WINBINDD_ENDPWENT,
59         WINBINDD_GETPWENT,
60         WINBINDD_SETGRENT,
61         WINBINDD_ENDGRENT,
62         WINBINDD_GETGRENT,
63
64         /* PAM authenticate and password change */
65
66         WINBINDD_PAM_AUTH,
67         WINBINDD_PAM_AUTH_CRAP,
68         WINBINDD_PAM_CHAUTHTOK,
69
70         /* List various things */
71
72         WINBINDD_LIST_USERS,         /* List w/o rid->id mapping */
73         WINBINDD_LIST_GROUPS,        /* Ditto */
74         WINBINDD_LIST_TRUSTDOM,
75
76         /* SID conversion */
77
78         WINBINDD_LOOKUPSID,
79         WINBINDD_LOOKUPNAME,
80
81         /* Lookup functions */
82
83         WINBINDD_SID_TO_UID,       
84         WINBINDD_SID_TO_GID,
85         WINBINDD_UID_TO_SID,
86         WINBINDD_GID_TO_SID,
87
88         /* Miscellaneous other stuff */
89
90         WINBINDD_CHECK_MACHACC,     /* Check machine account pw works */
91         WINBINDD_PING,              /* Just tell me winbind is running */
92         WINBINDD_INFO,              /* Various bit of info.  Currently just tidbits */
93         WINBINDD_DOMAIN_NAME,       /* The domain this winbind server is a member of (lp_workgroup()) */
94
95         WINBINDD_SHOW_SEQUENCE, /* display sequence numbers of domains */
96
97         /* WINS commands */
98
99         WINBINDD_WINS_BYIP,
100         WINBINDD_WINS_BYNAME,
101
102         /* account management commands */
103
104         WINBINDD_CREATE_USER,
105         WINBINDD_CREATE_GROUP,
106         WINBINDD_ADD_USER_TO_GROUP,
107         WINBINDD_REMOVE_USER_FROM_GROUP,
108         WINBINDD_SET_USER_PRIMARY_GROUP,
109         WINBINDD_DELETE_USER,
110         WINBINDD_DELETE_GROUP,
111         
112         /* this is like GETGRENT but gives an empty group list */
113         WINBINDD_GETGRLST,
114
115         WINBINDD_NETBIOS_NAME,       /* The netbios name of the server */
116         /* Placeholder for end of cmd list */
117
118         /* find the location of our privileged pipe */
119         WINBINDD_PRIV_PIPE_DIR,
120
121         /* return a list of group sids for a user sid */
122         WINBINDD_GETUSERSIDS,   
123
124         WINBINDD_NUM_CMDS
125 };
126
127 typedef struct winbindd_pw {
128         fstring pw_name;
129         fstring pw_passwd;
130         uid_t pw_uid;
131         gid_t pw_gid;
132         fstring pw_gecos;
133         fstring pw_dir;
134         fstring pw_shell;
135 } WINBINDD_PW;
136
137
138 typedef struct winbindd_gr {
139         fstring gr_name;
140         fstring gr_passwd;
141         gid_t gr_gid;
142         int num_gr_mem;
143         int gr_mem_ofs;   /* offset to group membership */
144         char **gr_mem;
145 } WINBINDD_GR;
146
147
148 #define WBFLAG_PAM_INFO3_NDR            0x0001
149 #define WBFLAG_PAM_INFO3_TEXT           0x0002
150 #define WBFLAG_PAM_NTKEY                0x0004
151 #define WBFLAG_PAM_LMKEY                0x0008
152 #define WBFLAG_PAM_CONTACT_TRUSTDOM     0x0010
153 #define WBFLAG_QUERY_ONLY               0x0020
154 #define WBFLAG_ALLOCATE_RID             0x0040
155
156 /* Winbind request structure */
157
158 struct winbindd_request {
159         uint32 length;
160         enum winbindd_cmd cmd;   /* Winbindd command to execute */
161         pid_t pid;               /* pid of calling process */
162         uint32 flags;            /* flags relavant to a given request */
163         fstring domain_name;    /* name of domain for which the request applies */
164
165         union {
166                 fstring winsreq;     /* WINS request */
167                 fstring username;    /* getpwnam */
168                 fstring groupname;   /* getgrnam */
169                 uid_t uid;           /* getpwuid, uid_to_sid */
170                 gid_t gid;           /* getgrgid, gid_to_sid */
171                 struct {
172                         /* We deliberatedly don't split into domain/user to
173                            avoid having the client know what the separator
174                            character is. */     
175                         fstring user;
176                         fstring pass;
177                 } auth;              /* pam_winbind auth module */
178                 struct {
179                         unsigned char chal[8];
180                         fstring user;
181                         fstring domain;
182                         fstring lm_resp;
183                         uint16 lm_resp_len;
184                         fstring nt_resp;
185                         uint16 nt_resp_len;
186                         fstring workstation;
187                 } auth_crap;
188                 struct {
189                     fstring user;
190                     fstring oldpass;
191                     fstring newpass;
192                 } chauthtok;         /* pam_winbind passwd module */
193                 fstring sid;         /* lookupsid, sid_to_[ug]id */
194                 struct {
195                         fstring dom_name;       /* lookupname */
196                         fstring name;       
197                 } name;
198                 uint32 num_entries;  /* getpwent, getgrent */
199                 struct {
200                         fstring username;
201                         fstring groupname;
202                 } acct_mgt;
203         } data;
204         char null_term;
205 };
206
207 /* Response values */
208
209 enum winbindd_result {
210         WINBINDD_ERROR,
211         WINBINDD_OK
212 };
213
214 /* Winbind response structure */
215
216 struct winbindd_response {
217     
218         /* Header information */
219
220         uint32 length;                        /* Length of response */
221         enum winbindd_result result;          /* Result code */
222
223         /* Fixed length return data */
224         
225         union {
226                 int interface_version;  /* Try to ensure this is always in the same spot... */
227                 
228                 fstring winsresp;               /* WINS response */
229
230                 /* getpwnam, getpwuid */
231                 
232                 struct winbindd_pw pw;
233
234                 /* getgrnam, getgrgid */
235
236                 struct winbindd_gr gr;
237
238                 uint32 num_entries; /* getpwent, getgrent */
239                 struct winbindd_sid {
240                         fstring sid;        /* lookupname, [ug]id_to_sid */
241                         int type;
242                 } sid;
243                 struct winbindd_name {
244                         fstring dom_name;       /* lookupsid */
245                         fstring name;       
246                         int type;
247                 } name;
248                 uid_t uid;          /* sid_to_uid */
249                 gid_t gid;          /* sid_to_gid */
250                 struct winbindd_info {
251                         char winbind_separator;
252                         fstring samba_version;
253                 } info;
254                 fstring domain_name;
255                 fstring netbios_name;
256
257                 struct auth_reply {
258                         uint32 nt_status;
259                         fstring nt_status_string;
260                         fstring error_string;
261                         int pam_error;
262                         char nt_session_key[16];
263                         char first_8_lm_hash[8];
264                 } auth;
265                 uint32 rid;     /* create user or group */
266         } data;
267
268         /* Variable length return data */
269
270         void *extra_data;               /* getgrnam, getgrgid, getgrent */
271 };
272
273 #endif