1dlpi_fd(3DLPI)  Data Link Provider Interface Library Functions  dlpi_fd(3DLPI)
2
3
4

NAME

6       dlpi_fd - get DLPI file descriptor
7

SYNOPSIS

9       cc [ flag ... ] file ... -ldlpi [ library ... ]
10       #include <libdlpi.h>
11
12       int dlpi_fd(dlpi_handle_t dh);
13
14

DESCRIPTION

16       The  dlpi_fd() function returns the integer file descriptor that can be
17       used to directly operate on the open DLPI stream  associated  with  the
18       DLPI  handle  dh.  This file descriptor can be used to perform non-DLPI
19       operations that do not alter the state of  the  DLPI  stream,  such  as
20       waiting  for  an  event using poll(2), or pushing and configuring addi‐
21       tional STREAMS modules, such  as  pfmod(7M).  If  DLPI  operations  are
22       directly  performed  on  the  file  descriptor,  or a STREAMS module is
23       pushed that alters the message-passing interface such that DLPI  opera‐
24       tions can no longer be issued, future operations on dh might not behave
25       as documented.
26
27
28       The returned file  descriptor  is  managed  by  libdlpi(3LIB)  and  the
29       descriptor must not be closed.
30

RETURN VALUES

32       The  function  returns  the integer file descriptor associated with the
33       DLPI handle dh. If dh is invalid, -1 is returned.
34

ATTRIBUTES

36       See attributes(5) for description of the following attributes:
37
38
39
40
41       ┌─────────────────────────────┬─────────────────────────────┐
42       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
43       ├─────────────────────────────┼─────────────────────────────┤
44       │Interface Stability          │Committed                    │
45       ├─────────────────────────────┼─────────────────────────────┤
46       │MT-Level                     │Safe                         │
47       └─────────────────────────────┴─────────────────────────────┘
48

SEE ALSO

50       poll(2), libdlpi(3LIB), attributes(5), dlpi(7P), pfmod(7M)
51
52
53
54SunOS 5.11                        15 Jun 2007                   dlpi_fd(3DLPI)
Impressum