and so it begins....
[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 7
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         /* this is like GETGRENT but gives an empty group list */
103         WINBINDD_GETGRLST,
104
105         WINBINDD_NETBIOS_NAME,       /* The netbios name of the server */
106         /* Placeholder for end of cmd list */
107
108         /* find the location of our privileged pipe */
109         WINBINDD_PRIV_PIPE_DIR,
110
111         WINBINDD_NUM_CMDS
112 };
113
114 #define WBFLAG_PAM_INFO3_NDR            0x0001
115 #define WBFLAG_PAM_INFO3_TEXT           0x0002
116 #define WBFLAG_PAM_NTKEY                0x0004
117 #define WBFLAG_PAM_LMKEY                0x0008
118 #define WBFLAG_PAM_CONTACT_TRUSTDOM     0x0010
119 #define WBFLAG_QUERY_ONLY               0x0020
120
121 /* Winbind request structure */
122
123 struct winbindd_request {
124         uint32 length;
125         enum winbindd_cmd cmd;   /* Winbindd command to execute */
126         pid_t pid;               /* pid of calling process */
127         uint32 flags;            /* flags relavant to a given request */
128
129         union {
130                 fstring winsreq;     /* WINS request */
131                 fstring username;    /* getpwnam */
132                 fstring groupname;   /* getgrnam */
133                 uid_t uid;           /* getpwuid, uid_to_sid */
134                 gid_t gid;           /* getgrgid, gid_to_sid */
135                 struct {
136                         /* We deliberatedly don't split into domain/user to
137                            avoid having the client know what the separator
138                            character is. */     
139                         fstring user;
140                         fstring pass;
141                 } auth;              /* pam_winbind auth module */
142                 struct {
143                         unsigned char chal[8];
144                         fstring user;
145                         fstring domain;
146                         fstring lm_resp;
147                         uint16 lm_resp_len;
148                         fstring nt_resp;
149                         uint16 nt_resp_len;
150                         fstring workstation;
151                 } auth_crap;
152                 struct {
153                     fstring user;
154                     fstring oldpass;
155                     fstring newpass;
156                 } chauthtok;         /* pam_winbind passwd module */
157                 fstring sid;         /* lookupsid, sid_to_[ug]id */
158                 struct {
159                         fstring dom_name;       /* lookupname */
160                         fstring name;       
161                 } name;
162                 uint32 num_entries;  /* getpwent, getgrent */
163         } data;
164         char null_term;
165 };
166
167 /* Response values */
168
169 enum winbindd_result {
170         WINBINDD_ERROR,
171         WINBINDD_OK
172 };
173
174 /* Winbind response structure */
175
176 struct winbindd_response {
177     
178         /* Header information */
179
180         uint32 length;                        /* Length of response */
181         enum winbindd_result result;          /* Result code */
182
183         /* Fixed length return data */
184         
185         union {
186                 int interface_version;  /* Try to ensure this is always in the same spot... */
187                 
188                 fstring winsresp;               /* WINS response */
189
190                 /* getpwnam, getpwuid */
191                 
192                 struct winbindd_pw {
193                         fstring pw_name;
194                         fstring pw_passwd;
195                         uid_t pw_uid;
196                         gid_t pw_gid;
197                         fstring pw_gecos;
198                         fstring pw_dir;
199                         fstring pw_shell;
200                 } pw;
201
202                 /* getgrnam, getgrgid */
203
204                 struct winbindd_gr {
205                         fstring gr_name;
206                         fstring gr_passwd;
207                         gid_t gr_gid;
208                         int num_gr_mem;
209                         int gr_mem_ofs;   /* offset to group membership */
210                 } gr;
211
212                 uint32 num_entries; /* getpwent, getgrent */
213                 struct winbindd_sid {
214                         fstring sid;        /* lookupname, [ug]id_to_sid */
215                         int type;
216                 } sid;
217                 struct winbindd_name {
218                         fstring dom_name;       /* lookupsid */
219                         fstring name;       
220                         int type;
221                 } name;
222                 uid_t uid;          /* sid_to_uid */
223                 gid_t gid;          /* sid_to_gid */
224                 struct winbindd_info {
225                         char winbind_separator;
226                         fstring samba_version;
227                 } info;
228                 fstring domain_name;
229                 fstring netbios_name;
230
231                 struct auth_reply {
232                         uint32 nt_status;
233                         fstring nt_status_string;
234                         fstring error_string;
235                         int pam_error;
236                         char nt_session_key[16];
237                         char first_8_lm_hash[8];
238                 } auth;
239         } data;
240
241         /* Variable length return data */
242
243         void *extra_data;               /* getgrnam, getgrgid, getgrent */
244 };
245
246 #endif