File: hesiod_getpwnam.3

package info (click to toggle)
hesiod 3.0.2-20
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 716 kB
  • ctags: 111
  • sloc: ansic: 1,269; sh: 236; makefile: 142
file content (63 lines) | stat: -rw-r--r-- 2,330 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
.\" $Id: hesiod_getpwnam.3,v 1.1 1996/12/08 21:38:24 ghudson Exp $
.\"
.\" Copyright 1996 by the Massachusetts Institute of Technology.
.\"
.\" Permission to use, copy, modify, and distribute this
.\" software and its documentation for any purpose and without
.\" fee is hereby granted, provided that the above copyright
.\" notice appear in all copies and that both that copyright
.\" notice and this permission notice appear in supporting
.\" documentation, and that the name of M.I.T. not be used in
.\" advertising or publicity pertaining to distribution of the
.\" software without specific, written prior permission.
.\" M.I.T. makes no representations about the suitability of
.\" this software for any purpose.  It is provided "as is"
.\" without express or implied warranty.
.\"
.TH HESIOD 3 "30 November 1996"
.SH NAME
hesiod_getpwnam, hesiod_getpwuid, hesiod_free_passwd \- Hesiod functions for retrieving passwd information
.SH SYNOPSIS
.nf
.B #include <hesiod.h>
.PP
.B struct passwd *hesiod_getpwnam(void *\fIcontext\fP, const char *\fIname\fP)
.B struct passwd *hesiod_getpwuid(void *\fIcontext\fP, uid_t \fIuid\fP)
.B void hesiod_free_passwd(void *\fIcontext\fP, struct passwd *\fIpw\fP)
.PP
.B cc file.c \-lhesiod
.fi
.SH DESCRIPTION
This family of functions allows you to retrieve passwd database
information using Hesiod.  To perform lookups, you need an initialized
Hesiod context; see hesiod(3) for details.  You may look up passwd
information by name or by uid; information is returned in the same
format as by
.I getpwnam
or
.IR getpwuid .
It is the caller's responsibility to call
.I hesiod_free_passwd
with the returned passwd entry to free the resources used by the
passwd entry.
.PP
Hesiod queries for passwd information are made using the ``passwd'' or
``uid'' Hesiod type, using either the username or the decimal
representation 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.
.SH RETURN VALUES
On failure,
.I hesiod_getpwnam
and
.I hesiod_getpwuid
return NULL and set the global variable
.I errno
to indicate the error.
.SH ERRORS
These calls may fail for any of the reasons the routine
.I hesiod_resolve
may fail.
.SH SEE ALSO
hesiod(3)