vos-timestamp-handling-20041106
[openafs.git] / src / volser / volprocs.c
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 #include <afsconfig.h>
11 #include <afs/param.h>
12
13 RCSID
14     ("$Header$");
15
16 #include <stdio.h>
17 #include <sys/types.h>
18 #include <errno.h>
19 #ifdef AFS_NT40_ENV
20 #include <fcntl.h>
21 #include <winsock2.h>
22 #else
23 #include <sys/file.h>
24 #include <netinet/in.h>
25 #include <unistd.h>
26 #endif
27
28 #ifdef HAVE_STRING_H
29 #include <string.h>
30 #else
31 #ifdef HAVE_STRINGS_H
32 #include <strings.h>
33 #endif
34 #endif
35
36 #include <dirent.h>
37 #include <sys/stat.h>
38 #include <rx/xdr.h>
39 #include <rx/rx.h>
40 #include <rx/rxkad.h>
41 #include <afs/afsint.h>
42 #include <signal.h>
43 #ifdef AFS_PTHREAD_ENV
44 #include <assert.h>
45 #else /* AFS_PTHREAD_ENV */
46 #include <afs/assert.h>
47 #endif /* AFS_PTHREAD_ENV */
48 #include <afs/prs_fs.h>
49 #include <afs/nfs.h>
50 #include <lwp.h>
51 #include <lock.h>
52 #include <afs/auth.h>
53 #include <afs/cellconfig.h>
54 #include <afs/keys.h>
55 #include <ubik.h>
56 #include <afs/ihandle.h>
57 #ifdef AFS_NT40_ENV
58 #include <afs/ntops.h>
59 #endif
60 #include <afs/vnode.h>
61 #include <afs/volume.h>
62 #include <afs/partition.h>
63 #include "vol.h"
64 #include <afs/fssync.h>
65 #include <afs/acl.h>
66 #include "afs/audit.h"
67 #include <afs/dir.h>
68
69 #include "volser.h"
70 #include "volint.h"
71
72 #include "volser_prototypes.h"
73
74 extern int DoLogging;
75 extern struct volser_trans *FindTrans(), *NewTrans(), *TransList();
76 extern struct afsconf_dir *tdir;
77
78 /* Needed by Irix. Leave, or include a header */
79 extern char *volutil_PartitionName();
80
81 extern void LogError(afs_int32 errcode);
82
83 /* Forward declarations */
84 static int GetPartName(afs_int32 partid, char *pname);
85
86 #define OneDay (24*60*60)
87
88 #ifdef AFS_NT40_ENV
89 #define ENOTCONN 134
90 #endif
91
92 afs_int32 localTid = 1;
93 afs_int32 VolPartitionInfo(), VolNukeVolume(), VolCreateVolume(),
94 VolDeleteVolume(), VolClone();
95 afs_int32 VolReClone(), VolTransCreate(), VolGetNthVolume(), VolGetFlags(),
96 VolForward(), VolDump();
97 afs_int32 VolRestore(), VolEndTrans(), VolSetForwarding(), VolGetStatus(),
98 VolSetInfo(), VolGetName();
99 afs_int32 VolListPartitions(), VolListOneVolume(),
100 VolXListOneVolume(), VolXListVolumes();
101 afs_int32 VolListVolumes(), XVolListPartitions(), VolMonitor(),
102 VolSetIdsTypes(), VolSetDate(), VolSetFlags();
103
104 /* this call unlocks all of the partition locks we've set */
105 int 
106 VPFullUnlock()
107 {
108     register struct DiskPartition *tp;
109     for (tp = DiskPartitionList; tp; tp = tp->next) {
110         if (tp->lock_fd != -1) {
111             close(tp->lock_fd); /* releases flock held on this partition */
112             tp->lock_fd = -1;
113         }
114     }
115     return 0;
116 }
117
118 /* get partition id from a name */
119 afs_int32
120 PartitionID(char *aname)
121 {
122     register char tc;
123     register int code = 0;
124     char ascii[3];
125
126     tc = *aname;
127     if (tc == 0)
128         return -1;              /* unknown */
129
130     /* otherwise check for vicepa or /vicepa, or just plain "a" */
131     ascii[2] = 0;
132     if (!strncmp(aname, "/vicep", 6)) {
133         strncpy(ascii, aname + 6, 2);
134     } else
135         return -1;              /* bad partition name */
136     /* now partitions are named /vicepa ... /vicepz, /vicepaa, /vicepab, .../vicepzz, and are numbered
137      * from 0.  Do the appropriate conversion */
138     if (ascii[1] == 0) {
139         /* one char name, 0..25 */
140         if (ascii[0] < 'a' || ascii[0] > 'z')
141             return -1;          /* wrongo */
142         return ascii[0] - 'a';
143     } else {
144         /* two char name, 26 .. <whatever> */
145         if (ascii[0] < 'a' || ascii[0] > 'z')
146             return -1;          /* wrongo */
147         if (ascii[1] < 'a' || ascii[1] > 'z')
148             return -1;          /* just as bad */
149         code = (ascii[0] - 'a') * 26 + (ascii[1] - 'a') + 26;
150         if (code > VOLMAXPARTS)
151             return -1;
152         return code;
153     }
154 }
155
156 static int
157 ConvertVolume(afs_int32 avol, char *aname, afs_int32 asize)
158 {
159     if (asize < 18)
160         return -1;
161     /* It's better using the Generic VFORMAT since otherwise we have to make changes to too many places... The 14 char limitation in names hits us again in AIX; print in field of 9 digits (still 10 for the rest), right justified with 0 padding */
162     (void)afs_snprintf(aname, asize, VFORMAT, (unsigned long)avol);
163     return 0;
164 }
165
166 static int
167 ConvertPartition(int apartno, char *aname, int asize)
168 {
169     if (asize < 10)
170         return E2BIG;
171     if (apartno < 0)
172         return EINVAL;
173     strcpy(aname, "/vicep");
174     if (apartno < 26) {
175         aname[6] = 'a' + apartno;
176         aname[7] = 0;
177     } else {
178         apartno -= 26;
179         aname[6] = 'a' + (apartno / 26);
180         aname[7] = 'a' + (apartno % 26);
181         aname[8] = 0;
182     }
183     return 0;
184 }
185
186 /* the only attach function that takes a partition is "...ByName", so we use it */
187 struct Volume *
188 XAttachVolume(afs_int32 *error, afs_int32 avolid, afs_int32 apartid, int amode)
189 {
190     char pbuf[30], vbuf[20];
191     register struct Volume *tv;
192
193     if (ConvertPartition(apartid, pbuf, sizeof(pbuf))) {
194         *error = EINVAL;
195         return NULL;
196     }
197     if (ConvertVolume(avolid, vbuf, sizeof(vbuf))) {
198         *error = EINVAL;
199         return NULL;
200     }
201     tv = VAttachVolumeByName(error, pbuf, vbuf, amode);
202     return tv;
203 }
204
205 /* Adapted from the file server; create a root directory for this volume */
206 static int
207 ViceCreateRoot(Volume *vp)
208 {
209     DirHandle dir;
210     struct acl_accessList *ACL;
211     ViceFid did;
212     Inode inodeNumber, nearInode;
213     char buf[SIZEOF_LARGEDISKVNODE];
214     struct VnodeDiskObject *vnode = (struct VnodeDiskObject *)buf;
215     struct VnodeClassInfo *vcp = &VnodeClassInfo[vLarge];
216     IHandle_t *h;
217     FdHandle_t *fdP;
218     int code;
219     afs_fsize_t length;
220
221     memset(vnode, 0, SIZEOF_LARGEDISKVNODE);
222
223     V_pref(vp, nearInode);
224     inodeNumber =
225         IH_CREATE(V_linkHandle(vp), V_device(vp),
226                   VPartitionPath(V_partition(vp)), nearInode, V_parentId(vp),
227                   1, 1, 0);
228     assert(VALID_INO(inodeNumber));
229
230     SetSalvageDirHandle(&dir, V_parentId(vp), vp->device, inodeNumber);
231     did.Volume = V_id(vp);
232     did.Vnode = (VnodeId) 1;
233     did.Unique = 1;
234
235     assert(!(MakeDir(&dir, &did, &did)));
236     DFlush();                   /* flush all modified dir buffers out */
237     DZap(&dir);                 /* Remove all buffers for this dir */
238     length = Length(&dir);      /* Remember size of this directory */
239
240     FidZap(&dir);               /* Done with the dir handle obtained via SetSalvageDirHandle() */
241
242     /* build a single entry ACL that gives all rights to system:administrators */
243     /* this section of code assumes that access list format is not going to
244      * change
245      */
246     ACL = VVnodeDiskACL(vnode);
247     ACL->size = sizeof(struct acl_accessList);
248     ACL->version = ACL_ACLVERSION;
249     ACL->total = 1;
250     ACL->positive = 1;
251     ACL->negative = 0;
252     ACL->entries[0].id = -204;  /* this assumes System:administrators is group -204 */
253     ACL->entries[0].rights =
254         PRSFS_READ | PRSFS_WRITE | PRSFS_INSERT | PRSFS_LOOKUP | PRSFS_DELETE
255         | PRSFS_LOCK | PRSFS_ADMINISTER;
256
257     vnode->type = vDirectory;
258     vnode->cloned = 0;
259     vnode->modeBits = 0777;
260     vnode->linkCount = 2;
261     VNDISK_SET_LEN(vnode, length);
262     vnode->uniquifier = 1;
263     V_uniquifier(vp) = vnode->uniquifier + 1;
264     vnode->dataVersion = 1;
265     VNDISK_SET_INO(vnode, inodeNumber);
266     vnode->unixModifyTime = vnode->serverModifyTime = V_creationDate(vp);
267     vnode->author = 0;
268     vnode->owner = 0;
269     vnode->parent = 0;
270     vnode->vnodeMagic = vcp->magic;
271
272     IH_INIT(h, vp->device, V_parentId(vp),
273             vp->vnodeIndex[vLarge].handle->ih_ino);
274     fdP = IH_OPEN(h);
275     assert(fdP != NULL);
276     code = FDH_SEEK(fdP, vnodeIndexOffset(vcp, 1), SEEK_SET);
277     assert(code >= 0);
278     code = FDH_WRITE(fdP, vnode, SIZEOF_LARGEDISKVNODE);
279     assert(code == SIZEOF_LARGEDISKVNODE);
280     FDH_REALLYCLOSE(fdP);
281     IH_RELEASE(h);
282     VNDISK_GET_LEN(length, vnode);
283     V_diskused(vp) = nBlocks(length);
284
285     return 1;
286 }
287
288 afs_int32
289 SAFSVolPartitionInfo(struct rx_call *acid, char *pname, struct diskPartition 
290                      *partition)
291 {
292     afs_int32 code;
293
294     code = VolPartitionInfo(acid, pname, partition);
295     osi_auditU(acid, VS_ParInfEvent, code, AUD_STR, pname, AUD_END);
296     return code;
297 }
298
299 afs_int32
300 VolPartitionInfo(struct rx_call *acid, char *pname, struct diskPartition 
301                  *partition)
302 {
303     register struct DiskPartition *dp;
304
305 /*
306     if (!afsconf_SuperUser(tdir, acid, caller)) return VOLSERBAD_ACCESS;
307 */
308     VResetDiskUsage();
309     dp = VGetPartition(pname, 0);
310     if (dp) {
311         strncpy(partition->name, dp->name, 32);
312         strncpy(partition->devName, dp->devName, 32);
313         partition->lock_fd = dp->lock_fd;
314         partition->free = dp->free;
315         partition->minFree = dp->totalUsable;
316         return 0;
317     } else
318         return VOLSERILLEGAL_PARTITION;
319 }
320
321 /* obliterate a volume completely, and slowly. */
322 afs_int32
323 SAFSVolNukeVolume(struct rx_call *acid, afs_int32 apartID, afs_int32 avolID)
324 {
325     afs_int32 code;
326
327     code = VolNukeVolume(acid, apartID, avolID);
328     osi_auditU(acid, VS_NukVolEvent, code, AUD_LONG, avolID, AUD_END);
329     return code;
330 }
331
332 afs_int32
333 VolNukeVolume(struct rx_call *acid, afs_int32 apartID, afs_int32 avolID)
334 {
335     register char *tp;
336     char partName[50];
337     afs_int32 error;
338     register afs_int32 code;
339     struct Volume *tvp;
340     char caller[MAXKTCNAMELEN];
341
342     /* check for access */
343     if (!afsconf_SuperUser(tdir, acid, caller))
344         return VOLSERBAD_ACCESS;
345     if (DoLogging)
346         Log("%s is executing VolNukeVolume %u\n", caller, avolID);
347
348     tp = volutil_PartitionName(apartID);
349     if (!tp)
350         return VOLSERNOVOL;
351     strcpy(partName, tp);       /* remember it for later */
352     /* we first try to attach the volume in update mode, so that the file
353      * server doesn't try to use it (and abort) while (or after) we delete it.
354      * If we don't get the volume, that's fine, too.  We just won't put it back.
355      */
356     tvp = XAttachVolume(&error, avolID, apartID, V_VOLUPD);
357     code = nuke(partName, avolID);
358     if (tvp)
359         VDetachVolume(&error, tvp);
360     return code;
361 }
362
363 /* create a new volume, with name aname, on the specified partition (1..n)
364  * and of type atype (readwriteVolume, readonlyVolume, backupVolume).
365  * As input, if *avolid is 0, we allocate a new volume id, otherwise we use *avolid
366  * for the volume id (useful for things like volume restore).
367  * Return the new volume id in *avolid.
368  */
369 afs_int32
370 SAFSVolCreateVolume(struct rx_call *acid, afs_int32 apart, char *aname, 
371                     afs_int32 atype, afs_int32 aparent, afs_int32 *avolid, 
372                     afs_int32 *atrans)
373 {
374     afs_int32 code;
375
376     code =
377         VolCreateVolume(acid, apart, aname, atype, aparent, avolid, atrans);
378     osi_auditU(acid, VS_CrVolEvent, code, AUD_LONG, *atrans, AUD_LONG,
379                *avolid, AUD_STR, aname, AUD_LONG, atype, AUD_LONG, aparent,
380                AUD_END);
381     return code;
382 }
383
384 afs_int32
385 VolCreateVolume(struct rx_call *acid, afs_int32 apart, char *aname, 
386                     afs_int32 atype, afs_int32 aparent, afs_int32 *avolid, 
387                     afs_int32 *atrans)
388 {
389     afs_int32 error;
390     register Volume *vp;
391     afs_int32 junk;             /* discardable error code */
392     register afs_int32 volumeID, doCreateRoot = 1;
393     register struct volser_trans *tt;
394     char ppath[30];
395     char caller[MAXKTCNAMELEN];
396
397     if (strlen(aname) > 31)
398         return VOLSERBADNAME;
399     if (!afsconf_SuperUser(tdir, acid, caller))
400         return VOLSERBAD_ACCESS;
401     if (DoLogging)
402         Log("%s is executing CreateVolume '%s'\n", caller, aname);
403     if ((error = ConvertPartition(apart, ppath, sizeof(ppath))))
404         return error;           /*a standard unix error */
405     if (atype != readwriteVolume && atype != readonlyVolume
406         && atype != backupVolume)
407         return EINVAL;
408     if ((volumeID = *avolid) == 0) {
409
410         Log("1 Volser: CreateVolume: missing volume number; %s volume not created\n", aname);
411         return E2BIG;
412
413     }
414     if ((aparent == volumeID) && (atype == readwriteVolume)) {
415         doCreateRoot = 0;
416     }
417     if (aparent == 0)
418         aparent = volumeID;
419     tt = NewTrans(volumeID, apart);
420     if (!tt) {
421         Log("1 createvolume: failed to create trans\n");
422         return VOLSERVOLBUSY;   /* volume already busy! */
423     }
424     vp = VCreateVolume(&error, ppath, volumeID, aparent);
425     if (error) {
426         Log("1 Volser: CreateVolume: Unable to create the volume; aborted, error code %u\n", error);
427         LogError(error);
428         DeleteTrans(tt, 1);
429         return EIO;
430     }
431     V_uniquifier(vp) = 1;
432     V_creationDate(vp) = V_copyDate(vp);
433     V_inService(vp) = V_blessed(vp) = 1;
434     V_type(vp) = atype;
435     AssignVolumeName(&V_disk(vp), aname, 0);
436     if (doCreateRoot)
437         ViceCreateRoot(vp);
438     V_destroyMe(vp) = DESTROY_ME;
439     V_inService(vp) = 0;
440     V_maxquota(vp) = 5000;      /* set a quota of 5000 at init time */
441     VUpdateVolume(&error, vp);
442     if (error) {
443         Log("1 Volser: create UpdateVolume failed, code %d\n", error);
444         LogError(error);
445         DeleteTrans(tt, 1);
446         VDetachVolume(&junk, vp);       /* rather return the real error code */
447         return error;
448     }
449     tt->volume = vp;
450     *atrans = tt->tid;
451     strcpy(tt->lastProcName, "CreateVolume");
452     tt->rxCallPtr = acid;
453     Log("1 Volser: CreateVolume: volume %u (%s) created\n", volumeID, aname);
454     tt->rxCallPtr = (struct rx_call *)0;
455     if (TRELE(tt))
456         return VOLSERTRELE_ERROR;
457     return 0;
458 }
459
460 /* delete the volume associated with this transaction */
461 afs_int32
462 SAFSVolDeleteVolume(struct rx_call *acid, afs_int32 atrans)
463 {
464     afs_int32 code;
465
466     code = VolDeleteVolume(acid, atrans);
467     osi_auditU(acid, VS_DelVolEvent, code, AUD_LONG, atrans, AUD_END);
468     return code;
469 }
470
471 afs_int32
472 VolDeleteVolume(struct rx_call *acid, afs_int32 atrans)
473 {
474     register struct volser_trans *tt;
475     afs_int32 error;
476     char caller[MAXKTCNAMELEN];
477
478     if (!afsconf_SuperUser(tdir, acid, caller))
479         return VOLSERBAD_ACCESS;
480     tt = FindTrans(atrans);
481     if (!tt)
482         return ENOENT;
483     if (tt->vflags & VTDeleted) {
484         Log("1 Volser: Delete: volume %u already deleted \n", tt->volid);
485         TRELE(tt);
486         return ENOENT;
487     }
488     if (DoLogging)
489         Log("%s is executing Delete Volume %u\n", caller, tt->volid);
490     strcpy(tt->lastProcName, "DeleteVolume");
491     tt->rxCallPtr = acid;
492     VPurgeVolume(&error, tt->volume);   /* don't check error code, it is not set! */
493     tt->vflags |= VTDeleted;    /* so we know not to do anything else to it */
494     tt->rxCallPtr = (struct rx_call *)0;
495     if (TRELE(tt))
496         return VOLSERTRELE_ERROR;
497
498     Log("1 Volser: Delete: volume %u deleted \n", tt->volid);
499     return 0;                   /* vpurgevolume doesn't set an error code */
500 }
501
502 /* make a clone of the volume associated with atrans, possibly giving it a new
503  * number (allocate a new number if *newNumber==0, otherwise use *newNumber
504  * for the clone's id).  The new clone is given the name newName.  Finally, due to
505  * efficiency considerations, if purgeId is non-zero, we purge that volume when doing
506  * the clone operation.  This may be useful when making new backup volumes, for instance
507  * since the net result of a clone and a purge generally leaves many inode ref counts
508  * the same, while doing them separately would result in far more iincs and idecs being
509  * peformed (and they are slow operations).
510  */
511 /* for efficiency reasons, sometimes faster to piggyback a purge here */
512 afs_int32
513 SAFSVolClone(struct rx_call *acid, afs_int32 atrans, afs_int32 purgeId, 
514              afs_int32 newType, char *newName, afs_int32 *newNumber)
515 {
516     afs_int32 code;
517
518     code = VolClone(acid, atrans, purgeId, newType, newName, newNumber);
519     osi_auditU(acid, VS_CloneEvent, code, AUD_LONG, atrans, AUD_LONG, purgeId,
520                AUD_STR, newName, AUD_LONG, newType, AUD_LONG, *newNumber,
521                AUD_END);
522     return code;
523 }
524
525 afs_int32
526 VolClone(struct rx_call *acid, afs_int32 atrans, afs_int32 purgeId, 
527              afs_int32 newType, char *newName, afs_int32 *newNumber)
528 {
529     VolumeId newId;
530     register struct Volume *originalvp, *purgevp, *newvp;
531     Error error, code;
532     register struct volser_trans *tt, *ttc;
533     char caller[MAXKTCNAMELEN];
534
535     if (strlen(newName) > 31)
536         return VOLSERBADNAME;
537     if (!afsconf_SuperUser(tdir, acid, caller))
538         return VOLSERBAD_ACCESS;        /*not a super user */
539     if (DoLogging)
540         Log("%s is executing Clone Volume new name=%s\n", caller, newName);
541     error = 0;
542     originalvp = (Volume *) 0;
543     purgevp = (Volume *) 0;
544     newvp = (Volume *) 0;
545     tt = ttc = (struct volser_trans *)0;
546
547     if (!newNumber || !*newNumber) {
548         Log("1 Volser: Clone: missing volume number for the clone; aborted\n");
549         goto fail;
550     }
551     newId = *newNumber;
552
553     if (newType != readonlyVolume && newType != backupVolume)
554         return EINVAL;
555     tt = FindTrans(atrans);
556     if (!tt)
557         return ENOENT;
558     if (tt->vflags & VTDeleted) {
559         Log("1 Volser: Clone: volume %u has been deleted \n", tt->volid);
560         TRELE(tt);
561         return ENOENT;
562     }
563     ttc = NewTrans(newId, tt->partition);
564     if (!ttc) {                 /* someone is messing with the clone already */
565         TRELE(tt);
566         return VBUSY;
567     }
568     strcpy(tt->lastProcName, "Clone");
569     tt->rxCallPtr = acid;
570
571
572     if (purgeId) {
573         purgevp = VAttachVolume(&error, purgeId, V_VOLUPD);
574         if (error) {
575             Log("1 Volser: Clone: Could not attach 'purge' volume %u; clone aborted\n", purgeId);
576             goto fail;
577         }
578     } else {
579         purgevp = NULL;
580     }
581     originalvp = tt->volume;
582     if ((V_type(originalvp) == backupVolume)
583         || (V_type(originalvp) == readonlyVolume)) {
584         Log("1 Volser: Clone: The volume to be cloned must be a read/write; aborted\n");
585         error = EROFS;
586         goto fail;
587     }
588     if ((V_destroyMe(originalvp) == DESTROY_ME) || !V_inService(originalvp)) {
589         Log("1 Volser: Clone: Volume %d is offline and cannot be cloned\n",
590             V_id(originalvp));
591         error = VOFFLINE;
592         goto fail;
593     }
594     if (purgevp) {
595         if (originalvp->device != purgevp->device) {
596             Log("1 Volser: Clone: Volumes %u and %u are on different devices\n", tt->volid, purgeId);
597             error = EXDEV;
598             goto fail;
599         }
600         if (V_type(purgevp) != readonlyVolume) {
601             Log("1 Volser: Clone: The \"purge\" volume must be a read only volume; aborted\n");
602             error = EINVAL;
603             goto fail;
604         }
605         if (V_type(originalvp) == readonlyVolume
606             && V_parentId(originalvp) != V_parentId(purgevp)) {
607             Log("1 Volser: Clone: Volume %u and volume %u were not cloned from the same parent volume; aborted\n", tt->volid, purgeId);
608             error = EXDEV;
609             goto fail;
610         }
611         if (V_type(originalvp) == readwriteVolume
612             && tt->volid != V_parentId(purgevp)) {
613             Log("1 Volser: Clone: Volume %u was not originally cloned from volume %u; aborted\n", purgeId, tt->volid);
614             error = EXDEV;
615             goto fail;
616         }
617     }
618
619     error = 0;
620
621     newvp =
622         VCreateVolume(&error, originalvp->partition->name, newId,
623                       V_parentId(originalvp));
624     if (error) {
625         Log("1 Volser: Clone: Couldn't create new volume; clone aborted\n");
626         newvp = (Volume *) 0;
627         goto fail;
628     }
629     if (newType == readonlyVolume)
630         V_cloneId(originalvp) = newId;
631     Log("1 Volser: Clone: Cloning volume %u to new volume %u\n", tt->volid,
632         newId);
633     if (purgevp)
634         Log("1 Volser: Clone: Purging old read only volume %u\n", purgeId);
635     CloneVolume(&error, originalvp, newvp, purgevp);
636     purgevp = NULL;             /* clone releases it, maybe even if error */
637     if (error) {
638         Log("1 Volser: Clone: clone operation failed with code %u\n", error);
639         LogError(error);
640         goto fail;
641     }
642     if (newType == readonlyVolume) {
643         AssignVolumeName(&V_disk(newvp), V_name(originalvp), ".readonly");
644         V_type(newvp) = readonlyVolume;
645     } else if (newType == backupVolume) {
646         AssignVolumeName(&V_disk(newvp), V_name(originalvp), ".backup");
647         V_type(newvp) = backupVolume;
648         V_backupId(originalvp) = newId;
649     }
650     strcpy(newvp->header->diskstuff.name, newName);
651     V_creationDate(newvp) = V_copyDate(newvp);
652     ClearVolumeStats(&V_disk(newvp));
653     V_destroyMe(newvp) = DESTROY_ME;
654     V_inService(newvp) = 0;
655     if (newType == backupVolume) {
656         V_backupDate(originalvp) = V_copyDate(newvp);
657         V_backupDate(newvp) = V_copyDate(newvp);
658     }
659     V_inUse(newvp) = 0;
660     VUpdateVolume(&error, newvp);
661     if (error) {
662         Log("1 Volser: Clone: VUpdate failed code %u\n", error);
663         LogError(error);
664         goto fail;
665     }
666     VDetachVolume(&error, newvp);       /* allow file server to get it's hands on it */
667     newvp = NULL;
668     VUpdateVolume(&error, originalvp);
669     if (error) {
670         Log("1 Volser: Clone: original update %u\n", error);
671         LogError(error);
672         goto fail;
673     }
674     tt->rxCallPtr = (struct rx_call *)0;
675     if (TRELE(tt)) {
676         tt = (struct volser_trans *)0;
677         error = VOLSERTRELE_ERROR;
678         goto fail;
679     }
680     DeleteTrans(ttc, 1);
681     return 0;
682
683   fail:
684     if (purgevp)
685         VDetachVolume(&code, purgevp);
686     if (newvp)
687         VDetachVolume(&code, newvp);
688     if (tt) {
689         tt->rxCallPtr = (struct rx_call *)0;
690         TRELE(tt);
691     }
692     if (ttc)
693         DeleteTrans(ttc, 1);
694     return error;
695 }
696
697 /* reclone this volume into the specified id */
698 afs_int32
699 SAFSVolReClone(struct rx_call *acid, afs_int32 atrans, afs_int32 cloneId)
700 {
701     afs_int32 code;
702
703     code = VolReClone(acid, atrans, cloneId);
704     osi_auditU(acid, VS_ReCloneEvent, code, AUD_LONG, atrans, AUD_LONG,
705                cloneId, AUD_END);
706     return code;
707 }
708
709 afs_int32
710 VolReClone(struct rx_call *acid, afs_int32 atrans, afs_int32 cloneId)
711 {
712     register struct Volume *originalvp, *clonevp;
713     Error error, code;
714     afs_int32 newType;
715     register struct volser_trans *tt, *ttc;
716     char caller[MAXKTCNAMELEN];
717
718     /*not a super user */
719     if (!afsconf_SuperUser(tdir, acid, caller))
720         return VOLSERBAD_ACCESS;
721     if (DoLogging)
722         Log("%s is executing Reclone Volume %u\n", caller, cloneId);
723     error = 0;
724     clonevp = originalvp = (Volume *) 0;
725     tt = (struct volser_trans *)0;
726
727     tt = FindTrans(atrans);
728     if (!tt)
729         return ENOENT;
730     if (tt->vflags & VTDeleted) {
731         Log("1 Volser: VolReClone: volume %u has been deleted \n", tt->volid);
732         TRELE(tt);
733         return ENOENT;
734     }
735     ttc = NewTrans(cloneId, tt->partition);
736     if (!ttc) {                 /* someone is messing with the clone already */
737         TRELE(tt);
738         return VBUSY;
739     }
740     strcpy(tt->lastProcName, "ReClone");
741     tt->rxCallPtr = acid;
742
743     originalvp = tt->volume;
744     if ((V_type(originalvp) == backupVolume)
745         || (V_type(originalvp) == readonlyVolume)) {
746         Log("1 Volser: Clone: The volume to be cloned must be a read/write; aborted\n");
747         error = EROFS;
748         goto fail;
749     }
750     if ((V_destroyMe(originalvp) == DESTROY_ME) || !V_inService(originalvp)) {
751         Log("1 Volser: Clone: Volume %d is offline and cannot be cloned\n",
752             V_id(originalvp));
753         error = VOFFLINE;
754         goto fail;
755     }
756
757     clonevp = VAttachVolume(&error, cloneId, V_VOLUPD);
758     if (error) {
759         Log("1 Volser: can't attach clone %d\n", cloneId);
760         goto fail;
761     }
762
763     newType = V_type(clonevp);  /* type of the new volume */
764
765     if (originalvp->device != clonevp->device) {
766         Log("1 Volser: Clone: Volumes %u and %u are on different devices\n",
767             tt->volid, cloneId);
768         error = EXDEV;
769         goto fail;
770     }
771     if (V_type(clonevp) != readonlyVolume && V_type(clonevp) != backupVolume) {
772         Log("1 Volser: Clone: The \"recloned\" volume must be a read only volume; aborted\n");
773         error = EINVAL;
774         goto fail;
775     }
776     if (V_type(originalvp) == readonlyVolume
777         && V_parentId(originalvp) != V_parentId(clonevp)) {
778         Log("1 Volser: Clone: Volume %u and volume %u were not cloned from the same parent volume; aborted\n", tt->volid, cloneId);
779         error = EXDEV;
780         goto fail;
781     }
782     if (V_type(originalvp) == readwriteVolume
783         && tt->volid != V_parentId(clonevp)) {
784         Log("1 Volser: Clone: Volume %u was not originally cloned from volume %u; aborted\n", cloneId, tt->volid);
785         error = EXDEV;
786         goto fail;
787     }
788
789     error = 0;
790     Log("1 Volser: Clone: Recloning volume %u to volume %u\n", tt->volid,
791         cloneId);
792     CloneVolume(&error, originalvp, clonevp, clonevp);
793     if (error) {
794         Log("1 Volser: Clone: reclone operation failed with code %d\n",
795             error);
796         LogError(error);
797         goto fail;
798     }
799
800     /* fix up volume name and type, CloneVolume just propagated RW's */
801     if (newType == readonlyVolume) {
802         AssignVolumeName(&V_disk(clonevp), V_name(originalvp), ".readonly");
803         V_type(clonevp) = readonlyVolume;
804     } else if (newType == backupVolume) {
805         AssignVolumeName(&V_disk(clonevp), V_name(originalvp), ".backup");
806         V_type(clonevp) = backupVolume;
807         V_backupId(originalvp) = cloneId;
808     }
809     /* don't do strcpy onto diskstuff.name, it's still OK from 1st clone */
810
811     /* pretend recloned volume is a totally new instance */
812     V_copyDate(clonevp) = time(0);
813     V_creationDate(clonevp) = V_copyDate(clonevp);
814     ClearVolumeStats(&V_disk(clonevp));
815     V_destroyMe(clonevp) = 0;
816     V_inService(clonevp) = 0;
817     if (newType == backupVolume) {
818         V_backupDate(originalvp) = V_copyDate(clonevp);
819         V_backupDate(clonevp) = V_copyDate(clonevp);
820     }
821     V_inUse(clonevp) = 0;
822     VUpdateVolume(&error, clonevp);
823     if (error) {
824         Log("1 Volser: Clone: VUpdate failed code %u\n", error);
825         LogError(error);
826         goto fail;
827     }
828     VDetachVolume(&error, clonevp);     /* allow file server to get it's hands on it */
829     clonevp = NULL;
830     VUpdateVolume(&error, originalvp);
831     if (error) {
832         Log("1 Volser: Clone: original update %u\n", error);
833         LogError(error);
834         goto fail;
835     }
836     tt->rxCallPtr = (struct rx_call *)0;
837     if (TRELE(tt)) {
838         tt = (struct volser_trans *)0;
839         error = VOLSERTRELE_ERROR;
840         goto fail;
841     }
842
843     DeleteTrans(ttc, 1);
844
845     {
846         struct DiskPartition *tpartp = originalvp->partition;
847         FSYNC_askfs(cloneId, tpartp->name, FSYNC_RESTOREVOLUME, 0);
848     }
849     return 0;
850
851   fail:
852     if (clonevp)
853         VDetachVolume(&code, clonevp);
854     if (tt) {
855         tt->rxCallPtr = (struct rx_call *)0;
856         TRELE(tt);
857     }
858     if (ttc)
859         DeleteTrans(ttc, 1);
860     return error;
861 }
862
863 /* create a new transaction, associated with volume and partition.  Type of
864  * volume transaction is spec'd by iflags.  New trans id is returned in ttid.
865  * See volser.h for definition of iflags (the constants are named IT*).
866  */
867 afs_int32
868 SAFSVolTransCreate(struct rx_call *acid, afs_int32 volume, afs_int32 partition,
869                    afs_int32 iflags, afs_int32 *ttid)
870 {
871     afs_int32 code;
872
873     code = VolTransCreate(acid, volume, partition, iflags, ttid);
874     osi_auditU(acid, VS_TransCrEvent, code, AUD_LONG, *ttid, AUD_LONG, volume,
875                AUD_END);
876     return code;
877 }
878
879 afs_int32
880 VolTransCreate(struct rx_call *acid, afs_int32 volume, afs_int32 partition,
881                    afs_int32 iflags, afs_int32 *ttid)
882 {
883     register struct volser_trans *tt;
884     register Volume *tv;
885     afs_int32 error, code;
886     afs_int32 mode;
887     char caller[MAXKTCNAMELEN];
888
889     if (!afsconf_SuperUser(tdir, acid, caller))
890         return VOLSERBAD_ACCESS;        /*not a super user */
891     if (iflags & ITCreate)
892         mode = V_SECRETLY;
893     else if (iflags & ITBusy)
894         mode = V_CLONE;
895     else if (iflags & ITReadOnly)
896         mode = V_READONLY;
897     else if (iflags & ITOffline)
898         mode = V_VOLUPD;
899     else {
900         Log("1 Volser: TransCreate: Could not create trans, error %u\n",
901             EINVAL);
902         LogError(EINVAL);
903         return EINVAL;
904     }
905     tt = NewTrans(volume, partition);
906     if (!tt) {
907         /* can't create a transaction? put the volume back */
908         Log("1 transcreate: can't create transaction\n");
909         return VOLSERVOLBUSY;
910     }
911     tv = XAttachVolume(&error, volume, partition, mode);
912     if (error) {
913         /* give up */
914         if (tv)
915             VDetachVolume(&code, tv);
916         DeleteTrans(tt, 1);
917         return error;
918     }
919     tt->volume = tv;
920     *ttid = tt->tid;
921     tt->iflags = iflags;
922     tt->vflags = 0;
923     strcpy(tt->lastProcName, "TransCreate");
924     if (TRELE(tt))
925         return VOLSERTRELE_ERROR;
926
927     return 0;
928 }
929
930 /* using aindex as a 0-based index, return the aindex'th volume on this server
931  * Both the volume number and partition number (one-based) are returned.
932  */
933 afs_int32
934 SAFSVolGetNthVolume(struct rx_call *acid, afs_int32 aindex, afs_int32 *avolume,
935                     afs_int32 *apart)
936 {
937     afs_int32 code;
938
939     code = VolGetNthVolume(acid, aindex, avolume, apart);
940     osi_auditU(acid, VS_GetNVolEvent, code, AUD_LONG, *avolume, AUD_END);
941     return code;
942 }
943
944 afs_int32
945 VolGetNthVolume(struct rx_call *acid, afs_int32 aindex, afs_int32 *avolume,
946                     afs_int32 *apart)
947 {
948     Log("1 Volser: GetNthVolume: Not yet implemented\n");
949     return VOLSERNO_OP;
950 }
951
952 /* return the volume flags (VT* constants in volser.h) associated with this
953  * transaction.
954  */
955 afs_int32
956 SAFSVolGetFlags(struct rx_call *acid, afs_int32 atid, afs_int32 *aflags)
957 {
958     afs_int32 code;
959
960     code = VolGetFlags(acid, atid, aflags);
961     osi_auditU(acid, VS_GetFlgsEvent, code, AUD_LONG, atid, AUD_END);
962     return code;
963 }
964
965 afs_int32
966 VolGetFlags(struct rx_call *acid, afs_int32 atid, afs_int32 *aflags)
967 {
968     register struct volser_trans *tt;
969
970     tt = FindTrans(atid);
971     if (!tt)
972         return ENOENT;
973     if (tt->vflags & VTDeleted) {
974         Log("1 Volser: VolGetFlags: volume %u has been deleted \n",
975             tt->volid);
976         TRELE(tt);
977         return ENOENT;
978     }
979     strcpy(tt->lastProcName, "GetFlags");
980     tt->rxCallPtr = acid;
981     *aflags = tt->vflags;
982     tt->rxCallPtr = (struct rx_call *)0;
983     if (TRELE(tt))
984         return VOLSERTRELE_ERROR;
985
986     return 0;
987 }
988
989 /* Change the volume flags (VT* constants in volser.h) associated with this
990  * transaction.  Effects take place immediately on volume, although volume
991  * remains attached as usual by the transaction.
992  */
993 afs_int32
994 SAFSVolSetFlags(struct rx_call *acid, afs_int32 atid, afs_int32 aflags)
995 {
996     afs_int32 code;
997
998     code = VolSetFlags(acid, atid, aflags);
999     osi_auditU(acid, VS_SetFlgsEvent, code, AUD_LONG, atid, AUD_LONG, aflags,
1000                AUD_END);
1001     return code;
1002 }
1003
1004 afs_int32
1005 VolSetFlags(struct rx_call *acid, afs_int32 atid, afs_int32 aflags)
1006 {
1007     register struct volser_trans *tt;
1008     register struct Volume *vp;
1009     afs_int32 error;
1010     char caller[MAXKTCNAMELEN];
1011
1012     if (!afsconf_SuperUser(tdir, acid, caller))
1013         return VOLSERBAD_ACCESS;        /*not a super user */
1014     /* find the trans */
1015     tt = FindTrans(atid);
1016     if (!tt)
1017         return ENOENT;
1018     if (tt->vflags & VTDeleted) {
1019         Log("1 Volser: VolSetFlags: volume %u has been deleted \n",
1020             tt->volid);
1021         TRELE(tt);
1022         return ENOENT;
1023     }
1024     strcpy(tt->lastProcName, "SetFlags");
1025     tt->rxCallPtr = acid;
1026     vp = tt->volume;            /* pull volume out of transaction */
1027
1028     /* check if we're allowed to make any updates */
1029     if (tt->iflags & ITReadOnly) {
1030         TRELE(tt);
1031         return EROFS;
1032     }
1033
1034     /* handle delete-on-salvage flag */
1035     if (aflags & VTDeleteOnSalvage) {
1036         V_destroyMe(tt->volume) = DESTROY_ME;
1037     } else {
1038         V_destroyMe(tt->volume) = 0;
1039     }
1040
1041     if (aflags & VTOutOfService) {
1042         V_inService(vp) = 0;
1043     } else {
1044         V_inService(vp) = 1;
1045     }
1046     VUpdateVolume(&error, vp);
1047     tt->vflags = aflags;
1048     tt->rxCallPtr = (struct rx_call *)0;
1049     if (TRELE(tt) && !error)
1050         return VOLSERTRELE_ERROR;
1051
1052     return error;
1053 }
1054
1055 /* dumpS the volume associated with a particular transaction from a particular
1056  * date.  Send the dump to a different transaction (destTrans) on the server
1057  * specified by the destServer structure.
1058  */
1059 afs_int32
1060 SAFSVolForward(struct rx_call *acid, afs_int32 fromTrans, afs_int32 fromDate,
1061                struct destServer *destination, afs_int32 destTrans, 
1062                struct restoreCookie *cookie)
1063 {
1064     afs_int32 code;
1065
1066     code =
1067         VolForward(acid, fromTrans, fromDate, destination, destTrans, cookie);
1068     osi_auditU(acid, VS_ForwardEvent, code, AUD_LONG, fromTrans, AUD_HOST,
1069                destination->destHost, AUD_LONG, destTrans, AUD_END);
1070     return code;
1071 }
1072
1073 afs_int32
1074 VolForward(struct rx_call *acid, afs_int32 fromTrans, afs_int32 fromDate,
1075                struct destServer *destination, afs_int32 destTrans, 
1076                struct restoreCookie *cookie)
1077 {
1078     register struct volser_trans *tt;
1079     register afs_int32 code;
1080     register struct rx_connection *tcon;
1081     struct rx_call *tcall;
1082     register struct Volume *vp;
1083     struct rx_securityClass *securityObject;
1084     afs_int32 securityIndex;
1085     char caller[MAXKTCNAMELEN];
1086
1087     if (!afsconf_SuperUser(tdir, acid, caller))
1088         return VOLSERBAD_ACCESS;        /*not a super user */
1089     /* initialize things */
1090     tcon = (struct rx_connection *)0;
1091     tt = (struct volser_trans *)0;
1092
1093     /* find the local transaction */
1094     tt = FindTrans(fromTrans);
1095     if (!tt)
1096         return ENOENT;
1097     if (tt->vflags & VTDeleted) {
1098         Log("1 Volser: VolForward: volume %u has been deleted \n", tt->volid);
1099         TRELE(tt);
1100         return ENOENT;
1101     }
1102     vp = tt->volume;
1103     strcpy(tt->lastProcName, "Forward");
1104
1105     /* get auth info for the this connection (uses afs from ticket file) */
1106     code = afsconf_ClientAuth(tdir, &securityObject, &securityIndex);
1107     if (code) {
1108         TRELE(tt);
1109         return code;
1110     }
1111
1112     /* make an rpc connection to the other server */
1113     tcon =
1114         rx_NewConnection(htonl(destination->destHost),
1115                          htons(destination->destPort), VOLSERVICE_ID,
1116                          securityObject, securityIndex);
1117     if (!tcon) {
1118         tt->rxCallPtr = (struct rx_call *)0;
1119         TRELE(tt);
1120         return ENOTCONN;
1121     }
1122     tcall = rx_NewCall(tcon);
1123     tt->rxCallPtr = tcall;
1124     /* start restore going.  fromdate == 0 --> doing an incremental dump/restore */
1125     code = StartAFSVolRestore(tcall, destTrans, (fromDate ? 1 : 0), cookie);
1126     if (code) {
1127         goto fail;
1128     }
1129
1130     /* these next calls implictly call rx_Write when writing out data */
1131     code = DumpVolume(tcall, vp, fromDate, 0);  /* last field = don't dump all dirs */
1132     if (code)
1133         goto fail;
1134     EndAFSVolRestore(tcall);    /* probably doesn't do much */
1135     tt->rxCallPtr = (struct rx_call *)0;
1136     code = rx_EndCall(tcall, 0);
1137     rx_DestroyConnection(tcon); /* done with the connection */
1138     tcon = NULL;
1139     if (code)
1140         goto fail;
1141     if (TRELE(tt))
1142         return VOLSERTRELE_ERROR;
1143
1144     return 0;
1145
1146   fail:
1147     if (tcon) {
1148         (void)rx_EndCall(tcall, 0);
1149         rx_DestroyConnection(tcon);
1150     }
1151     if (tt) {
1152         tt->rxCallPtr = (struct rx_call *)0;
1153         TRELE(tt);
1154     }
1155     return code;
1156 }
1157
1158 /* Start a dump and send it to multiple places simultaneously.
1159  * If this returns an error (eg, return ENOENT), it means that
1160  * none of the releases worked.  If this returns 0, that means 
1161  * that one or more of the releases worked, and the caller has
1162  * to examine the results array to see which one(s).
1163  * This will only do EITHER incremental or full, not both, so it's
1164  * the caller's responsibility to be sure that all the destinations
1165  * need just an incremental (and from the same time), if that's 
1166  * what we're doing. 
1167  */
1168 afs_int32
1169 SAFSVolForwardMultiple(struct rx_call *acid, afs_int32 fromTrans, afs_int32 
1170                        fromDate, manyDests *destinations, afs_int32 spare,
1171                        struct restoreCookie *cookie, manyResults *results)
1172 {
1173     afs_int32 securityIndex;
1174     struct rx_securityClass *securityObject;
1175     char caller[MAXKTCNAMELEN];
1176     struct volser_trans *tt;
1177     afs_int32 ec, code, *codes;
1178     struct rx_connection **tcons;
1179     struct rx_call **tcalls;
1180     struct Volume *vp;
1181     int i, is_incremental;
1182
1183     if (results)
1184         memset(results, 0, sizeof(manyResults));
1185
1186     if (!afsconf_SuperUser(tdir, acid, caller))
1187         return VOLSERBAD_ACCESS;        /*not a super user */
1188     tt = FindTrans(fromTrans);
1189     if (!tt)
1190         return ENOENT;
1191     if (tt->vflags & VTDeleted) {
1192         Log("1 Volser: VolForward: volume %u has been deleted \n", tt->volid);
1193         TRELE(tt);
1194         return ENOENT;
1195     }
1196     vp = tt->volume;
1197     strcpy(tt->lastProcName, "ForwardMulti");
1198
1199     /* (fromDate == 0) ==> incremental dump */
1200     is_incremental = (fromDate ? 1 : 0);
1201
1202     i = results->manyResults_len = destinations->manyDests_len;
1203     results->manyResults_val = codes =
1204         (afs_int32 *) malloc(i * sizeof(afs_int32));
1205     tcons =
1206         (struct rx_connection **)malloc(i * sizeof(struct rx_connection *));
1207     tcalls = (struct rx_call **)malloc(i * sizeof(struct rx_call *));
1208
1209     /* get auth info for this connection (uses afs from ticket file) */
1210     code = afsconf_ClientAuth(tdir, &securityObject, &securityIndex);
1211     if (code) {
1212         goto fail;              /* in order to audit each failure */
1213     }
1214
1215     /* make connections to all the other servers */
1216     for (i = 0; i < destinations->manyDests_len; i++) {
1217         struct replica *dest = &(destinations->manyDests_val[i]);
1218         tcons[i] =
1219             rx_NewConnection(htonl(dest->server.destHost),
1220                              htons(dest->server.destPort), VOLSERVICE_ID,
1221                              securityObject, securityIndex);
1222         if (!tcons[i]) {
1223             codes[i] = ENOTCONN;
1224         } else {
1225             if (!(tcalls[i] = rx_NewCall(tcons[i])))
1226                 codes[i] = ENOTCONN;
1227             else {
1228                 codes[i] =
1229                     StartAFSVolRestore(tcalls[i], dest->trans, is_incremental,
1230                                        cookie);
1231                 if (codes[i]) {
1232                     (void)rx_EndCall(tcalls[i], 0);
1233                     tcalls[i] = 0;
1234                     rx_DestroyConnection(tcons[i]);
1235                     tcons[i] = 0;
1236                 }
1237             }
1238         }
1239     }
1240
1241     /* these next calls implictly call rx_Write when writing out data */
1242     code = DumpVolMulti(tcalls, i, vp, fromDate, 0, codes);
1243
1244
1245   fail:
1246     for (i--; i >= 0; i--) {
1247         struct replica *dest = &(destinations->manyDests_val[i]);
1248
1249         if (!code && tcalls[i] && !codes[i]) {
1250             EndAFSVolRestore(tcalls[i]);
1251         }
1252         if (tcalls[i]) {
1253             ec = rx_EndCall(tcalls[i], 0);
1254             if (!codes[i])
1255                 codes[i] = ec;
1256         }
1257         if (tcons[i]) {
1258             rx_DestroyConnection(tcons[i]);     /* done with the connection */
1259         }
1260
1261         osi_auditU(acid, VS_ForwardEvent, (code ? code : codes[i]), AUD_LONG,
1262                    fromTrans, AUD_HOST, dest->server.destHost, AUD_LONG,
1263                    dest->trans, AUD_END);
1264     }
1265     free(tcons);
1266     free(tcalls);
1267
1268     if (tt) {
1269         tt->rxCallPtr = (struct rx_call *)0;
1270         if (TRELE(tt) && !code) /* return the first code if it's set */
1271             return VOLSERTRELE_ERROR;
1272     }
1273
1274     return code;
1275 }
1276
1277 afs_int32
1278 SAFSVolDump(struct rx_call *acid, afs_int32 fromTrans, afs_int32 fromDate)
1279 {
1280     afs_int32 code;
1281
1282     code = VolDump(acid, fromTrans, fromDate);
1283     osi_auditU(acid, VS_DumpEvent, code, AUD_LONG, fromTrans, AUD_END);
1284     return code;
1285 }
1286
1287 afs_int32
1288 VolDump(struct rx_call *acid, afs_int32 fromTrans, afs_int32 fromDate)
1289 {
1290     int code = 0;
1291     register struct volser_trans *tt;
1292     char caller[MAXKTCNAMELEN];
1293
1294     if (!afsconf_SuperUser(tdir, acid, caller))
1295         return VOLSERBAD_ACCESS;        /*not a super user */
1296     tt = FindTrans(fromTrans);
1297     if (!tt)
1298         return ENOENT;
1299     if (tt->vflags & VTDeleted) {
1300         Log("1 Volser: VolDump: volume %u has been deleted \n", tt->volid);
1301         TRELE(tt);
1302         return ENOENT;
1303     }
1304     strcpy(tt->lastProcName, "Dump");
1305     tt->rxCallPtr = acid;
1306     code = DumpVolume(acid, tt->volume, fromDate, 1);   /* squirt out the volume's data, too */
1307     if (code) {
1308         tt->rxCallPtr = (struct rx_call *)0;
1309         TRELE(tt);
1310         return code;
1311     }
1312     tt->rxCallPtr = (struct rx_call *)0;
1313
1314     if (TRELE(tt))
1315         return VOLSERTRELE_ERROR;
1316
1317     return 0;
1318 }
1319
1320 /* 
1321  * Ha!  No more helper process!
1322  */
1323 afs_int32
1324 SAFSVolRestore(struct rx_call *acid, afs_int32 atrans, afs_int32 aflags, 
1325                struct restoreCookie *cookie)
1326 {
1327     afs_int32 code;
1328
1329     code = VolRestore(acid, atrans, aflags, cookie);
1330     osi_auditU(acid, VS_RestoreEvent, code, AUD_LONG, atrans, AUD_END);
1331     return code;
1332 }
1333
1334 afs_int32
1335 VolRestore(struct rx_call *acid, afs_int32 atrans, afs_int32 aflags, 
1336                struct restoreCookie *cookie)
1337 {
1338     register struct volser_trans *tt;
1339     register afs_int32 code, tcode;
1340     char caller[MAXKTCNAMELEN];
1341
1342     if (!afsconf_SuperUser(tdir, acid, caller))
1343         return VOLSERBAD_ACCESS;        /*not a super user */
1344     tt = FindTrans(atrans);
1345     if (!tt)
1346         return ENOENT;
1347     if (tt->vflags & VTDeleted) {
1348         Log("1 Volser: VolRestore: volume %u has been deleted \n", tt->volid);
1349         TRELE(tt);
1350         return ENOENT;
1351     }
1352     strcpy(tt->lastProcName, "Restore");
1353     tt->rxCallPtr = acid;
1354
1355     DFlushVolume(V_parentId(tt->volume)); /* Ensure dir buffers get dropped */
1356
1357     code = RestoreVolume(acid, tt->volume, (aflags & 1), cookie);       /* last is incrementalp */
1358     FSYNC_askfs(tt->volid, NULL, FSYNC_RESTOREVOLUME, 0l);      /*break call backs on the
1359                                                                  * restored volume */
1360     tt->rxCallPtr = (struct rx_call *)0;
1361     tcode = TRELE(tt);
1362
1363     return (code ? code : tcode);
1364 }
1365
1366 /* end a transaction, returning the transaction's final error code in rcode */
1367 afs_int32
1368 SAFSVolEndTrans(struct rx_call *acid, afs_int32 destTrans, afs_int32 *rcode)
1369 {
1370     afs_int32 code;
1371
1372     code = VolEndTrans(acid, destTrans, rcode);
1373     osi_auditU(acid, VS_EndTrnEvent, code, AUD_LONG, destTrans, AUD_END);
1374     return code;
1375 }
1376
1377 afs_int32
1378 VolEndTrans(struct rx_call *acid, afs_int32 destTrans, afs_int32 *rcode)
1379 {
1380     register struct volser_trans *tt;
1381     char caller[MAXKTCNAMELEN];
1382
1383     if (!afsconf_SuperUser(tdir, acid, caller))
1384         return VOLSERBAD_ACCESS;        /*not a super user */
1385     tt = FindTrans(destTrans);
1386     if (!tt) {
1387         return ENOENT;
1388     }
1389     *rcode = tt->returnCode;
1390     DeleteTrans(tt, 1);         /* this does an implicit TRELE */
1391
1392     return 0;
1393 }
1394
1395 afs_int32
1396 SAFSVolSetForwarding(struct rx_call *acid, afs_int32 atid, afs_int32 anewsite)
1397 {
1398     afs_int32 code;
1399
1400     code = VolSetForwarding(acid, atid, anewsite);
1401     osi_auditU(acid, VS_SetForwEvent, code, AUD_LONG, atid, AUD_HOST,
1402                anewsite, AUD_END);
1403     return code;
1404 }
1405
1406 afs_int32
1407 VolSetForwarding(struct rx_call *acid, afs_int32 atid, afs_int32 anewsite)
1408 {
1409     register struct volser_trans *tt;
1410     char caller[MAXKTCNAMELEN];
1411
1412     if (!afsconf_SuperUser(tdir, acid, caller))
1413         return VOLSERBAD_ACCESS;        /*not a super user */
1414     tt = FindTrans(atid);
1415     if (!tt)
1416         return ENOENT;
1417     if (tt->vflags & VTDeleted) {
1418         Log("1 Volser: VolSetForwarding: volume %u has been deleted \n",
1419             tt->volid);
1420         TRELE(tt);
1421         return ENOENT;
1422     }
1423     strcpy(tt->lastProcName, "SetForwarding");
1424     tt->rxCallPtr = acid;
1425     FSYNC_askfs(tt->volid, NULL, FSYNC_MOVEVOLUME, anewsite);
1426     tt->rxCallPtr = (struct rx_call *)0;
1427     if (TRELE(tt))
1428         return VOLSERTRELE_ERROR;
1429
1430     return 0;
1431 }
1432
1433 afs_int32
1434 SAFSVolGetStatus(struct rx_call *acid, afs_int32 atrans, 
1435                  register struct volser_status *astatus)
1436 {
1437     afs_int32 code;
1438
1439     code = VolGetStatus(acid, atrans, astatus);
1440     osi_auditU(acid, VS_GetStatEvent, code, AUD_LONG, atrans, AUD_END);
1441     return code;
1442 }
1443
1444 afs_int32
1445 VolGetStatus(struct rx_call *acid, afs_int32 atrans, 
1446                  register struct volser_status *astatus)
1447 {
1448     register struct Volume *tv;
1449     register struct VolumeDiskData *td;
1450     struct volser_trans *tt;
1451
1452
1453     tt = FindTrans(atrans);
1454     if (!tt)
1455         return ENOENT;
1456     if (tt->vflags & VTDeleted) {
1457         Log("1 Volser: VolGetStatus: volume %u has been deleted \n",
1458             tt->volid);
1459         TRELE(tt);
1460         return ENOENT;
1461     }
1462     strcpy(tt->lastProcName, "GetStatus");
1463     tt->rxCallPtr = acid;
1464     tv = tt->volume;
1465     if (!tv) {
1466         tt->rxCallPtr = (struct rx_call *)0;
1467         TRELE(tt);
1468         return ENOENT;
1469     }
1470
1471     td = &tv->header->diskstuff;
1472     astatus->volID = td->id;
1473     astatus->nextUnique = td->uniquifier;
1474     astatus->type = td->type;
1475     astatus->parentID = td->parentId;
1476     astatus->cloneID = td->cloneId;
1477     astatus->backupID = td->backupId;
1478     astatus->restoredFromID = td->restoredFromId;
1479     astatus->maxQuota = td->maxquota;
1480     astatus->minQuota = td->minquota;
1481     astatus->owner = td->owner;
1482     astatus->creationDate = td->creationDate;
1483     astatus->accessDate = td->accessDate;
1484     astatus->updateDate = td->updateDate;
1485     astatus->expirationDate = td->expirationDate;
1486     astatus->backupDate = td->backupDate;
1487     astatus->copyDate = td->copyDate;
1488     tt->rxCallPtr = (struct rx_call *)0;
1489     if (TRELE(tt))
1490         return VOLSERTRELE_ERROR;
1491
1492     return 0;
1493 }
1494
1495 afs_int32
1496 SAFSVolSetInfo(struct rx_call *acid, afs_int32 atrans, 
1497                register struct volintInfo *astatus)
1498 {
1499     afs_int32 code;
1500
1501     code = VolSetInfo(acid, atrans, astatus);
1502     osi_auditU(acid, VS_SetInfoEvent, code, AUD_LONG, atrans, AUD_END);
1503     return code;
1504 }
1505
1506 afs_int32
1507 VolSetInfo(struct rx_call *acid, afs_int32 atrans, 
1508                register struct volintInfo *astatus)
1509 {
1510     register struct Volume *tv;
1511     register struct VolumeDiskData *td;
1512     struct volser_trans *tt;
1513     char caller[MAXKTCNAMELEN];
1514     afs_int32 error;
1515
1516     if (!afsconf_SuperUser(tdir, acid, caller))
1517         return VOLSERBAD_ACCESS;        /*not a super user */
1518     tt = FindTrans(atrans);
1519     if (!tt)
1520         return ENOENT;
1521     if (tt->vflags & VTDeleted) {
1522         Log("1 Volser: VolSetInfo: volume %u has been deleted \n", tt->volid);
1523         TRELE(tt);
1524         return ENOENT;
1525     }
1526     strcpy(tt->lastProcName, "SetStatus");
1527     tt->rxCallPtr = acid;
1528     tv = tt->volume;
1529     if (!tv) {
1530         tt->rxCallPtr = (struct rx_call *)0;
1531         TRELE(tt);
1532         return ENOENT;
1533     }
1534
1535     td = &tv->header->diskstuff;
1536     /*
1537      * Add more fields as necessary
1538      */
1539     if (astatus->maxquota != -1)
1540         td->maxquota = astatus->maxquota;
1541     if (astatus->dayUse != -1)
1542         td->dayUse = astatus->dayUse;
1543     if (astatus->creationDate != -1)
1544         td->creationDate = astatus->creationDate;
1545     if (astatus->updateDate != -1)
1546         td->updateDate = astatus->updateDate;
1547     VUpdateVolume(&error, tv);
1548     tt->rxCallPtr = (struct rx_call *)0;
1549     if (TRELE(tt))
1550         return VOLSERTRELE_ERROR;
1551     return 0;
1552 }
1553
1554
1555 afs_int32
1556 SAFSVolGetName(struct rx_call *acid, afs_int32 atrans, char **aname)
1557 {
1558     afs_int32 code;
1559
1560     code = VolGetName(acid, atrans, aname);
1561     osi_auditU(acid, VS_GetNameEvent, code, AUD_LONG, atrans, AUD_END);
1562     return code;
1563 }
1564
1565 afs_int32
1566 VolGetName(struct rx_call *acid, afs_int32 atrans, char **aname)
1567 {
1568     register struct Volume *tv;
1569     register struct VolumeDiskData *td;
1570     struct volser_trans *tt;
1571     register int len;
1572
1573     *aname = NULL;
1574     tt = FindTrans(atrans);
1575     if (!tt)
1576         return ENOENT;
1577     if (tt->vflags & VTDeleted) {
1578         Log("1 Volser: VolGetName: volume %u has been deleted \n", tt->volid);
1579         TRELE(tt);
1580         return ENOENT;
1581     }
1582     strcpy(tt->lastProcName, "GetName");
1583     tt->rxCallPtr = acid;
1584     tv = tt->volume;
1585     if (!tv) {
1586         tt->rxCallPtr = (struct rx_call *)0;
1587         TRELE(tt);
1588         return ENOENT;
1589     }
1590
1591     td = &tv->header->diskstuff;
1592     len = strlen(td->name) + 1; /* don't forget the null */
1593     if (len >= SIZE) {
1594         tt->rxCallPtr = (struct rx_call *)0;
1595         TRELE(tt);
1596         return E2BIG;
1597     }
1598     *aname = (char *)malloc(len);
1599     strcpy(*aname, td->name);
1600     tt->rxCallPtr = (struct rx_call *)0;
1601     if (TRELE(tt))
1602         return VOLSERTRELE_ERROR;
1603
1604     return 0;
1605 }
1606
1607 /*this is a handshake to indicate that the next call will be SAFSVolRestore
1608  * - a noop now !*/
1609 afs_int32
1610 SAFSVolSignalRestore(struct rx_call *acid, char volname[], int volType, 
1611                      afs_int32 parentId, afs_int32 cloneId)
1612 {
1613     return 0;
1614 }
1615
1616
1617 /*return a list of all partitions on the server. The non mounted
1618  *partitions are returned as -1 in the corresponding slot in partIds*/
1619 afs_int32
1620 SAFSVolListPartitions(struct rx_call *acid, struct pIDs *partIds)
1621 {
1622     afs_int32 code;
1623
1624     code = VolListPartitions(acid, partIds);
1625     osi_auditU(acid, VS_ListParEvent, code, AUD_END);
1626     return code;
1627 }
1628
1629 afs_int32
1630 VolListPartitions(struct rx_call *acid, struct pIDs *partIds)
1631 {
1632     char namehead[9];
1633     char i;
1634
1635     strcpy(namehead, "/vicep"); /*7 including null terminator */
1636
1637     /* Just return attached partitions. */
1638     namehead[7] = '\0';
1639     for (i = 0; i < 26; i++) {
1640         namehead[6] = i + 'a';
1641         if (VGetPartition(namehead, 0))
1642             partIds->partIds[i] = VGetPartition(namehead, 0) ? i : -1;
1643     }
1644
1645     return 0;
1646 }
1647
1648 /*return a list of all partitions on the server. The non mounted
1649  *partitions are returned as -1 in the corresponding slot in partIds*/
1650 afs_int32
1651 SAFSVolXListPartitions(struct rx_call *acid, struct partEntries *pEntries)
1652 {
1653     afs_int32 code;
1654
1655     code = XVolListPartitions(acid, pEntries);
1656     osi_auditU(acid, VS_ListParEvent, code, AUD_END);
1657     return code;
1658 }
1659
1660 afs_int32
1661 XVolListPartitions(struct rx_call *acid, struct partEntries *pEntries)
1662 {
1663     struct stat rbuf, pbuf;
1664     char namehead[9];
1665     struct partList partList;
1666     struct DiskPartition *dp;
1667     int i, j = 0, k;
1668
1669     strcpy(namehead, "/vicep"); /*7 including null terminator */
1670
1671     /* Only report attached partitions */
1672     for (i = 0; i < VOLMAXPARTS; i++) {
1673         if (i < 26) {
1674             namehead[6] = i + 'a';
1675             namehead[7] = '\0';
1676         } else {
1677             k = i - 26;
1678             namehead[6] = 'a' + (k / 26);
1679             namehead[7] = 'a' + (k % 26);
1680             namehead[8] = '\0';
1681         }
1682         dp = VGetPartition(namehead, 0);
1683         if (dp)
1684             partList.partId[j++] = i;
1685     }
1686     pEntries->partEntries_val = (afs_int32 *) malloc(j * sizeof(int));
1687     memcpy((char *)pEntries->partEntries_val, (char *)&partList,
1688            j * sizeof(int));
1689     pEntries->partEntries_len = j;
1690     return 0;
1691
1692 }
1693
1694 /*extract the volume id from string vname. Its of the form " V0*<id>.vol  "*/
1695 afs_int32
1696 ExtractVolId(char vname[])
1697 {
1698     int i;
1699     char name[VOLSER_MAXVOLNAME + 1];
1700
1701     strcpy(name, vname);
1702     i = 0;
1703     while (name[i] == 'V' || name[i] == '0')
1704         i++;
1705
1706     name[11] = '\0';            /* smash the "." */
1707     return (atol(&name[i]));
1708 }
1709
1710 /*return the name of the next volume header in the directory associated with dirp and dp.
1711 *the volume id is  returned in volid, and volume header name is returned in volname*/
1712 int
1713 GetNextVol(DIR * dirp, char *volname, afs_int32 * volid)
1714 {
1715     struct dirent *dp;
1716
1717     dp = readdir(dirp);         /*read next entry in the directory */
1718     if (dp) {
1719         if ((dp->d_name[0] == 'V') && !strcmp(&(dp->d_name[11]), VHDREXT)) {
1720             *volid = ExtractVolId(dp->d_name);
1721             strcpy(volname, dp->d_name);
1722             return 0;           /*return the name of the file representing a volume */
1723         } else {
1724             strcpy(volname, "");
1725             return 0;           /*volname doesnot represent a volume */
1726         }
1727     } else {
1728         strcpy(volname, "EOD");
1729         return 0;               /*end of directory */
1730     }
1731
1732 }
1733
1734 /*return the header information about the <volid> */
1735 afs_int32
1736 SAFSVolListOneVolume(struct rx_call *acid, afs_int32 partid, afs_int32 
1737                      volumeId, volEntries *volumeInfo)
1738 {
1739     afs_int32 code;
1740
1741     code = VolListOneVolume(acid, partid, volumeId, volumeInfo);
1742     osi_auditU(acid, VS_Lst1VolEvent, code, AUD_LONG, volumeId, AUD_END);
1743     return code;
1744 }
1745
1746 afs_int32
1747 VolListOneVolume(struct rx_call *acid, afs_int32 partid, afs_int32 
1748                      volumeId, volEntries *volumeInfo)
1749 {
1750     volintInfo *pntr;
1751     register struct Volume *tv;
1752     struct DiskPartition *partP;
1753     struct volser_trans *ttc;
1754     char pname[9], volname[20];
1755     afs_int32 error = 0;
1756     DIR *dirp;
1757     afs_int32 volid;
1758     int found = 0;
1759     unsigned int now;
1760
1761     volumeInfo->volEntries_val = (volintInfo *) malloc(sizeof(volintInfo));
1762     pntr = volumeInfo->volEntries_val;
1763     volumeInfo->volEntries_len = 1;
1764     if (GetPartName(partid, pname))
1765         return VOLSERILLEGAL_PARTITION;
1766     if (!(partP = VGetPartition(pname, 0)))
1767         return VOLSERILLEGAL_PARTITION;
1768     dirp = opendir(VPartitionPath(partP));
1769     if (dirp == NULL)
1770         return VOLSERILLEGAL_PARTITION;
1771     strcpy(volname, "");
1772     ttc = (struct volser_trans *)0;
1773     tv = (Volume *) 0;          /* volume not attached */
1774
1775     while (strcmp(volname, "EOD") && !found) {  /*while there are more volumes in the partition */
1776
1777         if (!strcmp(volname, "")) {     /* its not a volume, fetch next file */
1778             GetNextVol(dirp, volname, &volid);
1779             continue;           /*back to while loop */
1780         }
1781
1782         if (volid == volumeId) {        /*copy other things too */
1783             found = 1;
1784 #ifndef AFS_PTHREAD_ENV
1785             IOMGR_Poll();       /*make sure that the client doesnot time out */
1786 #endif
1787             ttc = NewTrans(volid, partid);
1788             if (!ttc) {
1789                 pntr->status = VBUSY;
1790                 pntr->volid = volid;
1791                 goto drop;
1792             }
1793             tv = VAttachVolumeByName(&error, pname, volname, V_READONLY);
1794             if (error) {
1795                 pntr->status = 0;       /*things are messed up */
1796                 strcpy(pntr->name, volname);
1797                 pntr->volid = volid;
1798                 Log("1 Volser: ListVolumes: Could not attach volume %u (%s:%s), error=%d\n", volid, pname, volname, error);
1799                 goto drop;
1800             }
1801             if (tv->header->diskstuff.destroyMe == DESTROY_ME) {
1802                 /*this volume will be salvaged */
1803                 pntr->status = 0;
1804                 strcpy(pntr->name, volname);
1805                 pntr->volid = volid;
1806                 Log("1 Volser: ListVolumes: Volume %u (%s) will be destroyed on next salvage\n", volid, volname);
1807                 goto drop;
1808             }
1809
1810             if (tv->header->diskstuff.needsSalvaged) {
1811                 /*this volume will be salvaged */
1812                 pntr->status = 0;
1813                 strcpy(pntr->name, volname);
1814                 pntr->volid = volid;
1815                 Log("1 Volser: ListVolumes: Volume %u (%s) needs to be salvaged\n", volid, volname);
1816                 goto drop;
1817             }
1818
1819             /*read in the relevant info */
1820             pntr->status = VOK; /*its ok */
1821             pntr->volid = tv->header->diskstuff.id;
1822             strcpy(pntr->name, tv->header->diskstuff.name);
1823             pntr->type = tv->header->diskstuff.type;    /*if ro volume */
1824             pntr->cloneID = tv->header->diskstuff.cloneId;      /*if rw volume */
1825             pntr->backupID = tv->header->diskstuff.backupId;
1826             pntr->parentID = tv->header->diskstuff.parentId;
1827             pntr->copyDate = tv->header->diskstuff.copyDate;
1828             pntr->inUse = tv->header->diskstuff.inUse;
1829             pntr->size = tv->header->diskstuff.diskused;
1830             pntr->needsSalvaged = tv->header->diskstuff.needsSalvaged;
1831             pntr->destroyMe = tv->header->diskstuff.destroyMe;
1832             pntr->maxquota = tv->header->diskstuff.maxquota;
1833             pntr->filecount = tv->header->diskstuff.filecount;
1834             now = FT_ApproxTime();
1835             if (now - tv->header->diskstuff.dayUseDate > OneDay)
1836                 pntr->dayUse = 0;
1837             else
1838                 pntr->dayUse = tv->header->diskstuff.dayUse;
1839             pntr->creationDate = tv->header->diskstuff.creationDate;
1840             pntr->accessDate = tv->header->diskstuff.accessDate;
1841             pntr->updateDate = tv->header->diskstuff.updateDate;
1842             pntr->backupDate = tv->header->diskstuff.backupDate;
1843             pntr->spare0 = tv->header->diskstuff.minquota;
1844             pntr->spare1 =
1845                 (long)tv->header->diskstuff.weekUse[0] +
1846                 (long)tv->header->diskstuff.weekUse[1] +
1847                 (long)tv->header->diskstuff.weekUse[2] +
1848                 (long)tv->header->diskstuff.weekUse[3] +
1849                 (long)tv->header->diskstuff.weekUse[4] +
1850                 (long)tv->header->diskstuff.weekUse[5] +
1851                 (long)tv->header->diskstuff.weekUse[6];
1852             pntr->flags = pntr->spare2 = pntr->spare3 = (long)0;
1853             VDetachVolume(&error, tv);  /*free the volume */
1854             tv = (Volume *) 0;
1855             if (error) {
1856                 pntr->status = 0;       /*things are messed up */
1857                 strcpy(pntr->name, volname);
1858                 Log("1 Volser: ListVolumes: Could not detach volume %s\n",
1859                     volname);
1860                 goto drop;
1861             }
1862         }
1863         GetNextVol(dirp, volname, &volid);
1864     }
1865   drop:
1866     if (tv) {
1867         VDetachVolume(&error, tv);
1868         tv = (Volume *) 0;
1869     }
1870     if (ttc) {
1871         DeleteTrans(ttc, 1);
1872         ttc = (struct volser_trans *)0;
1873     }
1874
1875     closedir(dirp);
1876     if (found)
1877         return 0;
1878     else
1879         return ENODEV;
1880 }
1881
1882 /*------------------------------------------------------------------------
1883  * EXPORTED SAFSVolXListOneVolume
1884  *
1885  * Description:
1886  *      Returns extended info on volume a_volID on partition a_partID.
1887  *
1888  * Arguments:
1889  *      a_rxCidP       : Pointer to the Rx call we're performing.
1890  *      a_partID       : Partition for which we want the extended list.
1891  *      a_volID        : Volume ID we wish to know about.
1892  *      a_volumeXInfoP : Ptr to the extended info blob.
1893  *
1894  * Returns:
1895  *      0                       Successful operation
1896  *      VOLSERILLEGAL_PARTITION if we got a bogus partition ID
1897  *
1898  * Environment:
1899  *      Nothing interesting.
1900  *
1901  * Side Effects:
1902  *      As advertised.
1903  *------------------------------------------------------------------------*/
1904
1905 afs_int32
1906 SAFSVolXListOneVolume(struct rx_call *a_rxCidP, afs_int32 a_partID, 
1907                       afs_int32 a_volID, volXEntries *a_volumeXInfoP)
1908 {
1909     afs_int32 code;
1910
1911     code = VolXListOneVolume(a_rxCidP, a_partID, a_volID, a_volumeXInfoP);
1912     osi_auditU(a_rxCidP, VS_XLst1VlEvent, code, AUD_LONG, a_volID, AUD_END);
1913     return code;
1914 }
1915
1916 afs_int32
1917 VolXListOneVolume(struct rx_call *a_rxCidP, afs_int32 a_partID, 
1918                       afs_int32 a_volID, volXEntries *a_volumeXInfoP)
1919 {                               /*SAFSVolXListOneVolume */
1920
1921     volintXInfo *xInfoP;        /*Ptr to the extended vol info */
1922     register struct Volume *tv; /*Volume ptr */
1923     struct volser_trans *ttc;   /*Volume transaction ptr */
1924     struct DiskPartition *partP;        /*Ptr to partition */
1925     char pname[9], volname[20]; /*Partition, volume names */
1926     afs_int32 error;            /*Error code */
1927     afs_int32 code;             /*Return code */
1928     DIR *dirp;                  /*Partition directory ptr */
1929     afs_int32 currVolID;        /*Current volume ID */
1930     int found = 0;              /*Did we find the volume we need? */
1931     struct VolumeDiskData *volDiskDataP;        /*Ptr to on-disk volume data */
1932     int numStatBytes;           /*Num stat bytes to copy per volume */
1933     unsigned int now;
1934
1935     /*
1936      * Set up our pointers for action, marking our structure to hold exactly
1937      * one entry.  Also, assume we'll fail in our quest.
1938      */
1939     a_volumeXInfoP->volXEntries_val =
1940         (volintXInfo *) malloc(sizeof(volintXInfo));
1941     xInfoP = a_volumeXInfoP->volXEntries_val;
1942     a_volumeXInfoP->volXEntries_len = 1;
1943     code = ENODEV;
1944
1945     /*
1946      * If the partition name we've been given is bad, bogue out.
1947      */
1948     if (GetPartName(a_partID, pname))
1949         return (VOLSERILLEGAL_PARTITION);
1950
1951     /*
1952      * Open the directory representing the given AFS parttion.  If we can't
1953      * do that, we lose.
1954      */
1955     if (!(partP = VGetPartition(pname, 0)))
1956         return VOLSERILLEGAL_PARTITION;
1957     dirp = opendir(VPartitionPath(partP));
1958     if (dirp == NULL)
1959         return (VOLSERILLEGAL_PARTITION);
1960
1961     /*
1962      * Sweep through the partition directory, looking for the desired entry.
1963      * First, of course, figure out how many stat bytes to copy out of each
1964      * volume.
1965      */
1966     numStatBytes =
1967         4 * ((2 * VOLINT_STATS_NUM_RWINFO_FIELDS) +
1968              (4 * VOLINT_STATS_NUM_TIME_FIELDS));
1969     strcpy(volname, "");
1970     ttc = (struct volser_trans *)0;     /*No transaction yet */
1971     tv = (Volume *) 0;          /*Volume not yet attached */
1972
1973     while (strcmp(volname, "EOD") && !found) {
1974         /*
1975          * If this is not a volume, move on to the next entry in the
1976          * partition's directory.
1977          */
1978         if (!strcmp(volname, "")) {
1979             GetNextVol(dirp, volname, &currVolID);
1980             continue;
1981         }
1982
1983         if (currVolID == a_volID) {
1984             /*
1985              * We found the volume entry we're interested.  Pull out the
1986              * extended information, remembering to poll (so that the client
1987              * doesn't time out) and to set up a transaction on the volume.
1988              */
1989             found = 1;
1990 #ifndef AFS_PTHREAD_ENV
1991             IOMGR_Poll();
1992 #endif
1993             ttc = NewTrans(currVolID, a_partID);
1994             if (!ttc) {
1995                 /*
1996                  * Couldn't get a transaction on this volume; let our caller
1997                  * know it's busy.
1998                  */
1999                 xInfoP->status = VBUSY;
2000                 xInfoP->volid = currVolID;
2001                 goto drop;
2002             }
2003
2004             /*
2005              * Attach the volume, give up on the volume if we can't.
2006              */
2007             tv = VAttachVolumeByName(&error, pname, volname, V_READONLY);
2008             if (error) {
2009                 xInfoP->status = 0;     /*things are messed up */
2010                 strcpy(xInfoP->name, volname);
2011                 xInfoP->volid = currVolID;
2012                 Log("1 Volser: XListOneVolume: Could not attach volume %u\n",
2013                     currVolID);
2014                 goto drop;
2015             }
2016
2017             /*
2018              * Also bag out on this volume if it's been marked as needing a
2019              * salvage or to-be-destroyed.
2020              */
2021             volDiskDataP = &(tv->header->diskstuff);
2022             if (volDiskDataP->destroyMe == DESTROY_ME) {
2023                 xInfoP->status = 0;
2024                 strcpy(xInfoP->name, volname);
2025                 xInfoP->volid = currVolID;
2026                 Log("1 Volser: XListOneVolume: Volume %u will be destroyed on next salvage\n", currVolID);
2027                 goto drop;
2028             }
2029
2030             if (volDiskDataP->needsSalvaged) {
2031                 xInfoP->status = 0;
2032                 strcpy(xInfoP->name, volname);
2033                 xInfoP->volid = currVolID;
2034                 Log("1 Volser: XListOneVolume: Volume %u needs to be salvaged\n", currVolID);
2035                 goto drop;
2036             }
2037
2038             /*
2039              * Pull out the desired info and stuff it into the area we'll be
2040              * returning to our caller.
2041              */
2042             strcpy(xInfoP->name, volDiskDataP->name);
2043             xInfoP->volid = volDiskDataP->id;
2044             xInfoP->type = volDiskDataP->type;
2045             xInfoP->backupID = volDiskDataP->backupId;
2046             xInfoP->parentID = volDiskDataP->parentId;
2047             xInfoP->cloneID = volDiskDataP->cloneId;
2048             xInfoP->status = VOK;
2049             xInfoP->copyDate = volDiskDataP->copyDate;
2050             xInfoP->inUse = volDiskDataP->inUse;
2051             xInfoP->creationDate = volDiskDataP->creationDate;
2052             xInfoP->accessDate = volDiskDataP->accessDate;
2053             xInfoP->updateDate = volDiskDataP->updateDate;
2054             xInfoP->backupDate = volDiskDataP->backupDate;
2055             now = FT_ApproxTime();
2056             if (now - volDiskDataP->dayUseDate > OneDay)
2057                 xInfoP->dayUse = 0;
2058             else
2059                 xInfoP->dayUse = volDiskDataP->dayUse;
2060             xInfoP->filecount = volDiskDataP->filecount;
2061             xInfoP->maxquota = volDiskDataP->maxquota;
2062             xInfoP->size = volDiskDataP->diskused;
2063
2064             /*
2065              * Copy out the stat fields in a single operation.
2066              */
2067             memcpy((char *)&(xInfoP->stat_reads[0]),
2068                    (char *)&(volDiskDataP->stat_reads[0]), numStatBytes);
2069
2070             /*
2071              * We're done copying.  Detach the volume and iterate (at this
2072              * point, since we found our volume, we'll then drop out of the
2073              * loop).
2074              */
2075             VDetachVolume(&error, tv);
2076             tv = (Volume *) 0;
2077             if (error) {
2078                 xInfoP->status = 0;
2079                 strcpy(xInfoP->name, volname);
2080                 Log("1 Volser: XListOneVolumes Couldn't detach volume %s\n",
2081                     volname);
2082                 goto drop;
2083             }
2084
2085             /*
2086              * At this point, we're golden.
2087              */
2088             code = 0;
2089         }                       /*Found desired volume */
2090         GetNextVol(dirp, volname, &currVolID);
2091     }
2092
2093     /*
2094      * Drop the transaction we have for this volume.
2095      */
2096   drop:
2097     if (tv) {
2098         VDetachVolume(&error, tv);
2099         tv = (Volume *) 0;
2100     }
2101     if (ttc) {
2102         DeleteTrans(ttc, 1);
2103         ttc = (struct volser_trans *)0;
2104     }
2105
2106     /*
2107      * Clean up before going to dinner: close the partition directory,
2108      * return the proper value.
2109      */
2110     closedir(dirp);
2111     return (code);
2112
2113 }                               /*SAFSVolXListOneVolume */
2114
2115 /*returns all the volumes on partition partid. If flags = 1 then all the 
2116 * relevant info about the volumes  is also returned */
2117 afs_int32
2118 SAFSVolListVolumes(struct rx_call *acid, afs_int32 partid, afs_int32 flags, 
2119                    volEntries *volumeInfo)
2120 {
2121     afs_int32 code;
2122
2123     code = VolListVolumes(acid, partid, flags, volumeInfo);
2124     osi_auditU(acid, VS_ListVolEvent, code, AUD_END);
2125     return code;
2126 }
2127
2128 afs_int32
2129 VolListVolumes(struct rx_call *acid, afs_int32 partid, afs_int32 flags, 
2130                    volEntries *volumeInfo)
2131 {
2132     volintInfo *pntr;
2133     register struct Volume *tv;
2134     struct DiskPartition *partP;
2135     struct volser_trans *ttc;
2136     afs_int32 allocSize = 1000; /*to be changed to a larger figure */
2137     char pname[9], volname[20];
2138     afs_int32 error = 0;
2139     DIR *dirp;
2140     afs_int32 volid;
2141     unsigned int now;
2142
2143     volumeInfo->volEntries_val =
2144         (volintInfo *) malloc(allocSize * sizeof(volintInfo));
2145     pntr = volumeInfo->volEntries_val;
2146     volumeInfo->volEntries_len = 0;
2147     if (GetPartName(partid, pname))
2148         return VOLSERILLEGAL_PARTITION;
2149     if (!(partP = VGetPartition(pname, 0)))
2150         return VOLSERILLEGAL_PARTITION;
2151     dirp = opendir(VPartitionPath(partP));
2152     if (dirp == NULL)
2153         return VOLSERILLEGAL_PARTITION;
2154     strcpy(volname, "");
2155     while (strcmp(volname, "EOD")) {    /*while there are more partitions in the partition */
2156         ttc = (struct volser_trans *)0; /* new one for each pass */
2157         tv = (Volume *) 0;      /* volume not attached */
2158
2159         if (!strcmp(volname, "")) {     /* its not a volume, fetch next file */
2160             GetNextVol(dirp, volname, &volid);
2161             continue;           /*back to while loop */
2162         }
2163
2164         if (flags) {            /*copy other things too */
2165 #ifndef AFS_PTHREAD_ENV
2166             IOMGR_Poll();       /*make sure that the client doesnot time out */
2167 #endif
2168             ttc = NewTrans(volid, partid);
2169             if (!ttc) {
2170                 pntr->status = VBUSY;
2171                 pntr->volid = volid;
2172                 goto drop;
2173             }
2174             tv = VAttachVolumeByName(&error, pname, volname, V_READONLY);
2175             if (error) {
2176                 pntr->status = 0;       /*things are messed up */
2177                 strcpy(pntr->name, volname);
2178                 pntr->volid = volid;
2179                 Log("1 Volser: ListVolumes: Could not attach volume %u (%s) error=%d\n", volid, volname, error);
2180                 goto drop;
2181             }
2182             if (tv->header->diskstuff.needsSalvaged) {
2183                 /*this volume will be salvaged */
2184                 pntr->status = 0;
2185                 strcpy(pntr->name, volname);
2186                 pntr->volid = volid;
2187                 Log("1 Volser: ListVolumes: Volume %u (%s) needs to be salvaged\n", volid, volname);
2188                 goto drop;
2189             }
2190
2191             if (tv->header->diskstuff.destroyMe == DESTROY_ME) {
2192                 /*this volume will be salvaged */
2193                 goto drop2;
2194             }
2195             /*read in the relevant info */
2196             pntr->status = VOK; /*its ok */
2197             pntr->volid = tv->header->diskstuff.id;
2198             strcpy(pntr->name, tv->header->diskstuff.name);
2199             pntr->type = tv->header->diskstuff.type;    /*if ro volume */
2200             pntr->cloneID = tv->header->diskstuff.cloneId;      /*if rw volume */
2201             pntr->backupID = tv->header->diskstuff.backupId;
2202             pntr->parentID = tv->header->diskstuff.parentId;
2203             pntr->copyDate = tv->header->diskstuff.copyDate;
2204             pntr->inUse = tv->header->diskstuff.inUse;
2205             pntr->size = tv->header->diskstuff.diskused;
2206             pntr->needsSalvaged = tv->header->diskstuff.needsSalvaged;
2207             pntr->maxquota = tv->header->diskstuff.maxquota;
2208             pntr->filecount = tv->header->diskstuff.filecount;
2209             now = FT_ApproxTime();
2210             if (now - tv->header->diskstuff.dayUseDate > OneDay)
2211                 pntr->dayUse = 0;
2212             else
2213                 pntr->dayUse = tv->header->diskstuff.dayUse;
2214             pntr->creationDate = tv->header->diskstuff.creationDate;
2215             pntr->accessDate = tv->header->diskstuff.accessDate;
2216             pntr->updateDate = tv->header->diskstuff.updateDate;
2217             pntr->backupDate = tv->header->diskstuff.backupDate;
2218             pntr->spare0 = tv->header->diskstuff.minquota;
2219             pntr->spare1 =
2220                 (long)tv->header->diskstuff.weekUse[0] +
2221                 (long)tv->header->diskstuff.weekUse[1] +
2222                 (long)tv->header->diskstuff.weekUse[2] +
2223                 (long)tv->header->diskstuff.weekUse[3] +
2224                 (long)tv->header->diskstuff.weekUse[4] +
2225                 (long)tv->header->diskstuff.weekUse[5] +
2226                 (long)tv->header->diskstuff.weekUse[6];
2227             pntr->flags = pntr->spare2 = pntr->spare3 = (long)0;
2228             VDetachVolume(&error, tv);  /*free the volume */
2229             tv = (Volume *) 0;
2230             if (error) {
2231                 pntr->status = 0;       /*things are messed up */
2232                 strcpy(pntr->name, volname);
2233                 Log("1 Volser: ListVolumes: Could not detach volume %s\n",
2234                     volname);
2235                 goto drop;
2236             }
2237         } else {
2238             pntr->volid = volid;
2239             /*just volids are needed */
2240         }
2241
2242       drop:
2243         if (ttc) {
2244             DeleteTrans(ttc, 1);
2245             ttc = (struct volser_trans *)0;
2246         }
2247         pntr++;
2248         volumeInfo->volEntries_len += 1;
2249         if ((allocSize - volumeInfo->volEntries_len) < 5) {
2250             /*running out of space, allocate more space */
2251             allocSize = (allocSize * 3) / 2;
2252             pntr =
2253                 (volintInfo *) realloc((char *)volumeInfo->volEntries_val,
2254                                        allocSize * sizeof(volintInfo));
2255             if (pntr == NULL) {
2256                 if (tv) {
2257                     VDetachVolume(&error, tv);
2258                     tv = (Volume *) 0;
2259                 }
2260                 if (ttc) {
2261                     DeleteTrans(ttc, 1);
2262                     ttc = (struct volser_trans *)0;
2263                 }
2264                 closedir(dirp);
2265                 return VOLSERNO_MEMORY;
2266             }
2267             volumeInfo->volEntries_val = pntr;  /* point to new block */
2268             /* set pntr to the right position */
2269             pntr = volumeInfo->volEntries_val + volumeInfo->volEntries_len;
2270
2271         }
2272
2273       drop2:
2274         if (tv) {
2275             VDetachVolume(&error, tv);
2276             tv = (Volume *) 0;
2277         }
2278         if (ttc) {
2279             DeleteTrans(ttc, 1);
2280             ttc = (struct volser_trans *)0;
2281         }
2282         GetNextVol(dirp, volname, &volid);
2283
2284     }
2285     closedir(dirp);
2286     if (ttc)
2287         DeleteTrans(ttc, 1);
2288
2289     return 0;
2290 }
2291
2292 /*------------------------------------------------------------------------
2293  * EXPORTED SAFSVolXListVolumes
2294  *
2295  * Description:
2296  *      Returns all the volumes on partition a_partID.  If a_flags
2297  *      is set to 1, then all the relevant extended volume information
2298  *      is also returned.
2299  *
2300  * Arguments:
2301  *      a_rxCidP       : Pointer to the Rx call we're performing.
2302  *      a_partID       : Partition for which we want the extended list.
2303  *      a_flags        : Various flags.
2304  *      a_volumeXInfoP : Ptr to the extended info blob.
2305  *
2306  * Returns:
2307  *      0                       Successful operation
2308  *      VOLSERILLEGAL_PARTITION if we got a bogus partition ID
2309  *      VOLSERNO_MEMORY         if we ran out of memory allocating
2310  *                              our return blob
2311  *
2312  * Environment:
2313  *      Nothing interesting.
2314  *
2315  * Side Effects:
2316  *      As advertised.
2317  *------------------------------------------------------------------------*/
2318
2319 afs_int32
2320 SAFSVolXListVolumes(struct rx_call *a_rxCidP, afs_int32 a_partID,
2321                     afs_int32 a_flags, volXEntries *a_volumeXInfoP)
2322 {
2323     afs_int32 code;
2324
2325     code = VolXListVolumes(a_rxCidP, a_partID, a_flags, a_volumeXInfoP);
2326     osi_auditU(a_rxCidP, VS_XLstVolEvent, code, AUD_END);
2327     return code;
2328 }
2329
2330 afs_int32
2331 VolXListVolumes(struct rx_call *a_rxCidP, afs_int32 a_partID,
2332                     afs_int32 a_flags, volXEntries *a_volumeXInfoP)
2333 {                               /*SAFSVolXListVolumes */
2334
2335     volintXInfo *xInfoP;        /*Ptr to the extended vol info */
2336     register struct Volume *tv; /*Volume ptr */
2337     struct DiskPartition *partP;        /*Ptr to partition */
2338     struct volser_trans *ttc;   /*Volume transaction ptr */
2339     afs_int32 allocSize = 1000; /*To be changed to a larger figure */
2340     char pname[9], volname[20]; /*Partition, volume names */
2341     afs_int32 error = 0;        /*Return code */
2342     DIR *dirp;                  /*Partition directory ptr */
2343     afs_int32 volid;            /*Current volume ID */
2344     struct VolumeDiskData *volDiskDataP;        /*Ptr to on-disk volume data */
2345     int numStatBytes;           /*Num stat bytes to copy per volume */
2346     unsigned int now;
2347
2348     /*
2349      * Allocate a large array of extended volume info structures, then
2350      * set it up for action.
2351      */
2352     a_volumeXInfoP->volXEntries_val =
2353         (volintXInfo *) malloc(allocSize * sizeof(volintXInfo));
2354     xInfoP = a_volumeXInfoP->volXEntries_val;
2355     a_volumeXInfoP->volXEntries_len = 0;
2356
2357     /*
2358      * If the partition name we've been given is bad, bogue out.
2359      */
2360     if (GetPartName(a_partID, pname))
2361         return (VOLSERILLEGAL_PARTITION);
2362
2363     /*
2364      * Open the directory representing the given AFS parttion.  If we can't
2365      * do that, we lose.
2366      */
2367     if (!(partP = VGetPartition(pname, 0)))
2368         return VOLSERILLEGAL_PARTITION;
2369     dirp = opendir(VPartitionPath(partP));
2370     if (dirp == NULL)
2371         return (VOLSERILLEGAL_PARTITION);
2372
2373     /*
2374      * Sweep through the partition directory, acting on each entry.  First,
2375      * of course, figure out how many stat bytes to copy out of each volume.
2376      */
2377     numStatBytes =
2378         4 * ((2 * VOLINT_STATS_NUM_RWINFO_FIELDS) +
2379              (4 * VOLINT_STATS_NUM_TIME_FIELDS));
2380     strcpy(volname, "");
2381     while (strcmp(volname, "EOD")) {
2382         ttc = (struct volser_trans *)0; /*New one for each pass */
2383         tv = (Volume *) 0;      /*Volume not yet attached */
2384
2385         /*
2386          * If this is not a volume, move on to the next entry in the
2387          * partition's directory.
2388          */
2389         if (!strcmp(volname, "")) {
2390             GetNextVol(dirp, volname, &volid);
2391             continue;
2392         }
2393
2394         if (a_flags) {
2395             /*
2396              * Full info about the volume desired.  Poll to make sure the
2397              * client doesn't time out, then start up a new transaction.
2398              */
2399 #ifndef AFS_PTHREAD_ENV
2400             IOMGR_Poll();
2401 #endif
2402             ttc = NewTrans(volid, a_partID);
2403             if (!ttc) {
2404                 /*
2405                  * Couldn't get a transaction on this volume; let our caller
2406                  * know it's busy.
2407                  */
2408                 xInfoP->status = VBUSY;
2409                 xInfoP->volid = volid;
2410                 goto drop;
2411             }
2412
2413             /*
2414              * Attach the volume, give up on this volume if we can't.
2415              */
2416             tv = VAttachVolumeByName(&error, pname, volname, V_READONLY);
2417             if (error) {
2418                 xInfoP->status = 0;     /*things are messed up */
2419                 strcpy(xInfoP->name, volname);
2420                 xInfoP->volid = volid;
2421                 Log("1 Volser: XListVolumes: Could not attach volume %u\n",
2422                     volid);
2423                 goto drop;
2424             }
2425
2426             /*
2427              * Also bag out on this volume if it's been marked as needing a
2428              * salvage or to-be-destroyed.
2429              */
2430             volDiskDataP = &(tv->header->diskstuff);
2431             if (volDiskDataP->needsSalvaged) {
2432                 xInfoP->status = 0;
2433                 strcpy(xInfoP->name, volname);
2434                 xInfoP->volid = volid;
2435                 Log("1 Volser: XListVolumes: Volume %u needs to be salvaged\n", volid);
2436                 goto drop;
2437             }
2438
2439             if (volDiskDataP->destroyMe == DESTROY_ME)
2440                 goto drop2;
2441
2442             /*
2443              * Pull out the desired info and stuff it into the area we'll be
2444              * returning to our caller.
2445              */
2446             strcpy(xInfoP->name, volDiskDataP->name);
2447             xInfoP->volid = volDiskDataP->id;
2448             xInfoP->type = volDiskDataP->type;
2449             xInfoP->backupID = volDiskDataP->backupId;
2450             xInfoP->parentID = volDiskDataP->parentId;
2451             xInfoP->cloneID = volDiskDataP->cloneId;
2452             xInfoP->status = VOK;
2453             xInfoP->copyDate = volDiskDataP->copyDate;
2454             xInfoP->inUse = volDiskDataP->inUse;
2455             xInfoP->creationDate = volDiskDataP->creationDate;
2456             xInfoP->accessDate = volDiskDataP->accessDate;
2457             xInfoP->updateDate = volDiskDataP->updateDate;
2458             xInfoP->backupDate = volDiskDataP->backupDate;
2459             now = FT_ApproxTime();
2460             if (now - volDiskDataP->dayUseDate > OneDay)
2461                 xInfoP->dayUse = 0;
2462             else
2463                 xInfoP->dayUse = volDiskDataP->dayUse;
2464             xInfoP->filecount = volDiskDataP->filecount;
2465             xInfoP->maxquota = volDiskDataP->maxquota;
2466             xInfoP->size = volDiskDataP->diskused;
2467
2468             /*
2469              * Copy out the stat fields in a single operation.
2470              */
2471             memcpy((char *)&(xInfoP->stat_reads[0]),
2472                    (char *)&(volDiskDataP->stat_reads[0]), numStatBytes);
2473
2474             /*
2475              * We're done copying.  Detach the volume and iterate.
2476              */
2477             VDetachVolume(&error, tv);
2478             tv = (Volume *) 0;
2479             if (error) {
2480                 xInfoP->status = 0;
2481                 strcpy(xInfoP->name, volname);
2482                 Log("1 Volser: XListVolumes: Could not detach volume %s\n",
2483                     volname);
2484                 goto drop;
2485             }
2486         } /*Full contents desired */
2487         else
2488             /*
2489              * Just volume IDs are needed.
2490              */
2491             xInfoP->volid = volid;
2492
2493       drop:
2494         /*
2495          * Drop the transaction we have for this volume.
2496          */
2497         if (ttc) {
2498             DeleteTrans(ttc, 1);
2499             ttc = (struct volser_trans *)0;
2500         }
2501
2502         /*
2503          * Bump the pointer in the data area we're building, along with
2504          * the count of the number of entries it contains.
2505          */
2506         xInfoP++;
2507         (a_volumeXInfoP->volXEntries_len)++;
2508         if ((allocSize - a_volumeXInfoP->volXEntries_len) < 5) {
2509             /*
2510              * We're running out of space in the area we've built.  Grow it.
2511              */
2512             allocSize = (allocSize * 3) / 2;
2513             xInfoP = (volintXInfo *)
2514                 realloc((char *)a_volumeXInfoP->volXEntries_val,
2515                         (allocSize * sizeof(volintXInfo)));
2516             if (xInfoP == NULL) {
2517                 /*
2518                  * Bummer, no memory. Bag it, tell our caller what went wrong.
2519                  */
2520                 if (tv) {
2521                     VDetachVolume(&error, tv);
2522                     tv = (Volume *) 0;
2523                 }
2524                 if (ttc) {
2525                     DeleteTrans(ttc, 1);
2526                     ttc = (struct volser_trans *)0;
2527                 }
2528                 closedir(dirp);
2529                 return (VOLSERNO_MEMORY);
2530             }
2531
2532             /*
2533              * Memory reallocation worked.  Correct our pointers so they
2534              * now point to the new block and the current open position within
2535              * the new block.
2536              */
2537             a_volumeXInfoP->volXEntries_val = xInfoP;
2538             xInfoP =
2539                 a_volumeXInfoP->volXEntries_val +
2540                 a_volumeXInfoP->volXEntries_len;
2541         }
2542         /*Need more space */
2543       drop2:
2544         /*
2545          * Detach our current volume and the transaction on it, then move on
2546          * to the next volume in the partition directory.
2547          */
2548         if (tv) {
2549             VDetachVolume(&error, tv);
2550             tv = (Volume *) 0;
2551         }
2552         if (ttc) {
2553             DeleteTrans(ttc, 1);
2554             ttc = (struct volser_trans *)0;
2555         }
2556         GetNextVol(dirp, volname, &volid);
2557     }                           /*Sweep through the partition directory */
2558
2559     /*
2560      * We've examined all entries in the partition directory.  Close it,
2561      * delete our transaction (if any), and go home happy.
2562      */
2563     closedir(dirp);
2564     if (ttc)
2565         DeleteTrans(ttc, 1);
2566     return (0);
2567
2568 }                               /*SAFSVolXListVolumes */
2569
2570 /*this call is used to monitor the status of volser for debugging purposes.
2571  *information about all the active transactions is returned in transInfo*/
2572 afs_int32
2573 SAFSVolMonitor(struct rx_call *acid, transDebugEntries *transInfo)
2574 {
2575     afs_int32 code;
2576
2577     code = VolMonitor(acid, transInfo);
2578     osi_auditU(acid, VS_MonitorEvent, code, AUD_END);
2579     return code;
2580 }
2581
2582 afs_int32
2583 VolMonitor(struct rx_call *acid, transDebugEntries *transInfo)
2584 {
2585     transDebugInfo *pntr;
2586     afs_int32 allocSize = 50;
2587     struct volser_trans *tt, *allTrans;
2588
2589     transInfo->transDebugEntries_val =
2590         (transDebugInfo *) malloc(allocSize * sizeof(transDebugInfo));
2591     pntr = transInfo->transDebugEntries_val;
2592     transInfo->transDebugEntries_len = 0;
2593     allTrans = TransList();
2594     if (allTrans == (struct volser_trans *)0)
2595         return 0;               /*no active transactions */
2596     for (tt = allTrans; tt; tt = tt->next) {    /*copy relevant info into pntr */
2597         pntr->tid = tt->tid;
2598         pntr->time = tt->time;
2599         pntr->creationTime = tt->creationTime;
2600         pntr->returnCode = tt->returnCode;
2601         pntr->volid = tt->volid;
2602         pntr->partition = tt->partition;
2603         pntr->iflags = tt->iflags;
2604         pntr->vflags = tt->vflags;
2605         pntr->tflags = tt->tflags;
2606         strcpy(pntr->lastProcName, tt->lastProcName);
2607         pntr->callValid = 0;
2608         if (tt->rxCallPtr) {    /*record call related info */
2609             pntr->callValid = 1;
2610             pntr->readNext = tt->rxCallPtr->rnext;
2611             pntr->transmitNext = tt->rxCallPtr->tnext;
2612             pntr->lastSendTime = tt->rxCallPtr->lastSendTime;
2613             pntr->lastReceiveTime = tt->rxCallPtr->lastReceiveTime;
2614         }
2615         pntr++;
2616         transInfo->transDebugEntries_len += 1;
2617         if ((allocSize - transInfo->transDebugEntries_len) < 5) {       /*alloc some more space */
2618             allocSize = (allocSize * 3) / 2;
2619             pntr =
2620                 (transDebugInfo *) realloc((char *)transInfo->
2621                                            transDebugEntries_val,
2622                                            allocSize *
2623                                            sizeof(transDebugInfo));
2624             transInfo->transDebugEntries_val = pntr;
2625             pntr =
2626                 transInfo->transDebugEntries_val +
2627                 transInfo->transDebugEntries_len;
2628             /*set pntr to right position */
2629         }
2630
2631     }
2632
2633     return 0;
2634 }
2635
2636 afs_int32
2637 SAFSVolSetIdsTypes(struct rx_call *acid, afs_int32 atid, char name[], afs_int32 type, afs_int32 pId, afs_int32 cloneId, afs_int32 backupId)
2638 {
2639     afs_int32 code;
2640
2641     code = VolSetIdsTypes(acid, atid, name, type, pId, cloneId, backupId);
2642     osi_auditU(acid, VS_SetIdTyEvent, code, AUD_LONG, atid, AUD_STR, name,
2643                AUD_STR, type, AUD_LONG, pId, AUD_LONG, cloneId, AUD_LONG,
2644                backupId, AUD_END);
2645     return code;
2646 }
2647
2648 afs_int32
2649 VolSetIdsTypes(struct rx_call *acid, afs_int32 atid, char name[], afs_int32 type, afs_int32 pId, afs_int32 cloneId, afs_int32 backupId)
2650 {
2651     struct Volume *tv;
2652     afs_int32 error = 0;
2653     register struct volser_trans *tt;
2654     char caller[MAXKTCNAMELEN];
2655
2656     if (strlen(name) > 31)
2657         return VOLSERBADNAME;
2658     if (!afsconf_SuperUser(tdir, acid, caller))
2659         return VOLSERBAD_ACCESS;        /*not a super user */
2660     /* find the trans */
2661     tt = FindTrans(atid);
2662     if (!tt)
2663         return ENOENT;
2664     if (tt->vflags & VTDeleted) {
2665         Log("1 Volser: VolSetIds: volume %u has been deleted \n", tt->volid);
2666         TRELE(tt);
2667         return ENOENT;
2668     }
2669     strcpy(tt->lastProcName, "SetIdsTypes");
2670     tt->rxCallPtr = acid;
2671     tv = tt->volume;
2672
2673     V_type(tv) = type;
2674     V_backupId(tv) = backupId;
2675     V_cloneId(tv) = cloneId;
2676     V_parentId(tv) = pId;
2677     strcpy((&V_disk(tv))->name, name);
2678     VUpdateVolume(&error, tv);
2679     if (error) {
2680         Log("1 Volser: SetIdsTypes: VUpdate failed code %d\n", error);
2681         LogError(error);
2682         goto fail;
2683     }
2684     tt->rxCallPtr = (struct rx_call *)0;
2685     if (TRELE(tt) && !error)
2686         return VOLSERTRELE_ERROR;
2687
2688     return error;
2689   fail:
2690     tt->rxCallPtr = (struct rx_call *)0;
2691     if (TRELE(tt) && !error)
2692         return VOLSERTRELE_ERROR;
2693     return error;
2694 }
2695
2696 afs_int32
2697 SAFSVolSetDate(struct rx_call *acid, afs_int32 atid, afs_int32 cdate)
2698 {
2699     afs_int32 code;
2700
2701     code = VolSetDate(acid, atid, cdate);
2702     osi_auditU(acid, VS_SetDateEvent, code, AUD_LONG, atid, AUD_LONG, cdate,
2703                AUD_END);
2704     return code;
2705 }
2706
2707 afs_int32
2708 VolSetDate(struct rx_call *acid, afs_int32 atid, afs_int32 cdate)
2709 {
2710     struct Volume *tv;
2711     afs_int32 error = 0;
2712     register struct volser_trans *tt;
2713     char caller[MAXKTCNAMELEN];
2714
2715     if (!afsconf_SuperUser(tdir, acid, caller))
2716         return VOLSERBAD_ACCESS;        /*not a super user */
2717     /* find the trans */
2718     tt = FindTrans(atid);
2719     if (!tt)
2720         return ENOENT;
2721     if (tt->vflags & VTDeleted) {
2722         Log("1 Volser: VolSetDate: volume %u has been deleted \n", tt->volid);
2723         TRELE(tt);
2724         return ENOENT;
2725     }
2726     strcpy(tt->lastProcName, "SetDate");
2727     tt->rxCallPtr = acid;
2728     tv = tt->volume;
2729
2730     V_creationDate(tv) = cdate;
2731     VUpdateVolume(&error, tv);
2732     if (error) {
2733         Log("1 Volser: SetDate: VUpdate failed code %d\n", error);
2734         LogError(error);
2735         goto fail;
2736     }
2737     tt->rxCallPtr = (struct rx_call *)0;
2738     if (TRELE(tt) && !error)
2739         return VOLSERTRELE_ERROR;
2740
2741     return error;
2742   fail:
2743     tt->rxCallPtr = (struct rx_call *)0;
2744     if (TRELE(tt) && !error)
2745         return VOLSERTRELE_ERROR;
2746     return error;
2747 }
2748
2749 #ifdef AFS_NAMEI_ENV
2750 /* 
2751  * Inode number format  (from namei_ops.c): 
2752  * low 26 bits - vnode number - all 1's if volume special file.
2753  * next 3 bits - tag
2754  * next 3 bits spare (0's)
2755  * high 32 bits - uniquifier (regular) or type if spare
2756  */
2757 #define NAMEI_VNODEMASK    0x003ffffff
2758 #define NAMEI_TAGMASK      0x7
2759 #define NAMEI_TAGSHIFT     26
2760 #define NAMEI_UNIQMASK     0xffffffff
2761 #define NAMEI_UNIQSHIFT    32
2762 #define NAMEI_INODESPECIAL ((Inode)NAMEI_VNODEMASK)
2763 #define NAMEI_VNODESPECIAL NAMEI_VNODEMASK
2764 #endif /* AFS_NAMEI_ENV */
2765
2766 afs_int32
2767 SAFSVolConvertROtoRWvolume(struct rx_call *acid, afs_int32 partId,
2768                            afs_int32 volumeId)
2769 {
2770 #if defined(AFS_NAMEI_ENV) && !defined(AFS_NT40_ENV)
2771     DIR *dirp;
2772     char pname[16];
2773     char volname[20];
2774     afs_int32 error = 0;
2775     afs_int32 volid;
2776     int found = 0;
2777     char caller[MAXKTCNAMELEN];
2778     char headername[16];
2779     char opath[256];
2780     char npath[256];
2781     struct VolumeDiskHeader h;
2782     int fd;
2783     IHandle_t *ih;
2784     Inode ino;
2785     struct DiskPartition *dp;
2786
2787     if (!afsconf_SuperUser(tdir, acid, caller))
2788         return VOLSERBAD_ACCESS;        /*not a super user */
2789     if (GetPartName(partId, pname))
2790         return VOLSERILLEGAL_PARTITION;
2791     dirp = opendir(pname);
2792     if (dirp == NULL)
2793         return VOLSERILLEGAL_PARTITION;
2794     strcpy(volname, "");
2795
2796     while (strcmp(volname, "EOD") && !found) {  /*while there are more volumes in the partition */
2797         GetNextVol(dirp, volname, &volid);
2798         if (strcmp(volname, "")) {      /* its a volume */
2799             if (volid == volumeId)
2800                 found = 1;
2801         }
2802     }
2803     if (!found)
2804         return ENOENT;
2805     (void)afs_snprintf(headername, sizeof headername, VFORMAT, volumeId);
2806     (void)afs_snprintf(opath, sizeof opath, "%s/%s", pname, headername);
2807     fd = open(opath, O_RDONLY);
2808     if (fd < 0) {
2809         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't open header for RO-volume %lu.\n", volumeId);
2810         return ENOENT;
2811     }
2812     if (read(fd, &h, sizeof(h)) != sizeof(h)) {
2813         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't read header for RO-volume %lu.\n", volumeId);
2814         close(fd);
2815         return EIO;
2816     }
2817     close(fd);
2818     FSYNC_askfs(volumeId, pname, FSYNC_RESTOREVOLUME, 0);
2819
2820     for (dp = DiskPartitionList; dp && strcmp(dp->name, pname);
2821          dp = dp->next);
2822     if (!dp) {
2823         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't find DiskPartition for %s\n", pname);
2824         return EIO;
2825     }
2826     ino = namei_MakeSpecIno(h.parent, VI_LINKTABLE);
2827     IH_INIT(ih, dp->device, h.parent, ino);
2828
2829     error = namei_ConvertROtoRWvolume(ih, volumeId);
2830     if (error)
2831         return error;
2832     h.id = h.parent;
2833     h.volumeInfo_hi = h.id;
2834     h.smallVnodeIndex_hi = h.id;
2835     h.largeVnodeIndex_hi = h.id;
2836     h.linkTable_hi = h.id;
2837     (void)afs_snprintf(headername, sizeof headername, VFORMAT, h.id);
2838     (void)afs_snprintf(npath, sizeof npath, "%s/%s", pname, headername);
2839     fd = open(npath, O_CREAT | O_EXCL | O_RDWR, 0644);
2840     if (fd < 0) {
2841         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't create header for RW-volume %lu.\n", h.id);
2842         return EIO;
2843     }
2844     if (write(fd, &h, sizeof(h)) != sizeof(h)) {
2845         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't write header for RW-volume %lu.\n", h.id);
2846         close(fd);
2847         return EIO;
2848     }
2849     close(fd);
2850     if (unlink(opath) < 0) {
2851         Log("1 SAFS_VolConvertROtoRWvolume: Couldn't unlink RO header, error = %d\n", error);
2852     }
2853     FSYNC_askfs(volumeId, pname, FSYNC_DONE, 0);
2854     FSYNC_askfs(h.id, pname, FSYNC_ON, 0);
2855     return 0;
2856 #else /* AFS_NAMEI_ENV */
2857     return EINVAL;
2858 #endif /* AFS_NAMEI_ENV */
2859 }
2860
2861 afs_int32
2862 SAFSVolGetSize(struct rx_call *acid, afs_int32 fromTrans, afs_int32 fromDate,
2863                register struct volintSize *size)
2864 {
2865     int code = 0;
2866     register struct volser_trans *tt;
2867     char caller[MAXKTCNAMELEN];
2868
2869     if (!afsconf_SuperUser(tdir, acid, caller))
2870         return VOLSERBAD_ACCESS;        /*not a super user */
2871     tt = FindTrans(fromTrans);
2872     if (!tt)
2873         return ENOENT;
2874     if (tt->vflags & VTDeleted) {
2875         TRELE(tt);
2876         return ENOENT;
2877     }
2878     strcpy(tt->lastProcName, "GetSize");
2879     tt->rxCallPtr = acid;
2880     code = SizeDumpVolume(acid, tt->volume, fromDate, 1, size); /* measure volume's data */
2881     tt->rxCallPtr = (struct rx_call *)0;
2882     if (TRELE(tt))
2883         return VOLSERTRELE_ERROR;
2884
2885 /*    osi_auditU(acid, VS_DumpEvent, code, AUD_LONG, fromTrans, AUD_END);  */
2886     return code;
2887 }
2888
2889 /* GetPartName - map partid (a decimal number) into pname (a string)
2890  * Since for NT we actually want to return the drive name, we map through the
2891  * partition struct.
2892  */
2893 static int
2894 GetPartName(afs_int32 partid, char *pname)
2895 {
2896     if (partid < 0)
2897         return -1;
2898     if (partid < 26) {
2899         strcpy(pname, "/vicep");
2900         pname[6] = 'a' + partid;
2901         pname[7] = '\0';
2902         return 0;
2903     } else if (partid < VOLMAXPARTS) {
2904         strcpy(pname, "/vicep");
2905         partid -= 26;
2906         pname[6] = 'a' + (partid / 26);
2907         pname[7] = 'a' + (partid % 26);
2908         pname[8] = '\0';
2909         return 0;
2910     } else
2911         return -1;
2912 }