git.gag.com Git - debian/amanda/blob - server-src/diskfile.h

   1 /*
   2  * Amanda, The Advanced Maryland Automatic Network Disk Archiver
   3  * Copyright (c) 1991-1998 University of Maryland at College Park
   4  * All Rights Reserved.
   5  *
   6  * Permission to use, copy, modify, distribute, and sell this software and its
   7  * documentation for any purpose is hereby granted without fee, provided that
   8  * the above copyright notice appear in all copies and that both that
   9  * copyright notice and this permission notice appear in supporting
  10  * documentation, and that the name of U.M. not be used in advertising or
  11  * publicity pertaining to distribution of the software without specific,
  12  * written prior permission.  U.M. makes no representations about the
  13  * suitability of this software for any purpose.  It is provided "as is"
  14  * without express or implied warranty.
  15  *
  16  * U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL
  17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M.
  18  * BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  19  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  20  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  21  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  22  *
  23  * Author: James da Silva, Systems Design and Analysis Group
  24  *                         Computer Science Department
  25  *                         University of Maryland at College Park
  26  */
  27 /*
  28  * $Id: diskfile.h,v 1.38 2006/06/22 20:41:33 martinea Exp $
  29  *
  30  * interface for disklist file reading code
  31  */
  32 #ifndef DISKFILE_H
  33 #define DISKFILE_H
  34
  35 #include "amanda.h"
  36 #include "conffile.h"
  37 #include "fileheader.h"
  38 #include "amfeatures.h"
  39
  40 typedef struct netif_s {
  41     struct netif_s *next;
  42     interface_t *config;
  43     unsigned long curusage;
  44 } netif_t;
  45
  46 typedef struct amhost_s {
  47     struct amhost_s *next;              /* next host */
  48     char *hostname;                     /* name of host */
  49     struct disk_s *disks;               /* linked list of disk records */
  50     int inprogress;                     /* # dumps in progress */
  51     int maxdumps;                       /* maximum dumps in parallel */
  52     netif_t *netif;                     /* network interface this host is on */
  53     time_t start_t;                     /* time last dump was started on this host */
  54     char *up;                           /* generic user pointer */
  55     am_feature_t *features;             /* feature set */
  56     int  pre_script;
  57     int  post_script;
  58 } am_host_t;
  59
  60 typedef struct disk_s {
  61     int         line;                   /* line number of last definition */
  62     struct disk_s *prev, *next;         /* doubly linked disk list */
  63
  64     am_host_t   *host;                  /* host list */
  65     struct disk_s *hostnext;
  66
  67     char        *hostname;              /* hostname */
  68     char        *name;                  /* label name for disk */
  69     char        *device;                /* device name for disk, eg "sd0g" */
  70     char        *dtype_name;            /* name of dump type */
  71     dumptype_t  *config;                /* pointer to the dumptype config */
  72     char        *program;               /* dump program, eg DUMP, STAR, GNUTAR */
  73     char        *srvcompprog;           /* custom compression server filter */
  74     char        *clntcompprog;          /* custom compression client filter */
  75     char        *srv_encrypt;           /* custom encryption server filter */
  76     char        *clnt_encrypt;          /* custom encryption client filter */
  77     char        *amandad_path;          /* amandad path on the client */
  78     char        *client_username;       /* username to connect on the client */
  79     char        *client_port;           /* port to connect on the client */
  80     char        *ssh_keys;              /* ssh_key file to use */
  81     sl_t        *exclude_file;          /* file exclude spec */
  82     sl_t        *exclude_list;          /* exclude list */
  83     sl_t        *include_file;          /* file include spec */
  84     sl_t        *include_list;          /* include list */
  85     int         exclude_optional;       /* exclude list are optional */
  86     int         include_optional;       /* include list are optional */
  87     int         priority;               /* priority of disk */
  88     int         allow_split;
  89     off_t       splitsize;
  90     off_t       tape_splitsize;         /* size of dumpfile chunks on tape */
  91     char        *split_diskbuffer;      /* place where we can buffer PORT-WRITE dumps other than RAM */
  92     off_t       fallback_splitsize;     /* size for in-RAM PORT-WRITE buffers */
  93     int         dumpcycle;              /* days between fulls */
  94     long        frequency;              /* XXX - not used */
  95     char        *auth;                  /* type of authentication (per disk) */
  96     int         maxdumps;               /* max number of parallel dumps (per system) */
  97     int         maxpromoteday;          /* maximum of promote day */
  98     int         bumppercent;
  99     off_t       bumpsize;
 100     int         bumpdays;
 101     double      bumpmult;
 102     time_t      starttime;              /* start this dump after this time (integer: HHMM) */
 103     time_t      start_t;                /* start this dump after this time (time_t) */
 104     int         strategy;               /* what dump strategy to use */
 105     int         ignore;                 /* ignore */
 106     estimatelist_t estimatelist;        /* what estimate strategy to use */
 107     int         compress;               /* type of compression to use */
 108     int         encrypt;                /* type of encryption to use */
 109     char        *srv_decrypt_opt;       /* server-side decryption option parameter to use */
 110     char        *clnt_decrypt_opt;      /* client-side decryption option parameter to use */
 111     double      comprate[2];            /* default compression rates */
 112     /* flag options */
 113     int         record;                 /* record dump in /etc/dumpdates ? */
 114     int         skip_incr;              /* incs done externally ? */
 115     int         skip_full;              /* fulls done externally ? */
 116     int         to_holdingdisk;         /* use holding disk ? */
 117     int         kencrypt;
 118     int         index;                  /* produce an index ? */
 119     data_path_t data_path;              /* defined data-path */
 120     char       *dataport_list;          /* list of address to send data */
 121     int         spindle;                /* spindle # - for parallel dumps */
 122     int         inprogress;             /* being dumped now? */
 123     int         todo;
 124     char       *application;
 125     identlist_t pp_scriptlist;
 126     void        *up;                    /* generic user pointer */
 127 } disk_t;
 128
 129 typedef struct disklist_s {
 130     disk_t *head, *tail;
 131 } disklist_t;
 132
 133 #define empty(dlist)    ((dlist).head == NULL)
 134
 135 /* This function is integrated with the conffile.c error-handling; handle its return
 136  * value just as you would the return of config_init() */
 137 cfgerr_level_t read_diskfile(const char *, disklist_t *);
 138
 139 am_host_t *lookup_host(const char *hostname);
 140 disk_t *lookup_disk(const char *hostname, const char *diskname);
 141
 142 disk_t *add_disk(disklist_t *list, char *hostname, char *diskname);
 143
 144 void enqueue_disk(disklist_t *list, disk_t *disk);
 145 void headqueue_disk(disklist_t *list, disk_t *disk);
 146 void insert_disk(disklist_t *list, disk_t *disk, int (*f)(disk_t *a, disk_t *b));
 147 int  find_disk(disklist_t *list, disk_t *disk);
 148 void sort_disk(disklist_t *in, disklist_t *out, int (*f)(disk_t *a, disk_t *b));
 149 disk_t *dequeue_disk(disklist_t *list);
 150 void remove_disk(disklist_t *list, disk_t *disk);
 151
 152 void dump_queue(char *str, disklist_t q, int npr, FILE *f);
 153
 154 char *optionstr(disk_t *dp);
 155
 156 /* xml_optionstr()
 157  * to_server must be set to 1 if the result is sent to another server
 158  *           application, eg. driver to dumper.
 159  *           It must be set to 0 if the result is sent to the client.
 160  */
 161 GPtrArray *validate_optionstr(disk_t *dp);
 162 char *xml_optionstr(disk_t *dp, int to_server);
 163 char *xml_estimate(estimatelist_t estimatelist, am_feature_t *their_features);
 164 char *clean_dle_str_for_client(char *dle_str);
 165 char *xml_application(disk_t *dp, application_t *application,
 166                       am_feature_t *their_features);
 167 char *xml_scripts(identlist_t pp_scriptlist, am_feature_t *their_features);
 168
 169 /* disable_skip_disk() set the db->todo flag to 0 for each dle with 'ignore'
 170  * 'strategy skip'. It is useful for all programs that want to skip them,i
 171  * eg. all amdump process.
 172  * Program use for listing dump or index should not use it.
 173  */
 174 void disable_skip_disk(disklist_t *origqp);
 175
 176 char *match_disklist(disklist_t *origqp, int sargc, char **sargv);
 177 gboolean match_dumpfile(dumpfile_t *file, int sargc, char **sargv);
 178 void free_disklist(disklist_t *dl);
 179
 180 netif_t *disklist_netifs(void);
 181
 182 #endif /* ! DISKFILE_H */