X-Git-Url: http://git.meshlink.io/?a=blobdiff_plain;f=avahi-common%2Fthread-watch.h;h=dec0cf356f7f60d9f50c960a5ff3f3f2c531a056;hb=94366b4c8e1e4c6b92353cf194cb972086f44a4a;hp=b3ebcd656e4d9f0cb9273569cf4947774952334a;hpb=1c7f879c9f0bdd3512ee2ae2d43fdefe1d7ff4e3;p=catta diff --git a/avahi-common/thread-watch.h b/avahi-common/thread-watch.h index b3ebcd6..dec0cf3 100644 --- a/avahi-common/thread-watch.h +++ b/avahi-common/thread-watch.h @@ -1,21 +1,19 @@ #ifndef foothreadedwatchhfoo #define foothreadedwatchhfoo -/* $Id$ */ - /*** This file is part of avahi. - + avahi is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version. - + avahi is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. - + You should have received a copy of the GNU Lesser General Public License along with avahi; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 @@ -30,23 +28,23 @@ AVAHI_C_DECL_BEGIN -/** A main loop object that runs an AvahiSimplePoll in its own thread. */ +/** A main loop object that runs an AvahiSimplePoll in its own thread. \since 0.6.4 */ typedef struct AvahiThreadedPoll AvahiThreadedPoll; /** Create a new event loop object. This will allocate the internal - * AvahiSimplePoll, but will not start the helper thread. */ + * AvahiSimplePoll, but will not start the helper thread. \since 0.6.4 */ AvahiThreadedPoll *avahi_threaded_poll_new(void); -/** Free an event loop object. Ths will stop the associated evet loop - * thread (if it is running). */ +/** Free an event loop object. This will stop the associated event loop + * thread (if it is running). \since 0.6.4 */ void avahi_threaded_poll_free(AvahiThreadedPoll *p); /** Return the abstracted poll API object for this event loop * object. The will return the same pointer each time it is - * called. */ + * called. \since 0.6.4 */ const AvahiPoll* avahi_threaded_poll_get(AvahiThreadedPoll *p); -/** Start the event loop helper thread. After the thread has startet +/** Start the event loop helper thread. After the thread has started * you must make sure to access the event loop object * (AvahiThreadedPoll, AvahiPoll and all its associated objects) * synchronized, i.e. with proper locking. You may want to use @@ -54,27 +52,27 @@ const AvahiPoll* avahi_threaded_poll_get(AvahiThreadedPoll *p); * which will lock the the entire event loop. Please note that event * loop callback functions are called from the event loop helper thread * with that lock held, i.e. avahi_threaded_poll_lock() calls are not - * required from event callbacks. */ + * required from event callbacks. \since 0.6.4 */ int avahi_threaded_poll_start(AvahiThreadedPoll *p); /** Request that the event loop quits and the associated thread stops. Call this from outside the helper thread if you want to shut - it down. */ + it down. \since 0.6.4 */ int avahi_threaded_poll_stop(AvahiThreadedPoll *p); /** Request that the event loop quits and the associated thread stops. Call this from inside the helper thread if you want to shut it - down.*/ + down. \since 0.6.4 */ void avahi_threaded_poll_quit(AvahiThreadedPoll *p); /** Lock the main loop object. Use this if you want to access the event * loop objects (such as creating a new event source) from anything * else but the event loop helper thread, i.e. from anything else but event - * loop callbacks */ + * loop callbacks \since 0.6.4 */ void avahi_threaded_poll_lock(AvahiThreadedPoll *p); /** Unlock the event loop object, use this as counterpart to - * avahi_threaded_poll_lock() */ + * avahi_threaded_poll_lock() \since 0.6.4 */ void avahi_threaded_poll_unlock(AvahiThreadedPoll *p); AVAHI_C_DECL_END