File: getnodebyname.3

package info (click to toggle)
dnprogs 2.52
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 3,644 kB
  • ctags: 4,021
  • sloc: ansic: 26,737; cpp: 10,666; makefile: 832; sh: 537; awk: 13
file content (56 lines) | stat: -rw-r--r-- 920 bytes parent folder | download | duplicates (8)
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
.TH GETNODEBYNAME 3 "July 28, 1998" "DECnet database functions"
.SH NAME
getnodebyname \- DECnet node entry retrieval by address

.SH SYNOPSIS
.B #include <netdnet/dn.h>
.br
.B #include <netdnet/dnetdb.h>
.br
.sp
.B struct nodeent *getnodebyname (char *name)
.sp
.SH DESCRIPTION

.B getnodebyname
searches the decnet hosts file for the DECnet node with name equal to
.B name 
and returns node information into the
.B nodeent
structure.
.br
If no entry is found, returns 
.B NULL


.SH EXAMPLE
.nf

#include <netdnet/dn.h>
#include <netdnet/dnetdb.h>
#include <sys/socket.h>

main(void)
{
    struct nodeent		*dp;


    if ( (dp=getnodebyname("mv3100")) == NULL)
	   printf("Error, cannot find node entry");
    else
	   printf("Node name is %s",dp->n_name);
}
.fi




.SH SEE ALSO

.BR dnet_htoa (3),
.BR dnet_ntoa (3),
.BR dnet_conn (3),
.BR dnet_addr (3),
.BR getnodebyaddr (3),
.BR getnodeadd (3),
.BR setnodeent (3)