2003-09-14 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / gpgme / ath.h
1 /* ath.h - Interfaces for thread-safeness library.
2    Copyright (C) 2002, 2003 g10 Code GmbH
3
4    This file is part of GPGME.
5  
6    GPGME is free software; you can redistribute it and/or modify it
7    under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 2 of the License, or
9    (at your option) any later version.
10  
11    GPGME is distributed in the hope that it will be useful, but
12    WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14    General Public License for more details.
15  
16    You should have received a copy of the GNU General Public License
17    along with GPGME; if not, write to the Free Software Foundation,
18    Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
19
20 #ifndef ATH_H
21 #define ATH_H
22
23 #include <sys/types.h>
24 #include <sys/socket.h>
25
26 \f
27 /* Define _ATH_EXT_SYM_PREFIX if you want to give all external symbols
28    a prefix.  */
29 #define _ATH_EXT_SYM_PREFIX _gpgme_
30
31 #ifdef _ATH_EXT_SYM_PREFIX
32 #define _ATH_PREFIX1(x,y) x ## y
33 #define _ATH_PREFIX2(x,y) _ATH_PREFIX1(x,y)
34 #define _ATH_PREFIX(x) _ATH_PREFIX2(_ATH_EXT_SYM_PREFIX,x)
35 #define ath_mutex_init _ATH_PREFIX(ath_mutex_init)
36 #define ath_mutex_destroy _ATH_PREFIX(ath_mutex_destroy)
37 #define ath_mutex_lock _ATH_PREFIX(ath_mutex_lock)
38 #define ath_mutex_unlock _ATH_PREFIX(ath_mutex_unlock)
39 #define ath_read _ATH_PREFIX(ath_read)
40 #define ath_write _ATH_PREFIX(ath_write)
41 #define ath_select _ATH_PREFIX(ath_select)
42 #define ath_waitpid _ATH_PREFIX(ath_waitpid)
43 #define ath_connect _ATH_PREFIX(ath_connect)
44 #define ath_accept _ATH_PREFIX(ath_accept)
45 #define ath_sendmsg _ATH_PREFIX(ath_sendmsg)
46 #define ath_recvmsg _ATH_PREFIX(ath_recvmsg)
47 #endif
48
49 \f
50 typedef void *ath_mutex_t;
51 #define ATH_MUTEX_INITIALIZER 0;
52
53 /* Functions for mutual exclusion.  */
54 int ath_mutex_init (ath_mutex_t *mutex);
55 int ath_mutex_destroy (ath_mutex_t *mutex);
56 int ath_mutex_lock (ath_mutex_t *mutex);
57 int ath_mutex_unlock (ath_mutex_t *mutex);
58
59 /* Replacement for the POSIX functions, which can be used to allow
60    other (user-level) threads to run.  */
61 ssize_t ath_read (int fd, void *buf, size_t nbytes);
62 ssize_t ath_write (int fd, const void *buf, size_t nbytes);
63 ssize_t ath_select (int nfd, fd_set *rset, fd_set *wset, fd_set *eset,
64                     struct timeval *timeout);
65 ssize_t ath_waitpid (pid_t pid, int *status, int options);
66 int ath_accept (int s, struct sockaddr *addr, socklen_t *length_ptr);
67 int ath_connect (int s, struct sockaddr *addr, socklen_t length);
68 int ath_sendmsg (int s, const struct msghdr *msg, int flags);
69 int ath_recvmsg (int s, struct msghdr *msg, int flags);
70
71 #define _ATH_COMPAT
72 #ifdef _ATH_COMPAT
73 struct ath_ops
74 {
75   int (*mutex_init) (void **priv, int just_check);
76   int (*mutex_destroy) (void *priv);
77   int (*mutex_lock) (void *priv);
78   int (*mutex_unlock) (void *priv);
79   ssize_t (*read) (int fd, void *buf, size_t nbytes);
80   ssize_t (*write) (int fd, const void *buf, size_t nbytes);
81   ssize_t (*select) (int nfd, fd_set *rset, fd_set *wset, fd_set *eset,
82                      struct timeval *timeout);
83   ssize_t (*waitpid) (pid_t pid, int *status, int options);
84   int (*accept) (int s, struct sockaddr *addr, socklen_t *length_ptr);
85   int (*connect) (int s, struct sockaddr *addr, socklen_t length);
86   int (*sendmsg) (int s, const struct msghdr *msg, int flags);
87   int (*recvmsg) (int s, struct msghdr *msg, int flags);
88 };
89
90 /* Initialize the any-thread package.  */
91 #define ath_init _ATH_PREFIX(ath_init)
92 void ath_init (void);
93
94 /* Used by ath_pkg_init.  */
95 #define ath_pthread_available _ATH_PREFIX(ath_pthread_available)
96 struct ath_ops *ath_pthread_available (void);
97 #define ath_pth_available _ATH_PREFIX(ath_pth_available)
98 struct ath_ops *ath_pth_available (void);
99 #endif
100
101 #endif  /* ATH_H */