restore/restore.h

   1 /*
   2  *      Ported to Linux's Second Extended File System as part of the
   3  *      dump and restore backup suit
   4  *      Remy Card <card@Linux.EU.Org>, 1994-1997
   5  *      Stelian Pop <stelian@popies.net>, 1999-2000
   6  *      Stelian Pop <stelian@popies.net> - Alcôve <www.alcove.com>, 2000-2002
   7  *
   8  *      $Id: restore.h,v 1.23 2002/01/16 10:29:26 stelian Exp $
   9  */
  10
  11 /*
  12  * Copyright (c) 1983, 1993
  13  *      The Regents of the University of California.  All rights reserved.
  14  * (c) UNIX System Laboratories, Inc.
  15  * All or some portions of this file are derived from material licensed
  16  * to the University of California by American Telephone and Telegraph
  17  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
  18  * the permission of UNIX System Laboratories, Inc.
  19  *
  20  * Redistribution and use in source and binary forms, with or without
  21  * modification, are permitted provided that the following conditions
  22  * are met:
  23  * 1. Redistributions of source code must retain the above copyright
  24  *    notice, this list of conditions and the following disclaimer.
  25  * 2. Redistributions in binary form must reproduce the above copyright
  26  *    notice, this list of conditions and the following disclaimer in the
  27  *    documentation and/or other materials provided with the distribution.
  28  * 3. All advertising materials mentioning features or use of this software
  29  *    must display the following acknowledgement:
  30  *      This product includes software developed by the University of
  31  *      California, Berkeley and its contributors.
  32  * 4. Neither the name of the University nor the names of its contributors
  33  *    may be used to endorse or promote products derived from this software
  34  *    without specific prior written permission.
  35  *
  36  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  37  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  38  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  39  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  40  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  41  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  42  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  43  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  44  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  45  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46  * SUCH DAMAGE.
  47  */
  48
  49 #include <config.h>
  50 #include <protocols/dumprestore.h>
  51 /*
  52  * Flags
  53  */
  54 extern int      aflag;          /* automatic volume increment */
  55 extern int      cvtflag;        /* convert from old to new tape format */
  56 extern int      bflag;          /* set input block size */
  57 extern int      dflag;          /* print out debugging info */
  58 extern int      hflag;          /* restore heirarchies */
  59 extern int      lflag;          /* assume remote filename is a regular file */
  60 extern int      Lflag;          /* compare errors limit */
  61 extern int      mflag;          /* restore by name instead of inode number */
  62 extern int      Mflag;          /* multi-volume restore */
  63 extern int      Vflag;          /* multi-volume on a single device like CDROM */
  64 extern int      Nflag;          /* do not write the disk */
  65 extern int      uflag;          /* unlink symlink targets */
  66 extern int      vflag;          /* print out actions taken */
  67 extern int      yflag;          /* always try to recover from tape errors */
  68 extern int      zflag;          /* tape is in compressed format */
  69 extern char*    bot_script;     /* beginning of tape script */
  70 /*
  71  * Global variables
  72  */
  73 extern char     *dumpmap;       /* map of inodes on this dump tape */
  74 extern char     *usedinomap;    /* map of inodes that are in use on this fs */
  75 extern dump_ino_t maxino;       /* highest numbered inode in this file system */
  76 extern long     dumpnum;        /* location of the dump on this tape */
  77 extern long     volno;          /* current volume being read */
  78 extern long     ntrec;          /* number of TP_BSIZE records per tape block */
  79 extern time_t   dumptime;       /* time that this dump begins */
  80 extern time_t   dumpdate;       /* time that this dump was made */
  81 extern char     command;        /* opration being performed */
  82 extern FILE     *terminal;      /* file descriptor for the terminal input */
  83 extern int      pipein;         /* input is from a pipe */
  84 extern char     *tmpdir;        /* name of temp directory */
  85 extern int      oldinofmt;      /* reading tape with old format inodes */
  86 extern int      Bcvt;           /* need byte swapping on inodes and dirs */
  87 extern int      compare_ignore_not_found;
  88                                 /* used to compare incremental dumps, */
  89                                 /* so messages about "not found" files */
  90                                 /* isn't seen. */
  91 extern int      compare_errors; /* did we encounter any compare errors? */
  92 extern char     filesys[NAMELEN];/* name of dumped filesystem */
  93
  94 /*
  95  * Each file in the file system is described by one of these entries
  96  */
  97 struct entry {
  98         char    *e_name;                /* the current name of this entry */
  99         u_char  e_namlen;               /* length of this name */
 100         char    e_type;                 /* type of this entry, see below */
 101         short   e_flags;                /* status flags, see below */
 102         dump_ino_t e_ino;               /* inode number in previous file sys */
 103         long    e_index;                /* unique index (for dumpped table) */
 104         struct  entry *e_parent;        /* pointer to parent directory (..) */
 105         struct  entry *e_sibling;       /* next element in this directory (.) */
 106         struct  entry *e_links;         /* hard links to this inode */
 107         struct  entry *e_entries;       /* for directories, their entries */
 108         struct  entry *e_next;          /* hash chain list */
 109 };
 110 /* types */
 111 #define LEAF 1                  /* non-directory entry */
 112 #define NODE 2                  /* directory entry */
 113 #define LINK 4                  /* synthesized type, stripped by addentry */
 114 /* flags */
 115 #define EXTRACT         0x0001  /* entry is to be replaced from the tape */
 116 #define NEW             0x0002  /* a new entry to be extracted */
 117 #define KEEP            0x0004  /* entry is not to change */
 118 #define REMOVED         0x0010  /* entry has been removed */
 119 #define TMPNAME         0x0020  /* entry has been given a temporary name */
 120 #define EXISTED         0x0040  /* directory already existed during extract */
 121
 122 /*
 123  * Constants associated with entry structs
 124  */
 125 #define HARDLINK        1
 126 #define SYMLINK         2
 127 #define TMPHDR          "RSTTMP"
 128
 129 /*
 130  * The entry describes the next file available on the tape
 131  */
 132 struct context {
 133         char    *name;          /* name of file */
 134         dump_ino_t ino;         /* inumber of file */
 135 #ifdef  __linux__
 136         struct  new_bsd_inode *dip;     /* pointer to inode */
 137 #else
 138         struct  dinode *dip;    /* pointer to inode */
 139 #endif
 140         char    action;         /* action being taken on this file */
 141 } curfile;
 142 /* actions */
 143 #define USING   1       /* extracting from the tape */
 144 #define SKIP    2       /* skipping */
 145 #define UNKNOWN 3       /* disposition or starting point is unknown */
 146
 147 /*
 148  * Definitions for library routines operating on directories.
 149  */
 150 typedef struct rstdirdesc RST_DIR;
 151
 152 /*
 153  * Flags to setdirmodes.
 154  */
 155 #define FORCE   0x0001
 156
 157 /*
 158  * Useful macros
 159  */
 160 #define TSTINO(ino, map) \
 161         (map[(u_int)((ino) - 1) / NBBY] &  (1 << ((u_int)((ino) - 1) % NBBY)))
 162 #define SETINO(ino, map) \
 163         map[(u_int)((ino) - 1) / NBBY] |=  1 << ((u_int)((ino) - 1) % NBBY)
 164
 165 #define Dprintf         if (dflag) fprintf
 166 #define Vprintf         if (vflag) fprintf
 167
 168 #define GOOD 1
 169 #define FAIL 0
 170
 171 #ifdef USE_QFA
 172 #define QFA_MAGIC       "495115637697"
 173 #define QFA_VERSION     "1.0"
 174 extern FILE     *gTapeposfp;
 175 extern char     *gTapeposfile;
 176 extern char     gTps[255];
 177 extern long     gSeekstart;
 178 extern int      tapeposflag;
 179 #endif /* USE_QFA */
 180
 181 #define do_compare_error \
 182         if (++compare_errors >= Lflag && Lflag) { \
 183                 printf("Compare errors limit reached, exiting...\n"); \
 184                 exit(2); \
 185         }
 186