source: openpam/trunk/lib/openpam_impl.h @ 25

Last change on this file since 25 was 25, checked in by des, 13 years ago

Store options, and pass them to modules.

Replace the "dispatching" flag with a pam_chain_t pointer. It is set
to point at the currently executing module right before calling the
module, and cleared right after the module returns. Note that this
isn't intended to prevent reentrancy in multi-threaded applications,
but simply to prevent modules from using the application interface.

When recursion is detected, return PAM_ABORT rather than
PAM_SYSTEM_ERR, since this is a programmatical error rather than
a runtime one.

Sponsored by: DARPA, NAI Labs

  • Property svn:keywords set to Id LastChangedRevision HeadURL LastChangedDate LastChangedBy
File size: 3.4 KB
Line 
1/*-
2 * Copyright (c) 2001 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 * $Id$
35 */
36
37#ifndef _OPENPAM_IMPL_H_INCLUDED
38#define _OPENPAM_IMPL_H_INCLUDED
39
40#include <security/openpam.h>
41
42/*
43 * Control flags
44 */
45#define PAM_REQUIRED            1
46#define PAM_REQUISITE           2
47#define PAM_SUFFICIENT          3
48#define PAM_OPTIONAL            4
49#define PAM_NUM_CONTROLFLAGS    5
50
51/*
52 * Chains
53 */
54#define PAM_AUTH                0
55#define PAM_ACCOUNT             1
56#define PAM_SESSION             2
57#define PAM_PASSWORD            3
58#define PAM_NUM_CHAINS          4
59
60#define PAM_ACCT_MGMT           0
61#define PAM_AUTHENTICATE        1
62#define PAM_CHAUTHTOK           2
63#define PAM_CLOSE_SESSION       3
64#define PAM_OPEN_SESSION        4
65#define PAM_SETCRED             5
66#define PAM_NUM_PRIMITIVES      6
67
68extern const char *_pam_sm_func_name[PAM_NUM_PRIMITIVES];
69
70typedef int (*pam_func_t)(pam_handle_t *, int, int, const char **);
71
72typedef struct pam_chain pam_chain_t;
73struct pam_chain {
74        int              flag;
75        char            *modpath;
76        int              optc;
77        char           **optv;
78        pam_chain_t     *next;
79        void            *dlh;
80        pam_func_t       primitive[PAM_NUM_PRIMITIVES];
81};
82
83#define PAM_NUM_ITEMS          10
84
85typedef struct pam_data pam_data_t;
86struct pam_data {
87        char            *name;
88        void            *data;
89        void            (*cleanup)(pam_handle_t *, void *, int);
90        pam_data_t      *next;
91};
92
93struct pam_handle {
94        char            *service;
95
96        /* chains */
97        pam_chain_t     *chains[PAM_NUM_CHAINS];
98        pam_chain_t     *current;
99
100        /* items and data */
101        void            *item[PAM_NUM_ITEMS];
102        pam_data_t      *module_data;
103
104        /* environment list */
105        char           **env;
106        int              env_count;
107        int              env_size;
108};
109
110#define PAM_OTHER       "other"
111
112int             openpam_dispatch(pam_handle_t *, int, int);
113int             openpam_findenv(pam_handle_t *, const char *, size_t);
114int             openpam_add_module(pam_handle_t *, int, int,
115                                   const char *, int, const char **);
116void            openpam_clear_chains(pam_handle_t *);
117
118#endif
Note: See TracBrowser for help on using the repository browser.