2 * Copyright 2000, International Business Machines Corporation and others.
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
13 #ifdef AFS_PTHREAD_ENV
17 #include <afs/voldefs.h>
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 */
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 */
31 /* tflags, representing transaction state */
32 #define TTDeleted 1 /* delete transaction not yet freed due to high refCount */
34 /* other names for volumes in voldefs.h */
38 #define volser_RWREPL 3
40 #define THOLD(tt) ((tt)->refCount++)
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 */
67 /* This is how often the garbage collection thread wakes up and
68 * checks for transactions that have timed out: BKGLoop()
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))
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 */
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.
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;
98 /* the stuff below is from errors.h in vol directory */
99 #define VICE_SPECIAL_ERRORS 101 /* Lowest special error code */
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
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 */
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
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 */
133 afs_uint32 volCloneId;
136 struct partList { /*used by the backup system */
137 afs_int32 partId[VOLMAXPARTS];
138 afs_int32 partFlags[VOLMAXPARTS];
141 #define STDERR stderr
142 #define STDOUT stdout
144 #define ISNAMEVALID(name) (strlen(name) < (VOLSER_OLDMAXVOLNAME - 9))
146 /* values for flags in struct nvldbEntry */
147 #define RW_EXISTS 0x1000
148 #define RO_EXISTS 0x2000
149 #define BACK_EXISTS 0x4000
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
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
165 #define NAMEVALID 0x10
166 #define SIZEVALID 0x20
167 #define ENTRYVALID 0x40
168 #define REUSECLONEID 0x80
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
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,
193 int (*secproc)(struct rx_securityClass *,
195 struct ubik_client **uclientp);
196 #endif /* _VOLSER_ */