git.meshlink.io Git - catta/blob - avahi-common/simple-watch.h

   1 #ifndef foosimplewatchhfoo
   2 #define foosimplewatchhfoo
   3
   4 /* $Id$ */
   5
   6 /***
   7   This file is part of avahi.
   8
   9   avahi is free software; you can redistribute it and/or modify it
  10   under the terms of the GNU Lesser General Public License as
  11   published by the Free Software Foundation; either version 2.1 of the
  12   License, or (at your option) any later version.
  13
  14   avahi is distributed in the hope that it will be useful, but WITHOUT
  15   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  16   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
  17   Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public
  20   License along with avahi; if not, write to the Free Software
  21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  22   USA.
  23 ***/
  24
  25 /** \file simple-watch.h Simple poll() based main loop implementation */
  26
  27 #include <sys/poll.h>
  28 #include <avahi-common/cdecl.h>
  29
  30 #include "watch.h"
  31
  32 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  33 AVAHI_C_DECL_BEGIN
  34 #endif
  35
  36 /** A main loop object. Main loops of this type aren't very flexible
  37  * since they only support a single wakeup type. Nevertheless it
  38  * should suffice for small test and example applications.  */
  39 typedef struct AvahiSimplePoll AvahiSimplePoll;
  40
  41 /** Create a new main loop object */
  42 AvahiSimplePoll *avahi_simple_poll_new(void);
  43
  44 /** Free a main loop object */
  45 void avahi_simple_poll_free(AvahiSimplePoll *s);
  46
  47 /** Return the abstracted poll API object for this main loop
  48  * object. The is will return the same pointer each time it is
  49  * called. */
  50 const AvahiPoll* avahi_simple_poll_get(AvahiSimplePoll *s);
  51
  52 /** Run a single main loop iteration of this main loop. If sleep_time
  53 is < 0 this will block until any of the registered events happens,
  54 then it will execute the attached callback function. If sleep_time is
  55 0 the routine just checks if any event is pending. If yes the attached
  56 callback function is called, otherwise the function returns
  57 immediately. If sleep_time > 0 the function will block for at most the
  58 specified time in msecs. Returns -1 on error, 0 on success and 1 if a
  59 quit request has been scheduled. Usually this function should be called
  60 in a loop until it returns a non-zero value*/
  61 int avahi_simple_poll_iterate(AvahiSimplePoll *s, int sleep_time);
  62
  63 /** Request that the main loop quits. If this is called the next
  64  call to avahi_simple_poll_iterate() will return 1 */
  65 void avahi_simple_poll_quit(AvahiSimplePoll *s);
  66
  67 /** Prototype for a poll() type function */
  68 typedef int (*AvahiPollFunc)(struct pollfd *ufds, unsigned int nfds, int timeout);
  69
  70 /** Replace the internally used poll() function. By default the system's poll() will be used */
  71 void avahi_simple_poll_set_func(AvahiSimplePoll *s, AvahiPollFunc func);
  72
  73 #ifndef DOXYGEN_SHOULD_SKIP_THIS
  74 AVAHI_C_DECL_END
  75 #endif
  76
  77 #endif