projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| 65824f48 BJ |
1 | .TH DUMP 5 |
| 2 | .SH NAME | |
| 3 | dump, ddate \- incremental dump format | |
| 4 | .SH SYNOPSIS | |
| 5 | .B #include <sys/types.h> | |
| 6 | .br | |
| 7 | .B #include <sys/ino.h> | |
| 8 | .br | |
| 9 | .B # include <dumprestor.h> | |
| 10 | .SH DESCRIPTION | |
| 11 | Tapes used by | |
| 12 | .I dump | |
| 13 | and | |
| 14 | .IR restor (1) | |
| 15 | contain: | |
| 16 | .nf | |
| 17 | .IP "" | |
| 18 | a header record | |
| 19 | two groups of bit map records | |
| 20 | a group of records describing directories | |
| 21 | a group of records describing files | |
| 22 | .fi | |
| 23 | .PP | |
| 24 | The format of the header record and of the first | |
| 25 | record of each description as given in the | |
| 26 | include file | |
| 27 | .I <dumprestor.h> | |
| 28 | is: | |
| 29 | .PP | |
| 30 | .nf | |
| 31 | .ta .5i \w'#define\ TS_INODE\ 'u | |
| 32 | .so /usr/include/dumprestor.h | |
| 33 | .fi | |
| 34 | .PP | |
| 35 | .I NTREC | |
| 36 | is the number of 1024 byte records in a physical | |
| 37 | tape block. | |
| 38 | .I MLEN | |
| 39 | is the number of bits in a bit map word. | |
| 40 | .I MSIZ | |
| 41 | is the number of bit map words. | |
| 42 | .PP | |
| 43 | The | |
| 44 | .I TS_ | |
| 45 | entries are used in the | |
| 46 | .I c_type | |
| 47 | field to indicate what sort of header | |
| 48 | this is. | |
| 49 | The types and their meanings are as follows: | |
| 50 | .TP \w'CHECKSUM\|'u | |
| 51 | TS_TAPE | |
| 52 | Tape volume label | |
| 53 | .PD 0 | |
| 54 | .TP | |
| 55 | TS_INODE | |
| 56 | A file or directory follows. | |
| 57 | The | |
| 58 | .I c_dinode | |
| 59 | field is a copy of the disk inode and contains | |
| 60 | bits telling what sort of file this is. | |
| 61 | .TP | |
| 62 | TS_BITS | |
| 63 | A bit map follows. | |
| 64 | This bit map has a one bit | |
| 65 | for each inode that was dumped. | |
| 66 | .TP | |
| 67 | TS_ADDR | |
| 68 | A subrecord of a file description. | |
| 69 | See | |
| 70 | .I c_addr | |
| 71 | below. | |
| 72 | .TP | |
| 73 | TS_END | |
| 74 | End of tape record. | |
| 75 | .TP | |
| 76 | TS_CLRI | |
| 77 | A bit map follows. | |
| 78 | This bit map contains a zero bit for | |
| 79 | all inodes that were empty on the file system when dumped. | |
| 80 | .TP | |
| 81 | MAGIC | |
| 82 | All header records have this number in | |
| 83 | .I c_magic. | |
| 84 | .TP | |
| 85 | CHECKSUM | |
| 86 | Header records checksum to this value. | |
| 87 | .PD | |
| 88 | .PP | |
| 89 | The fields of the header structure are as follows: | |
| 90 | .TP \w'TS_INODE\ 'u | |
| 91 | c_type | |
| 92 | The type of the header. | |
| 93 | .PD 0 | |
| 94 | .TP | |
| 95 | c_date | |
| 96 | The date the dump was taken. | |
| 97 | .TP | |
| 98 | c_ddate | |
| 99 | The date the file system was dumped from. | |
| 100 | .TP | |
| 101 | c_volume | |
| 102 | The current volume number of the dump. | |
| 103 | .TP | |
| 104 | c_tapea | |
| 105 | The current number of this (1024-byte) record. | |
| 106 | .TP | |
| 107 | c_inumber | |
| 108 | The number of the inode being dumped if this | |
| 109 | is of type | |
| 110 | .I TS_INODE. | |
| 111 | .TP | |
| 112 | c_magic | |
| 113 | This contains the value | |
| 114 | .I MAGIC | |
| 115 | above, truncated as needed. | |
| 116 | .TP | |
| 117 | c_checksum | |
| 118 | This contains whatever value is needed to | |
| 119 | make the record sum to | |
| 120 | .I CHECKSUM. | |
| 121 | .TP | |
| 122 | c_dinode | |
| 123 | This is a copy of the inode as it appears on the | |
| 124 | file system; see | |
| 125 | .IR filsys (5). | |
| 126 | .TP | |
| 127 | c_count | |
| 128 | The count of characters in | |
| 129 | .I c_addr. | |
| 130 | .TP | |
| 131 | c_addr | |
| 132 | An array of characters describing the blocks of the | |
| 133 | dumped file. | |
| 134 | A character is zero if the block associated with that character was not | |
| 135 | present on the file system, otherwise the character is non-zero. | |
| 136 | If the block was not present on the file system, no block was dumped; | |
| 137 | the block will be restored as a hole in the file. | |
| 138 | If there is not sufficient space in this record to describe | |
| 139 | all of the blocks in a file, | |
| 140 | .I TS_ADDR | |
| 141 | records will be scattered through the file, each one | |
| 142 | picking up where the last left off. | |
| 143 | .PD | |
| 144 | .PP | |
| 145 | Each volume except the last ends with a tapemark (read as an end | |
| 146 | of file). | |
| 147 | The last volume ends with a | |
| 148 | .I TS_END | |
| 149 | record and then the tapemark. | |
| 150 | .PP | |
| 151 | The structure | |
| 152 | .I idates | |
| 153 | describes an entry of the file | |
| 154 | .I /etc/ddate | |
| 155 | where dump history is kept. | |
| 156 | The fields of the structure are: | |
| 157 | .TP \w'TS_INODE\ 'u | |
| 158 | id_name | |
| 159 | The dumped filesystem is | |
| 160 | .RI `/dev/ id_nam'. | |
| 161 | .PD 0 | |
| 162 | .TP | |
| 163 | id_incno | |
| 164 | The level number of the dump tape; | |
| 165 | see | |
| 166 | .IR dump (1). | |
| 167 | .TP | |
| 168 | id_ddate | |
| 169 | The date of the incremental dump in system format | |
| 170 | see | |
| 171 | .IR types (5). | |
| 172 | .PD | |
| 173 | .SH FILES | |
| 174 | /etc/ddate | |
| 175 | .SH "SEE ALSO" | |
| 176 | dump(1), dumpdir(1), restor(1), filsys(5), types(5) |