pam_get_item.c revision 92289
191094Sdes/*- 292289Sdes * Copyright (c) 2002 Networks Associates Technology, Inc. 391094Sdes * All rights reserved. 491094Sdes * 591094Sdes * This software was developed for the FreeBSD Project by ThinkSec AS and 691094Sdes * NAI Labs, the Security Research Division of Network Associates, Inc. 791094Sdes * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the 891094Sdes * DARPA CHATS research program. 991094Sdes * 1091094Sdes * Redistribution and use in source and binary forms, with or without 1191094Sdes * modification, are permitted provided that the following conditions 1291094Sdes * are met: 1391094Sdes * 1. Redistributions of source code must retain the above copyright 1491094Sdes * notice, this list of conditions and the following disclaimer. 1591094Sdes * 2. Redistributions in binary form must reproduce the above copyright 1691094Sdes * notice, this list of conditions and the following disclaimer in the 1791094Sdes * documentation and/or other materials provided with the distribution. 1891094Sdes * 3. The name of the author may not be used to endorse or promote 1991094Sdes * products derived from this software without specific prior written 2091094Sdes * permission. 2191094Sdes * 2291094Sdes * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 2391094Sdes * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 2491094Sdes * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 2591094Sdes * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 2691094Sdes * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 2791094Sdes * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 2891094Sdes * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 2991094Sdes * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 3091094Sdes * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 3191094Sdes * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 3291094Sdes * SUCH DAMAGE. 3391094Sdes * 3492289Sdes * $P4: //depot/projects/openpam/lib/pam_get_item.c#10 $ 3591094Sdes */ 3691094Sdes 3791094Sdes#include <sys/param.h> 3891094Sdes 3991094Sdes#include <security/pam_appl.h> 4091094Sdes 4191094Sdes#include "openpam_impl.h" 4291094Sdes 4391094Sdes/* 4491094Sdes * XSSO 4.2.1 4591094Sdes * XSSO 6 page 46 4691094Sdes * 4791094Sdes * Get PAM information 4891094Sdes */ 4991094Sdes 5091094Sdesint 5191094Sdespam_get_item(pam_handle_t *pamh, 5291094Sdes int item_type, 5391094Sdes const void **item) 5491094Sdes{ 5591094Sdes if (pamh == NULL) 5691094Sdes return (PAM_SYSTEM_ERR); 5791094Sdes 5891094Sdes switch (item_type) { 5991094Sdes case PAM_SERVICE: 6091094Sdes case PAM_USER: 6191094Sdes case PAM_AUTHTOK: 6291094Sdes case PAM_OLDAUTHTOK: 6391094Sdes case PAM_TTY: 6491094Sdes case PAM_RHOST: 6591094Sdes case PAM_RUSER: 6691094Sdes case PAM_CONV: 6791094Sdes case PAM_USER_PROMPT: 6891094Sdes case PAM_AUTHTOK_PROMPT: 6991094Sdes *item = pamh->item[item_type]; 7091094Sdes return (PAM_SUCCESS); 7191094Sdes default: 7291100Sdes return (PAM_SYMBOL_ERR); 7391094Sdes } 7491094Sdes} 7591100Sdes 7691100Sdes/* 7791100Sdes * Error codes: 7891100Sdes * 7991100Sdes * PAM_SYMBOL_ERR 8091100Sdes * PAM_SYSTEM_ERR 8191100Sdes */ 8291100Sdes 8391100Sdes/** 8491100Sdes * The =pam_get_item function stores a pointer to the item specified by 8591100Sdes * the =item_type argument in the location specified by the =item 8691100Sdes * argument. 8791100Sdes * The item is retrieved from the PAM context specified by the =pamh 8891100Sdes * argument. 8991100Sdes * The following item types are recognized: 9091100Sdes * 9191100Sdes * =PAM_SERVICE: 9291100Sdes * The name of the requesting service. 9391100Sdes * =PAM_USER: 9491100Sdes * The name of the user the application is trying to 9591100Sdes * authenticate. 9691100Sdes * =PAM_TTY: 9791100Sdes * The name of the current terminal. 9891100Sdes * =PAM_RHOST: 9991100Sdes * The name of the applicant's host. 10091100Sdes * =PAM_CONV: 10191100Sdes * A =struct pam_conv describing the current conversation 10291100Sdes * function. 10391100Sdes * =PAM_AUTHTOK: 10491100Sdes * The current authentication token. 10591100Sdes * =PAM_OLDAUTHTOK: 10691100Sdes * The expired authentication token. 10791100Sdes * =PAM_RUSER: 10891100Sdes * The name of the applicant. 10991100Sdes * =PAM_USER_PROMPT: 11091100Sdes * The prompt to use when asking the applicant for a user 11191100Sdes * name to authenticate as. 11291100Sdes * =PAM_AUTHTOK_PROMPT: 11391100Sdes * The prompt to use when asking the applicant for an 11491100Sdes * authentication token. 11591100Sdes * 11691100Sdes * See =pam_start for a description of =struct pam_conv. 11791100Sdes * 11891100Sdes * >pam_set_item 11991100Sdes */ 120