endgrent man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

getgrent(3C)							  getgrent(3C)

NAME
       getgrent(),  getgrgid(),	 getgrgid_r(),	getgrnam(), getgrnam_r(), set‐
       grent(), endgrent(), fgetgrent() - get group file entry

SYNOPSIS
   Obsolescent Interfaces
DESCRIPTION
       and are used to obtain group entries, and return a pointer to an object
       of  structure.  An entry may come from any of the sources for specified
       in the file.  See nsswitch.conf(4).

       The structure is defined in and includes the following members:

       When first called,  returns a pointer to the  first  structure  in  the
			   group database; thereafter, it returns a pointer to
			   the next structure in the database.	In  this  way,
			   successive  calls  can be used to search the entire
			   database;

       Has the effect of  rewinding  the  group	 database  to  allow  repeated
       searches;

       Can be called to indicate that group database processing is complete;

       Searches from the beginning of the group database until a numeric group
       ID
			   matching gid is found, and returns a pointer to the
			   particular structure in which it was found;

       Searches	 from  the  beginning of the group database until a group name
       matching
			   name is found, and returns a pointer to the partic‐
			   ular structure in which it was found;

       Returns a pointer to the next
			   structure  in the standard I/O stream stream, which
			   should be open for reading, and its contents should
			   match the format of

   Obsolescent Interfaces
       get group file entry.

   Reentrant Interfaces
       and  both  update  the  group pointed to by and store a pointer to that
       structure at the location pointed to by The structure shall contain  an
       entry  from the group database with a matching or Storage referenced by
       the group structure pointed to by shall be allocated  from  the	memory
       provided with the parameter, which is in size.  The maximum size needed
       for this buffer can be determined with the parameter.  A	 NULL  pointer
       is  returned at the location pointed to by on error or if the requested
       entry is not found.

RETURN VALUE
       and return a NULL pointer if an end-of-file or error is encountered  on
       reading.	 Otherwise, the return value points to an internal static area
       containing a valid structure.

       and return zero upon success.  Otherwise, an error number  is  returned
       to indicate the error.

ERRORS
       and fail if any of the following are true:

	      An I/O error has occurred.

	      OPEN_MAX	  file	descriptors  are currently open in the calling
			  process.

	      The maximum allowable number of files is currently
			  open in the system.

       The and functions will fail if:

	      Insufficient storage was supplied via
			  buffer and bufsize to contain the data to be	refer‐
			  enced by the resulting group structure.

WARNINGS
       The value returned by and points to an area that is overwritten by each
       call to any of the functions.  It must be copied if it is to be saved.

       Users of and  should  note  that	 these	interfaces  now	 conform  with
       POSIX.1c.   and	are  obsolescent interfaces.  These interfaces and the
       old prototypes of and are supported for compatibility with existing DCE
       applications only.

       The  interfaces	and  use  the  Dynamic Name Service Switch.  (See nss‐
       witch.conf(4).)	An application that uses these	interfaces  cannot  be
       fully archive bound.

DEPENDENCIES
   NFS
       ypcat(1).

FILES
SEE ALSO
       ypcat(1),     getgroups(2),    getpwent(3C),    stdio(3S),    group(4),
       thread_safety(5).

STANDARDS CONFORMANCE
								  getgrent(3C)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net