lib/poll-loop.h

   1 /*
   2  * Copyright (c) 2008, 2009, 2010 Nicira Networks.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 /* High-level wrapper around the "poll" system call.
  18  *
  19  * Intended usage is for the program's main loop to go about its business
  20  * servicing whatever events it needs to.  Then, when it runs out of immediate
  21  * tasks, it calls each subordinate module's "wait" function, which in turn
  22  * calls one (or more) of the functions poll_fd_wait(), poll_immediate_wake(),
  23  * and poll_timer_wait() to register to be awakened when the appropriate event
  24  * occurs.  Then the main loop calls poll_block(), which blocks until one of
  25  * the registered events happens. */
  26
  27 #ifndef POLL_LOOP_H
  28 #define POLL_LOOP_H 1
  29
  30 #include <poll.h>
  31
  32 #ifdef  __cplusplus
  33 extern "C" {
  34 #endif
  35
  36 struct poll_waiter;
  37
  38 /* Schedule events to wake up the following poll_block(). */
  39 struct poll_waiter *poll_fd_wait(int fd, short int events);
  40 void poll_timer_wait(long long int msec);
  41 void poll_timer_wait_until(long long int msec);
  42 void poll_immediate_wake(void);
  43
  44 /* Wait until an event occurs. */
  45 void poll_block(void);
  46
  47 /* Cancel a file descriptor callback or event. */
  48 void poll_cancel(struct poll_waiter *);
  49
  50 #ifdef  __cplusplus
  51 }
  52 #endif
  53
  54 #endif /* poll-loop.h */