2 * Copyright 2000, International Business Machines Corporation and others.
5 * This software has been released under the terms of the IBM Public
6 * License. For details, see the LICENSE file in the top-level source
7 * directory or online at http://www.openafs.org/dl/license10.html
10 #include <afsconfig.h>
11 #include <afs/param.h>
15 #ifdef IGNORE_SOME_GCC_WARNINGS
16 # pragma GCC diagnostic warning "-Wimplicit-function-declaration"
20 #include <WINNT/afsreg.h>
24 #include <sys/statfs.h>
31 #include <rx/rx_globals.h>
33 #include <afs/vlserver.h>
34 #include <afs/cellconfig.h>
36 #include <afs/afsutil.h>
38 #include <afs/afsint.h>
43 #include <afs/ihandle.h>
44 #include <afs/vnode.h>
45 #include <afs/volume.h>
46 #include <afs/com_err.h>
50 #include "volser_internal.h"
51 #include "volser_prototypes.h"
52 #include "vsutils_prototypes.h"
53 #include "lockprocs_prototypes.h"
55 #ifdef HAVE_POSIX_REGEX
59 /* Local Prototypes */
60 int PrintDiagnostics(char *astring, afs_int32 acode);
61 int GetVolumeInfo(afs_uint32 volid, afs_uint32 *server, afs_int32 *part,
62 afs_int32 *voltype, struct nvldbentry *rentry);
74 #define COMMONPARMS cmd_Seek(ts, 12);\
75 cmd_AddParm(ts, "-cell", CMD_SINGLE, CMD_OPTIONAL, "cell name");\
76 cmd_AddParm(ts, "-noauth", CMD_FLAG, CMD_OPTIONAL, "don't authenticate");\
77 cmd_AddParm(ts, "-localauth",CMD_FLAG,CMD_OPTIONAL,"use server tickets");\
78 cmd_AddParm(ts, "-verbose", CMD_FLAG, CMD_OPTIONAL, "verbose");\
79 cmd_AddParm(ts, "-encrypt", CMD_FLAG, CMD_OPTIONAL, "encrypt commands");\
80 cmd_AddParm(ts, "-noresolve", CMD_FLAG, CMD_OPTIONAL, "don't resolve addresses"); \
81 cmd_AddParm(ts, "-config", CMD_SINGLE, CMD_OPTIONAL, "config location"); \
83 #define ERROR_EXIT(code) do { \
89 extern struct ubik_client *cstruct;
92 static struct tqHead busyHead, notokHead;
95 qInit(struct tqHead *ahead)
97 memset(ahead, 0, sizeof(struct tqHead));
103 qPut(struct tqHead *ahead, afs_uint32 volid)
107 elem = (struct tqElem *)malloc(sizeof(struct tqElem));
108 elem->next = ahead->next;
116 qGet(struct tqHead *ahead, afs_uint32 *volid)
120 if (ahead->count <= 0)
122 *volid = ahead->next->volid;
124 ahead->next = tmp->next;
130 /* returns 1 if <filename> exists else 0 */
132 FileExists(char *filename)
138 code = usd_Open(filename, USD_OPEN_RDONLY, 0, &ufd);
142 code = USD_IOCTL(ufd, USD_IOCTL_GETSIZE, &size);
150 /* returns 1 if <name> doesnot end in .readonly or .backup, else 0 */
152 VolNameOK(char *name)
157 total = strlen(name);
158 if (!strcmp(&name[total - 9], ".readonly")) {
160 } else if (!strcmp(&name[total - 7], ".backup")) {
167 /* return 1 if name is a number else 0 */
169 IsNumeric(char *name)
178 for (i = 0; i < len; i++) {
179 if (*ptr < '0' || *ptr > '9') {
191 * Parse a server dotted address and return the address in network byte order
194 GetServerNoresolve(char *aname)
200 code = sscanf(aname, "%d.%d.%d.%d", &b1, &b2, &b3, &b4);
202 addr = (b1 << 24) | (b2 << 16) | (b3 << 8) | b4;
203 addr = htonl(addr); /* convert to network byte order */
209 * Parse a server name/address and return the address in network byte order
212 GetServer(char *aname)
215 afs_uint32 addr; /* in network byte order */
217 char hostname[MAXHOSTCHARS];
219 if ((addr = GetServerNoresolve(aname)) == 0) {
220 th = gethostbyname(aname);
223 memcpy(&addr, th->h_addr, sizeof(addr));
226 if (rx_IsLoopbackAddr(ntohl(addr))) { /* local host */
227 code = gethostname(hostname, MAXHOSTCHARS);
230 th = gethostbyname(hostname);
233 memcpy(&addr, th->h_addr, sizeof(addr));
240 GetVolumeType(char *aname)
243 if (!strcmp(aname, "ro"))
245 else if (!strcmp(aname, "rw"))
247 else if (!strcmp(aname, "bk"))
254 IsPartValid(afs_int32 partId, afs_uint32 server, afs_int32 *code)
256 struct partList dummyPartList;
262 *code = UV_ListPartitions(server, &dummyPartList, &cnt);
265 for (i = 0; i < cnt; i++) {
266 if (dummyPartList.partFlags[i] & PARTVALID)
267 if (dummyPartList.partId[i] == partId)
275 /*sends the contents of file associated with <fd> and <blksize> to Rx Stream
276 * associated with <call> */
278 SendFile(usd_handle_t ufd, struct rx_call *call, long blksize)
280 char *buffer = (char *)0;
285 buffer = (char *)malloc(blksize);
287 fprintf(STDERR, "malloc failed\n");
291 while (!error && !done) {
292 #ifndef AFS_NT40_ENV /* NT csn't select on non-socket fd's */
295 FD_SET((intptr_t)(ufd->handle), &in);
296 /* don't timeout if read blocks */
297 #if defined(AFS_PTHREAD_ENV)
298 select(((intptr_t)(ufd->handle)) + 1, &in, 0, 0, 0);
300 IOMGR_Select(((intptr_t)(ufd->handle)) + 1, &in, 0, 0, 0);
303 error = USD_READ(ufd, buffer, blksize, &nbytes);
305 fprintf(STDERR, "File system read failed: %s\n",
306 afs_error_message(error));
313 if (rx_Write(call, buffer, nbytes) != nbytes) {
323 /* function invoked by UV_RestoreVolume, reads the data from rx_trx_stream and
324 * writes it out to the volume. */
326 WriteData(struct rx_call *call, void *rock)
328 char *filename = (char *) rock;
331 afs_int32 error, code;
333 afs_int64 currOffset;
339 if (!filename || !*filename) {
340 usd_StandardInput(&ufd);
344 code = usd_Open(filename, USD_OPEN_RDONLY, 0, &ufd);
347 code = USD_IOCTL(ufd, USD_IOCTL_GETBLKSIZE, &blksize);
350 fprintf(STDERR, "Could not access file '%s': %s\n", filename,
351 afs_error_message(code));
355 /* test if we have a valid dump */
356 USD_SEEK(ufd, 0, SEEK_END, &currOffset);
357 USD_SEEK(ufd, currOffset - sizeof(afs_uint32), SEEK_SET, &currOffset);
358 USD_READ(ufd, (char *)&buffer, sizeof(afs_uint32), &got);
359 if ((got != sizeof(afs_uint32)) || (ntohl(buffer) != DUMPENDMAGIC)) {
360 fprintf(STDERR, "Signature missing from end of file '%s'\n", filename);
364 USD_SEEK(ufd, 0, SEEK_SET, &currOffset);
366 code = SendFile(ufd, call, blksize);
373 code = USD_CLOSE(ufd);
375 fprintf(STDERR, "Could not close dump file %s\n",
376 (filename && *filename) ? filename : "STDOUT");
384 /* Receive data from <call> stream into file associated
385 * with <fd> <blksize>
388 ReceiveFile(usd_handle_t ufd, struct rx_call *call, long blksize)
392 afs_uint32 bytesleft, w;
395 buffer = (char *)malloc(blksize);
397 fprintf(STDERR, "memory allocation failed\n");
401 while ((bytesread = rx_Read(call, buffer, blksize)) > 0) {
402 for (bytesleft = bytesread; bytesleft; bytesleft -= w) {
403 #ifndef AFS_NT40_ENV /* NT csn't select on non-socket fd's */
406 FD_SET((intptr_t)(ufd->handle), &out);
407 /* don't timeout if write blocks */
408 #if defined(AFS_PTHREAD_ENV)
409 select(((intptr_t)(ufd->handle)) + 1, &out, 0, 0, 0);
411 IOMGR_Select(((intptr_t)(ufd->handle)) + 1, 0, &out, 0, 0);
415 USD_WRITE(ufd, &buffer[bytesread - bytesleft], bytesleft, &w);
417 fprintf(STDERR, "File system write failed: %s\n",
418 afs_error_message(error));
431 DumpFunction(struct rx_call *call, void *rock)
433 char *filename = (char *)rock;
434 usd_handle_t ufd; /* default is to stdout */
435 afs_int32 error = 0, code;
440 /* Open the output file */
441 if (!filename || !*filename) {
442 usd_StandardOutput(&ufd);
447 usd_Open(filename, USD_OPEN_CREATE | USD_OPEN_RDWR, 0666, &ufd);
451 code = USD_IOCTL(ufd, USD_IOCTL_SETSIZE, &size);
454 code = USD_IOCTL(ufd, USD_IOCTL_GETBLKSIZE, &blksize);
457 fprintf(STDERR, "Could not create file '%s': %s\n", filename,
458 afs_error_message(code));
459 ERROR_EXIT(VOLSERBADOP);
463 code = ReceiveFile(ufd, call, blksize);
468 /* Close the output file */
470 code = USD_CLOSE(ufd);
472 fprintf(STDERR, "Could not close dump file %s\n",
473 (filename && *filename) ? filename : "STDIN");
483 DisplayFormat(volintInfo *pntr, afs_uint32 server, afs_int32 part,
484 int *totalOK, int *totalNotOK, int *totalBusy, int fast,
485 int longlist, int disp)
491 fprintf(STDOUT, "%-10lu\n", (unsigned long)pntr->volid);
492 } else if (longlist) {
493 if (pntr->status == VOK) {
494 fprintf(STDOUT, "%-32s ", pntr->name);
495 fprintf(STDOUT, "%10lu ", (unsigned long)pntr->volid);
497 fprintf(STDOUT, "RW ");
499 fprintf(STDOUT, "RO ");
501 fprintf(STDOUT, "BK ");
502 fprintf(STDOUT, "%10d K ", pntr->size);
503 if (pntr->inUse == 1) {
504 fprintf(STDOUT, "On-line");
507 fprintf(STDOUT, "Off-line");
510 if (pntr->needsSalvaged == 1)
511 fprintf(STDOUT, "**needs salvage**");
512 fprintf(STDOUT, "\n");
513 MapPartIdIntoName(part, pname);
514 fprintf(STDOUT, " %s %s \n", hostutil_GetNameByINet(server),
516 fprintf(STDOUT, " RWrite %10lu ROnly %10lu Backup %10lu \n",
517 (unsigned long)pntr->parentID,
518 (unsigned long)pntr->cloneID,
519 (unsigned long)pntr->backupID);
520 fprintf(STDOUT, " MaxQuota %10d K \n", pntr->maxquota);
521 t = pntr->creationDate;
522 fprintf(STDOUT, " Creation %s",
525 fprintf(STDOUT, " Copy %s",
528 t = pntr->backupDate;
530 fprintf(STDOUT, " Backup Never\n");
532 fprintf(STDOUT, " Backup %s",
535 t = pntr->accessDate;
537 fprintf(STDOUT, " Last Access %s",
540 t = pntr->updateDate;
542 fprintf(STDOUT, " Last Update Never\n");
544 fprintf(STDOUT, " Last Update %s",
547 " %d accesses in the past day (i.e., vnode references)\n",
549 } else if (pntr->status == VBUSY) {
551 qPut(&busyHead, pntr->volid);
553 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
554 (unsigned long)pntr->volid);
557 qPut(¬okHead, pntr->volid);
559 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
560 (unsigned long)pntr->volid);
562 fprintf(STDOUT, "\n");
563 } else { /* default listing */
564 if (pntr->status == VOK) {
565 fprintf(STDOUT, "%-32s ", pntr->name);
566 fprintf(STDOUT, "%10lu ", (unsigned long)pntr->volid);
568 fprintf(STDOUT, "RW ");
570 fprintf(STDOUT, "RO ");
572 fprintf(STDOUT, "BK ");
573 fprintf(STDOUT, "%10d K ", pntr->size);
574 if (pntr->inUse == 1) {
575 fprintf(STDOUT, "On-line");
578 fprintf(STDOUT, "Off-line");
581 if (pntr->needsSalvaged == 1)
582 fprintf(STDOUT, "**needs salvage**");
583 fprintf(STDOUT, "\n");
584 } else if (pntr->status == VBUSY) {
586 qPut(&busyHead, pntr->volid);
588 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
589 (unsigned long)pntr->volid);
592 qPut(¬okHead, pntr->volid);
594 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
595 (unsigned long)pntr->volid);
600 /*------------------------------------------------------------------------
601 * PRIVATE XDisplayFormat
604 * Display the contents of one extended volume info structure.
607 * a_xInfoP : Ptr to extended volume info struct to print.
608 * a_servID : Server ID to print.
609 * a_partID : Partition ID to print.
610 * a_totalOKP : Ptr to total-OK counter.
611 * a_totalNotOKP : Ptr to total-screwed counter.
612 * a_totalBusyP : Ptr to total-busy counter.
613 * a_fast : Fast listing?
614 * a_int32 : Int32 listing?
615 * a_showProblems : Show volume problems?
621 * Nothing interesting.
625 *------------------------------------------------------------------------*/
628 XDisplayFormat(volintXInfo *a_xInfoP, afs_uint32 a_servID, afs_int32 a_partID,
629 int *a_totalOKP, int *a_totalNotOKP, int *a_totalBusyP,
630 int a_fast, int a_int32, int a_showProblems)
631 { /*XDisplayFormat */
639 fprintf(STDOUT, "%-10lu\n", (unsigned long)a_xInfoP->volid);
640 } else if (a_int32) {
642 * Fully-detailed listing.
644 if (a_xInfoP->status == VOK) {
646 * Volume's status is OK - all the fields are valid.
648 fprintf(STDOUT, "%-32s ", a_xInfoP->name);
649 fprintf(STDOUT, "%10lu ", (unsigned long)a_xInfoP->volid);
650 if (a_xInfoP->type == 0)
651 fprintf(STDOUT, "RW ");
652 if (a_xInfoP->type == 1)
653 fprintf(STDOUT, "RO ");
654 if (a_xInfoP->type == 2)
655 fprintf(STDOUT, "BK ");
656 fprintf(STDOUT, "%10d K used ", a_xInfoP->size);
657 fprintf(STDOUT, "%d files ", a_xInfoP->filecount);
658 if (a_xInfoP->inUse == 1) {
659 fprintf(STDOUT, "On-line");
662 fprintf(STDOUT, "Off-line");
665 fprintf(STDOUT, "\n");
666 MapPartIdIntoName(a_partID, pname);
667 fprintf(STDOUT, " %s %s \n", hostutil_GetNameByINet(a_servID),
669 fprintf(STDOUT, " RWrite %10lu ROnly %10lu Backup %10lu \n",
670 (unsigned long)a_xInfoP->parentID,
671 (unsigned long)a_xInfoP->cloneID,
672 (unsigned long)a_xInfoP->backupID);
673 fprintf(STDOUT, " MaxQuota %10d K \n", a_xInfoP->maxquota);
675 t = a_xInfoP->creationDate;
676 fprintf(STDOUT, " Creation %s",
679 t = a_xInfoP->copyDate;
680 fprintf(STDOUT, " Copy %s",
683 t = a_xInfoP->backupDate;
685 fprintf(STDOUT, " Backup Never\n");
687 fprintf(STDOUT, " Backup %s",
690 t = a_xInfoP->accessDate;
692 fprintf(STDOUT, " Last Access %s",
695 t = a_xInfoP->updateDate;
697 fprintf(STDOUT, " Last Update Never\n");
699 fprintf(STDOUT, " Last Update %s",
702 " %d accesses in the past day (i.e., vnode references)\n",
706 * Print all the read/write and authorship stats.
708 fprintf(STDOUT, "\n Raw Read/Write Stats\n");
710 " |-------------------------------------------|\n");
712 " | Same Network | Diff Network |\n");
714 " |----------|----------|----------|----------|\n");
716 " | Total | Auth | Total | Auth |\n");
718 " |----------|----------|----------|----------|\n");
719 fprintf(STDOUT, "Reads | %8d | %8d | %8d | %8d |\n",
720 a_xInfoP->stat_reads[VOLINT_STATS_SAME_NET],
721 a_xInfoP->stat_reads[VOLINT_STATS_SAME_NET_AUTH],
722 a_xInfoP->stat_reads[VOLINT_STATS_DIFF_NET],
723 a_xInfoP->stat_reads[VOLINT_STATS_DIFF_NET_AUTH]);
724 fprintf(STDOUT, "Writes | %8d | %8d | %8d | %8d |\n",
725 a_xInfoP->stat_writes[VOLINT_STATS_SAME_NET],
726 a_xInfoP->stat_writes[VOLINT_STATS_SAME_NET_AUTH],
727 a_xInfoP->stat_writes[VOLINT_STATS_DIFF_NET],
728 a_xInfoP->stat_writes[VOLINT_STATS_DIFF_NET_AUTH]);
730 " |-------------------------------------------|\n\n");
733 " Writes Affecting Authorship\n");
735 " |-------------------------------------------|\n");
737 " | File Authorship | Directory Authorship|\n");
739 " |----------|----------|----------|----------|\n");
741 " | Same | Diff | Same | Diff |\n");
743 " |----------|----------|----------|----------|\n");
744 fprintf(STDOUT, "0-60 sec | %8d | %8d | %8d | %8d |\n",
745 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_0],
746 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_0],
747 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_0],
748 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_0]);
749 fprintf(STDOUT, "1-10 min | %8d | %8d | %8d | %8d |\n",
750 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_1],
751 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_1],
752 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_1],
753 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_1]);
754 fprintf(STDOUT, "10min-1hr | %8d | %8d | %8d | %8d |\n",
755 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_2],
756 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_2],
757 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_2],
758 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_2]);
759 fprintf(STDOUT, "1hr-1day | %8d | %8d | %8d | %8d |\n",
760 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_3],
761 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_3],
762 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_3],
763 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_3]);
764 fprintf(STDOUT, "1day-1wk | %8d | %8d | %8d | %8d |\n",
765 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_4],
766 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_4],
767 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_4],
768 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_4]);
769 fprintf(STDOUT, "> 1wk | %8d | %8d | %8d | %8d |\n",
770 a_xInfoP->stat_fileSameAuthor[VOLINT_STATS_TIME_IDX_5],
771 a_xInfoP->stat_fileDiffAuthor[VOLINT_STATS_TIME_IDX_5],
772 a_xInfoP->stat_dirSameAuthor[VOLINT_STATS_TIME_IDX_5],
773 a_xInfoP->stat_dirDiffAuthor[VOLINT_STATS_TIME_IDX_5]);
775 " |-------------------------------------------|\n");
776 } /*Volume status OK */
777 else if (a_xInfoP->status == VBUSY) {
779 qPut(&busyHead, a_xInfoP->volid);
781 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
782 (unsigned long)a_xInfoP->volid);
786 qPut(¬okHead, a_xInfoP->volid);
788 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
789 (unsigned long)a_xInfoP->volid);
790 } /*Screwed volume */
791 fprintf(STDOUT, "\n");
797 if (a_xInfoP->status == VOK) {
798 fprintf(STDOUT, "%-32s ", a_xInfoP->name);
799 fprintf(STDOUT, "%10lu ", (unsigned long)a_xInfoP->volid);
800 if (a_xInfoP->type == 0)
801 fprintf(STDOUT, "RW ");
802 if (a_xInfoP->type == 1)
803 fprintf(STDOUT, "RO ");
804 if (a_xInfoP->type == 2)
805 fprintf(STDOUT, "BK ");
806 fprintf(STDOUT, "%10d K ", a_xInfoP->size);
807 if (a_xInfoP->inUse == 1) {
808 fprintf(STDOUT, "On-line");
811 fprintf(STDOUT, "Off-line");
814 fprintf(STDOUT, "\n");
816 else if (a_xInfoP->status == VBUSY) {
818 qPut(&busyHead, a_xInfoP->volid);
820 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
821 (unsigned long)a_xInfoP->volid);
825 qPut(¬okHead, a_xInfoP->volid);
827 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
828 (unsigned long)a_xInfoP->volid);
829 } /*Screwed volume */
830 } /*Default listing */
831 } /*XDisplayFormat */
833 /*------------------------------------------------------------------------
834 * PRIVATE XDisplayFormat2
837 * Display the formated contents of one extended volume info structure.
840 * a_xInfoP : Ptr to extended volume info struct to print.
841 * a_servID : Server ID to print.
842 * a_partID : Partition ID to print.
843 * a_totalOKP : Ptr to total-OK counter.
844 * a_totalNotOKP : Ptr to total-screwed counter.
845 * a_totalBusyP : Ptr to total-busy counter.
846 * a_fast : Fast listing?
847 * a_int32 : Int32 listing?
848 * a_showProblems : Show volume problems?
854 * Nothing interesting.
858 *------------------------------------------------------------------------*/
861 XDisplayFormat2(volintXInfo *a_xInfoP, afs_uint32 a_servID, afs_int32 a_partID,
862 int *a_totalOKP, int *a_totalNotOKP, int *a_totalBusyP,
863 int a_fast, int a_int32, int a_showProblems)
864 { /*XDisplayFormat */
870 fprintf(STDOUT, "vold_id\t%-10lu\n", (unsigned long)a_xInfoP->volid);
871 } else if (a_int32) {
873 * Fully-detailed listing.
875 if (a_xInfoP->status == VOK) {
877 * Volume's status is OK - all the fields are valid.
880 static long server_cache = -1, partition_cache = -1;
881 static char hostname[256], address[32], pname[16];
882 int i,ai[] = {VOLINT_STATS_TIME_IDX_0,VOLINT_STATS_TIME_IDX_1,VOLINT_STATS_TIME_IDX_2,
883 VOLINT_STATS_TIME_IDX_3,VOLINT_STATS_TIME_IDX_4,VOLINT_STATS_TIME_IDX_5};
885 if (a_servID != server_cache) {
889 strcpy(hostname, hostutil_GetNameByINet(a_servID));
890 strcpy(address, inet_ntoa(s));
891 server_cache = a_servID;
893 if (a_partID != partition_cache) {
894 MapPartIdIntoName(a_partID, pname);
895 partition_cache = a_partID;
898 fprintf(STDOUT, "name\t\t%s\n", a_xInfoP->name);
899 fprintf(STDOUT, "id\t\t%lu\n", afs_printable_uint32_lu(a_xInfoP->volid));
900 fprintf(STDOUT, "serv\t\t%s\t%s\n", address, hostname);
901 fprintf(STDOUT, "part\t\t%s\n", pname);
902 fprintf(STDOUT, "status\t\tOK\n");
903 fprintf(STDOUT, "backupID\t%lu\n",
904 afs_printable_uint32_lu(a_xInfoP->backupID));
905 fprintf(STDOUT, "parentID\t%lu\n",
906 afs_printable_uint32_lu(a_xInfoP->parentID));
907 fprintf(STDOUT, "cloneID\t\t%lu\n",
908 afs_printable_uint32_lu(a_xInfoP->cloneID));
909 fprintf(STDOUT, "inUse\t\t%s\n", a_xInfoP->inUse ? "Y" : "N");
910 switch (a_xInfoP->type) {
912 fprintf(STDOUT, "type\t\tRW\n");
915 fprintf(STDOUT, "type\t\tRO\n");
918 fprintf(STDOUT, "type\t\tBK\n");
921 fprintf(STDOUT, "type\t\t?\n");
924 t = a_xInfoP->creationDate;
925 fprintf(STDOUT, "creationDate\t%-9lu\t%s",
926 afs_printable_uint32_lu(a_xInfoP->creationDate),
929 t = a_xInfoP->accessDate;
930 fprintf(STDOUT, "accessDate\t%-9lu\t%s",
931 afs_printable_uint32_lu(a_xInfoP->accessDate),
934 t = a_xInfoP->updateDate;
935 fprintf(STDOUT, "updateDate\t%-9lu\t%s",
936 afs_printable_uint32_lu(a_xInfoP->updateDate),
939 t = a_xInfoP->backupDate;
940 fprintf(STDOUT, "backupDate\t%-9lu\t%s",
941 afs_printable_uint32_lu(a_xInfoP->backupDate),
944 t = a_xInfoP->copyDate;
945 fprintf(STDOUT, "copyDate\t%-9lu\t%s",
946 afs_printable_uint32_lu(a_xInfoP->copyDate),
949 fprintf(STDOUT, "diskused\t%u\n", a_xInfoP->size);
950 fprintf(STDOUT, "maxquota\t%u\n", a_xInfoP->maxquota);
952 fprintf(STDOUT, "filecount\t%u\n", a_xInfoP->filecount);
953 fprintf(STDOUT, "dayUse\t\t%u\n", a_xInfoP->dayUse);
957 fprintf(STDOUT,"reads_same_net\t%8d\n",a_xInfoP->stat_reads[VOLINT_STATS_SAME_NET]);
958 fprintf(STDOUT,"reads_same_net_auth\t%8d\n",a_xInfoP->stat_reads[VOLINT_STATS_SAME_NET_AUTH]);
959 fprintf(STDOUT,"reads_diff_net\t%8d\n",a_xInfoP->stat_reads[VOLINT_STATS_DIFF_NET]);
960 fprintf(STDOUT,"reads_diff_net_auth\t%8d\n",a_xInfoP->stat_reads[VOLINT_STATS_DIFF_NET_AUTH]);
962 fprintf(STDOUT,"writes_same_net\t%8d\n",a_xInfoP->stat_writes[VOLINT_STATS_SAME_NET]);
963 fprintf(STDOUT,"writes_same_net_auth\t%8d\n",a_xInfoP->stat_writes[VOLINT_STATS_SAME_NET_AUTH]);
964 fprintf(STDOUT,"writes_diff_net\t%8d\n",a_xInfoP->stat_writes[VOLINT_STATS_DIFF_NET]);
965 fprintf(STDOUT,"writes_diff_net_auth\t%8d\n",a_xInfoP->stat_writes[VOLINT_STATS_DIFF_NET_AUTH]);
969 fprintf(STDOUT,"file_same_author_idx_%d\t%8d\n",i+1,a_xInfoP->stat_fileSameAuthor[ai[i]]);
970 fprintf(STDOUT,"file_diff_author_idx_%d\t%8d\n",i+1,a_xInfoP->stat_fileDiffAuthor[ai[i]]);
971 fprintf(STDOUT,"dir_same_author_idx_%d\t%8d\n",i+1,a_xInfoP->stat_dirSameAuthor[ai[i]]);
972 fprintf(STDOUT,"dir_dif_author_idx_%d\t%8d\n",i+1,a_xInfoP->stat_dirDiffAuthor[ai[i]]);
975 } /*Volume status OK */
976 else if (a_xInfoP->status == VBUSY) {
978 qPut(&busyHead, a_xInfoP->volid);
980 fprintf(STDOUT, "BUSY_VOL\t%lu\n",
981 (unsigned long)a_xInfoP->volid);
985 qPut(¬okHead, a_xInfoP->volid);
987 fprintf(STDOUT, "COULD_NOT_ATTACH\t%lu\n",
988 (unsigned long)a_xInfoP->volid);
989 } /*Screwed volume */
995 if (a_xInfoP->status == VOK) {
996 fprintf(STDOUT, "name\t%-32s\n", a_xInfoP->name);
997 fprintf(STDOUT, "volID\t%10lu\n", (unsigned long)a_xInfoP->volid);
998 if (a_xInfoP->type == 0)
999 fprintf(STDOUT, "type\tRW\n");
1000 if (a_xInfoP->type == 1)
1001 fprintf(STDOUT, "type\tRO\n");
1002 if (a_xInfoP->type == 2)
1003 fprintf(STDOUT, "type\tBK\n");
1004 fprintf(STDOUT, "size\t%10dK\n", a_xInfoP->size);
1006 fprintf(STDOUT, "inUse\t%d\n",a_xInfoP->inUse);
1007 if (a_xInfoP->inUse == 1)
1013 else if (a_xInfoP->status == VBUSY) {
1015 qPut(&busyHead, a_xInfoP->volid);
1017 fprintf(STDOUT, "VOLUME_BUSY\t%lu\n",
1018 (unsigned long)a_xInfoP->volid);
1022 qPut(¬okHead, a_xInfoP->volid);
1024 fprintf(STDOUT, "COULD_NOT_ATTACH_VOLUME\t%lu\n",
1025 (unsigned long)a_xInfoP->volid);
1026 } /*Screwed volume */
1027 } /*Default listing */
1028 } /*XDisplayFormat */
1031 DisplayFormat2(long server, long partition, volintInfo *pntr)
1033 static long server_cache = -1, partition_cache = -1;
1034 static char hostname[256], address[32], pname[16];
1037 if (server != server_cache) {
1041 strcpy(hostname, hostutil_GetNameByINet(server));
1042 strcpy(address, inet_ntoa(s));
1043 server_cache = server;
1045 if (partition != partition_cache) {
1046 MapPartIdIntoName(partition, pname);
1047 partition_cache = partition;
1050 if (pntr->status == VOK)
1051 fprintf(STDOUT, "name\t\t%s\n", pntr->name);
1053 fprintf(STDOUT, "id\t\t%lu\n",
1054 afs_printable_uint32_lu(pntr->volid));
1055 fprintf(STDOUT, "serv\t\t%s\t%s\n", address, hostname);
1056 fprintf(STDOUT, "part\t\t%s\n", pname);
1057 switch (pntr->status) {
1059 fprintf(STDOUT, "status\t\tOK\n");
1062 fprintf(STDOUT, "status\t\tBUSY\n");
1065 fprintf(STDOUT, "status\t\tUNATTACHABLE\n");
1068 fprintf(STDOUT, "backupID\t%lu\n",
1069 afs_printable_uint32_lu(pntr->backupID));
1070 fprintf(STDOUT, "parentID\t%lu\n",
1071 afs_printable_uint32_lu(pntr->parentID));
1072 fprintf(STDOUT, "cloneID\t\t%lu\n",
1073 afs_printable_uint32_lu(pntr->cloneID));
1074 fprintf(STDOUT, "inUse\t\t%s\n", pntr->inUse ? "Y" : "N");
1075 fprintf(STDOUT, "needsSalvaged\t%s\n", pntr->needsSalvaged ? "Y" : "N");
1076 /* 0xD3 is from afs/volume.h since I had trouble including the file */
1077 fprintf(STDOUT, "destroyMe\t%s\n", pntr->destroyMe == 0xD3 ? "Y" : "N");
1078 switch (pntr->type) {
1080 fprintf(STDOUT, "type\t\tRW\n");
1083 fprintf(STDOUT, "type\t\tRO\n");
1086 fprintf(STDOUT, "type\t\tBK\n");
1089 fprintf(STDOUT, "type\t\t?\n");
1092 t = pntr->creationDate;
1093 fprintf(STDOUT, "creationDate\t%-9lu\t%s",
1094 afs_printable_uint32_lu(pntr->creationDate),
1097 t = pntr->accessDate;
1098 fprintf(STDOUT, "accessDate\t%-9lu\t%s",
1099 afs_printable_uint32_lu(pntr->accessDate),
1102 t = pntr->updateDate;
1103 fprintf(STDOUT, "updateDate\t%-9lu\t%s",
1104 afs_printable_uint32_lu(pntr->updateDate),
1107 t = pntr->backupDate;
1108 fprintf(STDOUT, "backupDate\t%-9lu\t%s",
1109 afs_printable_uint32_lu(pntr->backupDate),
1113 fprintf(STDOUT, "copyDate\t%-9lu\t%s",
1114 afs_printable_uint32_lu(pntr->copyDate),
1117 fprintf(STDOUT, "flags\t\t%#lx\t(Optional)\n",
1118 afs_printable_uint32_lu(pntr->flags));
1119 fprintf(STDOUT, "diskused\t%u\n", pntr->size);
1120 fprintf(STDOUT, "maxquota\t%u\n", pntr->maxquota);
1121 fprintf(STDOUT, "minquota\t%lu\t(Optional)\n",
1122 afs_printable_uint32_lu(pntr->spare0));
1123 fprintf(STDOUT, "filecount\t%u\n", pntr->filecount);
1124 fprintf(STDOUT, "dayUse\t\t%u\n", pntr->dayUse);
1125 fprintf(STDOUT, "weekUse\t\t%lu\t(Optional)\n",
1126 afs_printable_uint32_lu(pntr->spare1));
1127 fprintf(STDOUT, "spare2\t\t%lu\t(Optional)\n",
1128 afs_printable_uint32_lu(pntr->spare2));
1129 fprintf(STDOUT, "spare3\t\t%lu\t(Optional)\n",
1130 afs_printable_uint32_lu(pntr->spare3));
1135 DisplayVolumes2(long server, long partition, volintInfo *pntr, long count)
1139 for (i = 0; i < count; i++) {
1140 fprintf(STDOUT, "BEGIN_OF_ENTRY\n");
1141 DisplayFormat2(server, partition, pntr);
1142 fprintf(STDOUT, "END_OF_ENTRY\n\n");
1149 DisplayVolumes(afs_uint32 server, afs_int32 part, volintInfo *pntr,
1150 afs_int32 count, afs_int32 longlist, afs_int32 fast,
1153 int totalOK, totalNotOK, totalBusy, i;
1154 afs_uint32 volid = 0;
1161 for (i = 0; i < count; i++) {
1162 DisplayFormat(pntr, server, part, &totalOK, &totalNotOK, &totalBusy,
1167 while (busyHead.count) {
1168 qGet(&busyHead, &volid);
1169 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
1170 (unsigned long)volid);
1174 while (notokHead.count) {
1175 qGet(¬okHead, &volid);
1176 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
1177 (unsigned long)volid);
1181 fprintf(STDOUT, "\n");
1184 "Total volumes onLine %d ; Total volumes offLine %d ; Total busy %d\n\n",
1185 totalOK, totalNotOK, totalBusy);
1189 /*------------------------------------------------------------------------
1190 * PRIVATE XDisplayVolumes
1193 * Display extended volume information.
1196 * a_servID : Pointer to the Rx call we're performing.
1197 * a_partID : Partition for which we want the extended list.
1198 * a_xInfoP : Ptr to extended volume info.
1199 * a_count : Number of volume records contained above.
1200 * a_int32 : Int32 listing generated?
1201 * a_fast : Fast listing generated?
1202 * a_quiet : Quiet listing generated?
1208 * Nothing interesting.
1212 *------------------------------------------------------------------------*/
1215 XDisplayVolumes(afs_uint32 a_servID, afs_int32 a_partID, volintXInfo *a_xInfoP,
1216 afs_int32 a_count, afs_int32 a_int32, afs_int32 a_fast,
1218 { /*XDisplayVolumes */
1220 int totalOK; /*Total OK volumes */
1221 int totalNotOK; /*Total screwed volumes */
1222 int totalBusy; /*Total busy volumes */
1223 int i; /*Loop variable */
1224 afs_uint32 volid = 0; /*Current volume ID */
1227 * Initialize counters and (global!!) queues.
1236 * Display each volume in the list.
1238 for (i = 0; i < a_count; i++) {
1239 XDisplayFormat(a_xInfoP, a_servID, a_partID, &totalOK, &totalNotOK,
1240 &totalBusy, a_fast, a_int32, 0);
1245 * If any volumes were found to be busy or screwed, display them.
1248 while (busyHead.count) {
1249 qGet(&busyHead, &volid);
1250 fprintf(STDOUT, "**** Volume %lu is busy ****\n",
1251 (unsigned long)volid);
1255 while (notokHead.count) {
1256 qGet(¬okHead, &volid);
1257 fprintf(STDOUT, "**** Could not attach volume %lu ****\n",
1258 (unsigned long)volid);
1263 fprintf(STDOUT, "\n");
1266 "Total volumes: %d on-line, %d off-line, %d busyd\n\n",
1267 totalOK, totalNotOK, totalBusy);
1271 } /*XDisplayVolumes */
1273 /*------------------------------------------------------------------------
1274 * PRIVATE XDisplayVolumes2
1277 * Display extended formated volume information.
1280 * a_servID : Pointer to the Rx call we're performing.
1281 * a_partID : Partition for which we want the extended list.
1282 * a_xInfoP : Ptr to extended volume info.
1283 * a_count : Number of volume records contained above.
1284 * a_int32 : Int32 listing generated?
1285 * a_fast : Fast listing generated?
1286 * a_quiet : Quiet listing generated?
1292 * Nothing interesting.
1296 *------------------------------------------------------------------------*/
1299 XDisplayVolumes2(afs_uint32 a_servID, afs_int32 a_partID, volintXInfo *a_xInfoP,
1300 afs_int32 a_count, afs_int32 a_int32, afs_int32 a_fast,
1302 { /*XDisplayVolumes */
1304 int totalOK; /*Total OK volumes */
1305 int totalNotOK; /*Total screwed volumes */
1306 int totalBusy; /*Total busy volumes */
1307 int i; /*Loop variable */
1308 afs_uint32 volid = 0; /*Current volume ID */
1311 * Initialize counters and (global!!) queues.
1320 * Display each volume in the list.
1322 for (i = 0; i < a_count; i++) {
1323 fprintf(STDOUT, "BEGIN_OF_ENTRY\n");
1324 XDisplayFormat2(a_xInfoP, a_servID, a_partID, &totalOK, &totalNotOK,
1325 &totalBusy, a_fast, a_int32, 0);
1326 fprintf(STDOUT, "END_OF_ENTRY\n");
1331 * If any volumes were found to be busy or screwed, display them.
1334 while (busyHead.count) {
1335 qGet(&busyHead, &volid);
1336 fprintf(STDOUT, "BUSY_VOL\t%lu\n",
1337 (unsigned long)volid);
1341 while (notokHead.count) {
1342 qGet(¬okHead, &volid);
1343 fprintf(STDOUT, "COULD_NOT_ATTACH\t%lu\n",
1344 (unsigned long)volid);
1349 fprintf(STDOUT, "\n");
1352 "VOLUMES_ONLINE\t%d\nVOLUMES_OFFLINE\t%d\nVOLUMES_BUSY\t%d\n",
1353 totalOK, totalNotOK, totalBusy);
1357 } /*XDisplayVolumes2 */
1360 /* set <server> and <part> to the correct values depending on
1361 * <voltype> and <entry> */
1363 GetServerAndPart(struct nvldbentry *entry, int voltype, afs_uint32 *server,
1364 afs_int32 *part, int *previdx)
1366 int i, istart, vtype;
1371 /* Doesn't check for non-existance of backup volume */
1372 if ((voltype == RWVOL) || (voltype == BACKVOL)) {
1374 istart = 0; /* seach the entire entry */
1377 /* Seach from beginning of entry or pick up where we left off */
1378 istart = ((*previdx < 0) ? 0 : *previdx + 1);
1381 for (i = istart; i < entry->nServers; i++) {
1382 if (entry->serverFlags[i] & vtype) {
1383 *server = entry->serverNumber[i];
1384 *part = entry->serverPartition[i];
1390 /* Didn't find any, return -1 */
1396 PrintLocked(afs_int32 aflags)
1398 afs_int32 flags = aflags & VLOP_ALLOPERS;
1401 fprintf(STDOUT, " Volume is currently LOCKED \n");
1403 if (flags & VLOP_MOVE) {
1404 fprintf(STDOUT, " Volume is locked for a move operation\n");
1406 if (flags & VLOP_RELEASE) {
1407 fprintf(STDOUT, " Volume is locked for a release operation\n");
1409 if (flags & VLOP_BACKUP) {
1410 fprintf(STDOUT, " Volume is locked for a backup operation\n");
1412 if (flags & VLOP_DELETE) {
1413 fprintf(STDOUT, " Volume is locked for a delete/misc operation\n");
1415 if (flags & VLOP_DUMP) {
1416 fprintf(STDOUT, " Volume is locked for a dump/restore operation\n");
1422 PostVolumeStats(struct nvldbentry *entry)
1424 SubEnumerateEntry(entry);
1425 /* Check for VLOP_ALLOPERS */
1426 PrintLocked(entry->flags);
1430 /*------------------------------------------------------------------------
1431 * PRIVATE XVolumeStats
1434 * Display extended volume information.
1437 * a_xInfoP : Ptr to extended volume info.
1438 * a_entryP : Ptr to the volume's VLDB entry.
1439 * a_srvID : Server ID.
1440 * a_partID : Partition ID.
1441 * a_volType : Type of volume to print.
1447 * Nothing interesting.
1451 *------------------------------------------------------------------------*/
1454 XVolumeStats(volintXInfo *a_xInfoP, struct nvldbentry *a_entryP,
1455 afs_int32 a_srvID, afs_int32 a_partID, int a_volType)
1458 int totalOK, totalNotOK, totalBusy; /*Dummies - we don't really count here */
1460 XDisplayFormat(a_xInfoP, /*Ptr to extended volume info */
1461 a_srvID, /*Server ID to print */
1462 a_partID, /*Partition ID to print */
1463 &totalOK, /*Ptr to total-OK counter */
1464 &totalNotOK, /*Ptr to total-screwed counter */
1465 &totalBusy, /*Ptr to total-busy counter */
1466 0, /*Don't do a fast listing */
1467 1, /*Do a long listing */
1468 1); /*Show volume problems */
1474 VolumeStats_int(volintInfo *pntr, struct nvldbentry *entry, afs_uint32 server,
1475 afs_int32 part, int voltype)
1477 int totalOK, totalNotOK, totalBusy;
1479 DisplayFormat(pntr, server, part, &totalOK, &totalNotOK, &totalBusy, 0, 1,
1484 /* command to forcibly remove a volume */
1486 NukeVolume(struct cmd_syndesc *as)
1495 server = GetServer(tp = as->parms[0].items->data);
1497 fprintf(STDERR, "vos: server '%s' not found in host table\n", tp);
1501 partID = volutil_GetPartitionID(tp = as->parms[1].items->data);
1503 fprintf(STDERR, "vos: could not parse '%s' as a partition name", tp);
1507 volID = vsu_GetVolumeID(tp = as->parms[2].items->data, cstruct, &err);
1510 PrintError("", err);
1513 "vos: could not parse '%s' as a numeric volume ID", tp);
1518 "vos: forcibly removing all traces of volume %d, please wait...",
1521 code = UV_NukeVolume(server, partID, volID);
1523 fprintf(STDOUT, "done.\n");
1525 fprintf(STDOUT, "failed with code %d.\n", code);
1530 /*------------------------------------------------------------------------
1531 * PRIVATE ExamineVolume
1534 * Routine used to examine a single volume, contacting the VLDB as
1535 * well as the Volume Server.
1538 * as : Ptr to parsed command line arguments.
1541 * 0 for a successful operation,
1542 * Otherwise, one of the ubik or VolServer error values.
1545 * Nothing interesting.
1549 *------------------------------------------------------------------------
1552 ExamineVolume(struct cmd_syndesc *as, void *arock)
1554 struct nvldbentry entry;
1555 afs_int32 vcode = 0;
1556 volintInfo *pntr = (volintInfo *) 0;
1557 volintXInfo *xInfoP = (volintXInfo *) 0;
1559 afs_int32 code, err, error = 0;
1560 int voltype, foundserv = 0, foundentry = 0;
1564 int wantExtendedInfo; /*Do we want extended vol info? */
1565 int isSubEnum=0; /* Keep track whether sub enumerate called. */
1566 wantExtendedInfo = (as->parms[1].items ? 1 : 0); /* -extended */
1568 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err); /* -id */
1571 PrintError("", err);
1573 fprintf(STDERR, "Unknown volume ID or name '%s'\n",
1574 as->parms[0].items->data);
1579 fprintf(STDOUT, "Fetching VLDB entry for %lu .. ",
1580 (unsigned long)volid);
1583 vcode = VLDB_GetEntryByID(volid, -1, &entry);
1586 "Could not fetch the entry for volume number %lu from VLDB \n",
1587 (unsigned long)volid);
1591 fprintf(STDOUT, "done\n");
1592 MapHostToNetwork(&entry);
1594 if (entry.volumeId[RWVOL] == volid)
1596 else if (entry.volumeId[BACKVOL] == volid)
1598 else /* (entry.volumeId[ROVOL] == volid) */
1601 do { /* do {...} while (voltype == ROVOL) */
1602 /* Get the entry for the volume. If its a RW vol, get the RW entry.
1603 * It its a BK vol, get the RW entry (even if VLDB may say the BK doen't exist).
1604 * If its a RO vol, get the next RO entry.
1606 GetServerAndPart(&entry, ((voltype == ROVOL) ? ROVOL : RWVOL),
1607 &aserver, &apart, &previdx);
1608 if (previdx == -1) { /* searched all entries */
1610 fprintf(STDERR, "Volume %s does not exist in VLDB\n\n",
1611 as->parms[0].items->data);
1618 /* Get information about the volume from the server */
1620 fprintf(STDOUT, "Getting volume listing from the server %s .. ",
1621 hostutil_GetNameByINet(aserver));
1624 if (wantExtendedInfo)
1625 code = UV_XListOneVolume(aserver, apart, volid, &xInfoP);
1627 code = UV_ListOneVolume(aserver, apart, volid, &pntr);
1629 fprintf(STDOUT, "done\n");
1633 if (code == ENODEV) {
1634 if ((voltype == BACKVOL) && !(entry.flags & BACK_EXISTS)) {
1635 /* The VLDB says there is no backup volume and its not on disk */
1636 fprintf(STDERR, "Volume %s does not exist\n",
1637 as->parms[0].items->data);
1641 "Volume does not exist on server %s as indicated by the VLDB\n",
1642 hostutil_GetNameByINet(aserver));
1645 PrintDiagnostics("examine", code);
1647 fprintf(STDOUT, "\n");
1650 if (wantExtendedInfo)
1651 XVolumeStats(xInfoP, &entry, aserver, apart, voltype);
1652 else if (as->parms[2].items) {
1653 DisplayFormat2(aserver, apart, pntr);
1654 EnumerateEntry(&entry);
1657 VolumeStats_int(pntr, &entry, aserver, apart, voltype);
1659 if ((voltype == BACKVOL) && !(entry.flags & BACK_EXISTS)) {
1660 /* The VLDB says there is no backup volume yet we found one on disk */
1661 fprintf(STDERR, "Volume %s does not exist in VLDB\n",
1662 as->parms[0].items->data);
1671 } while (voltype == ROVOL);
1674 fprintf(STDERR, "Dump only information from VLDB\n\n");
1675 fprintf(STDOUT, "%s \n", entry.name); /* PostVolumeStats doesn't print name */
1679 PostVolumeStats(&entry);
1684 /*------------------------------------------------------------------------
1688 * Routine used to change the status of a single volume.
1691 * as : Ptr to parsed command line arguments.
1694 * 0 for a successful operation,
1695 * Otherwise, one of the ubik or VolServer error values.
1698 * Nothing interesting.
1702 *------------------------------------------------------------------------
1705 SetFields(struct cmd_syndesc *as, void *arock)
1707 struct nvldbentry entry;
1710 afs_int32 code, err;
1715 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err); /* -id */
1718 PrintError("", err);
1720 fprintf(STDERR, "Unknown volume ID or name '%s'\n",
1721 as->parms[0].items->data);
1725 code = VLDB_GetEntryByID(volid, RWVOL, &entry);
1728 "Could not fetch the entry for volume number %lu from VLDB \n",
1729 (unsigned long)volid);
1732 MapHostToNetwork(&entry);
1734 GetServerAndPart(&entry, RWVOL, &aserver, &apart, &previdx);
1735 if (previdx == -1) {
1736 fprintf(STDERR, "Volume %s does not exist in VLDB\n\n",
1737 as->parms[0].items->data);
1741 init_volintInfo(&info);
1745 if (as->parms[1].items) {
1747 code = util_GetHumanInt32(as->parms[1].items->data, &info.maxquota);
1749 fprintf(STDERR, "invalid quota value\n");
1753 if (as->parms[2].items) {
1757 if (as->parms[3].items) {
1758 /* -clearVolUpCounter */
1761 code = UV_SetVolumeInfo(aserver, apart, volid, &info);
1764 "Could not update volume info fields for volume number %lu\n",
1765 (unsigned long)volid);
1769 /*------------------------------------------------------------------------
1773 * Brings a volume online.
1776 * as : Ptr to parsed command line arguments.
1779 * 0 for a successful operation,
1782 * Nothing interesting.
1786 *------------------------------------------------------------------------
1789 volOnline(struct cmd_syndesc *as, void *arock)
1792 afs_int32 partition;
1794 afs_int32 code, err = 0;
1796 server = GetServer(as->parms[0].items->data);
1798 fprintf(STDERR, "vos: server '%s' not found in host table\n",
1799 as->parms[0].items->data);
1803 partition = volutil_GetPartitionID(as->parms[1].items->data);
1804 if (partition < 0) {
1805 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
1806 as->parms[1].items->data);
1810 volid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &err); /* -id */
1813 PrintError("", err);
1815 fprintf(STDERR, "Unknown volume ID or name '%s'\n",
1816 as->parms[0].items->data);
1820 code = UV_SetVolume(server, partition, volid, ITOffline, 0 /*online */ ,
1823 fprintf(STDERR, "Failed to set volume. Code = %d\n", code);
1830 /*------------------------------------------------------------------------
1831 * PRIVATE volOffline
1834 * Brings a volume offline.
1837 * as : Ptr to parsed command line arguments.
1840 * 0 for a successful operation,
1843 * Nothing interesting.
1847 *------------------------------------------------------------------------
1850 volOffline(struct cmd_syndesc *as, void *arock)
1853 afs_int32 partition;
1855 afs_int32 code, err = 0;
1856 afs_int32 transflag, sleeptime, transdone;
1858 server = GetServer(as->parms[0].items->data);
1860 fprintf(STDERR, "vos: server '%s' not found in host table\n",
1861 as->parms[0].items->data);
1865 partition = volutil_GetPartitionID(as->parms[1].items->data);
1866 if (partition < 0) {
1867 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
1868 as->parms[1].items->data);
1872 volid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &err); /* -id */
1875 PrintError("", err);
1877 fprintf(STDERR, "Unknown volume ID or name '%s'\n",
1878 as->parms[0].items->data);
1882 transflag = (as->parms[4].items ? ITBusy : ITOffline);
1883 sleeptime = (as->parms[3].items ? atol(as->parms[3].items->data) : 0);
1884 transdone = (sleeptime ? 0 /*online */ : VTOutOfService);
1885 if (as->parms[4].items && !as->parms[3].items) {
1886 fprintf(STDERR, "-sleep option must be used with -busy flag\n");
1891 UV_SetVolume(server, partition, volid, transflag, transdone,
1894 fprintf(STDERR, "Failed to set volume. Code = %d\n", code);
1902 CreateVolume(struct cmd_syndesc *as, void *arock)
1906 afs_uint32 volid = 0, rovolid = 0, bkvolid = 0;
1907 afs_uint32 *arovolid;
1909 struct nvldbentry entry;
1914 arovolid = &rovolid;
1917 tserver = GetServer(as->parms[0].items->data);
1919 fprintf(STDERR, "vos: host '%s' not found in host table\n",
1920 as->parms[0].items->data);
1923 pnum = volutil_GetPartitionID(as->parms[1].items->data);
1925 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
1926 as->parms[1].items->data);
1929 if (!IsPartValid(pnum, tserver, &code)) { /*check for validity of the partition */
1931 PrintError("", code);
1934 "vos : partition %s does not exist on the server\n",
1935 as->parms[1].items->data);
1938 if (!ISNAMEVALID(as->parms[2].items->data)) {
1940 "vos: the name of the root volume %s exceeds the size limit of %d\n",
1941 as->parms[2].items->data, VOLSER_OLDMAXVOLNAME - 10);
1944 if (!VolNameOK(as->parms[2].items->data)) {
1946 "Illegal volume name %s, should not end in .readonly or .backup\n",
1947 as->parms[2].items->data);
1950 if (IsNumeric(as->parms[2].items->data)) {
1951 fprintf(STDERR, "Illegal volume name %s, should not be a number\n",
1952 as->parms[2].items->data);
1955 vcode = VLDB_GetEntryByName(as->parms[2].items->data, &entry);
1957 fprintf(STDERR, "Volume %s already exists\n",
1958 as->parms[2].items->data);
1959 PrintDiagnostics("create", code);
1963 if (as->parms[3].items) {
1964 code = util_GetHumanInt32(as->parms[3].items->data, "a);
1966 fprintf(STDERR, "vos: bad integer specified for quota.\n");
1971 if (as->parms[4].items) {
1972 if (!IsNumeric(as->parms[4].items->data)) {
1973 fprintf(STDERR, "vos: Given volume ID %s should be numeric.\n",
1974 as->parms[4].items->data);
1978 code = util_GetUInt32(as->parms[4].items->data, &volid);
1980 fprintf(STDERR, "vos: bad integer specified for volume ID.\n");
1985 if (as->parms[5].items) {
1986 if (!IsNumeric(as->parms[5].items->data)) {
1987 fprintf(STDERR, "vos: Given RO volume ID %s should be numeric.\n",
1988 as->parms[5].items->data);
1992 code = util_GetUInt32(as->parms[5].items->data, &rovolid);
1994 fprintf(STDERR, "vos: bad integer specified for volume ID.\n");
2004 UV_CreateVolume3(tserver, pnum, as->parms[2].items->data, quota, 0,
2005 0, 0, 0, &volid, arovolid, &bkvolid);
2007 PrintDiagnostics("create", code);
2010 MapPartIdIntoName(pnum, part);
2011 fprintf(STDOUT, "Volume %lu created on partition %s of %s\n",
2012 (unsigned long)volid, part, as->parms[0].items->data);
2019 DeleteAll(struct nvldbentry *entry)
2022 afs_int32 error, code, curserver, curpart;
2025 MapHostToNetwork(entry);
2027 for (i = 0; i < entry->nServers; i++) {
2028 curserver = entry->serverNumber[i];
2029 curpart = entry->serverPartition[i];
2030 if (entry->serverFlags[i] & ITSROVOL) {
2031 volid = entry->volumeId[ROVOL];
2033 volid = entry->volumeId[RWVOL];
2035 code = UV_DeleteVolume(curserver, curpart, volid);
2044 DeleteVolume(struct cmd_syndesc *as, void *arock)
2046 afs_int32 err, code = 0;
2047 afs_uint32 server = 0;
2048 afs_int32 partition = -1;
2053 if (as->parms[0].items) {
2054 server = GetServer(as->parms[0].items->data);
2056 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2057 as->parms[0].items->data);
2062 if (as->parms[1].items) {
2063 partition = volutil_GetPartitionID(as->parms[1].items->data);
2064 if (partition < 0) {
2065 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2066 as->parms[1].items->data);
2070 /* Check for validity of the partition */
2071 if (!IsPartValid(partition, server, &code)) {
2073 PrintError("", code);
2076 "vos : partition %s does not exist on the server\n",
2077 as->parms[1].items->data);
2083 volid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &err);
2085 fprintf(STDERR, "Can't find volume name '%s' in VLDB\n",
2086 as->parms[2].items->data);
2088 PrintError("", err);
2092 /* If the server or partition option are not complete, try to fill
2093 * them in from the VLDB entry.
2095 if ((partition == -1) || !server) {
2096 struct nvldbentry entry;
2098 code = VLDB_GetEntryByID(volid, -1, &entry);
2101 "Could not fetch the entry for volume %lu from VLDB\n",
2102 (unsigned long)volid);
2103 PrintError("", code);
2107 if (((volid == entry.volumeId[RWVOL]) && (entry.flags & RW_EXISTS))
2108 || ((volid == entry.volumeId[BACKVOL])
2109 && (entry.flags & BACK_EXISTS))) {
2110 idx = Lp_GetRwIndex(&entry);
2111 if ((idx == -1) || (server && (server != entry.serverNumber[idx]))
2112 || ((partition != -1)
2113 && (partition != entry.serverPartition[idx]))) {
2114 fprintf(STDERR, "VLDB: Volume '%s' no match\n",
2115 as->parms[2].items->data);
2118 } else if ((volid == entry.volumeId[ROVOL])
2119 && (entry.flags & RO_EXISTS)) {
2120 for (idx = -1, j = 0; j < entry.nServers; j++) {
2121 if (entry.serverFlags[j] != ITSROVOL)
2124 if (((server == 0) || (server == entry.serverNumber[j]))
2125 && ((partition == -1)
2126 || (partition == entry.serverPartition[j]))) {
2129 "VLDB: Volume '%s' matches more than one RO\n",
2130 as->parms[2].items->data);
2137 fprintf(STDERR, "VLDB: Volume '%s' no match\n",
2138 as->parms[2].items->data);
2142 fprintf(STDERR, "VLDB: Volume '%s' no match\n",
2143 as->parms[2].items->data);
2147 server = htonl(entry.serverNumber[idx]);
2148 partition = entry.serverPartition[idx];
2152 code = UV_DeleteVolume(server, partition, volid);
2154 PrintDiagnostics("remove", code);
2158 MapPartIdIntoName(partition, pname);
2159 fprintf(STDOUT, "Volume %lu on partition %s server %s deleted\n",
2160 (unsigned long)volid, pname, hostutil_GetNameByINet(server));
2164 #define TESTM 0 /* set for move space tests, clear for production */
2166 MoveVolume(struct cmd_syndesc *as, void *arock)
2170 afs_uint32 fromserver, toserver;
2171 afs_int32 frompart, topart;
2172 afs_int32 flags, code, err;
2173 char fromPartName[10], toPartName[10];
2175 struct diskPartition64 partition; /* for space check */
2178 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2181 PrintError("", err);
2183 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2184 as->parms[0].items->data);
2187 fromserver = GetServer(as->parms[1].items->data);
2188 if (fromserver == 0) {
2189 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2190 as->parms[1].items->data);
2193 toserver = GetServer(as->parms[3].items->data);
2194 if (toserver == 0) {
2195 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2196 as->parms[3].items->data);
2199 frompart = volutil_GetPartitionID(as->parms[2].items->data);
2201 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2202 as->parms[2].items->data);
2205 if (!IsPartValid(frompart, fromserver, &code)) { /*check for validity of the partition */
2207 PrintError("", code);
2210 "vos : partition %s does not exist on the server\n",
2211 as->parms[2].items->data);
2214 topart = volutil_GetPartitionID(as->parms[4].items->data);
2216 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2217 as->parms[4].items->data);
2220 if (!IsPartValid(topart, toserver, &code)) { /*check for validity of the partition */
2222 PrintError("", code);
2225 "vos : partition %s does not exist on the server\n",
2226 as->parms[4].items->data);
2231 if (as->parms[5].items) flags |= RV_NOCLONE;
2234 * check source partition for space to clone volume
2237 MapPartIdIntoName(topart, toPartName);
2238 MapPartIdIntoName(frompart, fromPartName);
2241 * check target partition for space to move volume
2244 code = UV_PartitionInfo64(toserver, toPartName, &partition);
2246 fprintf(STDERR, "vos: cannot access partition %s\n", toPartName);
2250 fprintf(STDOUT, "target partition %s free space %" AFS_INT64_FMT "\n", toPartName,
2253 p = (volintInfo *) 0;
2254 code = UV_ListOneVolume(fromserver, frompart, volid, &p);
2256 fprintf(STDERR, "vos:cannot access volume %lu\n",
2257 (unsigned long)volid);
2261 fprintf(STDOUT, "volume %lu size %d\n", (unsigned long)volid,
2263 if (partition.free <= p->size) {
2265 "vos: no space on target partition %s to move volume %lu\n",
2266 toPartName, (unsigned long)volid);
2273 fprintf(STDOUT, "size test - don't do move\n");
2277 /* successful move still not guaranteed but shoot for it */
2280 UV_MoveVolume2(volid, fromserver, frompart, toserver, topart, flags);
2282 PrintDiagnostics("move", code);
2285 MapPartIdIntoName(topart, toPartName);
2286 MapPartIdIntoName(frompart, fromPartName);
2287 fprintf(STDOUT, "Volume %lu moved from %s %s to %s %s \n",
2288 (unsigned long)volid, as->parms[1].items->data, fromPartName,
2289 as->parms[3].items->data, toPartName);
2295 CopyVolume(struct cmd_syndesc *as, void *arock)
2298 afs_uint32 fromserver, toserver;
2299 afs_int32 frompart, topart, code, err, flags;
2300 char fromPartName[10], toPartName[10], *tovolume;
2301 struct nvldbentry entry;
2302 struct diskPartition64 partition; /* for space check */
2305 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2308 PrintError("", err);
2310 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2311 as->parms[0].items->data);
2314 fromserver = GetServer(as->parms[1].items->data);
2315 if (fromserver == 0) {
2316 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2317 as->parms[1].items->data);
2321 toserver = GetServer(as->parms[4].items->data);
2322 if (toserver == 0) {
2323 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2324 as->parms[4].items->data);
2328 tovolume = as->parms[3].items->data;
2329 if (!ISNAMEVALID(tovolume)) {
2331 "vos: the name of the root volume %s exceeds the size limit of %d\n",
2332 tovolume, VOLSER_OLDMAXVOLNAME - 10);
2335 if (!VolNameOK(tovolume)) {
2337 "Illegal volume name %s, should not end in .readonly or .backup\n",
2341 if (IsNumeric(tovolume)) {
2342 fprintf(STDERR, "Illegal volume name %s, should not be a number\n",
2346 code = VLDB_GetEntryByName(tovolume, &entry);
2348 fprintf(STDERR, "Volume %s already exists\n", tovolume);
2349 PrintDiagnostics("copy", code);
2353 frompart = volutil_GetPartitionID(as->parms[2].items->data);
2355 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2356 as->parms[2].items->data);
2359 if (!IsPartValid(frompart, fromserver, &code)) { /*check for validity of the partition */
2361 PrintError("", code);
2364 "vos : partition %s does not exist on the server\n",
2365 as->parms[2].items->data);
2369 topart = volutil_GetPartitionID(as->parms[5].items->data);
2371 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2372 as->parms[5].items->data);
2375 if (!IsPartValid(topart, toserver, &code)) { /*check for validity of the partition */
2377 PrintError("", code);
2380 "vos : partition %s does not exist on the server\n",
2381 as->parms[5].items->data);
2386 if (as->parms[6].items) flags |= RV_OFFLINE;
2387 if (as->parms[7].items) flags |= RV_RDONLY;
2388 if (as->parms[8].items) flags |= RV_NOCLONE;
2390 MapPartIdIntoName(topart, toPartName);
2391 MapPartIdIntoName(frompart, fromPartName);
2394 * check target partition for space to move volume
2397 code = UV_PartitionInfo64(toserver, toPartName, &partition);
2399 fprintf(STDERR, "vos: cannot access partition %s\n", toPartName);
2403 fprintf(STDOUT, "target partition %s free space %" AFS_INT64_FMT "\n", toPartName,
2406 p = (volintInfo *) 0;
2407 code = UV_ListOneVolume(fromserver, frompart, volid, &p);
2409 fprintf(STDERR, "vos:cannot access volume %lu\n",
2410 (unsigned long)volid);
2414 if (partition.free <= p->size) {
2416 "vos: no space on target partition %s to copy volume %lu\n",
2417 toPartName, (unsigned long)volid);
2423 /* successful copy still not guaranteed but shoot for it */
2426 UV_CopyVolume2(volid, fromserver, frompart, tovolume, toserver,
2429 PrintDiagnostics("copy", code);
2432 MapPartIdIntoName(topart, toPartName);
2433 MapPartIdIntoName(frompart, fromPartName);
2434 fprintf(STDOUT, "Volume %lu copied from %s %s to %s on %s %s \n",
2435 (unsigned long)volid, as->parms[1].items->data, fromPartName,
2436 tovolume, as->parms[4].items->data, toPartName);
2443 ShadowVolume(struct cmd_syndesc *as, void *arock)
2445 afs_uint32 volid, tovolid;
2446 afs_uint32 fromserver, toserver;
2447 afs_int32 frompart, topart;
2448 afs_int32 code, err, flags;
2449 char fromPartName[10], toPartName[10], toVolName[32], *tovolume;
2450 struct diskPartition64 partition; /* for space check */
2453 p = (volintInfo *) 0;
2454 q = (volintInfo *) 0;
2456 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2459 PrintError("", err);
2461 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2462 as->parms[0].items->data);
2465 fromserver = GetServer(as->parms[1].items->data);
2466 if (fromserver == 0) {
2467 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2468 as->parms[1].items->data);
2472 toserver = GetServer(as->parms[3].items->data);
2473 if (toserver == 0) {
2474 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2475 as->parms[3].items->data);
2479 frompart = volutil_GetPartitionID(as->parms[2].items->data);
2481 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2482 as->parms[2].items->data);
2485 if (!IsPartValid(frompart, fromserver, &code)) { /*check for validity of the partition */
2487 PrintError("", code);
2490 "vos : partition %s does not exist on the server\n",
2491 as->parms[2].items->data);
2495 topart = volutil_GetPartitionID(as->parms[4].items->data);
2497 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2498 as->parms[4].items->data);
2501 if (!IsPartValid(topart, toserver, &code)) { /*check for validity of the partition */
2503 PrintError("", code);
2506 "vos : partition %s does not exist on the server\n",
2507 as->parms[4].items->data);
2511 if (as->parms[5].items) {
2512 tovolume = as->parms[5].items->data;
2513 if (!ISNAMEVALID(tovolume)) {
2515 "vos: the name of the root volume %s exceeds the size limit of %d\n",
2516 tovolume, VOLSER_OLDMAXVOLNAME - 10);
2519 if (!VolNameOK(tovolume)) {
2521 "Illegal volume name %s, should not end in .readonly or .backup\n",
2525 if (IsNumeric(tovolume)) {
2527 "Illegal volume name %s, should not be a number\n",
2532 /* use actual name of source volume */
2533 code = UV_ListOneVolume(fromserver, frompart, volid, &p);
2535 fprintf(STDERR, "vos:cannot access volume %lu\n",
2536 (unsigned long)volid);
2539 strcpy(toVolName, p->name);
2540 tovolume = toVolName;
2541 /* save p for size checks later */
2544 if (as->parms[6].items) {
2545 tovolid = vsu_GetVolumeID(as->parms[6].items->data, cstruct, &err);
2548 PrintError("", err);
2550 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2551 as->parms[6].items->data);
2557 tovolid = vsu_GetVolumeID(tovolume, cstruct, &err);
2560 PrintError("", err);
2562 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2571 if (as->parms[7].items) flags |= RV_OFFLINE;
2572 if (as->parms[8].items) flags |= RV_RDONLY;
2573 if (as->parms[9].items) flags |= RV_NOCLONE;
2574 if (as->parms[10].items) flags |= RV_CPINCR;
2576 MapPartIdIntoName(topart, toPartName);
2577 MapPartIdIntoName(frompart, fromPartName);
2580 * check target partition for space to move volume
2583 code = UV_PartitionInfo64(toserver, toPartName, &partition);
2585 fprintf(STDERR, "vos: cannot access partition %s\n", toPartName);
2589 fprintf(STDOUT, "target partition %s free space %" AFS_INT64_FMT "\n", toPartName,
2592 /* Don't do this again if we did it above */
2594 code = UV_ListOneVolume(fromserver, frompart, volid, &p);
2596 fprintf(STDERR, "vos:cannot access volume %lu\n",
2597 (unsigned long)volid);
2602 /* OK if this fails */
2603 code = UV_ListOneVolume(toserver, topart, tovolid, &q);
2605 /* Treat existing volume size as "free" */
2607 p->size = (q->size < p->size) ? p->size - q->size : 0;
2609 if (partition.free <= p->size) {
2611 "vos: no space on target partition %s to copy volume %lu\n",
2612 toPartName, (unsigned long)volid);
2620 /* successful copy still not guaranteed but shoot for it */
2623 UV_CopyVolume2(volid, fromserver, frompart, tovolume, toserver,
2624 topart, tovolid, flags);
2626 PrintDiagnostics("shadow", code);
2629 MapPartIdIntoName(topart, toPartName);
2630 MapPartIdIntoName(frompart, fromPartName);
2631 fprintf(STDOUT, "Volume %lu shadowed from %s %s to %s %s \n",
2632 (unsigned long)volid, as->parms[1].items->data, fromPartName,
2633 as->parms[3].items->data, toPartName);
2640 CloneVolume(struct cmd_syndesc *as, void *arock)
2642 afs_uint32 volid, cloneid;
2644 afs_int32 part, voltype;
2645 char partName[10], *volname;
2646 afs_int32 code, err, flags;
2647 struct nvldbentry entry;
2649 volid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2652 PrintError("", err);
2654 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2655 as->parms[0].items->data);
2659 if (as->parms[1].items || as->parms[2].items) {
2660 if (!as->parms[1].items || !as->parms[2].items) {
2662 "Must specify both -server and -partition options\n");
2665 server = GetServer(as->parms[1].items->data);
2667 fprintf(STDERR, "vos: server '%s' not found in host table\n",
2668 as->parms[1].items->data);
2671 part = volutil_GetPartitionID(as->parms[2].items->data);
2673 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
2674 as->parms[2].items->data);
2677 if (!IsPartValid(part, server, &code)) { /*check for validity of the partition */
2679 PrintError("", code);
2682 "vos : partition %s does not exist on the server\n",
2683 as->parms[2].items->data);
2687 code = GetVolumeInfo(volid, &server, &part, &voltype, &entry);
2693 if (as->parms[3].items) {
2694 volname = as->parms[3].items->data;
2695 if (strlen(volname) > VOLSER_OLDMAXVOLNAME - 1) {
2697 "vos: the name of the root volume %s exceeds the size limit of %d\n",
2698 volname, VOLSER_OLDMAXVOLNAME - 1);
2703 * In order that you be able to make clones of RO or BK, this
2704 * check must be omitted.
2706 if (!VolNameOK(volname)) {
2708 "Illegal volume name %s, should not end in .readonly or .backup\n",
2713 if (IsNumeric(volname)) {
2715 "Illegal volume name %s, should not be a number\n",
2722 if (as->parms[4].items) {
2723 cloneid = vsu_GetVolumeID(as->parms[4].items->data, cstruct, &err);
2726 PrintError("", err);
2728 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2729 as->parms[4].items->data);
2735 if (as->parms[5].items) flags |= RV_OFFLINE;
2736 if (as->parms[6].items) flags |= RV_RDONLY;
2740 UV_CloneVolume(server, part, volid, cloneid, volname, flags);
2743 PrintDiagnostics("clone", code);
2746 MapPartIdIntoName(part, partName);
2747 fprintf(STDOUT, "Created clone for volume %s\n",
2748 as->parms[0].items->data);
2755 BackupVolume(struct cmd_syndesc *as, void *arock)
2759 afs_int32 apart, vtype, code, err;
2760 struct nvldbentry entry;
2763 afs_uint32 buserver;
2764 afs_int32 bupart, butype;
2765 struct nvldbentry buentry;
2767 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2770 PrintError("", err);
2772 fprintf(STDERR, "vos: can't find volume ID or name '%s'\n",
2773 as->parms[0].items->data);
2776 code = GetVolumeInfo(avolid, &aserver, &apart, &vtype, &entry);
2780 /* verify this is a readwrite volume */
2782 if (vtype != RWVOL) {
2783 fprintf(STDERR, "%s not RW volume\n", as->parms[0].items->data);
2787 /* is there a backup volume already? */
2789 if (entry.flags & BACK_EXISTS) {
2790 /* yep, where is it? */
2792 buvolid = entry.volumeId[BACKVOL];
2793 code = GetVolumeInfo(buvolid, &buserver, &bupart, &butype, &buentry);
2798 code = VLDB_IsSameAddrs(buserver, aserver, &err);
2801 "Failed to get info about server's %d address(es) from vlserver; aborting call!\n",
2807 "FATAL ERROR: backup volume %lu exists on server %lu\n",
2808 (unsigned long)buvolid, (unsigned long)buserver);
2813 /* nope, carry on */
2815 code = UV_BackupVolume(aserver, apart, avolid);
2818 PrintDiagnostics("backup", code);
2821 fprintf(STDOUT, "Created backup volume for %s \n",
2822 as->parms[0].items->data);
2827 ReleaseVolume(struct cmd_syndesc *as, void *arock)
2830 struct nvldbentry entry;
2833 afs_int32 apart, vtype, code, err;
2836 if (as->parms[1].items)
2838 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2841 PrintError("", err);
2843 fprintf(STDERR, "vos: can't find volume '%s'\n",
2844 as->parms[0].items->data);
2847 code = GetVolumeInfo(avolid, &aserver, &apart, &vtype, &entry);
2851 if (vtype != RWVOL) {
2852 fprintf(STDERR, "%s not a RW volume\n", as->parms[0].items->data);
2856 if (!ISNAMEVALID(entry.name)) {
2858 "Volume name %s is too long, rename before releasing\n",
2863 code = UV_ReleaseVolume(avolid, aserver, apart, force);
2865 PrintDiagnostics("release", code);
2868 fprintf(STDOUT, "Released volume %s successfully\n",
2869 as->parms[0].items->data);
2874 DumpVolumeCmd(struct cmd_syndesc *as, void *arock)
2878 afs_int32 apart, voltype, fromdate = 0, code, err, i, flags;
2879 char filename[MAXPATHLEN];
2880 struct nvldbentry entry;
2882 rx_SetRxDeadTime(60 * 10);
2883 for (i = 0; i < MAXSERVERS; i++) {
2884 struct rx_connection *rxConn = ubik_GetRPCConn(cstruct, i);
2887 rx_SetConnDeadTime(rxConn, rx_connDeadTime);
2888 if (rxConn->service)
2889 rxConn->service->connDeadTime = rx_connDeadTime;
2892 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
2895 PrintError("", err);
2897 fprintf(STDERR, "vos: can't find volume '%s'\n",
2898 as->parms[0].items->data);
2902 if (as->parms[3].items || as->parms[4].items) {
2903 if (!as->parms[3].items || !as->parms[4].items) {
2905 "Must specify both -server and -partition options\n");
2908 aserver = GetServer(as->parms[3].items->data);
2910 fprintf(STDERR, "Invalid server name\n");
2913 apart = volutil_GetPartitionID(as->parms[4].items->data);
2915 fprintf(STDERR, "Invalid partition name\n");
2919 code = GetVolumeInfo(avolid, &aserver, &apart, &voltype, &entry);
2924 if (as->parms[1].items && strcmp(as->parms[1].items->data, "0")) {
2925 code = ktime_DateToInt32(as->parms[1].items->data, &fromdate);
2927 fprintf(STDERR, "vos: failed to parse date '%s' (error=%d))\n",
2928 as->parms[1].items->data, code);
2932 if (as->parms[2].items) {
2933 strcpy(filename, as->parms[2].items->data);
2935 strcpy(filename, "");
2938 flags = as->parms[6].items ? VOLDUMPV2_OMITDIRS : 0;
2940 if (as->parms[5].items) {
2942 UV_DumpClonedVolume(avolid, aserver, apart, fromdate,
2943 DumpFunction, filename, flags);
2946 UV_DumpVolume(avolid, aserver, apart, fromdate, DumpFunction,
2949 if ((code == RXGEN_OPCODE) && (as->parms[6].items)) {
2950 flags &= ~VOLDUMPV2_OMITDIRS;
2954 PrintDiagnostics("dump", code);
2957 if (strcmp(filename, ""))
2958 fprintf(STDERR, "Dumped volume %s in file %s\n",
2959 as->parms[0].items->data, filename);
2961 fprintf(STDERR, "Dumped volume %s in stdout \n",
2962 as->parms[0].items->data);
2976 RestoreVolumeCmd(struct cmd_syndesc *as, void *arock)
2978 afs_uint32 avolid, aparentid;
2980 afs_int32 apart, code, vcode, err;
2981 afs_int32 aoverwrite = ASK;
2982 afs_int32 acreation = 0, alastupdate = 0;
2983 int restoreflags = 0;
2984 int readonly = 0, offline = 0, voltype = RWVOL;
2985 char afilename[MAXPATHLEN], avolname[VOLSER_MAXVOLNAME + 1], apartName[10];
2986 char volname[VOLSER_MAXVOLNAME + 1];
2987 struct nvldbentry entry;
2990 if (as->parms[4].items) {
2991 avolid = vsu_GetVolumeID(as->parms[4].items->data, cstruct, &err);
2994 PrintError("", err);
2996 fprintf(STDERR, "vos: can't find volume '%s'\n",
2997 as->parms[4].items->data);
3003 if (as->parms[5].items) {
3004 if ((strcmp(as->parms[5].items->data, "a") == 0)
3005 || (strcmp(as->parms[5].items->data, "abort") == 0)) {
3007 } else if ((strcmp(as->parms[5].items->data, "f") == 0)
3008 || (strcmp(as->parms[5].items->data, "full") == 0)) {
3010 } else if ((strcmp(as->parms[5].items->data, "i") == 0)
3011 || (strcmp(as->parms[5].items->data, "inc") == 0)
3012 || (strcmp(as->parms[5].items->data, "increment") == 0)
3013 || (strcmp(as->parms[5].items->data, "incremental") == 0)) {
3016 fprintf(STDERR, "vos: %s is not a valid argument to -overwrite\n",
3017 as->parms[5].items->data);
3021 if (as->parms[6].items)
3023 if (as->parms[7].items) {
3028 if (as->parms[8].items) {
3029 if ((strcmp(as->parms[8].items->data, "d") == 0)
3030 || (strcmp(as->parms[8].items->data, "dump") == 0)) {
3031 acreation = TS_DUMP;
3032 } else if ((strcmp(as->parms[8].items->data, "k") == 0)
3033 || (strcmp(as->parms[8].items->data, "keep") == 0)) {
3034 acreation = TS_KEEP;
3035 } else if ((strcmp(as->parms[8].items->data, "n") == 0)
3036 || (strcmp(as->parms[8].items->data, "new") == 0)) {
3039 fprintf(STDERR, "vos: %s is not a valid argument to -creation\n",
3040 as->parms[8].items->data);
3045 if (as->parms[9].items) {
3046 if ((strcmp(as->parms[9].items->data, "d") == 0)
3047 || (strcmp(as->parms[9].items->data, "dump") == 0)) {
3048 alastupdate = TS_DUMP;
3049 } else if ((strcmp(as->parms[9].items->data, "k") == 0)
3050 || (strcmp(as->parms[9].items->data, "keep") == 0)) {
3051 alastupdate = TS_KEEP;
3052 } else if ((strcmp(as->parms[9].items->data, "n") == 0)
3053 || (strcmp(as->parms[9].items->data, "new") == 0)) {
3054 alastupdate = TS_NEW;
3056 fprintf(STDERR, "vos: %s is not a valid argument to -lastupdate\n",
3057 as->parms[9].items->data);
3062 aserver = GetServer(as->parms[0].items->data);
3064 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3065 as->parms[0].items->data);
3068 apart = volutil_GetPartitionID(as->parms[1].items->data);
3070 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3071 as->parms[1].items->data);
3074 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
3076 PrintError("", code);
3079 "vos : partition %s does not exist on the server\n",
3080 as->parms[1].items->data);
3083 strcpy(avolname, as->parms[2].items->data);
3084 if (!ISNAMEVALID(avolname)) {
3086 "vos: the name of the volume %s exceeds the size limit\n",
3090 if (!VolNameOK(avolname)) {
3092 "Illegal volume name %s, should not end in .readonly or .backup\n",
3096 if (as->parms[3].items) {
3097 strcpy(afilename, as->parms[3].items->data);
3098 if (!FileExists(afilename)) {
3099 fprintf(STDERR, "Can't access file %s\n", afilename);
3103 strcpy(afilename, "");
3106 /* Check if volume exists or not */
3108 vsu_ExtractName(volname, avolname);
3109 vcode = VLDB_GetEntryByName(volname, &entry);
3110 if (vcode) { /* no volume - do a full restore */
3111 restoreflags = RV_FULLRST;
3112 if ((aoverwrite == INC) || (aoverwrite == ABORT))
3114 "Volume does not exist; Will perform a full restore\n");
3117 else if ((!readonly && Lp_GetRwIndex(&entry) == -1) /* RW volume does not exist - do a full */
3118 ||(readonly && !Lp_ROMatch(0, 0, &entry))) { /* RO volume does not exist - do a full */
3119 restoreflags = RV_FULLRST;
3120 if ((aoverwrite == INC) || (aoverwrite == ABORT))
3122 "%s Volume does not exist; Will perform a full restore\n",
3123 readonly ? "RO" : "RW");
3126 avolid = entry.volumeId[voltype];
3127 } else if (entry.volumeId[voltype] != 0
3128 && entry.volumeId[voltype] != avolid) {
3129 avolid = entry.volumeId[voltype];
3131 aparentid = entry.volumeId[RWVOL];
3134 else { /* volume exists - do we do a full incremental or abort */
3136 afs_int32 Opart, Otype, vol_elsewhere = 0;
3137 struct nvldbentry Oentry;
3141 avolid = entry.volumeId[voltype];
3142 } else if (entry.volumeId[voltype] != 0
3143 && entry.volumeId[voltype] != avolid) {
3144 avolid = entry.volumeId[voltype];
3146 aparentid = entry.volumeId[RWVOL];
3148 /* A file name was specified - check if volume is on another partition */
3149 vcode = GetVolumeInfo(avolid, &Oserver, &Opart, &Otype, &Oentry);
3153 vcode = VLDB_IsSameAddrs(Oserver, aserver, &err);
3156 "Failed to get info about server's %d address(es) from vlserver (err=%d); aborting call!\n",
3160 if (!vcode || (Opart != apart))
3163 if (aoverwrite == ASK) {
3164 if (strcmp(afilename, "") == 0) { /* The file is from standard in */
3166 "Volume exists and no -overwrite option specified; Aborting restore command\n");
3170 /* Ask what to do */
3171 if (vol_elsewhere) {
3173 "The volume %s %u already exists on a different server/part\n",
3174 volname, entry.volumeId[voltype]);
3176 "Do you want to do a full restore or abort? [fa](a): ");
3179 "The volume %s %u already exists in the VLDB\n",
3180 volname, entry.volumeId[voltype]);
3182 "Do you want to do a full/incremental restore or abort? [fia](a): ");
3185 while (!(dc == EOF || dc == '\n'))
3186 dc = getchar(); /* goto end of line */
3187 if ((c == 'f') || (c == 'F'))
3189 else if ((c == 'i') || (c == 'I'))
3195 if (aoverwrite == ABORT) {
3196 fprintf(STDERR, "Volume exists; Aborting restore command\n");
3198 } else if (aoverwrite == FULL) {
3199 restoreflags = RV_FULLRST;
3201 "Volume exists; Will delete and perform full restore\n");
3202 } else if (aoverwrite == INC) {
3204 if (vol_elsewhere) {
3206 "%s volume %lu already exists on a different server/part; not allowed\n",
3207 readonly ? "RO" : "RW", (unsigned long)avolid);
3213 restoreflags |= RV_OFFLINE;
3215 restoreflags |= RV_RDONLY;
3217 switch (acreation) {
3219 restoreflags |= RV_CRDUMP;
3222 restoreflags |= RV_CRKEEP;
3225 restoreflags |= RV_CRNEW;
3228 if (aoverwrite == FULL)
3229 restoreflags |= RV_CRNEW;
3231 restoreflags |= RV_CRKEEP;
3234 switch (alastupdate) {
3236 restoreflags |= RV_LUDUMP;
3239 restoreflags |= RV_LUKEEP;
3242 restoreflags |= RV_LUNEW;
3245 restoreflags |= RV_LUDUMP;
3247 if (as->parms[10].items) {
3248 restoreflags |= RV_NODEL;
3253 UV_RestoreVolume2(aserver, apart, avolid, aparentid,
3254 avolname, restoreflags, WriteData, afilename);
3256 PrintDiagnostics("restore", code);
3259 MapPartIdIntoName(apart, apartName);
3262 * patch typo here - originally "parms[1]", should be "parms[0]"
3265 fprintf(STDOUT, "Restored volume %s on %s %s\n", avolname,
3266 as->parms[0].items->data, apartName);
3271 LockReleaseCmd(struct cmd_syndesc *as, void *arock)
3274 afs_int32 code, err;
3276 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
3279 PrintError("", err);
3281 fprintf(STDERR, "vos: can't find volume '%s'\n",
3282 as->parms[0].items->data);
3286 code = UV_LockRelease(avolid);
3288 PrintDiagnostics("unlock", code);
3291 fprintf(STDOUT, "Released lock on vldb entry for volume %s\n",
3292 as->parms[0].items->data);
3297 AddSite(struct cmd_syndesc *as, void *arock)
3301 afs_int32 apart, code, err, arovolid, valid = 0;
3302 char apartName[10], avolname[VOLSER_MAXVOLNAME + 1];
3304 vsu_ExtractName(avolname, as->parms[2].items->data);;
3305 avolid = vsu_GetVolumeID(avolname, cstruct, &err);
3308 PrintError("", err);
3310 fprintf(STDERR, "vos: can't find volume '%s'\n",
3311 as->parms[2].items->data);
3315 if (as->parms[3].items) {
3316 vsu_ExtractName(avolname, as->parms[3].items->data);
3317 arovolid = vsu_GetVolumeID(avolname, cstruct, &err);
3319 fprintf(STDERR, "vos: invalid ro volume id '%s'\n",
3320 as->parms[3].items->data);
3324 aserver = GetServer(as->parms[0].items->data);
3326 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3327 as->parms[0].items->data);
3330 apart = volutil_GetPartitionID(as->parms[1].items->data);
3332 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3333 as->parms[1].items->data);
3336 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
3338 PrintError("", code);
3341 "vos : partition %s does not exist on the server\n",
3342 as->parms[1].items->data);
3345 if (as->parms[4].items) {
3348 code = UV_AddSite2(aserver, apart, avolid, arovolid, valid);
3350 PrintDiagnostics("addsite", code);
3353 MapPartIdIntoName(apart, apartName);
3354 fprintf(STDOUT, "Added replication site %s %s for volume %s\n",
3355 as->parms[0].items->data, apartName, as->parms[2].items->data);
3360 RemoveSite(struct cmd_syndesc *as, void *arock)
3365 afs_int32 apart, code, err;
3366 char apartName[10], avolname[VOLSER_MAXVOLNAME + 1];
3368 vsu_ExtractName(avolname, as->parms[2].items->data);
3369 avolid = vsu_GetVolumeID(avolname, cstruct, &err);
3372 PrintError("", err);
3374 fprintf(STDERR, "vos: can't find volume '%s'\n",
3375 as->parms[2].items->data);
3378 aserver = GetServer(as->parms[0].items->data);
3380 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3381 as->parms[0].items->data);
3384 apart = volutil_GetPartitionID(as->parms[1].items->data);
3386 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3387 as->parms[1].items->data);
3391 *skip the partition validity check, since it is possible that the partition
3392 *has since been decomissioned.
3395 if (!IsPartValid(apart,aserver,&code)){
3396 if(code) PrintError("",code);
3397 else fprintf(STDERR,"vos : partition %s does not exist on the server\n",as->parms[1].items->data);
3401 code = UV_RemoveSite(aserver, apart, avolid);
3403 PrintDiagnostics("remsite", code);
3406 MapPartIdIntoName(apart, apartName);
3407 fprintf(STDOUT, "Removed replication site %s %s for volume %s\n",
3408 as->parms[0].items->data, apartName, as->parms[2].items->data);
3413 ChangeLocation(struct cmd_syndesc *as, void *arock)
3417 afs_int32 apart, code, err;
3420 avolid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &err);
3423 PrintError("", err);
3425 fprintf(STDERR, "vos: can't find volume '%s'\n",
3426 as->parms[2].items->data);
3429 aserver = GetServer(as->parms[0].items->data);
3431 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3432 as->parms[0].items->data);
3435 apart = volutil_GetPartitionID(as->parms[1].items->data);
3437 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3438 as->parms[1].items->data);
3441 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
3443 PrintError("", code);
3446 "vos : partition %s does not exist on the server\n",
3447 as->parms[1].items->data);
3450 code = UV_ChangeLocation(aserver, apart, avolid);
3452 PrintDiagnostics("changeloc", code);
3455 MapPartIdIntoName(apart, apartName);
3456 fprintf(STDOUT, "Changed location to %s %s for volume %s\n",
3457 as->parms[0].items->data, apartName, as->parms[2].items->data);
3462 ListPartitions(struct cmd_syndesc *as, void *arock)
3466 struct partList dummyPartList;
3471 aserver = GetServer(as->parms[0].items->data);
3473 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3474 as->parms[0].items->data);
3479 code = UV_ListPartitions(aserver, &dummyPartList, &cnt);
3481 PrintDiagnostics("listpart", code);
3485 fprintf(STDOUT, "The partitions on the server are:\n");
3486 for (i = 0; i < cnt; i++) {
3487 if (dummyPartList.partFlags[i] & PARTVALID) {
3488 memset(pname, 0, sizeof(pname));
3489 MapPartIdIntoName(dummyPartList.partId[i], pname);
3490 fprintf(STDOUT, " %10s ", pname);
3492 if ((i % 5) == 0 && (i != 0))
3493 fprintf(STDOUT, "\n");
3496 fprintf(STDOUT, "\n");
3497 fprintf(STDOUT, "Total: %d\n", total);
3503 CompareVolName(const void *p1, const void *p2)
3505 volintInfo *arg1, *arg2;
3507 arg1 = (volintInfo *) p1;
3508 arg2 = (volintInfo *) p2;
3509 return (strcmp(arg1->name, arg2->name));
3513 /*------------------------------------------------------------------------
3514 * PRIVATE XCompareVolName
3517 * Comparison routine for volume names coming from an extended
3521 * a_obj1P : Char ptr to first extended vol info object
3522 * a_obj1P : Char ptr to second extended vol info object
3525 * The value of strcmp() on the volume names within the passed
3526 * objects (i,e., -1, 0, or 1).
3529 * Passed to qsort() as the designated comparison routine.
3533 *------------------------------------------------------------------------*/
3536 XCompareVolName(const void *a_obj1P, const void *a_obj2P)
3537 { /*XCompareVolName */
3540 (((struct volintXInfo *)(a_obj1P))->name,
3541 ((struct volintXInfo *)(a_obj2P))->name));
3543 } /*XCompareVolName */
3546 CompareVolID(const void *p1, const void *p2)
3548 volintInfo *arg1, *arg2;
3550 arg1 = (volintInfo *) p1;
3551 arg2 = (volintInfo *) p2;
3552 if (arg1->volid == arg2->volid)
3554 if (arg1->volid > arg2->volid)
3561 /*------------------------------------------------------------------------
3562 * PRIVATE XCompareVolID
3565 * Comparison routine for volume IDs coming from an extended
3569 * a_obj1P : Char ptr to first extended vol info object
3570 * a_obj1P : Char ptr to second extended vol info object
3573 * The value of strcmp() on the volume names within the passed
3574 * objects (i,e., -1, 0, or 1).
3577 * Passed to qsort() as the designated comparison routine.
3581 *------------------------------------------------------------------------*/
3584 XCompareVolID(const void *a_obj1P, const void *a_obj2P)
3585 { /*XCompareVolID */
3587 afs_int32 id1, id2; /*Volume IDs we're comparing */
3589 id1 = ((struct volintXInfo *)(a_obj1P))->volid;
3590 id2 = ((struct volintXInfo *)(a_obj2P))->volid;
3598 } /*XCompareVolID */
3600 /*------------------------------------------------------------------------
3601 * PRIVATE ListVolumes
3604 * Routine used to list volumes, contacting the Volume Server
3605 * directly, bypassing the VLDB.
3608 * as : Ptr to parsed command line arguments.
3611 * 0 Successful operation
3614 * Nothing interesting.
3618 *------------------------------------------------------------------------*/
3621 ListVolumes(struct cmd_syndesc *as, void *arock)
3623 afs_int32 apart, int32list, fast;
3627 volintInfo *oldpntr = NULL;
3631 volintXInfo *xInfoP;
3632 volintXInfo *origxInfoP = NULL; /*Ptr to current/orig extended vol info */
3633 int wantExtendedInfo; /*Do we want extended vol info? */
3636 struct partList dummyPartList;
3644 if (as->parms[3].items)
3646 if (as->parms[4].items)
3650 if (as->parms[2].items)
3656 if (as->parms[5].items) {
3658 * We can't coexist with the fast flag.
3662 "vos: Can't use the -fast and -extended flags together\n");
3667 * We need to turn on ``long'' listings to get the full effect.
3669 wantExtendedInfo = 1;
3672 wantExtendedInfo = 0;
3673 if (as->parms[1].items) {
3674 apart = volutil_GetPartitionID(as->parms[1].items->data);
3676 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3677 as->parms[1].items->data);
3680 dummyPartList.partId[0] = apart;
3681 dummyPartList.partFlags[0] = PARTVALID;
3684 aserver = GetServer(as->parms[0].items->data);
3686 fprintf(STDERR, "vos: server '%s' not found in host table\n",
3687 as->parms[0].items->data);
3692 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
3694 PrintError("", code);
3697 "vos : partition %s does not exist on the server\n",
3698 as->parms[1].items->data);
3702 code = UV_ListPartitions(aserver, &dummyPartList, &cnt);
3704 PrintDiagnostics("listvol", code);
3708 for (i = 0; i < cnt; i++) {
3709 if (dummyPartList.partFlags[i] & PARTVALID) {
3710 if (wantExtendedInfo)
3712 UV_XListVolumes(aserver, dummyPartList.partId[i], all,
3716 UV_ListVolumes(aserver, dummyPartList.partId[i], all,
3719 PrintDiagnostics("listvol", code);
3722 if (wantExtendedInfo) {
3723 origxInfoP = xInfoP;
3724 base = (char *)xInfoP;
3727 base = (char *)pntr;
3731 if (wantExtendedInfo)
3732 qsort(base, count, sizeof(volintXInfo), XCompareVolName);
3734 qsort(base, count, sizeof(volintInfo), CompareVolName);
3736 if (wantExtendedInfo)
3737 qsort(base, count, sizeof(volintXInfo), XCompareVolID);
3739 qsort(base, count, sizeof(volintInfo), CompareVolID);
3741 MapPartIdIntoName(dummyPartList.partId[i], pname);
3744 "Total number of volumes on server %s partition %s: %lu \n",
3745 as->parms[0].items->data, pname,
3746 (unsigned long)count);
3747 if (wantExtendedInfo) {
3748 if (as->parms[6].items)
3749 XDisplayVolumes2(aserver, dummyPartList.partId[i], origxInfoP,
3750 count, int32list, fast, quiet);
3752 XDisplayVolumes(aserver, dummyPartList.partId[i], origxInfoP,
3753 count, int32list, fast, quiet);
3756 xInfoP = (volintXInfo *) 0;
3758 if (as->parms[6].items)
3759 DisplayVolumes2(aserver, dummyPartList.partId[i], oldpntr,
3762 DisplayVolumes(aserver, dummyPartList.partId[i], oldpntr,
3763 count, int32list, fast, quiet);
3766 pntr = (volintInfo *) 0;
3774 SyncVldb(struct cmd_syndesc *as, void *arock)
3776 afs_int32 pnum = 0, code; /* part name */
3783 if (as->parms[0].items) {
3784 tserver = GetServer(as->parms[0].items->data);
3786 fprintf(STDERR, "vos: host '%s' not found in host table\n",
3787 as->parms[0].items->data);
3792 if (as->parms[1].items) {
3793 pnum = volutil_GetPartitionID(as->parms[1].items->data);
3795 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3796 as->parms[1].items->data);
3799 if (!IsPartValid(pnum, tserver, &code)) { /*check for validity of the partition */
3801 PrintError("", code);
3804 "vos: partition %s does not exist on the server\n",
3805 as->parms[1].items->data);
3812 "The -partition option requires a -server option\n");
3817 if (as->parms[3].items) {
3818 flags |= 2; /* don't update */
3821 if (as->parms[2].items) {
3822 /* Synchronize an individual volume */
3823 volname = as->parms[2].items->data;
3824 code = UV_SyncVolume(tserver, pnum, volname, flags);
3828 "Without a -volume option, the -server option is required\n");
3831 code = UV_SyncVldb(tserver, pnum, flags, 0 /*unused */ );
3835 PrintDiagnostics("syncvldb", code);
3839 /* Print a summary of what we did */
3841 fprintf(STDOUT, "VLDB volume %s synchronized", volname);
3843 fprintf(STDOUT, "VLDB synchronized");
3845 fprintf(STDOUT, " with state of server %s", as->parms[0].items->data);
3848 MapPartIdIntoName(pnum, part);
3849 fprintf(STDOUT, " partition %s\n", part);
3851 fprintf(STDOUT, "\n");
3857 SyncServer(struct cmd_syndesc *as, void *arock)
3859 afs_int32 pnum, code; /* part name */
3865 tserver = GetServer(as->parms[0].items->data);
3867 fprintf(STDERR, "vos: host '%s' not found in host table\n",
3868 as->parms[0].items->data);
3871 if (as->parms[1].items) {
3872 pnum = volutil_GetPartitionID(as->parms[1].items->data);
3874 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3875 as->parms[1].items->data);
3878 if (!IsPartValid(pnum, tserver, &code)) { /*check for validity of the partition */
3880 PrintError("", code);
3883 "vos : partition %s does not exist on the server\n",
3884 as->parms[1].items->data);
3892 if (as->parms[2].items) {
3893 flags |= 2; /* don't update */
3895 code = UV_SyncServer(tserver, pnum, flags, 0 /*unused */ );
3897 PrintDiagnostics("syncserv", code);
3901 MapPartIdIntoName(pnum, part);
3902 fprintf(STDOUT, "Server %s partition %s synchronized with VLDB\n",
3903 as->parms[0].items->data, part);
3905 fprintf(STDOUT, "Server %s synchronized with VLDB\n",
3906 as->parms[0].items->data);
3912 VolumeInfoCmd(char *name)
3914 struct nvldbentry entry;
3917 /* The vlserver will handle names with the .readonly
3918 * and .backup extension as well as volume ids.
3920 vcode = VLDB_GetEntryByName(name, &entry);
3922 PrintError("", vcode);
3925 MapHostToNetwork(&entry);
3926 EnumerateEntry(&entry);
3928 /* Defect #3027: grubby check to handle locked volume.
3929 * If VLOP_ALLOPERS is set, the entry is locked.
3930 * Leave this routine as is, but put in correct check.
3932 PrintLocked(entry.flags);
3938 VolumeZap(struct cmd_syndesc *as, void *arock)
3940 struct nvldbentry entry;
3941 afs_uint32 volid, zapbackupid = 0, backupid = 0;
3942 afs_int32 code, server, part, err;
3944 if (as->parms[3].items) {
3945 /* force flag is on, use the other version */
3946 return NukeVolume(as);
3949 if (as->parms[4].items) {
3953 volid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &err);
3956 PrintError("", err);
3958 fprintf(STDERR, "vos: can't find volume '%s'\n",
3959 as->parms[2].items->data);
3962 part = volutil_GetPartitionID(as->parms[1].items->data);
3964 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
3965 as->parms[1].items->data);
3968 server = GetServer(as->parms[0].items->data);
3970 fprintf(STDERR, "vos: host '%s' not found in host table\n",
3971 as->parms[0].items->data);
3974 if (!IsPartValid(part, server, &code)) { /*check for validity of the partition */
3976 PrintError("", code);
3979 "vos : partition %s does not exist on the server\n",
3980 as->parms[1].items->data);
3983 code = VLDB_GetEntryByID(volid, -1, &entry);
3985 if (volid == entry.volumeId[RWVOL])
3986 backupid = entry.volumeId[BACKVOL];
3988 "Warning: Entry for volume number %lu exists in VLDB (but we're zapping it anyway!)\n",
3989 (unsigned long)volid);
3992 volintInfo *pntr = (volintInfo *) 0;
3995 code = UV_ListOneVolume(server, part, volid, &pntr);
3997 if (volid == pntr->parentID)
3998 backupid = pntr->backupID;
4004 code = UV_VolumeZap(server, part, backupid);
4006 PrintDiagnostics("zap", code);
4009 fprintf(STDOUT, "Backup Volume %lu deleted\n",
4010 (unsigned long)backupid);
4013 code = UV_VolumeZap(server, part, volid);
4015 PrintDiagnostics("zap", code);
4018 fprintf(STDOUT, "Volume %lu deleted\n", (unsigned long)volid);
4024 VolserStatus(struct cmd_syndesc *as, void *arock)
4028 transDebugInfo *pntr, *oldpntr;
4034 server = GetServer(as->parms[0].items->data);
4036 fprintf(STDERR, "vos: host '%s' not found in host table\n",
4037 as->parms[0].items->data);
4040 code = UV_VolserStatus(server, &pntr, &count);
4042 PrintDiagnostics("status", code);
4047 fprintf(STDOUT, "No active transactions on %s\n",
4048 as->parms[0].items->data);
4050 fprintf(STDOUT, "Total transactions: %d\n", count);
4052 for (i = 0; i < count; i++) {
4053 /*print out the relevant info */
4054 fprintf(STDOUT, "--------------------------------------\n");
4055 t = pntr->creationTime;
4056 fprintf(STDOUT, "transaction: %lu created: %s",
4057 (unsigned long)pntr->tid, ctime(&t));
4059 fprintf(STDOUT, "lastActiveTime: %s", ctime(&t));
4060 if (pntr->returnCode) {
4061 fprintf(STDOUT, "returnCode: %lu\n",
4062 (unsigned long)pntr->returnCode);
4065 fprintf(STDOUT, "attachFlags: ");
4066 switch (pntr->iflags) {
4068 fprintf(STDOUT, "offline ");
4071 fprintf(STDOUT, "busy ");
4074 fprintf(STDOUT, "readonly ");
4077 fprintf(STDOUT, "create ");
4080 fprintf(STDOUT, "create volid ");
4083 fprintf(STDOUT, "\n");
4086 fprintf(STDOUT, "volumeStatus: ");
4087 switch (pntr->vflags) {
4088 case VTDeleteOnSalvage:
4089 fprintf(STDOUT, "deleteOnSalvage ");
4090 case VTOutOfService:
4091 fprintf(STDOUT, "outOfService ");
4093 fprintf(STDOUT, "deleted ");
4095 fprintf(STDOUT, "\n");
4098 fprintf(STDOUT, "transactionFlags: ");
4099 fprintf(STDOUT, "delete\n");
4101 MapPartIdIntoName(pntr->partition, pname);
4102 fprintf(STDOUT, "volume: %lu partition: %s procedure: %s\n",
4103 (unsigned long)pntr->volid, pname, pntr->lastProcName);
4104 if (pntr->callValid) {
4105 t = pntr->lastReceiveTime;
4106 fprintf(STDOUT, "packetRead: %lu lastReceiveTime: %s",
4107 (unsigned long)pntr->readNext, ctime(&t));
4108 t = pntr->lastSendTime;
4109 fprintf(STDOUT, "packetSend: %lu lastSendTime: %s",
4110 (unsigned long)pntr->transmitNext, ctime(&t));
4113 fprintf(STDOUT, "--------------------------------------\n");
4114 fprintf(STDOUT, "\n");
4122 RenameVolume(struct cmd_syndesc *as, void *arock)
4124 afs_int32 code1, code2, code;
4125 struct nvldbentry entry;
4127 code1 = VLDB_GetEntryByName(as->parms[0].items->data, &entry);
4129 fprintf(STDERR, "vos: Could not find entry for volume %s\n",
4130 as->parms[0].items->data);
4133 code2 = VLDB_GetEntryByName(as->parms[1].items->data, &entry);
4134 if ((!code1) && (!code2)) { /*the newname already exists */
4135 fprintf(STDERR, "vos: volume %s already exists\n",
4136 as->parms[1].items->data);
4140 if (code1 && code2) {
4141 fprintf(STDERR, "vos: Could not find entry for volume %s or %s\n",
4142 as->parms[0].items->data, as->parms[1].items->data);
4145 if (!VolNameOK(as->parms[0].items->data)) {
4147 "Illegal volume name %s, should not end in .readonly or .backup\n",
4148 as->parms[0].items->data);
4151 if (!ISNAMEVALID(as->parms[1].items->data)) {
4153 "vos: the new volume name %s exceeds the size limit of %d\n",
4154 as->parms[1].items->data, VOLSER_OLDMAXVOLNAME - 10);
4157 if (!VolNameOK(as->parms[1].items->data)) {
4159 "Illegal volume name %s, should not end in .readonly or .backup\n",
4160 as->parms[1].items->data);
4163 if (IsNumeric(as->parms[1].items->data)) {
4164 fprintf(STDERR, "Illegal volume name %s, should not be a number\n",
4165 as->parms[1].items->data);
4168 MapHostToNetwork(&entry);
4170 UV_RenameVolume(&entry, as->parms[0].items->data,
4171 as->parms[1].items->data);
4173 PrintDiagnostics("rename", code);
4176 fprintf(STDOUT, "Renamed volume %s to %s\n", as->parms[0].items->data,
4177 as->parms[1].items->data);
4182 GetVolumeInfo(afs_uint32 volid, afs_uint32 *server, afs_int32 *part, afs_int32 *voltype,
4183 struct nvldbentry *rentry)
4188 vcode = VLDB_GetEntryByID(volid, -1, rentry);
4191 "Could not fetch the entry for volume %lu from VLDB \n",
4192 (unsigned long)volid);
4193 PrintError("", vcode);
4196 MapHostToNetwork(rentry);
4197 if (volid == rentry->volumeId[ROVOL]) {
4199 for (i = 0; i < rentry->nServers; i++) {
4200 if ((index == -1) && (rentry->serverFlags[i] & ITSROVOL)
4201 && !(rentry->serverFlags[i] & RO_DONTUSE))
4206 "RO volume is not found in VLDB entry for volume %lu\n",
4207 (unsigned long)volid);
4211 *server = rentry->serverNumber[index];
4212 *part = rentry->serverPartition[index];
4216 index = Lp_GetRwIndex(rentry);
4219 "RW Volume is not found in VLDB entry for volume %lu\n",
4220 (unsigned long)volid);
4223 if (volid == rentry->volumeId[RWVOL]) {
4225 *server = rentry->serverNumber[index];
4226 *part = rentry->serverPartition[index];
4229 if (volid == rentry->volumeId[BACKVOL]) {
4231 *server = rentry->serverNumber[index];
4232 *part = rentry->serverPartition[index];
4236 "unexpected volume type for volume %lu\n",
4237 (unsigned long)volid);
4242 DeleteEntry(struct cmd_syndesc *as, void *arock)
4244 afs_int32 apart = 0;
4247 struct VldbListByAttributes attributes;
4248 nbulkentries arrayEntries;
4249 struct nvldbentry *vllist;
4250 struct cmd_item *itp;
4253 char prefix[VOLSER_MAXVOLNAME + 1];
4255 afs_int32 totalBack = 0, totalFail = 0, err;
4257 if (as->parms[0].items) { /* -id */
4258 if (as->parms[1].items || as->parms[2].items || as->parms[3].items) {
4260 "You cannot use -server, -partition, or -prefix with the -id argument\n");
4263 for (itp = as->parms[0].items; itp; itp = itp->next) {
4264 avolid = vsu_GetVolumeID(itp->data, cstruct, &err);
4267 PrintError("", err);
4269 fprintf(STDERR, "vos: can't find volume '%s'\n",
4273 if (as->parms[4].items || as->parms[5].items) {
4274 /* -noexecute (hidden) or -dryrun */
4275 fprintf(STDOUT, "Would have deleted VLDB entry for %s \n",
4280 vcode = ubik_VL_DeleteEntry(cstruct, 0, avolid, RWVOL);
4282 fprintf(STDERR, "Could not delete entry for volume %s\n",
4285 "You must specify a RW volume name or ID "
4286 "(the entire VLDB entry will be deleted)\n");
4287 PrintError("", vcode);
4293 fprintf(STDOUT, "Deleted %d VLDB entries\n", totalBack);
4297 if (!as->parms[1].items && !as->parms[2].items && !as->parms[3].items) {
4298 fprintf(STDERR, "You must specify an option\n");
4302 /* Zero out search attributes */
4303 memset(&attributes, 0, sizeof(struct VldbListByAttributes));
4305 if (as->parms[1].items) { /* -prefix */
4306 strncpy(prefix, as->parms[1].items->data, VOLSER_MAXVOLNAME);
4308 if (!as->parms[2].items && !as->parms[3].items) { /* a single entry only */
4310 "You must provide -server with the -prefix argument\n");
4315 if (as->parms[2].items) { /* -server */
4317 aserver = GetServer(as->parms[2].items->data);
4319 fprintf(STDERR, "vos: server '%s' not found in host table\n",
4320 as->parms[2].items->data);
4323 attributes.server = ntohl(aserver);
4324 attributes.Mask |= VLLIST_SERVER;
4327 if (as->parms[3].items) { /* -partition */
4328 if (!as->parms[2].items) {
4330 "You must provide -server with the -partition argument\n");
4333 apart = volutil_GetPartitionID(as->parms[3].items->data);
4335 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
4336 as->parms[3].items->data);
4339 attributes.partition = apart;
4340 attributes.Mask |= VLLIST_PARTITION;
4343 /* Print status line of what we are doing */
4344 fprintf(STDOUT, "Deleting VLDB entries for ");
4345 if (as->parms[2].items) {
4346 fprintf(STDOUT, "server %s ", as->parms[2].items->data);
4348 if (as->parms[3].items) {
4350 MapPartIdIntoName(apart, pname);
4351 fprintf(STDOUT, "partition %s ", pname);
4354 fprintf(STDOUT, "which are prefixed with %s ", prefix);
4356 fprintf(STDOUT, "\n");
4359 /* Get all the VLDB entries on a server and/or partition */
4360 memset(&arrayEntries, 0, sizeof(arrayEntries));
4361 vcode = VLDB_ListAttributes(&attributes, &nentries, &arrayEntries);
4363 fprintf(STDERR, "Could not access the VLDB for attributes\n");
4364 PrintError("", vcode);
4368 /* Process each entry */
4369 for (j = 0; j < nentries; j++) {
4370 vllist = &arrayEntries.nbulkentries_val[j];
4372 /* It only deletes the RW volumes */
4373 if (strncmp(vllist->name, prefix, strlen(prefix))) {
4376 "Omitting to delete %s due to prefix %s mismatch\n",
4377 vllist->name, prefix);
4384 if (as->parms[4].items || as->parms[5].items) {
4385 /* -noexecute (hidden) or -dryrun */
4386 fprintf(STDOUT, "Would have deleted VLDB entry for %s \n",
4392 /* Only matches the RW volume name */
4393 avolid = vllist->volumeId[RWVOL];
4394 vcode = ubik_VL_DeleteEntry(cstruct, 0, avolid, RWVOL);
4396 fprintf(STDOUT, "Could not delete VLDB entry for %s\n",
4399 PrintError("", vcode);
4404 fprintf(STDOUT, "Deleted VLDB entry for %s \n", vllist->name);
4409 fprintf(STDOUT, "----------------------\n");
4411 "Total VLDB entries deleted: %lu; failed to delete: %lu\n",
4412 (unsigned long)totalBack, (unsigned long)totalFail);
4414 xdr_free((xdrproc_t) xdr_nbulkentries, &arrayEntries);
4420 CompareVldbEntryByName(const void *p1, const void *p2)
4422 struct nvldbentry *arg1, *arg2;
4424 arg1 = (struct nvldbentry *)p1;
4425 arg2 = (struct nvldbentry *)p2;
4426 return (strcmp(arg1->name, arg2->name));
4430 static int CompareVldbEntry(char *p1, char *p2)
4432 struct nvldbentry *arg1,*arg2;
4435 char comp1[100],comp2[100];
4436 char temp1[20],temp2[20];
4438 arg1 = (struct nvldbentry *)p1;
4439 arg2 = (struct nvldbentry *)p2;
4443 for(i = 0; i < arg1->nServers; i++)
4444 if(arg1->serverFlags[i] & ITSRWVOL) pos1 = i;
4445 for(i = 0; i < arg2->nServers; i++)
4446 if(arg2->serverFlags[i] & ITSRWVOL) pos2 = i;
4447 if(pos1 == -1 || pos2 == -1){
4451 sprintf(comp1,"%10u",arg1->serverNumber[pos1]);
4452 sprintf(comp2,"%10u",arg2->serverNumber[pos2]);
4453 sprintf(temp1,"%10u",arg1->serverPartition[pos1]);
4454 sprintf(temp2,"%10u",arg2->serverPartition[pos2]);
4455 strcat(comp1,temp1);
4456 strcat(comp2,temp2);
4457 strcat(comp1,arg1->name);
4458 strcat(comp1,arg2->name);
4459 return(strcmp(comp1,comp2));
4465 ListVLDB(struct cmd_syndesc *as, void *arock)
4471 struct VldbListByAttributes attributes;
4472 nbulkentries arrayEntries;
4473 struct nvldbentry *vllist, *tarray = 0, *ttarray;
4474 afs_int32 centries, nentries = 0;
4475 afs_int32 tarraysize = 0;
4476 afs_int32 parraysize;
4479 int quiet, sort, lock;
4480 afs_int32 thisindex, nextindex;
4485 attributes.Mask = 0;
4486 lock = (as->parms[3].items ? 1 : 0); /* -lock flag */
4487 quiet = (as->parms[4].items ? 1 : 0); /* -quit flag */
4488 sort = (as->parms[5].items ? 0 : 1); /* -nosort flag */
4490 /* If the volume name is given, Use VolumeInfoCmd to look it up
4491 * and not ListAttributes.
4493 if (as->parms[0].items) {
4496 "vos: illegal use of '-locked' switch, need to specify server and/or partition\n");
4499 code = VolumeInfoCmd(as->parms[0].items->data);
4501 PrintError("", code);
4507 /* Server specified */
4508 if (as->parms[1].items) {
4509 aserver = GetServer(as->parms[1].items->data);
4511 fprintf(STDERR, "vos: server '%s' not found in host table\n",
4512 as->parms[1].items->data);
4515 attributes.server = ntohl(aserver);
4516 attributes.Mask |= VLLIST_SERVER;
4519 /* Partition specified */
4520 if (as->parms[2].items) {
4521 apart = volutil_GetPartitionID(as->parms[2].items->data);
4523 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
4524 as->parms[2].items->data);
4527 attributes.partition = apart;
4528 attributes.Mask |= VLLIST_PARTITION;
4532 attributes.Mask |= VLLIST_FLAG;
4533 attributes.flag = VLOP_ALLOPERS;
4536 /* Print header information */
4538 MapPartIdIntoName(apart, pname);
4539 fprintf(STDOUT, "VLDB entries for %s %s%s%s %s\n",
4540 (as->parms[1].items ? "server" : "all"),
4541 (as->parms[1].items ? as->parms[1].items->data : "servers"),
4542 (as->parms[2].items ? " partition " : ""),
4543 (as->parms[2].items ? pname : ""),
4544 (lock ? "which are locked:" : ""));
4547 for (thisindex = 0; (thisindex != -1); thisindex = nextindex) {
4548 memset(&arrayEntries, 0, sizeof(arrayEntries));
4553 VLDB_ListAttributesN2(&attributes, 0, thisindex, ¢ries,
4554 &arrayEntries, &nextindex);
4555 if (vcode == RXGEN_OPCODE) {
4556 /* Vlserver not running with ListAttributesN2. Fall back */
4558 VLDB_ListAttributes(&attributes, ¢ries, &arrayEntries);
4562 fprintf(STDERR, "Could not access the VLDB for attributes\n");
4563 PrintError("", vcode);
4566 nentries += centries;
4568 /* We don't sort, so just print the entries now */
4570 for (j = 0; j < centries; j++) { /* process each entry */
4571 vllist = &arrayEntries.nbulkentries_val[j];
4572 MapHostToNetwork(vllist);
4573 EnumerateEntry(vllist);
4575 PrintLocked(vllist->flags);
4579 /* So we sort. First we must collect all the entries and keep
4582 else if (centries > 0) {
4584 /* malloc the first bulk entries array */
4585 tarraysize = centries * sizeof(struct nvldbentry);
4586 tarray = malloc(tarraysize);
4589 "Could not allocate enough space for the VLDB entries\n");
4592 memcpy((char*)tarray, arrayEntries.nbulkentries_val, tarraysize);
4594 /* Grow the tarray to keep the extra entries */
4595 parraysize = (centries * sizeof(struct nvldbentry));
4597 (struct nvldbentry *)realloc(tarray,
4598 tarraysize + parraysize);
4601 "Could not allocate enough space for the VLDB entries\n");
4607 memcpy(((char *)tarray) + tarraysize,
4608 (char *)arrayEntries.nbulkentries_val, parraysize);
4609 tarraysize += parraysize;
4613 /* Free the bulk array */
4614 xdr_free((xdrproc_t) xdr_nbulkentries, &arrayEntries);
4617 /* Here is where we now sort all the entries and print them */
4618 if (sort && (nentries > 0)) {
4619 qsort((char *)tarray, nentries, sizeof(struct nvldbentry),
4620 CompareVldbEntryByName);
4621 for (vllist = tarray, j = 0; j < nentries; j++, vllist++) {
4622 MapHostToNetwork(vllist);
4623 EnumerateEntry(vllist);
4625 PrintLocked(vllist->flags);
4631 fprintf(STDOUT, "\nTotal entries: %lu\n", (unsigned long)nentries);
4638 BackSys(struct cmd_syndesc *as, void *arock)
4641 afs_int32 apart = 0;
4642 afs_uint32 aserver = 0, aserver1;
4643 afs_int32 code, apart1;
4645 struct VldbListByAttributes attributes;
4646 nbulkentries arrayEntries;
4647 struct nvldbentry *vllist;
4651 int seenprefix, seenxprefix, exclude, ex, exp, noaction;
4652 afs_int32 totalBack = 0;
4653 afs_int32 totalFail = 0;
4657 struct cmd_item *ti;
4659 #ifndef HAVE_POSIX_REGEX
4663 memset(&attributes, 0, sizeof(struct VldbListByAttributes));
4664 attributes.Mask = 0;
4666 seenprefix = (as->parms[0].items ? 1 : 0);
4667 exclude = (as->parms[3].items ? 1 : 0);
4668 seenxprefix = (as->parms[4].items ? 1 : 0);
4669 noaction = (as->parms[5].items ? 1 : 0);
4671 if (as->parms[1].items) { /* -server */
4672 aserver = GetServer(as->parms[1].items->data);
4674 fprintf(STDERR, "vos: server '%s' not found in host table\n",
4675 as->parms[1].items->data);
4678 attributes.server = ntohl(aserver);
4679 attributes.Mask |= VLLIST_SERVER;
4682 if (as->parms[2].items) { /* -partition */
4683 apart = volutil_GetPartitionID(as->parms[2].items->data);
4685 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
4686 as->parms[2].items->data);
4689 attributes.partition = apart;
4690 attributes.Mask |= VLLIST_PARTITION;
4693 /* Check to make sure the prefix and xprefix expressions compile ok */
4695 for (ti = as->parms[0].items; ti; ti = ti->next) {
4696 if (strncmp(ti->data, "^", 1) == 0) {
4697 #ifdef HAVE_POSIX_REGEX
4701 code = regcomp(&re, ti->data, REG_NOSUB);
4703 regerror(code, &re, errbuf, sizeof errbuf);
4705 "Unrecognizable -prefix regular expression: '%s': %s\n",
4711 ccode = (char *)re_comp(ti->data);
4714 "Unrecognizable -prefix regular expression: '%s': %s\n",
4723 for (ti = as->parms[4].items; ti; ti = ti->next) {
4724 if (strncmp(ti->data, "^", 1) == 0) {
4725 #ifdef HAVE_POSIX_REGEX
4729 code = regcomp(&re, ti->data, REG_NOSUB);
4731 regerror(code, &re, errbuf, sizeof errbuf);
4733 "Unrecognizable -xprefix regular expression: '%s': %s\n",
4739 ccode = (char *)re_comp(ti->data);
4742 "Unrecognizable -xprefix regular expression: '%s': %s\n",
4751 memset(&arrayEntries, 0, sizeof(arrayEntries)); /* initialize to hint the stub to alloc space */
4752 vcode = VLDB_ListAttributes(&attributes, &nentries, &arrayEntries);
4754 fprintf(STDERR, "Could not access the VLDB for attributes\n");
4755 PrintError("", vcode);
4759 if (as->parms[1].items || as->parms[2].items || verbose) {
4760 fprintf(STDOUT, "%s up volumes",
4761 (noaction ? "Would have backed" : "Backing"));
4763 if (as->parms[1].items) {
4764 fprintf(STDOUT, " on server %s", as->parms[1].items->data);
4765 } else if (as->parms[2].items) {
4766 fprintf(STDOUT, " for all servers");
4769 if (as->parms[2].items) {
4770 MapPartIdIntoName(apart, pname);
4771 fprintf(STDOUT, " partition %s", pname);
4774 if (seenprefix || (!seenprefix && seenxprefix)) {
4775 ti = (seenprefix ? as->parms[0].items : as->parms[4].items);
4776 ex = (seenprefix ? exclude : !exclude);
4777 exp = (strncmp(ti->data, "^", 1) == 0);
4778 fprintf(STDOUT, " which %smatch %s '%s'", (ex ? "do not " : ""),
4779 (exp ? "expression" : "prefix"), ti->data);
4780 for (ti = ti->next; ti; ti = ti->next) {
4781 exp = (strncmp(ti->data, "^", 1) == 0);
4782 printf(" %sor %s '%s'", (ex ? "n" : ""),
4783 (exp ? "expression" : "prefix"), ti->data);
4787 if (seenprefix && seenxprefix) {
4788 ti = as->parms[4].items;
4789 exp = (strncmp(ti->data, "^", 1) == 0);
4790 fprintf(STDOUT, " %swhich match %s '%s'",
4791 (exclude ? "adding those " : "removing those "),
4792 (exp ? "expression" : "prefix"), ti->data);
4793 for (ti = ti->next; ti; ti = ti->next) {
4794 exp = (strncmp(ti->data, "^", 1) == 0);
4795 printf(" or %s '%s'", (exp ? "expression" : "prefix"),
4799 fprintf(STDOUT, " .. ");
4801 fprintf(STDOUT, "\n");
4805 for (j = 0; j < nentries; j++) { /* process each vldb entry */
4806 vllist = &arrayEntries.nbulkentries_val[j];
4809 for (ti = as->parms[0].items; ti; ti = ti->next) {
4810 if (strncmp(ti->data, "^", 1) == 0) {
4811 #ifdef HAVE_POSIX_REGEX
4815 /* XXX -- should just do the compile once! */
4816 code = regcomp(&re, ti->data, REG_NOSUB);
4818 regerror(code, &re, errbuf, sizeof errbuf);
4820 "Error in -prefix regular expression: '%s': %s\n",
4824 match = (regexec(&re, vllist->name, 0, NULL, 0) == 0);
4827 ccode = (char *)re_comp(ti->data);
4830 "Error in -prefix regular expression: '%s': %s\n",
4834 match = (re_exec(vllist->name) == 1);
4838 (strncmp(vllist->name, ti->data, strlen(ti->data)) ==
4848 /* Without the -exclude flag: If it matches the prefix, then
4849 * check if we want to exclude any from xprefix.
4850 * With the -exclude flag: If it matches the prefix, then
4851 * check if we want to add any from xprefix.
4853 if (match && seenxprefix) {
4854 for (ti = as->parms[4].items; ti; ti = ti->next) {
4855 if (strncmp(ti->data, "^", 1) == 0) {
4856 #ifdef HAVE_POSIX_REGEX
4860 /* XXX -- should just do the compile once! */
4861 code = regcomp(&re, ti->data, REG_NOSUB);
4863 regerror(code, &re, errbuf, sizeof errbuf);
4865 "Error in -xprefix regular expression: '%s': %s\n",
4869 if (regexec(&re, vllist->name, 0, NULL, 0) == 0)
4873 ccode = (char *)re_comp(ti->data);
4876 "Error in -xprefix regular expression: '%s': %s\n",
4880 if (re_exec(vllist->name) == 1) {
4886 if (strncmp(vllist->name, ti->data, strlen(ti->data)) ==
4896 match = !match; /* -exclude will reverse the match */
4898 continue; /* Skip if no match */
4900 /* Print list of volumes to backup */
4902 fprintf(STDOUT, " %s\n", vllist->name);
4906 if (!(vllist->flags & RW_EXISTS)) {
4909 "Omitting to backup %s since RW volume does not exist \n",
4911 fprintf(STDOUT, "\n");
4917 avolid = vllist->volumeId[RWVOL];
4918 MapHostToNetwork(vllist);
4919 GetServerAndPart(vllist, RWVOL, &aserver1, &apart1, &previdx);
4920 if (aserver1 == -1 || apart1 == -1) {
4921 fprintf(STDOUT, "could not backup %s, invalid VLDB entry\n",
4927 same = VLDB_IsSameAddrs(aserver, aserver1, &error);
4930 "Failed to get info about server's %d address(es) from vlserver (err=%d); aborting call!\n",
4936 if ((aserver && !same) || (apart && (apart != apart1))) {
4939 "Omitting to backup %s since the RW is in a different location\n",
4945 time_t now = time(0);
4946 fprintf(STDOUT, "Creating backup volume for %s on %s",
4947 vllist->name, ctime(&now));
4951 code = UV_BackupVolume(aserver1, apart1, avolid);
4953 fprintf(STDOUT, "Could not backup %s\n", vllist->name);
4959 fprintf(STDOUT, "\n");
4961 } /* process each vldb entry */
4962 fprintf(STDOUT, "done\n");
4963 fprintf(STDOUT, "Total volumes backed up: %lu; failed to backup: %lu\n",
4964 (unsigned long)totalBack, (unsigned long)totalFail);
4966 xdr_free((xdrproc_t) xdr_nbulkentries, &arrayEntries);
4971 UnlockVLDB(struct cmd_syndesc *as, void *arock)
4974 afs_uint32 aserver = 0;
4977 struct VldbListByAttributes attributes;
4978 nbulkentries arrayEntries;
4979 struct nvldbentry *vllist;
4988 attributes.Mask = 0;
4990 if (as->parms[0].items) { /* server specified */
4991 aserver = GetServer(as->parms[0].items->data);
4993 fprintf(STDERR, "vos: server '%s' not found in host table\n",
4994 as->parms[0].items->data);
4997 attributes.server = ntohl(aserver);
4998 attributes.Mask |= VLLIST_SERVER;
5000 if (as->parms[1].items) { /* partition specified */
5001 apart = volutil_GetPartitionID(as->parms[1].items->data);
5003 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
5004 as->parms[1].items->data);
5007 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
5009 PrintError("", code);
5012 "vos : partition %s does not exist on the server\n",
5013 as->parms[1].items->data);
5016 attributes.partition = apart;
5017 attributes.Mask |= VLLIST_PARTITION;
5019 attributes.flag = VLOP_ALLOPERS;
5020 attributes.Mask |= VLLIST_FLAG;
5021 memset(&arrayEntries, 0, sizeof(arrayEntries)); /*initialize to hint the stub to alloc space */
5022 vcode = VLDB_ListAttributes(&attributes, &nentries, &arrayEntries);
5024 fprintf(STDERR, "Could not access the VLDB for attributes\n");
5025 PrintError("", vcode);
5028 for (j = 0; j < nentries; j++) { /* process each entry */
5029 vllist = &arrayEntries.nbulkentries_val[j];
5030 volid = vllist->volumeId[RWVOL];
5032 ubik_VL_ReleaseLock(cstruct, 0, volid, -1,
5033 LOCKREL_OPCODE | LOCKREL_AFSID |
5036 fprintf(STDERR, "Could not unlock entry for volume %s\n",
5038 PrintError("", vcode);
5043 MapPartIdIntoName(apart, pname);
5046 "Could not lock %lu VLDB entries of %lu locked entries\n",
5047 (unsigned long)totalE, (unsigned long)nentries);
5049 if (as->parms[0].items) {
5051 "Unlocked all the VLDB entries for volumes on server %s ",
5052 as->parms[0].items->data);
5053 if (as->parms[1].items) {
5054 MapPartIdIntoName(apart, pname);
5055 fprintf(STDOUT, "partition %s\n", pname);
5057 fprintf(STDOUT, "\n");
5059 } else if (as->parms[1].items) {
5060 MapPartIdIntoName(apart, pname);
5062 "Unlocked all the VLDB entries for volumes on partition %s on all servers\n",
5067 xdr_free((xdrproc_t) xdr_nbulkentries, &arrayEntries);
5072 PrintInt64Size(afs_uint64 in)
5076 static char output[16];
5078 SplitInt64(in,hi,lo);
5082 } else if (!(hi & 0xFFFFFC00)) {
5084 lo = (hi << 22) | (lo >> 10);
5085 } else if (!(hi & 0xFFF00000)) {
5087 lo = (hi << 12) | (lo >> 20);
5088 } else if (!(hi & 0xC0000000)) {
5090 lo = (hi << 2) | (lo >> 30);
5095 sprintf(output,"%u %s", lo, units);
5100 PartitionInfo(struct cmd_syndesc *as, void *arock)
5106 struct diskPartition64 partition;
5107 struct partList dummyPartList;
5109 int printSummary=0, sumPartitions=0;
5110 afs_uint64 sumFree, sumStorage;
5113 ZeroInt64(sumStorage);
5115 aserver = GetServer(as->parms[0].items->data);
5117 fprintf(STDERR, "vos: server '%s' not found in host table\n",
5118 as->parms[0].items->data);
5121 if (as->parms[1].items) {
5122 apart = volutil_GetPartitionID(as->parms[1].items->data);
5124 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
5125 as->parms[1].items->data);
5128 dummyPartList.partId[0] = apart;
5129 dummyPartList.partFlags[0] = PARTVALID;
5132 if (as->parms[2].items) {
5136 if (!IsPartValid(apart, aserver, &code)) { /*check for validity of the partition */
5138 PrintError("", code);
5141 "vos : partition %s does not exist on the server\n",
5142 as->parms[1].items->data);
5146 code = UV_ListPartitions(aserver, &dummyPartList, &cnt);
5148 PrintDiagnostics("listpart", code);
5152 for (i = 0; i < cnt; i++) {
5153 if (dummyPartList.partFlags[i] & PARTVALID) {
5154 MapPartIdIntoName(dummyPartList.partId[i], pname);
5155 code = UV_PartitionInfo64(aserver, pname, &partition);
5157 fprintf(STDERR, "Could not get information on partition %s\n",
5159 PrintError("", code);
5163 "Free space on partition %s: %" AFS_INT64_FMT " K blocks out of total %" AFS_INT64_FMT "\n",
5164 pname, partition.free, partition.minFree);
5166 AddUInt64(sumFree,partition.free,&sumFree);
5167 AddUInt64(sumStorage,partition.minFree,&sumStorage);
5172 "Summary: %s free out of ",
5173 PrintInt64Size(sumFree));
5175 "%s on %d partitions\n",
5176 PrintInt64Size(sumStorage),
5183 ChangeAddr(struct cmd_syndesc *as, void *arock)
5185 afs_int32 ip1, ip2, vcode;
5189 ip1 = GetServerNoresolve(as->parms[0].items->data);
5191 ip1 = GetServer(as->parms[0].items->data);
5193 fprintf(STDERR, "vos: invalid host address\n");
5197 if ((as->parms[1].items && as->parms[2].items)
5198 || (!as->parms[1].items && !as->parms[2].items)) {
5200 "vos: Must specify either '-newaddr <addr>' or '-remove' flag\n");
5204 if (as->parms[1].items) {
5206 ip2 = GetServerNoresolve(as->parms[1].items->data);
5208 ip2 = GetServer(as->parms[1].items->data);
5210 fprintf(STDERR, "vos: invalid host address\n");
5214 /* Play a trick here. If we are removing an address, ip1 will be -1
5215 * and ip2 will be the original address. This switch prevents an
5216 * older revision vlserver from removing the IP address.
5223 vcode = ubik_VL_ChangeAddr(cstruct, UBIK_CALL_NEW, ntohl(ip1), ntohl(ip2));
5225 char hoststr1[16], hoststr2[16];
5227 afs_inet_ntoa_r(ip2, hoststr2);
5228 fprintf(STDERR, "Could not remove server %s from the VLDB\n",
5230 if (vcode == VL_NOENT) {
5232 "vlserver does not support the remove flag or ");
5235 afs_inet_ntoa_r(ip1, hoststr1);
5236 afs_inet_ntoa_r(ip2, hoststr2);
5237 fprintf(STDERR, "Could not change server %s to server %s\n",
5238 hoststr1, hoststr2);
5240 PrintError("", vcode);
5245 fprintf(STDOUT, "Removed server %s from the VLDB\n",
5246 as->parms[0].items->data);
5248 fprintf(STDOUT, "Changed server %s to server %s\n",
5249 as->parms[0].items->data, as->parms[1].items->data);
5255 print_addrs(const bulkaddrs * addrs, afsUUID * m_uuid, int nentries,
5263 afsUUID_to_string(m_uuid, buf, sizeof(buf));
5264 printf("UUID: %s\n", buf);
5267 /* print out the list of all the server */
5268 addrp = (afs_uint32 *) addrs->bulkaddrs_val;
5269 for (i = 0; i < nentries; i++, addrp++) {
5270 *addrp = htonl(*addrp);
5273 printf("%s\n", afs_inet_ntoa_r(*addrp, hoststr));
5275 printf("%s\n", hostutil_GetNameByINet(*addrp));
5286 ListAddrs(struct cmd_syndesc *as, void *arock)
5288 afs_int32 vcode, m_uniq=0;
5289 afs_int32 i, printuuid = 0;
5290 struct VLCallBack vlcb;
5293 ListAddrByAttributes m_attrs;
5294 afsUUID m_uuid, askuuid;
5295 afs_int32 m_nentries;
5297 if (as->parms[0].items && as->parms[1].items) {
5298 fprintf(STDERR, "vos: Can't use the -uuid and -host flags together\n");
5302 memset(&m_attrs, 0, sizeof(struct ListAddrByAttributes));
5303 memset(&askuuid, 0, sizeof(afsUUID));
5304 if (as->parms[0].items) {
5306 if (afsUUID_from_string(as->parms[0].items->data, &askuuid) < 0) {
5307 fprintf(STDERR, "vos: invalid UUID '%s'\n",
5308 as->parms[0].items->data);
5311 m_attrs.Mask = VLADDR_UUID;
5312 m_attrs.uuid = askuuid;
5313 } else if (as->parms[1].items) {
5317 he = hostutil_GetHostByName((char *)as->parms[1].items->data);
5319 fprintf(STDERR, "vos: Can't get host info for '%s'\n",
5320 as->parms[1].items->data);
5323 memcpy(&saddr, he->h_addr, 4);
5324 m_attrs.Mask = VLADDR_IPADDR;
5325 m_attrs.ipaddr = ntohl(saddr);
5328 m_attrs.Mask = VLADDR_INDEX;
5331 if (as->parms[2].items) {
5335 memset(&m_addrs, 0, sizeof(bulkaddrs));
5336 memset(&vlcb, 0, sizeof(struct VLCallBack));
5339 ubik_VL_GetAddrs(cstruct, UBIK_CALL_NEW, 0, 0, &vlcb, &nentries,
5342 fprintf(STDERR, "vos: could not list the server addresses\n");
5343 PrintError("", vcode);
5347 for (i = 1, m_nentries = 0; nentries; i++) {
5350 xdr_free((xdrproc_t)xdr_bulkaddrs, &m_addrs); /* reset addr list */
5352 ubik_VL_GetAddrsU(cstruct, UBIK_CALL_NEW, &m_attrs, &m_uuid,
5353 &m_uniq, &m_nentries, &m_addrs);
5355 case 0: /* success */
5356 print_addrs(&m_addrs, &m_uuid, m_nentries, printuuid);
5361 if (m_attrs.Mask == VLADDR_UUID) {
5362 fprintf(STDERR, "vos: no entry for UUID '%s' found in VLDB\n",
5363 as->parms[0].items->data);
5365 } else if (m_attrs.Mask == VLADDR_IPADDR) {
5366 fprintf(STDERR, "vos: no entry for host '%s' [0x%08x] found in VLDB\n",
5367 as->parms[1].items->data, m_attrs.ipaddr);
5372 case VL_INDEXERANGE:
5373 vcode = 0; /* not an error, just means we're done */
5376 default: /* any other error */
5377 fprintf(STDERR, "vos: could not list the server addresses\n");
5378 PrintError("", vcode);
5382 /* if -uuid or -host, only list one response */
5383 if (as->parms[1].items || as->parms[0].items)
5388 xdr_free((xdrproc_t)xdr_bulkaddrs, &m_addrs);
5394 SetAddrs(struct cmd_syndesc *as, void *arock)
5399 afs_uint32 FS_HostAddrs_HBO[ADDRSPERSITE];
5401 memset(&m_addrs, 0, sizeof(bulkaddrs));
5402 memset(&askuuid, 0, sizeof(afsUUID));
5403 if (as->parms[0].items) {
5405 if (afsUUID_from_string(as->parms[0].items->data, &askuuid) < 0) {
5406 fprintf(STDERR, "vos: invalid UUID '%s'\n",
5407 as->parms[0].items->data);
5411 if (as->parms[1].items) {
5413 struct cmd_item *ti;
5417 for (ti = as->parms[1].items; ti && i < ADDRSPERSITE; ti = ti->next) {
5420 saddr = GetServerNoresolve(ti->data);
5422 saddr = GetServer(ti->data);
5425 fprintf(STDERR, "vos: Can't get host info for '%s'\n",
5429 /* Convert it to host byte order */
5430 FS_HostAddrs_HBO[i] = ntohl(saddr);
5433 m_addrs.bulkaddrs_len = i;
5434 m_addrs.bulkaddrs_val = FS_HostAddrs_HBO;
5437 vcode = ubik_VL_RegisterAddrs(cstruct, 0, &askuuid, 0, &m_addrs);
5440 if (vcode == VL_MULTIPADDR) {
5441 fprintf(STDERR, "vos: VL_RegisterAddrs rpc failed; The IP address exists on a different server; repair it\n");
5442 PrintError("", vcode);
5444 } else if (vcode == RXGEN_OPCODE) {
5445 fprintf(STDERR, "vlserver doesn't support VL_RegisterAddrs rpc; ignored\n");
5446 PrintError("", vcode);
5451 fprintf(STDOUT, "vos: Changed UUID with addresses:\n");
5452 print_addrs(&m_addrs, &askuuid, m_addrs.bulkaddrs_len, 1);
5458 LockEntry(struct cmd_syndesc *as, void *arock)
5461 afs_int32 vcode, err;
5463 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
5466 PrintError("", err);
5468 fprintf(STDERR, "vos: can't find volume '%s'\n",
5469 as->parms[0].items->data);
5472 vcode = ubik_VL_SetLock(cstruct, 0, avolid, -1, VLOP_DELETE);
5474 fprintf(STDERR, "Could not lock VLDB entry for volume %s\n",
5475 as->parms[0].items->data);
5476 PrintError("", vcode);
5479 fprintf(STDOUT, "Locked VLDB entry for volume %s\n",
5480 as->parms[0].items->data);
5485 ConvertRO(struct cmd_syndesc *as, void *arock)
5487 afs_int32 partition = -1;
5490 afs_int32 code, i, same;
5491 struct nvldbentry entry, storeEntry;
5493 afs_int32 rwindex = 0;
5494 afs_uint32 rwserver = 0;
5495 afs_int32 rwpartition = 0;
5496 afs_int32 roindex = 0;
5497 afs_uint32 roserver = 0;
5498 afs_int32 ropartition = 0;
5500 struct rx_connection *aconn;
5503 server = GetServer(as->parms[0].items->data);
5505 fprintf(STDERR, "vos: host '%s' not found in host table\n",
5506 as->parms[0].items->data);
5509 partition = volutil_GetPartitionID(as->parms[1].items->data);
5510 if (partition < 0) {
5511 fprintf(STDERR, "vos: could not interpret partition name '%s'\n",
5512 as->parms[1].items->data);
5515 if (!IsPartValid(partition, server, &code)) {
5517 PrintError("", code);
5520 "vos : partition %s does not exist on the server\n",
5521 as->parms[1].items->data);
5524 volid = vsu_GetVolumeID(as->parms[2].items->data, cstruct, &code);
5527 PrintError("", code);
5529 fprintf(STDERR, "Unknown volume ID or name '%s'\n",
5530 as->parms[0].items->data);
5533 if (as->parms[3].items)
5536 vcode = VLDB_GetEntryByID(volid, -1, &entry);
5539 "Could not fetch the entry for volume %lu from VLDB\n",
5540 (unsigned long)volid);
5541 PrintError("convertROtoRW", code);
5545 /* use RO volid even if user specified RW or BK volid */
5547 if (volid != entry.volumeId[ROVOL])
5548 volid = entry.volumeId[ROVOL];
5550 MapHostToNetwork(&entry);
5551 for (i = 0; i < entry.nServers; i++) {
5552 if (entry.serverFlags[i] & ITSRWVOL) {
5554 rwserver = entry.serverNumber[i];
5555 rwpartition = entry.serverPartition[i];
5557 if (entry.serverFlags[i] & ITSROVOL) {
5558 same = VLDB_IsSameAddrs(server, entry.serverNumber[i], &code);
5561 "Failed to get info about server's %d address(es) from vlserver (err=%d); aborting call!\n",
5567 roserver = entry.serverNumber[i];
5568 ropartition = entry.serverPartition[i];
5574 fprintf(STDERR, "Warning: RO volume didn't exist in vldb!\n");
5576 if (ropartition != partition) {
5578 "Warning: RO volume should be in partition %d instead of %d (vldb)\n",
5579 ropartition, partition);
5584 "VLDB indicates that a RW volume exists already on %s in partition %s.\n",
5585 hostutil_GetNameByINet(rwserver),
5586 volutil_PartitionName(rwpartition));
5588 fprintf(STDERR, "Overwrite this VLDB entry? [y|n] (n)\n");
5590 while (!(dc == EOF || dc == '\n'))
5591 dc = getchar(); /* goto end of line */
5592 if ((c != 'y') && (c != 'Y')) {
5593 fprintf(STDERR, "aborted.\n");
5600 ubik_VL_SetLock(cstruct, 0, entry.volumeId[RWVOL], RWVOL,
5602 aconn = UV_Bind(server, AFSCONF_VOLUMEPORT);
5603 code = AFSVolConvertROtoRWvolume(aconn, partition, volid);
5606 "Converting RO volume %lu to RW volume failed with code %d\n",
5607 (unsigned long)volid, code);
5608 PrintError("convertROtoRW ", code);
5611 entry.serverFlags[roindex] = ITSRWVOL;
5612 entry.flags |= RW_EXISTS;
5613 entry.flags &= ~BACK_EXISTS;
5616 if (rwindex != entry.nServers) {
5617 entry.serverNumber[rwindex] = entry.serverNumber[entry.nServers];
5618 entry.serverPartition[rwindex] =
5619 entry.serverPartition[entry.nServers];
5620 entry.serverFlags[rwindex] = entry.serverFlags[entry.nServers];
5621 entry.serverNumber[entry.nServers] = 0;
5622 entry.serverPartition[entry.nServers] = 0;
5623 entry.serverFlags[entry.nServers] = 0;
5626 entry.flags &= ~RO_EXISTS;
5627 for (i = 0; i < entry.nServers; i++) {
5628 if (entry.serverFlags[i] & ITSROVOL) {
5629 if (!(entry.serverFlags[i] & (RO_DONTUSE | NEW_REPSITE)))
5630 entry.flags |= RO_EXISTS;
5633 MapNetworkToHost(&entry, &storeEntry);
5635 VLDB_ReplaceEntry(entry.volumeId[RWVOL], RWVOL, &storeEntry,
5636 (LOCKREL_OPCODE | LOCKREL_AFSID |
5637 LOCKREL_TIMESTAMP));
5640 "Warning: volume converted, but vldb update failed with code %d!\n",
5643 vcode = UV_LockRelease(entry.volumeId[RWVOL]);
5645 PrintDiagnostics("unlock", vcode);
5651 Sizes(struct cmd_syndesc *as, void *arock)
5655 afs_int32 apart, voltype, fromdate = 0, code, err, i;
5656 struct nvldbentry entry;
5657 volintSize vol_size;
5659 rx_SetRxDeadTime(60 * 10);
5660 for (i = 0; i < MAXSERVERS; i++) {
5661 struct rx_connection *rxConn = ubik_GetRPCConn(cstruct, i);
5664 rx_SetConnDeadTime(rxConn, rx_connDeadTime);
5665 if (rxConn->service)
5666 rxConn->service->connDeadTime = rx_connDeadTime;
5669 avolid = vsu_GetVolumeID(as->parms[0].items->data, cstruct, &err);
5672 PrintError("", err);
5674 fprintf(STDERR, "vos: can't find volume '%s'\n",
5675 as->parms[0].items->data);
5679 if (as->parms[1].items || as->parms[2].items) {
5680 if (!as->parms[1].items || !as->parms[2].items) {
5682 "Must specify both -server and -partition options\n");
5685 aserver = GetServer(as->parms[2].items->data);
5687 fprintf(STDERR, "Invalid server name\n");
5690 apart = volutil_GetPartitionID(as->parms[1].items->data);
5692 fprintf(STDERR, "Invalid partition name\n");
5696 code = GetVolumeInfo(avolid, &aserver, &apart, &voltype, &entry);
5703 if (as->parms[4].items && strcmp(as->parms[4].items->data, "0")) {
5704 code = ktime_DateToInt32(as->parms[4].items->data, &fromdate);
5706 fprintf(STDERR, "vos: failed to parse date '%s' (error=%d))\n",
5707 as->parms[4].items->data, code);
5712 fprintf(STDOUT, "Volume: %s\n", as->parms[0].items->data);
5714 if (as->parms[3].items) { /* do the dump estimate */
5715 vol_size.dump_size = 0;
5716 code = UV_GetSize(avolid, aserver, apart, fromdate, &vol_size);
5718 PrintDiagnostics("size", code);
5721 /* presumably the size info is now gathered in pntr */
5722 /* now we display it */
5724 fprintf(STDOUT, "dump_size: %llu\n", vol_size.dump_size);
5733 EndTrans(struct cmd_syndesc *as, void *arock)
5736 afs_int32 code, tid, rcode;
5737 struct rx_connection *aconn;
5739 server = GetServer(as->parms[0].items->data);
5741 fprintf(STDERR, "vos: host '%s' not found in host table\n",
5742 as->parms[0].items->data);
5746 code = util_GetInt32(as->parms[1].items->data, &tid);
5748 fprintf(STDERR, "vos: bad integer specified for transaction ID.\n");
5752 aconn = UV_Bind(server, AFSCONF_VOLUMEPORT);
5753 code = AFSVolEndTrans(aconn, tid, &rcode);
5759 PrintDiagnostics("endtrans", code);
5767 PrintDiagnostics(char *astring, afs_int32 acode)
5769 if (acode == EACCES) {
5771 "You are not authorized to perform the 'vos %s' command (%d)\n",
5774 fprintf(STDERR, "Error in vos %s command.\n", astring);
5775 PrintError("", acode);
5783 win32_enableCrypt(void)
5790 /* Look up configuration parameters in Registry */
5791 code = RegOpenKeyEx(HKEY_LOCAL_MACHINE, AFSREG_CLT_SVC_PARAM_SUBKEY,
5792 0, (IsWow64()?KEY_WOW64_64KEY:0)|KEY_QUERY_VALUE, &parmKey);
5793 if (code != ERROR_SUCCESS) {
5794 dummyLen = sizeof(cryptall);
5795 RegQueryValueEx(parmKey, "SecurityLevel", NULL, NULL,
5796 (BYTE *) &cryptall, &dummyLen);
5798 RegCloseKey (parmKey);
5802 #endif /* AFS_NT40_ENV */
5805 MyBeforeProc(struct cmd_syndesc *as, void *arock)
5811 /* Initialize the ubik_client connection */
5812 rx_SetRxDeadTime(90);
5813 cstruct = (struct ubik_client *)0;
5817 if (as->parms[12].items) /* if -cell specified */
5818 tcell = as->parms[12].items->data;
5819 if (as->parms[14].items) /* -serverauth specified */
5821 if (as->parms[16].items /* -encrypt specified */
5823 || win32_enableCrypt()
5824 #endif /* AFS_NT40_ENV */
5828 if (as->parms[18].items) /* -config flag set */
5829 confdir = as->parms[18].items->data;
5832 vsu_ClientInit((as->parms[13].items != 0), confdir, tcell, sauth,
5833 &cstruct, UV_SetSecurity))) {
5834 fprintf(STDERR, "could not initialize VLDB library (code=%lu) \n",
5835 (unsigned long)code);
5839 if (as->parms[15].items) /* -verbose flag set */
5843 if (as->parms[17].items) /* -noresolve flag set */
5854 /* this sucks but it works for now.
5859 #include "AFS_component_version_number.c"
5862 main(int argc, char **argv)
5866 struct cmd_syndesc *ts;
5868 #ifdef AFS_AIX32_ENV
5870 * The following signal action for AIX is necessary so that in case of a
5871 * crash (i.e. core is generated) we can include the user's data section
5872 * in the core dump. Unfortunately, by default, only a partial core is
5873 * generated which, in many cases, isn't too useful.
5875 struct sigaction nsa;
5877 sigemptyset(&nsa.sa_mask);
5878 nsa.sa_handler = SIG_DFL;
5879 nsa.sa_flags = SA_FULLDUMP;
5880 sigaction(SIGSEGV, &nsa, NULL);
5883 confdir = AFSDIR_CLIENT_ETC_DIRPATH;
5885 cmd_SetBeforeProc(MyBeforeProc, NULL);
5887 ts = cmd_CreateSyntax("create", CreateVolume, NULL, "create a new volume");
5888 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
5889 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
5890 cmd_AddParm(ts, "-name", CMD_SINGLE, 0, "volume name");
5891 cmd_AddParm(ts, "-maxquota", CMD_SINGLE, CMD_OPTIONAL,
5892 "initial quota (KB)");
5893 cmd_AddParm(ts, "-id", CMD_SINGLE, CMD_OPTIONAL, "volume ID");
5894 cmd_AddParm(ts, "-roid", CMD_SINGLE, CMD_OPTIONAL, "readonly volume ID");
5896 cmd_AddParm(ts, "-minquota", CMD_SINGLE, CMD_OPTIONAL, "");
5900 ts = cmd_CreateSyntax("remove", DeleteVolume, NULL, "delete a volume");
5901 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
5902 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
5903 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5907 ts = cmd_CreateSyntax("move", MoveVolume, NULL, "move a volume");
5908 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5909 cmd_AddParm(ts, "-fromserver", CMD_SINGLE, 0, "machine name on source");
5910 cmd_AddParm(ts, "-frompartition", CMD_SINGLE, 0,
5911 "partition name on source");
5912 cmd_AddParm(ts, "-toserver", CMD_SINGLE, 0,
5913 "machine name on destination");
5914 cmd_AddParm(ts, "-topartition", CMD_SINGLE, 0,
5915 "partition name on destination");
5916 cmd_AddParm(ts, "-live", CMD_FLAG, CMD_OPTIONAL,
5917 "copy live volume without cloning");
5920 ts = cmd_CreateSyntax("copy", CopyVolume, NULL, "copy a volume");
5921 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID on source");
5922 cmd_AddParm(ts, "-fromserver", CMD_SINGLE, 0, "machine name on source");
5923 cmd_AddParm(ts, "-frompartition", CMD_SINGLE, 0,
5924 "partition name on source");
5925 cmd_AddParm(ts, "-toname", CMD_SINGLE, 0, "volume name on destination");
5926 cmd_AddParm(ts, "-toserver", CMD_SINGLE, 0,
5927 "machine name on destination");
5928 cmd_AddParm(ts, "-topartition", CMD_SINGLE, 0,
5929 "partition name on destination");
5930 cmd_AddParm(ts, "-offline", CMD_FLAG, CMD_OPTIONAL,
5931 "leave new volume offline");
5932 cmd_AddParm(ts, "-readonly", CMD_FLAG, CMD_OPTIONAL,
5933 "make new volume read-only");
5934 cmd_AddParm(ts, "-live", CMD_FLAG, CMD_OPTIONAL,
5935 "copy live volume without cloning");
5938 ts = cmd_CreateSyntax("shadow", ShadowVolume, NULL,
5939 "make or update a shadow volume");
5940 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID on source");
5941 cmd_AddParm(ts, "-fromserver", CMD_SINGLE, 0, "machine name on source");
5942 cmd_AddParm(ts, "-frompartition", CMD_SINGLE, 0,
5943 "partition name on source");
5944 cmd_AddParm(ts, "-toserver", CMD_SINGLE, 0,
5945 "machine name on destination");
5946 cmd_AddParm(ts, "-topartition", CMD_SINGLE, 0,
5947 "partition name on destination");
5948 cmd_AddParm(ts, "-toname", CMD_SINGLE, CMD_OPTIONAL,
5949 "volume name on destination");
5950 cmd_AddParm(ts, "-toid", CMD_SINGLE, CMD_OPTIONAL,
5951 "volume ID on destination");
5952 cmd_AddParm(ts, "-offline", CMD_FLAG, CMD_OPTIONAL,
5953 "leave shadow volume offline");
5954 cmd_AddParm(ts, "-readonly", CMD_FLAG, CMD_OPTIONAL,
5955 "make shadow volume read-only");
5956 cmd_AddParm(ts, "-live", CMD_FLAG, CMD_OPTIONAL,
5957 "copy live volume without cloning");
5958 cmd_AddParm(ts, "-incremental", CMD_FLAG, CMD_OPTIONAL,
5959 "do incremental update if target exists");
5962 ts = cmd_CreateSyntax("backup", BackupVolume, NULL,
5963 "make backup of a volume");
5964 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5967 ts = cmd_CreateSyntax("clone", CloneVolume, NULL,
5968 "make clone of a volume");
5969 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5970 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "server");
5971 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition");
5972 cmd_AddParm(ts, "-toname", CMD_SINGLE, CMD_OPTIONAL,
5973 "volume name on destination");
5974 cmd_AddParm(ts, "-toid", CMD_SINGLE, CMD_OPTIONAL,
5975 "volume ID on destination");
5976 cmd_AddParm(ts, "-offline", CMD_FLAG, CMD_OPTIONAL,
5977 "leave clone volume offline");
5978 cmd_AddParm(ts, "-readonly", CMD_FLAG, CMD_OPTIONAL,
5979 "make clone volume read-only, not readwrite");
5982 ts = cmd_CreateSyntax("release", ReleaseVolume, NULL, "release a volume");
5983 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5984 cmd_AddParm(ts, "-force", CMD_FLAG, CMD_OPTIONAL,
5985 "force a complete release");
5988 ts = cmd_CreateSyntax("dump", DumpVolumeCmd, NULL, "dump a volume");
5989 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
5990 cmd_AddParm(ts, "-time", CMD_SINGLE, CMD_OPTIONAL, "dump from time");
5991 cmd_AddParm(ts, "-file", CMD_SINGLE, CMD_OPTIONAL, "dump file");
5992 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "server");
5993 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition");
5994 cmd_AddParm(ts, "-clone", CMD_FLAG, CMD_OPTIONAL,
5995 "dump a clone of the volume");
5996 cmd_AddParm(ts, "-omitdirs", CMD_FLAG, CMD_OPTIONAL,
5997 "omit unchanged directories from an incremental dump");
6000 ts = cmd_CreateSyntax("restore", RestoreVolumeCmd, NULL,
6001 "restore a volume");
6002 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6003 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6004 cmd_AddParm(ts, "-name", CMD_SINGLE, 0, "name of volume to be restored");
6005 cmd_AddParm(ts, "-file", CMD_SINGLE, CMD_OPTIONAL, "dump file");
6006 cmd_AddParm(ts, "-id", CMD_SINGLE, CMD_OPTIONAL, "volume ID");
6007 cmd_AddParm(ts, "-overwrite", CMD_SINGLE, CMD_OPTIONAL,
6008 "abort | full | incremental");
6009 cmd_AddParm(ts, "-offline", CMD_FLAG, CMD_OPTIONAL,
6010 "leave restored volume offline");
6011 cmd_AddParm(ts, "-readonly", CMD_FLAG, CMD_OPTIONAL,
6012 "make restored volume read-only");
6013 cmd_AddParm(ts, "-creation", CMD_SINGLE, CMD_OPTIONAL,
6014 "dump | keep | new");
6015 cmd_AddParm(ts, "-lastupdate", CMD_SINGLE, CMD_OPTIONAL,
6016 "dump | keep | new");
6017 cmd_AddParm(ts, "-nodelete", CMD_FLAG, CMD_OPTIONAL,
6018 "do not delete old site when restoring to a new site");
6021 ts = cmd_CreateSyntax("unlock", LockReleaseCmd, NULL,
6022 "release lock on VLDB entry for a volume");
6023 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6026 ts = cmd_CreateSyntax("changeloc", ChangeLocation, NULL,
6027 "change an RW volume's location in the VLDB");
6028 cmd_AddParm(ts, "-server", CMD_SINGLE, 0,
6029 "machine name for new location");
6030 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0,
6031 "partition name for new location");
6032 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6035 ts = cmd_CreateSyntax("addsite", AddSite, NULL, "add a replication site");
6036 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name for new site");
6037 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0,
6038 "partition name for new site");
6039 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6040 cmd_AddParm(ts, "-roid", CMD_SINGLE, CMD_OPTIONAL, "volume name or ID for RO");
6041 cmd_AddParm(ts, "-valid", CMD_FLAG, CMD_OPTIONAL, "publish as an up-to-date site in VLDB");
6044 ts = cmd_CreateSyntax("remsite", RemoveSite, NULL,
6045 "remove a replication site");
6046 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6047 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6048 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6051 ts = cmd_CreateSyntax("listpart", ListPartitions, NULL, "list partitions");
6052 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6055 ts = cmd_CreateSyntax("listvol", ListVolumes, NULL,
6056 "list volumes on server (bypass VLDB)");
6057 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6058 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6059 cmd_AddParm(ts, "-fast", CMD_FLAG, CMD_OPTIONAL, "minimal listing");
6060 cmd_AddParm(ts, "-long", CMD_FLAG, CMD_OPTIONAL,
6061 "list all normal volume fields");
6062 cmd_AddParm(ts, "-quiet", CMD_FLAG, CMD_OPTIONAL,
6063 "generate minimal information");
6064 cmd_AddParm(ts, "-extended", CMD_FLAG, CMD_OPTIONAL,
6065 "list extended volume fields");
6066 cmd_AddParm(ts, "-format", CMD_FLAG, CMD_OPTIONAL,
6067 "machine readable format");
6070 ts = cmd_CreateSyntax("syncvldb", SyncVldb, NULL,
6071 "synchronize VLDB with server");
6072 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6073 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6074 cmd_AddParm(ts, "-volume", CMD_SINGLE, CMD_OPTIONAL, "volume name or ID");
6075 cmd_AddParm(ts, "-dryrun", CMD_FLAG, CMD_OPTIONAL, "list what would be done, don't do it");
6078 ts = cmd_CreateSyntax("syncserv", SyncServer, NULL,
6079 "synchronize server with VLDB");
6080 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6081 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6082 cmd_AddParm(ts, "-dryrun", CMD_FLAG, CMD_OPTIONAL, "list what would be done, don't do it");
6085 ts = cmd_CreateSyntax("examine", ExamineVolume, NULL,
6086 "everything about the volume");
6087 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6088 cmd_AddParm(ts, "-extended", CMD_FLAG, CMD_OPTIONAL,
6089 "list extended volume fields");
6090 cmd_AddParm(ts, "-format", CMD_FLAG, CMD_OPTIONAL,
6091 "machine readable format");
6093 cmd_CreateAlias(ts, "volinfo");
6095 ts = cmd_CreateSyntax("setfields", SetFields, NULL,
6096 "change volume info fields");
6097 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6098 cmd_AddParm(ts, "-maxquota", CMD_SINGLE, CMD_OPTIONAL, "quota (KB)");
6099 cmd_AddParm(ts, "-clearuse", CMD_FLAG, CMD_OPTIONAL, "clear dayUse");
6100 cmd_AddParm(ts, "-clearVolUpCounter", CMD_FLAG, CMD_OPTIONAL, "clear volUpdateCounter");
6103 ts = cmd_CreateSyntax("offline", volOffline, NULL, "force the volume status to offline");
6104 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "server name");
6105 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6106 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6107 cmd_AddParm(ts, "-sleep", CMD_SINGLE, CMD_OPTIONAL, "seconds to sleep");
6108 cmd_AddParm(ts, "-busy", CMD_FLAG, CMD_OPTIONAL, "busy volume");
6111 ts = cmd_CreateSyntax("online", volOnline, NULL, "force the volume status to online");
6112 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "server name");
6113 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6114 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6117 ts = cmd_CreateSyntax("zap", VolumeZap, NULL,
6118 "delete the volume, don't bother with VLDB");
6119 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6120 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6121 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume ID");
6122 cmd_AddParm(ts, "-force", CMD_FLAG, CMD_OPTIONAL,
6123 "force deletion of bad volumes");
6124 cmd_AddParm(ts, "-backup", CMD_FLAG, CMD_OPTIONAL,
6125 "also delete backup volume if one is found");
6128 ts = cmd_CreateSyntax("status", VolserStatus, NULL,
6129 "report on volser status");
6130 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6133 ts = cmd_CreateSyntax("rename", RenameVolume, NULL, "rename a volume");
6134 cmd_AddParm(ts, "-oldname", CMD_SINGLE, 0, "old volume name ");
6135 cmd_AddParm(ts, "-newname", CMD_SINGLE, 0, "new volume name ");
6138 ts = cmd_CreateSyntax("listvldb", ListVLDB, NULL,
6139 "list volumes in the VLDB");
6140 cmd_AddParm(ts, "-name", CMD_SINGLE, CMD_OPTIONAL, "volume name or ID");
6141 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6142 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6143 cmd_AddParm(ts, "-locked", CMD_FLAG, CMD_OPTIONAL, "locked volumes only");
6144 cmd_AddParm(ts, "-quiet", CMD_FLAG, CMD_OPTIONAL,
6145 "generate minimal information");
6146 cmd_AddParm(ts, "-nosort", CMD_FLAG, CMD_OPTIONAL,
6147 "do not alphabetically sort the volume names");
6150 ts = cmd_CreateSyntax("backupsys", BackSys, NULL, "en masse backups");
6151 cmd_AddParm(ts, "-prefix", CMD_LIST, CMD_OPTIONAL,
6152 "common prefix on volume(s)");
6153 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6154 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6155 cmd_AddParm(ts, "-exclude", CMD_FLAG, CMD_OPTIONAL,
6156 "exclude common prefix volumes");
6157 cmd_AddParm(ts, "-xprefix", CMD_LIST, CMD_OPTIONAL,
6158 "negative prefix on volume(s)");
6159 cmd_AddParm(ts, "-dryrun", CMD_FLAG, CMD_OPTIONAL, "list what would be done, don't do it");
6162 ts = cmd_CreateSyntax("delentry", DeleteEntry, NULL,
6163 "delete VLDB entry for a volume");
6164 cmd_AddParm(ts, "-id", CMD_LIST, CMD_OPTIONAL, "volume name or ID");
6165 cmd_AddParm(ts, "-prefix", CMD_SINGLE, CMD_OPTIONAL,
6166 "prefix of the volume whose VLDB entry is to be deleted");
6167 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6168 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6169 cmd_AddParm(ts, "-noexecute", CMD_FLAG, CMD_OPTIONAL|CMD_HIDDEN, "");
6170 cmd_AddParm(ts, "-dryrun", CMD_FLAG, CMD_OPTIONAL,
6171 "list what would be done, don't do it");
6174 ts = cmd_CreateSyntax("partinfo", PartitionInfo, NULL,
6175 "list partition information");
6176 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6177 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6178 cmd_AddParm(ts, "-summary", CMD_FLAG, CMD_OPTIONAL,
6179 "print storage summary");
6182 ts = cmd_CreateSyntax("unlockvldb", UnlockVLDB, NULL,
6183 "unlock all the locked entries in the VLDB");
6184 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6185 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6188 ts = cmd_CreateSyntax("lock", LockEntry, NULL,
6189 "lock VLDB entry for a volume");
6190 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6193 ts = cmd_CreateSyntax("changeaddr", ChangeAddr, NULL,
6194 "change the IP address of a file server");
6195 cmd_AddParm(ts, "-oldaddr", CMD_SINGLE, 0, "original IP address");
6196 cmd_AddParm(ts, "-newaddr", CMD_SINGLE, CMD_OPTIONAL, "new IP address");
6197 cmd_AddParm(ts, "-remove", CMD_FLAG, CMD_OPTIONAL,
6198 "remove the IP address from the VLDB");
6201 ts = cmd_CreateSyntax("listaddrs", ListAddrs, NULL,
6202 "list the IP address of all file servers registered in the VLDB");
6203 cmd_AddParm(ts, "-uuid", CMD_SINGLE, CMD_OPTIONAL, "uuid of server");
6204 cmd_AddParm(ts, "-host", CMD_SINGLE, CMD_OPTIONAL, "address of host");
6205 cmd_AddParm(ts, "-printuuid", CMD_FLAG, CMD_OPTIONAL,
6206 "print uuid of hosts");
6209 ts = cmd_CreateSyntax("convertROtoRW", ConvertRO, NULL,
6210 "convert a RO volume into a RW volume (after loss of old RW volume)");
6211 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6212 cmd_AddParm(ts, "-partition", CMD_SINGLE, 0, "partition name");
6213 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6214 cmd_AddParm(ts, "-force", CMD_FLAG, CMD_OPTIONAL, "don't ask");
6217 ts = cmd_CreateSyntax("size", Sizes, NULL,
6218 "obtain various sizes of the volume.");
6219 cmd_AddParm(ts, "-id", CMD_SINGLE, 0, "volume name or ID");
6220 cmd_AddParm(ts, "-partition", CMD_SINGLE, CMD_OPTIONAL, "partition name");
6221 cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL, "machine name");
6222 cmd_AddParm(ts, "-dump", CMD_FLAG, CMD_OPTIONAL,
6223 "Obtain the size of the dump");
6224 cmd_AddParm(ts, "-time", CMD_SINGLE, CMD_OPTIONAL, "dump from time");
6227 ts = cmd_CreateSyntax("endtrans", EndTrans, NULL,
6228 "end a volserver transaction");
6229 cmd_AddParm(ts, "-server", CMD_SINGLE, 0, "machine name");
6230 cmd_AddParm(ts, "-transaction", CMD_SINGLE, 0,
6234 ts = cmd_CreateSyntax("setaddrs", SetAddrs, NULL,
6235 "set the list of IP address for a given UUID in the VLDB");
6236 cmd_AddParm(ts, "-uuid", CMD_SINGLE, 0, "uuid of server");
6237 cmd_AddParm(ts, "-host", CMD_LIST, 0, "address of host");
6240 code = cmd_Dispatch(argc, argv);
6242 /* Shut down the ubik_client and rx connections */
6244 (void)ubik_ClientDestroy(cstruct);
6250 exit((code ? -1 : 0));