di_link_next_by_node(3devinfo)

1di_link_next_by_node(3DDeEvViIcNeFOI)nformation Library Fduin_cltiinokn_snext_by_node(3DEVINFO)
2
3
4

NAME

6       di_link_next_by_node, di_link_next_by_lnode - libdevinfo link traversal
7       functions
8

SYNOPSIS

10       cc [ flag... ] file... -ldevinfo [ library... ]
11       #include <libdevinfo.h>
12
13       di_link_t di_link_next_by_node(di_lnode_t node, di_link_t link,
14            uint_t endpoint);
15
16
17       di_link_t di_link_next_by_lnode(di_node_t lnode, di_link_t link,
18            uint_t endpoint);
19
20

PARAMETERS

22       link        The handle to the current the link or DI_LINK_NIL.
23
24
25       endpoint    Specify which endpoint of the link the node or lnode should
26                   correspond to, either DI_LINK_TGT or DI_LINK_SRC.
27
28
29       node        The device node with which the link is associated.
30
31
32       lnode       The lnode with which the link is associated.
33
34

DESCRIPTION

36       The  di_link_next_by_node()  function returns a handle to the next link
37       that has the same endpoint node as link.  If  link  is  DI_LINK_NIL,  a
38       handle  is  returned to the first link whose endpoint specified by end‐
39       point matches the node specified by node.
40
41
42       The di_link_next_by_lnode() function returns a handle to the next  link
43       that  has  the  same endpoint lnode as link.  If link is DI_LINK_NIL, a
44       handle  is returned to the first link whose endpoint specified by  end‐
45       point matches the lnode specified by lnode.
46

RETURN VALUES

48       Upon  successful  completion,  a  handle to the next link is  returned.
49       Otherwise, DI_LINK_NIL is returned and errno is  set  to  indicate  the
50       error.
51

ERRORS

53       The  di_link_next_by_node()  and di_link_next_by_lnode() functions will
54       fail if:
55
56       EINVAL    An argument is invalid.
57
58
59       ENXIO     The end of the link list has been reached.
60
61
62
63       The di_link_next_by_node() function will fail if:
64
65       ENOTSUP    Device usage information is not available in snapshot.
66
67

ATTRIBUTES

69       See attributes(5) for descriptions of the following attributes:
70
71
72
73
74       ┌─────────────────────────────┬─────────────────────────────┐
75       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │Interface Stability          │Evolving                     │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │MT-Level                     │Safe                         │
80       └─────────────────────────────┴─────────────────────────────┘
81