home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat5 / dump.z / dump
Encoding:
Text File  |  2001-04-17  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. dddduuuummmmpppp((((5555))))                                                                dddduuuummmmpppp((((5555))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      dump, dumpdates - incremental dump format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<pppprrrroooottttooooccccoooollllssss////dddduuuummmmpppprrrreeeessssttttoooorrrreeee....hhhh>>>>
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      Tapes used by _d_u_m_p and _r_e_s_t_o_r_e(1M) contain:
  17.  
  18.  
  19.           a header record
  20.           two groups of bit map records
  21.           a group of records describing directories
  22.           a group of records describing files
  23.  
  24.      The format of the header record and of the first record of each
  25.      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:
  26.  
  27.           #define TP_BSIZE                1024
  28.           #define NTREC          10
  29.           #define LBLSIZE        16
  30.           #define NAMELEN        64
  31.  
  32.           #define TS_TAPE        1
  33.           #define TS_INODE       2
  34.           #define TS_BITS        3
  35.           #define TS_ADDR        4
  36.           #define TS_END         5
  37.           #define TS_CLRI        6
  38.           #define MAGIC           (int) 60011
  39.           #define CHECKSUM                 (int) 84446
  40.  
  41.           struct spcl {
  42.                   int             c_type;
  43.                   time_t          c_date;
  44.                   time_t          c_ddate;
  45.                   int             c_volume;
  46.                   daddr_t         c_tapea;
  47.                   ino_t           c_inumber;
  48.                   int             c_magic;
  49.                   int             c_checksum;
  50.                   struct bsd_dinode        c_dinode;
  51.                   int             c_count;
  52.                   char            c_addr[TP_BSIZE/2];
  53.                   char            c_label[LBLSIZE];
  54.                   long            c_level;
  55.                   char            c_filesys[NAMELEN];
  56.                   char            c_dev[NAMELEN];
  57.                   long            c_flags;
  58.           } spcl;
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. dddduuuummmmpppp((((5555))))                                                                dddduuuummmmpppp((((5555))))
  71.  
  72.  
  73.  
  74.           struct idates {
  75.                   char            id_name[255];
  76.                   char            id_incno;
  77.                   time_t          id_ddate;
  78.           };
  79.  
  80.           #define DUMPOUTFMT "%-16s %c %s"
  81.           #define DUMPINFMT  "%[^ ] %c %[^\n]\n"
  82.  
  83.  
  84.      TP_BSIZE is the size of file blocks on the dump tapes.  NTREC is the
  85.      default number of 1024 byte records in a physical tape block (blocking
  86.      factor).
  87.  
  88.      The TS_ entries are used in the _c__t_y_p_e field to indicate what sort of
  89.      header this is.  The types and their meanings are as follows:
  90.  
  91.      TS_TAPE      Tape volume label
  92.      TS_INODE     A file or directory follows.  The _c__d_i_n_o_d_e field is a copy
  93.                   of the disk inode and contains bits indicating the type of
  94.                   the file.
  95.      TS_BITS      A bit map follows.  This bit map has a one bit for each
  96.                   inode that was dumped.
  97.      TS_ADDR      A subrecord of a file description.  See _c__a_d_d_r below.
  98.      TS_END       End of tape record.
  99.      TS_CLRI      A bit map follows.  This bit map contains a zero bit for all
  100.                   inodes that were empty on the filesystem when dumped.
  101.      MAGIC        All header records have this number in _c__m_a_g_i_c.
  102.      CHECKSUM     Header records checksum to this value.
  103.  
  104.      The fields of the header structure are as follows:
  105.  
  106.      c_type       The type of the header.
  107.      c_date       The date the dump was taken.
  108.      c_ddate      The date the filesystem was dumped from.
  109.      c_volume     The current volume number of the dump.
  110.      c_tapea      The current number of this (1024-byte) record.
  111.      c_inumber    The number of the inode being dumped if this is of type
  112.                   TS_INODE.
  113.      c_magic      This contains the value MAGIC above, truncated as needed.
  114.      c_checksum   This contains whatever value is needed to make the record
  115.                   sum to CHECKSUM.
  116.      c_dinode     This is a copy of the inode as it appears on the filesystem.
  117.                   Extent File System (see _f_s(4)) disk inodes differ from the
  118.                   Berkeley Fast File System inode format.  Dump converts EFS
  119.                   disk inodes to Berkeley's format, before dumping them on
  120.                   tape.
  121.      c_count      The count of characters in _c__a_d_d_r.
  122.      c_addr       An array of characters describing the blocks of the dumped
  123.                   file.  A character is zero if the block associated with that
  124.                   character was not present on the filesystem, otherwise the
  125.                   character is non-zero.  If the block was not present on the
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. dddduuuummmmpppp((((5555))))                                                                dddduuuummmmpppp((((5555))))
  137.  
  138.  
  139.  
  140.                   filesystem, no block was dumped; the block will be restored
  141.                   as a hole in the file.  If there is not sufficient space in
  142.                   this record to describe all of the blocks in a file, TS_ADDR
  143.                   records will be scattered through the file, each one picking
  144.                   up where the last left off.
  145.      c_label      Dump label.
  146.      c_level      Level of this dump.  See _d_u_m_p(1M).
  147.      c_filesys    Name of the dumped filesystem.
  148.      c_dev        Name of the dump device.
  149.      c_host       Name of the dumped host.
  150.      c_flags      Additional information.
  151.  
  152.      Each volume except the last ends with a tapemark (read as an end of
  153.      file).  The last volume ends with a TS_END record and then the tapemark.
  154.  
  155.      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
  156.      dump history is kept.  The fields of the structure are:
  157.  
  158.      id_name  The dumped filesystem is `/dev/_i_d__n_a_m'.
  159.      id_incno The level number of the dump tape; see _d_u_m_p(1M).
  160.      id_ddate The date of the incremental dump in system format see _t_y_p_e_s(5).
  161.  
  162. FFFFIIIILLLLEEEESSSS
  163.      /etc/dumpdates
  164.  
  165. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  166.      dump(1M), restore(1M), fs(4), types(5)
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.