Large set of changes to add UNIX account/group management
[sfrench/samba-autobuild/.git] / source / 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         WINBINDD_NUM_CMDS
122 };
123
124 typedef struct winbindd_pw {
125         fstring pw_name;
126         fstring pw_passwd;
127         uid_t pw_uid;
128         gid_t pw_gid;
129         fstring pw_gecos;
130         fstring pw_dir;
131         fstring pw_shell;
132 } WINBINDD_PW;
133
134
135 typedef struct winbindd_gr {
136         fstring gr_name;
137         fstring gr_passwd;
138         gid_t gr_gid;
139         int num_gr_mem;
140         int gr_mem_ofs;   /* offset to group membership */
141         char **gr_mem;
142 } WINBINDD_GR;
143
144
145 #define WBFLAG_PAM_INFO3_NDR            0x0001
146 #define WBFLAG_PAM_INFO3_TEXT           0x0002
147 #define WBFLAG_PAM_NTKEY                0x0004
148 #define WBFLAG_PAM_LMKEY                0x0008
149 #define WBFLAG_PAM_CONTACT_TRUSTDOM     0x0010
150 #define WBFLAG_QUERY_ONLY               0x0020
151
152 /* Winbind request structure */
153
154 struct winbindd_request {
155         uint32 length;
156         enum winbindd_cmd cmd;   /* Winbindd command to execute */
157         pid_t pid;               /* pid of calling process */
158         uint32 flags;            /* flags relavant to a given request */
159
160         union {
161                 fstring winsreq;     /* WINS request */
162                 fstring username;    /* getpwnam */
163                 fstring groupname;   /* getgrnam */
164                 uid_t uid;           /* getpwuid, uid_to_sid */
165                 gid_t gid;           /* getgrgid, gid_to_sid */
166                 struct {
167                         /* We deliberatedly don't split into domain/user to
168                            avoid having the client know what the separator
169                            character is. */     
170                         fstring user;
171                         fstring pass;
172                 } auth;              /* pam_winbind auth module */
173                 struct {
174                         unsigned char chal[8];
175                         fstring user;
176                         fstring domain;
177                         fstring lm_resp;
178                         uint16 lm_resp_len;
179                         fstring nt_resp;
180                         uint16 nt_resp_len;
181                         fstring workstation;
182                 } auth_crap;
183                 struct {
184                     fstring user;
185                     fstring oldpass;
186                     fstring newpass;
187                 } chauthtok;         /* pam_winbind passwd module */
188                 fstring sid;         /* lookupsid, sid_to_[ug]id */
189                 struct {
190                         fstring dom_name;       /* lookupname */
191                         fstring name;       
192                 } name;
193                 uint32 num_entries;  /* getpwent, getgrent */
194                 struct {
195                         fstring username;
196                         fstring groupname;
197                 } acct_mgt;
198         } data;
199         char null_term;
200 };
201
202 /* Response values */
203
204 enum winbindd_result {
205         WINBINDD_ERROR,
206         WINBINDD_OK
207 };
208
209 /* Winbind response structure */
210
211 struct winbindd_response {
212     
213         /* Header information */
214
215         uint32 length;                        /* Length of response */
216         enum winbindd_result result;          /* Result code */
217
218         /* Fixed length return data */
219         
220         union {
221                 int interface_version;  /* Try to ensure this is always in the same spot... */
222                 
223                 fstring winsresp;               /* WINS response */
224
225                 /* getpwnam, getpwuid */
226                 
227                 struct winbindd_pw pw;
228
229                 /* getgrnam, getgrgid */
230
231                 struct winbindd_gr gr;
232
233                 uint32 num_entries; /* getpwent, getgrent */
234                 struct winbindd_sid {
235                         fstring sid;        /* lookupname, [ug]id_to_sid */
236                         int type;
237                 } sid;
238                 struct winbindd_name {
239                         fstring dom_name;       /* lookupsid */
240                         fstring name;       
241                         int type;
242                 } name;
243                 uid_t uid;          /* sid_to_uid */
244                 gid_t gid;          /* sid_to_gid */
245                 struct winbindd_info {
246                         char winbind_separator;
247                         fstring samba_version;
248                 } info;
249                 fstring domain_name;
250                 fstring netbios_name;
251
252                 struct auth_reply {
253                         uint32 nt_status;
254                         fstring nt_status_string;
255                         fstring error_string;
256                         int pam_error;
257                         char nt_session_key[16];
258                         char first_8_lm_hash[8];
259                 } auth;
260         } data;
261
262         /* Variable length return data */
263
264         void *extra_data;               /* getgrnam, getgrgid, getgrent */
265 };
266
267 #endif