]> git.sur5r.net Git - bacula/bacula/blobdiff - bacula/src/stored/record.h
This commit was manufactured by cvs2svn to create tag
[bacula/bacula] / bacula / src / stored / record.h
index 19a195807f16c972cc2bf26f1143352c881e318c..dd3047d478af6b6e1bfa893ffd9a9cda292fc2e8 100644 (file)
 #define __RECORD_H 1
 
 /* Return codes from read_device_volume_label() */
-#define VOL_NOT_READ     0               /* Volume label not read */
-#define VOL_OK           1               /* volume name OK */
-#define VOL_NO_LABEL     2               /* volume not labeled */
-#define VOL_IO_ERROR     3               /* volume I/O error */
-#define VOL_NAME_ERROR   4               /* Volume name mismatch */
-#define VOL_CREATE_ERROR  5              /* Error creating label */
-#define VOL_VERSION_ERROR 6              /* Bacula version error */
-#define VOL_LABEL_ERROR   7              /* Bad label type */
+#define VOL_NOT_READ      0               /* Volume label not read */
+#define VOL_OK            1               /* volume name OK */
+#define VOL_NO_LABEL      2               /* volume not labeled */
+#define VOL_IO_ERROR      3               /* volume I/O error */
+#define VOL_NAME_ERROR    4               /* Volume name mismatch */
+#define VOL_CREATE_ERROR  5               /* Error creating label */
+#define VOL_VERSION_ERROR 6               /* Bacula version error */
+#define VOL_LABEL_ERROR   7               /* Bad label type */
+#define VOL_NO_MEDIA      8               /* Hard error -- no media present */
 
 
-/* Length of Record Header (5 * 4 bytes) */
-#define RECHDR_LENGTH 20
+/*  See block.h for RECHDR_LENGTH */
 
 /*
  * This is the Media structure for a record header.
  *  NB: when it is written it is serialized.
- */
-typedef struct s_record_hdr {
+
    uint32_t VolSessionId;
    uint32_t VolSessionTime;
+
+ * The above 8 bytes are only written in a BB01 block, BB02
+ *  and later blocks contain these values in the block header
+ *  rather than the record header.
+
    int32_t  FileIndex;
    int32_t  Stream;
    uint32_t data_len;
-} RECORD_HDR;
+
+ */
+
+/* Record state bit definitions */
+#define REC_NO_HEADER        (1<<0)   /* No header read */
+#define REC_PARTIAL_RECORD   (1<<1)   /* returning partial record */
+#define REC_BLOCK_EMPTY      (1<<2)   /* not enough data in block */
+#define REC_NO_MATCH         (1<<3)   /* No match on continuation data */
+#define REC_CONTINUATION     (1<<4)   /* Continuation record found */
+#define REC_ISTAPE           (1<<5)   /* Set if device is tape */
+
+#define is_partial_record(r) ((r)->state & REC_PARTIAL_RECORD)
+#define is_block_empty(r)    ((r)->state & REC_BLOCK_EMPTY)
 
 /*
  * DEV_RECORD for reading and writing records.
@@ -61,19 +77,25 @@ typedef struct s_record_hdr {
  * 
  *  This is the memory structure for the record header.
  */
-typedef struct s_dev_rec {
-   int     sync;                     /* synchronous */
-   uint32_t File;                    /* File number, returned if sync set */
-   uint32_t Block;                   /* Block number, returned if sync set */
-   uint32_t VolSessionId;            /* sequential id within this session */
-   uint32_t VolSessionTime;          /* session start time */
-   int32_t  FileIndex;               /* sequential file number */
-   int32_t  Stream;                  /* stream number */
-   uint32_t data_len;                /* current record length */
-   uint32_t remainder;               /* remaining bytes to read/write */
-   uint8_t  ser_buf[RECHDR_LENGTH];   /* serialized record header goes here */
-   char *data;                       /* Record data. This MUST be a memory pool item */
-} DEV_RECORD;
+struct BSR;                           /* satisfy forward reference */
+struct DEV_RECORD {
+   dlink link;                        /* link for chaining in read_record.c */
+   /* File and Block are always returned during reading
+    *  and writing records.
+    */
+   uint32_t File;                     /* File number */
+   uint32_t Block;                    /* Block number */
+   uint32_t VolSessionId;             /* sequential id within this session */
+   uint32_t VolSessionTime;           /* session start time */
+   int32_t  FileIndex;                /* sequential file number */
+   int32_t  Stream;                   /* stream number */
+   uint32_t data_len;                 /* current record length */
+   uint32_t remainder;                /* remaining bytes to read/write */
+   uint32_t state;                    /* state bits */
+   BSR *bsr;                          /* pointer to bsr that matched */
+   uint8_t  ser_buf[WRITE_RECHDR_LENGTH];   /* serialized record header goes here */
+   POOLMEM *data;                     /* Record data. This MUST be a memory pool item */
+};           
 
 
 /*
@@ -81,36 +103,47 @@ typedef struct s_dev_rec {
  * Note, these values are negative to distinguish them
  * from user records where the FileIndex is forced positive.
  */
