Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HESIOD(3)		   Library Functions Manual		     HESIOD(3)

NAME
       hesiod_getpwnam,	hesiod_getpwuid, hesiod_free_passwd - Hesiod functions
       for retrieving passwd information

SYNOPSIS
       #include	<hesiod.h>

       struct passwd *hesiod_getpwnam(void *context, const char	*name)
       struct passwd *hesiod_getpwuid(void *context, uid_t uid)
       void hesiod_free_passwd(void *context, struct passwd *pw)

       cc file.c -lhesiod

DESCRIPTION
       This family of functions	allows you to retrieve passwd database	infor-
       mation  using Hesiod.  To perform lookups, you need an initialized Hes-
       iod context; see	hesiod(3) for details.	You may	look up	passwd	infor-
       mation by name or by uid; information is	returned in the	same format as
       by getpwnam or getpwuid.	 It is the  caller's  responsibility  to  call
       hesiod_free_passwd with the returned passwd entry to free the resources
       used by the passwd entry.

       Hesiod queries for passwd information are made using the	``passwd''  or
       ``uid'' Hesiod type, using either the username or the decimal represen-
       tation of the uid as the	Hesiod name.  The corresponding	records	should
       be  a  colon-separated  list  of	 fields	giving the username, encrypted
       password, uid, gid, GECOS information, home directory, and shell	of the
       user.

RETURN VALUES
       On failure, hesiod_getpwnam and hesiod_getpwuid return NULL and set the
       global variable errno to	indicate the error.

ERRORS
       These calls may fail for	any of the reasons the routine	hesiod_resolve
       may fail.

SEE ALSO
       hesiod(3)

			       30 November 1996			     HESIOD(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hesiod_getpwnam&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help