disconnected-20080523
[openafs.git] / src / venus / fs.c
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 #include <afsconfig.h>
11 #include <afs/param.h>
12
13 RCSID
14     ("$Header$");
15
16 #include <afs/afs_args.h>
17 #include <rx/xdr.h>
18 #include <sys/ioctl.h>
19 #include <sys/socket.h>
20 #include <netdb.h>
21 #include <errno.h>
22 #include <stdio.h>
23 #include <netinet/in.h>
24 #include <sys/stat.h>
25 #include <afs/stds.h>
26 #include <afs/vice.h>
27 #include <afs/venus.h>
28 #include <afs/com_err.h>
29 #ifdef  AFS_AIX32_ENV
30 #include <signal.h>
31 #endif
32
33 #include <string.h>
34
35 #undef VIRTUE
36 #undef VICE
37 #include "afs/prs_fs.h"
38 #include <afs/afsint.h>
39 #include <afs/cellconfig.h>
40 #include <ubik.h>
41 #include <rx/rxkad.h>
42 #include <rx/rx_globals.h>
43 #include <afs/vldbint.h>
44 #include <afs/volser.h>
45 #include <afs/vlserver.h>
46 #include <afs/cmd.h>
47 #include <afs/afsutil.h>
48 #include <stdlib.h>
49 #include <assert.h>
50 #include <afs/ptclient.h>
51
52
53 #define MAXHOSTS 13
54 #define OMAXHOSTS 8
55 #define MAXCELLHOSTS 8
56 #define MAXNAME 100
57 #define MAXSIZE 2048
58 #define MAXINSIZE 1300          /* pioctl complains if data is larger than this */
59 #define VMSGSIZE 128            /* size of msg buf in volume hdr */
60
61 static char space[MAXSIZE];
62 static char tspace[1024];
63 static struct ubik_client *uclient;
64
65 static int GetClientAddrsCmd(), SetClientAddrsCmd(), FlushMountCmd();
66 static int RxStatProcCmd(), RxStatPeerCmd(), GetFidCmd(), UuidCmd();
67
68 extern char *hostutil_GetNameByINet();
69 extern struct hostent *hostutil_GetHostByName();
70
71
72 static char pn[] = "fs";
73 static int rxInitDone = 0;
74
75 static void ZapList();
76 static int PruneList();
77 static CleanAcl();
78 static int SetVolCmd(struct cmd_syndesc *as, void *arock);
79 static GetCellName();
80 static VLDBInit();
81 static void Die();
82
83 /*
84  * Character to use between name and rights in printed representation for
85  * DFS ACL's.
86  */
87 #define DFS_SEPARATOR   ' '
88
89 typedef char sec_rgy_name_t[1025];      /* A DCE definition */
90
91 struct Acl {
92     int dfs;                    /* Originally true if a dfs acl; now also the type
93                                  * of the acl (1, 2, or 3, corresponding to object,
94                                  * initial dir, or initial object). */
95     sec_rgy_name_t cell;        /* DFS cell name */
96     int nplus;
97     int nminus;
98     struct AclEntry *pluslist;
99     struct AclEntry *minuslist;
100 };
101
102 struct AclEntry {
103     struct AclEntry *next;
104     char name[MAXNAME];
105     afs_int32 rights;
106 };
107
108 struct vcxstat2 {
109     afs_int32 callerAccess;
110     afs_int32 cbExpires;
111     afs_int32 anyAccess;
112     char mvstat;
113 };
114
115 static void
116 ZapAcl(acl)
117      struct Acl *acl;
118 {
119     if (!acl)
120         return;
121     ZapList(acl->pluslist);
122     ZapList(acl->minuslist);
123     free(acl);
124 }
125
126 static
127 foldcmp(a, b)
128      char *a;
129      char *b;
130 {
131     char t, u;
132     while (1) {
133         t = *a++;
134         u = *b++;
135         if (t >= 'A' && t <= 'Z')
136             t += 0x20;
137         if (u >= 'A' && u <= 'Z')
138             u += 0x20;
139         if (t != u)
140             return 1;
141         if (t == 0)
142             return 0;
143     }
144 }
145
146 /*
147  * Mods for the AFS/DFS protocol translator.
148  *
149  * DFS rights. It's ugly to put these definitions here, but they
150  * *cannot* change, because they're part of the wire protocol.
151  * In any event, the protocol translator will guarantee these
152  * assignments for AFS cache managers.
153  */
154 #define DFS_READ          0x01
155 #define DFS_WRITE         0x02
156 #define DFS_EXECUTE       0x04
157 #define DFS_CONTROL       0x08
158 #define DFS_INSERT        0x10
159 #define DFS_DELETE        0x20
160
161 /* the application definable ones (backwards from AFS) */
162 #define DFS_USR0 0x80000000     /* "A" bit */
163 #define DFS_USR1 0x40000000     /* "B" bit */
164 #define DFS_USR2 0x20000000     /* "C" bit */
165 #define DFS_USR3 0x10000000     /* "D" bit */
166 #define DFS_USR4 0x08000000     /* "E" bit */
167 #define DFS_USR5 0x04000000     /* "F" bit */
168 #define DFS_USR6 0x02000000     /* "G" bit */
169 #define DFS_USR7 0x01000000     /* "H" bit */
170 #define DFS_USRALL      (DFS_USR0 | DFS_USR1 | DFS_USR2 | DFS_USR3 |\
171                          DFS_USR4 | DFS_USR5 | DFS_USR6 | DFS_USR7)
172
173 /*
174  * Offset of -id switch in command structure for various commands.
175  * The -if switch is the next switch always.
176  */
177 static int parm_setacl_id, parm_copyacl_id, parm_listacl_id;
178
179 /*
180  * Determine whether either the -id or -if switches are present, and
181  * return 0, 1 or 2, as appropriate. Abort if both switches are present.
182  */
183 /*    int id;   Offset of -id switch; -if is next switch */
184 static int
185 getidf(struct cmd_syndesc *as, int id)
186 {
187     int idf = 0;
188
189     if (as->parms[id].items) {
190         idf |= 1;
191     }
192     if (as->parms[id + 1].items) {
193         idf |= 2;
194     }
195     if (idf == 3) {
196         fprintf(stderr,
197                 "%s: you may specify either -id or -if, but not both switches\n",
198                 pn);
199         exit(1);
200     }
201     return idf;
202 }
203
204 static int
205 PRights(afs_int32 arights, int dfs)
206 {
207     if (!dfs) {
208         if (arights & PRSFS_READ)
209             printf("r");
210         if (arights & PRSFS_LOOKUP)
211             printf("l");
212         if (arights & PRSFS_INSERT)
213             printf("i");
214         if (arights & PRSFS_DELETE)
215             printf("d");
216         if (arights & PRSFS_WRITE)
217             printf("w");
218         if (arights & PRSFS_LOCK)
219             printf("k");
220         if (arights & PRSFS_ADMINISTER)
221             printf("a");
222         if (arights & PRSFS_USR0)
223             printf("A");
224         if (arights & PRSFS_USR1)
225             printf("B");
226         if (arights & PRSFS_USR2)
227             printf("C");
228         if (arights & PRSFS_USR3)
229             printf("D");
230         if (arights & PRSFS_USR4)
231             printf("E");
232         if (arights & PRSFS_USR5)
233             printf("F");
234         if (arights & PRSFS_USR6)
235             printf("G");
236         if (arights & PRSFS_USR7)
237             printf("H");
238     } else {
239         if (arights & DFS_READ)
240             printf("r");
241         else
242             printf("-");
243         if (arights & DFS_WRITE)
244             printf("w");
245         else
246             printf("-");
247         if (arights & DFS_EXECUTE)
248             printf("x");
249         else
250             printf("-");
251         if (arights & DFS_CONTROL)
252             printf("c");
253         else
254             printf("-");
255         if (arights & DFS_INSERT)
256             printf("i");
257         else
258             printf("-");
259         if (arights & DFS_DELETE)
260             printf("d");
261         else
262             printf("-");
263         if (arights & (DFS_USRALL))
264             printf("+");
265         if (arights & DFS_USR0)
266             printf("A");
267         if (arights & DFS_USR1)
268             printf("B");
269         if (arights & DFS_USR2)
270             printf("C");
271         if (arights & DFS_USR3)
272             printf("D");
273         if (arights & DFS_USR4)
274             printf("E");
275         if (arights & DFS_USR5)
276             printf("F");
277         if (arights & DFS_USR6)
278             printf("G");
279         if (arights & DFS_USR7)
280             printf("H");
281     }
282     return 0;
283 }
284
285 /* this function returns TRUE (1) if the file is in AFS, otherwise false (0) */
286 static int
287 InAFS(char *apath)
288 {
289     struct ViceIoctl blob;
290     afs_int32 code;
291
292     blob.in_size = 0;
293     blob.out_size = MAXSIZE;
294     blob.out = space;
295
296     code = pioctl(apath, VIOC_FILE_CELL_NAME, &blob, 1);
297     if (code) {
298         if ((errno == EINVAL) || (errno == ENOENT))
299             return 0;
300     }
301     return 1;
302 }
303
304 /* return a static pointer to a buffer */
305 static char *
306 Parent(char *apath)
307 {
308     char *tp;
309     strcpy(tspace, apath);
310     tp = strrchr(tspace, '/');
311     if (tp) {
312         *tp = 0;
313     } else
314         strcpy(tspace, ".");
315     return tspace;
316 }
317
318 enum rtype { add, destroy, deny };
319
320 static afs_int32
321 Convert(char *arights, int dfs, enum rtype *rtypep)
322 {
323     int i, len;
324     afs_int32 mode;
325     char tc;
326
327     *rtypep = add;              /* add rights, by default */
328
329     if (dfs) {
330         if (!strcmp(arights, "null")) {
331             *rtypep = deny;
332             return 0;
333         }
334         if (!strcmp(arights, "read"))
335             return DFS_READ | DFS_EXECUTE;
336         if (!strcmp(arights, "write"))
337             return DFS_READ | DFS_EXECUTE | DFS_INSERT | DFS_DELETE |
338                 DFS_WRITE;
339         if (!strcmp(arights, "all"))
340             return DFS_READ | DFS_EXECUTE | DFS_INSERT | DFS_DELETE |
341                 DFS_WRITE | DFS_CONTROL;
342     } else {
343         if (!strcmp(arights, "read"))
344             return PRSFS_READ | PRSFS_LOOKUP;
345         if (!strcmp(arights, "write"))
346             return PRSFS_READ | PRSFS_LOOKUP | PRSFS_INSERT | PRSFS_DELETE |
347                 PRSFS_WRITE | PRSFS_LOCK;
348         if (!strcmp(arights, "mail"))
349             return PRSFS_INSERT | PRSFS_LOCK | PRSFS_LOOKUP;
350         if (!strcmp(arights, "all"))
351             return PRSFS_READ | PRSFS_LOOKUP | PRSFS_INSERT | PRSFS_DELETE |
352                 PRSFS_WRITE | PRSFS_LOCK | PRSFS_ADMINISTER;
353     }
354     if (!strcmp(arights, "none")) {
355         *rtypep = destroy;      /* Remove entire entry */
356         return 0;
357     }
358     len = strlen(arights);
359     mode = 0;
360     for (i = 0; i < len; i++) {
361         tc = *arights++;
362         if (dfs) {
363             if (tc == '-')
364                 continue;
365             else if (tc == 'r')
366                 mode |= DFS_READ;
367             else if (tc == 'w')
368                 mode |= DFS_WRITE;
369             else if (tc == 'x')
370                 mode |= DFS_EXECUTE;
371             else if (tc == 'c')
372                 mode |= DFS_CONTROL;
373             else if (tc == 'i')
374                 mode |= DFS_INSERT;
375             else if (tc == 'd')
376                 mode |= DFS_DELETE;
377             else if (tc == 'A')
378                 mode |= DFS_USR0;
379             else if (tc == 'B')
380                 mode |= DFS_USR1;
381             else if (tc == 'C')
382                 mode |= DFS_USR2;
383             else if (tc == 'D')
384                 mode |= DFS_USR3;
385             else if (tc == 'E')
386                 mode |= DFS_USR4;
387             else if (tc == 'F')
388                 mode |= DFS_USR5;
389             else if (tc == 'G')
390                 mode |= DFS_USR6;
391             else if (tc == 'H')
392                 mode |= DFS_USR7;
393             else {
394                 fprintf(stderr, "%s: illegal DFS rights character '%c'.\n",
395                         pn, tc);
396                 exit(1);
397             }
398         } else {
399             if (tc == 'r')
400                 mode |= PRSFS_READ;
401             else if (tc == 'l')
402                 mode |= PRSFS_LOOKUP;
403             else if (tc == 'i')
404                 mode |= PRSFS_INSERT;
405             else if (tc == 'd')
406                 mode |= PRSFS_DELETE;
407             else if (tc == 'w')
408                 mode |= PRSFS_WRITE;
409             else if (tc == 'k')
410                 mode |= PRSFS_LOCK;
411             else if (tc == 'a')
412                 mode |= PRSFS_ADMINISTER;
413             else if (tc == 'A')
414                 mode |= PRSFS_USR0;
415             else if (tc == 'B')
416                 mode |= PRSFS_USR1;
417             else if (tc == 'C')
418                 mode |= PRSFS_USR2;
419             else if (tc == 'D')
420                 mode |= PRSFS_USR3;
421             else if (tc == 'E')
422                 mode |= PRSFS_USR4;
423             else if (tc == 'F')
424                 mode |= PRSFS_USR5;
425             else if (tc == 'G')
426                 mode |= PRSFS_USR6;
427             else if (tc == 'H')
428                 mode |= PRSFS_USR7;
429             else {
430                 fprintf(stderr, "%s: illegal rights character '%c'.\n", pn,
431                         tc);
432                 exit(1);
433             }
434         }
435     }
436     return mode;
437 }
438
439 static struct AclEntry *
440 FindList(struct AclEntry *alist, char *aname)
441 {
442     while (alist) {
443         if (!foldcmp(alist->name, aname))
444             return alist;
445         alist = alist->next;
446     }
447     return 0;
448 }
449
450 /* if no parm specified in a particular slot, set parm to be "." instead */
451 static void
452 SetDotDefault(struct cmd_item **aitemp)
453 {
454     struct cmd_item *ti;
455     if (*aitemp)
456         return;                 /* already has value */
457     /* otherwise, allocate an item representing "." */
458     ti = (struct cmd_item *)malloc(sizeof(struct cmd_item));
459     assert(ti);
460     ti->next = (struct cmd_item *)0;
461     ti->data = (char *)malloc(2);
462     assert(ti->data);
463     strcpy(ti->data, ".");
464     *aitemp = ti;
465 }
466
467 static void
468 ChangeList(struct Acl *al, afs_int32 plus, char *aname, afs_int32 arights)
469 {
470     struct AclEntry *tlist;
471     tlist = (plus ? al->pluslist : al->minuslist);
472     tlist = FindList(tlist, aname);
473     if (tlist) {
474         /* Found the item already in the list. */
475         tlist->rights = arights;
476         if (plus)
477             al->nplus -= PruneList(&al->pluslist, al->dfs);
478         else
479             al->nminus -= PruneList(&al->minuslist, al->dfs);
480         return;
481     }
482     /* Otherwise we make a new item and plug in the new data. */
483     tlist = (struct AclEntry *)malloc(sizeof(struct AclEntry));
484     assert(tlist);
485     strcpy(tlist->name, aname);
486     tlist->rights = arights;
487     if (plus) {
488         tlist->next = al->pluslist;
489         al->pluslist = tlist;
490         al->nplus++;
491         if (arights == 0 || arights == -1)
492             al->nplus -= PruneList(&al->pluslist, al->dfs);
493     } else {
494         tlist->next = al->minuslist;
495         al->minuslist = tlist;
496         al->nminus++;
497         if (arights == 0)
498             al->nminus -= PruneList(&al->minuslist, al->dfs);
499     }
500 }
501
502 static void
503 ZapList(struct AclEntry *alist)
504 {
505     struct AclEntry *tp, *np;
506     for (tp = alist; tp; tp = np) {
507         np = tp->next;
508         free(tp);
509     }
510 }
511
512 static int
513 PruneList(struct AclEntry **ae, int dfs)
514 {
515     struct AclEntry **lp;
516     struct AclEntry *te, *ne;
517     afs_int32 ctr;
518     ctr = 0;
519     lp = ae;
520     for (te = *ae; te; te = ne) {
521         if ((!dfs && te->rights == 0) || te->rights == -1) {
522             *lp = te->next;
523             ne = te->next;
524             free(te);
525             ctr++;
526         } else {
527             ne = te->next;
528             lp = &te->next;
529         }
530     }
531     return ctr;
532 }
533
534 static char *
535 SkipLine(char *astr)
536 {
537     while (*astr != '\n')
538         astr++;
539     astr++;
540     return astr;
541 }
542
543 /*
544  * Create an empty acl, taking into account whether the acl pointed
545  * to by astr is an AFS or DFS acl. Only parse this minimally, so we
546  * can recover from problems caused by bogus ACL's (in that case, always
547  * assume that the acl is AFS: for DFS, the user can always resort to
548  * acl_edit, but for AFS there may be no other way out).
549  */
550 static struct Acl *
551 EmptyAcl(char *astr)
552 {
553     struct Acl *tp;
554     int junk;
555
556     tp = (struct Acl *)malloc(sizeof(struct Acl));
557     assert(tp);
558     tp->nplus = tp->nminus = 0;
559     tp->pluslist = tp->minuslist = 0;
560     tp->dfs = 0;
561     sscanf(astr, "%d dfs:%d %s", &junk, &tp->dfs, tp->cell);
562     return tp;
563 }
564
565 static struct Acl *
566 ParseAcl(char *astr)
567 {
568     int nplus, nminus, i, trights;
569     char tname[MAXNAME];
570     struct AclEntry *first, *last, *tl;
571     struct Acl *ta;
572
573     ta = (struct Acl *)malloc(sizeof(struct Acl));
574     assert(ta);
575     ta->dfs = 0;
576     sscanf(astr, "%d dfs:%d %s", &ta->nplus, &ta->dfs, ta->cell);
577     astr = SkipLine(astr);
578     sscanf(astr, "%d", &ta->nminus);
579     astr = SkipLine(astr);
580
581     nplus = ta->nplus;
582     nminus = ta->nminus;
583
584     last = 0;
585     first = 0;
586     for (i = 0; i < nplus; i++) {
587         sscanf(astr, "%100s %d", tname, &trights);
588         astr = SkipLine(astr);
589         tl = (struct AclEntry *)malloc(sizeof(struct AclEntry));
590         assert(tl);
591         if (!first)
592             first = tl;
593         strcpy(tl->name, tname);
594         tl->rights = trights;
595         tl->next = 0;
596         if (last)
597             last->next = tl;
598         last = tl;
599     }
600     ta->pluslist = first;
601
602     last = 0;
603     first = 0;
604     for (i = 0; i < nminus; i++) {
605         sscanf(astr, "%100s %d", tname, &trights);
606         astr = SkipLine(astr);
607         tl = (struct AclEntry *)malloc(sizeof(struct AclEntry));
608         assert(tl);
609         if (!first)
610             first = tl;
611         strcpy(tl->name, tname);
612         tl->rights = trights;
613         tl->next = 0;
614         if (last)
615             last->next = tl;
616         last = tl;
617     }
618     ta->minuslist = first;
619
620     return ta;
621 }
622
623 static int
624 PrintStatus(VolumeStatus * status, char *name, char *offmsg)
625 {
626     printf("Volume status for vid = %u named %s\n", status->Vid, name);
627     if (*offmsg != 0)
628         printf("Current offline message is %s\n", offmsg);
629     printf("Current disk quota is ");
630     if (status->MaxQuota != 0)
631         printf("%d\n", status->MaxQuota);
632     else
633         printf("unlimited\n");
634     printf("Current blocks used are %d\n", status->BlocksInUse);
635     printf("The partition has %d blocks available out of %d\n\n",
636            status->PartBlocksAvail, status->PartMaxBlocks);
637     return 0;
638 }
639
640 static int
641 QuickPrintStatus(VolumeStatus * status, char *name)
642 {
643     double QuotaUsed = 0.0;
644     double PartUsed = 0.0;
645     int WARN = 0;
646     printf("%-25.25s", name);
647
648     if (status->MaxQuota != 0) {
649         printf("%10d%10d", status->MaxQuota, status->BlocksInUse);
650         QuotaUsed =
651             ((((double)status->BlocksInUse) / status->MaxQuota) * 100.0);
652     } else {
653         printf("  no limit%10d", status->BlocksInUse);
654     }
655     if (QuotaUsed > 90.0) {
656         printf("%5.0f%%<<", QuotaUsed);
657         WARN = 1;
658     } else
659         printf("%5.0f%%  ", QuotaUsed);
660     PartUsed =
661         (100.0 -
662          ((((double)status->PartBlocksAvail) / status->PartMaxBlocks) *
663           100.0));
664     if (PartUsed > 97.0) {
665         printf("%9.0f%%<<", PartUsed);
666         WARN = 1;
667     } else
668         printf("%9.0f%%  ", PartUsed);
669     if (WARN) {
670         printf("  <<WARNING\n");
671     } else
672         printf("\n");
673     return 0;
674 }
675
676 static int
677 QuickPrintSpace(VolumeStatus * status, char *name)
678 {
679     double PartUsed = 0.0;
680     int WARN = 0;
681     printf("%-25.25s", name);
682
683     printf("%10d%10d%10d", status->PartMaxBlocks,
684            status->PartMaxBlocks - status->PartBlocksAvail,
685            status->PartBlocksAvail);
686
687     PartUsed =
688         (100.0 -
689          ((((double)status->PartBlocksAvail) / status->PartMaxBlocks) *
690           100.0));
691     if (PartUsed > 90.0) {
692         printf(" %4.0f%%<<", PartUsed);
693         WARN = 1;
694     } else
695         printf(" %4.0f%%  ", PartUsed);
696     if (WARN) {
697         printf("  <<WARNING\n");
698     } else
699         printf("\n");
700     return 0;
701 }
702
703 static char *
704 AclToString(struct Acl *acl)
705 {
706     static char mydata[MAXSIZE];
707     char tstring[MAXSIZE];
708     char dfsstring[30];
709     struct AclEntry *tp;
710
711     if (acl->dfs)
712         sprintf(dfsstring, " dfs:%d %s", acl->dfs, acl->cell);
713     else
714         dfsstring[0] = '\0';
715     sprintf(mydata, "%d%s\n%d\n", acl->nplus, dfsstring, acl->nminus);
716     for (tp = acl->pluslist; tp; tp = tp->next) {
717         sprintf(tstring, "%s %d\n", tp->name, tp->rights);
718         strcat(mydata, tstring);
719     }
720     for (tp = acl->minuslist; tp; tp = tp->next) {
721         sprintf(tstring, "%s %d\n", tp->name, tp->rights);
722         strcat(mydata, tstring);
723     }
724     return mydata;
725 }
726
727 static int
728 SetACLCmd(struct cmd_syndesc *as, void *arock)
729 {
730     afs_int32 code;
731     struct ViceIoctl blob;
732     struct Acl *ta = 0;
733     struct cmd_item *ti, *ui;
734     int plusp;
735     afs_int32 rights;
736     int clear;
737     int idf = getidf(as, parm_setacl_id);
738     int error = 0;
739
740     if (as->parms[2].items)
741         clear = 1;
742     else
743         clear = 0;
744     plusp = !(as->parms[3].items);
745     for (ti = as->parms[0].items; ti; ti = ti->next) {
746         blob.out_size = MAXSIZE;
747         blob.in_size = idf;
748         blob.in = blob.out = space;
749         code = pioctl(ti->data, VIOCGETAL, &blob, 1);
750         if (code) {
751             Die(errno, ti->data);
752             error = 1;
753             continue;
754         }
755
756         if (ta)
757             ZapAcl(ta);
758         ta = ParseAcl(space);
759         if (!plusp && ta->dfs) {
760             fprintf(stderr,
761                     "%s: %s: you may not use the -negative switch with DFS acl's.\n%s",
762                     pn, ti->data,
763                     "(you may specify \"null\" to revoke all rights, however)\n");
764             error = 1;
765             continue;
766         }
767
768         if (ta)
769             ZapAcl(ta);
770         if (clear)
771             ta = EmptyAcl(space);
772         else
773             ta = ParseAcl(space);
774         CleanAcl(ta, ti->data);
775         for (ui = as->parms[1].items; ui; ui = ui->next->next) {
776             enum rtype rtype;
777             if (!ui->next) {
778                 fprintf(stderr,
779                         "%s: Missing second half of user/access pair.\n", pn);
780                 ZapAcl(ta);
781                 return 1;
782             }
783             rights = Convert(ui->next->data, ta->dfs, &rtype);
784             if (rtype == destroy && !ta->dfs) {
785                 struct AclEntry *tlist;
786
787                 tlist = (plusp ? ta->pluslist : ta->minuslist);
788                 if (!FindList(tlist, ui->data))
789                     continue;
790             }
791             if (rtype == deny && !ta->dfs)
792                 plusp = 0;
793             if (rtype == destroy && ta->dfs)
794                 rights = -1;
795             ChangeList(ta, plusp, ui->data, rights);
796         }
797         blob.in = AclToString(ta);
798         blob.out_size = 0;
799         blob.in_size = 1 + strlen(blob.in);
800         code = pioctl(ti->data, VIOCSETAL, &blob, 1);
801         if (code) {
802             if (errno == EINVAL) {
803                 if (ta->dfs) {
804                     static char *fsenv = 0;
805                     if (!fsenv) {
806                         fsenv = (char *)getenv("FS_EXPERT");
807                     }
808                     fprintf(stderr,
809                             "%s: \"Invalid argument\" was returned when you tried to store a DFS access list.\n",
810                             pn);
811                     if (!fsenv) {
812                         fprintf(stderr,
813                                 "%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s",
814                                 "\nPossible reasons for this include:\n\n",
815                                 " -You may have specified an inappropriate combination of rights.\n",
816                                 "  For example, some DFS-supported filesystems may not allow you to\n",
817                                 "  drop the \"c\" right from \"user_obj\".\n\n",
818                                 " -A mask_obj may be required (it is likely required by the underlying\n",
819                                 "  filesystem if you try to set anything other than the basic \"user_obj\"\n",
820                                 "  \"mask_obj\", or \"group_obj\" entries). Unlike acl_edit, the fs command\n",
821                                 "  does not automatically create or update the mask_obj. Try setting\n",
822                                 "  the rights \"mask_obj all\" with \"fs sa\" before adding any explicit\n",
823                                 "  users or groups. You can do this with a single command, such as\n",
824                                 "  \"fs sa mask_obj all user:somename read\"\n\n",
825                                 " -A specified user or group may not exist.\n\n",
826                                 " -You may have tried to delete \"user_obj\", \"group_obj\", or \"other_obj\".\n",
827                                 "  This is probably not allowed by the underlying file system.\n\n",
828                                 " -If you add a user or group to a DFS ACL, remember that it must be\n",
829                                 "  fully specified as \"user:username\" or \"group:groupname\". In addition, there\n",
830                                 "  may be local requirements on the format of the user or group name.\n",
831                                 "  Check with your cell administrator.\n\n",
832                                 " -Or numerous other possibilities. It would be great if we could be more\n",
833                                 "  precise about the actual problem, but for various reasons, this is\n",
834                                 "  impractical via this interface.  If you can't figure it out, you\n",
835                                 "  might try logging into a DCE-equipped machine and use acl_edit (or\n",
836                                 "  whatever is provided). You may get better results. Good luck!\n\n",
837                                 " (You may inhibit this message by setting \"FS_EXPERT\" in your environment)\n");
838                     }
839                 } else {
840                     fprintf(stderr,
841                             "%s: Invalid argument, possible reasons include:\n",
842                             pn);
843                     fprintf(stderr, "\t-File not in AFS\n");
844                     fprintf(stderr,
845                             "\t-Too many users on access control list\n");
846                     fprintf(stderr,
847                             "\t-Tried to add non-existent user to access control list\n");
848                 }
849             } else {
850                 Die(errno, ti->data);
851             }
852             error = 1;
853         }
854     }
855     if (ta)
856         ZapAcl(ta);
857     return error;
858 }
859
860
861 static int
862 CopyACLCmd(struct cmd_syndesc *as, void *arock)
863 {
864     afs_int32 code;
865     struct ViceIoctl blob;
866     struct Acl *fa, *ta = 0;
867     struct AclEntry *tp;
868     struct cmd_item *ti, *ui;
869     int plusp;
870     afs_int32 rights;
871     int clear;
872     int idf = getidf(as, parm_copyacl_id);
873     int error = 0;
874
875     if (as->parms[2].items)
876         clear = 1;
877     else
878         clear = 0;
879     blob.out_size = MAXSIZE;
880     blob.in_size = idf;
881     blob.in = blob.out = space;
882     code = pioctl(as->parms[0].items->data, VIOCGETAL, &blob, 1);
883     if (code) {
884         Die(errno, as->parms[0].items->data);
885         return 1;
886     }
887     fa = ParseAcl(space);
888     CleanAcl(fa, as->parms[0].items->data);
889     for (ti = as->parms[1].items; ti; ti = ti->next) {
890         blob.out_size = MAXSIZE;
891         blob.in_size = idf;
892         blob.in = blob.out = space;
893         code = pioctl(ti->data, VIOCGETAL, &blob, 1);
894         if (code) {
895             Die(errno, ti->data);
896             error = 1;
897             continue;
898         }
899
900         if (ta)
901             ZapAcl(ta);
902         if (clear)
903             ta = EmptyAcl(space);
904         else
905             ta = ParseAcl(space);
906         CleanAcl(ta, ti->data);
907         if (ta->dfs != fa->dfs) {
908             fprintf(stderr,
909                     "%s: incompatible file system types: acl not copied to %s; aborted\n",
910                     pn, ti->data);
911             error = 1;
912             continue;
913         }
914         if (ta->dfs) {
915             if (!clear && strcmp(ta->cell, fa->cell) != 0) {
916                 fprintf(stderr,
917                         "%s: default DCE cell differs for file %s: use \"-clear\" switch; acl not merged\n",
918                         pn, ti->data);
919                 error = 1;
920                 continue;
921             }
922             strcpy(ta->cell, fa->cell);
923         }
924         for (tp = fa->pluslist; tp; tp = tp->next)
925             ChangeList(ta, 1, tp->name, tp->rights);
926         for (tp = fa->minuslist; tp; tp = tp->next)
927             ChangeList(ta, 0, tp->name, tp->rights);
928         blob.in = AclToString(ta);
929         blob.out_size = 0;
930         blob.in_size = 1 + strlen(blob.in);
931         code = pioctl(ti->data, VIOCSETAL, &blob, 1);
932         if (code) {
933             if (errno == EINVAL) {
934                 fprintf(stderr,
935                         "%s: Invalid argument, possible reasons include:\n",
936                         pn);
937                 fprintf(stderr, "\t-File not in AFS\n");
938             } else {
939                 Die(errno, ti->data);
940             }
941             error = 1;
942         }
943     }
944     if (ta)
945         ZapAcl(ta);
946     ZapAcl(fa);
947     return error;
948 }
949
950 /* pioctl() call to get the cellname of a pathname */
951 static afs_int32
952 GetCell(char *fname, char *cellname)
953 {
954     afs_int32 code;
955     struct ViceIoctl blob;
956
957     blob.in_size = 0;
958     blob.out_size = MAXCELLCHARS;
959     blob.out = cellname;
960
961     code = pioctl(fname, VIOC_FILE_CELL_NAME, &blob, 1);
962     return code ? errno : 0;
963 }
964
965 /* Check if a username is valid: If it contains only digits (or a
966  * negative sign), then it might be bad. We then query the ptserver
967  * to see.
968  */
969 static
970 BadName(char *aname, char *fname)
971 {
972     afs_int32 tc, code, id;
973     char *nm;
974     char cell[MAXCELLCHARS];
975
976     for (nm = aname; tc = *nm; nm++) {
977         /* all must be '-' or digit to be bad */
978         if (tc != '-' && (tc < '0' || tc > '9'))
979             return 0;
980     }
981
982     /* Go to the PRDB and see if this all number username is valid */
983     code = GetCell(fname, cell);
984     if (code)
985         return 0;
986
987     pr_Initialize(1, AFSDIR_CLIENT_ETC_DIRPATH, cell);
988     code = pr_SNameToId(aname, &id);
989     pr_End();
990
991     /* 1=>Not-valid; 0=>Valid */
992     return ((!code && (id == ANONYMOUSID)) ? 1 : 0);
993 }
994
995
996 /* clean up an access control list of its bad entries; return 1 if we made
997    any changes to the list, and 0 otherwise */
998 static
999 CleanAcl(struct Acl *aa, char *fname)
1000 {
1001     struct AclEntry *te, **le, *ne;
1002     int changes;
1003
1004     /* Don't correct DFS ACL's for now */
1005     if (aa->dfs)
1006         return 0;
1007
1008     /* prune out bad entries */
1009     changes = 0;                /* count deleted entries */
1010     le = &aa->pluslist;
1011     for (te = aa->pluslist; te; te = ne) {
1012         ne = te->next;
1013         if (BadName(te->name, fname)) {
1014             /* zap this dude */
1015             *le = te->next;
1016             aa->nplus--;
1017             free(te);
1018             changes++;
1019         } else {
1020             le = &te->next;
1021         }
1022     }
1023     le = &aa->minuslist;
1024     for (te = aa->minuslist; te; te = ne) {
1025         ne = te->next;
1026         if (BadName(te->name, fname)) {
1027             /* zap this dude */
1028             *le = te->next;
1029             aa->nminus--;
1030             free(te);
1031             changes++;
1032         } else {
1033             le = &te->next;
1034         }
1035     }
1036     return changes;
1037 }
1038
1039
1040 /* clean up an acl to not have bogus entries */
1041 static int
1042 CleanACLCmd(struct cmd_syndesc *as, void *arock)
1043 {
1044     afs_int32 code;
1045     struct Acl *ta = 0;
1046     struct ViceIoctl blob;
1047     int changes;
1048     struct cmd_item *ti;
1049     struct AclEntry *te;
1050     int error = 0;
1051
1052     SetDotDefault(&as->parms[0].items);
1053     for (ti = as->parms[0].items; ti; ti = ti->next) {
1054         blob.out_size = MAXSIZE;
1055         blob.in_size = 0;
1056         blob.out = space;
1057         code = pioctl(ti->data, VIOCGETAL, &blob, 1);
1058         if (code) {
1059             Die(errno, ti->data);
1060             error = 1;
1061             continue;
1062         }
1063
1064         if (ta)
1065             ZapAcl(ta);
1066         ta = ParseAcl(space);
1067         if (ta->dfs) {
1068             fprintf(stderr,
1069                     "%s: cleanacl is not supported for DFS access lists.\n",
1070                     pn);
1071             error = 1;
1072             continue;
1073         }
1074
1075         changes = CleanAcl(ta, ti->data);
1076
1077         if (changes) {
1078             /* now set the acl */
1079             blob.in = AclToString(ta);
1080             blob.in_size = strlen(blob.in) + 1;
1081             blob.out_size = 0;
1082             code = pioctl(ti->data, VIOCSETAL, &blob, 1);
1083             if (code) {
1084                 if (errno == EINVAL) {
1085                     fprintf(stderr,
1086                             "%s: Invalid argument, possible reasons include\n",
1087                             pn);
1088                     fprintf(stderr, "%s: File not in vice or\n", pn);
1089                     fprintf(stderr,
1090                             "%s: Too many users on access control list or\n",
1091                             pn);
1092                 } else {
1093                     Die(errno, ti->data);
1094                 }
1095                 error = 1;
1096                 continue;
1097             }
1098
1099             /* now list the updated acl */
1100             printf("Access list for %s is now\n", ti->data);
1101             if (ta->nplus > 0) {
1102                 if (!ta->dfs)
1103                     printf("Normal rights:\n");
1104                 for (te = ta->pluslist; te; te = te->next) {
1105                     printf("  %s ", te->name);
1106                     PRights(te->rights, ta->dfs);
1107                     printf("\n");
1108                 }
1109             }
1110             if (ta->nminus > 0) {
1111                 printf("Negative rights:\n");
1112                 for (te = ta->minuslist; te; te = te->next) {
1113                     printf("  %s ", te->name);
1114                     PRights(te->rights, ta->dfs);
1115                     printf("\n");
1116                 }
1117             }
1118             if (ti->next)
1119                 printf("\n");
1120         } else
1121             printf("Access list for %s is fine.\n", ti->data);
1122     }
1123     if (ta)
1124         ZapAcl(ta);
1125     return error;
1126 }
1127
1128 static int
1129 ListACLCmd(struct cmd_syndesc *as, void *arock)
1130 {
1131     afs_int32 code;
1132     struct Acl *ta;
1133     struct ViceIoctl blob;
1134     struct AclEntry *te;
1135     struct cmd_item *ti;
1136     int idf = getidf(as, parm_listacl_id);
1137     int error = 0;
1138
1139     SetDotDefault(&as->parms[0].items);
1140     for (ti = as->parms[0].items; ti; ti = ti->next) {
1141         blob.out_size = MAXSIZE;
1142         blob.in_size = idf;
1143         blob.in = blob.out = space;
1144         code = pioctl(ti->data, VIOCGETAL, &blob, 1);
1145         if (code) {
1146             Die(errno, ti->data);
1147             error = 1;
1148             continue;
1149         }
1150         ta = ParseAcl(space);
1151         switch (ta->dfs) {
1152         case 0:
1153             printf("Access list for %s is\n", ti->data);
1154             break;
1155         case 1:
1156             printf("DFS access list for %s is\n", ti->data);
1157             break;
1158         case 2:
1159             printf("DFS initial directory access list of %s is\n", ti->data);
1160             break;
1161         case 3:
1162             printf("DFS initial file access list of %s is\n", ti->data);
1163             break;
1164         }
1165         if (ta->dfs) {
1166             printf("  Default cell = %s\n", ta->cell);
1167         }
1168         if (ta->nplus > 0) {
1169             if (!ta->dfs)
1170                 printf("Normal rights:\n");
1171             for (te = ta->pluslist; te; te = te->next) {
1172                 printf("  %s ", te->name);
1173                 PRights(te->rights, ta->dfs);
1174                 printf("\n");
1175             }
1176         }
1177         if (ta->nminus > 0) {
1178             printf("Negative rights:\n");
1179             for (te = ta->minuslist; te; te = te->next) {
1180                 printf("  %s ", te->name);
1181                 PRights(te->rights, ta->dfs);
1182                 printf("\n");
1183             }
1184         }
1185         if (ti->next)
1186             printf("\n");
1187         ZapAcl(ta);
1188     }
1189     return error;
1190 }
1191
1192 static int
1193 GetCallerAccess(struct cmd_syndesc *as, void *arock)
1194 {
1195     struct cmd_item *ti;
1196     int error = 0;
1197
1198     SetDotDefault(&as->parms[0].items);
1199     for (ti = as->parms[0].items; ti; ti = ti->next) {
1200         afs_int32 code;
1201         struct ViceIoctl blob;
1202         struct vcxstat2 stat;
1203         blob.out_size = sizeof(struct vcxstat2);
1204         blob.in_size = 0;
1205         blob.out = (void *)&stat;
1206         code = pioctl(ti->data, VIOC_GETVCXSTATUS2, &blob, 1);
1207         if (code) {
1208             Die(errno, ti->data);
1209             error = 1;
1210             continue;
1211         }
1212         printf("Callers access to %s is ", ti->data);
1213         PRights(stat.callerAccess, 0);
1214         printf("\n");
1215     }
1216     return error;
1217 }
1218
1219 static int
1220 FlushVolumeCmd(struct cmd_syndesc *as, void *arock)
1221 {
1222     afs_int32 code;
1223     struct ViceIoctl blob;
1224     struct cmd_item *ti;
1225     int error = 0;
1226
1227     SetDotDefault(&as->parms[0].items);
1228     for (ti = as->parms[0].items; ti; ti = ti->next) {
1229         blob.in_size = blob.out_size = 0;
1230         code = pioctl(ti->data, VIOC_FLUSHVOLUME, &blob, 0);
1231         if (code) {
1232             fprintf(stderr, "Error flushing volume ");
1233             perror(ti->data);
1234             error = 1;
1235             continue;
1236         }
1237     }
1238     return error;
1239 }
1240
1241 /* 
1242  * The Windows version of UuidCmd displays the UUID.
1243  * When the UNIX version is updated to do the same
1244  * be sure to replace the CMD_REQUIRED flag with
1245  * CMD_OPTIONAL in the cmd_AddParam(-generate) call 
1246  */
1247 static int
1248 UuidCmd(struct cmd_syndesc *as, void *arock)
1249 {
1250     afs_int32 code;
1251     struct ViceIoctl blob;
1252
1253     blob.in_size = 0;
1254     blob.out_size = 0;
1255     
1256     if (as->parms[0].items) {
1257         if (geteuid()) {
1258             fprintf (stderr, "Permission denied: requires root access.\n");
1259             return EACCES;
1260         }
1261
1262         /* generate new UUID */
1263         code = pioctl(0, VIOC_NEWUUID, &blob, 1);
1264
1265         if (code) {
1266             Die(errno, 0);
1267             return 1;
1268         }
1269
1270         printf("New uuid generated.\n");
1271     } else {
1272         /* This will never execute */
1273         printf("Please add the '-generate' option to generate a new UUID.\n");
1274     }
1275     return 0;
1276 }
1277
1278 static int
1279 FlushCmd(struct cmd_syndesc *as, void *arock)
1280 {
1281     afs_int32 code;
1282     struct ViceIoctl blob;
1283     struct cmd_item *ti;
1284     int error = 0;
1285
1286     for (ti = as->parms[0].items; ti; ti = ti->next) {
1287         blob.in_size = blob.out_size = 0;
1288         code = pioctl(ti->data, VIOCFLUSH, &blob, 0);
1289         if (code) {
1290             if (errno == EMFILE) {
1291                 fprintf(stderr, "%s: Can't flush active file %s\n", pn,
1292                         ti->data);
1293             } else {
1294                 fprintf(stderr, "%s: Error flushing file ", pn);
1295                 perror(ti->data);
1296             }
1297             error = 1;
1298             continue;
1299         }
1300     }
1301     return error;
1302 }
1303
1304 /* all this command does is repackage its args and call SetVolCmd */
1305 static int
1306 SetQuotaCmd(struct cmd_syndesc *as, void *arock)
1307 {
1308     struct cmd_syndesc ts;
1309
1310     /* copy useful stuff from our command slot; we may later have to reorder */
1311     memcpy(&ts, as, sizeof(ts));        /* copy whole thing */
1312     return SetVolCmd(&ts, arock);
1313 }
1314
1315 static int
1316 SetVolCmd(struct cmd_syndesc *as, void *arock)
1317 {
1318     afs_int32 code;
1319     struct ViceIoctl blob;
1320     struct cmd_item *ti;
1321     struct VolumeStatus *status;
1322     char *offmsg, *input;
1323     int error = 0;
1324
1325     SetDotDefault(&as->parms[0].items);
1326     for (ti = as->parms[0].items; ti; ti = ti->next) {
1327         /* once per file */
1328         blob.out_size = MAXSIZE;
1329         blob.in_size = sizeof(*status) + 3;     /* for the three terminating nulls */
1330         blob.out = space;
1331         blob.in = space;
1332         status = (VolumeStatus *) space;
1333         status->MinQuota = status->MaxQuota = -1;
1334         offmsg = NULL;
1335         if (as->parms[1].items) {
1336             code = util_GetInt32(as->parms[1].items->data, &status->MaxQuota);
1337             if (code) {
1338                 fprintf(stderr, "%s: bad integer specified for quota.\n", pn);
1339                 error = 1;
1340                 continue;
1341             }
1342         }
1343         if (as->parms[2].items)
1344             offmsg = as->parms[2].items->data;
1345         input = (char *)status + sizeof(*status);
1346         *(input++) = '\0';      /* never set name: this call doesn't change vldb */
1347         if (offmsg) {
1348             if (strlen(offmsg) >= VMSGSIZE) {
1349                 fprintf(stderr,
1350                         "%s: message must be shorter than %d characters\n",
1351                         pn, VMSGSIZE);
1352                 error = 1;
1353                 continue;
1354             }
1355             strcpy(input, offmsg);
1356             blob.in_size += strlen(offmsg);
1357             input += strlen(offmsg) + 1;
1358         } else
1359             *(input++) = '\0';
1360         *(input++) = '\0';      /* Pad for old style volume "motd" */
1361         code = pioctl(ti->data, VIOCSETVOLSTAT, &blob, 1);
1362         if (code) {
1363             Die(errno, ti->data);
1364             error = 1;
1365         }
1366     }
1367     return error;
1368 }
1369
1370 /*
1371  * Why is VenusFid declared in the kernel-only section of afs.h,
1372  * if it's the exported interface of the cache manager?
1373  */
1374 struct VenusFid {
1375     afs_int32 Cell;
1376     AFSFid Fid;
1377 };
1378
1379 static int
1380 ExamineCmd(struct cmd_syndesc *as, void *arock)
1381 {
1382     afs_int32 code;
1383     struct ViceIoctl blob;
1384     struct cmd_item *ti;
1385     struct VolumeStatus *status;
1386     char *name, *offmsg;
1387     int error = 0;
1388
1389     SetDotDefault(&as->parms[0].items);
1390     for (ti = as->parms[0].items; ti; ti = ti->next) {
1391         struct VenusFid vfid;
1392
1393         /* once per file */
1394         blob.out_size = MAXSIZE;
1395         blob.in_size = 0;
1396         blob.out = space;
1397         code = pioctl(ti->data, VIOCGETVOLSTAT, &blob, 1);
1398         if (code) {
1399             Die(errno, ti->data);
1400             error = 1;
1401             continue;
1402         }
1403         status = (VolumeStatus *) space;
1404         name = (char *)status + sizeof(*status);
1405         offmsg = name + strlen(name) + 1;
1406
1407         blob.out_size = sizeof(struct VenusFid);
1408         blob.out = (char *) &vfid;
1409         if (0 == pioctl(ti->data, VIOCGETFID, &blob, 1)) {
1410             printf("File %s (%u.%u.%u) contained in volume %u\n",
1411                    ti->data, vfid.Fid.Volume, vfid.Fid.Vnode, vfid.Fid.Unique,
1412                    vfid.Fid.Volume);
1413         }
1414
1415         PrintStatus(status, name, offmsg);
1416     }
1417     return error;
1418 }
1419
1420 static int
1421 ListQuotaCmd(struct cmd_syndesc *as, void *arock)
1422 {
1423     afs_int32 code;
1424     struct ViceIoctl blob;
1425     struct cmd_item *ti;
1426     struct VolumeStatus *status;
1427     char *name;
1428     int error = 0;
1429
1430     printf("%-25s%-10s%-10s%-7s%-11s\n", "Volume Name", "     Quota",
1431            "      Used", " %Used", "  Partition");
1432     SetDotDefault(&as->parms[0].items);
1433     for (ti = as->parms[0].items; ti; ti = ti->next) {
1434         /* once per file */
1435         blob.out_size = MAXSIZE;
1436         blob.in_size = 0;
1437         blob.out = space;
1438         code = pioctl(ti->data, VIOCGETVOLSTAT, &blob, 1);
1439         if (code) {
1440             Die(errno, ti->data);
1441             error = 1;
1442             continue;
1443         }
1444         status = (VolumeStatus *) space;
1445         name = (char *)status + sizeof(*status);
1446         QuickPrintStatus(status, name);
1447     }
1448     return error;
1449 }
1450
1451 static int
1452 WhereIsCmd(struct cmd_syndesc *as, void *arock)
1453 {
1454     afs_int32 code;
1455     struct ViceIoctl blob;
1456     struct cmd_item *ti;
1457     int j;
1458     afs_int32 *hosts;
1459     char *tp;
1460     int error = 0;
1461
1462     SetDotDefault(&as->parms[0].items);
1463     for (ti = as->parms[0].items; ti; ti = ti->next) {
1464         /* once per file */
1465         blob.out_size = MAXSIZE;
1466         blob.in_size = 0;
1467         blob.out = space;
1468         memset(space, 0, sizeof(space));
1469         code = pioctl(ti->data, VIOCWHEREIS, &blob, 1);
1470         if (code) {
1471             Die(errno, ti->data);
1472             error = 1;
1473             continue;
1474         }
1475         hosts = (afs_int32 *) space;
1476         printf("File %s is on host%s ", ti->data,
1477                (hosts[0] && !hosts[1]) ? "" : "s");
1478         for (j = 0; j < MAXHOSTS; j++) {
1479             if (hosts[j] == 0)
1480                 break;
1481             tp = hostutil_GetNameByINet(hosts[j]);
1482             printf("%s ", tp);
1483         }
1484         printf("\n");
1485     }
1486     return error;
1487 }
1488
1489
1490 static int
1491 DiskFreeCmd(struct cmd_syndesc *as, void *arock)
1492 {
1493     afs_int32 code;
1494     struct ViceIoctl blob;
1495     struct cmd_item *ti;
1496     char *name;
1497     struct VolumeStatus *status;
1498     int error = 0;
1499
1500     printf("%-25s%-10s%-10s%-10s%-6s\n", "Volume Name", "    kbytes",
1501            "      used", "     avail", " %used");
1502     SetDotDefault(&as->parms[0].items);
1503     for (ti = as->parms[0].items; ti; ti = ti->next) {
1504         /* once per file */
1505         blob.out_size = MAXSIZE;
1506         blob.in_size = 0;
1507         blob.out = space;
1508         code = pioctl(ti->data, VIOCGETVOLSTAT, &blob, 1);
1509         if (code) {
1510             Die(errno, ti->data);
1511             error = 1;
1512             continue;
1513         }
1514         status = (VolumeStatus *) space;
1515         name = (char *)status + sizeof(*status);
1516         QuickPrintSpace(status, name);
1517     }
1518     return error;
1519 }
1520
1521 static int
1522 QuotaCmd(struct cmd_syndesc *as, void *arock)
1523 {
1524     afs_int32 code;
1525     struct ViceIoctl blob;
1526     struct cmd_item *ti;
1527     double quotaPct;
1528     struct VolumeStatus *status;
1529     int error = 0;
1530
1531     SetDotDefault(&as->parms[0].items);
1532     for (ti = as->parms[0].items; ti; ti = ti->next) {
1533         /* once per file */
1534         blob.out_size = MAXSIZE;
1535         blob.in_size = 0;
1536         blob.out = space;
1537         code = pioctl(ti->data, VIOCGETVOLSTAT, &blob, 1);
1538         if (code) {
1539             Die(errno, ti->data);
1540             error = 1;
1541             continue;
1542         }
1543         status = (VolumeStatus *) space;
1544         if (status->MaxQuota)
1545             quotaPct =
1546                 ((((double)status->BlocksInUse) / status->MaxQuota) * 100.0);
1547         else
1548             quotaPct = 0.0;
1549         printf("%2.0f%% of quota used.\n", quotaPct);
1550     }
1551     return error;
1552 }
1553
1554 static int
1555 ListMountCmd(struct cmd_syndesc *as, void *arock)
1556 {
1557     afs_int32 code;
1558     struct ViceIoctl blob;
1559     struct cmd_item *ti;
1560     char orig_name[1024];       /*Original name, may be modified */
1561     char true_name[1024];       /*``True'' dirname (e.g., symlink target) */
1562     char parent_dir[1024];      /*Parent directory of true name */
1563     char *last_component;       /*Last component of true name */
1564     struct stat statbuff;       /*Buffer for status info */
1565     int link_chars_read;        /*Num chars read in readlink() */
1566     int thru_symlink;           /*Did we get to a mount point via a symlink? */
1567     int error = 0;
1568
1569     for (ti = as->parms[0].items; ti; ti = ti->next) {
1570         /* once per file */
1571         thru_symlink = 0;
1572         sprintf(orig_name, "%s%s", (ti->data[0] == '/') ? "" : "./",
1573                 ti->data);
1574
1575         if (lstat(orig_name, &statbuff) < 0) {
1576             /* if lstat fails, we should still try the pioctl, since it
1577              * may work (for example, lstat will fail, but pioctl will
1578              * work if the volume of offline (returning ENODEV). */
1579             statbuff.st_mode = S_IFDIR; /* lie like pros */
1580         }
1581
1582         /*
1583          * The lstat succeeded.  If the given file is a symlink, substitute
1584          * the file name with the link name.
1585          */
1586         if ((statbuff.st_mode & S_IFMT) == S_IFLNK) {
1587             thru_symlink = 1;
1588             /*
1589              * Read name of resolved file.
1590              */
1591             link_chars_read = readlink(orig_name, true_name, 1024);
1592             if (link_chars_read <= 0) {
1593                 fprintf(stderr,
1594                         "%s: Can't read target name for '%s' symbolic link!\n",
1595                         pn, orig_name);
1596                 error = 1;
1597                 continue;
1598             }
1599
1600             /*
1601              * Add a trailing null to what was read, bump the length.
1602              */
1603             true_name[link_chars_read++] = 0;
1604
1605             /*
1606              * If the symlink is an absolute pathname, we're fine.  Otherwise, we
1607              * have to create a full pathname using the original name and the
1608              * relative symlink name.  Find the rightmost slash in the original
1609              * name (we know there is one) and splice in the symlink value.
1610              */
1611             if (true_name[0] != '/') {
1612                 last_component = (char *)strrchr(orig_name, '/');
1613                 strcpy(++last_component, true_name);
1614                 strcpy(true_name, orig_name);
1615             }
1616         } else
1617             strcpy(true_name, orig_name);
1618
1619         /*
1620          * Find rightmost slash, if any.
1621          */
1622         last_component = (char *)strrchr(true_name, '/');
1623         if (last_component) {
1624             /*
1625              * Found it.  Designate everything before it as the parent directory,
1626              * everything after it as the final component.
1627              */
1628             strncpy(parent_dir, true_name, last_component - true_name);
1629             parent_dir[last_component - true_name] = 0;
1630             last_component++;   /*Skip the slash */
1631         } else {
1632             /*
1633              * No slash appears in the given file name.  Set parent_dir to the current
1634              * directory, and the last component as the given name.
1635              */
1636             strcpy(parent_dir, ".");
1637             last_component = true_name;
1638         }
1639
1640         if (strcmp(last_component, ".") == 0
1641             || strcmp(last_component, "..") == 0) {
1642             fprintf(stderr,
1643                     "%s: you may not use '.' or '..' as the last component\n",
1644                     pn);
1645             fprintf(stderr, "%s: of a name in the 'fs lsmount' command.\n",
1646                     pn);
1647             error = 1;
1648             continue;
1649         }
1650
1651         blob.in = last_component;
1652         blob.in_size = strlen(last_component) + 1;
1653         blob.out_size = MAXSIZE;
1654         blob.out = space;
1655         memset(space, 0, MAXSIZE);
1656
1657         code = pioctl(parent_dir, VIOC_AFS_STAT_MT_PT, &blob, 1);
1658
1659         if (code == 0) {
1660             printf("'%s' is a %smount point for volume '%s'\n", ti->data,
1661                    (thru_symlink ? "symbolic link, leading to a " : ""),
1662                    space);
1663         } else {
1664             if (errno == EINVAL) {
1665                 fprintf(stderr, "'%s' is not a mount point.\n", ti->data);
1666             } else {
1667                 Die(errno, (ti->data ? ti->data : parent_dir));
1668             }
1669             error = 1;
1670         }
1671     }
1672     return error;
1673 }
1674
1675 static int
1676 MakeMountCmd(struct cmd_syndesc *as, void *arock)
1677 {
1678     afs_int32 code;
1679     char *cellName, *volName, *tmpName;
1680     struct afsconf_cell info;
1681     struct vldbentry vldbEntry;
1682     struct ViceIoctl blob;
1683
1684 /*
1685
1686 defect #3069
1687
1688     if (as->parms[5].items && !as->parms[2].items) {
1689         fprintf(stderr, "%s: must provide cell when creating cellular mount point.\n", pn);
1690         return 1;
1691     }
1692 */
1693
1694     if (as->parms[2].items)     /* cell name specified */
1695         cellName = as->parms[2].items->data;
1696     else
1697         cellName = NULL;
1698     volName = as->parms[1].items->data;
1699
1700     if (strlen(volName) >= 64) {
1701         fprintf(stderr,
1702                 "%s: volume name too long (length must be < 64 characters)\n",
1703                 pn);
1704         return 1;
1705     }
1706
1707     /* Check for a cellname in the volume specification, and complain
1708      * if it doesn't match what was specified with -cell */
1709     if (tmpName = strchr(volName, ':')) {
1710         *tmpName = '\0';
1711         if (cellName) {
1712             if (strcasecmp(cellName, volName)) {
1713                 fprintf(stderr, "%s: cellnames do not match.\n", pn);
1714                 return 1;
1715             }
1716         }
1717         cellName = volName;
1718         volName = ++tmpName;
1719     }
1720
1721     if (!InAFS(Parent(as->parms[0].items->data))) {
1722         fprintf(stderr,
1723                 "%s: mount points must be created within the AFS file system\n",
1724                 pn);
1725         return 1;
1726     }
1727
1728     if (!cellName) {
1729         blob.in_size = 0;
1730         blob.out_size = MAXSIZE;
1731         blob.out = space;
1732         code =
1733             pioctl(Parent(as->parms[0].items->data), VIOC_FILE_CELL_NAME,
1734                    &blob, 1);
1735     }
1736
1737     code = GetCellName(cellName ? cellName : space, &info);
1738     if (code) {
1739         return 1;
1740     }
1741     if (!(as->parms[4].items)) {
1742         /* not fast, check which cell the mountpoint is being created in */
1743         /* not fast, check name with VLDB */
1744         code = VLDBInit(1, &info);
1745         if (code == 0) {
1746             /* make the check.  Don't complain if there are problems with init */
1747             code =
1748                 ubik_VL_GetEntryByNameO(uclient, 0, volName,
1749                           &vldbEntry);
1750             if (code == VL_NOENT) {
1751                 fprintf(stderr,
1752                         "%s: warning, volume %s does not exist in cell %s.\n",
1753                         pn, volName, cellName ? cellName : space);
1754             }
1755         }
1756     }
1757
1758     if (as->parms[3].items)     /* if -rw specified */
1759         strcpy(space, "%");
1760     else
1761         strcpy(space, "#");
1762     if (cellName) {
1763         /* cellular mount point, prepend cell prefix */
1764         strcat(space, info.name);
1765         strcat(space, ":");
1766     }
1767     strcat(space, volName);     /* append volume name */
1768     strcat(space, ".");         /* stupid convention; these end with a period */
1769     code = symlink(space, as->parms[0].items->data);
1770     if (code) {
1771         Die(errno, as->parms[0].items->data);
1772         return 1;
1773     }
1774     return 0;
1775 }
1776
1777 /*
1778  * Delete AFS mount points.  Variables are used as follows:
1779  *      tbuffer: Set to point to the null-terminated directory name of the mount point
1780  *          (or ``.'' if none is provided)
1781  *      tp: Set to point to the actual name of the mount point to nuke.
1782  */
1783 static int
1784 RemoveMountCmd(struct cmd_syndesc *as, void *arock)
1785 {
1786     afs_int32 code = 0;
1787     struct ViceIoctl blob;
1788     struct cmd_item *ti;
1789     char tbuffer[1024];
1790     char lsbuffer[1024];
1791     char *tp;
1792     int error = 0;
1793
1794     for (ti = as->parms[0].items; ti; ti = ti->next) {
1795         /* once per file */
1796         tp = (char *)strrchr(ti->data, '/');
1797         if (tp) {
1798             strncpy(tbuffer, ti->data, code = tp - ti->data);   /* the dir name */
1799             tbuffer[code] = 0;
1800             tp++;               /* skip the slash */
1801         } else {
1802             strcpy(tbuffer, ".");
1803             tp = ti->data;
1804         }
1805         blob.in = tp;
1806         blob.in_size = strlen(tp) + 1;
1807         blob.out = lsbuffer;
1808         blob.out_size = sizeof(lsbuffer);
1809         code = pioctl(tbuffer, VIOC_AFS_STAT_MT_PT, &blob, 0);
1810         if (code) {
1811             if (errno == EINVAL) {
1812                 fprintf(stderr, "%s: '%s' is not a mount point.\n", pn,
1813                         ti->data);
1814             } else {
1815                 Die(errno, ti->data);
1816             }
1817             error = 1;
1818             continue;           /* don't bother trying */
1819         }
1820         blob.out_size = 0;
1821         blob.in = tp;
1822         blob.in_size = strlen(tp) + 1;
1823         code = pioctl(tbuffer, VIOC_AFS_DELETE_MT_PT, &blob, 0);
1824         if (code) {
1825             Die(errno, ti->data);
1826             error = 1;
1827         }
1828     }
1829     return error;
1830 }
1831
1832 /*
1833 */
1834
1835 static int
1836 CheckServersCmd(struct cmd_syndesc *as, void *arock)
1837 {
1838     afs_int32 code;
1839     struct ViceIoctl blob;
1840     afs_int32 j;
1841     afs_int32 temp;
1842     char *tp;
1843     char tbuffer[128];
1844     afs_int32 interval;
1845     struct afsconf_cell info;
1846     struct chservinfo checkserv;
1847
1848     memset(&checkserv, 0, sizeof(struct chservinfo));
1849     blob.in_size = sizeof(struct chservinfo);
1850     blob.in = (caddr_t) & checkserv;
1851
1852     blob.out_size = MAXSIZE;
1853     blob.out = space;
1854     memset(space, 0, sizeof(afs_int32));        /* so we assure zero when nothing is copied back */
1855
1856     /* prepare flags for checkservers command */
1857     temp = 2;                   /* default to checking local cell only */
1858     if (as->parms[2].items)
1859         temp |= 1;              /* set fast flag */
1860     if (as->parms[1].items)
1861         temp &= ~2;             /* turn off local cell check */
1862
1863     checkserv.magic = 0x12345678;       /* XXX */
1864     checkserv.tflags = temp;
1865
1866     /* now copy in optional cell name, if specified */
1867     if (as->parms[0].items) {
1868         code = GetCellName(as->parms[0].items->data, &info);
1869         if (code) {
1870             return 1;
1871         }
1872         strcpy(checkserv.tbuffer, info.name);
1873         checkserv.tsize = strlen(info.name) + 1;
1874     } else {
1875         strcpy(checkserv.tbuffer, "\0");
1876         checkserv.tsize = 0;
1877     }
1878
1879     if (as->parms[3].items) {
1880         checkserv.tinterval = atol(as->parms[3].items->data);
1881
1882         /* sanity check */
1883         if (checkserv.tinterval < 0) {
1884             printf
1885                 ("Warning: The negative -interval is ignored; treated as an inquiry\n");
1886             checkserv.tinterval = 0;
1887         } else if (checkserv.tinterval > 600) {
1888             printf
1889                 ("Warning: The maximum -interval value is 10 mins (600 secs)\n");
1890             checkserv.tinterval = 600;  /* 10 min max interval */
1891         }
1892     } else {
1893         checkserv.tinterval = -1;       /* don't change current interval */
1894     }
1895
1896     code = pioctl(0, VIOCCKSERV, &blob, 1);
1897     if (code) {
1898         if ((errno == EACCES) && (checkserv.tinterval > 0)) {
1899             printf("Must be root to change -interval\n");
1900             return 1;
1901         }
1902         Die(errno, 0);
1903         return 1;
1904     }
1905     memcpy(&temp, space, sizeof(afs_int32));
1906     if (checkserv.tinterval >= 0) {
1907         if (checkserv.tinterval > 0)
1908             printf
1909                 ("The new down server probe interval (%d secs) is now in effect (old interval was %d secs)\n",
1910                  checkserv.tinterval, temp);
1911         else
1912             printf("The current down server probe interval is %d secs\n",
1913                    temp);
1914         return 0;
1915     }
1916     if (temp == 0) {
1917         printf("All servers are running.\n");
1918     } else {
1919         printf
1920             ("These servers unavailable due to network or server problems: ");
1921         for (j = 0;; j++) {
1922             memcpy(&temp, space + j * sizeof(afs_int32), sizeof(afs_int32));
1923             if (temp == 0)
1924                 break;
1925             tp = hostutil_GetNameByINet(temp);
1926             printf(" %s", tp);
1927         }
1928         printf(".\n");
1929         code = 1;               /* XXX */
1930     }
1931     return code;
1932 }
1933
1934 static int
1935 MessagesCmd(struct cmd_syndesc *as, void *arock)
1936 {
1937     afs_int32 code = 0;
1938     struct ViceIoctl blob;
1939     afs_int32 j;
1940     afs_int32 temp;
1941     struct gaginfo gagflags;
1942     struct cmd_item *show;
1943
1944     memset(&gagflags, 0, sizeof(struct gaginfo));
1945     blob.in_size = sizeof(struct gaginfo);
1946     blob.in = (caddr_t) & gagflags;
1947     blob.out_size = MAXSIZE;
1948     blob.out = space;
1949     memset(space, 0, sizeof(afs_int32));        /* so we assure zero when nothing is copied back */
1950
1951     if (show = as->parms[0].items) {
1952         if (!strcasecmp(show->data, "user"))
1953             gagflags.showflags |= GAGUSER;
1954         else if (!strcasecmp(show->data, "console"))
1955             gagflags.showflags |= GAGCONSOLE;
1956         else if (!strcasecmp(show->data, "all"))
1957             gagflags.showflags |= GAGCONSOLE | GAGUSER;
1958         else if (!strcasecmp(show->data, "none"))
1959             /* do nothing */ ;
1960         else {
1961             fprintf(stderr,
1962                     "unrecognized flag %s: must be in {user,console,all,none}\n",
1963                     show->data);
1964             code = EINVAL;
1965         }
1966     }
1967
1968     if (code)
1969         return 1;
1970
1971     code = pioctl(0, VIOC_GAG, &blob, 1);
1972     if (code) {
1973         Die(errno, 0);
1974         return 1;
1975     }
1976
1977     return 0;
1978 }
1979
1980 static int
1981 CheckVolumesCmd(struct cmd_syndesc *as, void *arock)
1982 {
1983     afs_int32 code;
1984     struct ViceIoctl blob;
1985
1986     blob.in_size = 0;
1987     blob.out_size = 0;
1988     code = pioctl(0, VIOCCKBACK, &blob, 1);
1989     if (code) {
1990         Die(errno, 0);
1991         return 1;
1992     }
1993
1994     printf("All volumeID/name mappings checked.\n");
1995     return 0;
1996 }
1997
1998 static int
1999 PreCacheCmd(struct cmd_syndesc *as, char *arock)
2000 {
2001     afs_int32 code;
2002     struct ViceIoctl blob;
2003     afs_int32 temp;
2004     
2005     if (!as->parms[0].items && !as->parms[1].items) {
2006         fprintf(stderr, "%s: syntax error in precache cmd.\n", pn);
2007         return 1;
2008     }
2009     if (as->parms[0].items) {
2010         code = util_GetInt32(as->parms[0].items->data, &temp);
2011         if (code) {
2012             fprintf(stderr, "%s: bad integer specified for precache size.\n",
2013                     pn);
2014             return 1;
2015         }
2016     } else
2017         temp = 0;
2018     blob.in = (char *)&temp;
2019     blob.in_size = sizeof(afs_int32);
2020     blob.out_size = 0;
2021     code = pioctl(0, VIOCPRECACHE, &blob, 1);
2022     if (code) {
2023         Die(errno, NULL);
2024         return 1;
2025     }
2026     
2027     printf("New precache size set.\n");
2028     return 0;
2029 }
2030
2031 static int
2032 SetCacheSizeCmd(struct cmd_syndesc *as, void *arock)
2033 {
2034     afs_int32 code;
2035     struct ViceIoctl blob;
2036     afs_int32 temp;
2037
2038     if (!as->parms[0].items && !as->parms[1].items) {
2039         fprintf(stderr, "%s: syntax error in setcachesize cmd.\n", pn);
2040         return 1;
2041     }
2042     if (as->parms[0].items) {
2043         code = util_GetInt32(as->parms[0].items->data, &temp);
2044         if (code) {
2045             fprintf(stderr, "%s: bad integer specified for cache size.\n",
2046                     pn);
2047             return 1;
2048         }
2049     } else
2050         temp = 0;
2051     blob.in = (char *)&temp;
2052     blob.in_size = sizeof(afs_int32);
2053     blob.out_size = 0;
2054     code = pioctl(0, VIOCSETCACHESIZE, &blob, 1);
2055     if (code) {
2056         if (errno == EROFS) {
2057             printf
2058                 ("'fs setcache' not allowed on memory cache based cache managers.\n");
2059         } else {
2060             Die(errno, NULL);
2061         }
2062         return 1;
2063     }
2064
2065     printf("New cache size set.\n");
2066     return 0;
2067 }
2068
2069 #define MAXGCSIZE       16
2070 static int
2071 GetCacheParmsCmd(struct cmd_syndesc *as, void *arock)
2072 {
2073     afs_int32 code, filesUsed;
2074     struct ViceIoctl blob;
2075     afs_int32 parms[MAXGCSIZE];
2076     double percentFiles, percentBlocks;
2077     afs_int32 flags = 0;
2078
2079     if (as->parms[0].items){ /* -files */
2080         flags = 1;
2081     } else if (as->parms[1].items){ /* -excessive */
2082         flags = 2;
2083     } else {
2084         flags = 0;
2085     }
2086
2087     memset(parms, '\0', sizeof parms);  /* avoid Purify UMR error */
2088     if (flags){
2089         blob.in = (char *)&flags;
2090         blob.in_size = sizeof(afs_int32);
2091     } else {    /* be backward compatible */
2092         blob.in = NULL;
2093         blob.in_size = 0;
2094     }
2095     blob.out_size = sizeof(parms);
2096     blob.out = (char *)parms;
2097     code = pioctl(0, VIOCGETCACHEPARMS, &blob, 1);
2098     if (code) {
2099         Die(errno, NULL);
2100         return 1;
2101     }
2102
2103     if (!flags){
2104         printf("AFS using %d of the cache's available %d 1K byte blocks.\n",
2105                 parms[1], parms[0]);
2106         if (parms[1] > parms[0])
2107                 printf("[Cache guideline temporarily deliberately exceeded; it will be adjusted down but you may wish to increase the cache size.]\n");
2108         return 0;
2109     }
2110
2111     percentBlocks = ((double)parms[1]/parms[0]) * 100;
2112     printf("AFS using %5.0f%% of cache blocks (%d of %d 1k blocks)\n",
2113            percentBlocks, parms[1], parms[0]);
2114
2115     if (parms[2] == 0)
2116         return 0;
2117
2118     filesUsed = parms[2] - parms[3];
2119     percentFiles = ((double)filesUsed/parms[2]) * 100;
2120     printf("          %5.0f%% of the cache files (%d of %d files)\n",
2121             percentFiles, filesUsed, parms[2]);
2122     if (flags == 2){
2123         printf("        afs_cacheFiles: %10d\n", parms[2]);
2124         printf("        IFFree:         %10d\n", parms[3]); 
2125         printf("        IFEverUsed:     %10d\n", parms[4]); 
2126         printf("        IFDataMod:      %10d\n", parms[5]); 
2127         printf("        IFDirtyPages:   %10d\n", parms[6]);
2128         printf("        IFAnyPages:     %10d\n", parms[7]); 
2129         printf("        IFDiscarded:    %10d\n", parms[8]);
2130         printf("        DCentries:  %10d\n", parms[9]);
2131         printf("          0k-   4K: %10d\n", parms[10]); 
2132         printf("          4k-  16k: %10d\n", parms[11]); 
2133         printf("         16k-  64k: %10d\n", parms[12]); 
2134         printf("         64k- 256k: %10d\n", parms[13]); 
2135         printf("        256k-   1M: %10d\n", parms[14]); 
2136         printf("              >=1M: %10d\n", parms[15]); 
2137     }
2138
2139     if (percentBlocks > 90)
2140         printf("[cache size usage over 90%, consider increasing cache size]\n");
2141     if (percentFiles > 90)
2142         printf("[cache file usage over 90%, consider increasing '-files' argument to afsd]\n");
2143          
2144     return 0;
2145 }
2146
2147 static int
2148 ListCellsCmd(struct cmd_syndesc *as, void *arock)
2149 {
2150     afs_int32 code;
2151     afs_int32 i, j;
2152     char *tcp, *tp;
2153     afs_int32 clear;
2154     struct ViceIoctl blob;
2155     int resolve;
2156
2157     resolve = !(as->parms[0].items);    /* -numeric */
2158
2159     for (i = 0;; i++) {
2160         tp = space;
2161         memcpy(tp, &i, sizeof(afs_int32));
2162         blob.out_size = MAXSIZE;
2163         blob.in_size = sizeof(afs_int32);
2164         blob.in = space;
2165         blob.out = space;
2166         code = pioctl(0, VIOCGETCELL, &blob, 1);
2167         if (code < 0) {
2168             if (errno == EDOM)
2169                 break;          /* done with the list */
2170             Die(errno, 0);
2171             return 1;
2172         }
2173         tp = space;
2174         printf("Cell %s on hosts", tp + MAXCELLHOSTS * sizeof(afs_int32));
2175         for (j = 0; j < MAXCELLHOSTS; j++) {
2176             afs_int32 addr;
2177             char *name, tbuffer[20];
2178
2179             memcpy(&addr, tp + j * sizeof(afs_int32), sizeof(afs_int32));
2180             if (addr == 0)
2181                 break;
2182
2183             if (resolve) {
2184                 name = hostutil_GetNameByINet(addr);
2185             } else {
2186                 addr = ntohl(addr);
2187                 sprintf(tbuffer, "%d.%d.%d.%d", (addr >> 24) & 0xff,
2188                         (addr >> 16) & 0xff, (addr >> 8) & 0xff, addr & 0xff);
2189                 name = tbuffer;
2190             }
2191             printf(" %s", name);
2192         }
2193         printf(".\n");
2194     }
2195     return 0;
2196 }
2197
2198 static int
2199 ListAliasesCmd(struct cmd_syndesc *as, void *arock)
2200 {
2201     afs_int32 code, i;
2202     char *tp, *aliasName, *realName;
2203     struct ViceIoctl blob;
2204
2205     for (i = 0;; i++) {
2206         tp = space;
2207         memcpy(tp, &i, sizeof(afs_int32));
2208         blob.out_size = MAXSIZE;
2209         blob.in_size = sizeof(afs_int32);
2210         blob.in = space;
2211         blob.out = space;
2212         code = pioctl(0, VIOC_GETALIAS, &blob, 1);
2213         if (code < 0) {
2214             if (errno == EDOM)
2215                 break;          /* done with the list */
2216             Die(errno, 0);
2217             return 1;
2218         }
2219         tp = space;
2220         aliasName = tp;
2221         tp += strlen(aliasName) + 1;
2222         realName = tp;
2223         printf("Alias %s for cell %s\n", aliasName, realName);
2224     }
2225     return 0;
2226 }
2227
2228 static int
2229 CallBackRxConnCmd(struct cmd_syndesc *as, void *arock)
2230 {
2231     afs_int32 code;
2232     struct ViceIoctl blob;
2233     struct cmd_item *ti;
2234     afs_int32 hostAddr;
2235     struct hostent *thp;
2236     char *tp;
2237     int setp;
2238     
2239     ti = as->parms[0].items;
2240     setp = 1;
2241     if (ti) {
2242         thp = hostutil_GetHostByName(ti->data);
2243         if (!thp) {
2244             fprintf(stderr, "host %s not found in host table.\n", ti->data);
2245             return 1;
2246         }
2247         else memcpy(&hostAddr, thp->h_addr, sizeof(afs_int32));
2248     } else {
2249         hostAddr = 0;   /* means don't set host */
2250         setp = 0;       /* aren't setting host */
2251     }
2252     
2253     /* now do operation */
2254     blob.in_size = sizeof(afs_int32);
2255     blob.out_size = sizeof(afs_int32);
2256     blob.in = (char *) &hostAddr;
2257     blob.out = (char *) &hostAddr;
2258     
2259     code = pioctl(0, VIOC_CBADDR, &blob, 1);
2260     if (code < 0) {
2261         Die(errno, 0);
2262         return 1;
2263     }
2264     return 0;
2265 }
2266
2267 static int
2268 NukeNFSCredsCmd(struct cmd_syndesc *as, void *arock)
2269 {
2270     afs_int32 code;
2271     struct ViceIoctl blob;
2272     struct cmd_item *ti;
2273     afs_int32 hostAddr;
2274     struct hostent *thp;
2275     
2276     ti = as->parms[0].items;
2277     thp = hostutil_GetHostByName(ti->data);
2278     if (!thp) {
2279         fprintf(stderr, "host %s not found in host table.\n", ti->data);
2280         return 1;
2281     }
2282     else memcpy(&hostAddr, thp->h_addr, sizeof(afs_int32));
2283     
2284     /* now do operation */
2285     blob.in_size = sizeof(afs_int32);
2286     blob.out_size = sizeof(afs_int32);
2287     blob.in = (char *) &hostAddr;
2288     blob.out = (char *) &hostAddr;
2289     
2290     code = pioctl(0, VIOC_NFS_NUKE_CREDS, &blob, 1);
2291     if (code < 0) {
2292         Die(errno, 0);
2293         return 1;
2294     }
2295     return 0;
2296 }
2297
2298 static int
2299 NewCellCmd(struct cmd_syndesc *as, void *arock)
2300 {
2301     afs_int32 code, linkedstate = 0, size = 0, *lp;
2302     struct ViceIoctl blob;
2303     struct cmd_item *ti;
2304     char *tp, *cellname = 0;
2305     struct hostent *thp;
2306     afs_int32 fsport = 0, vlport = 0;
2307     afs_int32 magic, scount;    /* Number of servers to pass in pioctl call */
2308
2309     /* Yuck!
2310      * With the NEWCELL pioctl call, 3.4 clients take an array of
2311      * MAXHOSTS (13) servers while 3.5 clients take an array of
2312      * MAXCELLHOSTS (8) servers. To determine which we are talking to,
2313      * do a GETCELL pioctl and pass it a magic number. If an array of
2314      * 8 comes back, its a 3.5 client. If not, its a 3.4 client.
2315      * If we get back EDOM, there are no cells in the kernel yet,
2316      * and we'll assume a 3.5 client.
2317      */
2318     tp = space;
2319     lp = (afs_int32 *) tp;
2320     *lp++ = 0;                  /* first cell entry */
2321     *lp = 0x12345678;           /* magic */
2322     blob.out_size = MAXSIZE;
2323     blob.in_size = sizeof(afs_int32) + sizeof(afs_int32);
2324     blob.in = space;
2325     blob.out = space;
2326     code = pioctl(0, VIOCGETCELL, &blob, 1);
2327     if (code < 0 && errno != EDOM) {
2328         Die(errno, 0);
2329         return 1;
2330     }
2331     if (code < 1 && errno == EDOM) {
2332         scount = MAXHOSTS;
2333     } else {
2334         tp = space;
2335         cellname = tp + MAXCELLHOSTS * sizeof(afs_int32);
2336         scount = ((cellname[0] != '\0') ? MAXCELLHOSTS : MAXHOSTS);
2337     }
2338
2339     /* Now setup and do the NEWCELL pioctl call */
2340     memset(space, 0, (scount + 1) * sizeof(afs_int32));
2341     tp = space;
2342     lp = (afs_int32 *) tp;
2343     *lp++ = 0x12345678;
2344     tp += sizeof(afs_int32);
2345     for (ti = as->parms[1].items; ti; ti = ti->next) {
2346         thp = hostutil_GetHostByName(ti->data);
2347         if (!thp) {
2348             fprintf(stderr,
2349                     "%s: Host %s not found in host table, skipping it.\n", pn,
2350                     ti->data);
2351         } else {
2352             memcpy(tp, thp->h_addr, sizeof(afs_int32));
2353             tp += sizeof(afs_int32);
2354         }
2355     }
2356     if (as->parms[2].items) {
2357         /*
2358          * Link the cell, for the purposes of volume location, to the specified
2359          * cell.
2360          */
2361         cellname = as->parms[2].items->data;
2362         linkedstate = 1;
2363     }
2364 #ifdef FS_ENABLE_SERVER_DEBUG_PORTS
2365     if (as->parms[3].items) {
2366         code = util_GetInt32(as->parms[3].items->data, &vlport);
2367         if (code) {
2368             fprintf(stderr,
2369                     "%s: bad integer specified for the fileserver port.\n",
2370                     pn);
2371             return 1;
2372         }
2373     }
2374     if (as->parms[4].items) {
2375         code = util_GetInt32(as->parms[4].items->data, &fsport);
2376         if (code) {
2377             fprintf(stderr,
2378                     "%s: bad integer specified for the vldb server port.\n",
2379                     pn);
2380             return 1;
2381         }
2382     }
2383 #endif
2384     tp = (char *)(space + (scount + 1) * sizeof(afs_int32));
2385     lp = (afs_int32 *) tp;
2386     *lp++ = fsport;
2387     *lp++ = vlport;
2388     *lp = linkedstate;
2389     strcpy(space + ((scount + 4) * sizeof(afs_int32)),
2390            as->parms[0].items->data);
2391     size = ((scount + 4) * sizeof(afs_int32))
2392         + strlen(as->parms[0].items->data)
2393         + 1 /* for null */ ;
2394     tp = (char *)(space + size);
2395     if (linkedstate) {
2396         strcpy(tp, cellname);
2397         size += strlen(cellname) + 1;
2398     }
2399     blob.in_size = size;
2400     blob.in = space;
2401     blob.out_size = 0;
2402     code = pioctl(0, VIOCNEWCELL, &blob, 1);
2403     if (code < 0) {
2404         Die(errno, 0);
2405         return 1;
2406     }
2407     return 0;
2408 }
2409
2410 static int
2411 NewAliasCmd(struct cmd_syndesc *as, void *arock)
2412 {
2413     afs_int32 code;
2414     struct ViceIoctl blob;
2415     char *tp;
2416     char *aliasName, *realName;
2417
2418     /* Now setup and do the NEWCELL pioctl call */
2419     aliasName = as->parms[0].items->data;
2420     realName = as->parms[1].items->data;
2421     tp = space;
2422     strcpy(tp, aliasName);
2423     tp += strlen(aliasName) + 1;
2424     strcpy(tp, realName);
2425     tp += strlen(realName) + 1;
2426
2427     blob.in_size = tp - space;
2428     blob.in = space;
2429     blob.out_size = 0;
2430     blob.out = space;
2431     code = pioctl(0, VIOC_NEWALIAS, &blob, 1);
2432     if (code < 0) {
2433         if (errno == EEXIST) {
2434             fprintf(stderr,
2435                     "%s: cell name `%s' in use by an existing cell.\n", pn,
2436                     aliasName);
2437         } else {
2438             Die(errno, 0);
2439         }
2440         return 1;
2441     }
2442     return 0;
2443 }
2444
2445 static int
2446 WhichCellCmd(struct cmd_syndesc *as, void *arock)
2447 {
2448     afs_int32 code;
2449     struct cmd_item *ti;
2450     int error = 0;
2451     char cell[MAXCELLCHARS];
2452
2453     SetDotDefault(&as->parms[0].items);
2454     for (ti = as->parms[0].items; ti; ti = ti->next) {
2455         code = GetCell(ti->data, cell);
2456         if (code) {
2457             if (errno == ENOENT)
2458                 fprintf(stderr, "%s: no such cell as '%s'\n", pn, ti->data);
2459             else
2460                 Die(errno, ti->data);
2461             error = 1;
2462             continue;
2463         }
2464
2465         printf("File %s lives in cell '%s'\n", ti->data, cell);
2466     }
2467     return error;
2468 }
2469
2470 static int
2471 WSCellCmd(struct cmd_syndesc *as, void *arock)
2472 {
2473     afs_int32 code;
2474     struct ViceIoctl blob;
2475
2476     blob.in_size = 0;
2477     blob.in = NULL;
2478     blob.out_size = MAXSIZE;
2479     blob.out = space;
2480
2481     code = pioctl(NULL, VIOC_GET_WS_CELL, &blob, 1);
2482     if (code) {
2483         Die(errno, NULL);
2484         return 1;
2485     }
2486
2487     printf("This workstation belongs to cell '%s'\n", space);
2488     return 0;
2489 }
2490
2491 /*
2492 static PrimaryCellCmd(as)
2493     struct cmd_syndesc *as;
2494 {
2495     fprintf(stderr, "This command is obsolete, as is the concept of a primary token.\n");
2496     return 0;
2497 }
2498 */
2499
2500 static int
2501 MonitorCmd(struct cmd_syndesc *as, void *arock)
2502 {
2503     afs_int32 code;
2504     struct ViceIoctl blob;
2505     struct cmd_item *ti;
2506     afs_int32 hostAddr;
2507     struct hostent *thp;
2508     char *tp;
2509     int setp;
2510
2511     ti = as->parms[0].items;
2512     setp = 1;
2513     if (ti) {
2514         /* set the host */
2515         if (!strcmp(ti->data, "off"))
2516             hostAddr = 0xffffffff;
2517         else {
2518             thp = hostutil_GetHostByName(ti->data);
2519             if (!thp) {
2520                 if (!strcmp(ti->data, "localhost")) {
2521                     fprintf(stderr,
2522                             "localhost not in host table, assuming 127.0.0.1\n");
2523                     hostAddr = htonl(0x7f000001);
2524                 } else {
2525                     fprintf(stderr, "host %s not found in host table.\n",
2526                             ti->data);
2527                     return 1;
2528                 }
2529             } else
2530                 memcpy(&hostAddr, thp->h_addr, sizeof(afs_int32));
2531         }
2532     } else {
2533         hostAddr = 0;           /* means don't set host */
2534         setp = 0;               /* aren't setting host */
2535     }
2536
2537     /* now do operation */
2538     blob.in_size = sizeof(afs_int32);
2539     blob.out_size = sizeof(afs_int32);
2540     blob.in = (char *)&hostAddr;
2541     blob.out = (char *)&hostAddr;
2542     code = pioctl(0, VIOC_AFS_MARINER_HOST, &blob, 1);
2543     if (code) {
2544         Die(errno, 0);
2545         return 1;
2546     }
2547     if (setp) {
2548         printf("%s: new monitor host set.\n", pn);
2549     } else {
2550         /* now decode old address */
2551         if (hostAddr == 0xffffffff) {
2552             printf("Cache monitoring is currently disabled.\n");
2553         } else {
2554             tp = hostutil_GetNameByINet(hostAddr);
2555             printf("Using host %s for monitor services.\n", tp);
2556         }
2557     }
2558     return 0;
2559 }
2560
2561 static int
2562 SysNameCmd(struct cmd_syndesc *as, void *arock)
2563 {
2564     afs_int32 code;
2565     struct ViceIoctl blob;
2566     struct cmd_item *ti;
2567     char *input = space;
2568     afs_int32 setp = 0;
2569
2570     ti = as->parms[0].items;
2571     blob.in = space;
2572     blob.out = space;
2573     blob.out_size = MAXSIZE;
2574     blob.in_size = sizeof(afs_int32);
2575     input += sizeof(afs_int32);
2576     for (; ti; ti = ti->next) {
2577         setp++;
2578         blob.in_size += strlen(ti->data) + 1;
2579         if (blob.in_size > MAXSIZE) {
2580             fprintf(stderr, "%s: sysname%s too long.\n", pn,
2581                     setp > 1 ? "s" : "");
2582             return 1;
2583         }
2584         strcpy(input, ti->data);
2585         input += strlen(ti->data);
2586         *(input++) = '\0';
2587     }
2588     memcpy(space, &setp, sizeof(afs_int32));
2589     code = pioctl(0, VIOC_AFS_SYSNAME, &blob, 1);
2590     if (code) {
2591         Die(errno, 0);
2592         return 1;
2593     }
2594     if (setp) {
2595         printf("%s: new sysname%s set.\n", pn, setp > 1 ? " list" : "");
2596         return 0;
2597     }
2598     input = space;
2599     memcpy(&setp, input, sizeof(afs_int32));
2600     input += sizeof(afs_int32);
2601     if (!setp) {
2602         fprintf(stderr, "No sysname name value was found\n");
2603         return 1;
2604     }
2605     printf("Current sysname%s is", setp > 1 ? " list" : "");
2606     for (; setp > 0; --setp) {
2607         printf(" \'%s\'", input);
2608         input += strlen(input) + 1;
2609     }
2610     printf("\n");
2611     return 0;
2612 }
2613
2614 static char *exported_types[] = { "null", "nfs", "" };
2615 static int
2616 ExportAfsCmd(struct cmd_syndesc *as, void *arock)
2617 {
2618     afs_int32 code;
2619     struct ViceIoctl blob;
2620     struct cmd_item *ti;
2621     int export = 0, type = 0, mode = 0, exp = 0, exportcall, pwsync =
2622         0, smounts = 0, clipags = 0, pagcb = 0;
2623
2624     ti = as->parms[0].items;
2625     if (strcmp(ti->data, "nfs") == 0)
2626         type = 0x71;            /* NFS */
2627     else {
2628         fprintf(stderr,
2629                 "Invalid exporter type, '%s', Only the 'nfs' exporter is currently supported\n",
2630                 ti->data);
2631         return 1;
2632     }
2633     ti = as->parms[1].items;
2634     if (ti) {
2635         if (strcmp(ti->data, "on") == 0)
2636             export = 3;
2637         else if (strcmp(ti->data, "off") == 0)
2638             export = 2;
2639         else {
2640             fprintf(stderr, "Illegal argument %s\n", ti->data);
2641             return 1;
2642         }
2643         exp = 1;
2644     }
2645     if (ti = as->parms[2].items) {      /* -noconvert */
2646         if (strcmp(ti->data, "on") == 0)
2647             mode = 2;
2648         else if (strcmp(ti->data, "off") == 0)
2649             mode = 3;
2650         else {
2651             fprintf(stderr, "Illegal argument %s\n", ti->data);
2652             return 1;
2653         }
2654     }
2655     if (ti = as->parms[3].items) {      /* -uidcheck */
2656         if (strcmp(ti->data, "on") == 0)
2657             pwsync = 3;
2658         else if (strcmp(ti->data, "off") == 0)
2659             pwsync = 2;
2660         else {
2661             fprintf(stderr, "Illegal argument %s\n", ti->data);
2662             return 1;
2663         }
2664     }
2665     if (ti = as->parms[4].items) {      /* -submounts */
2666         if (strcmp(ti->data, "on") == 0)
2667             smounts = 3;
2668         else if (strcmp(ti->data, "off") == 0)
2669             smounts = 2;
2670         else {
2671             fprintf(stderr, "Illegal argument %s\n", ti->data);
2672             return 1;
2673         }
2674     }
2675     if (ti = as->parms[5].items) {      /* -clipags */
2676         if (strcmp(ti->data, "on") == 0)
2677             clipags = 3;
2678         else if (strcmp(ti->data, "off") == 0)
2679             clipags = 2;
2680         else {
2681             fprintf(stderr, "Illegal argument %s\n", ti->data);
2682             return 1;
2683         }
2684     }
2685     if (ti = as->parms[6].items) {      /* -pagcb */
2686         if (strcmp(ti->data, "on") == 0)
2687             pagcb = 3;
2688         else if (strcmp(ti->data, "off") == 0)
2689             pagcb = 2;
2690         else {
2691             fprintf(stderr, "Illegal argument %s\n", ti->data);
2692             return 1;
2693         }
2694     }
2695     exportcall =
2696         (type << 24) | (pagcb << 10) | (clipags << 8) |
2697         (mode << 6) | (pwsync << 4) | (smounts << 2) | export;
2698     type &= ~0x70;
2699     /* make the call */
2700     blob.in = (char *)&exportcall;
2701     blob.in_size = sizeof(afs_int32);
2702     blob.out = (char *)&exportcall;
2703     blob.out_size = sizeof(afs_int32);
2704     code = pioctl(0, VIOC_EXPORTAFS, &blob, 1);
2705     if (code) {
2706         if (errno == ENODEV) {
2707             fprintf(stderr,
2708                     "Sorry, the %s-exporter type is currently not supported on this AFS client\n",
2709                     exported_types[type]);
2710         } else {
2711             Die(errno, 0);
2712         }
2713         return 1;
2714     }
2715
2716     if (exportcall & 1) {
2717         printf("'%s' translator is enabled with the following options:\n",
2718                exported_types[type]);
2719         printf("\tRunning in %s mode\n",
2720                (exportcall & 2 ? "strict unix" :
2721                 "convert owner mode bits to world/other"));
2722         printf("\tRunning in %s mode\n",
2723                (exportcall & 4 ? "strict 'passwd sync'" :
2724                 "no 'passwd sync'"));
2725         printf("\t%s\n",
2726                (exportcall & 8 ? "Allow mounts of /afs/.. subdirs" :
2727                 "Only mounts to /afs allowed"));
2728         printf("\t%s\n",
2729                (exportcall & 16 ? "Client-assigned PAG's are used" :
2730                 "Client-assigned PAG's are not used"));
2731         printf("\t%s\n",
2732                (exportcall & 32 ?
2733                 "Callbacks are made to get creds from new clients" :
2734                 "Callbacks are not made to get creds from new clients"));
2735     } else {
2736         printf("'%s' translator is disabled\n", exported_types[type]);
2737     }
2738     return 0;
2739 }
2740
2741
2742 static int
2743 GetCellCmd(struct cmd_syndesc *as, void *arock)
2744 {
2745     afs_int32 code;
2746     struct ViceIoctl blob;
2747     struct afsconf_cell info;
2748     struct cmd_item *ti;
2749     struct a {
2750         afs_int32 stat;
2751         afs_int32 junk;
2752     } args;
2753     int error = 0;
2754
2755     memset(&args, '\0', sizeof args);   /* avoid Purify UMR error */
2756     for (ti = as->parms[0].items; ti; ti = ti->next) {
2757         /* once per cell */
2758         blob.out_size = sizeof(args);
2759         blob.out = (caddr_t) & args;
2760         code = GetCellName(ti->data, &info);
2761         if (code) {
2762             error = 1;
2763             continue;
2764         }
2765         blob.in_size = 1 + strlen(info.name);
2766         blob.in = info.name;
2767         code = pioctl(0, VIOC_GETCELLSTATUS, &blob, 1);
2768         if (code) {
2769             if (errno == ENOENT)
2770                 fprintf(stderr, "%s: the cell named '%s' does not exist\n",
2771                         pn, info.name);
2772             else
2773                 Die(errno, info.name);
2774             error = 1;
2775             continue;
2776         }
2777         printf("Cell %s status: ", info.name);
2778 #ifdef notdef
2779         if (args.stat & 1)
2780             printf("primary ");
2781 #endif
2782         if (args.stat & 2)
2783             printf("no setuid allowed");
2784         else
2785             printf("setuid allowed");
2786         if (args.stat & 4)
2787             printf(", using old VLDB");
2788         printf("\n");
2789     }
2790     return error;
2791 }
2792
2793 static int
2794 SetCellCmd(struct cmd_syndesc *as, void *arock)
2795 {
2796     afs_int32 code;
2797     struct ViceIoctl blob;
2798     struct afsconf_cell info;
2799     struct cmd_item *ti;
2800     struct a {
2801         afs_int32 stat;
2802         afs_int32 junk;
2803         char cname[64];
2804     } args;
2805     int error = 0;
2806
2807     /* Check arguments. */
2808     if (as->parms[1].items && as->parms[2].items) {
2809         fprintf(stderr, "Cannot specify both -suid and -nosuid.\n");
2810         return 1;
2811     }
2812
2813     /* figure stuff to set */
2814     args.stat = 0;
2815     args.junk = 0;
2816
2817     if (!as->parms[1].items)
2818         args.stat |= 2;         /* default to -nosuid */
2819
2820     /* set stat for all listed cells */
2821     for (ti = as->parms[0].items; ti; ti = ti->next) {
2822         /* once per cell */
2823         code = GetCellName(ti->data, &info);
2824         if (code) {
2825             error = 1;
2826             continue;
2827         }
2828         strcpy(args.cname, info.name);
2829         blob.in_size = sizeof(args);
2830         blob.in = (caddr_t) & args;
2831         blob.out_size = 0;
2832         blob.out = (caddr_t) 0;
2833         code = pioctl(0, VIOC_SETCELLSTATUS, &blob, 1);
2834         if (code) {
2835             Die(errno, info.name);      /* XXX added cell name to Die() call */
2836             error = 1;
2837         }
2838     }
2839     return error;
2840 }
2841
2842 static int
2843 GetCellName(char *cellName, struct afsconf_cell *info)
2844 {
2845     struct afsconf_dir *tdir;
2846     int code;
2847
2848     tdir = afsconf_Open(AFSDIR_CLIENT_ETC_DIRPATH);
2849     if (!tdir) {
2850         fprintf(stderr,
2851                 "Could not process files in configuration directory (%s).\n",
2852                 AFSDIR_CLIENT_ETC_DIRPATH);
2853         return -1;
2854     }
2855
2856     code = afsconf_GetCellInfo(tdir, cellName, AFSCONF_VLDBSERVICE, info);
2857     if (code) {
2858         fprintf(stderr, "%s: cell %s not in %s\n", pn, cellName,
2859                 AFSDIR_CLIENT_CELLSERVDB_FILEPATH);
2860         return code;
2861     }
2862
2863     return 0;
2864 }
2865
2866
2867 static int
2868 VLDBInit(int noAuthFlag, struct afsconf_cell *info)
2869 {
2870     afs_int32 code;
2871
2872     code = ugen_ClientInit(noAuthFlag, AFSDIR_CLIENT_ETC_DIRPATH, 
2873                            info->name, 0, &uclient, 
2874                            NULL, pn, rxkad_clear,
2875                            VLDB_MAXSERVERS, AFSCONF_VLDBSERVICE, 50,
2876                            0, 0, USER_SERVICE_ID);
2877     rxInitDone = 1;
2878     return code;
2879 }
2880
2881 static struct ViceIoctl gblob;
2882 static int debug = 0;
2883 /*
2884  * here follow some routines in suport of the setserverprefs and
2885  * getserverprefs commands.  They are:
2886  * SetPrefCmd  "top-level" routine
2887  * addServer   adds a server to the list of servers to be poked into the
2888  *             kernel.  Will poke the list into the kernel if it threatens
2889  *             to get too large.
2890  * pokeServers pokes the existing list of servers and ranks into the kernel
2891  * GetPrefCmd  reads the Cache Manager's current list of server ranks
2892  */
2893
2894 /*
2895  * returns -1 if error message printed,
2896  * 0 on success,
2897  * errno value if error and no error message printed
2898  */
2899 static int
2900 pokeServers(void)
2901 {
2902     int code;
2903
2904     code = pioctl(0, VIOC_SETSPREFS, &gblob, 1);
2905     if (code && (errno == EINVAL)) {
2906         struct setspref *ssp;
2907         ssp = (struct setspref *)gblob.in;
2908         if (!(ssp->flags & DBservers)) {
2909             gblob.in = (void *)&(ssp->servers[0]);
2910             gblob.in_size -= ((char *)&(ssp->servers[0])) - (char *)ssp;
2911             code = pioctl(0, VIOC_SETSPREFS33, &gblob, 1);
2912             return code ? errno : 0;
2913         }
2914         fprintf(stderr,
2915                 "This cache manager does not support VL server preferences.\n");
2916         return -1;
2917     }
2918
2919     return code ? errno : 0;
2920 }
2921
2922 /*
2923  * returns -1 if error message printed,
2924  * 0 on success,
2925  * errno value if error and no error message printed
2926  */
2927 static int
2928 addServer(char *name, afs_int32 rank)
2929 {
2930     int t, code;
2931     struct setspref *ssp;
2932     struct spref *sp;
2933     struct hostent *thostent;
2934     afs_uint32 addr;
2935     int error = 0;
2936
2937 #ifndef MAXUSHORT
2938 #ifdef MAXSHORT
2939 #define MAXUSHORT ((unsigned short) 2*MAXSHORT+1)       /* assumes two's complement binary system */
2940 #else
2941 #define MAXUSHORT ((unsigned short) ~0)
2942 #endif
2943 #endif
2944
2945     thostent = hostutil_GetHostByName(name);
2946     if (!thostent) {
2947         fprintf(stderr, "%s: couldn't resolve name.\n", name);
2948         return -1;
2949     }
2950
2951     ssp = (struct setspref *)(gblob.in);
2952
2953     for (t = 0; thostent->h_addr_list[t]; t++) {
2954         if (gblob.in_size > MAXINSIZE - sizeof(struct spref)) {
2955             code = pokeServers();
2956             if (code)
2957                 error = code;
2958             ssp->num_servers = 0;
2959         }
2960
2961         sp = (struct spref *)(gblob.in + gblob.in_size);
2962         memcpy(&(sp->server.s_addr), thostent->h_addr_list[t],
2963                sizeof(afs_uint32));
2964         sp->rank = (rank > MAXUSHORT ? MAXUSHORT : rank);
2965         gblob.in_size += sizeof(struct spref);
2966         ssp->num_servers++;
2967
2968         if (debug)
2969             fprintf(stderr, "adding server %s, rank %d, ip addr 0x%lx\n",
2970                     name, sp->rank, sp->server.s_addr);
2971     }
2972
2973     return error;
2974 }
2975
2976
2977 static int
2978 SetPrefCmd(struct cmd_syndesc *as, void *arock)
2979 {
2980     FILE *infd;
2981     afs_int32 code;
2982     struct cmd_item *ti;
2983     char name[80];
2984     afs_int32 rank;
2985     struct setspref *ssp;
2986     int error = 0;              /* -1 means error message printed,
2987                                  * >0 means errno value for unprinted message */
2988
2989     ssp = (struct setspref *)space;
2990     ssp->flags = 0;
2991     ssp->num_servers = 0;
2992     gblob.in_size = ((char *)&(ssp->servers[0])) - (char *)ssp;
2993     gblob.in = space;
2994     gblob.out = space;
2995     gblob.out_size = MAXSIZE;
2996
2997
2998     if (geteuid()) {
2999         fprintf(stderr, "Permission denied: requires root access.\n");
3000         return 1;
3001     }
3002
3003     ti = as->parms[2].items;    /* -file */
3004     if (ti) {
3005         if (debug)
3006             fprintf(stderr, "opening file %s\n", ti->data);
3007         if (!(infd = fopen(ti->data, "r"))) {
3008             perror(ti->data);
3009             error = -1;
3010         } else {
3011             while (fscanf(infd, "%79s%ld", name, &rank) != EOF) {
3012                 code = addServer(name, (unsigned short)rank);
3013                 if (code)
3014                     error = code;
3015             }
3016         }
3017     }
3018
3019     ti = as->parms[3].items;    /* -stdin */
3020     if (ti) {
3021         while (scanf("%79s%ld", name, &rank) != EOF) {
3022             code = addServer(name, (unsigned short)rank);
3023             if (code)
3024                 error = code;
3025         }
3026     }
3027
3028     for (ti = as->parms[0].items; ti; ti = ti->next) {  /* list of servers, ranks */
3029         if (ti) {
3030             if (!ti->next) {
3031                 break;
3032             }
3033             code = addServer(ti->data, (unsigned short)atol(ti->next->data));
3034             if (code)
3035                 error = code;
3036             if (debug)
3037                 printf("set fs prefs %s %s\n", ti->data, ti->next->data);
3038             ti = ti->next;
3039         }
3040     }
3041     code = pokeServers();
3042     if (code)
3043         error = code;
3044     if (debug)
3045         printf("now working on vlservers, code=%d\n", code);
3046
3047     ssp = (struct setspref *)space;
3048     ssp->flags = DBservers;
3049     ssp->num_servers = 0;
3050     gblob.in_size = ((char *)&(ssp->servers[0])) - (char *)ssp;
3051     gblob.in = space;
3052
3053     for (ti = as->parms[1].items; ti; ti = ti->next) {  /* list of dbservers, ranks */
3054         if (ti) {
3055             if (!ti->next) {
3056                 break;
3057             }
3058             code = addServer(ti->data, (unsigned short)atol(ti->next->data));
3059             if (code)
3060                 error = code;
3061             if (debug)
3062                 printf("set vl prefs %s %s\n", ti->data, ti->next->data);
3063             ti = ti->next;
3064         }
3065     }
3066
3067     if (as->parms[1].items) {
3068         if (debug)
3069             printf("now poking vlservers\n");
3070         code = pokeServers();
3071         if (code)
3072             error = code;
3073     }
3074
3075     if (error > 0)
3076         Die(error, 0);
3077
3078     return error ? 1 : 0;
3079 }
3080
3081
3082
3083 static int
3084 GetPrefCmd(struct cmd_syndesc *as, void *arock)
3085 {
3086     afs_int32 code;
3087     struct cmd_item *ti;
3088     char *name, tbuffer[20];
3089     afs_int32 rank, addr;
3090     FILE *outfd;
3091     int resolve;
3092     int vlservers = 0;
3093     struct ViceIoctl blob;
3094     struct sprefrequest *in;
3095     struct sprefinfo *out;
3096     int i;
3097
3098     ti = as->parms[0].items;    /* -file */
3099     if (ti) {
3100         if (debug)
3101             fprintf(stderr, "opening file %s\n", ti->data);
3102         if (!(outfd = freopen(ti->data, "w", stdout))) {
3103             perror(ti->data);
3104             return 1;
3105         }
3106     }
3107
3108     ti = as->parms[1].items;    /* -numeric */
3109     resolve = !(ti);
3110     ti = as->parms[2].items;    /* -vlservers */
3111     vlservers |= (ti ? DBservers : 0);
3112     /*  ti = as->parms[3].items;   -cell */
3113
3114     in = (struct sprefrequest *)space;
3115     in->offset = 0;
3116
3117     do {
3118         blob.in_size = sizeof(struct sprefrequest);
3119         blob.in = (char *)in;
3120         blob.out = space;
3121         blob.out_size = MAXSIZE;
3122
3123         in->num_servers =
3124             (MAXSIZE - 2 * sizeof(short)) / sizeof(struct spref);
3125         in->flags = vlservers;
3126
3127         code = pioctl(0, VIOC_GETSPREFS, &blob, 1);
3128         if (code) {
3129             perror("getserverprefs pioctl");
3130             return 1;
3131         }
3132
3133         out = (struct sprefinfo *)blob.out;
3134
3135         for (i = 0; i < out->num_servers; i++) {
3136             if (resolve) {
3137                 name = hostutil_GetNameByINet(out->servers[i].server.s_addr);
3138             } else {
3139                 addr = ntohl(out->servers[i].server.s_addr);
3140                 sprintf(tbuffer, "%d.%d.%d.%d", (addr >> 24) & 0xff,
3141                         (addr >> 16) & 0xff, (addr >> 8) & 0xff, addr & 0xff);
3142                 name = tbuffer;
3143             }
3144             printf("%-50s %5u\n", name, out->servers[i].rank);
3145         }
3146
3147         in->offset = out->next_offset;
3148     } while (out->next_offset > 0);
3149
3150     return 0;
3151 }
3152
3153 static int
3154 StoreBehindCmd(struct cmd_syndesc *as, void *arock)
3155 {
3156     afs_int32 code = 0;
3157     struct ViceIoctl blob;
3158     struct cmd_item *ti;
3159     struct sbstruct tsb, tsb2;
3160     int verbose = 0;
3161     afs_int32 allfiles;
3162     char *t;
3163     int error = 0;
3164
3165     tsb.sb_thisfile = -1;
3166     ti = as->parms[0].items;    /* -kbytes */
3167     if (ti) {
3168         if (!as->parms[1].items) {
3169             fprintf(stderr, "%s: you must specify -files with -kbytes.\n",
3170                     pn);
3171             return 1;
3172         }
3173         tsb.sb_thisfile = strtol(ti->data, &t, 10) * 1024;
3174         if ((tsb.sb_thisfile < 0) || (t != ti->data + strlen(ti->data))) {
3175             fprintf(stderr, "%s: %s must be 0 or a positive number.\n", pn,
3176                     ti->data);
3177             return 1;
3178         }
3179     }
3180
3181     allfiles = tsb.sb_default = -1;     /* Don't set allfiles yet */
3182     ti = as->parms[2].items;    /* -allfiles */
3183     if (ti) {
3184         allfiles = strtol(ti->data, &t, 10) * 1024;
3185         if ((allfiles < 0) || (t != ti->data + strlen(ti->data))) {
3186             fprintf(stderr, "%s: %s must be 0 or a positive number.\n", pn,
3187                     ti->data);
3188             return 1;
3189         }
3190     }
3191
3192     /* -verbose or -file only or no options */
3193     if (as->parms[3].items || (as->parms[1].items && !as->parms[0].items)
3194         || (!as->parms[0].items && !as->parms[1].items
3195             && !as->parms[2].items))
3196         verbose = 1;
3197
3198     blob.in = (char *)&tsb;
3199     blob.out = (char *)&tsb2;
3200     blob.in_size = blob.out_size = sizeof(struct sbstruct);
3201     memset(&tsb2, 0, sizeof(tsb2));
3202
3203     /* once per -file */
3204     for (ti = as->parms[1].items; ti; ti = ti->next) {
3205         /* Do this solely to see if the file is there */
3206         code = pioctl(ti->data, VIOCWHEREIS, &blob, 1);
3207         if (code) {
3208             Die(errno, ti->data);
3209             error = 1;
3210             continue;
3211         }
3212
3213         code = pioctl(ti->data, VIOC_STORBEHIND, &blob, 1);
3214         if (code) {
3215             Die(errno, ti->data);
3216             error = 1;
3217             continue;
3218         }
3219
3220         if (verbose && (blob.out_size == sizeof(tsb2))) {
3221             if (tsb2.sb_thisfile == -1) {
3222                 fprintf(stdout, "Will store %s according to default.\n",
3223                         ti->data);
3224             } else {
3225                 fprintf(stdout,
3226                         "Will store up to %d kbytes of %s asynchronously.\n",
3227                         (tsb2.sb_thisfile / 1024), ti->data);
3228             }
3229         }
3230     }
3231
3232     /* If no files - make at least one pioctl call, or
3233      * set the allfiles default if we need to.
3234      */
3235     if (!as->parms[1].items || (allfiles != -1)) {
3236         tsb.sb_default = allfiles;
3237         code = pioctl(0, VIOC_STORBEHIND, &blob, 1);
3238         if (code) {
3239             Die(errno, ((allfiles == -1) ? 0 : "-allfiles"));
3240             error = 1;
3241         }
3242     }
3243
3244     /* Having no arguments also reports the default store asynchrony */
3245     if (verbose && (blob.out_size == sizeof(tsb2))) {
3246         fprintf(stdout, "Default store asynchrony is %d kbytes.\n",
3247                 (tsb2.sb_default / 1024));
3248     }
3249
3250     return error;
3251 }
3252
3253
3254 static int
3255 SetCryptCmd(struct cmd_syndesc *as, void *arock)
3256 {
3257     afs_int32 code = 0, flag;
3258     struct ViceIoctl blob;
3259     char *tp;
3260
3261     tp = as->parms[0].items->data;
3262     if (strcmp(tp, "on") == 0)
3263         flag = 1;
3264     else if (strcmp(tp, "off") == 0)
3265         flag = 0;
3266     else {
3267         fprintf(stderr, "%s: %s must be \"on\" or \"off\".\n", pn, tp);
3268         return EINVAL;
3269     }
3270
3271     blob.in = (char *)&flag;
3272     blob.in_size = sizeof(flag);
3273     blob.out_size = 0;
3274     code = pioctl(0, VIOC_SETRXKCRYPT, &blob, 1);
3275     if (code)
3276         Die(errno, NULL);
3277     return 0;
3278 }
3279
3280
3281 static int
3282 GetCryptCmd(struct cmd_syndesc *as, void *arock)
3283 {
3284     afs_int32 code = 0, flag;
3285     struct ViceIoctl blob;
3286     char *tp;
3287
3288     blob.in = NULL;
3289     blob.in_size = 0;
3290     blob.out_size = sizeof(flag);
3291     blob.out = space;
3292
3293     code = pioctl(0, VIOC_GETRXKCRYPT, &blob, 1);
3294
3295     if (code)
3296         Die(errno, NULL);
3297     else {
3298         tp = space;
3299         memcpy(&flag, tp, sizeof(afs_int32));
3300         printf("Security level is currently ");
3301         if (flag == 1)
3302             printf("crypt (data security).\n");
3303         else
3304             printf("clear.\n");
3305     }
3306     return 0;
3307 }
3308
3309 #ifdef AFS_DISCON_ENV
3310 static char *modenames[] = {
3311     "readonly",
3312     "fetchonly", /* Not currently supported */
3313     "partial",   /* Not currently supported */
3314     "nat",
3315     "full",
3316     NULL
3317 };
3318
3319 static int
3320 DisconCmd(struct cmd_syndesc *as, void *arock)
3321 {
3322     struct cmd_item *ti;
3323     char *modename;
3324     int modelen;
3325     afs_int32 mode, code;
3326     struct ViceIoctl blob;
3327
3328     blob.in = NULL;
3329     blob.in_size = 0;
3330
3331     ti = as->parms[0].items;
3332     if (ti) {
3333         modename = ti->data;
3334         modelen = strlen(modename);
3335         for (mode = 0; modenames[mode] != NULL; mode++)
3336             if (!strncasecmp(modename, modenames[mode], modelen))
3337                 break;
3338         if (modenames[mode] == NULL)
3339             printf("Unknown discon mode \"%s\"\n", modename);
3340         else {
3341             memcpy(space, &mode, sizeof mode);
3342             blob.in = space;
3343             blob.in_size = sizeof mode;
3344         }
3345     }
3346
3347     blob.out_size = sizeof(mode);
3348     blob.out = space;
3349     code = pioctl(0, VIOC_DISCON, &blob, 1);
3350     if (code)
3351         Die(errno, NULL);
3352     else {
3353         memcpy(&mode, space, sizeof mode);
3354         if (mode < sizeof modenames / sizeof (char *))
3355             printf("Discon mode is now \"%s\"\n", modenames[mode]);
3356         else
3357             printf("Unknown discon mode %d\n", mode);
3358     }
3359
3360     return 0;
3361 }
3362 #endif
3363
3364 #include "AFS_component_version_number.c"
3365
3366 int
3367 main(int argc, char **argv)
3368 {
3369     afs_int32 code;
3370     struct cmd_syndesc *ts;
3371
3372 #ifdef  AFS_AIX32_ENV
3373     /*
3374      * The following signal action for AIX is necessary so that in case of a
3375      * crash (i.e. core is generated) we can include the user's data section
3376      * in the core dump. Unfortunately, by default, only a partial core is
3377      * generated which, in many cases, isn't too useful.
3378      */
3379     struct sigaction nsa;
3380
3381     sigemptyset(&nsa.sa_mask);
3382     nsa.sa_handler = SIG_DFL;
3383     nsa.sa_flags = SA_FULLDUMP;
3384     sigaction(SIGSEGV, &nsa, NULL);
3385 #endif
3386
3387     /* try to find volume location information */
3388     ts = cmd_CreateSyntax("getclientaddrs", GetClientAddrsCmd, NULL,
3389                           "get client network interface addresses");
3390     cmd_CreateAlias(ts, "gc");
3391
3392     ts = cmd_CreateSyntax("setclientaddrs", SetClientAddrsCmd, NULL,
3393                           "set client network interface addresses");
3394     cmd_AddParm(ts, "-address", CMD_LIST, CMD_OPTIONAL | CMD_EXPANDS,
3395                 "client network interfaces");
3396     cmd_CreateAlias(ts, "sc");
3397
3398     ts = cmd_CreateSyntax("setserverprefs", SetPrefCmd, NULL,
3399                           "set server ranks");
3400     cmd_AddParm(ts, "-servers", CMD_LIST, CMD_OPTIONAL | CMD_EXPANDS,
3401                 "fileserver names and ranks");
3402     cmd_AddParm(ts, "-vlservers", CMD_LIST, CMD_OPTIONAL | CMD_EXPANDS,
3403                 "VL server names and ranks");
3404     cmd_AddParm(ts, "-file", CMD_SINGLE, CMD_OPTIONAL,
3405                 "input from named file");
3406     cmd_AddParm(ts, "-stdin", CMD_FLAG, CMD_OPTIONAL, "input from stdin");
3407     cmd_CreateAlias(ts, "sp");
3408
3409     ts = cmd_CreateSyntax("getserverprefs", GetPrefCmd, NULL,
3410                           "get server ranks");
3411     cmd_AddParm(ts, "-file", CMD_SINGLE, CMD_OPTIONAL,
3412                 "output to named file");
3413     cmd_AddParm(ts, "-numeric", CMD_FLAG, CMD_OPTIONAL, "addresses only");
3414     cmd_AddParm(ts, "-vlservers", CMD_FLAG, CMD_OPTIONAL, "VL servers");
3415 /*    cmd_AddParm(ts, "-cell", CMD_FLAG, CMD_OPTIONAL, "cellname"); */
3416     cmd_CreateAlias(ts, "gp");
3417
3418     ts = cmd_CreateSyntax("setacl", SetACLCmd, NULL, "set access control list");
3419     cmd_AddParm(ts, "-dir", CMD_LIST, 0, "directory");
3420     cmd_AddParm(ts, "-acl", CMD_LIST, 0, "access list entries");
3421     cmd_AddParm(ts, "-clear", CMD_FLAG, CMD_OPTIONAL, "clear access list");
3422     cmd_AddParm(ts, "-negative", CMD_FLAG, CMD_OPTIONAL,
3423                 "apply to negative rights");
3424     parm_setacl_id = ts->nParms;
3425     cmd_AddParm(ts, "-id", CMD_FLAG, CMD_OPTIONAL,
3426                 "initial directory acl (DFS only)");
3427     cmd_AddParm(ts, "-if", CMD_FLAG, CMD_OPTIONAL,
3428                 "initial file acl (DFS only)");
3429     cmd_CreateAlias(ts, "sa");
3430
3431     ts = cmd_CreateSyntax("listacl", ListACLCmd, NULL,
3432                           "list access control list");
3433     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3434     parm_listacl_id = ts->nParms;
3435     cmd_AddParm(ts, "-id", CMD_FLAG, CMD_OPTIONAL, "initial directory acl");
3436     cmd_AddParm(ts, "-if", CMD_FLAG, CMD_OPTIONAL, "initial file acl");
3437     cmd_CreateAlias(ts, "la");
3438
3439     ts = cmd_CreateSyntax("getcalleraccess", GetCallerAccess, NULL,
3440             "list callers access");
3441     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3442     cmd_CreateAlias(ts, "gca");
3443
3444     ts = cmd_CreateSyntax("cleanacl", CleanACLCmd, NULL,
3445                           "clean up access control list");
3446     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3447
3448     ts = cmd_CreateSyntax("copyacl", CopyACLCmd, NULL,
3449                           "copy access control list");
3450     cmd_AddParm(ts, "-fromdir", CMD_SINGLE, 0,
3451                 "source directory (or DFS file)");
3452     cmd_AddParm(ts, "-todir", CMD_LIST, 0,
3453                 "destination directory (or DFS file)");
3454     cmd_AddParm(ts, "-clear", CMD_FLAG, CMD_OPTIONAL,
3455                 "first clear dest access list");
3456     parm_copyacl_id = ts->nParms;
3457     cmd_AddParm(ts, "-id", CMD_FLAG, CMD_OPTIONAL, "initial directory acl");
3458     cmd_AddParm(ts, "-if", CMD_FLAG, CMD_OPTIONAL, "initial file acl");
3459
3460     cmd_CreateAlias(ts, "ca");
3461
3462     ts = cmd_CreateSyntax("flush", FlushCmd, NULL, "flush file from cache");
3463     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3464     ts = cmd_CreateSyntax("flushmount", FlushMountCmd, NULL,
3465                           "flush mount symlink from cache");
3466     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3467
3468     ts = cmd_CreateSyntax("setvol", SetVolCmd, NULL, "set volume status");
3469     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3470     cmd_AddParm(ts, "-max", CMD_SINGLE, CMD_OPTIONAL,
3471                 "disk space quota in 1K units");
3472 #ifdef notdef
3473     cmd_AddParm(ts, "-min", CMD_SINGLE, CMD_OPTIONAL,
3474                 "disk space guaranteed");
3475     cmd_AddParm(ts, "-motd", CMD_SINGLE, CMD_OPTIONAL, "message of the day");
3476 #endif
3477     cmd_AddParm(ts, "-offlinemsg", CMD_SINGLE, CMD_OPTIONAL,
3478                 "offline message");
3479     cmd_CreateAlias(ts, "sv");
3480
3481     ts = cmd_CreateSyntax("messages", MessagesCmd, NULL,
3482                           "control Cache Manager messages");
3483     cmd_AddParm(ts, "-show", CMD_SINGLE, CMD_OPTIONAL,
3484                 "[user|console|all|none]");
3485
3486     ts = cmd_CreateSyntax("examine", ExamineCmd, NULL, "display file/volume status");
3487     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3488     cmd_CreateAlias(ts, "lv");
3489     cmd_CreateAlias(ts, "listvol");
3490
3491     ts = cmd_CreateSyntax("listquota", ListQuotaCmd, NULL, "list volume quota");
3492     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3493     cmd_CreateAlias(ts, "lq");
3494
3495     ts = cmd_CreateSyntax("diskfree", DiskFreeCmd, NULL,
3496                           "show server disk space usage");
3497     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3498     cmd_CreateAlias(ts, "df");
3499
3500     ts = cmd_CreateSyntax("quota", QuotaCmd, NULL, "show volume quota usage");
3501     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3502
3503     ts = cmd_CreateSyntax("lsmount", ListMountCmd, NULL, "list mount point");
3504     cmd_AddParm(ts, "-dir", CMD_LIST, 0, "directory");
3505
3506     ts = cmd_CreateSyntax("mkmount", MakeMountCmd, NULL, "make mount point");
3507     cmd_AddParm(ts, "-dir", CMD_SINGLE, 0, "directory");
3508     cmd_AddParm(ts, "-vol", CMD_SINGLE, 0, "volume name");
3509     cmd_AddParm(ts, "-cell", CMD_SINGLE, CMD_OPTIONAL, "cell name");
3510     cmd_AddParm(ts, "-rw", CMD_FLAG, CMD_OPTIONAL, "force r/w volume");
3511     cmd_AddParm(ts, "-fast", CMD_FLAG, CMD_OPTIONAL,
3512                 "don't check name with VLDB");
3513
3514 /*
3515
3516 defect 3069
3517
3518     cmd_AddParm(ts, "-root", CMD_FLAG, CMD_OPTIONAL, "create cellular mount point");
3519 */
3520
3521
3522     ts = cmd_CreateSyntax("rmmount", RemoveMountCmd, NULL, "remove mount point");
3523     cmd_AddParm(ts, "-dir", CMD_LIST, 0, "directory");
3524
3525     ts = cmd_CreateSyntax("checkservers", CheckServersCmd, NULL,
3526                           "check local cell's servers");
3527     cmd_AddParm(ts, "-cell", CMD_SINGLE, CMD_OPTIONAL, "cell to check");
3528     cmd_AddParm(ts, "-all", CMD_FLAG, CMD_OPTIONAL, "check all cells");
3529     cmd_AddParm(ts, "-fast", CMD_FLAG, CMD_OPTIONAL,
3530                 "just list, don't check");
3531     cmd_AddParm(ts, "-interval", CMD_SINGLE, CMD_OPTIONAL,
3532                 "seconds between probes");
3533
3534     ts = cmd_CreateSyntax("checkvolumes", CheckVolumesCmd, NULL,
3535                           "check volumeID/name mappings");
3536     cmd_CreateAlias(ts, "checkbackups");
3537
3538
3539     ts = cmd_CreateSyntax("setcachesize", SetCacheSizeCmd, NULL,
3540                           "set cache size");
3541     cmd_AddParm(ts, "-blocks", CMD_SINGLE, CMD_OPTIONAL,
3542                 "size in 1K byte blocks (0 => reset)");
3543     cmd_CreateAlias(ts, "cachesize");
3544
3545     cmd_AddParm(ts, "-reset", CMD_FLAG, CMD_OPTIONAL,
3546                 "reset size back to boot value");
3547
3548     ts = cmd_CreateSyntax("getcacheparms", GetCacheParmsCmd, NULL,
3549                           "get cache usage info");
3550     cmd_AddParm(ts, "-files", CMD_FLAG, CMD_OPTIONAL, "Show cach files used as well");
3551     cmd_AddParm(ts, "-excessive", CMD_FLAG, CMD_OPTIONAL, "excessively verbose cache stats");
3552
3553     ts = cmd_CreateSyntax("listcells", ListCellsCmd, NULL,
3554                           "list configured cells");
3555     cmd_AddParm(ts, "-numeric", CMD_FLAG, CMD_OPTIONAL, "addresses only");
3556
3557     ts = cmd_CreateSyntax("listaliases", ListAliasesCmd, NULL,
3558                           "list configured cell aliases");
3559
3560     ts = cmd_CreateSyntax("setquota", SetQuotaCmd, NULL, "set volume quota");
3561     cmd_AddParm(ts, "-path", CMD_SINGLE, CMD_OPTIONAL, "dir/file path");
3562     cmd_AddParm(ts, "-max", CMD_SINGLE, 0, "max quota in kbytes");
3563 #ifdef notdef
3564     cmd_AddParm(ts, "-min", CMD_SINGLE, CMD_OPTIONAL, "min quota in kbytes");
3565 #endif
3566     cmd_CreateAlias(ts, "sq");
3567
3568     ts = cmd_CreateSyntax("newcell", NewCellCmd, NULL, "configure new cell");
3569     cmd_AddParm(ts, "-name", CMD_SINGLE, 0, "cell name");
3570     cmd_AddParm(ts, "-servers", CMD_LIST, CMD_REQUIRED, "primary servers");
3571     cmd_AddParm(ts, "-linkedcell", CMD_SINGLE, CMD_OPTIONAL,
3572                 "linked cell name");
3573
3574     ts = cmd_CreateSyntax("newalias", NewAliasCmd, NULL,
3575                           "configure new cell alias");
3576     cmd_AddParm(ts, "-alias", CMD_SINGLE, 0, "alias name");
3577     cmd_AddParm(ts, "-name", CMD_SINGLE, 0, "real name of cell");
3578
3579 #ifdef FS_ENABLE_SERVER_DEBUG_PORTS
3580 /*
3581  * Turn this on only if you wish to be able to talk to a server which is listening
3582  * on alternative ports. This is not intended for general use and may not be
3583  * supported in the cache manager. It is not a way to run two servers at the
3584  * same host, since the cache manager cannot properly distinguish those two hosts.
3585  */
3586     cmd_AddParm(ts, "-fsport", CMD_SINGLE, CMD_OPTIONAL,
3587                 "cell's fileserver port");
3588     cmd_AddParm(ts, "-vlport", CMD_SINGLE, CMD_OPTIONAL,
3589                 "cell's vldb server port");
3590 #endif
3591
3592     ts = cmd_CreateSyntax("whichcell", WhichCellCmd, NULL, "list file's cell");
3593     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3594
3595     ts = cmd_CreateSyntax("whereis", WhereIsCmd, NULL, "list file's location");
3596     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3597
3598     ts = cmd_CreateSyntax("wscell", WSCellCmd, NULL, "list workstation's cell");
3599
3600 /*
3601     ts = cmd_CreateSyntax("primarycell", PrimaryCellCmd, NULL, "obsolete (listed primary cell)");
3602 */
3603
3604     /* set cache monitor host address */
3605     ts = cmd_CreateSyntax("monitor", MonitorCmd, NULL, (char *)CMD_HIDDEN);
3606     cmd_AddParm(ts, "-server", CMD_SINGLE, CMD_OPTIONAL,
3607                 "host name or 'off'");
3608     cmd_CreateAlias(ts, "mariner");
3609
3610     ts = cmd_CreateSyntax("getcellstatus", GetCellCmd, NULL, "get cell status");
3611     cmd_AddParm(ts, "-cell", CMD_LIST, 0, "cell name");
3612
3613     ts = cmd_CreateSyntax("setcell", SetCellCmd, NULL, "set cell status");
3614     cmd_AddParm(ts, "-cell", CMD_LIST, 0, "cell name");
3615     cmd_AddParm(ts, "-suid", CMD_FLAG, CMD_OPTIONAL, "allow setuid programs");
3616     cmd_AddParm(ts, "-nosuid", CMD_FLAG, CMD_OPTIONAL,
3617                 "disallow setuid programs");
3618
3619     ts = cmd_CreateSyntax("flushvolume", FlushVolumeCmd, NULL,
3620                           "flush all data in volume");
3621     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3622
3623     ts = cmd_CreateSyntax("sysname", SysNameCmd, NULL,
3624                           "get/set sysname (i.e. @sys) value");
3625     cmd_AddParm(ts, "-newsys", CMD_LIST, CMD_OPTIONAL, "new sysname");
3626
3627     ts = cmd_CreateSyntax("exportafs", ExportAfsCmd, NULL,
3628                           "enable/disable translators to AFS");
3629     cmd_AddParm(ts, "-type", CMD_SINGLE, 0, "exporter name");
3630     cmd_AddParm(ts, "-start", CMD_SINGLE, CMD_OPTIONAL,
3631                 "start/stop translator (on | off)");
3632     cmd_AddParm(ts, "-convert", CMD_SINGLE, CMD_OPTIONAL,
3633                 "convert from afs to unix mode (on | off)");
3634     cmd_AddParm(ts, "-uidcheck", CMD_SINGLE, CMD_OPTIONAL,
3635                 "run on strict 'uid check' mode (on | off)");
3636     cmd_AddParm(ts, "-submounts", CMD_SINGLE, CMD_OPTIONAL,
3637                 "allow nfs mounts to subdirs of /afs/.. (on  | off)");
3638     cmd_AddParm(ts, "-clipags", CMD_SINGLE, CMD_OPTIONAL,
3639                 "enable use of client-assigned PAG's (on  | off)");
3640     cmd_AddParm(ts, "-pagcb", CMD_SINGLE, CMD_OPTIONAL,
3641                 "enable callbacks to get creds from new clients (on  | off)");
3642
3643
3644     ts = cmd_CreateSyntax("storebehind", StoreBehindCmd, NULL,
3645                           "store to server after file close");
3646     cmd_AddParm(ts, "-kbytes", CMD_SINGLE, CMD_OPTIONAL,
3647                 "asynchrony for specified names");
3648     cmd_AddParm(ts, "-files", CMD_LIST, CMD_OPTIONAL, "specific pathnames");
3649     cmd_AddParm(ts, "-allfiles", CMD_SINGLE, CMD_OPTIONAL,
3650                 "new default (KB)");
3651     cmd_AddParm(ts, "-verbose", CMD_FLAG, CMD_OPTIONAL, "show status");
3652     cmd_CreateAlias(ts, "sb");
3653
3654     ts = cmd_CreateSyntax("setcrypt", SetCryptCmd, NULL,
3655                           "set cache manager encryption flag");
3656     cmd_AddParm(ts, "-crypt", CMD_SINGLE, 0, "on or off");
3657
3658     ts = cmd_CreateSyntax("getcrypt", GetCryptCmd, NULL,
3659                           "get cache manager encryption flag");
3660
3661     ts = cmd_CreateSyntax("rxstatproc", RxStatProcCmd, NULL,
3662                           "Manage per process RX statistics");
3663     cmd_AddParm(ts, "-enable", CMD_FLAG, CMD_OPTIONAL, "Enable RX stats");
3664     cmd_AddParm(ts, "-disable", CMD_FLAG, CMD_OPTIONAL, "Disable RX stats");
3665     cmd_AddParm(ts, "-clear", CMD_FLAG, CMD_OPTIONAL, "Clear RX stats");
3666
3667     ts = cmd_CreateSyntax("rxstatpeer", RxStatPeerCmd, NULL,
3668                           "Manage per peer RX statistics");
3669     cmd_AddParm(ts, "-enable", CMD_FLAG, CMD_OPTIONAL, "Enable RX stats");
3670     cmd_AddParm(ts, "-disable", CMD_FLAG, CMD_OPTIONAL, "Disable RX stats");
3671     cmd_AddParm(ts, "-clear", CMD_FLAG, CMD_OPTIONAL, "Clear RX stats");
3672
3673     ts = cmd_CreateSyntax("setcbaddr", CallBackRxConnCmd, NULL, "configure callback connection address");
3674     cmd_AddParm(ts, "-addr", CMD_SINGLE, CMD_OPTIONAL, "host name or address");
3675
3676     /* try to find volume location information */
3677     ts = cmd_CreateSyntax("getfid", GetFidCmd, NULL,
3678                           "get fid for file(s)");
3679     cmd_AddParm(ts, "-path", CMD_LIST, CMD_OPTIONAL, "dir/file path");
3680
3681 #ifdef AFS_DISCON_ENV
3682     ts = cmd_CreateSyntax("discon", DisconCmd, NULL,
3683                           "disconnection mode");
3684     cmd_AddParm(ts, "-mode", CMD_SINGLE, CMD_OPTIONAL, "readonly | nat | full");
3685 #endif
3686
3687     ts = cmd_CreateSyntax("nukenfscreds", NukeNFSCredsCmd, NULL, "nuke credentials for NFS client");
3688     cmd_AddParm(ts, "-addr", CMD_SINGLE, 0, "host name or address");
3689
3690     ts = cmd_CreateSyntax("uuid", UuidCmd, NULL, "manage the UUID for the cache manager");
3691     cmd_AddParm(ts, "-generate", CMD_FLAG, CMD_REQUIRED, "generate a new UUID");
3692
3693     ts = cmd_CreateSyntax("precache", PreCacheCmd, 0,
3694                           "set precache size");
3695     cmd_AddParm(ts, "-blocks", CMD_SINGLE, CMD_OPTIONAL,
3696                 "size in 1K byte blocks (0 => disable)");
3697
3698     code = cmd_Dispatch(argc, argv);
3699     if (rxInitDone)
3700         rx_Finalize();
3701
3702     return code;
3703 }
3704
3705 static void
3706 Die(int errnum, char *filename)
3707 {
3708     switch (errnum) {
3709     case EINVAL:
3710         if (filename)
3711             fprintf(stderr,
3712                     "%s: Invalid argument; it is possible that %s is not in AFS.\n",
3713                     pn, filename);
3714         else
3715             fprintf(stderr, "%s: Invalid argument.\n", pn);
3716         break;
3717     case ENOENT:
3718         if (filename)
3719             fprintf(stderr, "%s: File '%s' doesn't exist\n", pn, filename);
3720         else
3721             fprintf(stderr, "%s: no such file returned\n", pn);
3722         break;
3723     case EROFS:
3724         fprintf(stderr,
3725                 "%s: You can not change a backup or readonly volume\n", pn);
3726         break;
3727     case EACCES:
3728     case EPERM:
3729         if (filename)
3730             fprintf(stderr,
3731                     "%s: You don't have the required access rights on '%s'\n",
3732                     pn, filename);
3733         else
3734             fprintf(stderr,
3735                     "%s: You do not have the required rights to do this operation\n",
3736                     pn);
3737         break;
3738     default:
3739         if (filename)
3740             fprintf(stderr, "%s:'%s'", pn, filename);
3741         else
3742             fprintf(stderr, "%s", pn);
3743         fprintf(stderr, ": %s\n", afs_error_message(errnum));
3744         break;
3745     }
3746 }
3747
3748 /* get clients interface addresses */
3749 static int
3750 GetClientAddrsCmd(struct cmd_syndesc *as, void *arock)
3751 {
3752     afs_int32 code;
3753     struct cmd_item *ti;
3754     char *name;
3755     struct ViceIoctl blob;
3756     struct sprefrequest *in;
3757     struct sprefinfo *out;
3758
3759     in = (struct sprefrequest *)space;
3760     in->offset = 0;
3761
3762     do {
3763         blob.in_size = sizeof(struct sprefrequest);
3764         blob.in = (char *)in;
3765         blob.out = space;
3766         blob.out_size = MAXSIZE;
3767
3768         in->num_servers =
3769             (MAXSIZE - 2 * sizeof(short)) / sizeof(struct spref);
3770         /* returns addr in network byte order */
3771         code = pioctl(0, VIOC_GETCPREFS, &blob, 1);
3772         if (code) {
3773             perror("getClientInterfaceAddr pioctl");
3774             return 1;
3775         }
3776
3777         {
3778             int i;
3779             out = (struct sprefinfo *)blob.out;
3780             for (i = 0; i < out->num_servers; i++) {
3781                 afs_int32 addr;
3782                 char tbuffer[32];
3783                 addr = ntohl(out->servers[i].server.s_addr);
3784                 sprintf(tbuffer, "%d.%d.%d.%d", (addr >> 24) & 0xff,
3785                         (addr >> 16) & 0xff, (addr >> 8) & 0xff, addr & 0xff);
3786                 printf("%-50s\n", tbuffer);
3787             }
3788             in->offset = out->next_offset;
3789         }
3790     } while (out->next_offset > 0);
3791
3792     return 0;
3793 }
3794
3795 static int
3796 SetClientAddrsCmd(struct cmd_syndesc *as, void *arock)
3797 {
3798     afs_int32 code, addr;
3799     struct cmd_item *ti;
3800     char name[80];
3801     struct ViceIoctl blob;
3802     struct setspref *ssp;
3803     int sizeUsed = 0, i, flag;
3804     afs_int32 existingAddr[1024];       /* existing addresses on this host */
3805     int existNu;
3806     int error = 0;
3807
3808     ssp = (struct setspref *)space;
3809     ssp->num_servers = 0;
3810     blob.in = space;
3811     blob.out = space;
3812     blob.out_size = MAXSIZE;
3813
3814     if (geteuid()) {
3815         fprintf(stderr, "Permission denied: requires root access.\n");
3816         return 1;
3817     }
3818
3819     /* extract all existing interface addresses */
3820     existNu = rx_getAllAddr(existingAddr, 1024);
3821     if (existNu < 0)
3822         return 1;
3823
3824     sizeUsed = sizeof(struct setspref); /* space used in ioctl buffer */
3825     for (ti = as->parms[0].items; ti; ti = ti->next) {
3826         if (sizeUsed >= sizeof(space)) {
3827             fprintf(stderr, "No more space\n");
3828             return 1;
3829         }
3830         addr = extractAddr(ti->data, 20);       /* network order */
3831         if ((addr == AFS_IPINVALID) || (addr == AFS_IPINVALIDIGNORE)) {
3832             fprintf(stderr, "Error in specifying address: %s..ignoring\n",
3833                     ti->data);
3834             error = 1;
3835             continue;
3836         }
3837         /* see if it is an address that really exists */
3838         for (flag = 0, i = 0; i < existNu; i++)
3839             if (existingAddr[i] == addr) {
3840                 flag = 1;
3841                 break;
3842             }
3843         if (!flag) {            /* this is an nonexistent address */
3844             fprintf(stderr, "Nonexistent address: 0x%08x..ignoring\n", addr);
3845             error = 1;
3846             continue;
3847         }
3848         /* copy all specified addr into ioctl buffer */
3849         (ssp->servers[ssp->num_servers]).server.s_addr = addr;
3850         printf("Adding 0x%08x\n", addr);
3851         ssp->num_servers++;
3852         sizeUsed += sizeof(struct spref);
3853     }
3854     if (ssp->num_servers < 1) {
3855         fprintf(stderr, "No addresses specified\n");
3856         return 1;
3857     }
3858     blob.in_size = sizeUsed - sizeof(struct spref);
3859
3860     code = pioctl(0, VIOC_SETCPREFS, &blob, 1); /* network order */
3861     if (code) {
3862         Die(errno, 0);
3863         error = 1;
3864     }
3865
3866     return error;
3867 }
3868
3869 static int
3870 FlushMountCmd(struct cmd_syndesc *as, void *arock)
3871 {
3872     afs_int32 code;
3873     struct ViceIoctl blob;
3874     struct cmd_item *ti;
3875     char orig_name[1024];       /*Original name, may be modified */
3876     char true_name[1024];       /*``True'' dirname (e.g., symlink target) */
3877     char parent_dir[1024];      /*Parent directory of true name */
3878     char *last_component;       /*Last component of true name */
3879     struct stat statbuff;       /*Buffer for status info */
3880     int link_chars_read;        /*Num chars read in readlink() */
3881     int thru_symlink;           /*Did we get to a mount point via a symlink? */
3882     int error = 0;
3883
3884     for (ti = as->parms[0].items; ti; ti = ti->next) {
3885         /* once per file */
3886         thru_symlink = 0;
3887         sprintf(orig_name, "%s%s", (ti->data[0] == '/') ? "" : "./",
3888                 ti->data);
3889
3890         if (lstat(orig_name, &statbuff) < 0) {
3891             /* if lstat fails, we should still try the pioctl, since it
3892              * may work (for example, lstat will fail, but pioctl will
3893              * work if the volume of offline (returning ENODEV). */
3894             statbuff.st_mode = S_IFDIR; /* lie like pros */
3895         }
3896
3897         /*
3898          * The lstat succeeded.  If the given file is a symlink, substitute
3899          * the file name with the link name.
3900          */
3901         if ((statbuff.st_mode & S_IFMT) == S_IFLNK) {
3902             thru_symlink = 1;
3903             /*
3904              * Read name of resolved file.
3905              */
3906             link_chars_read = readlink(orig_name, true_name, 1024);
3907             if (link_chars_read <= 0) {
3908                 fprintf(stderr,
3909                         "%s: Can't read target name for '%s' symbolic link!\n",
3910                         pn, orig_name);
3911                 error = 1;
3912                 continue;
3913             }
3914
3915             /*
3916              * Add a trailing null to what was read, bump the length.
3917              */
3918             true_name[link_chars_read++] = 0;
3919
3920             /*
3921              * If the symlink is an absolute pathname, we're fine.  Otherwise, we
3922              * have to create a full pathname using the original name and the
3923              * relative symlink name.  Find the rightmost slash in the original
3924              * name (we know there is one) and splice in the symlink value.
3925              */
3926             if (true_name[0] != '/') {
3927                 last_component = (char *)strrchr(orig_name, '/');
3928                 strcpy(++last_component, true_name);
3929                 strcpy(true_name, orig_name);
3930             }
3931         } else
3932             strcpy(true_name, orig_name);
3933
3934         /*
3935          * Find rightmost slash, if any.
3936          */
3937         last_component = (char *)strrchr(true_name, '/');
3938         if (last_component) {
3939             /*
3940              * Found it.  Designate everything before it as the parent directory,
3941              * everything after it as the final component.
3942              */
3943             strncpy(parent_dir, true_name, last_component - true_name);
3944             parent_dir[last_component - true_name] = 0;
3945             last_component++;   /*Skip the slash */
3946         } else {
3947             /*
3948              * No slash appears in the given file name.  Set parent_dir to the current
3949              * directory, and the last component as the given name.
3950              */
3951             strcpy(parent_dir, ".");
3952             last_component = true_name;
3953         }
3954
3955         if (strcmp(last_component, ".") == 0
3956             || strcmp(last_component, "..") == 0) {
3957             fprintf(stderr,
3958                     "%s: you may not use '.' or '..' as the last component\n",
3959                     pn);
3960             fprintf(stderr, "%s: of a name in the 'fs flushmount' command.\n",
3961                     pn);
3962             error = 1;
3963             continue;
3964         }
3965
3966         blob.in = last_component;
3967         blob.in_size = strlen(last_component) + 1;
3968         blob.out_size = 0;
3969         memset(space, 0, MAXSIZE);
3970
3971         code = pioctl(parent_dir, VIOC_AFS_FLUSHMOUNT, &blob, 1);
3972
3973         if (code != 0) {
3974             if (errno == EINVAL) {
3975                 fprintf(stderr, "'%s' is not a mount point.\n", ti->data);
3976             } else {
3977                 Die(errno, (ti->data ? ti->data : parent_dir));
3978             }
3979             error = 1;
3980         }
3981     }
3982     return error;
3983 }
3984
3985 static int
3986 RxStatProcCmd(struct cmd_syndesc *as, void *arock)
3987 {
3988     afs_int32 code;
3989     afs_int32 flags = 0;
3990     struct ViceIoctl blob;
3991     struct cmd_item *ti;
3992
3993     if (as->parms[0].items) {   /* -enable */
3994         flags |= AFSCALL_RXSTATS_ENABLE;
3995     }
3996     if (as->parms[1].items) {   /* -disable */
3997         flags |= AFSCALL_RXSTATS_DISABLE;
3998     }
3999     if (as->parms[2].items) {   /* -clear */
4000         flags |= AFSCALL_RXSTATS_CLEAR;
4001     }
4002     if (flags == 0) {
4003         fprintf(stderr, "You must specify at least one argument\n");
4004         return 1;
4005     }
4006
4007     blob.in = (char *)&flags;
4008     blob.in_size = sizeof(afs_int32);
4009     blob.out_size = 0;
4010
4011     code = pioctl(NULL, VIOC_RXSTAT_PROC, &blob, 1);
4012     if (code != 0) {
4013         Die(errno, NULL);
4014         return 1;
4015     }
4016
4017     return 0;
4018 }
4019
4020 static int
4021 RxStatPeerCmd(struct cmd_syndesc *as, void *arock)
4022 {
4023     afs_int32 code;
4024     afs_int32 flags = 0;
4025     struct ViceIoctl blob;
4026     struct cmd_item *ti;
4027
4028     if (as->parms[0].items) {   /* -enable */
4029         flags |= AFSCALL_RXSTATS_ENABLE;
4030     }
4031     if (as->parms[1].items) {   /* -disable */
4032         flags |= AFSCALL_RXSTATS_DISABLE;
4033     }
4034     if (as->parms[2].items) {   /* -clear */
4035         flags |= AFSCALL_RXSTATS_CLEAR;
4036     }
4037     if (flags == 0) {
4038         fprintf(stderr, "You must specify at least one argument\n");
4039         return 1;
4040     }
4041
4042     blob.in = (char *)&flags;
4043     blob.in_size = sizeof(afs_int32);
4044     blob.out_size = 0;
4045
4046     code = pioctl(NULL, VIOC_RXSTAT_PEER, &blob, 1);
4047     if (code != 0) {
4048         Die(errno, NULL);
4049         return 1;
4050     }
4051
4052     return 0;
4053 }
4054
4055 static int
4056 GetFidCmd(struct cmd_syndesc *as, void *arock)
4057 {
4058     struct ViceIoctl blob;
4059     struct cmd_item *ti;
4060     for (ti = as->parms[0].items; ti; ti = ti->next) {
4061       struct VenusFid vfid;
4062       
4063       blob.out_size = sizeof(struct VenusFid);
4064       blob.out = (char *) &vfid;
4065       blob.in_size = 0;
4066       
4067       if (0 == pioctl(ti->data, VIOCGETFID, &blob, 1)) {
4068         printf("File %s (%u.%u.%u) contained in volume %u\n",
4069                ti->data, vfid.Fid.Volume, vfid.Fid.Vnode, vfid.Fid.Unique,
4070                vfid.Fid.Volume);
4071       }
4072     }
4073
4074     return 0;
4075 }
4076