OSDN Git Service

LDP: Update original to LDP v3.68
[linuxjm/LDP_man-pages.git] / original / man3 / putgrent.3
1 .\" Copyright 2003 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
2 .\"
3 .\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
4 .\" Distributed under GPL
5 .\" %%%LICENSE_END
6 .\"
7 .TH PUTGRENT 3 2003-09-09 "GNU" "Linux Programmer's Manual"
8 .SH NAME
9 putgrent \- write a group database entry to a file
10 .SH SYNOPSIS
11 .BR "#define _GNU_SOURCE" "         /* See feature_test_macros(7) */"
12 .br
13 .B #include <grp.h>
14 .sp
15 .BI "int putgrent(const struct group *" grp ", FILE *" fp );
16 .SH DESCRIPTION
17 The
18 .BR putgrent ()
19 function is the counterpart for
20 .BR fgetgrent (3).
21 The function writes the content of the provided
22 .IR "struct group"
23 into the
24 file pointed to by
25 .IR fp .
26 The list of group members must be NULL-terminated or NULL-initialized.
27 .sp
28 The
29 .IR "struct group"
30 is defined as follows:
31 .sp
32 .in +4n
33 .nf
34 struct group {
35     char   *gr_name;      /* group name */
36     char   *gr_passwd;    /* group password */
37     gid_t   gr_gid;       /* group ID */
38     char  **gr_mem;       /* group members */
39 };
40 .fi
41 .in
42 .SH RETURN VALUE
43 The function returns zero on success, and a nonzero value on error.
44 .SH CONFORMING TO
45 This function is a GNU extension.
46 .SH SEE ALSO
47 .BR fgetgrent (3),
48 .BR getgrent (3),
49 .BR group (5)
50 .SH COLOPHON
51 This page is part of release 3.68 of the Linux
52 .I man-pages
53 project.
54 A description of the project,
55 information about reporting bugs,
56 and the latest version of this page,
57 can be found at
58 \%http://www.kernel.org/doc/man\-pages/.