3 Copyright Andrew Tridgell <tridge@samba.org> 2000
4 Copyright Tim Potter <tpot@samba.org> 2000
5 Copyright Andrew Bartlett <abartlet@samba.org> 2002
6 Copyright Guenther Deschner <gd@samba.org> 2005-2007
8 largely based on pam_userdb by Cristian Gafton <gafton@redhat.com> also
9 contains large slabs of code from pam_unix by Elliot Lee
10 <sopwith@redhat.com> (see copyright below for full details)
13 #include "pam_winbind.h"
15 #define _PAM_LOG_FUNCTION_ENTER(function, pamh, ctrl, flags) \
17 _pam_log_debug(pamh, ctrl, LOG_DEBUG, "[pamh: %p] ENTER: " \
18 function " (flags: 0x%04x)", pamh, flags); \
19 _pam_log_state(pamh, ctrl); \
22 #define _PAM_LOG_FUNCTION_LEAVE(function, pamh, ctrl, retval) \
24 _pam_log_debug(pamh, ctrl, LOG_DEBUG, "[pamh: %p] LEAVE: " \
25 function " returning %d", pamh, retval); \
26 _pam_log_state(pamh, ctrl); \
31 #define MAX_PASSWD_TRIES 3
34 * Work around the pam API that has functions with void ** as parameters
35 * These lead to strict aliasing warnings with gcc.
37 static int _pam_get_item(const pam_handle_t *pamh,
41 const void **item = (const void **)_item;
42 return pam_get_item(pamh, item_type, item);
44 static int _pam_get_data(const pam_handle_t *pamh,
45 const char *module_data_name,
48 const void **data = (const void **)_data;
49 return pam_get_data(pamh, module_data_name, data);
54 #ifdef HAVE_PAM_VSYSLOG
55 static void _pam_log_int(const pam_handle_t *pamh,
60 pam_vsyslog(pamh, err, format, args);
63 static void _pam_log_int(const pam_handle_t *pamh,
71 _pam_get_item(pamh, PAM_SERVICE, &service);
73 format2 = (char *)malloc(strlen(MODULE_NAME)+strlen(format)+strlen(service)+5);
74 if (format2 == NULL) {
75 /* what else todo ? */
76 vsyslog(err, format, args);
80 sprintf(format2, "%s(%s): %s", MODULE_NAME, service, format);
81 vsyslog(err, format2, args);
84 #endif /* HAVE_PAM_VSYSLOG */
86 static bool _pam_log_is_silent(int ctrl)
88 return on(ctrl, WINBIND_SILENT);
91 static void _pam_log(const pam_handle_t *pamh, int ctrl, int err, const char *format, ...) PRINTF_ATTRIBUTE(4,5);
92 static void _pam_log(const pam_handle_t *pamh, int ctrl, int err, const char *format, ...)
96 if (_pam_log_is_silent(ctrl)) {
100 va_start(args, format);
101 _pam_log_int(pamh, err, format, args);
105 static bool _pam_log_is_debug_enabled(int ctrl)
111 if (_pam_log_is_silent(ctrl)) {
115 if (!(ctrl & WINBIND_DEBUG_ARG)) {
122 static bool _pam_log_is_debug_state_enabled(int ctrl)
124 if (!(ctrl & WINBIND_DEBUG_STATE)) {
128 return _pam_log_is_debug_enabled(ctrl);
131 static void _pam_log_debug(const pam_handle_t *pamh, int ctrl, int err, const char *format, ...) PRINTF_ATTRIBUTE(4,5);
132 static void _pam_log_debug(const pam_handle_t *pamh, int ctrl, int err, const char *format, ...)
136 if (!_pam_log_is_debug_enabled(ctrl)) {
140 va_start(args, format);
141 _pam_log_int(pamh, err, format, args);
145 static void _pam_log_state_datum(const pam_handle_t *pamh,
151 const void *data = NULL;
152 if (item_type != 0) {
153 pam_get_item(pamh, item_type, &data);
155 pam_get_data(pamh, key, &data);
158 const char *type = (item_type != 0) ? "ITEM" : "DATA";
159 if (is_string != 0) {
160 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
161 "[pamh: %p] STATE: %s(%s) = \"%s\" (%p)",
162 pamh, type, key, (const char *)data,
165 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
166 "[pamh: %p] STATE: %s(%s) = %p",
167 pamh, type, key, data);
172 #define _PAM_LOG_STATE_DATA_POINTER(pamh, ctrl, module_data_name) \
173 _pam_log_state_datum(pamh, ctrl, 0, module_data_name, 0)
175 #define _PAM_LOG_STATE_DATA_STRING(pamh, ctrl, module_data_name) \
176 _pam_log_state_datum(pamh, ctrl, 0, module_data_name, 1)
178 #define _PAM_LOG_STATE_ITEM_POINTER(pamh, ctrl, item_type) \
179 _pam_log_state_datum(pamh, ctrl, item_type, #item_type, 0)
181 #define _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, item_type) \
182 _pam_log_state_datum(pamh, ctrl, item_type, #item_type, 1)
184 #ifdef DEBUG_PASSWORD
185 #define _LOG_PASSWORD_AS_STRING 1
187 #define _LOG_PASSWORD_AS_STRING 0
190 #define _PAM_LOG_STATE_ITEM_PASSWORD(pamh, ctrl, item_type) \
191 _pam_log_state_datum(pamh, ctrl, item_type, #item_type, \
192 _LOG_PASSWORD_AS_STRING)
194 static void _pam_log_state(const pam_handle_t *pamh, int ctrl)
196 if (!_pam_log_is_debug_state_enabled(ctrl)) {
200 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_SERVICE);
201 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_USER);
202 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_TTY);
203 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_RHOST);
204 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_RUSER);
205 _PAM_LOG_STATE_ITEM_PASSWORD(pamh, ctrl, PAM_OLDAUTHTOK);
206 _PAM_LOG_STATE_ITEM_PASSWORD(pamh, ctrl, PAM_AUTHTOK);
207 _PAM_LOG_STATE_ITEM_STRING(pamh, ctrl, PAM_USER_PROMPT);
208 _PAM_LOG_STATE_ITEM_POINTER(pamh, ctrl, PAM_CONV);
209 #ifdef PAM_FAIL_DELAY
210 _PAM_LOG_STATE_ITEM_POINTER(pamh, ctrl, PAM_FAIL_DELAY);
212 #ifdef PAM_REPOSITORY
213 _PAM_LOG_STATE_ITEM_POINTER(pamh, ctrl, PAM_REPOSITORY);
216 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl, PAM_WINBIND_HOMEDIR);
217 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl, PAM_WINBIND_LOGONSCRIPT);
218 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl, PAM_WINBIND_LOGONSERVER);
219 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl, PAM_WINBIND_PROFILEPATH);
220 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl,
221 PAM_WINBIND_NEW_AUTHTOK_REQD);
222 /* Use atoi to get PAM result code */
223 _PAM_LOG_STATE_DATA_STRING(pamh, ctrl,
224 PAM_WINBIND_NEW_AUTHTOK_REQD_DURING_AUTH);
225 _PAM_LOG_STATE_DATA_POINTER(pamh, ctrl, PAM_WINBIND_PWD_LAST_SET);
228 static int _pam_parse(const pam_handle_t *pamh,
232 dictionary **result_d)
235 const char *config_file = NULL;
238 dictionary *d = NULL;
240 if (flags & PAM_SILENT) {
241 ctrl |= WINBIND_SILENT;
244 for (i=argc,v=argv; i-- > 0; ++v) {
245 if (!strncasecmp(*v, "config", strlen("config"))) {
246 ctrl |= WINBIND_CONFIG_FILE;
252 if (config_file == NULL) {
253 config_file = PAM_WINBIND_CONFIG_FILE;
256 d = iniparser_load(config_file);
258 goto config_from_pam;
261 if (iniparser_getboolean(d, "global:debug", false)) {
262 ctrl |= WINBIND_DEBUG_ARG;
265 if (iniparser_getboolean(d, "global:debug_state", false)) {
266 ctrl |= WINBIND_DEBUG_STATE;
269 if (iniparser_getboolean(d, "global:cached_login", false)) {
270 ctrl |= WINBIND_CACHED_LOGIN;
273 if (iniparser_getboolean(d, "global:krb5_auth", false)) {
274 ctrl |= WINBIND_KRB5_AUTH;
277 if (iniparser_getboolean(d, "global:silent", false)) {
278 ctrl |= WINBIND_SILENT;
281 if (iniparser_getstr(d, "global:krb5_ccache_type") != NULL) {
282 ctrl |= WINBIND_KRB5_CCACHE_TYPE;
285 if ((iniparser_getstr(d, "global:require-membership-of") != NULL) ||
286 (iniparser_getstr(d, "global:require_membership_of") != NULL)) {
287 ctrl |= WINBIND_REQUIRED_MEMBERSHIP;
290 if (iniparser_getboolean(d, "global:try_first_pass", false)) {
291 ctrl |= WINBIND_TRY_FIRST_PASS_ARG;
294 if (iniparser_getint(d, "global:warn_pwd_expire", 0)) {
295 ctrl |= WINBIND_WARN_PWD_EXPIRE;
299 /* step through arguments */
300 for (i=argc,v=argv; i-- > 0; ++v) {
302 /* generic options */
303 if (!strcmp(*v,"debug"))
304 ctrl |= WINBIND_DEBUG_ARG;
305 else if (!strcasecmp(*v, "debug_state"))
306 ctrl |= WINBIND_DEBUG_STATE;
307 else if (!strcasecmp(*v, "silent"))
308 ctrl |= WINBIND_SILENT;
309 else if (!strcasecmp(*v, "use_authtok"))
310 ctrl |= WINBIND_USE_AUTHTOK_ARG;
311 else if (!strcasecmp(*v, "use_first_pass"))
312 ctrl |= WINBIND_USE_FIRST_PASS_ARG;
313 else if (!strcasecmp(*v, "try_first_pass"))
314 ctrl |= WINBIND_TRY_FIRST_PASS_ARG;
315 else if (!strcasecmp(*v, "unknown_ok"))
316 ctrl |= WINBIND_UNKNOWN_OK_ARG;
317 else if (!strncasecmp(*v, "require_membership_of",
318 strlen("require_membership_of")))
319 ctrl |= WINBIND_REQUIRED_MEMBERSHIP;
320 else if (!strncasecmp(*v, "require-membership-of",
321 strlen("require-membership-of")))
322 ctrl |= WINBIND_REQUIRED_MEMBERSHIP;
323 else if (!strcasecmp(*v, "krb5_auth"))
324 ctrl |= WINBIND_KRB5_AUTH;
325 else if (!strncasecmp(*v, "krb5_ccache_type",
326 strlen("krb5_ccache_type")))
327 ctrl |= WINBIND_KRB5_CCACHE_TYPE;
328 else if (!strcasecmp(*v, "cached_login"))
329 ctrl |= WINBIND_CACHED_LOGIN;
331 _pam_log(pamh, ctrl, LOG_ERR,
332 "pam_parse: unknown option: %s", *v);
342 iniparser_freedict(d);
349 static void _pam_winbind_cleanup_func(pam_handle_t *pamh,
353 int ctrl = _pam_parse(pamh, 0, 0, NULL, NULL);
354 if (_pam_log_is_debug_state_enabled(ctrl)) {
355 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
356 "[pamh: %p] CLEAN: cleaning up PAM data %p "
357 "(error_status = %d)", pamh, data,
364 static const struct ntstatus_errors {
365 const char *ntstatus_string;
366 const char *error_string;
367 } ntstatus_errors[] = {
370 {"NT_STATUS_BACKUP_CONTROLLER",
371 "No primary Domain Controler available"},
372 {"NT_STATUS_DOMAIN_CONTROLLER_NOT_FOUND",
373 "No domain controllers found"},
374 {"NT_STATUS_NO_LOGON_SERVERS",
376 {"NT_STATUS_PWD_TOO_SHORT",
377 "Password too short"},
378 {"NT_STATUS_PWD_TOO_RECENT",
379 "The password of this user is too recent to change"},
380 {"NT_STATUS_PWD_HISTORY_CONFLICT",
381 "Password is already in password history"},
382 {"NT_STATUS_PASSWORD_EXPIRED",
383 "Your password has expired"},
384 {"NT_STATUS_PASSWORD_MUST_CHANGE",
385 "You need to change your password now"},
386 {"NT_STATUS_INVALID_WORKSTATION",
387 "You are not allowed to logon from this workstation"},
388 {"NT_STATUS_INVALID_LOGON_HOURS",
389 "You are not allowed to logon at this time"},
390 {"NT_STATUS_ACCOUNT_EXPIRED",
391 "Your account has expired. "
392 "Please contact your System administrator"}, /* SCNR */
393 {"NT_STATUS_ACCOUNT_DISABLED",
394 "Your account is disabled. "
395 "Please contact your System administrator"}, /* SCNR */
396 {"NT_STATUS_ACCOUNT_LOCKED_OUT",
397 "Your account has been locked. "
398 "Please contact your System administrator"}, /* SCNR */
399 {"NT_STATUS_NOLOGON_WORKSTATION_TRUST_ACCOUNT",
400 "Invalid Trust Account"},
401 {"NT_STATUS_NOLOGON_SERVER_TRUST_ACCOUNT",
402 "Invalid Trust Account"},
403 {"NT_STATUS_NOLOGON_INTERDOMAIN_TRUST_ACCOUNT",
404 "Invalid Trust Account"},
405 {"NT_STATUS_ACCESS_DENIED",
410 const char *_get_ntstatus_error_string(const char *nt_status_string)
413 for (i=0; ntstatus_errors[i].ntstatus_string != NULL; i++) {
414 if (!strcasecmp(ntstatus_errors[i].ntstatus_string,
416 return ntstatus_errors[i].error_string;
422 /* --- authentication management functions --- */
424 /* Attempt a conversation */
426 static int converse(pam_handle_t *pamh,
428 struct pam_message **message,
429 struct pam_response **response)
432 struct pam_conv *conv;
434 retval = _pam_get_item(pamh, PAM_CONV, &conv);
435 if (retval == PAM_SUCCESS) {
436 retval = conv->conv(nargs,
437 (const struct pam_message **)message,
438 response, conv->appdata_ptr);
441 return retval; /* propagate error status */
445 static int _make_remark(pam_handle_t * pamh,
450 int retval = PAM_SUCCESS;
452 struct pam_message *pmsg[1], msg[1];
453 struct pam_response *resp;
455 if (flags & WINBIND_SILENT) {
460 msg[0].msg = discard_const_p(char, text);
461 msg[0].msg_style = type;
464 retval = converse(pamh, 1, pmsg, &resp);
467 _pam_drop_reply(resp, 1);
472 static int _make_remark_v(pam_handle_t *pamh,
481 ret = vasprintf(&var, format, args);
483 _pam_log(pamh, 0, LOG_ERR, "memory allocation failure");
487 ret = _make_remark(pamh, flags, type, var);
492 static int _make_remark_format(pam_handle_t * pamh, int flags, int type, const char *format, ...) PRINTF_ATTRIBUTE(4,5);
493 static int _make_remark_format(pam_handle_t * pamh, int flags, int type, const char *format, ...)
498 va_start(args, format);
499 ret = _make_remark_v(pamh, flags, type, format, args);
504 static int pam_winbind_request(pam_handle_t *pamh,
506 enum winbindd_cmd req_type,
507 struct winbindd_request *request,
508 struct winbindd_response *response)
510 /* Fill in request and send down pipe */
511 winbindd_init_request(request, req_type);
513 if (winbind_write_sock(request, sizeof(*request), 0, 0) == -1) {
514 _pam_log(pamh, ctrl, LOG_ERR,
515 "pam_winbind_request: write to socket failed!");
516 winbind_close_sock();
517 return PAM_SERVICE_ERR;
521 if (winbindd_read_reply(response) == -1) {
522 _pam_log(pamh, ctrl, LOG_ERR,
523 "pam_winbind_request: read from socket failed!");
524 winbind_close_sock();
525 return PAM_SERVICE_ERR;
528 /* We are done with the socket - close it and avoid mischeif */
529 winbind_close_sock();
531 /* Copy reply data from socket */
532 if (response->result == WINBINDD_OK) {
536 /* no need to check for pam_error codes for getpwnam() */
539 case WINBINDD_GETPWNAM:
540 case WINBINDD_LOOKUPNAME:
541 if (strlen(response->data.auth.nt_status_string) > 0) {
542 _pam_log(pamh, ctrl, LOG_ERR,
543 "request failed, NT error was %s",
544 response->data.auth.nt_status_string);
546 _pam_log(pamh, ctrl, LOG_ERR, "request failed");
548 return PAM_USER_UNKNOWN;
553 if (response->data.auth.pam_error != PAM_SUCCESS) {
554 _pam_log(pamh, ctrl, LOG_ERR,
555 "request failed: %s, "
556 "PAM error was %s (%d), NT error was %s",
557 response->data.auth.error_string,
558 pam_strerror(pamh, response->data.auth.pam_error),
559 response->data.auth.pam_error,
560 response->data.auth.nt_status_string);
561 return response->data.auth.pam_error;
564 _pam_log(pamh, ctrl, LOG_ERR, "request failed, but PAM error 0!");
566 return PAM_SERVICE_ERR;
569 static int pam_winbind_request_log(pam_handle_t *pamh,
571 enum winbindd_cmd req_type,
572 struct winbindd_request *request,
573 struct winbindd_response *response,
578 retval = pam_winbind_request(pamh, ctrl, req_type, request, response);
582 /* incorrect password */
583 _pam_log(pamh, ctrl, LOG_WARNING, "user '%s' denied access "
584 "(incorrect password or invalid membership)", user);
586 case PAM_ACCT_EXPIRED:
587 /* account expired */
588 _pam_log(pamh, ctrl, LOG_WARNING, "user '%s' account expired",
591 case PAM_AUTHTOK_EXPIRED:
592 /* password expired */
593 _pam_log(pamh, ctrl, LOG_WARNING, "user '%s' password expired",
596 case PAM_NEW_AUTHTOK_REQD:
597 /* new password required */
598 _pam_log(pamh, ctrl, LOG_WARNING, "user '%s' new password "
601 case PAM_USER_UNKNOWN:
602 /* the user does not exist */
603 _pam_log_debug(pamh, ctrl, LOG_NOTICE, "user '%s' not found",
605 if (ctrl & WINBIND_UNKNOWN_OK_ARG) {
610 /* Otherwise, the authentication looked good */
614 case WINBINDD_PAM_AUTH:
615 _pam_log(pamh, ctrl, LOG_NOTICE,
616 "user '%s' granted access", user);
618 case WINBINDD_PAM_CHAUTHTOK:
619 _pam_log(pamh, ctrl, LOG_NOTICE,
620 "user '%s' password changed", user);
623 _pam_log(pamh, ctrl, LOG_NOTICE,
624 "user '%s' OK", user);
630 /* we don't know anything about this return value */
631 _pam_log(pamh, ctrl, LOG_ERR,
632 "internal module error (retval = %d, user = '%s')",
639 * send a password expiry message if required
641 * @param pamh PAM handle
642 * @param ctrl PAM winbind options.
643 * @param next_change expected (calculated) next expiry date.
644 * @param already_expired pointer to a boolean to indicate if the password is
647 * @return boolean Returns true if message has been sent, false if not.
650 static bool _pam_send_password_expiry_message(pam_handle_t *pamh,
655 bool *already_expired)
658 struct tm tm_now, tm_next_change;
660 if (already_expired) {
661 *already_expired = false;
664 if (next_change <= now) {
665 PAM_WB_REMARK_DIRECT(pamh, ctrl, "NT_STATUS_PASSWORD_EXPIRED");
666 if (already_expired) {
667 *already_expired = true;
672 if ((next_change < 0) ||
673 (next_change > now + warn_pwd_expire * SECONDS_PER_DAY)) {
677 if ((localtime_r(&now, &tm_now) == NULL) ||
678 (localtime_r(&next_change, &tm_next_change) == NULL)) {
682 days = (tm_next_change.tm_yday+tm_next_change.tm_year*365) -
683 (tm_now.tm_yday+tm_now.tm_year*365);
686 _make_remark(pamh, ctrl, PAM_TEXT_INFO,
687 "Your password expires today");
691 if (days > 0 && days < warn_pwd_expire) {
692 _make_remark_format(pamh, ctrl, PAM_TEXT_INFO,
693 "Your password will expire in %d %s",
694 days, (days > 1) ? "days":"day");
702 * Send a warning if the password expires in the near future
704 * @param pamh PAM handle
705 * @param ctrl PAM winbind options.
706 * @param response The full authentication response structure.
707 * @param already_expired boolean, is the pwd already expired?
712 static void _pam_warn_password_expiry(pam_handle_t *pamh,
714 const struct winbindd_response *response,
716 bool *already_expired)
718 time_t now = time(NULL);
719 time_t next_change = 0;
721 if (already_expired) {
722 *already_expired = false;
725 /* accounts with ACB_PWNOEXP set never receive a warning */
726 if (response->data.auth.info3.acct_flags & ACB_PWNOEXP) {
730 /* no point in sending a warning if this is a grace logon */
731 if (PAM_WB_GRACE_LOGON(response->data.auth.info3.user_flgs)) {
735 /* check if the info3 must change timestamp has been set */
736 next_change = response->data.auth.info3.pass_must_change_time;
738 if (_pam_send_password_expiry_message(pamh, flags, next_change, now,
744 /* now check for the global password policy */
745 /* good catch from Ralf Haferkamp: an expiry of "never" is translated
747 if (response->data.auth.policy.expire <= 0) {
751 next_change = response->data.auth.info3.pass_last_set_time +
752 response->data.auth.policy.expire;
754 if (_pam_send_password_expiry_message(pamh, flags, next_change, now,
760 /* no warning sent */
763 #define IS_SID_STRING(name) (strncmp("S-", name, 2) == 0)
766 * Append a string, making sure not to overflow and to always return a
767 * NULL-terminated string.
769 * @param dest Destination string buffer (must already be NULL-terminated).
770 * @param src Source string buffer.
771 * @param dest_buffer_size Size of dest buffer in bytes.
773 * @return false if dest buffer is not big enough (no bytes copied), true on
777 static bool safe_append_string(char *dest,
779 int dest_buffer_size)
781 int dest_length = strlen(dest);
782 int src_length = strlen(src);
784 if (dest_length + src_length + 1 > dest_buffer_size) {
788 memcpy(dest + dest_length, src, src_length + 1);
793 * Convert a names into a SID string, appending it to a buffer.
795 * @param pamh PAM handle
796 * @param ctrl PAM winbind options.
797 * @param user User in PAM request.
798 * @param name Name to convert.
799 * @param sid_list_buffer Where to append the string sid.
800 * @param sid_list_buffer Size of sid_list_buffer (in bytes).
802 * @return false on failure, true on success.
804 static bool winbind_name_to_sid_string(pam_handle_t *pamh,
808 char *sid_list_buffer,
809 int sid_list_buffer_size)
811 const char* sid_string;
812 struct winbindd_response sid_response;
815 if (IS_SID_STRING(name)) {
818 struct winbindd_request sid_request;
820 ZERO_STRUCT(sid_request);
821 ZERO_STRUCT(sid_response);
823 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
824 "no sid given, looking up: %s\n", name);
826 /* fortunatly winbindd can handle non-separated names */
827 strncpy(sid_request.data.name.name, name,
828 sizeof(sid_request.data.name.name) - 1);
830 if (pam_winbind_request_log(pamh, ctrl, WINBINDD_LOOKUPNAME,
831 &sid_request, &sid_response,
833 _pam_log(pamh, ctrl, LOG_INFO,
834 "could not lookup name: %s\n", name);
838 sid_string = sid_response.data.sid.sid;
841 if (!safe_append_string(sid_list_buffer, sid_string,
842 sid_list_buffer_size)) {
850 * Convert a list of names into a list of sids.
852 * @param pamh PAM handle
853 * @param ctrl PAM winbind options.
854 * @param user User in PAM request.
855 * @param name_list List of names or string sids, separated by commas.
856 * @param sid_list_buffer Where to put the list of string sids.
857 * @param sid_list_buffer Size of sid_list_buffer (in bytes).
859 * @return false on failure, true on success.
861 static bool winbind_name_list_to_sid_string_list(pam_handle_t *pamh,
864 const char *name_list,
865 char *sid_list_buffer,
866 int sid_list_buffer_size)
869 char *current_name = NULL;
870 const char *search_location;
873 if (sid_list_buffer_size > 0) {
874 sid_list_buffer[0] = 0;
877 search_location = name_list;
878 while ((comma = strstr(search_location, ",")) != NULL) {
879 current_name = strndup(search_location,
880 comma - search_location);
881 if (NULL == current_name) {
885 if (!winbind_name_to_sid_string(pamh, ctrl, user,
888 sid_list_buffer_size)) {
892 SAFE_FREE(current_name);
894 if (!safe_append_string(sid_list_buffer, ",",
895 sid_list_buffer_size)) {
899 search_location = comma + 1;
902 if (!winbind_name_to_sid_string(pamh, ctrl, user, search_location,
904 sid_list_buffer_size)) {
911 SAFE_FREE(current_name);
916 * put krb5ccname variable into environment
918 * @param pamh PAM handle
919 * @param ctrl PAM winbind options.
920 * @param krb5ccname env variable retrieved from winbindd.
925 static void _pam_setup_krb5_env(pam_handle_t *pamh,
927 const char *krb5ccname)
932 if (off(ctrl, WINBIND_KRB5_AUTH)) {
936 if (!krb5ccname || (strlen(krb5ccname) == 0)) {
940 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
941 "request returned KRB5CCNAME: %s", krb5ccname);
943 if (snprintf(var, sizeof(var), "KRB5CCNAME=%s", krb5ccname) == -1) {
947 ret = pam_putenv(pamh, var);
949 _pam_log(pamh, ctrl, LOG_ERR,
950 "failed to set KRB5CCNAME to %s: %s",
951 var, pam_strerror(pamh, ret));
956 * Set string into the PAM stack.
958 * @param pamh PAM handle
959 * @param ctrl PAM winbind options.
960 * @param data_name Key name for pam_set_data.
961 * @param value String value.
966 static void _pam_set_data_string(pam_handle_t *pamh,
968 const char *data_name,
973 if (!data_name || !value || (strlen(data_name) == 0) ||
974 (strlen(value) == 0)) {
978 ret = pam_set_data(pamh, data_name, (void *)strdup(value),
979 _pam_winbind_cleanup_func);
981 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
982 "Could not set data %s: %s\n",
983 data_name, pam_strerror(pamh, ret));
989 * Set info3 strings into the PAM stack.
991 * @param pamh PAM handle
992 * @param ctrl PAM winbind options.
993 * @param data_name Key name for pam_set_data.
994 * @param value String value.
999 static void _pam_set_data_info3(pam_handle_t *pamh,
1001 struct winbindd_response *response)
1003 _pam_set_data_string(pamh, ctrl, PAM_WINBIND_HOMEDIR,
1004 response->data.auth.info3.home_dir);
1005 _pam_set_data_string(pamh, ctrl, PAM_WINBIND_LOGONSCRIPT,
1006 response->data.auth.info3.logon_script);
1007 _pam_set_data_string(pamh, ctrl, PAM_WINBIND_LOGONSERVER,
1008 response->data.auth.info3.logon_srv);
1009 _pam_set_data_string(pamh, ctrl, PAM_WINBIND_PROFILEPATH,
1010 response->data.auth.info3.profile_path);
1014 * Free info3 strings in the PAM stack.
1016 * @param pamh PAM handle
1021 static void _pam_free_data_info3(pam_handle_t *pamh)
1023 pam_set_data(pamh, PAM_WINBIND_HOMEDIR, NULL, NULL);
1024 pam_set_data(pamh, PAM_WINBIND_LOGONSCRIPT, NULL, NULL);
1025 pam_set_data(pamh, PAM_WINBIND_LOGONSERVER, NULL, NULL);
1026 pam_set_data(pamh, PAM_WINBIND_PROFILEPATH, NULL, NULL);
1030 * Send PAM_ERROR_MSG for cached or grace logons.
1032 * @param pamh PAM handle
1033 * @param ctrl PAM winbind options.
1034 * @param username User in PAM request.
1035 * @param info3_user_flgs Info3 flags containing logon type bits.
1040 static void _pam_warn_logon_type(pam_handle_t *pamh,
1042 const char *username,
1043 uint32_t info3_user_flgs)
1045 /* inform about logon type */
1046 if (PAM_WB_GRACE_LOGON(info3_user_flgs)) {
1048 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1050 "Please change your password as soon you're "
1052 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1053 "User %s logged on using grace logon\n",
1056 } else if (PAM_WB_CACHED_LOGON(info3_user_flgs)) {
1058 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1059 "Domain Controller unreachable, "
1060 "using cached credentials instead. "
1061 "Network resources may be unavailable");
1062 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1063 "User %s logged on using cached credentials\n",
1069 * Send PAM_ERROR_MSG for krb5 errors.
1071 * @param pamh PAM handle
1072 * @param ctrl PAM winbind options.
1073 * @param username User in PAM request.
1074 * @param info3_user_flgs Info3 flags containing logon type bits.
1079 static void _pam_warn_krb5_failure(pam_handle_t *pamh,
1081 const char *username,
1082 uint32_t info3_user_flgs)
1084 if (PAM_WB_KRB5_CLOCK_SKEW(info3_user_flgs)) {
1085 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1086 "Failed to establish your Kerberos Ticket cache "
1087 "due time differences\n"
1088 "with the domain controller. "
1089 "Please verify the system time.\n");
1090 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1091 "User %s: Clock skew when getting Krb5 TGT\n",
1097 * Compose Password Restriction String for a PAM_ERROR_MSG conversation.
1099 * @param response The struct winbindd_response.
1101 * @return string (caller needs to free).
1104 static char *_pam_compose_pwd_restriction_string(struct winbindd_response *response)
1107 size_t offset = 0, ret = 0, str_size = 1024;
1109 str = (char *)malloc(str_size);
1114 memset(str, '\0', str_size);
1116 offset = snprintf(str, str_size, "Your password ");
1121 if (response->data.auth.policy.min_length_password > 0) {
1122 ret = snprintf(str+offset, str_size-offset,
1123 "must be at least %d characters; ",
1124 response->data.auth.policy.min_length_password);
1131 if (response->data.auth.policy.password_history > 0) {
1132 ret = snprintf(str+offset, str_size-offset,
1133 "cannot repeat any of your previous %d "
1135 response->data.auth.policy.password_history);
1142 if (response->data.auth.policy.password_properties &
1143 DOMAIN_PASSWORD_COMPLEX) {
1144 ret = snprintf(str+offset, str_size-offset,
1145 "must contain capitals, numerals "
1147 "and cannot contain your account "
1155 ret = snprintf(str+offset, str_size-offset,
1156 "Please type a different password. "
1157 "Type a password which meets these requirements in "
1158 "both text boxes.");
1170 /* talk to winbindd */
1171 static int winbind_auth_request(pam_handle_t * pamh,
1177 const int warn_pwd_expire,
1178 struct winbindd_response *p_response,
1179 time_t *pwd_last_set,
1182 struct winbindd_request request;
1183 struct winbindd_response response;
1185 bool already_expired = false;
1187 ZERO_STRUCT(request);
1188 ZERO_STRUCT(response);
1194 strncpy(request.data.auth.user, user,
1195 sizeof(request.data.auth.user)-1);
1197 strncpy(request.data.auth.pass, pass,
1198 sizeof(request.data.auth.pass)-1);
1200 request.data.auth.krb5_cc_type[0] = '\0';
1201 request.data.auth.uid = -1;
1203 request.flags = WBFLAG_PAM_INFO3_TEXT |
1204 WBFLAG_PAM_GET_PWD_POLICY |
1205 WBFLAG_PAM_CONTACT_TRUSTDOM;
1207 if (ctrl & (WINBIND_KRB5_AUTH|WINBIND_CACHED_LOGIN)) {
1208 struct passwd *pwd = NULL;
1210 pwd = getpwnam(user);
1212 return PAM_USER_UNKNOWN;
1214 request.data.auth.uid = pwd->pw_uid;
1217 if (ctrl & WINBIND_KRB5_AUTH) {
1219 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1220 "enabling krb5 login flag\n");
1222 request.flags |= WBFLAG_PAM_KRB5 |
1223 WBFLAG_PAM_FALLBACK_AFTER_KRB5;
1226 if (ctrl & WINBIND_CACHED_LOGIN) {
1227 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1228 "enabling cached login flag\n");
1229 request.flags |= WBFLAG_PAM_CACHED_LOGIN;
1234 request.flags |= WBFLAG_PAM_UNIX_NAME;
1237 if (cctype != NULL) {
1238 strncpy(request.data.auth.krb5_cc_type, cctype,
1239 sizeof(request.data.auth.krb5_cc_type) - 1);
1240 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1241 "enabling request for a %s krb5 ccache\n",
1245 request.data.auth.require_membership_of_sid[0] = '\0';
1247 if (member != NULL) {
1249 if (!winbind_name_list_to_sid_string_list(pamh, ctrl, user,
1251 request.data.auth.require_membership_of_sid,
1252 sizeof(request.data.auth.require_membership_of_sid))) {
1254 _pam_log_debug(pamh, ctrl, LOG_ERR,
1255 "failed to serialize membership of sid "
1256 "\"%s\"\n", member);
1257 return PAM_AUTH_ERR;
1261 ret = pam_winbind_request_log(pamh, ctrl, WINBINDD_PAM_AUTH,
1262 &request, &response, user);
1265 *pwd_last_set = response.data.auth.info3.pass_last_set_time;
1269 /* We want to process the response in the caller. */
1270 *p_response = response;
1275 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1276 "NT_STATUS_PASSWORD_EXPIRED");
1277 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1278 "NT_STATUS_PASSWORD_MUST_CHANGE");
1279 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1280 "NT_STATUS_INVALID_WORKSTATION");
1281 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1282 "NT_STATUS_INVALID_LOGON_HOURS");
1283 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1284 "NT_STATUS_ACCOUNT_EXPIRED");
1285 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1286 "NT_STATUS_ACCOUNT_DISABLED");
1287 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1288 "NT_STATUS_ACCOUNT_LOCKED_OUT");
1289 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1290 "NT_STATUS_NOLOGON_WORKSTATION_TRUST_ACCOUNT");
1291 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1292 "NT_STATUS_NOLOGON_SERVER_TRUST_ACCOUNT");
1293 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1294 "NT_STATUS_NOLOGON_INTERDOMAIN_TRUST_ACCOUNT");
1295 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1296 "NT_STATUS_DOMAIN_CONTROLLER_NOT_FOUND");
1297 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1298 "NT_STATUS_NO_LOGON_SERVERS");
1299 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1300 "NT_STATUS_WRONG_PASSWORD");
1301 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1302 "NT_STATUS_ACCESS_DENIED");
1305 if (ret == PAM_SUCCESS) {
1307 /* warn a user if the password is about to expire soon */
1308 _pam_warn_password_expiry(pamh, ctrl, &response,
1312 if (already_expired == true) {
1313 SMB_TIME_T last_set;
1314 last_set = response.data.auth.info3.pass_last_set_time;
1315 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1316 "Password has expired "
1317 "(Password was last set: %lld, "
1318 "the policy says it should expire here "
1319 "%lld (now it's: %lu))\n",
1320 (long long int)last_set,
1321 (long long int)last_set +
1322 response.data.auth.policy.expire,
1325 return PAM_AUTHTOK_EXPIRED;
1328 /* inform about logon type */
1329 _pam_warn_logon_type(pamh, ctrl, user,
1330 response.data.auth.info3.user_flgs);
1332 /* inform about krb5 failures */
1333 _pam_warn_krb5_failure(pamh, ctrl, user,
1334 response.data.auth.info3.user_flgs);
1336 /* set some info3 info for other modules in the stack */
1337 _pam_set_data_info3(pamh, ctrl, &response);
1339 /* put krb5ccname into env */
1340 _pam_setup_krb5_env(pamh, ctrl, response.data.auth.krb5ccname);
1342 /* If winbindd returned a username, return the pointer to it
1344 if (user_ret && response.data.auth.unix_username[0]) {
1345 /* We have to trust it's a null terminated string. */
1346 *user_ret = strndup(response.data.auth.unix_username,
1347 sizeof(response.data.auth.unix_username) - 1);
1354 /* talk to winbindd */
1355 static int winbind_chauthtok_request(pam_handle_t * pamh,
1358 const char *oldpass,
1359 const char *newpass,
1360 time_t pwd_last_set)
1362 struct winbindd_request request;
1363 struct winbindd_response response;
1366 ZERO_STRUCT(request);
1367 ZERO_STRUCT(response);
1369 if (request.data.chauthtok.user == NULL) {
1373 strncpy(request.data.chauthtok.user, user,
1374 sizeof(request.data.chauthtok.user) - 1);
1376 if (oldpass != NULL) {
1377 strncpy(request.data.chauthtok.oldpass, oldpass,
1378 sizeof(request.data.chauthtok.oldpass) - 1);
1380 request.data.chauthtok.oldpass[0] = '\0';
1383 if (newpass != NULL) {
1384 strncpy(request.data.chauthtok.newpass, newpass,
1385 sizeof(request.data.chauthtok.newpass) - 1);
1387 request.data.chauthtok.newpass[0] = '\0';
1390 if (ctrl & WINBIND_KRB5_AUTH) {
1391 request.flags = WBFLAG_PAM_KRB5 |
1392 WBFLAG_PAM_CONTACT_TRUSTDOM;
1395 ret = pam_winbind_request_log(pamh, ctrl, WINBINDD_PAM_CHAUTHTOK,
1396 &request, &response, user);
1398 if (ret == PAM_SUCCESS) {
1402 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1403 "NT_STATUS_BACKUP_CONTROLLER");
1404 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1405 "NT_STATUS_DOMAIN_CONTROLLER_NOT_FOUND");
1406 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1407 "NT_STATUS_NO_LOGON_SERVERS");
1408 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1409 "NT_STATUS_ACCESS_DENIED");
1411 /* TODO: tell the min pwd length ? */
1412 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1413 "NT_STATUS_PWD_TOO_SHORT");
1415 /* TODO: tell the minage ? */
1416 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1417 "NT_STATUS_PWD_TOO_RECENT");
1419 /* TODO: tell the history length ? */
1420 PAM_WB_REMARK_CHECK_RESPONSE_RET(pamh, ctrl, response,
1421 "NT_STATUS_PWD_HISTORY_CONFLICT");
1423 if (!strcasecmp(response.data.auth.nt_status_string,
1424 "NT_STATUS_PASSWORD_RESTRICTION")) {
1426 char *pwd_restriction_string = NULL;
1427 SMB_TIME_T min_pwd_age;
1428 uint32_t reject_reason = response.data.auth.reject_reason;
1429 min_pwd_age = response.data.auth.policy.min_passwordage;
1431 /* FIXME: avoid to send multiple PAM messages after another */
1432 switch (reject_reason) {
1435 case SAMR_REJECT_OTHER:
1436 if ((min_pwd_age > 0) &&
1437 (pwd_last_set + min_pwd_age > time(NULL))) {
1438 PAM_WB_REMARK_DIRECT(pamh, ctrl,
1439 "NT_STATUS_PWD_TOO_RECENT");
1442 case SAMR_REJECT_TOO_SHORT:
1443 PAM_WB_REMARK_DIRECT(pamh, ctrl,
1444 "NT_STATUS_PWD_TOO_SHORT");
1446 case SAMR_REJECT_IN_HISTORY:
1447 PAM_WB_REMARK_DIRECT(pamh, ctrl,
1448 "NT_STATUS_PWD_HISTORY_CONFLICT");
1450 case SAMR_REJECT_COMPLEXITY:
1451 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1452 "Password does not meet "
1453 "complexity requirements");
1456 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1457 "unknown password change "
1458 "reject reason: %d",
1463 pwd_restriction_string =
1464 _pam_compose_pwd_restriction_string(&response);
1465 if (pwd_restriction_string) {
1466 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1467 pwd_restriction_string);
1468 SAFE_FREE(pwd_restriction_string);
1476 * Checks if a user has an account
1479 * 1 = User not found
1483 static int valid_user(pam_handle_t *pamh,
1487 /* check not only if the user is available over NSS calls, also make
1488 * sure it's really a winbind user, this is important when stacking PAM
1489 * modules in the 'account' or 'password' facility. */
1491 struct passwd *pwd = NULL;
1492 struct winbindd_request request;
1493 struct winbindd_response response;
1496 ZERO_STRUCT(request);
1497 ZERO_STRUCT(response);
1499 pwd = getpwnam(user);
1504 strncpy(request.data.username, user,
1505 sizeof(request.data.username) - 1);
1507 ret = pam_winbind_request_log(pamh, ctrl, WINBINDD_GETPWNAM,
1508 &request, &response, user);
1511 case PAM_USER_UNKNOWN:
1521 static char *_pam_delete(register char *xx)
1529 * obtain a password from the user
1532 static int _winbind_read_password(pam_handle_t * pamh,
1534 const char *comment,
1535 const char *prompt1,
1536 const char *prompt2,
1544 _pam_log(pamh, ctrl, LOG_DEBUG, "getting password (0x%08x)", ctrl);
1547 * make sure nothing inappropriate gets returned
1550 *pass = token = NULL;
1553 * which authentication token are we getting?
1556 if (on(WINBIND__OLD_PASSWORD, ctrl)) {
1557 authtok_flag = PAM_OLDAUTHTOK;
1559 authtok_flag = PAM_AUTHTOK;
1563 * should we obtain the password from a PAM item ?
1566 if (on(WINBIND_TRY_FIRST_PASS_ARG, ctrl) ||
1567 on(WINBIND_USE_FIRST_PASS_ARG, ctrl)) {
1568 retval = _pam_get_item(pamh, authtok_flag, &item);
1569 if (retval != PAM_SUCCESS) {
1571 _pam_log(pamh, ctrl, LOG_ALERT,
1572 "pam_get_item returned error "
1573 "to unix-read-password");
1575 } else if (item != NULL) { /* we have a password! */
1578 _pam_log(pamh, ctrl, LOG_DEBUG,
1579 "pam_get_item returned a password");
1581 } else if (on(WINBIND_USE_FIRST_PASS_ARG, ctrl)) {
1582 return PAM_AUTHTOK_RECOVER_ERR; /* didn't work */
1583 } else if (on(WINBIND_USE_AUTHTOK_ARG, ctrl)
1584 && off(WINBIND__OLD_PASSWORD, ctrl)) {
1585 return PAM_AUTHTOK_RECOVER_ERR;
1589 * getting here implies we will have to get the password from the
1594 struct pam_message msg[3], *pmsg[3];
1595 struct pam_response *resp;
1598 /* prepare to converse */
1600 if (comment != NULL && off(ctrl, WINBIND_SILENT)) {
1602 msg[0].msg_style = PAM_TEXT_INFO;
1603 msg[0].msg = discard_const_p(char, comment);
1610 msg[i].msg_style = PAM_PROMPT_ECHO_OFF;
1611 msg[i++].msg = discard_const_p(char, prompt1);
1614 if (prompt2 != NULL) {
1616 msg[i].msg_style = PAM_PROMPT_ECHO_OFF;
1617 msg[i++].msg = discard_const_p(char, prompt2);
1620 /* so call the conversation expecting i responses */
1622 retval = converse(pamh, i, pmsg, &resp);
1624 if (retval == PAM_SUCCESS) {
1625 retval = PAM_AUTHTOK_RECOVER_ERR;
1629 if (retval != PAM_SUCCESS) {
1630 _pam_drop_reply(resp, i);
1634 /* interpret the response */
1636 token = x_strdup(resp[i - replies].resp);
1638 _pam_log(pamh, ctrl, LOG_NOTICE,
1639 "could not recover "
1640 "authentication token");
1641 retval = PAM_AUTHTOK_RECOVER_ERR;
1646 /* verify that password entered correctly */
1647 if (!resp[i - 1].resp ||
1648 strcmp(token, resp[i - 1].resp)) {
1649 _pam_delete(token); /* mistyped */
1650 retval = PAM_AUTHTOK_RECOVER_ERR;
1651 _make_remark(pamh, ctrl, PAM_ERROR_MSG,
1657 * tidy up the conversation (resp_retcode) is ignored
1658 * -- what is it for anyway? AGM
1660 _pam_drop_reply(resp, i);
1664 if (retval != PAM_SUCCESS) {
1665 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1666 "unable to obtain a password");
1669 /* 'token' is the entered password */
1671 /* we store this password as an item */
1673 retval = pam_set_item(pamh, authtok_flag, token);
1674 _pam_delete(token); /* clean it up */
1675 if (retval != PAM_SUCCESS ||
1676 (retval = _pam_get_item(pamh, authtok_flag, &item)) != PAM_SUCCESS) {
1678 _pam_log(pamh, ctrl, LOG_CRIT, "error manipulating password");
1684 item = NULL; /* break link to password */
1689 const char *get_conf_item_string(const pam_handle_t *pamh,
1698 const char *parm_opt = NULL;
1700 if (!(ctrl & config_flag)) {
1704 /* let the pam opt take precedence over the pam_winbind.conf option */
1705 for (i=0; i<argc; i++) {
1707 if ((strncmp(argv[i], item, strlen(item)) == 0)) {
1710 if ((p = strchr(argv[i], '=')) == NULL) {
1711 _pam_log(pamh, ctrl, LOG_INFO,
1712 "no \"=\" delimiter for \"%s\" found\n",
1716 _pam_log_debug(pamh, ctrl, LOG_INFO,
1717 "PAM config: %s '%s'\n", item, p+1);
1725 if (!asprintf(&key, "global:%s", item)) {
1729 parm_opt = iniparser_getstr(d, key);
1732 _pam_log_debug(pamh, ctrl, LOG_INFO, "CONFIG file: %s '%s'\n",
1739 int get_config_item_int(const pam_handle_t *pamh,
1747 int i, parm_opt = -1;
1749 if (!(ctrl & config_flag)) {
1753 /* let the pam opt take precedence over the pam_winbind.conf option */
1754 for (i = 0; i < argc; i++) {
1756 if ((strncmp(argv[i], item, strlen(item)) == 0)) {
1759 if ((p = strchr(argv[i], '=')) == NULL) {
1760 _pam_log(pamh, ctrl, LOG_INFO,
1761 "no \"=\" delimiter for \"%s\" found\n",
1765 parm_opt = atoi(p + 1);
1766 _pam_log_debug(pamh, ctrl, LOG_INFO,
1767 "PAM config: %s '%d'\n",
1776 if (!asprintf(&key, "global:%s", item)) {
1780 parm_opt = iniparser_getint(d, key, -1);
1783 _pam_log_debug(pamh, ctrl, LOG_INFO,
1784 "CONFIG file: %s '%d'\n",
1791 const char *get_krb5_cc_type_from_config(const pam_handle_t *pamh,
1797 return get_conf_item_string(pamh, argc, argv, ctrl, d,
1799 WINBIND_KRB5_CCACHE_TYPE);
1802 const char *get_member_from_config(const pam_handle_t *pamh,
1808 const char *ret = NULL;
1809 ret = get_conf_item_string(pamh, argc, argv, ctrl, d,
1810 "require_membership_of",
1811 WINBIND_REQUIRED_MEMBERSHIP);
1815 return get_conf_item_string(pamh, argc, argv, ctrl, d,
1816 "require-membership-of",
1817 WINBIND_REQUIRED_MEMBERSHIP);
1820 int get_warn_pwd_expire_from_config(const pam_handle_t *pamh,
1827 ret = get_config_item_int(pamh, argc, argv, ctrl, d,
1829 WINBIND_WARN_PWD_EXPIRE);
1830 /* no or broken setting */
1832 return DEFAULT_DAYS_TO_WARN_BEFORE_PWD_EXPIRES;
1838 * Retrieve the winbind separator.
1840 * @param pamh PAM handle
1841 * @param ctrl PAM winbind options.
1843 * @return string separator character. NULL on failure.
1846 static char winbind_get_separator(pam_handle_t *pamh,
1849 struct winbindd_request request;
1850 struct winbindd_response response;
1852 ZERO_STRUCT(request);
1853 ZERO_STRUCT(response);
1855 if (pam_winbind_request_log(pamh, ctrl, WINBINDD_INFO,
1856 &request, &response, NULL)) {
1860 return response.data.info.winbind_separator;
1864 * Convert a upn to a name.
1866 * @param pamh PAM handle
1867 * @param ctrl PAM winbind options.
1868 * @param upn USer UPN to be trabslated.
1870 * @return converted name. NULL pointer on failure. Caller needs to free.
1873 static char* winbind_upn_to_username(pam_handle_t *pamh,
1877 struct winbindd_request req;
1878 struct winbindd_response resp;
1881 int account_name_len;
1884 /* This cannot work when the winbind separator = @ */
1886 sep = winbind_get_separator(pamh, ctrl);
1887 if (!sep || sep == '@') {
1891 /* Convert the UPN to a SID */
1896 strncpy(req.data.name.dom_name, "",
1897 sizeof(req.data.name.dom_name) - 1);
1898 strncpy(req.data.name.name, upn,
1899 sizeof(req.data.name.name) - 1);
1900 retval = pam_winbind_request_log(pamh, ctrl, WINBINDD_LOOKUPNAME,
1902 if (retval != PAM_SUCCESS) {
1906 /* Convert the the SID back to the sAMAccountName */
1909 strncpy(req.data.sid, resp.data.sid.sid, sizeof(req.data.sid)-1);
1911 retval = pam_winbind_request_log(pamh, ctrl, WINBINDD_LOOKUPSID,
1913 if (retval != PAM_SUCCESS) {
1917 account_name_len = asprintf(&account_name, "%s\\%s",
1918 resp.data.name.dom_name,
1919 resp.data.name.name);
1921 return account_name;
1925 int pam_sm_authenticate(pam_handle_t *pamh, int flags,
1926 int argc, const char **argv)
1928 const char *username;
1929 const char *password;
1930 const char *member = NULL;
1931 const char *cctype = NULL;
1932 int warn_pwd_expire;
1933 int retval = PAM_AUTH_ERR;
1934 dictionary *d = NULL;
1935 char *username_ret = NULL;
1936 char *new_authtok_required = NULL;
1937 char *real_username = NULL;
1939 /* parse arguments */
1940 int ctrl = _pam_parse(pamh, flags, argc, argv, &d);
1942 retval = PAM_SYSTEM_ERR;
1946 _PAM_LOG_FUNCTION_ENTER("pam_sm_authenticate", pamh, ctrl, flags);
1948 /* Get the username */
1949 retval = pam_get_user(pamh, &username, NULL);
1950 if ((retval != PAM_SUCCESS) || (!username)) {
1951 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1952 "can not get the username");
1953 retval = PAM_SERVICE_ERR;
1959 /* Decode the user name since AIX does not support logn user
1960 names by default. The name is encoded as _#uid. */
1962 if (username[0] == '_') {
1963 uid_t id = atoi(&username[1]);
1964 struct passwd *pw = NULL;
1966 if ((id!=0) && ((pw = getpwuid(id)) != NULL)) {
1967 real_username = strdup(pw->pw_name);
1972 if (!real_username) {
1973 /* Just making a copy of the username we got from PAM */
1974 if ((real_username = strdup(username)) == NULL) {
1975 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
1976 "memory allocation failure when copying "
1978 retval = PAM_SERVICE_ERR;
1983 /* Maybe this was a UPN */
1985 if (strchr(real_username, '@') != NULL) {
1986 char *samaccountname = NULL;
1988 samaccountname = winbind_upn_to_username(pamh, ctrl,
1990 if (samaccountname) {
1991 free(real_username);
1992 real_username = samaccountname;
1996 retval = _winbind_read_password(pamh, ctrl, NULL,
2000 if (retval != PAM_SUCCESS) {
2001 _pam_log(pamh, ctrl, LOG_ERR,
2002 "Could not retrieve user's password");
2003 retval = PAM_AUTHTOK_ERR;
2007 /* Let's not give too much away in the log file */
2009 #ifdef DEBUG_PASSWORD
2010 _pam_log_debug(pamh, ctrl, LOG_INFO,
2011 "Verify user '%s' with password '%s'",
2012 real_username, password);
2014 _pam_log_debug(pamh, ctrl, LOG_INFO,
2015 "Verify user '%s'", real_username);
2018 member = get_member_from_config(pamh, argc, argv, ctrl, d);
2020 cctype = get_krb5_cc_type_from_config(pamh, argc, argv, ctrl, d);
2022 warn_pwd_expire = get_warn_pwd_expire_from_config(pamh, argc, argv,
2025 /* Now use the username to look up password */
2026 retval = winbind_auth_request(pamh, ctrl, real_username, password,
2027 member, cctype, warn_pwd_expire, NULL,
2028 NULL, &username_ret);
2030 if (retval == PAM_NEW_AUTHTOK_REQD ||
2031 retval == PAM_AUTHTOK_EXPIRED) {
2033 char *new_authtok_required_during_auth = NULL;
2035 if (!asprintf(&new_authtok_required, "%d", retval)) {
2036 retval = PAM_BUF_ERR;
2040 pam_set_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD,
2041 new_authtok_required,
2042 _pam_winbind_cleanup_func);
2044 retval = PAM_SUCCESS;
2046 if (!asprintf(&new_authtok_required_during_auth, "%d", true)) {
2047 retval = PAM_BUF_ERR;
2051 pam_set_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD_DURING_AUTH,
2052 new_authtok_required_during_auth,
2053 _pam_winbind_cleanup_func);
2060 pam_set_item (pamh, PAM_USER, username_ret);
2061 _pam_log_debug(pamh, ctrl, LOG_INFO,
2062 "Returned user was '%s'", username_ret);
2066 if (real_username) {
2067 free(real_username);
2071 iniparser_freedict(d);
2074 if (!new_authtok_required) {
2075 pam_set_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD, NULL, NULL);
2078 if (retval != PAM_SUCCESS) {
2079 _pam_free_data_info3(pamh);
2082 _PAM_LOG_FUNCTION_LEAVE("pam_sm_authenticate", pamh, ctrl, retval);
2088 int pam_sm_setcred(pam_handle_t *pamh, int flags,
2089 int argc, const char **argv)
2091 int ret = PAM_SYSTEM_ERR;
2092 dictionary *d = NULL;
2094 /* parse arguments */
2095 int ctrl = _pam_parse(pamh, flags, argc, argv, &d);
2097 ret = PAM_SYSTEM_ERR;
2101 _PAM_LOG_FUNCTION_ENTER("pam_sm_setcred", pamh, ctrl, flags);
2103 switch (flags & ~PAM_SILENT) {
2105 case PAM_DELETE_CRED:
2106 ret = pam_sm_close_session(pamh, flags, argc, argv);
2108 case PAM_REFRESH_CRED:
2109 _pam_log_debug(pamh, ctrl, LOG_WARNING,
2110 "PAM_REFRESH_CRED not implemented");
2113 case PAM_REINITIALIZE_CRED:
2114 _pam_log_debug(pamh, ctrl, LOG_WARNING,
2115 "PAM_REINITIALIZE_CRED not implemented");
2118 case PAM_ESTABLISH_CRED:
2119 _pam_log_debug(pamh, ctrl, LOG_WARNING,
2120 "PAM_ESTABLISH_CRED not implemented");
2124 ret = PAM_SYSTEM_ERR;
2130 iniparser_freedict(d);
2133 _PAM_LOG_FUNCTION_LEAVE("pam_sm_setcred", pamh, ctrl, ret);
2139 * Account management. We want to verify that the account exists
2140 * before returning PAM_SUCCESS
2143 int pam_sm_acct_mgmt(pam_handle_t *pamh, int flags,
2144 int argc, const char **argv)
2146 const char *username;
2147 int ret = PAM_USER_UNKNOWN;
2149 dictionary *d = NULL;
2151 /* parse arguments */
2152 int ctrl = _pam_parse(pamh, flags, argc, argv, &d);
2154 return PAM_SYSTEM_ERR;
2157 _PAM_LOG_FUNCTION_ENTER("pam_sm_acct_mgmt", pamh, ctrl, flags);
2160 /* Get the username */
2161 ret = pam_get_user(pamh, &username, NULL);
2162 if ((ret != PAM_SUCCESS) || (!username)) {
2163 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
2164 "can not get the username");
2165 ret = PAM_SERVICE_ERR;
2169 /* Verify the username */
2170 ret = valid_user(pamh, ctrl, username);
2173 /* some sort of system error. The log was already printed */
2174 ret = PAM_SERVICE_ERR;
2177 /* the user does not exist */
2178 _pam_log_debug(pamh, ctrl, LOG_NOTICE, "user '%s' not found",
2180 if (ctrl & WINBIND_UNKNOWN_OK_ARG) {
2184 ret = PAM_USER_UNKNOWN;
2187 pam_get_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD,
2188 (const void **)&tmp);
2190 ret = atoi((const char *)tmp);
2192 case PAM_AUTHTOK_EXPIRED:
2193 /* fall through, since new token is required in this case */
2194 case PAM_NEW_AUTHTOK_REQD:
2195 _pam_log(pamh, ctrl, LOG_WARNING,
2196 "pam_sm_acct_mgmt success but %s is set",
2197 PAM_WINBIND_NEW_AUTHTOK_REQD);
2198 _pam_log(pamh, ctrl, LOG_NOTICE,
2199 "user '%s' needs new password",
2201 /* PAM_AUTHTOKEN_REQD does not exist, but is documented in the manpage */
2202 ret = PAM_NEW_AUTHTOK_REQD;
2205 _pam_log(pamh, ctrl, LOG_WARNING,
2206 "pam_sm_acct_mgmt success");
2207 _pam_log(pamh, ctrl, LOG_NOTICE,
2208 "user '%s' granted access", username);
2214 /* Otherwise, the authentication looked good */
2215 _pam_log(pamh, ctrl, LOG_NOTICE,
2216 "user '%s' granted access", username);
2220 /* we don't know anything about this return value */
2221 _pam_log(pamh, ctrl, LOG_ERR,
2222 "internal module error (ret = %d, user = '%s')",
2224 ret = PAM_SERVICE_ERR;
2228 /* should not be reached */
2234 iniparser_freedict(d);
2237 _PAM_LOG_FUNCTION_LEAVE("pam_sm_acct_mgmt", pamh, ctrl, ret);
2243 int pam_sm_open_session(pam_handle_t *pamh, int flags,
2244 int argc, const char **argv)
2246 int ret = PAM_SYSTEM_ERR;
2247 dictionary *d = NULL;
2249 /* parse arguments */
2250 int ctrl = _pam_parse(pamh, flags, argc, argv, &d);
2252 ret = PAM_SYSTEM_ERR;
2256 _PAM_LOG_FUNCTION_ENTER("pam_sm_open_session", pamh, ctrl, flags);
2262 iniparser_freedict(d);
2265 _PAM_LOG_FUNCTION_LEAVE("pam_sm_open_session", pamh, ctrl, ret);
2271 int pam_sm_close_session(pam_handle_t *pamh, int flags,
2272 int argc, const char **argv)
2274 dictionary *d = NULL;
2275 int retval = PAM_SUCCESS;
2277 /* parse arguments */
2278 int ctrl = _pam_parse(pamh, flags, argc, argv, &d);
2280 retval = PAM_SYSTEM_ERR;
2284 _PAM_LOG_FUNCTION_ENTER("pam_sm_close_session", pamh, ctrl, flags);
2286 if (!(flags & PAM_DELETE_CRED)) {
2287 retval = PAM_SUCCESS;
2291 if (ctrl & WINBIND_KRB5_AUTH) {
2293 /* destroy the ccache here */
2294 struct winbindd_request request;
2295 struct winbindd_response response;
2297 const char *ccname = NULL;
2298 struct passwd *pwd = NULL;
2300 ZERO_STRUCT(request);
2301 ZERO_STRUCT(response);
2303 retval = pam_get_user(pamh, &user, "Username: ");
2305 _pam_log(pamh, ctrl, LOG_ERR,
2306 "could not identify user");
2311 _pam_log(pamh, ctrl, LOG_ERR,
2312 "username was NULL!");
2313 retval = PAM_USER_UNKNOWN;
2317 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
2318 "username [%s] obtained", user);
2320 ccname = pam_getenv(pamh, "KRB5CCNAME");
2321 if (ccname == NULL) {
2322 _pam_log_debug(pamh, ctrl, LOG_DEBUG,
2323 "user has no KRB5CCNAME environment");
2326 strncpy(request.data.logoff.user, user,
2327 sizeof(request.data.logoff.user) - 1);
2330 strncpy(request.data.logoff.krb5ccname, ccname,
2331 sizeof(request.data.logoff.krb5ccname) - 1);
2334 pwd = getpwnam(user);
2336 retval = PAM_USER_UNKNOWN;
2339 request.data.logoff.uid = pwd->pw_uid;
2341 request.flags = WBFLAG_PAM_KRB5 |
2342 WBFLAG_PAM_CONTACT_TRUSTDOM;
2344 retval = pam_winbind_request_log(pamh, ctrl,
2345 WINBINDD_PAM_LOGOFF,
2346 &request, &response, user);
2351 iniparser_freedict(d);
2354 _PAM_LOG_FUNCTION_LEAVE("pam_sm_close_session", pamh, ctrl, retval);
2360 * evaluate whether we need to re-authenticate with kerberos after a
2363 * @param pamh PAM handle
2364 * @param ctrl PAM winbind options.
2365 * @param user The username
2367 * @return boolean Returns true if required, false if not.
2370 static bool _pam_require_krb5_auth_after_chauthtok(pam_handle_t *pamh,
2375 /* Make sure that we only do this if a) the chauthtok got initiated
2376 * during a logon attempt (authenticate->acct_mgmt->chauthtok) b) any
2377 * later password change via the "passwd" command if done by the user
2380 char *new_authtok_reqd_during_auth = NULL;
2381 struct passwd *pwd = NULL;
2383 if (!(ctrl & WINBIND_KRB5_AUTH)) {
2387 _pam_get_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD_DURING_AUTH,
2388 &new_authtok_reqd_during_auth);
2389 pam_set_data(pamh, PAM_WINBIND_NEW_AUTHTOK_REQD_DURING_AUTH,
2392 if (new_authtok_reqd_during_auth) {
2396 pwd = getpwnam(user);
2401 if (getuid() == pwd->pw_uid) {
2410 int pam_sm_chauthtok(pam_handle_t * pamh, int flags,
2411 int argc, const char **argv)
2417 /* <DO NOT free() THESE> */
2419 char *pass_old, *pass_new;
2420 /* </DO NOT free() THESE> */
2425 dictionary *d = NULL;
2426 char *username_ret = NULL;
2427 struct winbindd_response response;
2429 ZERO_STRUCT(response);
2431 ctrl = _pam_parse(pamh, flags, argc, argv, &d);
2433 ret = PAM_SYSTEM_ERR;
2437 _PAM_LOG_FUNCTION_ENTER("pam_sm_chauthtok", pamh, ctrl, flags);
2439 /* clearing offline bit for the auth in the password change */
2440 ctrl &= ~WINBIND_CACHED_LOGIN;
2443 * First get the name of a user
2445 ret = pam_get_user(pamh, &user, "Username: ");
2447 _pam_log(pamh, ctrl, LOG_ERR,
2448 "password - could not identify user");
2453 _pam_log(pamh, ctrl, LOG_ERR, "username was NULL!");
2454 ret = PAM_USER_UNKNOWN;
2458 _pam_log_debug(pamh, ctrl, LOG_DEBUG, "username [%s] obtained", user);
2460 /* check if this is really a user in winbindd, not only in NSS */
2461 ret = valid_user(pamh, ctrl, user);
2464 ret = PAM_USER_UNKNOWN;
2467 ret = PAM_SYSTEM_ERR;
2474 * obtain and verify the current password (OLDAUTHTOK) for
2478 if (flags & PAM_PRELIM_CHECK) {
2479 time_t pwdlastset_prelim = 0;
2481 /* instruct user what is happening */
2482 #define greeting "Changing password for "
2483 Announce = (char *) malloc(sizeof(greeting) + strlen(user));
2484 if (Announce == NULL) {
2485 _pam_log(pamh, ctrl, LOG_CRIT,
2486 "password - out of memory");
2490 (void) strcpy(Announce, greeting);
2491 (void) strcpy(Announce + sizeof(greeting) - 1, user);
2494 lctrl = ctrl | WINBIND__OLD_PASSWORD;
2495 ret = _winbind_read_password(pamh, lctrl,
2497 "(current) NT password: ",
2499 (const char **) &pass_old);
2500 if (ret != PAM_SUCCESS) {
2501 _pam_log(pamh, ctrl, LOG_NOTICE,
2502 "password - (old) token not obtained");
2506 /* verify that this is the password for this user */
2508 ret = winbind_auth_request(pamh, ctrl, user, pass_old,
2509 NULL, NULL, 0, &response,
2510 &pwdlastset_prelim, NULL);
2512 if (ret != PAM_ACCT_EXPIRED &&
2513 ret != PAM_AUTHTOK_EXPIRED &&
2514 ret != PAM_NEW_AUTHTOK_REQD &&
2515 ret != PAM_SUCCESS) {
2520 pam_set_data(pamh, PAM_WINBIND_PWD_LAST_SET,
2521 (void *)pwdlastset_prelim, NULL);
2523 ret = pam_set_item(pamh, PAM_OLDAUTHTOK,
2524 (const void *) pass_old);
2526 if (ret != PAM_SUCCESS) {
2527 _pam_log(pamh, ctrl, LOG_CRIT,
2528 "failed to set PAM_OLDAUTHTOK");
2530 } else if (flags & PAM_UPDATE_AUTHTOK) {
2532 time_t pwdlastset_update = 0;
2535 * obtain the proposed password
2539 * get the old token back.
2542 ret = _pam_get_item(pamh, PAM_OLDAUTHTOK, &pass_old);
2544 if (ret != PAM_SUCCESS) {
2545 _pam_log(pamh, ctrl, LOG_NOTICE,
2546 "user not authenticated");
2550 lctrl = ctrl & ~WINBIND_TRY_FIRST_PASS_ARG;
2552 if (on(WINBIND_USE_AUTHTOK_ARG, lctrl)) {
2553 lctrl |= WINBIND_USE_FIRST_PASS_ARG;
2556 ret = PAM_AUTHTOK_ERR;
2557 while ((ret != PAM_SUCCESS) && (retry++ < MAX_PASSWD_TRIES)) {
2559 * use_authtok is to force the use of a previously entered
2560 * password -- needed for pluggable password strength checking
2563 ret = _winbind_read_password(pamh, lctrl,
2565 "Enter new NT password: ",
2566 "Retype new NT password: ",
2567 (const char **)&pass_new);
2569 if (ret != PAM_SUCCESS) {
2570 _pam_log_debug(pamh, ctrl, LOG_ALERT,
2572 "new password not obtained");
2573 pass_old = NULL;/* tidy up */
2578 * At this point we know who the user is and what they
2579 * propose as their new password. Verify that the new
2580 * password is acceptable.
2583 if (pass_new[0] == '\0') {/* "\0" password = NULL */
2589 * By reaching here we have approved the passwords and must now
2590 * rebuild the password database file.
2592 _pam_get_data(pamh, PAM_WINBIND_PWD_LAST_SET,
2593 &pwdlastset_update);
2595 ret = winbind_chauthtok_request(pamh, ctrl, user, pass_old,
2596 pass_new, pwdlastset_update);
2598 _pam_overwrite(pass_new);
2599 _pam_overwrite(pass_old);
2600 pass_old = pass_new = NULL;
2604 if (_pam_require_krb5_auth_after_chauthtok(pamh, ctrl, user)) {
2606 const char *member = NULL;
2607 const char *cctype = NULL;
2608 int warn_pwd_expire;
2610 member = get_member_from_config(pamh, argc, argv,
2612 cctype = get_krb5_cc_type_from_config(pamh, argc, argv,
2614 warn_pwd_expire = get_warn_pwd_expire_from_config(pamh,
2621 ret = winbind_auth_request(pamh, ctrl, user, pass_new,
2622 member, cctype, 0, &response,
2623 NULL, &username_ret);
2624 _pam_overwrite(pass_new);
2625 _pam_overwrite(pass_old);
2626 pass_old = pass_new = NULL;
2628 if (ret == PAM_SUCCESS) {
2630 /* warn a user if the password is about to
2632 _pam_warn_password_expiry(pamh, ctrl, &response,
2636 /* set some info3 info for other modules in the
2638 _pam_set_data_info3(pamh, ctrl, &response);
2640 /* put krb5ccname into env */
2641 _pam_setup_krb5_env(pamh, ctrl,
2642 response.data.auth.krb5ccname);
2645 pam_set_item(pamh, PAM_USER,
2647 _pam_log_debug(pamh, ctrl, LOG_INFO,
2648 "Returned user was '%s'",
2657 ret = PAM_SERVICE_ERR;
2662 iniparser_freedict(d);
2665 /* Deal with offline errors. */
2666 PAM_WB_REMARK_CHECK_RESPONSE(pamh, ctrl, response,
2667 "NT_STATUS_NO_LOGON_SERVERS");
2668 PAM_WB_REMARK_CHECK_RESPONSE(pamh, ctrl, response,
2669 "NT_STATUS_DOMAIN_CONTROLLER_NOT_FOUND");
2670 PAM_WB_REMARK_CHECK_RESPONSE(pamh, ctrl, response,
2671 "NT_STATUS_ACCESS_DENIED");
2673 _PAM_LOG_FUNCTION_LEAVE("pam_sm_chauthtok", pamh, ctrl, ret);
2680 /* static module data */
2682 struct pam_module _pam_winbind_modstruct = {
2684 pam_sm_authenticate,
2687 pam_sm_open_session,
2688 pam_sm_close_session,
2695 * Copyright (c) Andrew Tridgell <tridge@samba.org> 2000
2696 * Copyright (c) Tim Potter <tpot@samba.org> 2000
2697 * Copyright (c) Andrew Bartlettt <abartlet@samba.org> 2002
2698 * Copyright (c) Guenther Deschner <gd@samba.org> 2005-2007
2699 * Copyright (c) Jan Rêkorajski 1999.
2700 * Copyright (c) Andrew G. Morgan 1996-8.
2701 * Copyright (c) Alex O. Yuriev, 1996.
2702 * Copyright (c) Cristian Gafton 1996.
2703 * Copyright (C) Elliot Lee <sopwith@redhat.com> 1996, Red Hat Software.
2705 * Redistribution and use in source and binary forms, with or without
2706 * modification, are permitted provided that the following conditions
2708 * 1. Redistributions of source code must retain the above copyright
2709 * notice, and the entire permission notice in its entirety,
2710 * including the disclaimer of warranties.
2711 * 2. Redistributions in binary form must reproduce the above copyright
2712 * notice, this list of conditions and the following disclaimer in the
2713 * documentation and/or other materials provided with the distribution.
2714 * 3. The name of the author may not be used to endorse or promote
2715 * products derived from this software without specific prior
2716 * written permission.
2718 * ALTERNATIVELY, this product may be distributed under the terms of
2719 * the GNU Public License, in which case the provisions of the GPL are
2720 * required INSTEAD OF the above restrictions. (This clause is
2721 * necessary due to a potential bad interaction between the GPL and
2722 * the restrictions contained in a BSD-style copyright.)
2724 * THIS SOFTWARE IS PROVIDED `AS IS'' AND ANY EXPRESS OR IMPLIED
2725 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
2726 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2727 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
2728 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2729 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
2730 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2731 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
2732 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
2733 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
2734 * OF THE POSSIBILITY OF SUCH DAMAGE.