You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
111 lines
3.3 KiB
111 lines
3.3 KiB
#if 0
|
|
INDI
|
|
Copyright (C) 2003 Elwood C. Downey
|
|
|
|
This library 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.
|
|
|
|
This library 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 this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
|
|
#endif
|
|
|
|
#ifndef EVENT_LOOP_H
|
|
#define EVENT_LOOP_H
|
|
|
|
/** \file eventloop.h
|
|
\brief Public interface to INDI's eventloop mechanism.
|
|
\author Elwood C. Downey
|
|
*/
|
|
|
|
/* signature of a callback, workproc and timer function */
|
|
|
|
/** \typedef CBF
|
|
\brief Signature of a callback function.
|
|
*/
|
|
typedef void (CBF) (int fd, void *);
|
|
|
|
/** \typedef WPF
|
|
\brief Signature of a work procedure function.
|
|
*/
|
|
typedef void (WPF) (void *);
|
|
|
|
/** \typedef TCF
|
|
\brief Signature of a timer function.
|
|
*/
|
|
typedef void (TCF) (void *);
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** \fn void eventLoop(void)
|
|
\brief Main calls this when ready to hand over control.
|
|
*/
|
|
extern void eventLoop(void);
|
|
|
|
/**
|
|
* \defgroup utilFunctions Utility functions to add and remove callbacks, workprocs, and timers.
|
|
*/
|
|
/*@{*/
|
|
|
|
/** Register a new callback, \e fp, to be called with \e ud as argument when \e fd is ready.
|
|
*
|
|
* \param fd file descriptor.
|
|
* \param fp a pointer to the callback function.
|
|
* \param ud a pointer to be passed to the callback function when called.
|
|
* \return a unique callback id for use with rmCallback().
|
|
*/
|
|
extern int addCallback (int fd, CBF *fp, void *ud);
|
|
|
|
/** Remove a callback function.
|
|
*
|
|
* \param cid the callback ID returned from addCallback().
|
|
*/
|
|
extern void rmCallback (int cid);
|
|
|
|
/** Add a new work procedure, fp, to be called with ud when nothing else to do.
|
|
*
|
|
* \param fp a pointer to the work procedure callback function.
|
|
* \param ud a pointer to be passed to the callback function when called.
|
|
* \return a unique id for use with rmWorkProc().
|
|
*/
|
|
extern int addWorkProc (WPF *fp, void *ud);
|
|
|
|
/** Remove the work procedure with the given \e id, as returned from addWorkProc().
|
|
*
|
|
* \param wid the work procedure callback ID returned from addWorkProc().
|
|
*/
|
|
extern void rmWorkProc (int wid);
|
|
|
|
/** Register a new timer function, \e fp, to be called with \e ud as argument after \e ms. Add to list in order of decreasing time from epoch, ie, last entry runs soonest. The timer will only invoke the callback function \b once. You need to call addTimer again if you want to repeat the process.
|
|
*
|
|
* \param ms timer period in milliseconds.
|
|
* \param fp a pointer to the callback function.
|
|
* \param ud a pointer to be passed to the callback function when called.
|
|
* \return a unique id for use with rmTimer().
|
|
*/
|
|
extern int addTimer (int ms, TCF *fp, void *ud);
|
|
|
|
/** Remove the timer with the given \e id, as returned from addTimer().
|
|
*
|
|
* \param tid the timer callback ID returned from addTimer().
|
|
*/
|
|
extern void rmTimer (int tid);
|
|
|
|
/*@}*/
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|