1dlpi_get_physaddrD(a3tDaLPLIi)nk Provider Interface Library Fudnlcptii_ognest_physaddr(3DLPI)
2
3
4

NAME

6       dlpi_get_physaddr - get physical address using DLPI
7

SYNOPSIS

9       cc [ flag... ] file... -ldlpi [ library... ]
10       #include <libdlpi.h>
11
12       int dlpi_get_physaddr(dlpi_handle_t dh, uint_t type,
13            void *addrp,size_t *addrlenp);
14
15

DESCRIPTION

17       The  dlpi_get_physaddr() function gets a physical address from the DLPI
18       link instance associated with DLPI handle  dh.  The  retrieved  address
19       depends upon type, which can be:
20
21       DL_FACT_PHYS_ADDR    Factory physical address
22
23
24       DL_CURR_PHYS_ADDR    Current physical address
25
26
27
28       The operation can be performed in any DLPI state of dh.
29
30
31       The  caller  must ensure that addrp is at least DLPI_PHYSADDR_MAX bytes
32       in size and addrlenp must contain the length of  addrp.  Upon  success,
33       addrp  contains  the  specified physical address, and addrlenp contains
34       the physical address length. If a physical address  is  not  available,
35       addrp is not filled in and addrlenp is set to zero.
36

RETURN VALUES

38       Upon success, DLPI_SUCCESS is returned. If DL_SYSERR is returned, errno
39       contains the specific UNIX system error value. Otherwise, a DLPI  error
40       value defined in <sys/dlpi.h> or an error value listed in the following
41       section is returned.
42

ERRORS

44       DLPI_EBADMSG      Bad DLPI message
45
46
47       DLPI_EINHANDLE    Invalid DLPI handle
48
49
50       DLPI_EINVAL       Invalid argument
51
52
53       DLPI_ETIMEDOUT    DLPI operation timed out
54
55

ATTRIBUTES

57       See attributes(5) for description of the following attributes:
58
59
60
61
62       ┌─────────────────────────────┬─────────────────────────────┐
63       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
64       ├─────────────────────────────┼─────────────────────────────┤
65       │Interface Stability          │Committed                    │
66       ├─────────────────────────────┼─────────────────────────────┤
67       │MT-Level                     │Safe                         │
68       └─────────────────────────────┴─────────────────────────────┘
69

SEE ALSO

71       dlpi_set_physaddr(3DLPI), libdlpi(3LIB), attributes(5)
72
73
74
75SunOS 5.11                        22 Aug 2007         dlpi_get_physaddr(3DLPI)
Impressum