prep for 1.2rc2 release
[rrdtool.git] / src / rrd_tool.h
1 /*****************************************************************************
2  * RRDtool 1.2rc2  Copyright by Tobi Oetiker, 1997-2005
3  *****************************************************************************
4  * rrd_tool.h   Common Header File
5  *****************************************************************************/
6 #ifdef  __cplusplus
7 extern "C" {
8 #endif
9
10
11 #ifndef _RRD_TOOL_H
12 #define _RRD_TOOL_H
13
14 #ifdef WIN32
15 #include "../confignt/config.h"
16 #else
17 #ifdef HAVE_CONFIG_H
18 #include <config.h>
19 #endif
20 #endif
21
22 #ifdef MUST_DISABLE_SIGFPE
23 #include <signal.h>
24 #endif
25
26 #ifdef MUST_DISABLE_FPMASK
27 #include <floatingpoint.h>
28 #endif
29     
30 #include <stdio.h>
31 #include <stdlib.h>
32 #include <errno.h>
33 #include <string.h>
34 #include <time.h>
35 #include <ctype.h>
36
37 #if HAVE_SYS_PARAM_H
38 #  include <sys/param.h>
39 #endif
40
41 #ifndef MAXPATH
42 #  define MAXPATH 1024
43 #endif
44
45 #if HAVE_MATH_H
46 # include <math.h>
47 #endif
48 /* Sorry: don't know autoconf as well how to check the exist of
49    dirent.h ans sys/stat.h
50 */
51
52 #if HAVE_DIRENT_H
53 # include <dirent.h>
54 # define NAMLEN(dirent) strlen((dirent)->d_name)
55 #else
56 # define dirent direct
57 # define NAMLEN(dirent) (dirent)->d_namlen
58 # if HAVE_SYS_NDIR_H
59 #  include <sys/ndir.h>
60 # endif
61 # if HAVE_SYS_DIR_H
62 #  include <sys/dir.h>
63 # endif
64 # if HAVE_NDIR_H
65 #  include <ndir.h>
66 # endif
67 #endif
68
69 #if HAVE_SYS_TYPES_H
70 # include <sys/types.h>
71 #endif
72
73 #if HAVE_SYS_STAT_H
74 # include <sys/stat.h>
75 #endif
76
77
78 #if HAVE_UNISTD_H
79 # include <unistd.h>
80 #endif
81 #if HAVE_SYS_TIME_H
82 # include <sys/time.h>
83 #endif
84 #if HAVE_SYS_TIMES_H
85 # include <sys/times.h>
86 #endif
87 #if HAVE_SYS_RESOURCE_H
88 # include <sys/resource.h>
89 #if (defined(__svr4__) && defined(__sun__))
90 /* Solaris headers (pre 2.6) don't have a getrusage prototype.
91    Use this instead. */
92 extern int getrusage(int, struct rusage *);
93 #endif /* __svr4__ && __sun__ */
94 #endif
95
96 #include "rrd.h"
97
98 #ifndef WIN32
99
100 /* unix-only includes */
101 #ifndef isnan
102 int isnan(double value);
103 #endif
104
105 #else
106
107 /* Win32 only includes */
108
109 #include <float.h>        /* for _isnan  */
110 #define isnan _isnan
111 #define finite _finite
112 #define isinf(a) (_fpclass(a) == _FPCLASS_NINF || _fpclass(a) == _FPCLASS_PINF)
113 struct tm* localtime_r(const time_t *timep, struct tm* result);
114 char* ctime_r(const time_t *timep, char* result);
115 struct tm* gmtime_r(const time_t *timep, struct tm* result);
116 char *strtok_r(char *str, const char *sep, char **last);
117 #endif
118
119 /* local include files -- need to be after the system ones */
120 #include "getopt.h"
121 #include "rrd_format.h"
122
123 #ifndef max
124 #define max(a,b) ((a) > (b) ? (a) : (b))
125 #endif
126
127 #ifndef min
128 #define min(a,b) ((a) < (b) ? (a) : (b))
129 #endif                                                   
130
131 #define DIM(x) (sizeof(x)/sizeof(x[0]))
132
133 /* rrd info interface */
134 enum info_type   { RD_I_VAL=0,
135                RD_I_CNT,
136                RD_I_STR, 
137                    RD_I_INT };
138
139 typedef union infoval { 
140     unsigned long u_cnt; 
141     rrd_value_t   u_val;
142     char         *u_str;
143     int           u_int;
144 } infoval;
145
146 typedef struct info_t {
147     char            *key;
148     enum info_type  type;
149     union infoval   value;
150     struct info_t   *next;
151 } info_t;
152
153 info_t *rrd_info(int, char **);
154 info_t *rrd_update_v(int, char **);
155 char * sprintf_alloc(char *, ...);
156 info_t *info_push(info_t *, char *, enum info_type, infoval);
157
158 /* HELPER FUNCTIONS */
159
160 int PngSize(FILE *, long *, long *);
161
162 int rrd_create_fn(char *file_name, rrd_t *rrd);
163 int rrd_fetch_fn(char *filename, enum cf_en cf_idx,
164                  time_t *start,time_t *end,
165                  unsigned long *step,
166                  unsigned long *ds_cnt,
167                  char        ***ds_namv,
168                  rrd_value_t **data);
169
170 void rrd_free(rrd_t *rrd);
171 void rrd_freemem(void *mem);
172 void rrd_init(rrd_t *rrd);
173
174 int rrd_open(const char *file_name, FILE **in_file, rrd_t *rrd, int rdwr);
175 int readfile(const char *file, char **buffer, int skipfirst);
176
177 #define RRD_READONLY    0
178 #define RRD_READWRITE   1
179
180 enum cf_en cf_conv(char *string);
181 enum dst_en dst_conv(char *string);
182 long ds_match(rrd_t *rrd,char *ds_nam);
183 double rrd_diff(char *a, char *b);
184
185     /* rrd_strerror is thread safe, but still it uses a global buffer
186        (but one per thread), thus subsequent calls within a single
187        thread overwrite the same buffer */
188 const char *rrd_strerror(int err);
189
190 #endif
191
192 #ifdef  __cplusplus
193 }
194 #endif