putpwent(3) - BetterMan

putpwent(3)

write a password file entry

distropkg manpages-dev@6.9.1-1dataset 2026-04-01T06:19:02Z+debian+ec4110e+mandoc:1.14.6-4

Synopsis

#include <stdio.h>
#include <sys/types.h>
#include <pwd.h>
int putpwent(const struct passwd *restrict 
p
, FILE *restrict 
stream
);
putpwent
():
Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _SVID_SOURCE

—

Options · 1

EINVAL

Invalid (NULL) argument given.

NAME

putpwent - write a password file entry

LIBRARY

Standard C library (libc, -lc)

SYNOPSIS

bash

#include <stdio.h>\n
\n#include <sys/types.h>\n
\n#include <pwd.h>

bash

int putpwent(const struct passwd *restrict \np\n, FILE *restrict \nstream\n);

putpwent():

bash


\n
    Since glibc 2.19:
\n
        _DEFAULT_SOURCE
\n
    glibc 2.19 and earlier:
\n
        _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:

bash

struct passwd {
\n
    char    *pw_name;        /* username */
\n
    char    *pw_passwd;      /* user password */
\n
    uid_t    pw_uid;         /* user ID */
\n
    gid_t    pw_gid;         /* group ID */
\n
    char    *pw_gecos;       /* real name */
\n
    char    *pw_dir;         /* home directory */
\n
    char    *pw_shell;       /* shell program */
};

RETURN VALUE

The putpwent() function returns 0 on success. On failure, it returns -1, and errno is set to indicate the error.

ERRORS

EINVAL: Invalid (NULL) argument given.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
putpwent ()	Thread safety	MT-Safe locale

STANDARDS

None.

HISTORY

SVr4.