-#define PRE_LABEL   -1               /* Vol label on unwritten tape */
-#define VOL_LABEL   -2               /* Volume label first file */
-#define EOM_LABEL   -3               /* Writen at end of tape */        
-#define SOS_LABEL   -4               /* Start of Session */
-#define EOS_LABEL   -5               /* End of Session */
+#define PRE_LABEL   -1                /* Vol label on unwritten tape */
+#define VOL_LABEL   -2                /* Volume label first file */
+#define EOM_LABEL   -3                /* Writen at end of tape */        
+#define SOS_LABEL   -4                /* Start of Session */
+#define EOS_LABEL   -5                /* End of Session */
+#define EOT_LABEL   -6                /* End of physical tape (2 eofs) */
 
 /* 
- *   Volume Label Record
+ *   Volume Label Record.  This is the in-memory definition. The
+ *     tape definition is defined in the serialization code itself
+ *     ser_volume_label() and unser_volume_label() and is slightly different.
  */
+
 struct Volume_Label {
   /*  
    * The first items in this structure are saved
    * in the DEVICE buffer, but are not actually written
    * to the tape.
    */
-  int32_t LabelType;                 /* This is written in header only */
-  uint32_t LabelSize;                /* length of serialized label */
+  int32_t LabelType;                  /* This is written in header only */
+  uint32_t LabelSize;                 /* length of serialized label */
   /*
    * The items below this line are stored on 
    * the tape
    */
-  char Id[32];                       /* Bacula Immortal ... */
+  char Id[32];                        /* Bacula Immortal ... */
+
+  uint32_t VerNum;                    /* Label version number */
 
-  uint32_t VerNum;                   /* Label version number */
+  /* VerNum <= 10 */
+  float64_t label_date;               /* Date tape labeled */
+  float64_t label_time;               /* Time tape labeled */
 
-  float64_t label_date;              /* Date tape labeled */
-  float64_t label_time;              /* Time tape labeled */
-  float64_t write_date;              /* Date this label written */
-  float64_t write_time;              /* Time this label written */
+  /* VerNum >= 11 */
+  btime_t   label_btime;              /* tdate tape labeled */
+  btime_t   write_btime;              /* tdate tape written */
+
+  /* Unused with VerNum >= 11 */
+  float64_t write_date;               /* Date this label written */
+  float64_t write_time;               /* Time this label written */
 
   char VolName[MAX_NAME_LENGTH];      /* Volume name */
   char PrevVolName[MAX_NAME_LENGTH];  /* Previous Volume Name */
@@ -119,9 +152,9 @@ struct Volume_Label {
   char MediaType[MAX_NAME_LENGTH];    /* Type of this media */
 
   char HostName[MAX_NAME_LENGTH];     /* Host name of writing computer */
-  char LabelProg[32];                /* Label program name */
-  char ProgVersion[32];              /* Program version */
-  char ProgDate[32];                 /* Program build date/time */
+  char LabelProg[50];                 /* Label program name */
+  char ProgVersion[50];               /* Program version */
+  char ProgDate[50];                  /* Program build date/time */
 };
 
 #define SER_LENGTH_Volume_Label 1024   /* max serialised length of volume label */
@@ -134,31 +167,44 @@ typedef struct Volume_Label VOLUME_LABEL;
  *  This record is at the beginning and end of each session
  */
 struct Session_Label {
-  char Id[32];                       /* Bacula Immortal ... */
+  char Id[32];                        /* Bacula Immortal ... */
+
+  uint32_t VerNum;                    /* Label version number */
+
+  uint32_t JobId;                     /* Job id */
+  uint32_t VolumeIndex;               /* Sequence no of volume for this job */
 
-  uint32_t VerNum;                   /* Label version number */
+  /* VerNum >= 11 */
+  btime_t   write_btime;              /* Tdate this label written */
 
-  uint32_t JobId;                    /* Job id */
-  uint32_t VolumeIndex;              /* Sequence no of volume for this job */
+  /* VerNum < 11 */
+  float64_t write_date;               /* Date this label written */
 
-  float64_t write_date;              /* Date this label written */
-  float64_t write_time;              /* Time this label written */
+  /* Unused VerNum >= 11 */
+  float64_t write_time;               /* Time this label written */
 
   char PoolName[MAX_NAME_LENGTH];     /* Pool name */
   char PoolType[MAX_NAME_LENGTH];     /* Pool type */
-  char JobName[MAX_NAME_LENGTH];
+  char JobName[MAX_NAME_LENGTH];      /* base Job name */
   char ClientName[MAX_NAME_LENGTH];
+  char Job[MAX_NAME_LENGTH];          /* Unique name of this Job */
+  char FileSetName[MAX_NAME_LENGTH];
+  char FileSetMD5[MAX_NAME_LENGTH];
+  uint32_t JobType;
+  uint32_t JobLevel;
+  /* The remainder are part of EOS label only */
   uint32_t JobFiles;
   uint64_t JobBytes;
-  uint32_t start_block;
-  uint32_t end_block;
-  uint32_t start_file;
-  uint32_t end_file;
+  uint32_t StartBlock;
+  uint32_t EndBlock;
+  uint32_t StartFile;
+  uint32_t EndFile;
   uint32_t JobErrors;
+  uint32_t JobStatus;                 /* Job status */
 
 };
 typedef struct Session_Label SESSION_LABEL;
 
-#define SERIAL_BUFSIZE 1024          /* volume serialisation buffer size */
+#define SERIAL_BUFSIZE  1024          /* volume serialisation buffer size */
 
 #endif