libmisc/xgetpwnam.c

   1 /*
   2  * Copyright (c) 2007 - 2009, Nicolas François
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  * 3. The name of the copyright holders or contributors may not be used to
  14  *    endorse or promote products derived from this software without
  15  *    specific prior written permission.
  16  *
  17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  20  * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
  21  * HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28  */
  29
  30 /*
  31  * According to the Linux-PAM documentation:
  32  *
  33  *  4.1. Care about standard library calls
  34  *
  35  *  In general, writers of authorization-granting applications should
  36  *  assume that each module is likely to call any or all 'libc' functions.
  37  *  For 'libc' functions that return pointers to static/dynamically
  38  *  allocated structures (ie.  the library allocates the memory and the
  39  *  user is not expected to 'free()' it) any module call to this function
  40  *  is likely to corrupt a pointer previously obtained by the application.
  41  *  The application programmer should either re-call such a 'libc'
  42  *  function after a call to the Linux-PAM library, or copy the structure
  43  *  contents to some safe area of memory before passing control to the
  44  *  Linux-PAM library.
  45  *
  46  *  Two important function classes that fall into this category are
  47  *  getpwnam(3) and syslog(3).
  48  *
  49  * This file provide wrapper to the getpwnam or getpwnam_r functions.
  50  */
  51
  52 #include <config.h>
  53
  54 #include "pwio.h"
  55
  56 #define LOOKUP_TYPE     struct passwd
  57 #define FUNCTION_NAME   getpwnam
  58 #define ARG_TYPE        const char *
  59 #define ARG_NAME        name
  60 #define DUP_FUNCTION    __pw_dup
  61 #define HAVE_FUNCTION_R (defined HAVE_GETPWNAM_R)
  62
  63 #include "xgetXXbyYY.c"
  64