1/* $NetBSD: pam_appl.h,v 1.7 2023/06/30 21:46:20 christos Exp $ */ 2 3/*- 4 * Copyright (c) 2002-2003 Networks Associates Technology, Inc. 5 * Copyright (c) 2004-2017 Dag-Erling Sm��rgrav 6 * All rights reserved. 7 * 8 * This software was developed for the FreeBSD Project by ThinkSec AS and 9 * Network Associates Laboratories, the Security Research Division of 10 * Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 11 * ("CBOSS"), as part of the DARPA CHATS research program. 12 * 13 * Redistribution and use in source and binary forms, with or without 14 * modification, are permitted provided that the following conditions 15 * are met: 16 * 1. Redistributions of source code must retain the above copyright 17 * notice, this list of conditions and the following disclaimer. 18 * 2. Redistributions in binary form must reproduce the above copyright 19 * notice, this list of conditions and the following disclaimer in the 20 * documentation and/or other materials provided with the distribution. 21 * 3. The name of the author may not be used to endorse or promote 22 * products derived from this software without specific prior written 23 * permission. 24 * 25 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 28 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 29 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 30 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 31 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 32 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 33 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 34 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 35 * SUCH DAMAGE. 36 */ 37 38#ifndef SECURITY_PAM_APPL_H_INCLUDED 39#define SECURITY_PAM_APPL_H_INCLUDED 40 41#include <security/pam_types.h> 42#include <security/pam_constants.h> 43#include <security/openpam_attr.h> 44 45#ifdef __cplusplus 46extern "C" { 47#endif 48 49/* 50 * XSSO 4.2.1, 6 51 */ 52 53int 54pam_acct_mgmt(pam_handle_t *_pamh, 55 int _flags) 56 OPENPAM_NONNULL((1)); 57 58int 59pam_authenticate(pam_handle_t *_pamh, 60 int _flags) 61 OPENPAM_NONNULL((1)); 62 63int 64pam_chauthtok(pam_handle_t *_pamh, 65 int _flags) 66 OPENPAM_NONNULL((1)); 67 68int 69pam_close_session(pam_handle_t *_pamh, 70 int _flags) 71 OPENPAM_NONNULL((1)); 72 73int 74pam_end(pam_handle_t *_pamh, 75 int _status); 76 77int 78pam_get_data(const pam_handle_t *_pamh, 79 const char *_module_data_name, 80 const void **_data) 81 OPENPAM_NONNULL((1,2,3)); 82 83int 84pam_get_item(const pam_handle_t *_pamh, 85 int _item_type, 86 const void **_item) 87 OPENPAM_NONNULL((1,3)); 88 89int 90pam_get_user(pam_handle_t *_pamh, 91 const char **_user, 92 const char *_prompt) 93 OPENPAM_NONNULL((1,2)); 94 95const char * 96pam_getenv(pam_handle_t *_pamh, 97 const char *_name) 98 OPENPAM_NONNULL((1,2)); 99 100char ** 101pam_getenvlist(pam_handle_t *_pamh) 102 OPENPAM_NONNULL((1)); 103 104int 105pam_open_session(pam_handle_t *_pamh, 106 int _flags) 107 OPENPAM_NONNULL((1)); 108 109int 110pam_putenv(pam_handle_t *_pamh, 111 const char *_namevalue) 112 OPENPAM_NONNULL((1,2)); 113 114int 115pam_set_data(pam_handle_t *_pamh, 116 const char *_module_data_name, 117 void *_data, 118 void (*_cleanup)(pam_handle_t *_pamh, 119 void *_data, 120 int _pam_end_status)) 121 OPENPAM_NONNULL((1,2)); 122 123int 124pam_set_item(pam_handle_t *_pamh, 125 int _item_type, 126 const void *_item) 127 OPENPAM_NONNULL((1)); 128 129int 130pam_setcred(pam_handle_t *_pamh, 131 int _flags) 132 OPENPAM_NONNULL((1)); 133 134int 135pam_start(const char *_service, 136 const char *_user, 137 const struct pam_conv *_pam_conv, 138 pam_handle_t **_pamh) 139 OPENPAM_NONNULL((4)); 140 141const char * 142pam_strerror(const pam_handle_t *_pamh, 143 int _error_number); 144 145/* 146 * Single Sign-On extensions 147 */ 148#if 0 149int 150pam_authenticate_secondary(pam_handle_t *_pamh, 151 char *_target_username, 152 char *_target_module_type, 153 char *_target_authn_domain, 154 char *_target_supp_data, 155 char *_target_module_authtok, 156 int _flags); 157 158int 159pam_get_mapped_authtok(pam_handle_t *_pamh, 160 const char *_target_module_username, 161 const char *_target_module_type, 162 const char *_target_authn_domain, 163 size_t *_target_authtok_len, 164 unsigned char **_target_module_authtok); 165 166int 167pam_get_mapped_username(pam_handle_t *_pamh, 168 const char *_src_username, 169 const char *_src_module_type, 170 const char *_src_authn_domain, 171 const char *_target_module_type, 172 const char *_target_authn_domain, 173 char **_target_module_username); 174 175int 176pam_set_mapped_authtok(pam_handle_t *_pamh, 177 const char *_target_module_username, 178 size_t _target_authtok_len, 179 unsigned char *_target_module_authtok, 180 const char *_target_module_type, 181 const char *_target_authn_domain); 182 183int 184pam_set_mapped_username(pam_handle_t *_pamh, 185 char *_src_username, 186 char *_src_module_type, 187 char *_src_authn_domain, 188 char *_target_module_username, 189 char *_target_module_type, 190 char *_target_authn_domain); 191#endif /* 0 */ 192 193#ifdef __cplusplus 194} 195#endif 196 197#endif /* !SECURITY_PAM_APPL_H_INCLUDED */ 198