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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
.\" @(#)getrpcent.3n 2.2 88/08/02 4.0 RPCSRC; from 1.11 88/03/14 SMI
.\"
.\" Translated Sun Apr 23 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH GETRPCENT 3N "14 diciembre 1987"
.SH NOMBRE
getrpcent, getrpcbyname, getrpcbynumber \- obtienen una entrada RPC
.SH SINOPSIS
.nf
.ft B
#include <netdb.h>
.LP
.ft B
struct rpcent *getrpcent(\|)
.LP
.ft B
struct rpcent *getrpcbyname(name)
char *name;
.LP
.ft B
struct rpcent *getrpcbynumber(number)
int number;
.LP
.ft B
setrpcent (stayopen)
int stayopen;
.LP
.ft B
endrpcent (\|)
.fi
.SH DESCRIPCIN
.LP
.BR getrpcent(\|) ,
.B getrpcbyname(\|)
y
.B getrpcbynumber(\|)
devuelven un puntero a un objeto con la siguiente estructura, que contiene
los campos extrados de una lnea de la base de datos de nmeros de
programas RPC,
.BR /etc/rpc .
.RS
.LP
.nf
.ft B
struct rpcent {
char *r_name; /* nom. del servidor para este programa RPC */
char **r_aliases; /* lista de alias */
long r_number; /* nmero del programa RPC */
};
.ft R
.fi
.RE
.LP
Los miembros de esta estructura son:
.RS
.PD 0
.TP 20
.B r_name
El nombre del servidor para este programa RPC.
.TP 20
.B r_aliases
Una lista terminada en NULL de nombres alternativos para el programa RPC.
.TP 20
.B r_number
El nmero del programa RPC para este servicio.
.PD
.RE
.LP
.B getrpcent(\|)
lee la siguiente lnea del fichero, abriendo el fichero si es necesario.
.LP
.B setrpcent(\|)
abre el fichero y coloca su puntero de lectura/escritura al principio. Si la
opcin
.I stayopen
no es cero, la base de datos de red no se cerrar tras cada llamada a
.B getrpcent(\|)
(tampoco ni directa ni indirectamente a travs de alguna de las otras
llamadas \*(lqgetrpc\*(rq).
.LP
.B endrpcent
cierra el fichero.
.LP
.B getrpcbyname(\|)
y
.B getrpcbynumber(\|)
examinan secuencialmente el fichero, desde el principio, hasta que
encuentran un nombre de programa RPC o un nmero de programa coincidente, o
hasta que se encuentre el final del fichero.
.SH FICHEROS
.PD 0
.TP 20
.B /etc/rpc
.PD
.SH "VASE TAMBIN"
.BR rpc (5),
.BR rpcinfo (8C),
.BR ypserv (8)
.SH DIAGNSTICOS
.LP
Se devuelve un puntero
.SM NULL
si se encuentra un
.SM EOF
o si se produce un error.
.SH FALLOS
.LP
Toda la informacin se almacenada en un rea esttica por lo que debe
copiarse a otro sitio si se va a guardar.
|
