| 1 |
/*---------------------------------------------------------------------------*\ |
| 2 |
$Id: poll.h,v 1.3 2002/05/11 11:32:30 bmc Exp $ |
| 3 |
|
| 4 |
NAME |
| 5 |
|
| 6 |
poll - select(2)-based poll() emulation function for BSD systems. |
| 7 |
|
| 8 |
SYNOPSIS |
| 9 |
#include "poll.h" |
| 10 |
|
| 11 |
struct pollfd |
| 12 |
{ |
| 13 |
int fd; |
| 14 |
short events; |
| 15 |
short revents; |
| 16 |
} |
| 17 |
|
| 18 |
int poll (struct pollfd *pArray, unsigned long n_fds, int timeout) |
| 19 |
|
| 20 |
DESCRIPTION |
| 21 |
|
| 22 |
This file, and the accompanying "poll.c", implement the System V |
| 23 |
poll(2) system call for BSD systems (which typically do not provide |
| 24 |
poll()). Poll() provides a method for multiplexing input and output |
| 25 |
on multiple open file descriptors; in traditional BSD systems, that |
| 26 |
capability is provided by select(). While the semantics of select() |
| 27 |
differ from those of poll(), poll() can be readily emulated in terms |
| 28 |
of select() -- which is how this function is implemented. |
| 29 |
|
| 30 |
REFERENCES |
| 31 |
Stevens, W. Richard. Unix Network Programming. Prentice-Hall, 1990. |
| 32 |
|
| 33 |
NOTES |
| 34 |
1. This software requires an ANSI C compiler. |
| 35 |
|
| 36 |
LICENSE |
| 37 |
|
| 38 |
This software is released under the following license: |
| 39 |
|
| 40 |
Copyright (c) 1995-2002 Brian M. Clapper |
| 41 |
All rights reserved. |
| 42 |
|
| 43 |
Redistribution and use in source and binary forms are |
| 44 |
permitted provided that: (1) source distributions retain |
| 45 |
this entire copyright notice and comment; (2) modifications |
| 46 |
made to the software are prominently mentioned, and a copy |
| 47 |
of the original software (or a pointer to its location) are |
| 48 |
included; and (3) distributions including binaries display |
| 49 |
the following acknowledgement: "This product includes |
| 50 |
software developed by Brian M. Clapper <bmc@clapper.org>" |
| 51 |
in the documentation or other materials provided with the |
| 52 |
distribution. The name of the author may not be used to |
| 53 |
endorse or promote products derived from this software |
| 54 |
without specific prior written permission. |
| 55 |
|
| 56 |
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS |
| 57 |
OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE |
| 58 |
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A |
| 59 |
PARTICULAR PURPOSE. |
| 60 |
|
| 61 |
Effectively, this means you can do what you want with the software |
| 62 |
except remove this notice or take advantage of the author's name. |
| 63 |
If you modify the software and redistribute your modified version, |
| 64 |
you must indicate that your version is a modification of the |
| 65 |
original, and you must provide either a pointer to or a copy of the |
| 66 |
original. |
| 67 |
\*---------------------------------------------------------------------------*/ |
| 68 |
|
| 69 |
#ifndef _POLL_EMUL_H_ |
| 70 |
#define _POLL_EMUL_H_ |
| 71 |
|
| 72 |
#if defined(HAVE_SYS_POLL_H) && defined(HAVE_POLL) |
| 73 |
# include <sys/poll.h> |
| 74 |
#else |
| 75 |
|
| 76 |
#define POLLIN 0x01 |
| 77 |
#define POLLPRI 0x02 |
| 78 |
#define POLLOUT 0x04 |
| 79 |
#define POLLERR 0x08 |
| 80 |
#define POLLHUP 0x10 |
| 81 |
#define POLLNVAL 0x20 |
| 82 |
|
| 83 |
struct pollfd |
| 84 |
{ |
| 85 |
int fd; |
| 86 |
short events; |
| 87 |
short revents; |
| 88 |
}; |
| 89 |
|
| 90 |
#ifdef __cplusplus |
| 91 |
extern "C" |
| 92 |
{ |
| 93 |
#endif |
| 94 |
|
| 95 |
#if (__STDC__ > 0) || defined(__cplusplus) |
| 96 |
extern int poll (struct pollfd *pArray, unsigned long n_fds, int timeout); |
| 97 |
#else |
| 98 |
extern int poll(); |
| 99 |
#endif |
| 100 |
|
| 101 |
#ifdef __cplusplus |
| 102 |
} |
| 103 |
#endif |
| 104 |
|
| 105 |
#endif |
| 106 |
|
| 107 |
#endif /* _POLL_EMUL_H_ */ |
