*** UNIX MANUAL PAGE BROWSER ***

A Nergahak database for man pages research.

Navigation

Directory Browser

1Browse 4.4BSD4.4BSD
1Browse Digital UNIXDigital UNIX 4.0e
1Browse FreeBSDFreeBSD 14.3
1Browse MINIXMINIX 3.4.0rc6-d5e4fc0
1Browse NetBSDNetBSD 10.1
1Browse OpenBSDOpenBSD 7.7
1Browse UNIX v7Version 7 UNIX
1Browse UNIX v10Version 10 UNIX

Manual Page Search

Manual Page Result

0 Command: pw_dup | Section: 3 | Source: OpenBSD | File: pw_dup.3
PW_DUP(3) FreeBSD Library Functions Manual PW_DUP(3) NAME pw_dup - make a copy of a struct passwd SYNOPSIS #include <pwd.h> struct passwd * pw_dup(const struct passwd *pw); DESCRIPTION The pw_dup() function allocates sufficient memory for a copy of the struct passwd pw, does the copy, and returns a pointer to it. This is useful as subsequent calls to getpwent(), getpwnam(), and getpwuid() will overwrite the data they returned from previous calls. The returned pointer should be deallocated by a single call to free(3). Since pw_dup() allocates space for the copy in one chunk, it is not necessary to free the individual strings contained in the returned struct passwd. If insufficient memory is available, NULL is returned. EXAMPLES The following will make a copy of the struct passwd for root and store it in "pw_save": struct passwd *pw, *pw_save; if ((pw = getpwnam("root")) == NULL) { fprintf(stderr, "Cannot find root in the password file.\n"); exit(1); } if ((pw_save = pw_dup(pw)) == NULL) { fprintf(stderr, "Out of memory.\n"); exit(1); } ERRORS pw_dup() function may fail and set the external variable errno for any of the errors specified for the library function malloc(3). SEE ALSO free(3), getpwent(3), malloc(3) HISTORY The pw_dup() function first appeared in OpenBSD 2.9. FreeBSD 14.1-RELEASE-p8 January 25, 2019 FreeBSD 14.1-RELEASE-p8

Navigation Options