pam_appl.h revision 114536
1/*- 2 * Copyright (c) 2002 Networks Associates Technology, Inc. 3 * All rights reserved. 4 * 5 * This software was developed for the FreeBSD Project by ThinkSec AS and 6 * Network Associates Laboratories, the Security Research Division of 7 * Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 8 * ("CBOSS"), as part of the 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/include/security/pam_appl.h#11 $ 35 */ 36 37#ifndef _PAM_APPL_H_INCLUDED 38#define _PAM_APPL_H_INCLUDED 39 40#include <security/pam_types.h> 41#include <security/pam_constants.h> 42 43#ifdef __cplusplus 44extern "C" { 45#endif 46 47/* 48 * XSSO 4.2.1, 6 49 */ 50 51int 52pam_acct_mgmt(pam_handle_t *_pamh, 53 int _flags); 54 55int 56pam_authenticate(pam_handle_t *_pamh, 57 int _flags); 58 59int 60pam_chauthtok(pam_handle_t *_pamh, 61 int _flags); 62 63int 64pam_close_session(pam_handle_t *_pamh, 65 int _flags); 66 67int 68pam_end(pam_handle_t *_pamh, 69 int _status); 70 71int 72pam_get_data(pam_handle_t *_pamh, 73 const char *_module_data_name, 74 const void **_data); 75 76int 77pam_get_item(pam_handle_t *_pamh, 78 int _item_type, 79 const void **_item); 80 81int 82pam_get_user(pam_handle_t *_pamh, 83 const char **_user, 84 const char *_prompt); 85 86const char * 87pam_getenv(pam_handle_t *_pamh, 88 const char *_name); 89 90char ** 91pam_getenvlist(pam_handle_t *_pamh); 92 93int 94pam_open_session(pam_handle_t *_pamh, 95 int _flags); 96 97int 98pam_putenv(pam_handle_t *_pamh, 99 const char *_namevalue); 100 101int 102pam_set_data(pam_handle_t *_pamh, 103 const char *_module_data_name, 104 void *_data, 105 void (*_cleanup)(pam_handle_t *_pamh, 106 void *_data, 107 int _pam_end_status)); 108 109int 110pam_set_item(pam_handle_t *_pamh, 111 int _item_type, 112 const void *_item); 113 114int 115pam_setcred(pam_handle_t *_pamh, 116 int _flags); 117 118int 119pam_start(const char *_service, 120 const char *_user, 121 const struct pam_conv *_pam_conv, 122 pam_handle_t **_pamh); 123 124const char * 125pam_strerror(pam_handle_t *_pamh, 126 int _error_number); 127 128/* 129 * Single Sign-On extensions 130 */ 131#if 0 132int 133pam_authenticate_secondary(pam_handle_t *_pamh, 134 char *_target_username, 135 char *_target_module_type, 136 char *_target_authn_domain, 137 char *_target_supp_data, 138 char *_target_module_authtok, 139 int _flags); 140 141int 142pam_get_mapped_authtok(pam_handle_t *_pamh, 143 const char *_target_module_username, 144 const char *_target_module_type, 145 const char *_target_authn_domain, 146 size_t *_target_authtok_len, 147 unsigned char **_target_module_authtok); 148 149int 150pam_get_mapped_username(pam_handle_t *_pamh, 151 const char *_src_username, 152 const char *_src_module_type, 153 const char *_src_authn_domain, 154 const char *_target_module_type, 155 const char *_target_authn_domain, 156 char **_target_module_username); 157 158int 159pam_set_mapped_authtok(pam_handle_t *_pamh, 160 const char *_target_module_username, 161 size_t _target_authtok_len, 162 unsigned char *_target_module_authtok, 163 const char *_target_module_type, 164 const char *_target_authn_domain); 165 166int 167pam_set_mapped_username(pam_handle_t *_pamh, 168 char *_src_username, 169 char *_src_module_type, 170 char *_src_authn_domain, 171 char *_target_module_username, 172 char *_target_module_type, 173 char *_target_authn_domain); 174#endif /* 0 */ 175 176#ifdef __cplusplus 177} 178#endif 179 180#endif 181