

DUMP(5)                       1985			  DUMP(5)


NNAAMMEE
     dump, dumpdates - incremental dump format

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<ssyyss//iinnooddee..hh>>
     ##iinncclluuddee <<pprroottooccoollss//dduummpprreessttoorree..hh>>

DDEESSCCRRIIPPTTIIOONN
     Tapes used by _d_u_m_p and _r_e_s_t_o_r_e(8) contain:

	  a header record
	  two groups of bit map records
	  a group of records describing directories
	  a group of records describing files

     The format of the header record and of the first record of
     each description as given in the include file
     <_p_r_o_t_o_c_o_l_s/_d_u_m_p_r_e_s_t_o_r_e._h> is:

     #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;
     };


Printed 7/27/90               June				1


DUMP(5)                       1985			  DUMP(5)


     #define   DUMPOUTFMT     "%-16s %c %s"	  /* for printf */
				   /* name, incno, ctime(date) */
     #define   DUMPINFMT "%16s %c %[^\n]\n"  /* inverse for scanf */

     NTREC is the number of 1024 byte records in a physical tape
     block.  MLEN is the number of bits in a bit map word.  MSIZ
     is the number of bit map words.

     The TS_ entries are used in the _c__t_y_p_e field to indicate
     what sort of header this is.  The types and their meanings
     are as follows:

     TS_TAPE	  Tape volume label
     TS_INODE	  A file or directory follows.	The _c__d_i_n_o_d_e
		  field is a copy of the disk inode and contains
		  bits telling what sort of file this is.
     TS_BITS	  A bit map follows.  This bit map has a one bit
		  for each inode that was dumped.
     TS_ADDR	  A subrecord of a file description.  See _c__a_d_d_r
		  below.
     TS_END	  End of tape record.
     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.
     MAGIC	  All header records have this number in _c__m_a_g_i_c.
     CHECKSUM	  Header records checksum to this value.

     The fields of the header structure are as follows:

     c_type	  The type of the header.
     c_date	  The date the dump was taken.
     c_ddate	  The date the file system was dumped from.
     c_volume	  The current volume number of the dump.
     c_tapea	  The current number of this (1024-byte) record.
     c_inumber	  The number of the inode being dumped if this is
		  of type TS_INODE.
     c_magic	  This contains the value MAGIC above, truncated
		  as needed.
     c_checksum   This contains whatever value is needed to make
		  the record sum to CHECKSUM.
     c_dinode	  This is a copy of the inode as it appears on
		  the file system; see _f_s(5).
     c_count	  The count of characters in _c__a_d_d_r.
     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 char-
		  acter 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


Printed 7/27/90               June				2


DUMP(5)                       1985			  DUMP(5)


		  file, TS_ADDR records will be scattered through
		  the file, each one picking up where the last
		  left off.

     Each volume except the last ends with a tapemark (read as an
     end of file).  The last volume ends with a TS_END record and
     then the tapemark.

     The structure _i_d_a_t_e_s describes an entry in the file
     /_e_t_c/_d_u_m_p_d_a_t_e_s where dump history is kept.  The fields of
     the structure are:

     id_name  The dumped filesystem is `/dev/_i_d__n_a_m'.
     id_incno The level number of the dump tape; see _d_u_m_p(8).
     id_ddate The date of the incremental dump in system format
	      see _t_y_p_e_s(5).

FFIILLEESS
     /etc/dumpdates

SSEEEE AALLSSOO
     dump(8), restore(8), fs(5), types(5)


Printed 7/27/90               June				3