File: hesiod_getservbyname.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 (62 lines) | stat: -rw-r--r-- 2,297 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
.\" $Id: hesiod_getservbyname.3,v 1.1 1996/12/08 21:38:45 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_getservbyname, hesiod_free_servent \- Hesiod functions for retrieving service information
.SH SYNOPSIS
.nf
.B #include <hesiod.h>
.PP
.B struct servent *hesiod_getservbyname(void *\fIcontext\fP,
.B 	const char *\fIname\fP, const char *\fIproto\fP)
.B void hesiod_free_servent(void *\fIcontext\fP, struct servent *\fIserv\fP)
.PP
.B cc file.c \-lhesiod
.fi
.SH DESCRIPTION
This family of functions allows you to retrieve service to port
mappings using Hesiod.  To perform lookups, you need an initialized
Hesiod context; see hesiod(3) for details.  Information is returned in
the same format as by
.IR getservbyname .
It is the caller's responsibility to call
.I hesiod_free_servent
with the returned service entry to free the resources used by the
service entry.
.PP
Hesiod queries for service information are made using the ``service''
Hesiod type, using the service name as the Hesiod name.  The
corresponding records should be space-separated lists of strings
giving the service name, protocol, port number (in decimal), and zero
or more aliases for the service.  There may be multiple records per
service name;
.I hesiod_getservbyname
will pick the first one whose protocol matches
.IR proto .
.SH RETURN VALUES
On failure,
.I hesiod_getservbyname
returns NULL and sets the global variable
.I errno
to indicate the error.
.SH ERRORS
.I hesiod_getservbyname
may fail for any of the reasons the routine
.I hesiod_resolve
may fail.
.SH SEE ALSO
hesiod(3)