putgrent Subroutine
Purpose
Updates group descriptions.
Library
Standard C Library (libc.a)
Syntax
int putgrent (grp, fp)
struct group *grp;
FILE *fp;
Description
The putgrent subroutine updates group descriptions. The grp parameter is a pointer to a group structure, as created by the getgrent, getgrgid, and getgrnam subroutines.
The putgrent subroutine writes a line on the stream specified by the fp parameter. The stream matches the format of /etc/group.
The gr_passwd field of the line written is always set to ! (exclamation point).
Parameters
| Item | Description |
|---|---|
| grp | Pointer to a group structure. |
| fp | Specifies the stream to be written to. |
Return Values
The putgrent subroutine returns a value of 0 upon successful completion. If putgrent fails, a nonzero value is returned.
Files
/etc/group
/etc/security/group