fdwalk should return 0 on an empty directory
[kopensolaris-gnu/glibc.git] / io / sys / poll.h
1 /* Compatibility definitions for System V `poll' interface.
2    Copyright (C) 1994,1996-2001,2004,2005,2006 Free Software Foundation, Inc.
3    This file is part of the GNU C Library.
4
5    The GNU C Library is free software; you can redistribute it and/or
6    modify it under the terms of the GNU Lesser General Public
7    License as published by the Free Software Foundation; either
8    version 2.1 of the License, or (at your option) any later version.
9
10    The GNU C Library is distributed in the hope that it will be useful,
11    but WITHOUT ANY WARRANTY; without even the implied warranty of
12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13    Lesser General Public License for more details.
14
15    You should have received a copy of the GNU Lesser General Public
16    License along with the GNU C Library; if not, write to the Free
17    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
18    02111-1307 USA.  */
19
20 #ifndef _SYS_POLL_H
21 #define _SYS_POLL_H     1
22
23 #include <features.h>
24
25 /* Get the platform dependent bits of `poll'.  */
26 #include <bits/poll.h>
27 #ifdef __USE_GNU
28 /* Get the __sigset_t definition.  */
29 # include <bits/sigset.h>
30 /* Get the timespec definition.  */
31 # define __need_timespec
32 # include <time.h>
33 #endif
34
35
36 /* Type used for the number of file descriptors.  */
37 typedef unsigned long int nfds_t;
38
39 /* Data structure describing a polling request.  */
40 struct pollfd
41   {
42     int fd;                     /* File descriptor to poll.  */
43     short int events;           /* Types of events poller cares about.  */
44     short int revents;          /* Types of events that actually occurred.  */
45   };
46
47
48 __BEGIN_DECLS
49
50 /* Poll the file descriptors described by the NFDS structures starting at
51    FDS.  If TIMEOUT is nonzero and not -1, allow TIMEOUT milliseconds for
52    an event to occur; if TIMEOUT is -1, block until an event occurs.
53    Returns the number of file descriptors with events, zero if timed out,
54    or -1 for errors.
55
56    This function is a cancellation point and therefore not marked with
57    __THROW.  */
58 extern int poll (struct pollfd *__fds, nfds_t __nfds, int __timeout);
59
60 #ifdef __USE_GNU
61 /* Like poll, but before waiting the threads signal mask is replaced
62    with that specified in the fourth parameter.  For better usability,
63    the timeout value is specified using a TIMESPEC object.
64
65    This function is a cancellation point and therefore not marked with
66    __THROW.  */
67 extern int ppoll (struct pollfd *__fds, nfds_t __nfds,
68                   __const struct timespec *__timeout,
69                   __const __sigset_t *__ss);
70 #endif
71
72 __END_DECLS
73
74 #endif  /* sys/poll.h */