unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



dump(4)								      dump(4)



NAME

  dumprestor, dumpdates	- Incremental dump format

SYNOPSIS

  #include <&lt;sys/types.h>&gt;
  #include <&lt;ufs/inode.h>&gt;

DESCRIPTION

  Tapes	used by	dump and restore 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 <&lt;dumprestor.h>&gt; is:

	      #define NTREC	      10

	      #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 NFS_MAGIC	      (int) 60012
	      #define CHECKSUM	      (int) 84446

	      #define TP_BSIZE	      1024
	      #define TP_NINDIR	      (TP_BSIZE/2)
	      #define LBLSIZE	      16
	      #define NAMELEN	      64
	      struct  s_spcl {
		      long	      c_type;
		      time_t	      c_date;
		      time_t	      c_ddate;
		      long	      c_volume;
		      daddr_t	      c_tapea;
		      ino_t	      c_inumber;
		      long	      c_magic;
		      long	      c_checksum;
		      struct	      dinode	      c_dinode;
		      long	      c_count;
		      char	      c_addr[TP_NINDIR];
		      char	      c_label[LBLSIZE];
		      long	      c_level;
		      char	      c_filesys[NAMELEN];
		      char	      c_dev[NAMELEN];
		      char	      c_host[NAMELEN];
		      long	      c_flags;
	      }	s_spcl;

	      struct idates
	      {
		      char	      id_name[NAME_MAX + 3];
		      char	      id_incno;
		      time_t	      id_ddate;
	      };

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



  NTREC	is the number of TP_BSIZE-byte records in a physical tape block.

  The TS_ entries are used in the c_type 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_dinode 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 (1) bit for each	inode
	    that was dumped.

  TS_ADDR   A subrecord	of a file description.	See c_addr described in	the
	    next list.

  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.

  NFS_MAGIC All	header records have this number	in c_magic.

  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 of	the dump.

  c_ddate   The	date of	the previous dump to the file system.

  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.
	    For	further	information, see fs(4).

  c_count   The	count of characters in c_addr.

  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
	    nonzero.  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, TS_ADDR records will be
	    scattered through the file,	each one picking up where the last
	    left off.

  c_label   The	label of the dump.

  c_level   The	level number of	the dump.

  c_filesys The	name of	the file system.

  c_dev	    The	name of	the device.

  c_host    The	name of	the host.

  c_flags   Additional information such	as whether the dump uses the format
	    tape header	described here.

  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	idates describes an entry in the file /etc/dumpdates where
  dump history is kept.	 The fields of the structure are:

  id_name   The	dumped filesystem is `/dev/?/id_nam' where ? indicates a dev-
	    ice	class subdirectory such	as /dev/disk.

  id_incno  The	level number of	the dump tape.	For further information, see
	    dump(8).

  id_ddate  The	date of	the incremental	dump in	system format.

FILES

  /etc/dumpdates

RELATED	INFORMATION

  fs(4), dump(8), restore(8)