nss/nss.h

   1 /* Copyright (C) 1996-2019 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, see
  16    <https://www.gnu.org/licenses/>.  */
  17
  18 /* Define interface to NSS.  This is meant for the interface functions
  19    and for implementors of new services.  */
  20
  21 #ifndef _NSS_H
  22 #define _NSS_H  1
  23
  24 #include <features.h>
  25 #include <stdint.h>
  26
  27
  28 __BEGIN_DECLS
  29
  30 /* Possible results of lookup using a nss_* function.  */
  31 enum nss_status
  32 {
  33   NSS_STATUS_TRYAGAIN = -2,
  34   NSS_STATUS_UNAVAIL,
  35   NSS_STATUS_NOTFOUND,
  36   NSS_STATUS_SUCCESS,
  37   NSS_STATUS_RETURN
  38 };
  39
  40
  41 /* Data structure used for the 'gethostbyname4_r' function.  */
  42 struct gaih_addrtuple
  43   {
  44     struct gaih_addrtuple *next;
  45     char *name;
  46     int family;
  47     uint32_t addr[4];
  48     uint32_t scopeid;
  49   };
  50
  51
  52 /* Overwrite service selection for database DBNAME using specification
  53    in STRING.
  54    This function should only be used by system programs which have to
  55    work around non-existing services (e.e., while booting).
  56    Attention: Using this function repeatedly will slowly eat up the
  57    whole memory since previous selection data cannot be freed.  */
  58 extern int __nss_configure_lookup (const char *__dbname,
  59                                    const char *__string) __THROW;
  60
  61 __END_DECLS
  62
  63 #endif /* nss.h */