pam_setcred.c revision 91799
1/*- 2 * Copyright (c) 2002 Networks Associates Technologies, Inc. 3 * All rights reserved. 4 * 5 * This software was developed for the FreeBSD Project by ThinkSec AS and 6 * NAI Labs, the Security Research Division of Network Associates, Inc. 7 * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 8 * DARPA CHATS research program. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 3. The name of the author may not be used to endorse or promote 19 * products derived from this software without specific prior written 20 * permission. 21 * 22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 26 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32 * SUCH DAMAGE. 33 * 34 * $P4: //depot/projects/openpam/lib/pam_setcred.c#7 $ 35 */ 36 37#include <sys/param.h> 38 39#include <security/pam_appl.h> 40 41#include "openpam_impl.h" 42 43/* 44 * XSSO 4.2.1 45 * XSSO 6 page 57 46 * 47 * Modify / delete user credentials for an authentication service 48 */ 49 50int 51pam_setcred(pam_handle_t *pamh, 52 int flags) 53{ 54 55 return (openpam_dispatch(pamh, PAM_SM_SETCRED, flags)); 56} 57 58/* 59 * Error codes: 60 * 61 * =openpam_dispatch 62 * =pam_sm_setcred 63 * !PAM_IGNORE 64 */ 65 66/** 67 * The =pam_setcred function manages the application's credentials. 68 * The operation to perform is specified by the =flags argument: 69 * 70 * PAM_ESTABLISH_CRED: 71 * Establish the credentials of the target user. 72 * PAM_DELETE_CRED: 73 * Revoke all established credentials. 74 * PAM_REINITIALIZE_CRED: 75 * Fully reinitialise credentials. 76 * PAM_REFRESH_CRED: 77 * Refresh credentials. 78 */ 79