diff options
Diffstat (limited to 'static/unix-v10/man5/dump.5')
| -rw-r--r-- | static/unix-v10/man5/dump.5 | 211 |
1 files changed, 211 insertions, 0 deletions
diff --git a/static/unix-v10/man5/dump.5 b/static/unix-v10/man5/dump.5 new file mode 100644 index 00000000..aeb57c96 --- /dev/null +++ b/static/unix-v10/man5/dump.5 @@ -0,0 +1,211 @@ +.TH DUMP 5 +.UC 4 +.SH NAME +dump, ddate \- incremental dump format +.SH SYNOPSIS +.B #include <sys/types.h> +.br +.B #include <sys/ino.h> +.br +.B #include <dumprestor.h> +.SH DESCRIPTION +Tapes used by +.I dump +and +.IR restor (1) +contain: +.nf +.IP "" +a header record +two groups of bit map records +a group of records describing directories +a group of records describing files +.fi +.PP +The format of the header record and of the first +record of each description as given in the +include file +.I <dumprestor.h> +is: +.PP +.nf +#define NTREC 10 +#define MLEN 16 +#define MSIZ 4096 + +#define TS_TAPE 1 +#define TS_INODE 2 +#define TS_BITS 3 +#define TS_ADDR 4 +#define TS_END 5 +#define TS_CLRI 6 +#define MAGIC (int) 60011 +#define CHECKSUM (int) 84446 + +struct spcl { + int c_type; + time_t c_date; + time_t c_ddate; + int c_volume; + daddr_t c_tapea; + ino_t c_inumber; + int c_magic; + int c_checksum; + struct dinode c_dinode; + int c_count; + char c_addr[BSIZE]; +} spcl; + +struct idates { + char id_name[16]; + char id_incno; + time_t id_ddate; +}; + +#define DUMPOUTFMT "%-16s %c %s" /* for printf */ + /* name, incno, ctime(date) */ +#define DUMPINFMT "%16s %c %[^\en]\en" /* inverse for scanf */ +.fi +.PP +.I NTREC +is the number of 1024 byte records in a physical +tape block. +.I MLEN +is the number of bits in a bit map word. +.I MSIZ +is the number of bit map words. +.PP +The +.I TS_ +entries are used in the +.I c_type +field to indicate what sort of header +this is. +The types and their meanings are as follows: +.TP 13 +TS_TAPE +Tape volume label +.PD 0 +.TP +TS_INODE +A file or directory follows. +The +.I c_dinode +field is a copy of the disk inode and contains +bits telling what sort of file this is. +.TP +TS_BITS +A bit map follows. +This bit map has a one bit +for each inode that was dumped. +.TP +TS_ADDR +A subrecord of a file description. +See +.I c_addr +below. +.TP +TS_END +End of tape record. +.TP +TS_CLRI +A bit map follows. +This bit map contains a zero bit for +all inodes that were empty on the file system when dumped. +.TP +MAGIC +All header records have this number in +.I c_magic. +.TP +CHECKSUM +Header records checksum to this value. +.PD +.PP +The fields of the header structure are as follows: +.TP 13 +c_type +The type of the header. +.PD 0 +.TP +c_date +The date the dump was taken. +.TP +c_ddate +The date the file system was dumped from. +.TP +c_volume +The current volume number of the dump. +.TP +c_tapea +The current number of this (1024-byte) record. +.TP +c_inumber +The number of the inode being dumped if this +is of type +.I TS_INODE. +.TP +c_magic +This contains the value +.I MAGIC +above, truncated as needed. +.TP +c_checksum +This contains whatever value is needed to +make the record sum to +.I CHECKSUM. +.TP +c_dinode +This is a copy of the inode as it appears on the +file system; see +.IR filsys (5). +.TP +c_count +The count of characters in +.I c_addr. +.TP +c_addr +An array of characters describing the blocks of the +dumped file. +A character is zero if the block associated with that character was not +present on the file system, otherwise the character is non-zero. +If the block was not present on the file system, no block was dumped; +the block will be restored as a hole in the file. +If there is not sufficient space in this record to describe +all of the blocks in a file, +.I TS_ADDR +records will be scattered through the file, each one +picking up where the last left off. +.PD +.PP +Each volume except the last ends with a tapemark (read as an end +of file). +The last volume ends with a +.I TS_END +record and then the tapemark. +.PP +The structure +.I idates +describes an entry of the file +.I /etc/ddate +where dump history is kept. +The fields of the structure are: +.TP \w'TS_INODE\ 'u +id_name +The dumped filesystem is +.RI `/dev/ id_nam'. +.PD 0 +.TP +id_incno +The level number of the dump tape; +see +.IR dump (1). +.TP +id_ddate +The date of the incremental dump in system format +see +.IR types (5). +.PD +.SH FILES +/etc/ddate +.SH "SEE ALSO" +dump(8), dumpdir(8), restor(8), filsys(5), types(5) |