1rsm_intr_signal_wait_Rpeomloltfed(S3hRaSrMe)d Memory Librarrsym_Fiunntcrt_isoingsnal_wait_pollfd(3RSM)
2
3
4

NAME

6       rsm_intr_signal_wait_pollfd  -  wait  for  events  on  a  list  of file
7       descriptors
8

SYNOPSIS

10       cc [ flag... ] file... -lrsm [ library ... ]
11       #include <rsmapi.h>
12
13       int rsm_intr_signal_wait_pollfd(struct pollfd fds[],
14            nfds_t nfds, int timeout, int *numfdsp);
15
16

DESCRIPTION

18       The rsm_intr_signal_wait_pollfd() function is similar to  rsm_intr_sig‐
19       nal_wait(3RSM),  except that it  allows an application to multiplex I/O
20       over various types of file descriptors. Applications can use this func‐
21       tion  to  wait for interrupt signals on RSMAPI segments as well as poll
22       for I/O events on other non-RSMAPI file descriptors.
23
24
25       The fds argument is an array of pollfd structures  that  correspond  to
26       both   RSMAPI   segments  and  other  file  descriptors.  The  rsm_mem‐
27       seg_get_pollfd(3RSM) is used to obtain a pollfd structure corresponding
28       to an RSMAPI segment.
29
30
31       The number of file descriptors that have events is returned in numfdsp.
32       This parameter can be set to NULL if the application is not  interested
33       in  the  number  of  file descriptors that have events. See poll(2) for
34       descriptions of the pollfd structure as well as the  nfds  and  timeout
35       parameters.
36
37
38       It  is  the application's responsibility to establish the validity of a
39       pollfd structure corresponding to an RSMAPI segment  by  ensuring  that
40       rsm_memseg_release_pollfd(3RSM)  has  not been called on the segment or
41       that the segment has not been destroyed.
42
43
44       For file descriptors  other  than  RSMAPI  segments,  the  behavior  of
45       rsm_intr_signal_wait_pollfd() is similar to poll().
46

RETURN VALUES

48       Upon successful completion, rsm_intr_signal_wait_pollfd() returns 0 and
49       the revents member of the pollfd struct corresponding to an RSMAPI seg‐
50       ment is set to POLLRDNORM, indicating that an interrupt signal for that
51       segment was received. Otherwise, an error value is returned.
52
53
54       For file descriptors other than RSMAPI segments, the revents member  of
55       the pollfd struct is identical to that returned by poll(2).
56

ERRORS

58       The  rsm_intr_signal_wait_pollfd()  function  can  return the following
59       errors:
60
61       RSMERR_TIMEOUT
62
63           Timeout has occured.
64
65
66       RSMERR_BAD_ARGS_ERRORS
67
68           Invalid arguments passed.
69
70
71       RSMERR_BAD_ADDR
72
73           An argument points to an illegal address.
74
75
76       RSMERR_INTERRUPTED
77
78           The call was interrupted.
79
80
81       RSMERR_INSUFFICIENT_MEM
82
83           Insufficient memory.
84
85
86       RSMERR_INSUFFICIENT_RESOURCES
87
88           Insufficient resources.
89
90

ATTRIBUTES

92       See attributes(5) for descriptions of the following attributes:
93
94
95
96
97       ┌─────────────────────────────┬─────────────────────────────┐
98       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
99       ├─────────────────────────────┼─────────────────────────────┤
100       │Interface Stability          │Evolving                     │
101       ├─────────────────────────────┼─────────────────────────────┤
102       │MT-Level                     │MT-Safe                      │
103       └─────────────────────────────┴─────────────────────────────┘
104

SEE ALSO

106       poll(2),    rsm_intr_signal_wait(3RSM),    rsm_memseg_get_pollfd(3RSM),
107       rsm_memseg_release_pollfd(3RSM), attributes(5)
108
109
110
111SunOS 5.11                        1 Dec 2002 rsm_intr_signal_wait_pollfd(3RSM)
Impressum