2009-11-10 Marcus Brinkmann <marcus@g10code.de>
[gpgme.git] / src / util.h
1 /* util.h 
2    Copyright (C) 2000 Werner Koch (dd9jn)
3    Copyright (C) 2001, 2002, 2003, 2004, 2005 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 UTIL_H
23 #define UTIL_H
24
25 #include "gpgme.h"
26
27 \f
28 #define DIM(v) (sizeof(v)/sizeof((v)[0]))
29
30 \f
31 /*-- {posix,w32}-util.c --*/
32 const char *_gpgme_get_gpg_path (void);
33 const char *_gpgme_get_gpgsm_path (void);
34 const char *_gpgme_get_gpgconf_path (void);
35 const char *_gpgme_get_g13_path (void);
36 const char *_gpgme_get_uiserver_socket_path (void);
37
38 int _gpgme_get_conf_int (const char *key, int *value);
39 void _gpgme_allow_set_foreground_window (pid_t pid);
40
41 /*-- dirinfo.c --*/
42 const char *_gpgme_get_default_homedir (void);
43 const char *_gpgme_get_default_agent_socket (void);
44
45
46 \f
47 /*-- replacement functions in <funcname>.c --*/
48 #ifdef HAVE_CONFIG_H
49
50 #ifndef HAVE_STPCPY
51 static _GPGME_INLINE char *
52 _gpgme_stpcpy (char *a, const char *b)
53 {
54   while (*b)
55     *a++ = *b++;
56   *a = 0;
57   return a;
58 }
59 #define stpcpy(a,b) _gpgme_stpcpy ((a), (b))
60 #endif /*!HAVE_STPCPY*/
61
62 #if !HAVE_VASPRINTF
63 #include <stdarg.h>
64 int vasprintf (char **result, const char *format, va_list args);
65 int asprintf (char **result, const char *format, ...);
66 #endif
67
68 #ifndef HAVE_TTYNAME_R
69 int ttyname_r (int fd, char *buf, size_t buflen);
70 #endif
71 #endif
72
73 \f
74 /*-- conversion.c --*/
75 /* Convert two hexadecimal digits from STR to the value they
76    represent.  Returns -1 if one of the characters is not a
77    hexadecimal digit.  */
78 int _gpgme_hextobyte (const char *str);
79
80 /* Decode the C formatted string SRC and store the result in the
81    buffer *DESTP which is LEN bytes long.  If LEN is zero, then a
82    large enough buffer is allocated with malloc and *DESTP is set to
83    the result.  Currently, LEN is only used to specify if allocation
84    is desired or not, the caller is expected to make sure that *DESTP
85    is large enough if LEN is not zero.  */
86 gpgme_error_t _gpgme_decode_c_string (const char *src, char **destp,
87                                       size_t len);
88
89 /* Decode the percent escaped string SRC and store the result in the
90    buffer *DESTP which is LEN bytes long.  If LEN is zero, then a
91    large enough buffer is allocated with malloc and *DESTP is set to
92    the result.  Currently, LEN is only used to specify if allocation
93    is desired or not, the caller is expected to make sure that *DESTP
94    is large enough if LEN is not zero.  If BINARY is 1, then '\0'
95    characters are allowed in the output.  */
96 gpgme_error_t _gpgme_decode_percent_string (const char *src, char **destp,
97                                             size_t len, int binary);
98
99 gpgme_error_t _gpgme_encode_percent_string (const char *src, char **destp,
100                                             size_t len);
101
102
103 /* Parse the string TIMESTAMP into a time_t.  The string may either be
104    seconds since Epoch or in the ISO 8601 format like
105    "20390815T143012".  Returns 0 for an empty string or seconds since
106    Epoch. Leading spaces are skipped. If ENDP is not NULL, it will
107    point to the next non-parsed character in TIMESTRING. */
108 time_t _gpgme_parse_timestamp (const char *timestamp, char **endp);
109
110
111 gpgme_error_t _gpgme_map_gnupg_error (char *err);
112
113 \f
114 /* Retrieve the environment variable NAME and return a copy of it in a
115    malloc()'ed buffer in *VALUE.  If the environment variable is not
116    set, return NULL in *VALUE.  */
117 gpgme_error_t _gpgme_getenv (const char *name, char **value);
118
119 \f
120 #ifdef HAVE_W32_SYSTEM
121 int _gpgme_mkstemp (int *fd, char **name);
122 const char *_gpgme_get_w32spawn_path (void);
123 #endif
124
125 /*--  Error codes not yet available in current gpg-error.h.   --*/
126 #ifndef GPG_ERR_UNFINISHED
127 #define GPG_ERR_UNFINISHED 199
128 #endif
129 #ifndef GPG_ERR_NOT_OPERATIONAL 
130 #define GPG_ERR_NOT_OPERATIONAL 176
131 #endif
132
133 \f
134 #ifdef ENABLE_ASSUAN
135 #include <assuan.h>
136 /* System hooks for assuan integration.  */
137 extern struct assuan_system_hooks _gpgme_assuan_system_hooks;
138 extern struct assuan_malloc_hooks _gpgme_assuan_malloc_hooks;
139 int _gpgme_assuan_log_cb (assuan_context_t ctx, void *hook,
140                           unsigned int cat, const char *msg);
141 #endif
142
143 #endif /* UTIL_H */