Commit | Line | Data |
---|---|---|
72972dd0 TL |
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 512 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 (512-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) |