Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

putpwent(3c) [opensolaris man page]

putpwent(3C)						   Standard C Library Functions 					      putpwent(3C)

NAME
putpwent - write password file entry SYNOPSIS
#include <pwd.h> int putpwent(const struct passwd *p, FILE *f); DESCRIPTION
The putpwent() function is the inverse of getpwent(). See getpwnam(3C). Given a pointer to a passwd structure created by getpwent(), getp- wuid(), or getpwnam(), putpwent() writes a line on the stream f that matches the format of /etc/passwd. RETURN VALUES
The putpwent() function returns a non-zero value if an error was detected during its operation. Otherwise, it returns 0. USAGE
The putpwent() function is of limited utility, since most password files are maintained as Network Information Service (NIS) files that cannot be updated with this function. For this reason, the use of this function is discouraged. If used at all, it should be used with put- spent(3C) to update the shadow file. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
getpwnam(3C), putspent(3C), attributes(5) SunOS 5.11 29 Dec 1996 putpwent(3C)

Check Out this Related Man Page

PUTPWENT(3)						     Linux Programmer's Manual						       PUTPWENT(3)

NAME
putpwent - write a password file entry SYNOPSIS
#include <stdio.h> #include <sys/types.h> #include <pwd.h> int putpwent(const struct passwd *p, FILE *stream); Feature Test Macro Requirements for glibc (see feature_test_macros(7)): putpwent(): _SVID_SOURCE DESCRIPTION
The putpwent() function writes a password entry from the structure p in the file associated with stream. The passwd structure is defined in <pwd.h> as follows: struct passwd { char *pw_name; /* username */ char *pw_passwd; /* user password */ uid_t pw_uid; /* user ID */ gid_t pw_gid; /* group ID */ char *pw_gecos; /* real name */ char *pw_dir; /* home directory */ char *pw_shell; /* shell program */ }; RETURN VALUE
The putpwent() function returns 0 on success, or -1 if an error occurs. ERRORS
EINVAL Invalid (NULL) argument given. CONFORMING TO
SVr4. SEE ALSO
endpwent(3), fgetpwent(3), getpw(3), getpwent(3), getpwnam(3), getpwuid(3), setpwent(3) COLOPHON
This page is part of release 3.27 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. GNU
2007-07-26 PUTPWENT(3)
Man Page