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 /* Read a VLDB file and verify it for correctness */
12 #define VL 0x001 /* good volume entry */
13 #define FR 0x002 /* free volume entry */
14 #define MH 0x004 /* multi-homed entry */
16 #define RWH 0x010 /* on rw hash chain */
17 #define ROH 0x020 /* on ro hash chain */
18 #define BKH 0x040 /* on bk hash chain */
19 #define NH 0x080 /* on name hash chain */
21 #define MHC 0x100 /* on multihomed chain */
22 #define FRC 0x200 /* on free chain */
24 #define REFRW 0x1000 /* linked from something (RW) */
25 #define REFRO 0x2000 /* linked from something (RO) */
26 #define REFBK 0x4000 /* linked from something (BK) */
27 #define REFN 0x8000 /* linked from something (name) */
29 #define MULTRW 0x10000 /* multiply-chained (RW) */
30 #define MULTRO 0x20000 /* multiply-chained (RO) */
31 #define MULTBK 0x40000 /* multiply-chained (BK) */
32 #define MULTN 0x80000 /* multiply-chained (name) */
34 #define MISRWH 0x100000 /* mischained (RW) */
35 #define MISROH 0x200000 /* mischained (RO) */
36 #define MISBKH 0x400000 /* mischained (BK) */
37 #define MISNH 0x800000 /* mischained (name) */
39 #define VLDB_CHECK_NO_VLDB_CHECK_ERROR 0
40 #define VLDB_CHECK_WARNING 1
41 #define VLDB_CHECK_ERROR 2
42 #define VLDB_CHECK_FATAL 4
43 #define vldbread(x,y,z) vldbio(x,y,z,0)
44 #define vldbwrite(x,y,z) vldbio(x,y,z,1)
46 #include <afsconfig.h>
47 #include <afs/param.h>
51 #include <sys/types.h>
58 #include <WINNT/afsevent.h>
61 #include <sys/socket.h>
63 #include <netinet/in.h>
69 #include <afs/afsutil.h>
72 #define ADDR(x) (x/sizeof(struct nvlentry))
75 int listentries, listservers, listheader, listuheader, verbose, quiet;
80 /* if quiet, don't send anything to stdout */
82 /* error level. 0 = no error, 1 = warning, 2 = error, 4 = fatal */
89 int serveraddrs[MAXSERVERID + 2];
91 /* Used to control what goes to stdout based on quiet flag */
93 quiet_println(const char *fmt,...) {
97 vfprintf(stdout, fmt, args);
102 /* Used to set the error level and ship messages to stderr */
104 log_error(int eval, const char *fmt, ...)
107 if (error_level < eval) error_level = eval ; /* bump up the severity */
109 vfprintf(stderr, fmt, args);
112 if (error_level == VLDB_CHECK_FATAL) exit(VLDB_CHECK_FATAL);
120 /* Bump the version number?? We could cheat and push a new db... */
129 struct ubik_hdr uheader;
131 offset = lseek(fd, 0, 0);
133 log_error(VLDB_CHECK_FATAL,"error: lseek to 0 failed: %d %d\n", offset, errno);
134 return (VLDB_CHECK_FATAL);
137 /* now read the info */
138 r = read(fd, &uheader, sizeof(uheader));
139 if (r != sizeof(uheader)) {
140 log_error(VLDB_CHECK_FATAL,"error: read of %lu bytes failed: %d %d\n", sizeof(uheader), r,
142 return (VLDB_CHECK_FATAL);
145 uheader.magic = ntohl(uheader.magic);
146 uheader.size = ntohl(uheader.size);
147 uheader.version.epoch = ntohl(uheader.version.epoch);
148 uheader.version.counter = ntohl(uheader.version.counter);
151 quiet_println("Ubik Header\n");
152 quiet_println(" Magic = 0x%x\n", uheader.magic);
153 quiet_println(" Size = %u\n", uheader.size);
154 quiet_println(" Version.epoch = %u\n", uheader.version.epoch);
155 quiet_println(" Version.counter = %u\n", uheader.version.counter);
158 if (uheader.size != HDRSIZE)
159 log_error(VLDB_CHECK_WARNING,"VLDB_CHECK_WARNING: Ubik header size is %u (should be %u)\n", uheader.size,
161 if (uheader.magic != UBIK_MAGIC)
162 log_error(VLDB_CHECK_ERROR,"Ubik header magic is 0x%x (should be 0x%x)\n", uheader.magic,
169 vldbio(int position, void *buffer, int size, int rdwr)
173 /* seek to the correct spot. skip ubik stuff */
174 p = position + HDRSIZE;
175 offset = lseek(fd, p, 0);
177 log_error(VLDB_CHECK_FATAL,"error: lseek to %d failed: %d %d\n", p, offset, errno);
182 r = write(fd, buffer, size);
184 r = read(fd, buffer, size);
187 log_error(VLDB_CHECK_FATAL,"error: %s of %d bytes failed: %d %d\n", rdwr==1?"write":"read",
211 NameHash(char *volname)
217 for (vchar = volname + strlen(volname) - 1; vchar >= volname; vchar--)
218 hash = (hash * 63) + (*((unsigned char *)vchar) - 63);
219 return (hash % HASHSIZE);
223 IdHash(afs_uint32 volid)
225 return ((abs(volid)) % HASHSIZE);
228 #define LEGALCHARS ".ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_"
230 InvalidVolname(char *volname)
236 slen = strlen(volname);
237 if (slen >= VL_MAXNAMELEN)
239 return (slen != strspn(volname, map));
243 readheader(struct vlheader *headerp)
247 vldbread(0, (char *)headerp, sizeof(*headerp));
249 headerp->vital_header.vldbversion =
250 ntohl(headerp->vital_header.vldbversion);
251 headerp->vital_header.headersize =
252 ntohl(headerp->vital_header.headersize);
253 headerp->vital_header.freePtr = ntohl(headerp->vital_header.freePtr);
254 headerp->vital_header.eofPtr = ntohl(headerp->vital_header.eofPtr);
255 headerp->vital_header.allocs = ntohl(headerp->vital_header.allocs);
256 headerp->vital_header.frees = ntohl(headerp->vital_header.frees);
257 headerp->vital_header.MaxVolumeId =
258 ntohl(headerp->vital_header.MaxVolumeId);
259 headerp->vital_header.totalEntries[0] =
260 ntohl(headerp->vital_header.totalEntries[0]);
261 for (i = 0; i < MAXTYPES; i++)
262 headerp->vital_header.totalEntries[i] =
263 ntohl(headerp->vital_header.totalEntries[1]);
265 headerp->SIT = ntohl(headerp->SIT);
266 for (i = 0; i < MAXSERVERID; i++)
267 headerp->IpMappedAddr[i] = ntohl(headerp->IpMappedAddr[i]);
268 for (i = 0; i < HASHSIZE; i++)
269 headerp->VolnameHash[i] = ntohl(headerp->VolnameHash[i]);
270 for (i = 0; i < MAXTYPES; i++)
271 for (j = 0; j < HASHSIZE; j++)
272 headerp->VolidHash[i][j] = ntohl(headerp->VolidHash[i][j]);
275 quiet_println("vldb header\n");
276 quiet_println(" vldbversion = %u\n",
277 headerp->vital_header.vldbversion);
278 quiet_println(" headersize = %u [actual=%lu]\n",
279 headerp->vital_header.headersize, sizeof(*headerp));
280 quiet_println(" freePtr = 0x%x\n", headerp->vital_header.freePtr);
281 quiet_println(" eofPtr = %u\n", headerp->vital_header.eofPtr);
282 quiet_println(" allocblock calls = %10u\n", headerp->vital_header.allocs);
283 quiet_println(" freeblock calls = %10u\n", headerp->vital_header.frees);
284 quiet_println(" MaxVolumeId = %u\n",
285 headerp->vital_header.MaxVolumeId);
286 quiet_println(" rw vol entries = %u\n",
287 headerp->vital_header.totalEntries[0]);
288 quiet_println(" ro vol entries = %u\n",
289 headerp->vital_header.totalEntries[1]);
290 quiet_println(" bk vol entries = %u\n",
291 headerp->vital_header.totalEntries[2]);
292 quiet_println(" multihome info = 0x%x (%u)\n", headerp->SIT,
294 quiet_println(" server ip addr table: size = %d entries\n",
296 quiet_println(" volume name hash table: size = %d buckets\n", HASHSIZE);
297 quiet_println(" volume id hash table: %d tables with %d buckets each\n",
301 /* Check the header size */
302 if (headerp->vital_header.headersize != sizeof(*headerp))
303 log_error(VLDB_CHECK_WARNING,"Header reports its size as %d (should be %lu)\n",
304 headerp->vital_header.headersize, sizeof(*headerp));
309 writeheader(struct vlheader *headerp)
313 headerp->vital_header.vldbversion =
314 htonl(headerp->vital_header.vldbversion);
315 headerp->vital_header.headersize =
316 htonl(headerp->vital_header.headersize);
317 headerp->vital_header.freePtr = htonl(headerp->vital_header.freePtr);
318 headerp->vital_header.eofPtr = htonl(headerp->vital_header.eofPtr);
319 headerp->vital_header.allocs = htonl(headerp->vital_header.allocs);
320 headerp->vital_header.frees = htonl(headerp->vital_header.frees);
321 headerp->vital_header.MaxVolumeId =
322 htonl(headerp->vital_header.MaxVolumeId);
323 headerp->vital_header.totalEntries[0] =
324 htonl(headerp->vital_header.totalEntries[0]);
325 for (i = 0; i < MAXTYPES; i++)
326 headerp->vital_header.totalEntries[i] =
327 htonl(headerp->vital_header.totalEntries[1]);
329 headerp->SIT = htonl(headerp->SIT);
330 for (i = 0; i < MAXSERVERID; i++)
331 headerp->IpMappedAddr[i] = htonl(headerp->IpMappedAddr[i]);
332 for (i = 0; i < HASHSIZE; i++)
333 headerp->VolnameHash[i] = htonl(headerp->VolnameHash[i]);
334 for (i = 0; i < MAXTYPES; i++)
335 for (j = 0; j < HASHSIZE; j++)
336 headerp->VolidHash[i][j] = htonl(headerp->VolidHash[i][j]);
338 vldbwrite(0, (char *)headerp, sizeof(*headerp));
342 readMH(afs_int32 addr, struct extentaddr *mhblockP)
345 struct extentaddr *e;
347 vldbread(addr, (char *)mhblockP, VL_ADDREXTBLK_SIZE);
349 mhblockP->ex_count = ntohl(mhblockP->ex_count);
350 mhblockP->ex_flags = ntohl(mhblockP->ex_flags);
351 for (i = 0; i < VL_MAX_ADDREXTBLKS; i++)
352 mhblockP->ex_contaddrs[i] = ntohl(mhblockP->ex_contaddrs[i]);
354 for (i = 1; i < VL_MHSRV_PERBLK; i++) {
357 /* won't convert hostuuid */
358 e->ex_uniquifier = ntohl(e->ex_uniquifier);
359 for (j = 0; j < VL_MAXIPADDRS_PERMH; j++)
360 e->ex_addrs[j] = ntohl(e->ex_addrs[j]);
366 readentry(afs_int32 addr, struct nvlentry *vlentryp, afs_int32 *type)
370 vldbread(addr, (char *)vlentryp, sizeof(*vlentryp));
372 for (i = 0; i < MAXTYPES; i++)
373 vlentryp->volumeId[i] = ntohl(vlentryp->volumeId[i]);
374 vlentryp->flags = ntohl(vlentryp->flags);
375 vlentryp->LockAfsId = ntohl(vlentryp->LockAfsId);
376 vlentryp->LockTimestamp = ntohl(vlentryp->LockTimestamp);
377 vlentryp->cloneId = ntohl(vlentryp->cloneId);
378 for (i = 0; i < MAXTYPES; i++)
379 vlentryp->nextIdHash[i] = ntohl(vlentryp->nextIdHash[i]);
380 vlentryp->nextNameHash = ntohl(vlentryp->nextNameHash);
381 for (i = 0; i < NMAXNSERVERS; i++) {
382 /* make sure not to ntohl these, as they're chars, not ints */
383 vlentryp->serverNumber[i] = vlentryp->serverNumber[i];
384 vlentryp->serverPartition[i] = vlentryp->serverPartition[i];
385 vlentryp->serverFlags[i] = vlentryp->serverFlags[i];
388 if (vlentryp->flags == VLCONTBLOCK) {
390 } else if (vlentryp->flags == VLFREE) {
397 quiet_println("address %u: ", addr);
398 if (vlentryp->flags == VLCONTBLOCK) {
399 quiet_println("mh extension block\n");
400 } else if (vlentryp->flags == VLFREE) {
401 quiet_println("free vlentry\n");
403 quiet_println("vlentry %s\n", vlentryp->name);
404 quiet_println(" rw id = %u ; ro id = %u ; bk id = %u\n",
405 vlentryp->volumeId[0], vlentryp->volumeId[1],
406 vlentryp->volumeId[2]);
407 quiet_println(" flags =");
408 if (vlentryp->flags & VLF_RWEXISTS)
409 quiet_println(" rw");
410 if (vlentryp->flags & VLF_ROEXISTS)
411 quiet_println(" ro");
412 if (vlentryp->flags & VLF_BACKEXISTS)
413 quiet_println(" bk");
414 if (vlentryp->flags & 0xffff8fff)
415 quiet_println(" errorflag(0x%x)", vlentryp->flags);
417 quiet_println(" LockAfsId = %d\n", vlentryp->LockAfsId);
418 quiet_println(" LockTimestamp = %d\n", vlentryp->LockTimestamp);
419 quiet_println(" cloneId = %u\n", vlentryp->cloneId);
421 (" next hash for rw = %u ; ro = %u ; bk = %u ; name = %u\n",
422 vlentryp->nextIdHash[0], vlentryp->nextIdHash[1],
423 vlentryp->nextIdHash[2], vlentryp->nextNameHash);
424 for (i = 0; i < NMAXNSERVERS; i++) {
425 if (vlentryp->serverNumber[i] != 255) {
426 quiet_println(" server %d ; partition %d ; flags =",
427 vlentryp->serverNumber[i],
428 vlentryp->serverPartition[i]);
429 if (vlentryp->serverFlags[i] & VLSF_RWVOL)
430 quiet_println(" rw");
431 if (vlentryp->serverFlags[i] & VLSF_ROVOL)
432 quiet_println(" ro");
433 if (vlentryp->serverFlags[i] & VLSF_BACKVOL)
434 quiet_println(" bk");
435 if (vlentryp->serverFlags[i] & VLSF_NEWREPSITE)
436 quiet_println(" newro");
446 writeentry(afs_int32 addr, struct nvlentry *vlentryp)
450 if (verbose) quiet_println("Writing back entry at addr %u\n", addr);
452 for (i = 0; i < MAXTYPES; i++)
453 vlentryp->volumeId[i] = htonl(vlentryp->volumeId[i]);
454 vlentryp->flags = htonl(vlentryp->flags);
455 vlentryp->LockAfsId = htonl(vlentryp->LockAfsId);
456 vlentryp->LockTimestamp = htonl(vlentryp->LockTimestamp);
457 vlentryp->cloneId = htonl(vlentryp->cloneId);
458 for (i = 0; i < MAXTYPES; i++)
459 vlentryp->nextIdHash[i] = htonl(vlentryp->nextIdHash[i]);
460 vlentryp->nextNameHash = htonl(vlentryp->nextNameHash);
461 for (i = 0; i < NMAXNSERVERS; i++) {
462 /* make sure not to htonl these, as they're chars, not ints */
463 vlentryp->serverNumber[i] = vlentryp->serverNumber[i] ;
464 vlentryp->serverPartition[i] = vlentryp->serverPartition[i] ;
465 vlentryp->serverFlags[i] = vlentryp->serverFlags[i] ;
467 vldbwrite(addr, (char *)vlentryp, sizeof(*vlentryp));
471 readSIT(int base, int addr)
474 char sitbuf[VL_ADDREXTBLK_SIZE];
475 struct extentaddr *extent;
479 vldbread(addr, sitbuf, VL_ADDREXTBLK_SIZE);
480 extent = (struct extentaddr *)sitbuf;
482 quiet_println("multihome info block: base %d\n", base);
484 quiet_println(" count = %u\n", ntohl(extent->ex_count));
485 quiet_println(" flags = %u\n", ntohl(extent->ex_flags));
486 for (i = 0; i < VL_MAX_ADDREXTBLKS; i++) {
487 quiet_println(" contaddrs[%d] = %u\n", i,
488 ntohl(extent->ex_contaddrs[i]));
491 for (i = 1; i < VL_MHSRV_PERBLK; i++) {
492 /* should we skip this entry */
493 for (j = 0; j < VL_MAX_ADDREXTBLKS; j++) {
494 if (extent[i].ex_addrs[j])
497 if (j >= VL_MAX_ADDREXTBLKS)
500 quiet_println(" base %d index %d:\n", base, i);
502 quiet_println(" afsuuid = (%x %x %x /%d/%d/ /%x/%x/%x/%x/%x/%x/)\n",
503 ntohl(extent[i].ex_hostuuid.time_low),
504 ntohl(extent[i].ex_hostuuid.time_mid),
505 ntohl(extent[i].ex_hostuuid.time_hi_and_version),
506 ntohl(extent[i].ex_hostuuid.clock_seq_hi_and_reserved),
507 ntohl(extent[i].ex_hostuuid.clock_seq_low),
508 ntohl(extent[i].ex_hostuuid.node[0]),
509 ntohl(extent[i].ex_hostuuid.node[1]),
510 ntohl(extent[i].ex_hostuuid.node[2]),
511 ntohl(extent[i].ex_hostuuid.node[3]),
512 ntohl(extent[i].ex_hostuuid.node[4]),
513 ntohl(extent[i].ex_hostuuid.node[5]));
514 quiet_println(" uniquifier = %u\n", ntohl(extent[i].ex_uniquifier));
515 for (j = 0; j < VL_MAXIPADDRS_PERMH; j++) {
516 a = ntohl(extent[i].ex_addrs[j]);
518 quiet_println(" %d.%d.%d.%d\n", (a >> 24) & 0xff,
519 (a >> 16) & 0xff, (a >> 8) & 0xff, (a) & 0xff);
526 * Read each entry in the database:
527 * Record what type of entry it is and its address in the record array.
528 * Remember what the maximum volume id we found is and check against the header.
531 ReadAllEntries(struct vlheader *header)
533 afs_int32 type, rindex, i, j, e;
534 int freecount = 0, mhcount = 0, vlcount = 0;
535 int rwcount = 0, rocount = 0, bkcount = 0;
536 struct nvlentry vlentry;
538 afs_uint32 entrysize = 0;
539 afs_uint32 maxvolid = 0;
541 if (verbose) quiet_println("Read each entry in the database\n");
542 for (addr = header->vital_header.headersize;
543 addr < header->vital_header.eofPtr; addr += entrysize) {
545 /* Remember the highest volume id */
546 readentry(addr, &vlentry, &type);
548 if (!(vlentry.flags & VLF_RWEXISTS))
549 log_error(VLDB_CHECK_WARNING,"VLDB_CHECK_WARNING: VLDB entry '%s' has no RW volume\n",
552 for (i = 0; i < MAXTYPES; i++)
553 if (maxvolid < vlentry.volumeId[i])
554 maxvolid = vlentry.volumeId[i];
557 for (j = 0; j < NMAXNSERVERS; j++) {
558 if (vlentry.serverNumber[j] == 255)
560 if (vlentry.serverFlags[j] & (VLSF_ROVOL | VLSF_NEWREPSITE)) {
564 if (vlentry.serverFlags[j] & VLSF_RWVOL) {
566 if (vlentry.flags & VLF_BACKEXISTS)
570 if (!vlentry.serverFlags[j]) {
576 (VLDB_CHECK_ERROR,"VLDB entry '%s' contains an unknown RW/RO index serverFlag\n",
581 (" index %d : serverNumber %d : serverPartition %d : serverFlag %d\n",
582 j, vlentry.serverNumber[j], vlentry.serverPartition[j],
583 vlentry.serverFlags[j]);
587 rindex = addr / sizeof(vlentry);
588 if (record[rindex].type) {
589 log_error(VLDB_CHECK_ERROR,"INTERNAL VLDB_CHECK_ERROR: record holder %d already in use\n",
593 record[rindex].addr = addr;
594 record[rindex].type = type;
596 /* Determine entrysize and keep count */
598 entrysize = sizeof(vlentry);
600 } else if (type == FR) {
601 entrysize = sizeof(vlentry);
603 } else if (type == MH) {
604 entrysize = VL_ADDREXTBLK_SIZE;
607 log_error(VLDB_CHECK_ERROR, "Unknown entry at %u. Aborting\n", addr);
612 quiet_println("Found %d entries, %d free entries, %d multihomed blocks\n",
613 vlcount, freecount, mhcount);
614 quiet_println("Found %d RW volumes, %d BK volumes, %d RO volumes\n", rwcount,
618 /* Check the maxmimum volume id in the header */
619 if (maxvolid != header->vital_header.MaxVolumeId - 1)
621 ("Header's maximum volume id is %u and largest id found in VLDB is %u\n",
622 header->vital_header.MaxVolumeId, maxvolid);
627 SetHashEnd(long addr, int type, long new)
629 struct nvlentry vlentry;
630 afs_int32 type2, next = -1;
632 for (; addr; addr = next) {
633 readentry(addr, &vlentry, &type2);
634 switch(type & 0xf0) {
636 next = vlentry.nextIdHash[0];
639 next = vlentry.nextIdHash[1];
642 next = vlentry.nextIdHash[2];
645 next = vlentry.nextNameHash;
652 switch(type & 0xf0) {
654 if (vlentry.nextIdHash[0] != 0) {quiet_println("bwoop\n");}
655 vlentry.nextIdHash[0] = new;
658 if (vlentry.nextIdHash[1] != 0) {quiet_println("bwoop\n");}
659 vlentry.nextIdHash[1] = new;
662 if (vlentry.nextIdHash[2] != 0) {quiet_println("bwoop\n");}
663 vlentry.nextIdHash[2] = new;
666 if (vlentry.nextNameHash != 0) {quiet_println("bwoop\n");}
667 vlentry.nextNameHash = new;
670 writeentry(addr, &vlentry);
677 * Follow each Name hash bucket marking it as read in the record array.
678 * Record we found it in the name hash within the record array.
679 * Check that the name is hashed correctly.
682 FollowNameHash(struct vlheader *header)
684 int count = 0, longest = 0, shortest = -1, chainlength;
685 struct nvlentry vlentry;
687 afs_int32 i, type, rindex;
689 /* Now follow the Name Hash Table */
690 if (verbose) quiet_println("Check Volume Name Hash\n");
691 for (i = 0; i < HASHSIZE; i++) {
693 for (addr = header->VolnameHash[i]; addr; addr = vlentry.nextNameHash) {
694 readentry(addr, &vlentry, &type);
696 log_error(VLDB_CHECK_ERROR,"Name Hash %d: Bad entry at %u: Not a valid vlentry\n",
701 rindex = addr / sizeof(vlentry);
703 if (record[rindex].addr != addr && record[rindex].addr) {
705 (VLDB_CHECK_ERROR,"INTERNAL VLDB_CHECK_ERROR: addresses %ld and %u use same record slot %d\n",
706 record[rindex].addr, addr, rindex);
708 if (record[rindex].type & NH) {
710 (VLDB_CHECK_ERROR,"Name Hash %d: Bad entry '%s': Already in the name hash\n",
712 record[rindex].type |= MULTN;
715 record[rindex].type |= NH;
716 record[rindex].type |= REFN;
721 /* Hash the name and check if in correct hash table */
722 if (NameHash(vlentry.name) != i) {
724 (VLDB_CHECK_ERROR,"Name Hash %d: Bad entry '%s': Incorrect name hash chain (should be in %d)\n",
725 i, vlentry.name, NameHash(vlentry.name));
726 record[rindex].type |= MULTN;
729 if (chainlength > longest)
730 longest = chainlength;
731 if ((shortest == -1) || (chainlength < shortest))
732 shortest = chainlength;
736 ("%d entries in name hash, longest is %d, shortest is %d, average length is %f\n",
737 count, longest, shortest, ((float)count / (float)HASHSIZE));
743 * Follow the ID hash chains for the RW, RO, and BK hash tables.
744 * Record we found it in the id hash within the record array.
745 * Check that the ID is hashed correctly.
748 FollowIdHash(struct vlheader *header)
750 int count = 0, longest = 0, shortest = -1, chainlength;
751 struct nvlentry vlentry;
753 afs_int32 i, j, hash, type, rindex, ref, badref, badhash;
755 /* Now follow the RW, RO, and BK Hash Tables */
756 if (verbose) quiet_println("Check RW, RO, and BK id Hashes\n");
757 for (i = 0; i < MAXTYPES; i++) {
758 hash = ((i == 0) ? RWH : ((i == 1) ? ROH : BKH));
759 ref = ((i == 0) ? REFRW : ((i == 1) ? REFRO : REFBK));
760 badref = ((i == 0) ? MULTRW : ((i == 1) ? MULTRO : MULTBK));
761 badhash = ((i == 0) ? MULTRW : ((i == 1) ? MULTRO : MULTBK));
765 for (j = 0; j < HASHSIZE; j++) {
767 for (addr = header->VolidHash[i][j]; addr;
768 addr = vlentry.nextIdHash[i]) {
769 readentry(addr, &vlentry, &type);
772 (VLDB_CHECK_ERROR,"%s Id Hash %d: Bad entry at %u: Not a valid vlentry\n",
777 rindex = addr / sizeof(vlentry);
778 if (record[rindex].addr != addr && record[rindex].addr) {
780 (VLDB_CHECK_ERROR,"INTERNAL VLDB_CHECK_ERROR: addresses %ld and %u use same record slot %d\n",
781 record[rindex].addr, addr, rindex);
783 if (record[rindex].type & hash) {
785 (VLDB_CHECK_ERROR,"%s Id Hash %d: Bad entry '%s': Already in the hash table\n",
786 vtype(i), j, vlentry.name);
787 record[rindex].type |= badref;
790 record[rindex].type |= hash;
791 record[rindex].type |= ref;
796 /* Hash the id and check if in correct hash table */
797 if (IdHash(vlentry.volumeId[i]) != j) {
799 (VLDB_CHECK_ERROR,"%s Id Hash %d: Bad entry '%s': Incorrect Id hash chain (should be in %d)\n",
800 vtype(i), j, vlentry.name,
801 IdHash(vlentry.volumeId[i]));
802 record[rindex].type |= badhash;
803 printf("%d: %x\n", rindex, record[rindex].type);
807 if (chainlength > longest)
808 longest = chainlength;
809 if ((shortest == -1) || (chainlength < shortest))
810 shortest = chainlength;
814 ("%d entries in %s hash, longest is %d, shortest is %d, average length is %f\n",
815 count, vtype(i), longest, shortest,((float)count / (float)HASHSIZE));
822 * Follow the free chain.
823 * Record we found it in the free chain within the record array.
826 FollowFreeChain(struct vlheader *header)
829 struct nvlentry vlentry;
831 afs_int32 type, rindex;
833 /* Now follow the Free Chain */
834 if (verbose) quiet_println("Check Volume Free Chain\n");
835 for (addr = header->vital_header.freePtr; addr;
836 addr = vlentry.nextIdHash[0]) {
837 readentry(addr, &vlentry, &type);
840 (VLDB_CHECK_ERROR,"Free Chain %d: Bad entry at %u: Not a valid free vlentry (0x%x)\n",
845 rindex = addr / sizeof(vlentry);
846 if (record[rindex].addr != addr && record[rindex].addr) {
848 (VLDB_CHECK_ERROR,"INTERNAL VLDB_CHECK_ERROR: addresses %u and %ld use same record slot %d\n",
849 record[rindex].addr, addr, rindex);
851 if (record[rindex].type & FRC) {
852 log_error(VLDB_CHECK_ERROR,"Free Chain: Bad entry at %u: Already in the free chain\n",
856 record[rindex].type |= FRC;
861 quiet_println("%d entries on free chain\n", count);
866 * Read each multihomed block and mark it as found in the record.
867 * Read each entry in each multihomed block and mark the serveraddrs
868 * array with the number of ip addresses found for this entry.
870 * Then read the IpMappedAddr array in the header.
871 * Verify that multihomed entries base and index are valid and points to
872 * a good multhomed entry.
873 * Mark the serveraddrs array with 1 ip address for regular entries.
875 * By the end, the severaddrs array will have a 0 if the entry has no
876 * IP addresses in it or the count of the number of IP addresses.
878 * The code does not verify if there are duplicate IP addresses in the
879 * list. The vlserver does this when a fileserver registeres itself.
882 CheckIpAddrs(struct vlheader *header)
885 afs_int32 i, j, m, rindex;
886 afs_int32 mhentries, regentries;
887 afs_int32 caddrs[VL_MAX_ADDREXTBLKS];
888 char mhblock[VL_ADDREXTBLK_SIZE];
889 struct extentaddr *MHblock = (struct extentaddr *)mhblock;
890 struct extentaddr *e;
891 int ipindex, ipaddrs;
894 memset(&nulluuid, 0, sizeof(nulluuid));
897 quiet_println("Check Multihomed blocks\n");
900 /* Read the first MH block and from it, gather the
901 * addresses of all the mh blocks.
903 readMH(header->SIT, MHblock);
904 if (MHblock->ex_flags != VLCONTBLOCK) {
906 (VLDB_CHECK_ERROR,"Multihomed Block 0: Bad entry at %u: Not a valid multihomed block\n",
910 for (i = 0; i < VL_MAX_ADDREXTBLKS; i++) {
911 caddrs[i] = MHblock->ex_contaddrs[i];
914 if (header->SIT != caddrs[0]) {
916 (VLDB_CHECK_ERROR,"MH block does not point to self %u in header, %u in block\n",
917 header->SIT, caddrs[0]);
920 /* Now read each MH block and record it in the record array */
921 for (i = 0; i < VL_MAX_ADDREXTBLKS; i++) {
925 readMH(caddrs[i], MHblock);
926 if (MHblock->ex_flags != VLCONTBLOCK) {
928 (VLDB_CHECK_ERROR,"Multihomed Block 0: Bad entry at %u: Not a valid multihomed block\n",
932 rindex = caddrs[i] / sizeof(vlentry);
933 if (record[rindex].addr != caddrs[i] && record[rindex].addr) {
935 (VLDB_CHECK_ERROR,"INTERNAL VLDB_CHECK_ERROR: addresses %u and %u use same record slot %d\n",
936 record[rindex].addr, caddrs[i], rindex);
938 if (record[rindex].type & FRC) {
940 (VLDB_CHECK_ERROR,"MH Blocks Chain %d: Bad entry at %ld: Already a MH block\n",
941 i, record[rindex].addr);
944 record[rindex].type |= MHC;
948 /* Read each entry in a multihomed block.
949 * Find the pointer to the entry in the IpMappedAddr array and
950 * verify that the entry is good (has IP addresses in it).
953 for (j = 1; j < VL_MHSRV_PERBLK; j++) {
954 e = (struct extentaddr *)&(MHblock[j]);
956 /* Search the IpMappedAddr array for the reference to this entry */
957 for (ipindex = 0; ipindex < MAXSERVERID; ipindex++) {
958 if (((header->IpMappedAddr[ipindex] & 0xff000000) ==
962 IpMappedAddr[ipindex] & 0x00ff0000) >> 16) == i)
963 && ((header->IpMappedAddr[ipindex] & 0x0000ffff) ==
968 if (ipindex >= MAXSERVERID)
971 serveraddrs[ipindex] = -1;
973 if (memcmp(&e->ex_hostuuid, &nulluuid, sizeof(afsUUID)) == 0) {
976 (VLDB_CHECK_ERROR,"Server Addrs index %d references null MH block %d, index %d\n",
978 serveraddrs[ipindex] = 0; /* avoids printing 2nd error below */
983 /* Step through each ip address and count the good addresses */
985 for (m = 0; m < VL_MAXIPADDRS_PERMH; m++) {
990 /* If we found any good ip addresses, mark it in the serveraddrs record */
995 (VLDB_CHECK_ERROR,"MH block %d, index %d: Not referenced by server addrs\n",
998 serveraddrs[ipindex] = ipaddrs; /* It is good */
1002 if (listservers && ipaddrs) {
1003 quiet_println("MH block %d, index %d:", i, j);
1004 for (m = 0; m < VL_MAXIPADDRS_PERMH; m++) {
1005 if (!e->ex_addrs[m])
1007 quiet_println(" %d.%d.%d.%d",
1008 (e->ex_addrs[m] & 0xff000000) >> 24,
1009 (e->ex_addrs[m] & 0x00ff0000) >> 16,
1010 (e->ex_addrs[m] & 0x0000ff00) >> 8,
1011 (e->ex_addrs[m] & 0x000000ff));
1013 quiet_println("\n");
1017 * if (mhentries != MHblock->ex_count) {
1018 * quiet_println("MH blocks says it has %d entries (found %d)\n",
1019 * MHblock->ex_count, mhentries);
1025 quiet_println("%d multihomed blocks\n", mhblocks);
1027 /* Check the server addresses */
1029 quiet_println("Check server addresses\n");
1030 mhentries = regentries = 0;
1031 for (i = 0; i <= MAXSERVERID; i++) {
1032 if (header->IpMappedAddr[i]) {
1033 if ((header->IpMappedAddr[i] & 0xff000000) == 0xff000000) {
1035 if (((header->IpMappedAddr[i] & 0x00ff0000) >> 16) >
1038 (VLDB_CHECK_ERROR,"IP Addr for entry %d: Multihome block is bad (%d)\n",
1039 i, ((header->IpMappedAddr[i] & 0x00ff0000) >> 16));
1040 if (((header->IpMappedAddr[i] & 0x0000ffff) > VL_MHSRV_PERBLK)
1041 || ((header->IpMappedAddr[i] & 0x0000ffff) < 1))
1043 (VLDB_CHECK_ERROR,"IP Addr for entry %d: Multihome index is bad (%d)\n",
1044 i, (header->IpMappedAddr[i] & 0x0000ffff));
1045 if (serveraddrs[i] == -1) {
1047 (VLDB_CHECK_WARNING,"warning: IP Addr for entry %d: Multihome entry has no ip addresses\n",
1052 quiet_println(" Server ip addr %d = MH block %d, index %d\n",
1053 i, (header->IpMappedAddr[i] & 0x00ff0000) >> 16,
1054 (header->IpMappedAddr[i] & 0x0000ffff));
1058 serveraddrs[i] = 1; /* It is good */
1060 quiet_println(" Server ip addr %d = %d.%d.%d.%d\n", i,
1061 (header->IpMappedAddr[i] & 0xff000000) >> 24,
1062 (header->IpMappedAddr[i] & 0x00ff0000) >> 16,
1063 (header->IpMappedAddr[i] & 0x0000ff00) >> 8,
1064 (header->IpMappedAddr[i] & 0x000000ff));
1070 quiet_println("%d simple entries, %d multihomed entries, Total = %d\n",
1071 regentries, mhentries, mhentries + regentries);
1077 FixBad(afs_uint32 idx, afs_uint32 addr, afs_uint32 type, afs_uint32 tmp,
1078 struct nvlentry *vlentry, afs_uint32 hash) {
1079 SetHashEnd(addr, type, tmp);
1080 quiet_println("linked unlinked chain %u (index %lu) to end of chain %d for %s hash\n",
1081 tmp, ADDR(tmp), hash, type==NH?"Name":(type==RWH?"RW":(type==ROH?"RO":"BK")));
1085 WorkerBee(struct cmd_syndesc *as, void *arock)
1088 afs_int32 maxentries, type;
1089 struct vlheader header;
1090 struct nvlentry vlentry, vlentry2;
1093 error_level = 0; /* start clean with no error status */
1094 dbfile = as->parms[0].items->data; /* -database */
1095 listuheader = (as->parms[1].items ? 1 : 0); /* -uheader */
1096 listheader = (as->parms[2].items ? 1 : 0); /* -vheader */
1097 listservers = (as->parms[3].items ? 1 : 0); /* -servers */
1098 listentries = (as->parms[4].items ? 1 : 0); /* -entries */
1099 verbose = (as->parms[5].items ? 1 : 0); /* -verbose */
1100 quiet = (as->parms[6].items ? 1 : 0); /* -quiet */
1101 fix = (as->parms[7].items ? 1 : 0); /* -fix */
1104 if (quiet && (verbose || listuheader || listheader ||listservers \
1106 log_error(VLDB_CHECK_FATAL," -quiet cannot be used other display flags\n");
1107 return VLDB_CHECK_FATAL;
1111 /* open the vldb database file */
1112 fd = open(dbfile, (fix > 0)?O_RDWR:O_RDONLY, 0);
1114 log_error(VLDB_CHECK_FATAL,"can't open file '%s'. error = %d\n", dbfile, errno);
1118 /* read the ubik header and the vldb database header */
1120 readheader(&header);
1121 if (header.vital_header.vldbversion < 3) {
1122 log_error(VLDB_CHECK_FATAL,"does not support vldb with version less than 3\n");
1123 return VLDB_CHECK_FATAL;
1126 maxentries = (header.vital_header.eofPtr / sizeof(vlentry)) + 1;
1127 record = (struct er *)malloc(maxentries * sizeof(struct er));
1128 memset(record, 0, (maxentries * sizeof(struct er)));
1129 memset(serveraddrs, 0, sizeof(serveraddrs));
1131 /* Will fill in the record array of entries it found */
1132 ReadAllEntries(&header);
1133 listentries = 0; /* Listed all the entries */
1135 /* Check the multihomed blocks for valid entries as well as
1136 * the IpMappedAddrs array in the header for valid entries.
1138 CheckIpAddrs(&header);
1140 /* Follow the hash tables */
1141 FollowNameHash(&header);
1142 FollowIdHash(&header);
1144 /* Follow the chain of free entries */
1145 FollowFreeChain(&header);
1147 /* Now check the record we have been keeping for inconsistencies
1148 * For valid vlentries, also check that the server we point to is
1149 * valid (the serveraddrs array).
1152 quiet_println("Verify each volume entry\n");
1153 for (i = 0; i < maxentries; i++) {
1161 if (record[i].type == 0)
1164 /* If a vlentry, verify that its name is valid, its name and ids are
1165 * on the hash chains, and its server numbers are good.
1167 if (record[i].type & VL) {
1169 int foundbroken = 0;
1172 readentry(record[i].addr, &vlentry, &type);
1174 if (InvalidVolname(vlentry.name))
1175 log_error(VLDB_CHECK_ERROR,"Volume '%s' at addr %ld has an invalid name\n",
1176 vlentry.name, record[i].addr);
1178 if (!(record[i].type & NH)) {
1179 nextp = ADDR(vlentry.nextNameHash);
1181 hash = NameHash(vlentry.name);
1182 nextpp = &vlentry.nextNameHash;
1188 if (vlentry.volumeId[0] && !(record[i].type & RWH)) {
1189 nextp = ADDR(vlentry.nextIdHash[0]);
1191 hash = IdHash(vlentry.volumeId[0]);
1192 nextpp = &(vlentry.nextIdHash[0]);
1194 sprintf(volidbuf, "id %u ", vlentry.volumeId[0]);
1198 if (vlentry.volumeId[1] && !(record[i].type & ROH)) {
1199 nextp = ADDR(vlentry.nextIdHash[1]);
1201 hash = IdHash(vlentry.volumeId[1]);
1202 nextpp = &(vlentry.nextIdHash[1]);
1204 sprintf(volidbuf, "id %u ", vlentry.volumeId[1]);
1208 if (vlentry.volumeId[2] && !(record[i].type & BKH)) {
1209 nextp = ADDR(vlentry.nextIdHash[2]);
1211 hash = IdHash(vlentry.volumeId[2]);
1212 nextpp = &(vlentry.nextIdHash[2]);
1214 sprintf(volidbuf, "id %u ", vlentry.volumeId[2]);
1218 if (record[ADDR(vlentry.nextNameHash)].type & MULTN) {
1219 nextp = ADDR(vlentry.nextNameHash);
1221 hash = NameHash(vlentry.name);
1222 nextpp = &vlentry.nextNameHash;
1225 readentry(vlentry.nextNameHash, &vlentry2, &type);
1226 nexthash = NameHash(vlentry2.name);
1227 if (hash != nexthash)
1231 if ((record[ADDR(vlentry.nextIdHash[0])].type & MULTRW)) {
1232 nextp = ADDR(vlentry.nextIdHash[0]);
1234 hash = IdHash(vlentry.volumeId[0]);
1235 nextpp = &(vlentry.nextIdHash[0]);
1237 sprintf(volidbuf, "id %u ", vlentry.volumeId[0]);
1238 readentry(vlentry.nextIdHash[0], &vlentry2, &type);
1239 nexthash = IdHash(vlentry2.volumeId[0]);
1240 if (hash != nexthash)
1244 if ((record[ADDR(vlentry.nextIdHash[1])].type & MULTRO)) {
1245 nextp = ADDR(vlentry.nextIdHash[1]);
1247 hash = IdHash(vlentry.volumeId[1]);
1248 nextpp = &(vlentry.nextIdHash[1]);
1250 sprintf(volidbuf, "id %u ", vlentry.volumeId[1]);
1251 readentry(vlentry.nextIdHash[1], &vlentry2, &type);
1252 nexthash = IdHash(vlentry2.volumeId[1]);
1253 if (hash != nexthash)
1257 if ((record[ADDR(vlentry.nextIdHash[2])].type & MULTBK)) {
1258 nextp = ADDR(vlentry.nextIdHash[2]);
1260 hash = IdHash(vlentry.volumeId[2]);
1261 nextpp = &(vlentry.nextIdHash[2]);
1263 sprintf(volidbuf, "id %u ", vlentry.volumeId[2]);
1264 readentry(vlentry.nextIdHash[2], &vlentry2, &type);
1265 nexthash = IdHash(vlentry2.volumeId[2]);
1266 if (hash != nexthash)
1271 log_error(VLDB_CHECK_ERROR, "%d: Volume '%s' %s forward link in %s hash chain is broken (hash %d != %d)", i,
1272 vlentry.name, volidbuf, which, hash, nexthash);
1273 } else if (foundbad) {
1274 log_error(VLDB_CHECK_ERROR, "%d: Volume '%s' %snot found in %s hash %d", i,
1275 vlentry.name, volidbuf, which, hash);
1278 if (foundbad || foundbroken) {
1280 log_error(VLDB_CHECK_ERROR, ", unchaining next (%d)\n", nextp);
1282 writeentry(record[i].addr, &vlentry);
1284 log_error(VLDB_CHECK_ERROR, "\n");
1289 for (j = 0; j < NMAXNSERVERS; j++) {
1290 if ((vlentry.serverNumber[j] != 255)
1291 && (serveraddrs[vlentry.serverNumber[j]] == 0)) {
1293 (VLDB_CHECK_ERROR,"Volume '%s', index %d points to empty server entry %d\n",
1294 vlentry.name, j, vlentry.serverNumber[j]);
1298 if (record[i].type & 0xffff0f00)
1300 (VLDB_CHECK_ERROR,"Volume '%s' id %u also found on other chains (0x%x)\n",
1301 vlentry.name, vlentry.volumeId[0], record[i].type);
1304 } else if (record[i].type & FR) {
1305 if (!(record[i].type & FRC))
1306 log_error(VLDB_CHECK_ERROR,"Free vlentry at %ld not on free chain\n",
1309 if (record[i].type & 0xfffffdf0)
1311 (VLDB_CHECK_ERROR,"Free vlentry at %ld also found on other chains (0x%x)\n",
1312 record[i].addr, record[i].type);
1314 /* A multihomed entry */
1315 } else if (record[i].type & MH) {
1316 if (!(record[i].type & MHC))
1317 log_error(VLDB_CHECK_ERROR,"Multihomed block at %ld is orphaned\n",
1320 if (record[i].type & 0xfffffef0)
1322 (VLDB_CHECK_ERROR,"Multihomed block at %ld also found on other chains (0x%x)\n",
1323 record[i].addr, record[i].type);
1326 log_error(VLDB_CHECK_ERROR,"Unknown entry type at %u (0x%x)\n", record[i].addr,
1331 if (verbose) quiet_println("Verify each chain head\n");
1336 for (j = 0; j < HASHSIZE; j++) {
1337 for (addr = header.VolnameHash[j]; j < HASHSIZE; j++) {
1338 if (record[ADDR(addr)].type & MULTN) {
1339 hash = NameHash(vlentry.name);
1341 header.VolnameHash[j] = vlentry.nextNameHash;
1342 vlentry.nextNameHash = 0;
1344 writeentry(record[i].addr, &vlentry);
1349 for (i = 0; i <= 2; i++) {
1350 for (j = 0, addr = header.VolidHash[i][j]; j < HASHSIZE; j++) {
1351 if (verbose) quiet_println("got %d %d %d\n", i, j, ADDR(addr));
1352 if (i == 0 && (record[ADDR(addr)].type & MULTRW)) {
1353 hash = IdHash(vlentry.volumeId[i]);
1355 header.VolidHash[i][j] = vlentry.nextIdHash[i];
1356 vlentry.nextIdHash[i] = 0;
1358 quiet_println("fix %d %d %d\n", i, j, ADDR(addr));
1359 writeentry(record[i].addr, &vlentry);
1364 if (i == 1 && (record[ADDR(addr)].type & MULTRO)) {
1365 hash = IdHash(vlentry.volumeId[i]);
1367 header.VolidHash[i][j] = vlentry.nextIdHash[i];
1368 vlentry.nextIdHash[i] = 0;
1370 quiet_println("fix %d %d %d\n", i, j, addr);
1371 writeentry(record[i].addr, &vlentry);
1376 if (i == 2 && (record[ADDR(addr)].type & MULTBK)) {
1377 hash = IdHash(vlentry.volumeId[i]);
1379 header.VolidHash[i][j] = vlentry.nextIdHash[i];
1380 vlentry.nextIdHash[i] = 0;
1382 quiet_println("fix %d %d %d\n", i, j, addr);
1383 writeentry(record[i].addr, &vlentry);
1390 /* By the time we get here, unchained entries are really unchained */
1391 quiet_println("Scanning %u entries for possible repairs\n", maxentries);
1392 for (i = 0; i < maxentries; i++) {
1394 if (record[i].type & VL) {
1395 readentry(record[i].addr, &vlentry, &type);
1396 if (!(record[i].type & REFN)) {
1397 log_error(VLDB_CHECK_ERROR,"%d: Record %ld (type 0x%x) not in a name chain\n", i,
1398 record[i].addr, record[i].type);
1399 if (strlen(vlentry.name)>0) {
1401 if (header.VolnameHash[NameHash(vlentry.name)] == 0)
1402 header.VolnameHash[NameHash(vlentry.name)] = record[i].addr;
1404 FixBad(i, header.VolnameHash[NameHash(vlentry.name)], NH, record[i].addr, &vlentry, NameHash(vlentry.name));
1407 nextpp = &vlentry.nextNameHash;
1408 if (fix && *nextpp) {
1409 printf(", unchaining");
1411 writeentry(record[i].addr, &vlentry);
1415 if (vlentry.volumeId[0] && !(record[i].type & REFRW)) {
1416 log_error(VLDB_CHECK_ERROR,"%d: Record %ld (type 0x%x) not in a RW chain\n", i,
1417 record[i].addr, record[i].type);
1419 if (header.VolidHash[0][IdHash(vlentry.volumeId[0])] == 0)
1420 header.VolidHash[0][IdHash(vlentry.volumeId[0])] = record[i].addr;
1422 FixBad(i, header.VolidHash[0][IdHash(vlentry.volumeId[0])], RWH, record[i].addr, &vlentry, IdHash(vlentry.volumeId[0]));
1425 if (vlentry.volumeId[1] && !(record[i].type & REFRO)) {
1426 log_error(VLDB_CHECK_ERROR,"%d: Record %ld (type 0x%x) not in a RO chain\n", i,
1427 record[i].addr, record[i].type);
1429 if (header.VolidHash[1][IdHash(vlentry.volumeId[1])] == 0)
1430 header.VolidHash[1][IdHash(vlentry.volumeId[1])] = record[i].addr;
1432 FixBad(i, header.VolidHash[1][IdHash(vlentry.volumeId[1])], ROH, record[i].addr, &vlentry, IdHash(vlentry.volumeId[1]));
1435 if (vlentry.volumeId[2] && !(record[i].type & REFBK)) {
1436 log_error(VLDB_CHECK_ERROR,"%d: Record %ld (type 0x%x) not in a BK chain\n", i,
1437 record[i].addr, record[i].type);
1439 if (header.VolidHash[2][IdHash(vlentry.volumeId[2])] == 0)
1440 header.VolidHash[2][IdHash(vlentry.volumeId[2])] = record[i].addr;
1442 FixBad(i, header.VolidHash[2][IdHash(vlentry.volumeId[2])], BKH, record[i].addr, &vlentry, IdHash(vlentry.volumeId[2]));
1449 writeheader(&header);
1465 main(int argc, char **argv)
1467 struct cmd_syndesc *ts;
1471 ts = cmd_CreateSyntax(NULL, WorkerBee, NULL, "vldb check");
1472 cmd_AddParm(ts, "-database", CMD_SINGLE, CMD_REQUIRED, "vldb_file");
1473 cmd_AddParm(ts, "-uheader", CMD_FLAG, CMD_OPTIONAL,
1474 "Display UBIK header");
1475 cmd_AddParm(ts, "-vheader", CMD_FLAG, CMD_OPTIONAL,
1476 "Display VLDB header");
1477 cmd_AddParm(ts, "-servers", CMD_FLAG, CMD_OPTIONAL,
1478 "Display server list");
1479 cmd_AddParm(ts, "-entries", CMD_FLAG, CMD_OPTIONAL, "Display entries");
1480 cmd_AddParm(ts, "-verbose", CMD_FLAG, CMD_OPTIONAL, "verbose");
1481 cmd_AddParm(ts, "-quiet", CMD_FLAG, CMD_OPTIONAL, "quiet");
1482 cmd_AddParm(ts, "-fix", CMD_FLAG, CMD_OPTIONAL, "attempt to patch the database (potentially dangerous)");
1484 return cmd_Dispatch(argc, argv);