Update to LGPL v2.1.
[platform/upstream/glibc.git] / grp / grp.h
index 1059df0..3324771 100644 (file)
--- a/grp/grp.h
+++ b/grp/grp.h
@@ -1,20 +1,20 @@
-/* Copyright (C) 1991, 92, 95, 96, 97, 98 Free Software Foundation, Inc.
+/* Copyright (C) 1991,92,95,96,97,98,99,2000,01 Free Software Foundation, Inc.
    This file is part of the GNU C Library.
 
    The GNU C Library is free software; you can redistribute it and/or
-   modify it under the terms of the GNU Library General Public License as
-   published by the Free Software Foundation; either version 2 of the
-   License, or (at your option) any later version.
+   modify it under the terms of the GNU Lesser General Public
+   License as published by the Free Software Foundation; either
+   version 2.1 of the License, or (at your option) any later version.
 
    The GNU C Library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-   Library General Public License for more details.
+   Lesser General Public License for more details.
 
-   You should have received a copy of the GNU Library General Public
-   License along with the GNU C Library; see the file COPYING.LIB.  If not,
-   write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
-   Boston, MA 02111-1307, USA.  */
+   You should have received a copy of the GNU Lesser General Public
+   License along with the GNU C Library; if not, write to the Free
+   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+   02111-1307 USA.  */
 
 /*
  *     POSIX Standard: 9.2.1 Group Database Access     <grp.h>
@@ -34,9 +34,9 @@ __BEGIN_DECLS
 
 
 /* For the Single Unix specification we must define this type here.  */
-#if defined __USE_XOPEN && !defined gid_t
+#if defined __USE_XOPEN && !defined __gid_t_defined
 typedef __gid_t gid_t;
-# define gid_t gid_t
+# define __gid_t_defined
 #endif
 
 /* The group structure.         */
@@ -57,30 +57,31 @@ struct group
 
 #if defined __USE_SVID || defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 /* Rewind the group-file stream.  */
-extern void setgrent __P ((void));
+extern void setgrent (void) __THROW;
 
 /* Close the group-file stream.  */
-extern void endgrent __P ((void));
+extern void endgrent (void) __THROW;
 
 /* Read an entry from the group-file stream, opening it if necessary.  */
-extern struct group *getgrent __P ((void));
+extern struct group *getgrent (void) __THROW;
 #endif
 
 #ifdef __USE_SVID
 /* Read a group entry from STREAM.  */
-extern struct group *fgetgrent __P ((FILE *__stream));
+extern struct group *fgetgrent (FILE *__stream) __THROW;
 #endif
 
 #ifdef __USE_GNU
 /* Write the given entry onto the given stream.  */
-extern int putgrent __P ((__const struct group *__p, FILE *__f));
+extern int putgrent (__const struct group *__restrict __p,
+                    FILE *__restrict __f) __THROW;
 #endif
 
 /* Search for an entry with a matching group ID.  */
-extern struct group *getgrgid __P ((__gid_t __gid));
+extern struct group *getgrgid (__gid_t __gid) __THROW;
 
 /* Search for an entry with a matching group name.  */
-extern struct group *getgrnam __P ((__const char *__name));
+extern struct group *getgrnam (__const char *__name) __THROW;
 
 #if defined __USE_POSIX || defined __USE_MISC
 
@@ -98,27 +99,30 @@ extern struct group *getgrnam __P ((__const char *__name));
    other reentrant functions so the chances are good this is what the
    POSIX people would choose.  */
 
-# if defined __USE_SVID || defined __USE_BSD || defined __USE_XOPEN_EXTENDED
-extern int getgrent_r __P ((struct group *__resultbuf, char *buffer,
-                           size_t __buflen, struct group **__result));
+# ifdef __USE_GNU
+extern int getgrent_r (struct group *__restrict __resultbuf,
+                      char *__restrict __buffer, size_t __buflen,
+                      struct group **__restrict __result) __THROW;
 # endif
 
 /* Search for an entry with a matching group ID.  */
-extern int getgrgid_r __P ((__gid_t __gid, struct group *__resultbuf,
-                           char *buffer, size_t __buflen,
-                           struct group **__result));
+extern int getgrgid_r (__gid_t __gid, struct group *__restrict __resultbuf,
+                      char *__restrict __buffer, size_t __buflen,
+                      struct group **__restrict __result) __THROW;
 
 /* Search for an entry with a matching group name.  */
-extern int getgrnam_r __P ((__const char *__name, struct group *__resultbuf,
-                           char *buffer, size_t __buflen,
-                           struct group **__result));
+extern int getgrnam_r (__const char *__restrict __name,
+                      struct group *__restrict __resultbuf,
+                      char *__restrict __buffer, size_t __buflen,
+                      struct group **__restrict __result) __THROW;
 
 # ifdef        __USE_SVID
 /* Read a group entry from STREAM.  This function is not standardized
    an probably never will.  */
-extern int fgetgrent_r __P ((FILE * __stream, struct group *__resultbuf,
-                            char *buffer, size_t __buflen,
-                            struct group **__result));
+extern int fgetgrent_r (FILE *__restrict __stream,
+                       struct group *__restrict __resultbuf,
+                       char *__restrict __buffer, size_t __buflen,
+                       struct group **__restrict __result) __THROW;
 # endif
 
 #endif /* POSIX or reentrant */
@@ -130,12 +134,18 @@ extern int fgetgrent_r __P ((FILE * __stream, struct group *__resultbuf,
 # include <stddef.h>
 
 /* Set the group set for the current user to GROUPS (N of them).  */
-extern int setgroups __P ((size_t __n, __const __gid_t *__groups));
+extern int setgroups (size_t __n, __const __gid_t *__groups) __THROW;
+
+/* Store at most *NGROUPS members of the group set for USER into
+   *GROUPS.  Also include GROUP.  The actual number of groups found is
+   returned in *NGROUPS.  Return -1 if the if *NGROUPS is too small.  */
+extern int getgrouplist (__const char *__user, __gid_t __group,
+                        __gid_t *__groups, int *__ngroups) __THROW;
 
 /* Initialize the group set for the current user
    by reading the group database and using all groups
    of which USER is a member.  Also include GROUP.  */
-extern int initgroups __P ((__const char *__user, __gid_t __group));
+extern int initgroups (__const char *__user, __gid_t __group) __THROW;
 
 #endif /* Use BSD.  */