src/volser/volser.p.h

   1 /*
   2  * Copyright 2000, International Business Machines Corporation and others.
   3  * All Rights Reserved.
   4  *
   5  * This software has been released under the terms of the IBM Public
   6  * License.  For details, see the LICENSE file in the top-level source
   7  * directory or online at http://www.openafs.org/dl/license10.html
   8  */
   9
  10 #ifndef _VOLSER_
  11 #define _VOLSER_ 1
  12
  13 #ifdef AFS_PTHREAD_ENV
  14 #include <pthread.h>
  15 #endif
  16
  17 #include <afs/voldefs.h>
  18
  19 /* vflags, representing state of the volume */
  20 #define VTDeleteOnSalvage       1       /* delete on next salvage */
  21 #define VTOutOfService          2       /* never put this volume online */
  22 #define VTDeleted               4       /* deleted, don't do anything else */
  23
  24 /* iflags, representing "attach mode" for this volume at the start of this transaction */
  25 #define ITOffline       1       /* volume offline on server (returns VOFFLINE) */
  26 #define ITBusy          2       /* volume busy on server (returns VBUSY) */
  27 #define ITReadOnly      8       /* volume readonly on client, readwrite on server -DO NOT USE */
  28 #define ITCreate        0x10    /* volume does not exist correctly yet */
  29 #define ITCreateVolID   0x1000  /* create volid */
  30
  31 /* tflags, representing transaction state */
  32 #define TTDeleted       1       /* delete transaction not yet freed due  to high refCount */
  33
  34 /* other names for volumes in voldefs.h */
  35 #define volser_RW       0
  36 #define volser_RO       1
  37 #define volser_BACK     2
  38 #define volser_RWREPL   3
  39
  40 #define THOLD(tt)       ((tt)->refCount++)
  41
  42 struct volser_trans {
  43     struct volser_trans *next;  /* next ptr in active trans list */
  44     afs_int32 tid;              /* transaction id */
  45     afs_int32 time;             /* time transaction was last active (for timeouts) */
  46     afs_int32 creationTime;     /* time the transaction started */
  47     afs_int32 returnCode;       /* transaction error code */
  48     struct Volume *volume;      /* pointer to open volume */
  49     VolumeId volid;             /* open volume's id */
  50     afs_int32 partition;        /* open volume's partition */
  51     afs_int32 dumpTransId;      /* other side's trans id during a dump */
  52     afs_int32 dumpSeq;          /* next sequence number to use during a dump */
  53     short refCount;             /* reference count on this structure */
  54     short iflags;               /* initial attach mode flags (IT*) */
  55     char vflags;                /* current volume status flags (VT*) */
  56     char tflags;                /* transaction flags (TT*) */
  57     char incremental;           /* do an incremental restore */
  58     /* the fields below are useful for debugging */
  59     char lastProcName[30];      /* name of the last procedure which used transaction */
  60     struct rx_call *rxCallPtr;  /* pointer to latest associated rx_call */
  61 #ifdef AFS_PTHREAD_ENV
  62     pthread_mutex_t lock;       /* per transaction lock */
  63 #endif
  64
  65 };
  66
  67 /* This is how often the garbage collection thread wakes up and
  68  * checks for transactions that have timed out: BKGLoop()
  69  */
  70 #define GCWAKEUP            30
  71
  72 #ifdef AFS_PTHREAD_ENV
  73 #define VTRANS_OBJ_LOCK_INIT(tt) \
  74   opr_mutex_init(&((tt)->lock));
  75 #define VTRANS_OBJ_LOCK_DESTROY(tt) \
  76   opr_mutex_destroy(&((tt)->lock))
  77 #define VTRANS_OBJ_LOCK(tt) \
  78   opr_mutex_enter(&((tt)->lock))
  79 #define VTRANS_OBJ_UNLOCK(tt) \
  80   opr_mutex_exit(&((tt)->lock))
  81 #else
  82 #define VTRANS_OBJ_LOCK_INIT(tt)
  83 #define VTRANS_OBJ_LOCK_DESTROY(tt)
  84 #define VTRANS_OBJ_LOCK(tt)
  85 #define VTRANS_OBJ_UNLOCK(tt)
  86 #endif /* AFS_PTHREAD_ENV */
  87
  88 #define MAXHELPERS          10
  89 /* flags for vol helper busyFlags array.  First, VHIdle goes on when a server
  90  * becomes idle.  Next, idle flag is cleared and VHRequest goes on when
  91  * trans is queued.  Finally, VHRequest goes off (but VHIdle stays off) when
  92  * helper is done.  VHIdle goes on again when an lwp waits for work.
  93  */
  94 #define VHIdle              1   /* vol helper is waiting for a request here */
  95 #define VHRequest           2   /* a request has been queued here */
  96 extern struct volser_trans *QI_GlobalWriteTrans;
  97
  98 /* the stuff below is from errors.h in vol directory */
  99 #define VICE_SPECIAL_ERRORS     101     /* Lowest special error code */
 100
 101 #define VSALVAGE        101     /* Volume needs salvage */
 102 #define VNOVNODE        102     /* Bad vnode number quoted */
 103 #define VNOVOL          103     /* Volume not attached, doesn't exist,
 104                                  * not created or not online */
 105 #define VVOLEXISTS      104     /* Volume already exists */
 106 #define VNOSERVICE      105     /* Volume is not in service (i.e. it's
 107                                  * is out of funds, is obsolete, or somesuch) */
 108 #define VOFFLINE        106     /* Volume is off line, for the reason
 109                                  * given in the offline message */
 110 #define VONLINE         107     /* Volume is already on line */
 111 #define VDISKFULL       108     /* Partition is "full", i.e. rougly within
 112                                  * n% of full */
 113 #define VOVERQUOTA      109     /* Volume max quota exceeded */
 114 #define VBUSY           110     /* Volume temporarily unavailable; try again.
 115                                  * The volume should be available again shortly; if
 116                                  * it isn't something is wrong.  Not normally to be
 117                                  * propagated to the application level */
 118 #define VMOVED          111     /* Volume has moved to another server; do a VGetVolumeInfo
 119                                  * to THIS server to find out where */
 120
 121 #define VLDB_MAXSERVERS 10
 122 #define VOLSERVICE_ID 4
 123 #define INVALID_BID 0
 124 #define VOLSER_MAXVOLNAME 65
 125 #define VOLSER_OLDMAXVOLNAME 32
 126
 127 /*flags used for interfacing with the  backup system */
 128 struct volDescription {         /*used for interfacing with the backup system */
 129     char volName[VOLSER_MAXVOLNAME];    /* should be VNAMESIZE as defined in volume.h */
 130     afs_uint32 volId;
 131     int volSize;
 132     afs_int32 volFlags;
 133     afs_uint32 volCloneId;
 134 };
 135
 136 struct partList {               /*used by the backup system */
 137     afs_int32 partId[VOLMAXPARTS];
 138     afs_int32 partFlags[VOLMAXPARTS];
 139 };
 140
 141 #define STDERR  stderr
 142 #define STDOUT  stdout
 143
 144 #define ISNAMEVALID(name) (strlen(name) < (VOLSER_OLDMAXVOLNAME - 9))
 145
 146 /* values for flags in struct nvldbEntry */
 147 #define RW_EXISTS 0x1000
 148 #define RO_EXISTS 0x2000
 149 #define BACK_EXISTS 0x4000
 150
 151 /* values for serverFlags in struct nvldbEntry */
 152 #define NEW_REPSITE 0x01
 153 #define ITSROVOL    0x02
 154 #define ITSRWVOL    0x04
 155 #define ITSBACKVOL  0x08
 156 #define ITSRWREPL   0x10
 157 #define RO_DONTUSE  0x20
 158
 159 #define VLOP_RESTORE 0x100      /*this is bogus, clashes with VLOP_DUMP */
 160 #define VLOP_ADDSITE 0x80       /*this is bogus, clashes with VLOP_DELETE */
 161 #define PARTVALID 0x01
 162 #define CLONEVALID 0x02
 163 #define CLONEZAPPED 0x04
 164 #define IDVALID 0x08
 165 #define NAMEVALID 0x10
 166 #define SIZEVALID 0x20
 167 #define ENTRYVALID 0x40
 168 #define REUSECLONEID 0x80
 169 #define VOK 0x02
 170
 171 /* Values for the UV_RestoreVolume flags parameter */
 172 /* Also used for UV_CopyVolume and UV_CloneVolume */
 173 #define RV_FULLRST      0x000001
 174 #define RV_OFFLINE      0x000002
 175 #define RV_CRDUMP       0x000010
 176 #define RV_CRKEEP       0x000020
 177 #define RV_CRNEW        0x000040
 178 #define RV_LUDUMP       0x000100
 179 #define RV_LUKEEP       0x000200
 180 #define RV_LUNEW        0x000400
 181 #define RV_RDONLY       0x010000
 182 #define RV_CPINCR       0x020000
 183 #define RV_NOVLDB       0x040000
 184 #define RV_NOCLONE      0x080000
 185 #define RV_NODEL        0x100000
 186 #define RV_RWONLY       0x200000
 187
 188 struct ubik_client;
 189 extern afs_uint32 vsu_GetVolumeID(char *astring, struct ubik_client *acstruct, afs_int32 *errp);
 190 extern int vsu_ExtractName(char rname[], char name[]);
 191 extern afs_int32 vsu_ClientInit(const char *confDir, char *cellName,
 192                                 int secFlags,
 193                                 int (*secproc)(struct rx_securityClass *,
 194                                                afs_int32),
 195                                 struct ubik_client **uclientp);
 196 #endif /* _VOLSER_ */