2005-06-02 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / gpgme / wait.h
1 /* wait.h - Definitions for the wait queue interface.
2    Copyright (C) 2000 Werner Koch (dd9jn)
3    Copyright (C) 2001, 2002, 2003, 2004 g10 Code GmbH
4  
5    This file is part of GPGME.
6  
7    GPGME is free software; you can redistribute it and/or modify it
8    under the terms of the GNU Lesser General Public License as
9    published by the Free Software Foundation; either version 2.1 of
10    the License, or (at your option) any later version.
11    
12    GPGME is distributed in the hope that it will be useful, but
13    WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15    Lesser General Public License for more details.
16    
17    You should have received a copy of the GNU Lesser General Public
18    License along with this program; if not, write to the Free Software
19    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
20    02111-1307, USA.  */
21
22 #ifndef WAIT_H
23 #define WAIT_H
24
25 #include "gpgme.h"
26 #include "sema.h"
27
28 struct fd_table
29 {
30   struct io_select_fd_s *fds;
31   size_t size;
32 };
33 typedef struct fd_table *fd_table_t;
34
35 /* Wait items are hooked into the io_select_fd_s to connect an fd with
36    a callback handler.  */
37 struct wait_item_s
38 {
39   gpgme_ctx_t ctx;
40   gpgme_io_cb_t handler;
41   void *handler_value;
42   int dir;
43 };
44
45 /* A registered fd handler is removed later using the tag that
46    identifies it.  */
47 struct tag
48 {
49   /* The context for which the fd was registered.  */
50   gpgme_ctx_t ctx;
51
52   /* The index into the fd table for this context.  */
53   int idx;
54
55   /* This is used by the wrappers for the user event loop.  */
56   void *user_tag;
57 };
58
59
60 void _gpgme_fd_table_init (fd_table_t fdt);
61 void _gpgme_fd_table_deinit (fd_table_t fdt);
62
63 gpgme_error_t _gpgme_add_io_cb (void *data, int fd, int dir,
64                              gpgme_io_cb_t fnc, void *fnc_data, void **r_tag);
65 void _gpgme_remove_io_cb (void *tag);
66 void _gpgme_wait_private_event_cb (void *data, gpgme_event_io_t type,
67                                    void *type_data);
68 void _gpgme_wait_global_event_cb (void *data, gpgme_event_io_t type,
69                                   void *type_data);
70
71 gpgme_error_t _gpgme_wait_user_add_io_cb (void *data, int fd, int dir,
72                                           gpgme_io_cb_t fnc, void *fnc_data,
73                                           void **r_tag);
74 void _gpgme_wait_user_remove_io_cb (void *tag);
75 void _gpgme_wait_user_event_cb (void *data, gpgme_event_io_t type,
76                                 void *type_data);
77
78 gpgme_error_t _gpgme_wait_one (gpgme_ctx_t ctx);
79
80 gpgme_error_t _gpgme_run_io_cb (struct io_select_fd_s *an_fds, int checked);
81
82 #endif  /* WAIT_H */