src/rrd.h

   1 /*****************************************************************************
   2  * RRDtool 1.2.15  Copyright by Tobi Oetiker, 1997-2006
   3  *****************************************************************************
   4  * rrdlib.h   Public header file for librrd
   5  *****************************************************************************
   6  * $Id$
   7  * $Log$
   8  * Revision 1.9  2005/02/13 16:13:33  oetiker
   9  * let rrd_graph return the actual value range it picked ...
  10  * -- Henrik Stoerner <henrik@hswn.dk>
  11  *
  12  * Revision 1.8  2004/05/26 22:11:12  oetiker
  13  * reduce compiler warnings. Many small fixes. -- Mike Slifcak <slif@bellsouth.net>
  14  *
  15  * Revision 1.7  2003/11/12 22:14:26  oetiker
  16  * allow to pass an open filehandle into rrd_graph as an extra argument
  17  *
  18  * Revision 1.6  2003/11/11 19:46:21  oetiker
  19  * replaced time_value with rrd_time_value as MacOS X introduced a struct of that name in their standard headers
  20  *
  21  * Revision 1.5  2003/04/25 18:35:08  jake
  22  * Alternate update interface, updatev. Returns info about CDPs written to disk as result of update. Output format is similar to rrd_info, a hash of key-values.
  23  *
  24  * Revision 1.4  2003/04/01 22:52:23  jake
  25  * Fix Win32 build. VC++ 6.0 and 7.0 now use the thread-safe code.
  26  *
  27  * Revision 1.3  2003/02/13 07:05:27  oetiker
  28  * Find attached the patch I promised to send to you. Please note that there
  29  * are three new source files (src/rrd_is_thread_safe.h, src/rrd_thread_safe.c
  30  * and src/rrd_not_thread_safe.c) and the introduction of librrd_th. This
  31  * library is identical to librrd, but it contains support code for per-thread
  32  * global variables currently used for error information only. This is similar
  33  * to how errno per-thread variables are implemented.  librrd_th must be linked
  34  * alongside of libpthred
  35  *
  36  * There is also a new file "THREADS", holding some documentation.
  37  *
  38  * -- Peter Stamfest <peter@stamfest.at>
  39  *
  40  * Revision 1.2  2002/05/07 21:58:32  oetiker
  41  * new command rrdtool xport integrated
  42  * --  Wolfgang Schrimm <Wolfgang.Schrimm@urz.uni-heidelberg.de>
  43  *
  44  * Revision 1.1.1.1  2001/02/25 22:25:05  oetiker
  45  * checkin
  46  *
  47  *****************************************************************************/
  48 #ifdef  __cplusplus
  49 extern "C" {
  50 #endif
  51
  52 #ifndef _RRDLIB_H
  53 #define _RRDLIB_H
  54
  55 #include <time.h>
  56 #include <stdio.h> /* for FILE */
  57
  58 /* Transplanted from rrd_format.h */
  59 typedef double       rrd_value_t;         /* the data storage type is
  60                                            * double */
  61 /* END rrd_format.h */
  62
  63 /* main function blocks */
  64 int    rrd_create(int, char **);
  65 int    rrd_update(int, char **);
  66 int    rrd_graph(int, char **, char ***, int *, int *, FILE *, double *, double *);
  67 int    rrd_fetch(int, char **, time_t *, time_t *, unsigned long *,
  68                  unsigned long *, char ***, rrd_value_t **);
  69 int    rrd_restore(int, char **);
  70 int    rrd_dump(int, char **);
  71 int    rrd_tune(int, char **);
  72 time_t rrd_last(int, char **);
  73 time_t rrd_first(int, char **);
  74 int    rrd_resize(int, char **);
  75 char * rrd_strversion(void);
  76 double rrd_version(void);
  77 int    rrd_xport(int, char **, int *, time_t *, time_t *,
  78                  unsigned long *, unsigned long *,
  79                  char ***, rrd_value_t **);
  80
  81 /* thread-safe (hopefully) */
  82 int    rrd_create_r(char *filename,
  83                     unsigned long pdp_step, time_t last_up,
  84                     int argc, char **argv);
  85 /* NOTE: rrd_update_r are only thread-safe if no at-style time
  86    specifications get used!!! */
  87 int    rrd_update_r(char *filename, char *_template,
  88                     int argc, char **argv);
  89 int    rrd_dump_r(const char *filename, char *outname);
  90 time_t rrd_last_r(const char *filename);
  91 time_t rrd_first_r(const char *filename, int rraindex);
  92
  93 /* Transplanted from parsetime.h */
  94 typedef enum {
  95         ABSOLUTE_TIME,
  96         RELATIVE_TO_START_TIME,
  97         RELATIVE_TO_END_TIME
  98 } timetype;
  99
 100 #define TIME_OK NULL
 101
 102 struct rrd_time_value {
 103   timetype type;
 104   long offset;
 105   struct tm tm;
 106 };
 107
 108 struct rrd_context {
 109     int len;
 110     int errlen;
 111     char *lib_errstr;
 112     char *rrd_error;
 113 };
 114
 115 /* returns the current per-thread rrd_context */
 116 struct rrd_context *rrd_get_context(void);
 117
 118 char *parsetime(const char *spec, struct rrd_time_value *ptv);
 119 /* END parsetime.h */
 120
 121 int proc_start_end (struct rrd_time_value *,  struct rrd_time_value *, time_t *, time_t *);
 122
 123 /* HELPER FUNCTIONS */
 124 void rrd_set_error(char *,...);
 125 void rrd_clear_error(void);
 126 int  rrd_test_error(void);
 127 char *rrd_get_error(void);
 128
 129 /** MULTITHREADED HELPER FUNCTIONS */
 130 struct rrd_context *rrd_new_context(void);
 131 void   rrd_free_context (struct rrd_context *buf);
 132
 133 /* void   rrd_set_error_r  (struct rrd_context *, char *, ...); */
 134 /* void   rrd_clear_error_r(struct rrd_context *); */
 135 /* int    rrd_test_error_r (struct rrd_context *); */
 136 /* char  *rrd_get_error_r  (struct rrd_context *); */
 137
 138 int  LockRRD(FILE *);
 139
 140 #endif /* _RRDLIB_H */
 141
 142 #ifdef  __cplusplus
 143 }
 144 #endif