vol: Use FDH_SIZE more consistently
[openafs.git] / src / vol / vol-salvage.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 /*
11  *      System:         VICE-TWO
12  *      Module:         vol-salvage.c
13  *      Institution:    The Information Technology Center, Carnegie-Mellon University
14  */
15
16 /*  1.2 features:
17         Correct handling of bad "." and ".." entries.
18         Message if volume has "destroyMe" flag set--but doesn't delete yet.
19         Link count bug fixed--bug was that vnodeEssence link count was unsigned
20         14 bits.  Needs to be signed.
21
22     1.3 features:
23         Change to DirHandle stuff to make sure that cache entries are reused at the
24         right time (this parallels the file server change, but is not identical).
25
26         Added calls to directory salvager routines; doesn't salvage dir unless debug=1.
27
28     1.4 features:
29         Fixed bug which was causing inode link counts to go bad (thus leaking
30         disk blocks).
31 Vnodes with 0 inode pointers in RW volumes are now deleted.
32         An inode with a matching inode number to the vnode is preferred to an
33         inode with a higer data version.
34         Bug is probably fixed that was causing data version to remain wrong,
35         despite assurances from the salvager to the contrary.
36
37     1.5 features:
38         Added limited salvaging:  unless ForceSalvage is on, then the volume will
39         not be salvaged if the dontSalvage flag is set in the Volume Header.
40         The ForceSalvage flag is turned on if an individual volume is salvaged or
41         if the file FORCESALVAGE exists in the partition header of the file system
42         being salvaged.  This isn't used for anything but could be set by vfsck.
43         A -f flag was also added to force salvage.
44
45     1.6 features:
46         It now deletes obsolete volume inodes without complaining
47
48     1.7 features:
49         Repairs rw volume headers (again).
50
51     1.8 features:
52         Correlates volume headers & inodes correctly, thus preventing occasional deletion
53         of read-only volumes...
54         No longer forces a directory salvage for volume 144 (which may be a good volume
55         at some other site!)
56         Some of the messages are cleaned up or made more explicit.  One or two added.
57         Logging cleaned up.
58         A bug was fixed which forced salvage of read-only volumes without a corresponding
59         read/write volume.
60
61     1.9 features:
62         When a volume header is recreated, the new name will be "bogus.volume#"
63
64     2.0 features:
65         Directory salvaging turned on!!!
66
67     2.1 features:
68         Prints warning messages for setuid programs.
69
70     2.2 features:
71         Logs missing inode numbers.
72
73     2.3 features:
74             Increments directory version number by 200 (rather than by 1) when it is salvaged, in order to prevent problems due to the fact that a version number can be promised to a workstation before it is written to disk.  If the server crashes, it may have an older version.  Salvaging it could bring the version number up to the same version the workstation believed it already had a call back on.
75
76     2.4 features:
77             Locks the file /vice/vol/salvage.lock before starting.  Aborts if it can't acquire the lock.
78             Time stamps on log entries.
79             Fcntl on stdout to cause all entries to be appended.
80             Problems writing to temporary files are now all detected.
81             Inode summary files are now dynamically named (so that multiple salvagers wouldn't conflict).
82             Some cleanup of error messages.
83 */
84
85
86 #include <afsconfig.h>
87 #include <afs/param.h>
88
89 #include <afs/procmgmt.h>
90 #include <roken.h>
91
92 #ifdef HAVE_SYS_FILE_H
93 # include <sys/file.h>
94 #endif
95
96 #ifdef AFS_NT40_ENV
97 #include <WINNT/afsevent.h>
98 #endif
99 #ifndef WCOREDUMP
100 #define WCOREDUMP(x)    ((x) & 0200)
101 #endif
102 #include <afs/opr.h>
103 #ifdef AFS_PTHREAD_ENV
104 # include <opr/lock.h>
105 #endif
106
107 #include <afs/afsint.h>
108 #if !defined(AFS_SGI_ENV) && !defined(AFS_NT40_ENV)
109 #if defined(AFS_VFSINCL_ENV)
110 #include <sys/vnode.h>
111 #ifdef  AFS_SUN5_ENV
112 #include <sys/fs/ufs_inode.h>
113 #else
114 #if defined(AFS_DARWIN_ENV) || defined(AFS_XBSD_ENV)
115 #include <ufs/ufs/dinode.h>
116 #include <ufs/ffs/fs.h>
117 #else
118 #include <ufs/inode.h>
119 #endif
120 #endif
121 #else /* AFS_VFSINCL_ENV */
122 #if !defined(AFS_LINUX20_ENV) && !defined(AFS_XBSD_ENV) && !defined(AFS_DARWIN_ENV)
123 #include <sys/inode.h>
124 #endif
125 #endif /* AFS_VFSINCL_ENV */
126 #endif /* AFS_SGI_ENV */
127 #ifdef  AFS_AIX_ENV
128 #include <sys/vfs.h>
129 #include <sys/lockf.h>
130 #else
131 #ifdef  AFS_HPUX_ENV
132 #include <checklist.h>
133 #else
134 #if defined(AFS_SGI_ENV)
135 #include <mntent.h>
136 #else
137 #if     defined(AFS_SUN_ENV) || defined(AFS_SUN5_ENV)
138 #ifdef    AFS_SUN5_ENV
139 #include <sys/mnttab.h>
140 #include <sys/mntent.h>
141 #else
142 #include <mntent.h>
143 #endif
144 #else
145 #endif /* AFS_SGI_ENV */
146 #endif /* AFS_HPUX_ENV */
147 #endif
148 #endif
149 #ifndef AFS_NT40_ENV
150 #include <afs/osi_inode.h>
151 #endif
152 #include <afs/cmd.h>
153 #include <afs/dir.h>
154 #include <afs/afsutil.h>
155 #include <afs/fileutil.h>
156 #include <rx/rx_queue.h>
157
158 #include "nfs.h"
159 #include "lwp.h"
160 #include "lock.h"
161 #include <afs/afssyscalls.h>
162 #include "ihandle.h"
163 #include "vnode.h"
164 #include "volume.h"
165 #include "partition.h"
166 #include "daemon_com.h"
167 #include "daemon_com_inline.h"
168 #include "fssync.h"
169 #include "fssync_inline.h"
170 #include "volume_inline.h"
171 #include "salvsync.h"
172 #include "viceinode.h"
173 #include "salvage.h"
174 #include "volinodes.h"          /* header magic number, etc. stuff */
175 #include "vol-salvage.h"
176 #include "common.h"
177 #include "vol_internal.h"
178 #include <afs/acl.h>
179 #include <afs/prs_fs.h>
180
181 #ifdef FSSYNC_BUILD_CLIENT
182 #include "vg_cache.h"
183 #endif
184
185 #ifdef AFS_NT40_ENV
186 #include <pthread.h>
187 #endif
188
189 #define SALV_BUFFER_SIZE 1024
190
191 static char *TimeStamp(char *buffer, size_t size, time_t clock, int precision);
192
193
194 int debug;                      /* -d flag */
195 extern int Testing;             /* -n flag */
196 int ListInodeOption;            /* -i flag */
197 int ShowRootFiles;              /* -r flag */
198 int RebuildDirs;                /* -sal flag */
199 int Parallel = 4;               /* -para X flag */
200 int PartsPerDisk = 8;           /* Salvage up to 8 partitions on same disk sequentially */
201 int forceR = 0;                 /* -b flag */
202 int ShowLog = 0;                /* -showlog flag */
203 char *ShowLogFilename = NULL;    /* log file name for -showlog */
204 int ShowSuid = 0;               /* -showsuid flag */
205 int ShowMounts = 0;             /* -showmounts flag */
206 int orphans = ORPH_IGNORE;      /* -orphans option */
207 int Showmode = 0;
208 int ClientMode = 0;             /* running as salvager server client */
209
210 #ifdef AFS_NT40_ENV
211 int canfork = 0;
212 #else
213 int canfork = 1;
214 #endif
215
216 #define MAXPARALLEL     32
217
218 int OKToZap;                    /* -o flag */
219 int ForceSalvage;               /* If salvage should occur despite the DONT_SALVAGE flag
220                                  * in the volume header */
221
222 #define ROOTINODE       2       /* Root inode of a 4.2 Unix file system
223                                  * partition */
224 /**
225  * information that is 'global' to a particular salvage job.
226  */
227 struct SalvInfo {
228     Device fileSysDevice;    /**< The device number of the current partition
229                               *   being salvaged */
230     char fileSysPath[9];     /**< The path of the mounted partition currently
231                               *   being salvaged, i.e. the directory containing
232                               *   the volume headers */
233     char *fileSysPathName;   /**< NT needs this to make name pretty log. */
234     IHandle_t *VGLinkH;      /**< Link handle for current volume group. */
235     int VGLinkH_cnt;         /**< # of references to lnk handle. */
236     struct DiskPartition64 *fileSysPartition; /**< Partition being salvaged */
237
238 #ifndef AFS_NT40_ENV
239     char *fileSysDeviceName; /**< The block device where the file system being
240                               *   salvaged was mounted */
241     char *filesysfulldev;
242 #endif
243     int VolumeChanged;       /**< Set by any routine which would change the
244                               *   volume in a way which would require callbacks
245                               *   to be broken if the volume was put back on
246                               *   on line by an active file server */
247
248     VolumeDiskData VolInfo;  /**< A copy of the last good or salvaged volume
249                               *   header dealt with */
250
251     int nVolumesInInodeFile; /**< Number of read-write volumes summarized */
252     FD_t inodeFd;             /**< File descriptor for inode file */
253
254     struct VolumeSummary *volumeSummaryp; /**< Holds all the volumes in a part */
255     int nVolumes;            /**< Number of volumes (read-write and read-only)
256                               *   in volume summary */
257     struct InodeSummary *inodeSummary; /**< contains info on all the relevant
258                                         *   inodes */
259
260     struct VnodeInfo vnodeInfo[nVNODECLASSES]; /**< contains info on all of the
261                                                 *   vnodes in the volume that
262                                                 *   we are currently looking
263                                                 *   at */
264     int useFSYNC; /**< 0 if the fileserver is unavailable; 1 if we should try
265                    *   to contact the fileserver over FSYNC */
266 };
267
268 char *tmpdir = NULL;
269
270
271
272 /* Forward declarations */
273 static void QuietExit(int) AFS_NORETURN;
274 static void SalvageShowLog(void);
275 static int IsVnodeOrphaned(struct SalvInfo *salvinfo, VnodeId vnode);
276 static int AskVolumeSummary(struct SalvInfo *salvinfo,
277                             VolumeId singleVolumeNumber);
278 static void MaybeAskOnline(struct SalvInfo *salvinfo, VolumeId volumeId);
279 static void AskError(struct SalvInfo *salvinfo, VolumeId volumeId);
280
281 #ifdef AFS_DEMAND_ATTACH_FS
282 static int LockVolume(struct SalvInfo *salvinfo, VolumeId volumeId);
283 #endif /* AFS_DEMAND_ATTACH_FS */
284
285 /* Uniquifier stored in the Inode */
286 static Unique
287 IUnique(Unique u)
288 {
289 #ifdef  AFS_3DISPARES
290     return (u & 0x3fffff);
291 #else
292 #if defined(AFS_SGI_EXMAG)
293     return (u & SGI_UNIQMASK);
294 #else
295     return (u);
296 #endif /* AFS_SGI_EXMAG */
297 #endif
298 }
299
300 static int
301 BadError(int aerror)
302 {
303     if (aerror == EPERM || aerror == ENXIO || aerror == ENOENT)
304         return 1;
305     return 0;                   /* otherwise may be transient, e.g. EMFILE */
306 }
307
308 #define MAX_ARGS 128
309 #ifdef AFS_NT40_ENV
310 char *save_args[MAX_ARGS];
311 int n_save_args = 0;
312 extern pthread_t main_thread;
313 childJob_t myjob = { SALVAGER_MAGIC, NOT_CHILD, "" };
314 #endif
315
316 /**
317  * Get the salvage lock if not already held. Hold until process exits.
318  *
319  * @param[in] locktype READ_LOCK or WRITE_LOCK
320  */
321 static void
322 _ObtainSalvageLock(int locktype)
323 {
324     struct VLockFile salvageLock;
325     int offset = 0;
326     int nonblock = 1;
327     int code;
328
329     VLockFileInit(&salvageLock, AFSDIR_SERVER_SLVGLOCK_FILEPATH);
330
331     code = VLockFileLock(&salvageLock, offset, locktype, nonblock);
332     if (code == EBUSY) {
333         fprintf(stderr,
334                 "salvager:  There appears to be another salvager running!  "
335                 "Aborted.\n");
336         Exit(1);
337     } else if (code) {
338         fprintf(stderr,
339                 "salvager:  Error %d trying to acquire salvage lock!  "
340                 "Aborted.\n", code);
341         Exit(1);
342     }
343 }
344 void
345 ObtainSalvageLock(void)
346 {
347     _ObtainSalvageLock(WRITE_LOCK);
348 }
349 void
350 ObtainSharedSalvageLock(void)
351 {
352     _ObtainSalvageLock(READ_LOCK);
353 }
354
355
356 #ifdef AFS_SGI_XFS_IOPS_ENV
357 /* Check if the given partition is mounted. For XFS, the root inode is not a
358  * constant. So we check the hard way.
359  */
360 int
361 IsPartitionMounted(char *part)
362 {
363     FILE *mntfp;
364     struct mntent *mntent;
365
366     opr_Verify(mntfp = setmntent(MOUNTED, "r"));
367     while (mntent = getmntent(mntfp)) {
368         if (!strcmp(part, mntent->mnt_dir))
369             break;
370     }
371     endmntent(mntfp);
372
373     return mntent ? 1 : 1;
374 }
375 #endif
376 /* Check if the given inode is the root of the filesystem. */
377 #ifndef AFS_SGI_XFS_IOPS_ENV
378 int
379 IsRootInode(struct afs_stat_st *status)
380 {
381     /*
382      * The root inode is not a fixed value in XFS partitions. So we need to
383      * see if the partition is in the list of mounted partitions. This only
384      * affects the SalvageFileSys path, so we check there.
385      */
386     return (status->st_ino == ROOTINODE);
387 }
388 #endif
389
390 #ifdef AFS_AIX42_ENV
391 #ifndef AFS_NAMEI_ENV
392 /* We don't want to salvage big files filesystems, since we can't put volumes on
393  * them.
394  */
395 int
396 CheckIfBigFilesFS(char *mountPoint, char *devName)
397 {
398     struct superblock fs;
399     char name[128];
400
401     if (strncmp(devName, "/dev/", 5)) {
402         (void)sprintf(name, "/dev/%s", devName);
403     } else {
404         (void)strcpy(name, devName);
405     }
406
407     if (ReadSuper(&fs, name) < 0) {
408         Log("Unable to read superblock. Not salvaging partition %s.\n",
409             mountPoint);
410         return 1;
411     }
412     if (IsBigFilesFileSystem(&fs)) {
413         Log("Partition %s is a big files filesystem, not salvaging.\n",
414             mountPoint);
415         return 1;
416     }
417     return 0;
418 }
419 #endif
420 #endif
421
422 #ifdef AFS_NT40_ENV
423 #define HDSTR "\\Device\\Harddisk"
424 #define HDLEN  (sizeof(HDSTR)-1)        /* Length of "\Device\Harddisk" */
425 int
426 SameDisk(struct DiskPartition64 *p1, struct DiskPartition64 *p2)
427 {
428 #define RES_LEN 256
429     char res1[RES_LEN];
430     char res2[RES_LEN];
431
432     static int dowarn = 1;
433
434     if (!QueryDosDevice(p1->devName, res1, RES_LEN - 1))
435         return 1;
436     if (strncmp(res1, HDSTR, HDLEN)) {
437         if (dowarn) {
438             dowarn = 0;
439             Log("WARNING: QueryDosDevice is returning %s, not %s for %s\n",
440                 res1, HDSTR, p1->devName);
441         }
442     }
443     if (!QueryDosDevice(p2->devName, res2, RES_LEN - 1))
444         return 1;
445     if (strncmp(res2, HDSTR, HDLEN)) {
446         if (dowarn) {
447             dowarn = 0;
448             Log("WARNING: QueryDosDevice is returning %s, not %s for %s\n",
449                 res2, HDSTR, p2->devName);
450         }
451     }
452
453     return (0 == _strnicmp(res1, res2, RES_LEN - 1));
454 }
455 #else
456 #define SameDisk(P1, P2) ((P1)->device/PartsPerDisk == (P2)->device/PartsPerDisk)
457 #endif
458
459 /* This assumes that two partitions with the same device number divided by
460  * PartsPerDisk are on the same disk.
461  */
462 void
463 SalvageFileSysParallel(struct DiskPartition64 *partP)
464 {
465     struct job {
466         struct DiskPartition64 *partP;
467         int pid;                /* Pid for this job */
468         int jobnumb;            /* Log file job number */
469         struct job *nextjob;    /* Next partition on disk to salvage */
470     };
471     static struct job *jobs[MAXPARALLEL] = { 0 };       /* Need to zero this */
472     struct job *thisjob = 0;
473     static int numjobs = 0;
474     static int jobcount = 0;
475     int wstatus;
476     struct job *oldjob;
477     int startjob;
478     FILE *passLog;
479     int i, j, pid;
480
481     if (partP) {
482         /* We have a partition to salvage. Copy it into thisjob */
483         thisjob = calloc(1, sizeof(struct job));
484         if (!thisjob) {
485             Log("Can't salvage '%s'. Not enough memory\n", partP->name);
486             return;
487         }
488         thisjob->partP = partP;
489         thisjob->jobnumb = jobcount;
490         jobcount++;
491     } else if (jobcount == 0) {
492         /* We are asking to wait for all jobs (partp == 0), yet we never
493          * started any.
494          */
495         Log("No file system partitions named %s* found; not salvaged\n",
496             VICE_PARTITION_PREFIX);
497         return;
498     }
499
500     if (debug || Parallel == 1) {
501         if (thisjob) {
502             SalvageFileSys(thisjob->partP, 0);
503             free(thisjob);
504         }
505         return;
506     }
507
508     if (thisjob) {
509         /* Check to see if thisjob is for a disk that we are already
510          * salvaging. If it is, link it in as the next job to do. The
511          * jobs array has 1 entry per disk being salvages. numjobs is
512          * the total number of disks currently being salvaged. In
513          * order to keep thejobs array compact, when a disk is
514          * completed, the hightest element in the jobs array is moved
515          * down to now open slot.
516          */
517         for (j = 0; j < numjobs; j++) {
518             if (SameDisk(jobs[j]->partP, thisjob->partP)) {
519                 /* On same disk, add it to this list and return */
520                 thisjob->nextjob = jobs[j]->nextjob;
521                 jobs[j]->nextjob = thisjob;
522                 thisjob = 0;
523                 break;
524             }
525         }
526     }
527
528     /* Loop until we start thisjob or until all existing jobs are finished */
529     while (thisjob || (!partP && (numjobs > 0))) {
530         startjob = -1;          /* No new job to start */
531
532         if ((numjobs >= Parallel) || (!partP && (numjobs > 0))) {
533             /* Either the max jobs are running or we have to wait for all
534              * the jobs to finish. In either case, we wait for at least one
535              * job to finish. When it's done, clean up after it.
536              */
537             pid = wait(&wstatus);
538             opr_Assert(pid != -1);
539             for (j = 0; j < numjobs; j++) {     /* Find which job it is */
540                 if (pid == jobs[j]->pid)
541                     break;
542             }
543             opr_Assert(j < numjobs);
544             if (WCOREDUMP(wstatus)) {   /* Say if the job core dumped */
545                 Log("Salvage of %s core dumped!\n", jobs[j]->partP->name);
546             }
547
548             numjobs--;          /* job no longer running */
549             oldjob = jobs[j];   /* remember */
550             jobs[j] = jobs[j]->nextjob; /* Step to next part on same disk */
551             free(oldjob);       /* free the old job */
552
553             /* If there is another partition on the disk to salvage, then
554              * say we will start it (startjob). If not, then put thisjob there
555              * and say we will start it.
556              */
557             if (jobs[j]) {      /* Another partitions to salvage */
558                 startjob = j;   /* Will start it */
559             } else {            /* There is not another partition to salvage */
560                 if (thisjob) {
561                     jobs[j] = thisjob;  /* Add thisjob */
562                     thisjob = 0;
563                     startjob = j;       /* Will start it */
564                 } else {
565                     jobs[j] = jobs[numjobs];    /* Move last job up to this slot */
566                     startjob = -1;      /* Don't start it - already running */
567                 }
568             }
569         } else {
570             /* We don't have to wait for a job to complete */
571             if (thisjob) {
572                 jobs[numjobs] = thisjob;        /* Add this job */
573                 thisjob = 0;
574                 startjob = numjobs;     /* Will start it */
575             }
576         }
577
578         /* Start up a new salvage job on a partition in job slot "startjob" */
579         if (startjob != -1) {
580             if (!Showmode)
581                 Log("Starting salvage of file system partition %s\n",
582                     jobs[startjob]->partP->name);
583 #ifdef AFS_NT40_ENV
584             /* For NT, we not only fork, but re-exec the salvager. Pass in the
585              * commands and pass the child job number via the data path.
586              */
587             pid =
588                 nt_SalvagePartition(jobs[startjob]->partP->name,
589                                     jobs[startjob]->jobnumb);
590             jobs[startjob]->pid = pid;
591             numjobs++;
592 #else
593             pid = Fork();
594             if (pid) {
595                 jobs[startjob]->pid = pid;
596                 numjobs++;
597             } else {
598                 int fd;
599                 char *filename;
600                 struct logOptions logopts;
601
602                 memset(&logopts, 0, sizeof(logopts));
603                 logopts.lopt_dest = logDest_file;
604
605                 for (fd = 0; fd < 16; fd++)
606                     close(fd);
607                 open(OS_DIRSEP, 0);
608                 dup2(0, 1);
609                 dup2(0, 2);
610
611                 ShowLog = 0; /* Child processes do not display. */
612                 if (asprintf(&filename, "%s.%d",
613                              AFSDIR_SERVER_SLVGLOG_FILEPATH,
614                              jobs[startjob]->jobnumb) >= 0) {
615                     logopts.lopt_filename = filename;
616                     OpenLog(&logopts);
617                     free(filename);
618                 }
619
620                 SalvageFileSys1(jobs[startjob]->partP, 0);
621                 Exit(0);
622             }
623 #endif
624         }
625     }                           /* while ( thisjob || (!partP && numjobs > 0) ) */
626
627     /*
628      * If waited for all jobs to complete, now collect log files and return.
629      * No files can be collected when logging to the system log (syslog).
630      */
631     if (GetLogDest() == logDest_file) {
632         if (!partP) {
633             char *buf = calloc(1, SALV_BUFFER_SIZE);
634             char *logFileName;
635
636             if (buf == NULL) {
637                 Log("out of memory");
638             } else {
639                 for (i = 0; i < jobcount; i++) {
640                     if (asprintf(&logFileName, "%s.%d",
641                                  AFSDIR_SERVER_SLVGLOG_FILEPATH, i) < 0) {
642                         Log("out of memory");
643                         break;
644                     }
645                     if ((passLog = afs_fopen(logFileName, "r"))) {
646                         while (fgets(buf, SALV_BUFFER_SIZE, passLog)) {
647                             WriteLogBuffer(buf, strlen(buf));
648                         }
649                         fclose(passLog);
650                     }
651                     (void)unlink(logFileName);
652                     free(logFileName);
653                 }
654                 free(buf);
655             }
656         }
657     }
658     return;
659 }
660
661
662 void
663 SalvageFileSys(struct DiskPartition64 *partP, VolumeId singleVolumeNumber)
664 {
665     if (!canfork || debug || Fork() == 0) {
666         SalvageFileSys1(partP, singleVolumeNumber);
667         if (canfork && !debug) {
668             QuietExit(0);
669         }
670     } else
671         Wait("SalvageFileSys");
672 }
673
674 char *
675 get_DevName(char *pbuffer, char *wpath)
676 {
677     char pbuf[128], *ptr;
678     strcpy(pbuf, pbuffer);
679     ptr = (char *)strrchr(pbuf, OS_DIRSEPC);
680     if (ptr) {
681         *ptr = '\0';
682         strcpy(wpath, pbuf);
683     } else
684         return NULL;
685     ptr = (char *)strrchr(pbuffer, OS_DIRSEPC);
686     if (ptr) {
687         strcpy(pbuffer, ptr + 1);
688         return pbuffer;
689     } else
690         return NULL;
691 }
692
693 void
694 SalvageFileSys1(struct DiskPartition64 *partP, VolumeId singleVolumeNumber)
695 {
696     char *name, *tdir;
697     char *inodeListPath = NULL;
698     FD_t inodeFile = INVALID_FD;
699     static char tmpDevName[100];
700     static char wpath[100];
701     struct VolumeSummary *vsp, *esp;
702     int i, j;
703     int code;
704     int tries = 0;
705     struct SalvInfo l_salvinfo;
706     struct SalvInfo *salvinfo = &l_salvinfo;
707
708  retry:
709     memset(salvinfo, 0, sizeof(*salvinfo));
710
711     tries++;
712     if (inodeFile != INVALID_FD) {
713         OS_CLOSE(inodeFile);
714         inodeFile = INVALID_FD;
715     }
716     if (tries > VOL_MAX_CHECKOUT_RETRIES) {
717         Abort("Raced too many times with fileserver restarts while trying to "
718               "checkout/lock volumes; Aborted\n");
719     }
720 #ifdef AFS_DEMAND_ATTACH_FS
721     if (tries > 1) {
722         /* unlock all previous volume locks, since we're about to lock them
723          * again */
724         VLockFileReinit(&partP->volLockFile);
725     }
726 #endif /* AFS_DEMAND_ATTACH_FS */
727
728     salvinfo->fileSysPartition = partP;
729     salvinfo->fileSysDevice = salvinfo->fileSysPartition->device;
730     salvinfo->fileSysPathName = VPartitionPath(salvinfo->fileSysPartition);
731
732 #ifdef AFS_NT40_ENV
733     /* Opendir can fail on "C:" but not on "C:\" if C is empty! */
734     (void)sprintf(salvinfo->fileSysPath, "%s" OS_DIRSEP, salvinfo->fileSysPathName);
735     name = partP->devName;
736 #else
737     strlcpy(salvinfo->fileSysPath, salvinfo->fileSysPathName, sizeof(salvinfo->fileSysPath));
738     strcpy(tmpDevName, partP->devName);
739     name = get_DevName(tmpDevName, wpath);
740     salvinfo->fileSysDeviceName = name;
741     salvinfo->filesysfulldev = wpath;
742 #endif
743
744     if (singleVolumeNumber) {
745 #ifndef AFS_DEMAND_ATTACH_FS
746         /* only non-DAFS locks the partition when salvaging a single volume;
747          * DAFS will lock the individual volumes in the VG */
748         VLockPartition(partP->name);
749 #endif /* !AFS_DEMAND_ATTACH_FS */
750
751         ForceSalvage = 1;
752
753         /* salvageserver already setup fssync conn for us */
754         if ((programType != salvageServer) && !VConnectFS()) {
755             Abort("Couldn't connect to file server\n");
756         }
757
758         salvinfo->useFSYNC = 1;
759         AskOffline(salvinfo, singleVolumeNumber);
760 #ifdef AFS_DEMAND_ATTACH_FS
761         if (LockVolume(salvinfo, singleVolumeNumber)) {
762             goto retry;
763         }
764 #endif /* AFS_DEMAND_ATTACH_FS */
765
766     } else {
767         salvinfo->useFSYNC = 0;
768         VLockPartition(partP->name);
769         if (ForceSalvage) {
770             ForceSalvage = 1;
771         } else {
772             ForceSalvage = UseTheForceLuke(salvinfo->fileSysPath);
773         }
774         if (!Showmode)
775             Log("SALVAGING FILE SYSTEM PARTITION %s (device=%s%s)\n",
776                 partP->name, name, (Testing ? "(READONLY mode)" : ""));
777         if (ForceSalvage)
778             Log("***Forced salvage of all volumes on this partition***\n");
779     }
780
781
782     /*
783      * Remove any leftover /vicepa/salvage.inodes.* or /vicepa/salvage.temp.*
784      * files
785      */
786     {
787         DIR *dirp;
788         struct dirent *dp;
789
790         opr_Verify((dirp = opendir(salvinfo->fileSysPath)) != NULL);
791         while ((dp = readdir(dirp))) {
792             if (!strncmp(dp->d_name, "salvage.inodes.", 15)
793                 || !strncmp(dp->d_name, "salvage.temp.", 13)) {
794                 char npath[1024];
795                 Log("Removing old salvager temp files %s\n", dp->d_name);
796                 strcpy(npath, salvinfo->fileSysPath);
797                 strcat(npath, OS_DIRSEP);
798                 strcat(npath, dp->d_name);
799                 OS_UNLINK(npath);
800             }
801         }
802         closedir(dirp);
803     }
804     tdir = (tmpdir ? tmpdir : salvinfo->fileSysPath);
805 #ifdef AFS_NT40_ENV
806     (void)_putenv("TMP=");      /* If "TMP" is set, then that overrides tdir. */
807     inodeListPath = strdup(_tempnam(tdir, "salvage.inodes."));
808     if (inodeListPath == NULL) {
809         Abort("Error allocating memory for inodeListPath\n");
810     }
811 #else
812     code = asprintf(&inodeListPath, "%s" OS_DIRSEP "salvage.inodes.%s.%d", tdir, name,
813              getpid());
814     if (code == -1) {
815         Abort("Error allocating memory for inodeListPath\n");
816     }
817 #endif
818
819     inodeFile = OS_OPEN(inodeListPath, O_RDWR|O_TRUNC|O_CREAT, 0666);
820     if (inodeFile == INVALID_FD) {
821         Abort("Error %d when creating inode description file %s; not salvaged\n", errno, inodeListPath);
822     }
823 #ifdef AFS_NT40_ENV
824     /* Using nt_unlink here since we're really using the delete on close
825      * semantics of unlink. In most places in the salvager, we really do
826      * mean to unlink the file at that point. Those places have been
827      * modified to actually do that so that the NT crt can be used there.
828      *
829      * jaltman - On NT delete on close cannot be applied to a file while the
830      * process has an open file handle that does not have DELETE file
831      * access and FILE_SHARE_DELETE.  fopen() calls CreateFile() without
832      * delete privileges.  As a result the nt_unlink() call will always
833      * fail.
834      */
835     code = nt_unlink(inodeListPath);
836 #else
837     code = unlink(inodeListPath);
838 #endif
839     if (code < 0) {
840         Log("Error %d when trying to unlink %s\n", errno, inodeListPath);
841     }
842
843     if (GetInodeSummary(salvinfo, inodeFile, singleVolumeNumber) < 0) {
844         OS_CLOSE(inodeFile);
845         free(inodeListPath);
846         return;
847     }
848     salvinfo->inodeFd = inodeFile;
849     if (salvinfo->inodeFd == INVALID_FD)
850         Abort("Temporary file %s is missing...\n", inodeListPath);
851
852     free(inodeListPath);
853     inodeListPath = NULL;
854
855     OS_SEEK(salvinfo->inodeFd, 0L, SEEK_SET);
856     if (ListInodeOption) {
857         PrintInodeList(salvinfo);
858         if (singleVolumeNumber) {
859             /* We've checked out the volume from the fileserver, and we need
860              * to give it back. We don't know if the volume exists or not,
861              * so we don't know whether to AskOnline or not. Try to determine
862              * if the volume exists by trying to read the volume header, and
863              * AskOnline if it is readable. */
864             MaybeAskOnline(salvinfo, singleVolumeNumber);
865         }
866         return;
867     }
868     /* enumerate volumes in the partition.
869      * figure out sets of read-only + rw volumes.
870      * salvage each set, read-only volumes first, then read-write.
871      * Fix up inodes on last volume in set (whether it is read-write
872      * or read-only).
873      */
874     if (GetVolumeSummary(salvinfo, singleVolumeNumber)) {
875         goto retry;
876     }
877
878     if (singleVolumeNumber) {
879         /* If we delete a volume during the salvage, we indicate as such by
880          * setting the volsummary->deleted field. We need to know if we
881          * deleted a volume or not in order to know which volumes to bring
882          * back online after the salvage. If we fork, we will lose this
883          * information, since volsummary->deleted will not get set in the
884          * parent. So, don't fork. */
885         canfork = 0;
886     }
887
888     for (i = j = 0, vsp = salvinfo->volumeSummaryp, esp = vsp + salvinfo->nVolumes;
889          i < salvinfo->nVolumesInInodeFile; i = j) {
890         VolumeId rwvid = salvinfo->inodeSummary[i].RWvolumeId;
891         for (j = i;
892              j < salvinfo->nVolumesInInodeFile && salvinfo->inodeSummary[j].RWvolumeId == rwvid;
893              j++) {
894             VolumeId vid = salvinfo->inodeSummary[j].volumeId;
895             struct VolumeSummary *tsp;
896             /* Scan volume list (from partition root directory) looking for the
897              * current rw volume number in the volume list from the inode scan.
898              * If there is one here that is not in the inode volume list,
899              * delete it now. */
900             for (; vsp < esp && (vsp->header.parent < rwvid); vsp++) {
901                 if (vsp->unused)
902                     DeleteExtraVolumeHeaderFile(salvinfo, vsp);
903             }
904             /* Now match up the volume summary info from the root directory with the
905              * entry in the volume list obtained from scanning inodes */
906             salvinfo->inodeSummary[j].volSummary = NULL;
907             for (tsp = vsp; tsp < esp && (tsp->header.parent == rwvid); tsp++) {
908                 if (tsp->header.id == vid) {
909                     salvinfo->inodeSummary[j].volSummary = tsp;
910                     tsp->unused = 0;
911                     break;
912                 }
913             }
914         }
915         /* Salvage the group of volumes (several read-only + 1 read/write)
916          * starting with the current read-only volume we're looking at.
917          */
918 #ifdef AFS_NT40_ENV
919         nt_SalvageVolumeGroup(salvinfo, &salvinfo->inodeSummary[i], j - i);
920 #else
921         DoSalvageVolumeGroup(salvinfo, &salvinfo->inodeSummary[i], j - i);
922 #endif /* AFS_NT40_ENV */
923
924     }
925
926     /* Delete any additional volumes that were listed in the partition but which didn't have any corresponding inodes */
927     for (; vsp < esp; vsp++) {
928         if (vsp->unused)
929             DeleteExtraVolumeHeaderFile(salvinfo, vsp);
930     }
931
932     if (!singleVolumeNumber)    /* Remove the FORCESALVAGE file */
933         RemoveTheForce(salvinfo->fileSysPath);
934
935     if (!Testing && singleVolumeNumber) {
936         int foundSVN = 0;
937 #ifdef AFS_DEMAND_ATTACH_FS
938         /* unlock vol headers so the fs can attach them when we AskOnline */
939         VLockFileReinit(&salvinfo->fileSysPartition->volLockFile);
940 #endif /* AFS_DEMAND_ATTACH_FS */
941
942         /* Step through the volumeSummary list and set all volumes on-line.
943          * Most volumes were taken off-line in GetVolumeSummary.
944          * If a volume was deleted, don't tell the fileserver anything, since
945          * we already told the fileserver the volume was deleted back when we
946          * we destroyed the volume header.
947          * Also, make sure we bring the singleVolumeNumber back online first.
948          */
949
950         for (j = 0; j < salvinfo->nVolumes; j++) {
951             if (salvinfo->volumeSummaryp[j].header.id == singleVolumeNumber) {
952                 foundSVN = 1;
953                 if (!salvinfo->volumeSummaryp[j].deleted) {
954                     AskOnline(salvinfo, singleVolumeNumber);
955                 }
956             }
957         }
958
959         if (!foundSVN) {
960             /* If singleVolumeNumber is not in our volumeSummary, it means that
961              * at least one other volume in the VG is on the partition, but the
962              * RW volume is not. We've already AskOffline'd it by now, though,
963              * so make sure we don't still have the volume checked out. */
964             AskDelete(salvinfo, singleVolumeNumber);
965         }
966
967         for (j = 0; j < salvinfo->nVolumes; j++) {
968             if (salvinfo->volumeSummaryp[j].header.id != singleVolumeNumber) {
969                 if (!salvinfo->volumeSummaryp[j].deleted) {
970                     AskOnline(salvinfo, salvinfo->volumeSummaryp[j].header.id);
971                 }
972             }
973         }
974     } else {
975         if (!Showmode)
976             Log("SALVAGING OF PARTITION %s%s COMPLETED\n",
977                 salvinfo->fileSysPartition->name, (Testing ? " (READONLY mode)" : ""));
978     }
979
980     OS_CLOSE(inodeFile);                /* SalvageVolumeGroup was the last which needed it. */
981 }
982
983 void
984 DeleteExtraVolumeHeaderFile(struct SalvInfo *salvinfo, struct VolumeSummary *vsp)
985 {
986     char path[VMAXPATHLEN + 10];
987     char filename[VMAXPATHLEN];
988
989     if (vsp->deleted) {
990         return;
991     }
992
993     VolumeExternalName_r(vsp->header.id, filename, sizeof(filename));
994     sprintf(path, "%s" OS_DIRSEP "%s", salvinfo->fileSysPath, filename);
995
996     if (!Showmode)
997         Log("The volume header file %s is not associated with any actual data (%sdeleted)\n", path, (Testing ? "would have been " : ""));
998     if (!Testing) {
999         afs_int32 code;
1000         code = VDestroyVolumeDiskHeader(salvinfo->fileSysPartition, vsp->header.id, vsp->header.parent);
1001         if (code) {
1002             Log("Error %ld destroying volume disk header for volume %" AFS_VOLID_FMT "\n",
1003                 afs_printable_int32_ld(code),
1004                 afs_printable_VolumeId_lu(vsp->header.id));
1005         }
1006
1007         /* make sure we actually delete the header file; ENOENT
1008          * is fine, since VDestroyVolumeDiskHeader probably already
1009          * unlinked it */
1010         if (unlink(path) && errno != ENOENT) {
1011             Log("Unable to unlink %s (errno = %d)\n", path, errno);
1012         }
1013         if (salvinfo->useFSYNC) {
1014             AskDelete(salvinfo, vsp->header.id);
1015         }
1016         vsp->deleted = 1;
1017     }
1018 }
1019
1020 int
1021 CompareInodes(const void *_p1, const void *_p2)
1022 {
1023     const struct ViceInodeInfo *p1 = _p1;
1024     const struct ViceInodeInfo *p2 = _p2;
1025     if (p1->u.vnode.vnodeNumber == INODESPECIAL
1026         || p2->u.vnode.vnodeNumber == INODESPECIAL) {
1027         VolumeId p1rwid, p2rwid;
1028         p1rwid =
1029             (p1->u.vnode.vnodeNumber ==
1030              INODESPECIAL ? p1->u.special.parentId : p1->u.vnode.volumeId);
1031         p2rwid =
1032             (p2->u.vnode.vnodeNumber ==
1033              INODESPECIAL ? p2->u.special.parentId : p2->u.vnode.volumeId);
1034         if (p1rwid < p2rwid)
1035             return -1;
1036         if (p1rwid > p2rwid)
1037             return 1;
1038         if (p1->u.vnode.vnodeNumber == INODESPECIAL
1039             && p2->u.vnode.vnodeNumber == INODESPECIAL) {
1040             if (p1->u.vnode.volumeId == p2->u.vnode.volumeId)
1041                 return (p1->u.special.type < p2->u.special.type ? -1 : 1);
1042             if (p1->u.vnode.volumeId == p1rwid)
1043                 return -1;
1044             if (p2->u.vnode.volumeId == p2rwid)
1045                 return 1;
1046             return (p1->u.vnode.volumeId < p2->u.vnode.volumeId ? -1 : 1);
1047         }
1048         if (p1->u.vnode.vnodeNumber != INODESPECIAL)
1049             return (p2->u.vnode.volumeId == p2rwid ? 1 : -1);
1050         return (p1->u.vnode.volumeId == p1rwid ? -1 : 1);
1051     }
1052     if (p1->u.vnode.volumeId < p2->u.vnode.volumeId)
1053         return -1;
1054     if (p1->u.vnode.volumeId > p2->u.vnode.volumeId)
1055         return 1;
1056     if (p1->u.vnode.vnodeNumber < p2->u.vnode.vnodeNumber)
1057         return -1;
1058     if (p1->u.vnode.vnodeNumber > p2->u.vnode.vnodeNumber)
1059         return 1;
1060     /* The following tests are reversed, so that the most desirable
1061      * of several similar inodes comes first */
1062     if (p1->u.vnode.vnodeUniquifier > p2->u.vnode.vnodeUniquifier) {
1063 #ifdef  AFS_3DISPARES
1064         if (p1->u.vnode.vnodeUniquifier > 3775414 /* 90% of 4.2M */  &&
1065             p2->u.vnode.vnodeUniquifier < 419490 /* 10% of 4.2M */ )
1066             return 1;
1067 #endif
1068 #ifdef  AFS_SGI_EXMAG
1069         if (p1->u.vnode.vnodeUniquifier > 15099494 /* 90% of 16M */  &&
1070             p2->u.vnode.vnodeUniquifier < 1677721 /* 10% of 16M */ )
1071             return 1;
1072 #endif
1073         return -1;
1074     }
1075     if (p1->u.vnode.vnodeUniquifier < p2->u.vnode.vnodeUniquifier) {
1076 #ifdef  AFS_3DISPARES
1077         if (p2->u.vnode.vnodeUniquifier > 3775414 /* 90% of 4.2M */  &&
1078             p1->u.vnode.vnodeUniquifier < 419490 /* 10% of 4.2M */ )
1079             return -1;
1080 #endif
1081 #ifdef  AFS_SGI_EXMAG
1082         if (p2->u.vnode.vnodeUniquifier > 15099494 /* 90% of 16M */  &&
1083             p1->u.vnode.vnodeUniquifier < 1677721 /* 10% of 16M */ )
1084             return 1;
1085 #endif
1086         return 1;
1087     }
1088     if (p1->u.vnode.inodeDataVersion > p2->u.vnode.inodeDataVersion) {
1089 #ifdef  AFS_3DISPARES
1090         if (p1->u.vnode.inodeDataVersion > 1887437 /* 90% of 2.1M */  &&
1091             p2->u.vnode.inodeDataVersion < 209716 /* 10% of 2.1M */ )
1092             return 1;
1093 #endif
1094 #ifdef  AFS_SGI_EXMAG
1095         if (p1->u.vnode.inodeDataVersion > 15099494 /* 90% of 16M */  &&
1096             p2->u.vnode.inodeDataVersion < 1677721 /* 10% of 16M */ )
1097             return 1;
1098 #endif
1099         return -1;
1100     }
1101     if (p1->u.vnode.inodeDataVersion < p2->u.vnode.inodeDataVersion) {
1102 #ifdef  AFS_3DISPARES
1103         if (p2->u.vnode.inodeDataVersion > 1887437 /* 90% of 2.1M */  &&
1104             p1->u.vnode.inodeDataVersion < 209716 /* 10% of 2.1M */ )
1105             return -1;
1106 #endif
1107 #ifdef  AFS_SGI_EXMAG
1108         if (p2->u.vnode.inodeDataVersion > 15099494 /* 90% of 16M */  &&
1109             p1->u.vnode.inodeDataVersion < 1677721 /* 10% of 16M */ )
1110             return 1;
1111 #endif
1112         return 1;
1113     }
1114     return 0;
1115 }
1116
1117 void
1118 CountVolumeInodes(struct ViceInodeInfo *ip, int maxInodes,
1119                   struct InodeSummary *summary)
1120 {
1121     VolumeId volume = ip->u.vnode.volumeId;
1122     VolumeId rwvolume = volume;
1123     int n, nSpecial;
1124     Unique maxunique;
1125     n = nSpecial = 0;
1126     maxunique = 0;
1127     while (maxInodes-- && volume == ip->u.vnode.volumeId) {
1128         n++;
1129         if (ip->u.vnode.vnodeNumber == INODESPECIAL) {
1130             nSpecial++;
1131             rwvolume = ip->u.special.parentId;
1132             /* This isn't quite right, as there could (in error) be different
1133              * parent inodes in different special vnodes */
1134         } else {
1135             if (maxunique < ip->u.vnode.vnodeUniquifier)
1136                 maxunique = ip->u.vnode.vnodeUniquifier;
1137         }
1138         ip++;
1139     }
1140     summary->volumeId = volume;
1141     summary->RWvolumeId = rwvolume;
1142     summary->nInodes = n;
1143     summary->nSpecialInodes = nSpecial;
1144     summary->maxUniquifier = maxunique;
1145 }
1146
1147 int
1148 OnlyOneVolume(struct ViceInodeInfo *inodeinfo, VolumeId singleVolumeNumber, void *rock)
1149 {
1150     if (inodeinfo->u.vnode.vnodeNumber == INODESPECIAL)
1151         return (inodeinfo->u.special.parentId == singleVolumeNumber);
1152     return (inodeinfo->u.vnode.volumeId == singleVolumeNumber);
1153 }
1154
1155 /* GetInodeSummary
1156  *
1157  * Collect list of inodes in file named by path. If a truly fatal error,
1158  * unlink the file and abort. For lessor errors, return -1. The file will
1159  * be unlinked by the caller.
1160  */
1161 int
1162 GetInodeSummary(struct SalvInfo *salvinfo, FD_t inodeFile, VolumeId singleVolumeNumber)
1163 {
1164     int forceSal, err;
1165     int code;
1166     struct ViceInodeInfo *ip, *ip_save;
1167     struct InodeSummary summary;
1168     char summaryFileName[50];
1169     FD_t summaryFile = INVALID_FD;
1170 #ifdef AFS_NT40_ENV
1171     char *dev = salvinfo->fileSysPath;
1172     char *wpath = salvinfo->fileSysPath;
1173 #else
1174     char *dev = salvinfo->fileSysDeviceName;
1175     char *wpath = salvinfo->filesysfulldev;
1176 #endif
1177     char *part = salvinfo->fileSysPath;
1178     char *tdir;
1179     int i;
1180     int retcode = 0;
1181     int deleted = 0;
1182     afs_sfsize_t st_size;
1183
1184     /* This file used to come from vfsck; cobble it up ourselves now... */
1185     if ((err =
1186          ListViceInodes(dev, salvinfo->fileSysPath, inodeFile,
1187                         singleVolumeNumber ? OnlyOneVolume : 0,
1188                         singleVolumeNumber, &forceSal, forceR, wpath, NULL)) < 0) {
1189         if (err == -2) {
1190             Log("*** I/O error %d when writing a tmp inode file; Not salvaged %s ***\nIncrease space on partition or use '-tmpdir'\n", errno, dev);
1191             retcode = -1;
1192             goto error;
1193         }
1194         Abort("Unable to get inodes for \"%s\"; not salvaged\n", dev);
1195     }
1196     if (forceSal && !ForceSalvage) {
1197         Log("***Forced salvage of all volumes on this partition***\n");
1198         ForceSalvage = 1;
1199     }
1200     OS_SEEK(inodeFile, 0L, SEEK_SET);
1201     salvinfo->inodeFd = inodeFile;
1202     if (salvinfo->inodeFd == INVALID_FD ||
1203         (st_size = OS_SIZE(salvinfo->inodeFd)) == -1) {
1204         Abort("No inode description file for \"%s\"; not salvaged\n", dev);
1205     }
1206     tdir = (tmpdir ? tmpdir : part);
1207 #ifdef AFS_NT40_ENV
1208     (void)_putenv("TMP=");      /* If "TMP" is set, then that overrides tdir. */
1209     (void)strcpy(summaryFileName, _tempnam(tdir, "salvage.temp."));
1210 #else
1211     snprintf(summaryFileName, sizeof summaryFileName,
1212              "%s" OS_DIRSEP "salvage.temp.%d", tdir, getpid());
1213 #endif
1214     summaryFile = OS_OPEN(summaryFileName, O_RDWR|O_APPEND|O_CREAT, 0666);
1215     if (summaryFile == INVALID_FD) {
1216         Abort("Unable to create inode summary file\n");
1217     }
1218
1219 #ifdef AFS_NT40_ENV
1220     /* Using nt_unlink here since we're really using the delete on close
1221      * semantics of unlink. In most places in the salvager, we really do
1222      * mean to unlink the file at that point. Those places have been
1223      * modified to actually do that so that the NT crt can be used there.
1224      *
1225      * jaltman - As commented elsewhere, this cannot work because fopen()
1226      * does not open files with DELETE and FILE_SHARE_DELETE.
1227      */
1228     code = nt_unlink(summaryFileName);
1229 #else
1230     code = unlink(summaryFileName);
1231 #endif
1232     if (code < 0) {
1233         Log("Error %d when trying to unlink %s\n", errno, summaryFileName);
1234     }
1235
1236     if (!canfork || debug || Fork() == 0) {
1237         int nInodes = st_size / sizeof(struct ViceInodeInfo);
1238         if (nInodes == 0) {
1239             OS_CLOSE(summaryFile);
1240             if (!singleVolumeNumber)    /* Remove the FORCESALVAGE file */
1241                 RemoveTheForce(salvinfo->fileSysPath);
1242             else {
1243                 struct VolumeSummary *vsp;
1244                 int i;
1245                 int foundSVN = 0;
1246
1247                 GetVolumeSummary(salvinfo, singleVolumeNumber);
1248
1249                 for (i = 0, vsp = salvinfo->volumeSummaryp; i < salvinfo->nVolumes; i++) {
1250                     if (vsp->unused) {
1251                         if (vsp->header.id == singleVolumeNumber) {
1252                             foundSVN = 1;
1253                         }
1254                         DeleteExtraVolumeHeaderFile(salvinfo, vsp);
1255                     }
1256                 }
1257
1258                 if (!foundSVN) {
1259                     if (Testing) {
1260                         MaybeAskOnline(salvinfo, singleVolumeNumber);
1261                     } else {
1262                         /* make sure we get rid of stray .vol headers, even if
1263                          * they're not in our volume summary (might happen if
1264                          * e.g. something else created them and they're not in the
1265                          * fileserver VGC) */
1266                         VDestroyVolumeDiskHeader(salvinfo->fileSysPartition,
1267                                                  singleVolumeNumber, 0 /*parent*/);
1268                         AskDelete(salvinfo, singleVolumeNumber);
1269                     }
1270                 }
1271             }
1272             Log("%s vice inodes on %s; not salvaged\n",
1273                 singleVolumeNumber ? "No applicable" : "No", dev);
1274             retcode = -1;
1275             deleted = 1;
1276             goto error;
1277         }
1278         ip = malloc(nInodes*sizeof(struct ViceInodeInfo));
1279         if (ip == NULL) {
1280             OS_CLOSE(summaryFile);
1281             Abort
1282                 ("Unable to allocate enough space to read inode table; %s not salvaged\n",
1283                  dev);
1284         }
1285         if (OS_READ(salvinfo->inodeFd, ip, st_size) != st_size) {
1286             OS_CLOSE(summaryFile);
1287             Abort("Unable to read inode table; %s not salvaged\n", dev);
1288         }
1289         qsort(ip, nInodes, sizeof(struct ViceInodeInfo), CompareInodes);
1290         if (OS_SEEK(salvinfo->inodeFd, 0, SEEK_SET) == -1
1291             || OS_WRITE(salvinfo->inodeFd, ip, st_size) != st_size) {
1292             OS_CLOSE(summaryFile);
1293             Abort("Unable to rewrite inode table; %s not salvaged\n", dev);
1294         }
1295         summary.index = 0;
1296         ip_save = ip;
1297         while (nInodes) {
1298             CountVolumeInodes(ip, nInodes, &summary);
1299             if (OS_WRITE(summaryFile, &summary, sizeof(summary)) != sizeof(summary)) {
1300                 Log("Difficulty writing summary file (errno = %d); %s not salvaged\n", errno, dev);
1301                 OS_CLOSE(summaryFile);
1302                 retcode = -1;
1303                 goto error;
1304             }
1305             summary.index += (summary.nInodes);
1306             nInodes -= summary.nInodes;
1307             ip += summary.nInodes;
1308         }
1309         free(ip_save);
1310         ip = ip_save = NULL;
1311         /* Following fflush is not fclose, because if it was debug mode would not work */
1312         if (OS_SYNC(summaryFile) == -1) {
1313             Log("Unable to write summary file (errno = %d); %s not salvaged\n", errno, dev);
1314             OS_CLOSE(summaryFile);
1315             retcode = -1;
1316             goto error;
1317         }
1318         if (canfork && !debug) {
1319             QuietExit(0);
1320         }
1321     } else {
1322         if (Wait("Inode summary") == -1) {
1323             OS_CLOSE(summaryFile);
1324             Exit(1);            /* salvage of this partition aborted */
1325         }
1326     }
1327
1328     st_size = OS_SIZE(summaryFile);
1329     opr_Assert(st_size >= 0);
1330     if (st_size != 0) {
1331         int ret;
1332         salvinfo->inodeSummary = malloc(st_size);
1333         opr_Assert(salvinfo->inodeSummary != NULL);
1334         /* For GNU we need to do lseek to get the file pointer moved. */
1335         opr_Assert(OS_SEEK(summaryFile, 0, SEEK_SET) == 0);
1336         ret = OS_READ(summaryFile, salvinfo->inodeSummary, st_size);
1337         opr_Assert(ret == st_size);
1338     }
1339     salvinfo->nVolumesInInodeFile = st_size / sizeof(struct InodeSummary);
1340     for (i = 0; i < salvinfo->nVolumesInInodeFile; i++) {
1341         salvinfo->inodeSummary[i].volSummary = NULL;
1342     }
1343     Log("%d nVolumesInInodeFile %lu \n",salvinfo->nVolumesInInodeFile,(unsigned long)st_size);
1344     OS_CLOSE(summaryFile);
1345
1346  error:
1347     if (retcode && singleVolumeNumber && !deleted) {
1348         AskError(salvinfo, singleVolumeNumber);
1349     }
1350
1351     return retcode;
1352 }
1353
1354 /* Comparison routine for volume sort.
1355    This is setup so that a read-write volume comes immediately before
1356    any read-only clones of that volume */
1357 int
1358 CompareVolumes(const void *_p1, const void *_p2)
1359 {
1360     const struct VolumeSummary *p1 = _p1;
1361     const struct VolumeSummary *p2 = _p2;
1362     if (p1->header.parent != p2->header.parent)
1363         return p1->header.parent < p2->header.parent ? -1 : 1;
1364     if (p1->header.id == p1->header.parent)     /* p1 is rw volume */
1365         return -1;
1366     if (p2->header.id == p2->header.parent)     /* p2 is rw volume */
1367         return 1;
1368     return p1->header.id < p2->header.id ? -1 : 1;      /* Both read-only */
1369 }
1370
1371 /**
1372  * Gleans volumeSummary information by asking the fileserver
1373  *
1374  * @param[in] singleVolumeNumber  the volume we're salvaging. 0 if we're
1375  *                                salvaging a whole partition
1376  *
1377  * @return whether we obtained the volume summary information or not
1378  *  @retval 0  success; we obtained the volume summary information
1379  *  @retval -1 we raced with a fileserver restart; volume locks and checkout
1380  *             must be retried
1381  *  @retval 1  we did not get the volume summary information; either the
1382  *             fileserver responded with an error, or we are not supposed to
1383  *             ask the fileserver for the information (e.g. we are salvaging
1384  *             the entire partition or we are not the salvageserver)
1385  *
1386  * @note for non-DAFS, always returns 1
1387  */
1388 static int
1389 AskVolumeSummary(struct SalvInfo *salvinfo, VolumeId singleVolumeNumber)
1390 {
1391     afs_int32 code = 1;
1392 #if defined(FSSYNC_BUILD_CLIENT) && defined(AFS_DEMAND_ATTACH_FS)
1393     if (programType == salvageServer) {
1394         if (singleVolumeNumber) {
1395             FSSYNC_VGQry_response_t q_res;
1396             SYNC_response res;
1397             struct VolumeSummary *vsp;
1398             int i;
1399             struct VolumeDiskHeader diskHdr;
1400
1401             memset(&res, 0, sizeof(res));
1402
1403             code = FSYNC_VGCQuery(salvinfo->fileSysPartition->name, singleVolumeNumber, &q_res, &res);
1404
1405             /*
1406              * We must wait for the partition to finish scanning before
1407              * can continue, since we will not know if we got the entire
1408              * VG membership unless the partition is fully scanned.
1409              * We could, in theory, just scan the partition ourselves if
1410              * the VG cache is not ready, but we would be doing the exact
1411              * same scan the fileserver is doing; it will almost always
1412              * be faster to wait for the fileserver. The only exceptions
1413              * are if the partition does not take very long to scan, and
1414              * in that case it's fast either way, so who cares?
1415              */
1416             if (code == SYNC_FAILED && res.hdr.reason == FSYNC_PART_SCANNING) {
1417                 Log("waiting for fileserver to finish scanning partition %s...\n",
1418                     salvinfo->fileSysPartition->name);
1419
1420                 for (i = 1; code == SYNC_FAILED && res.hdr.reason == FSYNC_PART_SCANNING; i++) {
1421                     /* linearly ramp up from 1 to 10 seconds; nothing fancy,
1422                      * just so small partitions don't need to wait over 10
1423                      * seconds every time, and large partitions are generally
1424                      * polled only once every ten seconds. */
1425                     sleep((i > 10) ? (i = 10) : i);
1426
1427                     code = FSYNC_VGCQuery(salvinfo->fileSysPartition->name, singleVolumeNumber, &q_res, &res);
1428                 }
1429             }
1430
1431             if (code == SYNC_FAILED && res.hdr.reason == FSYNC_UNKNOWN_VOLID) {
1432                 /* This can happen if there's no header for the volume
1433                  * we're salvaging, or no headers exist for the VG (if
1434                  * we're salvaging an RW). Act as if we got a response
1435                  * with no VG members. The headers may be created during
1436                  * salvaging, if there are inodes in this VG. */
1437                 code = 0;
1438                 memset(&q_res, 0, sizeof(q_res));
1439                 q_res.rw = singleVolumeNumber;
1440             }
1441
1442             if (code) {
1443                 Log("fileserver refused VGCQuery request for volume %" AFS_VOLID_FMT " on "
1444                     "partition %s, code %ld reason %ld\n",
1445                     afs_printable_VolumeId_lu(singleVolumeNumber),
1446                     salvinfo->fileSysPartition->name,
1447                     afs_printable_int32_ld(code),
1448                     afs_printable_int32_ld(res.hdr.reason));
1449                 goto done;
1450             }
1451
1452             if (q_res.rw != singleVolumeNumber) {
1453                 Log("fileserver requested salvage of clone %" AFS_VOLID_FMT "; scheduling salvage of volume group %" AFS_VOLID_FMT "...\n",
1454                     afs_printable_VolumeId_lu(singleVolumeNumber),
1455                     afs_printable_VolumeId_lu(q_res.rw));
1456 #ifdef SALVSYNC_BUILD_CLIENT
1457                 if (SALVSYNC_LinkVolume(q_res.rw,
1458                                        singleVolumeNumber,
1459                                        salvinfo->fileSysPartition->name,
1460                                        NULL) != SYNC_OK) {
1461                     Log("schedule request failed\n");
1462                 }
1463 #endif /* SALVSYNC_BUILD_CLIENT */
1464                 Exit(SALSRV_EXIT_VOLGROUP_LINK);
1465             }
1466
1467             salvinfo->volumeSummaryp = calloc(VOL_VG_MAX_VOLS, sizeof(struct VolumeSummary));
1468             opr_Assert(salvinfo->volumeSummaryp != NULL);
1469
1470             salvinfo->nVolumes = 0;
1471             vsp = salvinfo->volumeSummaryp;
1472
1473             for (i = 0; i < VOL_VG_MAX_VOLS; i++) {
1474                 char name[VMAXPATHLEN];
1475
1476                 if (!q_res.children[i]) {
1477                     continue;
1478                 }
1479
1480                 /* AskOffline for singleVolumeNumber was called much earlier */
1481                 if (q_res.children[i] != singleVolumeNumber) {
1482                     AskOffline(salvinfo, q_res.children[i]);
1483                     if (LockVolume(salvinfo, q_res.children[i])) {
1484                         /* need to retry */
1485                         return -1;
1486                     }
1487                 }
1488
1489                 code = VReadVolumeDiskHeader(q_res.children[i], salvinfo->fileSysPartition, &diskHdr);
1490                 if (code) {
1491                     Log("Cannot read header for %lu; trying to salvage group anyway\n",
1492                         afs_printable_uint32_lu(q_res.children[i]));
1493                     code = 0;
1494                     continue;
1495                 }
1496
1497                 DiskToVolumeHeader(&vsp->header, &diskHdr);
1498                 VolumeExternalName_r(q_res.children[i], name, sizeof(name));
1499                 vsp->unused = 1;
1500                 salvinfo->nVolumes++;
1501                 vsp++;
1502             }
1503
1504             qsort(salvinfo->volumeSummaryp, salvinfo->nVolumes, sizeof(struct VolumeSummary),
1505                   CompareVolumes);
1506         }
1507       done:
1508         if (code) {
1509             Log("Cannot get volume summary from fileserver; falling back to scanning "
1510                 "entire partition\n");
1511         }
1512     }
1513 #endif /* FSSYNC_BUILD_CLIENT && AFS_DEMAND_ATTACH_FS */
1514     return code;
1515 }
1516
1517 /**
1518  * count how many volume headers are found by VWalkVolumeHeaders.
1519  *
1520  * @param[in] dp   the disk partition (unused)
1521  * @param[in] name full path to the .vol header (unused)
1522  * @param[in] hdr  the header data (unused)
1523  * @param[in] last whether this is the last try or not (unused)
1524  * @param[in] rock actually an afs_int32*; the running count of how many
1525  *                 volumes we have found
1526  *
1527  * @retval 0 always
1528  */
1529 static int
1530 CountHeader(struct DiskPartition64 *dp, const char *name,
1531             struct VolumeDiskHeader *hdr, int last, void *rock)
1532 {
1533     afs_int32 *nvols = (afs_int32 *)rock;
1534     (*nvols)++;
1535     return 0;
1536 }
1537
1538 /**
1539  * parameters to pass to the VWalkVolumeHeaders callbacks when recording volume
1540  * data.
1541  */
1542 struct SalvageScanParams {
1543     VolumeId singleVolumeNumber; /**< 0 for a partition-salvage, otherwise the
1544                                   * vol id of the VG we're salvaging */
1545     struct VolumeSummary *vsp;   /**< ptr to the current volume summary object
1546                                   * we're filling in */
1547     afs_int32 nVolumes;          /**< # of vols we've encountered */
1548     afs_int32 totalVolumes;      /**< max # of vols we should encounter (the
1549                                   * # of vols we've alloc'd memory for) */
1550     int retry;  /**< do we need to retry vol lock/checkout? */
1551     struct SalvInfo *salvinfo; /**< salvage job info */
1552 };
1553
1554 /**
1555  * records volume summary info found from VWalkVolumeHeaders.
1556  *
1557  * Found volumes are also taken offline if they are in the specific volume
1558  * group we are looking for.
1559  *
1560  * @param[in] dp   the disk partition
1561  * @param[in] name full path to the .vol header
1562  * @param[in] hdr  the header data
1563  * @param[in] last 1 if this is the last try to read the header, 0 otherwise
1564  * @param[in] rock actually a struct SalvageScanParams*, containing the
1565  *                 information needed to record the volume summary data
1566  *
1567  * @return operation status
1568  *  @retval 0  success
1569  *  @retval -1 volume locking raced with fileserver restart; checking out
1570  *             and locking volumes needs to be retried
1571  *  @retval 1  volume header is mis-named and should be deleted
1572  */
1573 static int
1574 RecordHeader(struct DiskPartition64 *dp, const char *name,
1575              struct VolumeDiskHeader *hdr, int last, void *rock)
1576 {
1577     char nameShouldBe[64];
1578     struct SalvageScanParams *params;
1579     struct VolumeSummary summary;
1580     VolumeId singleVolumeNumber;
1581     struct SalvInfo *salvinfo;
1582
1583     params = (struct SalvageScanParams *)rock;
1584
1585     memset(&summary, 0, sizeof(summary));
1586
1587     singleVolumeNumber = params->singleVolumeNumber;
1588     salvinfo = params->salvinfo;
1589
1590     DiskToVolumeHeader(&summary.header, hdr);
1591
1592     if (singleVolumeNumber && summary.header.id == singleVolumeNumber
1593         && summary.header.parent != singleVolumeNumber) {
1594
1595         if (programType == salvageServer) {
1596 #ifdef SALVSYNC_BUILD_CLIENT
1597             Log("fileserver requested salvage of clone %" AFS_VOLID_FMT "; scheduling salvage of volume group %" AFS_VOLID_FMT "...\n",
1598                 afs_printable_VolumeId_lu(summary.header.id),
1599                 afs_printable_VolumeId_lu(summary.header.parent));
1600             if (SALVSYNC_LinkVolume(summary.header.parent,
1601                                     summary.header.id,
1602                                     dp->name,
1603                                     NULL) != SYNC_OK) {
1604                 Log("schedule request failed\n");
1605             }
1606 #endif
1607             Exit(SALSRV_EXIT_VOLGROUP_LINK);
1608
1609         } else {
1610             Log("%" AFS_VOLID_FMT " is a read-only volume; not salvaged\n",
1611                 afs_printable_VolumeId_lu(singleVolumeNumber));
1612             Exit(1);
1613         }
1614     }
1615
1616     if (!singleVolumeNumber || summary.header.id == singleVolumeNumber
1617         || summary.header.parent == singleVolumeNumber) {
1618
1619         /* check if the header file is incorrectly named */
1620         int badname = 0;
1621         const char *base = strrchr(name, OS_DIRSEPC);
1622         if (base) {
1623             base++;
1624         } else {
1625             base = name;
1626         }
1627
1628         snprintf(nameShouldBe, sizeof nameShouldBe,
1629                  VFORMAT, afs_printable_VolumeId_lu(summary.header.id));
1630
1631
1632         if (strcmp(nameShouldBe, base)) {
1633             /* .vol file has wrong name; retry/delete */
1634             badname = 1;
1635         }
1636
1637         if (!badname || last) {
1638             /* only offline the volume if the header is good, or if this is
1639              * the last try looking at it; avoid AskOffline'ing the same vol
1640              * multiple times */
1641
1642             if (singleVolumeNumber
1643                 && summary.header.id != singleVolumeNumber) {
1644                 /* don't offline singleVolumeNumber; we already did that
1645                  * earlier */
1646
1647                 AskOffline(salvinfo, summary.header.id);
1648
1649 #ifdef AFS_DEMAND_ATTACH_FS
1650                 if (!badname) {
1651                     /* don't lock the volume if the header is bad, since we're
1652                      * about to delete it anyway. */
1653                     if (LockVolume(salvinfo, summary.header.id)) {
1654                         params->retry = 1;
1655                         return -1;
1656                     }
1657                 }
1658 #endif /* AFS_DEMAND_ATTACH_FS */
1659             }
1660         }
1661         if (badname) {
1662             if (last && !Showmode) {
1663                 Log("Volume header file %s is incorrectly named (should be %s "
1664                     "not %s); %sdeleted (it will be recreated later, if "
1665                     "necessary)\n", name, nameShouldBe, base,
1666                     (Testing ? "it would have been " : ""));
1667             }
1668             return 1;
1669         }
1670
1671         summary.unused = 1;
1672         params->nVolumes++;
1673
1674         if (params->nVolumes > params->totalVolumes) {
1675             /* We found more volumes than we found on the first partition walk;
1676              * apparently something created a volume while we were
1677              * partition-salvaging, or we found more than 20 vols when salvaging a
1678              * particular volume. Abort if we detect this, since other programs
1679              * supposed to not touch the partition while it is partition-salvaging,
1680              * and we shouldn't find more than 20 vols in a VG.
1681              */
1682             Abort("Found %ld vol headers, but should have found at most %ld! "
1683                   "Make sure the volserver/fileserver are not running at the "
1684                   "same time as a partition salvage\n",
1685                   afs_printable_int32_ld(params->nVolumes),
1686                   afs_printable_int32_ld(params->totalVolumes));
1687         }
1688
1689         memcpy(params->vsp, &summary, sizeof(summary));
1690         params->vsp++;
1691     }
1692
1693     return 0;
1694 }
1695
1696 /**
1697  * possibly unlinks bad volume headers found from VWalkVolumeHeaders.
1698  *
1699  * If the header could not be read in at all, the header is always unlinked.
1700  * If instead RecordHeader said the header was bad (that is, the header file
1701  * is mis-named), we only unlink if we are doing a partition salvage, as
1702  * opposed to salvaging a specific volume group.
1703  *
1704  * @param[in] dp   the disk partition
1705  * @param[in] name full path to the .vol header
1706  * @param[in] hdr  header data, or NULL if the header could not be read
1707  * @param[in] rock actually a struct SalvageScanParams*, with some information
1708  *                 about the scan
1709  */
1710 static void
1711 UnlinkHeader(struct DiskPartition64 *dp, const char *name,
1712              struct VolumeDiskHeader *hdr, void *rock)
1713 {
1714     struct SalvageScanParams *params;
1715     int dounlink = 0;
1716
1717     params = (struct SalvageScanParams *)rock;
1718
1719     if (!hdr) {
1720         /* no header; header is too bogus to read in at all */
1721         if (!Showmode) {
1722             Log("%s is not a legitimate volume header file; %sdeleted\n", name, (Testing ? "it would have been " : ""));
1723         }
1724         if (!Testing) {
1725             dounlink = 1;
1726         }
1727
1728     } else if (!params->singleVolumeNumber) {
1729         /* We were able to read in a header, but RecordHeader said something
1730          * was wrong with it. We only unlink those if we are doing a partition
1731          * salvage. */
1732         if (!Testing) {
1733             dounlink = 1;
1734         }
1735     }
1736
1737     if (dounlink && unlink(name)) {
1738         Log("Error %d while trying to unlink %s\n", errno, name);
1739     }
1740 }
1741
1742 /**
1743  * Populates salvinfo->volumeSummaryp with volume summary information, either by asking
1744  * the fileserver for VG information, or by scanning the /vicepX partition.
1745  *
1746  * @param[in] singleVolumeNumber  the volume ID of the single volume group we
1747  *                                are salvaging, or 0 if this is a partition
1748  *                                salvage
1749  *
1750  * @return operation status
1751  *  @retval 0  success
1752  *  @retval -1 we raced with a fileserver restart; checking out and locking
1753  *             volumes must be retried
1754  */
1755 int
1756 GetVolumeSummary(struct SalvInfo *salvinfo, VolumeId singleVolumeNumber)
1757 {
1758     afs_int32 nvols = 0;
1759     struct SalvageScanParams params;
1760     int code;
1761
1762     code = AskVolumeSummary(salvinfo, singleVolumeNumber);
1763     if (code == 0) {
1764         /* we successfully got the vol information from the fileserver; no
1765          * need to scan the partition */
1766         return 0;
1767     }
1768     if (code < 0) {
1769         /* we need to retry volume checkout */
1770         return code;
1771     }
1772
1773     if (!singleVolumeNumber) {
1774         /* Count how many volumes we have in /vicepX */
1775         code = VWalkVolumeHeaders(salvinfo->fileSysPartition, salvinfo->fileSysPath, CountHeader,
1776                                   NULL, &nvols);
1777         if (code < 0) {
1778             Abort("Can't read directory %s; not salvaged\n", salvinfo->fileSysPath);
1779         }
1780         if (!nvols)
1781             nvols = 1;
1782     } else {
1783         nvols = VOL_VG_MAX_VOLS;
1784     }
1785
1786     salvinfo->volumeSummaryp = calloc(nvols, sizeof(struct VolumeSummary));
1787     opr_Assert(salvinfo->volumeSummaryp != NULL);
1788
1789     params.singleVolumeNumber = singleVolumeNumber;
1790     params.vsp = salvinfo->volumeSummaryp;
1791     params.nVolumes = 0;
1792     params.totalVolumes = nvols;
1793     params.retry = 0;
1794     params.salvinfo = salvinfo;
1795
1796     /* walk the partition directory of volume headers and record the info
1797      * about them; unlinking invalid headers */
1798     code = VWalkVolumeHeaders(salvinfo->fileSysPartition, salvinfo->fileSysPath, RecordHeader,
1799                               UnlinkHeader, &params);
1800     if (params.retry) {
1801         /* we apparently need to retry checking-out/locking volumes */
1802         return -1;
1803     }
1804     if (code < 0) {
1805         Abort("Failed to get volume header summary\n");
1806     }
1807     salvinfo->nVolumes = params.nVolumes;
1808
1809     qsort(salvinfo->volumeSummaryp, salvinfo->nVolumes, sizeof(struct VolumeSummary),
1810           CompareVolumes);
1811
1812     return 0;
1813 }
1814
1815 #ifdef AFS_NAMEI_ENV
1816 /* Find the link table. This should be associated with the RW volume, even
1817  * if there is only an RO volume at this site.
1818  */
1819 static Inode
1820 FindLinkHandle(struct InodeSummary *isp, int nVols,
1821                struct ViceInodeInfo *allInodes)
1822 {
1823     int i, j;
1824     struct ViceInodeInfo *ip;
1825
1826     for (i = 0; i < nVols; i++) {
1827         ip = allInodes + isp[i].index;
1828         for (j = 0; j < isp[i].nSpecialInodes; j++) {
1829             if (ip[j].u.special.volumeId == isp->RWvolumeId &&
1830                 ip[j].u.special.parentId == isp->RWvolumeId &&
1831                 ip[j].u.special.type == VI_LINKTABLE) {
1832                 return ip[j].inodeNumber;
1833             }
1834         }
1835     }
1836     return (Inode) - 1;
1837 }
1838
1839 static int
1840 CheckDupLinktable(struct SalvInfo *salvinfo, struct InodeSummary *isp, struct ViceInodeInfo *ip)
1841 {
1842     afs_ino_str_t stmp;
1843     if (ip->u.vnode.vnodeNumber != INODESPECIAL) {
1844         /* not a linktable; process as a normal file */
1845         return 0;
1846     }
1847     if (ip->u.special.type != VI_LINKTABLE) {
1848         /* not a linktable; process as a normal file */
1849         return 0;
1850     }
1851
1852     /* make sure nothing inc/decs it */
1853     ip->linkCount = 0;
1854
1855     if (ip->u.special.volumeId == ip->u.special.parentId) {
1856         /* This is a little weird, but shouldn't break anything, and there is
1857          * no known way that this can happen; just do nothing, in case deleting
1858          * it would screw something up. */
1859         Log("Inode %s appears to be a valid linktable for id (%u), but it's not\n",
1860             PrintInode(stmp, ip->inodeNumber), ip->u.special.parentId);
1861         Log("the linktable for our volume group (%u). This is unusual, since\n",
1862             isp->RWvolumeId);
1863         Log("there should only be one linktable per volume group. I'm leaving\n");
1864         Log("it alone, just to be safe.\n");
1865         return -1;
1866     }
1867
1868     Log("Linktable %s appears to be invalid (parentid/volumeid mismatch: %u != %u)\n",
1869         PrintInode(stmp, ip->inodeNumber), ip->u.special.parentId, ip->u.special.volumeId);
1870     if (Testing) {
1871         Log("Would have deleted linktable inode %s\n", PrintInode(stmp, ip->inodeNumber));
1872     } else {
1873         IHandle_t *tmpH;
1874         namei_t ufs_name;
1875
1876         Log("Deleting linktable inode %s\n", PrintInode(stmp, ip->inodeNumber));
1877         IH_INIT(tmpH, salvinfo->fileSysDevice, isp->RWvolumeId, ip->inodeNumber);
1878         namei_HandleToName(&ufs_name, tmpH);
1879         if (unlink(ufs_name.n_path) < 0) {
1880             Log("Error %d unlinking path %s\n", errno, ufs_name.n_path);
1881         }
1882     }
1883
1884     return -1;
1885 }
1886 #endif
1887
1888 int
1889 CreateLinkTable(struct SalvInfo *salvinfo, struct InodeSummary *isp, Inode ino)
1890 {
1891     struct versionStamp version;
1892     FdHandle_t *fdP;
1893
1894     if (!VALID_INO(ino))
1895         ino =
1896             IH_CREATE(NULL, salvinfo->fileSysDevice, salvinfo->fileSysPath, 0, isp->RWvolumeId,
1897                       INODESPECIAL, VI_LINKTABLE, isp->RWvolumeId);
1898     if (!VALID_INO(ino))
1899         Abort
1900             ("Unable to allocate link table inode for volume %" AFS_VOLID_FMT " (error = %d)\n",
1901              afs_printable_VolumeId_lu(isp->RWvolumeId), errno);
1902     IH_INIT(salvinfo->VGLinkH, salvinfo->fileSysDevice, isp->RWvolumeId, ino);
1903     fdP = IH_OPEN(salvinfo->VGLinkH);
1904     if (fdP == NULL)
1905         Abort("Can't open link table for volume %" AFS_VOLID_FMT " (error = %d)\n",
1906               afs_printable_VolumeId_lu(isp->RWvolumeId), errno);
1907
1908     if (FDH_TRUNC(fdP, sizeof(version) + sizeof(short)) < 0)
1909         Abort("Can't truncate link table for volume %" AFS_VOLID_FMT " (error = %d)\n",
1910               afs_printable_VolumeId_lu(isp->RWvolumeId), errno);
1911
1912     version.magic = LINKTABLEMAGIC;
1913     version.version = LINKTABLEVERSION;
1914
1915     if (FDH_PWRITE(fdP, (char *)&version, sizeof(version), 0)
1916         != sizeof(version))
1917         Abort("Can't truncate link table for volume %" AFS_VOLID_FMT " (error = %d)\n",
1918               afs_printable_VolumeId_lu(isp->RWvolumeId), errno);
1919
1920     FDH_REALLYCLOSE(fdP);
1921
1922     /* If the volume summary exits (i.e.,  the V*.vol header file exists),
1923      * then set this inode there as well.
1924      */
1925     if (isp->volSummary)
1926         isp->volSummary->header.linkTable = ino;
1927
1928     return 0;
1929 }
1930
1931 #ifdef AFS_NT40_ENV
1932 void *
1933 nt_SVG(void *arg)
1934 {
1935     SVGParms_t *parms = (SVGParms_t *) arg;
1936     DoSalvageVolumeGroup(parms->svgp_salvinfo, parms->svgp_inodeSummaryp, parms->svgp_count);
1937     return NULL;
1938 }
1939
1940 void
1941 nt_SalvageVolumeGroup(struct SalvInfo *salvinfo, struct InodeSummary *isp, int nVols)
1942 {
1943     pthread_t tid;
1944     pthread_attr_t tattr;
1945     int code;
1946     SVGParms_t parms;
1947
1948     /* Initialize per volume global variables, even if later code does so */
1949     salvinfo->VolumeChanged = 0;
1950     salvinfo->VGLinkH = NULL;
1951     salvinfo->VGLinkH_cnt = 0;
1952     memset(&salvinfo->VolInfo, 0, sizeof(salvinfo->VolInfo));
1953
1954     parms.svgp_inodeSummaryp = isp;
1955     parms.svgp_count = nVols;
1956     parms.svgp_salvinfo = salvinfo;
1957     code = pthread_attr_init(&tattr);
1958     if (code) {
1959         Log("Failed to salvage volume group %u: pthread_attr_init()\n",
1960             isp->RWvolumeId);
1961         return;
1962     }
1963     code = pthread_attr_setdetachstate(&tattr, PTHREAD_CREATE_JOINABLE);
1964     if (code) {
1965         Log("Failed to salvage volume group %u: pthread_attr_setdetachstate()\n", isp->RWvolumeId);
1966         return;
1967     }
1968     code = pthread_create(&tid, &tattr, nt_SVG, &parms);
1969     if (code) {
1970         Log("Failed to create thread to salvage volume group %u\n",
1971             isp->RWvolumeId);
1972         return;
1973     }
1974     (void)pthread_join(tid, NULL);
1975 }
1976 #endif /* AFS_NT40_ENV */
1977
1978 void
1979 DoSalvageVolumeGroup(struct SalvInfo *salvinfo, struct InodeSummary *isp, int nVols)
1980 {
1981     struct ViceInodeInfo *inodes, *allInodes, *ip;
1982     int i, totalInodes, size, salvageTo;
1983     int haveRWvolume;
1984     int check;
1985     Inode ino;
1986     int dec_VGLinkH = 0;
1987     int VGLinkH_p1 =0;
1988     FdHandle_t *fdP = NULL;
1989
1990     salvinfo->VGLinkH_cnt = 0;
1991     haveRWvolume = (isp->volumeId == isp->RWvolumeId
1992                     && isp->nSpecialInodes > 0);
1993     if ((!ShowMounts) || (ShowMounts && !haveRWvolume)) {
1994         if (!ForceSalvage && QuickCheck(salvinfo, isp, nVols))
1995             return;
1996     }
1997     if (ShowMounts && !haveRWvolume)
1998         return;
1999     if (canfork && !debug && Fork() != 0) {
2000         (void)Wait("Salvage volume group");
2001         return;
2002     }
2003     for (i = 0, totalInodes = 0; i < nVols; i++)
2004         totalInodes += isp[i].nInodes;
2005     size = totalInodes * sizeof(struct ViceInodeInfo);
2006     inodes = malloc(size);
2007     allInodes = inodes - isp->index;    /* this would the base of all the inodes
2008                                          * for the partition, if all the inodes
2009                                          * had been read into memory */
2010     opr_Verify(OS_SEEK
2011            (salvinfo->inodeFd, isp->index * sizeof(struct ViceInodeInfo),
2012             SEEK_SET) != -1);
2013     opr_Verify(OS_READ(salvinfo->inodeFd, inodes, size) == size);
2014
2015     /* Don't try to salvage a read write volume if there isn't one on this
2016      * partition */
2017     salvageTo = haveRWvolume ? 0 : 1;
2018
2019 #ifdef AFS_NAMEI_ENV
2020     ino = FindLinkHandle(isp, nVols, allInodes);
2021     if (VALID_INO(ino)) {
2022         IH_INIT(salvinfo->VGLinkH, salvinfo->fileSysDevice, isp->RWvolumeId, ino);
2023         fdP = IH_OPEN(salvinfo->VGLinkH);
2024     }
2025     if (VALID_INO(ino) && fdP != NULL) {
2026         struct versionStamp header;
2027         afs_sfsize_t nBytes;
2028
2029         nBytes = FDH_PREAD(fdP, (char *)&header, sizeof(struct versionStamp), 0);
2030         if (nBytes != sizeof(struct versionStamp)
2031             || header.magic != LINKTABLEMAGIC) {
2032             Log("Bad linktable header for volume %" AFS_VOLID_FMT ".\n", afs_printable_VolumeId_lu(isp->RWvolumeId));
2033             FDH_REALLYCLOSE(fdP);
2034             fdP = NULL;
2035         }
2036     }
2037     if (!VALID_INO(ino) || fdP == NULL) {
2038         Log("%s link table for volume %" AFS_VOLID_FMT ".\n",
2039             Testing ? "Would have recreated" : "Recreating", afs_printable_VolumeId_lu(isp->RWvolumeId));
2040         if (Testing) {
2041             IH_INIT(salvinfo->VGLinkH, salvinfo->fileSysDevice, -1, -1);
2042         } else {
2043             int i, j;
2044             struct ViceInodeInfo *ip;
2045             CreateLinkTable(salvinfo, isp, ino);
2046             fdP = IH_OPEN(salvinfo->VGLinkH);
2047             /* Sync fake 1 link counts to the link table, now that it exists */
2048             if (fdP) {
2049                 for (i = 0; i < nVols; i++) {
2050                     ip = allInodes + isp[i].index;
2051                     for (j = isp[i].nSpecialInodes; j < isp[i].nInodes; j++) {
2052                         namei_SetLinkCount(fdP, ip[j].inodeNumber, 1, 0);
2053                         ip[j].linkCount = 1;
2054                     }
2055                 }
2056             }
2057         }
2058     }
2059     if (fdP)
2060         FDH_REALLYCLOSE(fdP);
2061 #else
2062     IH_INIT(salvinfo->VGLinkH, salvinfo->fileSysDevice, -1, -1);
2063 #endif
2064
2065     /* Salvage in reverse order--read/write volume last; this way any
2066      * Inodes not referenced by the time we salvage the read/write volume
2067      * can be picked up by the read/write volume */
2068     /* ACTUALLY, that's not done right now--the inodes just vanish */
2069     for (i = nVols - 1; i >= salvageTo; i--) {
2070         int rw = (i == 0);
2071         struct InodeSummary *lisp = &isp[i];
2072 #ifdef AFS_NAMEI_ENV
2073         if (rw && (nVols > 1 || isp[i].nSpecialInodes == isp[i].nInodes)) {
2074             /* If nVols > 1, we have more than one vol in this volgroup, so
2075              * the RW inodes we detected may just be for the linktable, and
2076              * there is no actual RW volume.
2077              *
2078              * Additionally, if we only have linktable inodes (no other
2079              * special inodes, no data inodes), there is also no actual RW
2080              * volume to salvage; this is just cruft left behind by something
2081              * else. In that case nVols will only be 1, though, so also
2082              * perform this linktables-only check if we don't have any
2083              * non-special inodes. */
2084             int inode_i;
2085             int all_linktables = 1;
2086             for (inode_i = 0; inode_i < isp[i].nSpecialInodes; inode_i++) {
2087                 if (inodes[inode_i].u.special.type != VI_LINKTABLE) {
2088                     all_linktables = 0;
2089                     break;
2090                 }
2091             }
2092             if (all_linktables) {
2093                 /* All we have are linktable special inodes, so skip salvaging
2094                  * the RW; there was never an RW volume here. If we don't do
2095                  * this, we risk creating a new "phantom" RW that the VLDB
2096                  * doesn't know about, which is confusing and can cause
2097                  * problems. */
2098                  haveRWvolume = 0;
2099                  continue;
2100             }
2101         }
2102 #endif
2103         if (!Showmode)
2104             Log("%s VOLUME %" AFS_VOLID_FMT "%s.\n", rw ? "SALVAGING" : "CHECKING CLONED",
2105                 afs_printable_VolumeId_lu(lisp->volumeId), (Testing ? "(READONLY mode)" : ""));
2106         /* Check inodes twice.  The second time do things seriously.  This
2107          * way the whole RO volume can be deleted, below, if anything goes wrong */
2108         for (check = 1; check >= 0; check--) {
2109             int deleteMe;
2110             if (SalvageVolumeHeaderFile(salvinfo, lisp, allInodes, rw, check, &deleteMe)
2111                 == -1) {
2112                 MaybeZapVolume(salvinfo, lisp, "Volume header", deleteMe, check);
2113                 if (rw && deleteMe) {
2114                     haveRWvolume = 0;   /* This will cause its inodes to be deleted--since salvage
2115                                          * volume won't be called */
2116                     break;
2117                 }
2118                 if (!rw)
2119                     break;
2120             }
2121             if (rw && check == 1)
2122                 continue;
2123             if (SalvageVnodes(salvinfo, isp, lisp, allInodes, check) == -1) {
2124                 MaybeZapVolume(salvinfo, lisp, "Vnode index", 0, check);
2125                 break;
2126             }
2127         }
2128     }
2129
2130     /* Fix actual inode counts */
2131     if (!Showmode) {
2132         afs_ino_str_t stmp;
2133         Log("totalInodes %d\n",totalInodes);
2134         for (ip = inodes; totalInodes; ip++, totalInodes--) {
2135             static int TraceBadLinkCounts = 0;
2136 #ifdef AFS_NAMEI_ENV
2137             if (salvinfo->VGLinkH->ih_ino == ip->inodeNumber) {
2138                 dec_VGLinkH = ip->linkCount - salvinfo->VGLinkH_cnt;
2139                 VGLinkH_p1 = ip->u.param[0];
2140                 continue;       /* Deal with this last. */
2141             } else if (CheckDupLinktable(salvinfo, isp, ip)) {
2142                 /* Don't touch this inode; CheckDupLinktable has handled it */
2143                 continue;
2144             }
2145 #endif
2146             if (ip->linkCount != 0 && TraceBadLinkCounts) {
2147                 TraceBadLinkCounts--;   /* Limit reports, per volume */
2148                 Log("#### DEBUG #### Link count incorrect by %d; inode %s, size %llu, p=(%u,%u,%u,%u)\n", ip->linkCount, PrintInode(stmp, ip->inodeNumber), (afs_uintmax_t) ip->byteCount, ip->u.param[0], ip->u.param[1], ip->u.param[2], ip->u.param[3]); /* VolumeId in param */
2149             }
2150
2151             /* If ip->linkCount is non-zero at this point, then the linkcount
2152              * for the inode on disk is wrong. Initially linkCount is set to
2153              * the actual link count of the inode on disk, and then we (the
2154              * salvager) decrement it for every reference to that inode that we
2155              * find. So if linkCount is still positive by this point, it means
2156              * that the linkcount on disk is too high, so we should DEC the
2157              * inode. If linkCount is negative, it means the linkcount is too
2158              * low, so we should INC the inode.
2159              *
2160              * If we get an error while INC'ing or DEC'ing, that's a little
2161              * odd and indicates a bug, but try to continue anyway, so the
2162              * volume may still be made accessible. */
2163             while (ip->linkCount > 0) {
2164                 if (!Testing) {
2165                     if (IH_DEC(salvinfo->VGLinkH, ip->inodeNumber, ip->u.param[0])) {
2166                         Log("idec failed. inode %s errno %d\n",
2167                             PrintInode(stmp, ip->inodeNumber), errno);
2168                         break;
2169                     }
2170                 }
2171                 ip->linkCount--;
2172             }
2173             while (ip->linkCount < 0) {
2174                 if (!Testing) {
2175                     if (IH_INC(salvinfo->VGLinkH, ip->inodeNumber, ip->u.param[0])) {
2176                         Log("iinc failed. inode %s errno %d\n",
2177                             PrintInode(stmp, ip->inodeNumber), errno);
2178                         break;
2179                     }
2180                 }
2181                 ip->linkCount++;
2182             }
2183         }
2184 #ifdef AFS_NAMEI_ENV
2185         while (dec_VGLinkH > 0) {
2186             if (IH_DEC(salvinfo->VGLinkH, salvinfo->VGLinkH->ih_ino, VGLinkH_p1) < 0) {
2187                 Log("idec failed on link table, errno = %d\n", errno);
2188             }
2189             dec_VGLinkH--;
2190         }
2191         while (dec_VGLinkH < 0) {
2192             if (IH_INC(salvinfo->VGLinkH, salvinfo->VGLinkH->ih_ino, VGLinkH_p1) < 0) {
2193                 Log("iinc failed on link table, errno = %d\n", errno);
2194             }
2195             dec_VGLinkH++;
2196         }
2197 #endif
2198     }
2199     free(inodes);
2200     /* Directory consistency checks on the rw volume */
2201     if (haveRWvolume)
2202         SalvageVolume(salvinfo, isp, salvinfo->VGLinkH);
2203     IH_RELEASE(salvinfo->VGLinkH);
2204
2205     if (canfork && !debug) {
2206         QuietExit(0);
2207     }
2208 }
2209
2210 int
2211 QuickCheck(struct SalvInfo *salvinfo, struct InodeSummary *isp, int nVols)
2212 {
2213     /* Check headers BEFORE forking */
2214     int i;
2215     IHandle_t *h;
2216
2217     for (i = 0; i < nVols; i++) {
2218         struct VolumeSummary *vs = isp[i].volSummary;
2219         VolumeDiskData volHeader;
2220         if (!vs) {
2221             /* Don't salvage just because phantom rw volume is there... */
2222             /* (If a read-only volume exists, read/write inodes must also exist) */
2223             if (i == 0 && isp->nSpecialInodes == 0 && nVols > 1)
2224                 continue;
2225             return 0;
2226         }
2227         IH_INIT(h, salvinfo->fileSysDevice, vs->header.parent, vs->header.volumeInfo);
2228         if (IH_IREAD(h, 0, (char *)&volHeader, sizeof(volHeader))
2229             == sizeof(volHeader)
2230             && volHeader.stamp.magic == VOLUMEINFOMAGIC
2231             && volHeader.dontSalvage == DONT_SALVAGE
2232             && volHeader.needsSalvaged == 0 && volHeader.destroyMe == 0) {
2233             if (volHeader.inUse != 0) {
2234                 volHeader.inUse = 0;
2235                 volHeader.inService = 1;
2236                 if (!Testing) {
2237                     if (IH_IWRITE(h, 0, (char *)&volHeader, sizeof(volHeader))
2238                         != sizeof(volHeader)) {
2239                         IH_RELEASE(h);
2240                         return 0;
2241                     }
2242                 }
2243             }
2244             IH_RELEASE(h);
2245         } else {
2246             IH_RELEASE(h);
2247             return 0;
2248         }
2249     }
2250     return 1;
2251 }
2252
2253
2254 /* SalvageVolumeHeaderFile
2255  *
2256  * Salvage the top level V*.vol header file. Make sure the special files
2257  * exist and that there are no duplicates.
2258  *
2259  * Calls SalvageHeader for each possible type of volume special file.
2260  */
2261
2262 int
2263 SalvageVolumeHeaderFile(struct SalvInfo *salvinfo, struct InodeSummary *isp,
2264                         struct ViceInodeInfo *inodes, int RW,
2265                         int check, int *deleteMe)
2266 {
2267     int i;
2268     struct ViceInodeInfo *ip;
2269     int allinodesobsolete = 1;
2270     struct VolumeDiskHeader diskHeader;
2271     afs_int32 (*writefunc)(VolumeDiskHeader_t *, struct DiskPartition64 *) = NULL;
2272     int *skip;
2273     struct VolumeHeader tempHeader;
2274     struct afs_inode_info stuff[MAXINODETYPE];
2275
2276     /* keeps track of special inodes that are probably 'good'; they are
2277      * referenced in the vol header, and are included in the given inodes
2278      * array */
2279     struct {
2280         int valid;
2281         Inode inode;
2282     } goodspecial[MAXINODETYPE];
2283
2284     if (deleteMe)
2285         *deleteMe = 0;
2286
2287     memset(goodspecial, 0, sizeof(goodspecial));
2288
2289     skip = calloc(isp->nSpecialInodes, sizeof(*skip));
2290     if (skip == NULL) {
2291         Log("cannot allocate memory for inode skip array when salvaging "
2292             "volume %lu; not performing duplicate special inode recovery\n",
2293             afs_printable_uint32_lu(isp->volumeId));
2294         /* still try to perform the salvage; the skip array only does anything
2295          * if we detect duplicate special inodes */
2296     }
2297
2298     init_inode_info(&tempHeader, stuff);
2299
2300     /*
2301      * First, look at the special inodes and see if any are referenced by
2302      * the existing volume header. If we find duplicate special inodes, we
2303      * can use this information to use the referenced inode (it's more
2304      * likely to be the 'good' one), and throw away the duplicates.
2305      */
2306     if (isp->volSummary && skip) {
2307         /* use tempHeader, so we can use the stuff[] array to easily index
2308          * into the isp->volSummary special inodes */
2309         memcpy(&tempHeader, &isp->volSummary->header, sizeof(struct VolumeHeader));
2310
2311         for (i = 0; i < isp->nSpecialInodes; i++) {
2312             ip = &inodes[isp->index + i];
2313             if (ip->u.special.type <= 0 || ip->u.special.type > MAXINODETYPE) {
2314                 /* will get taken care of in a later loop */
2315                 continue;
2316             }
2317             if (ip->inodeNumber == *(stuff[ip->u.special.type - 1].inode)) {
2318                 goodspecial[ip->u.special.type-1].valid = 1;
2319                 goodspecial[ip->u.special.type-1].inode = ip->inodeNumber;
2320             }
2321         }
2322     }
2323
2324     memset(&tempHeader, 0, sizeof(tempHeader));
2325     tempHeader.stamp.magic = VOLUMEHEADERMAGIC;
2326     tempHeader.stamp.version = VOLUMEHEADERVERSION;
2327     tempHeader.id = isp->volumeId;
2328     tempHeader.parent = isp->RWvolumeId;
2329
2330     /* Check for duplicates (inodes are sorted by type field) */
2331     for (i = 0; i < isp->nSpecialInodes - 1; i++) {
2332         ip = &inodes[isp->index + i];
2333         if (ip->u.special.type == (ip + 1)->u.special.type) {
2334             afs_ino_str_t stmp1, stmp2;
2335
2336             if (ip->u.special.type <= 0 || ip->u.special.type > MAXINODETYPE) {
2337                 /* Will be caught in the loop below */
2338                 continue;
2339             }
2340             if (!Showmode) {
2341                 Log("Duplicate special %d inodes for volume %" AFS_VOLID_FMT " found (%s, %s);\n",
2342                     ip->u.special.type, afs_printable_VolumeId_lu(isp->volumeId),
2343                     PrintInode(stmp1, ip->inodeNumber),
2344                     PrintInode(stmp2, (ip+1)->inodeNumber));
2345             }
2346             if (skip && goodspecial[ip->u.special.type-1].valid) {
2347                 Inode gi = goodspecial[ip->u.special.type-1].inode;
2348
2349                 if (!Showmode) {
2350                     Log("using special inode referenced by vol header (%s)\n",
2351                         PrintInode(stmp1, gi));
2352                 }
2353
2354                 /* the volume header references some special inode of
2355                  * this type in the inodes array; are we it? */
2356                 if (ip->inodeNumber != gi) {
2357                     skip[i] = 1;
2358                 } else if ((ip+1)->inodeNumber != gi) {
2359                     /* in case this is the last iteration; we need to
2360                      * make sure we check ip+1, too */
2361                     skip[i+1] = 1;
2362                 }
2363             } else {
2364                 if (!Showmode)
2365                     Log("cannot determine which is correct; salvage of volume %" AFS_VOLID_FMT " aborted\n", afs_printable_VolumeId_lu(isp->volumeId));
2366                 if (skip) {
2367                     free(skip);
2368                 }
2369                 return -1;
2370             }
2371         }
2372     }
2373     for (i = 0; i < isp->nSpecialInodes; i++) {
2374         afs_ino_str_t stmp;
2375         ip = &inodes[isp->index + i];
2376         if (ip->u.special.type <= 0 || ip->u.special.type > MAXINODETYPE) {
2377             if (check) {
2378                 Log("Rubbish header inode %s of type %d\n",
2379                     PrintInode(stmp, ip->inodeNumber),
2380                     ip->u.special.type);
2381                 if (skip) {
2382                     free(skip);
2383                 }
2384                 return -1;
2385             }
2386             Log("Rubbish header inode %s of type %d; deleted\n",
2387                 PrintInode(stmp, ip->inodeNumber),
2388                 ip->u.special.type);
2389         } else if (!stuff[ip->u.special.type - 1].obsolete) {
2390             if (skip && skip[i]) {
2391                 if (orphans == ORPH_REMOVE) {
2392                     Log("Removing orphan special inode %s of type %d\n",
2393                         PrintInode(stmp, ip->inodeNumber), ip->u.special.type);
2394                     continue;
2395                 } else {
2396                     Log("Ignoring orphan special inode %s of type %d\n",
2397                         PrintInode(stmp, ip->inodeNumber), ip->u.special.type);
2398                     /* fall through to the ip->linkCount--; line below */
2399                 }
2400             } else {
2401                 *(stuff[ip->u.special.type - 1].inode) = ip->inodeNumber;
2402                 allinodesobsolete = 0;
2403             }
2404             if (!check && ip->u.special.type != VI_LINKTABLE)
2405                 ip->linkCount--;        /* Keep the inode around */
2406         }
2407     }
2408     if (skip) {
2409         free(skip);
2410     }
2411     skip = NULL;
2412
2413     if (allinodesobsolete) {
2414         if (deleteMe)
2415             *deleteMe = 1;
2416         return -1;
2417     }
2418
2419     if (!check)
2420         salvinfo->VGLinkH_cnt++;                /* one for every header. */
2421
2422     if (!RW && !check && isp->volSummary) {
2423         ClearROInUseBit(isp->volSummary);
2424         return 0;
2425     }
2426
2427     for (i = 0; i < MAXINODETYPE; i++) {
2428         if (stuff[i].inodeType == VI_LINKTABLE) {
2429             /* Gross hack: SalvageHeader does a bcmp on the volume header.
2430              * And we may have recreated the link table earlier, so set the
2431              * RW header as well. The header magic was already checked.
2432              */
2433             if (VALID_INO(salvinfo->VGLinkH->ih_ino)) {
2434                 *stuff[i].inode = salvinfo->VGLinkH->ih_ino;
2435             }
2436             continue;
2437         }
2438         if (SalvageHeader(salvinfo, &stuff[i], isp, check, deleteMe) == -1 && check)
2439             return -1;
2440     }
2441
2442     if (isp->volSummary == NULL) {
2443         char path[VMAXPATHLEN];
2444         char headerName[64];
2445         snprintf(headerName, sizeof headerName, VFORMAT,
2446                  afs_printable_VolumeId_lu(isp->volumeId));
2447         snprintf(path, sizeof path, "%s" OS_DIRSEP "%s",
2448                  salvinfo->fileSysPath, headerName);
2449         if (check) {
2450             Log("No header file for volume %" AFS_VOLID_FMT "\n", afs_printable_VolumeId_lu(isp->volumeId));
2451             return -1;
2452         }
2453         if (!Showmode)
2454             Log("No header file for volume %" AFS_VOLID_FMT "; %screating %s\n",
2455                 afs_printable_VolumeId_lu(isp->volumeId), (Testing ? "it would have been " : ""),
2456                 path);
2457         isp->volSummary = calloc(1, sizeof(struct VolumeSummary));
2458
2459         writefunc = VCreateVolumeDiskHeader;
2460     } else {
2461         char path[VMAXPATHLEN];
2462         char headerName[64];
2463         /* hack: these two fields are obsolete... */
2464         isp->volSummary->header.volumeAcl = 0;
2465         isp->volSummary->header.volumeMountTable = 0;
2466
2467         if (memcmp
2468             (&isp->volSummary->header, &tempHeader,
2469              sizeof(struct VolumeHeader))) {
2470             VolumeExternalName_r(isp->volumeId, headerName, sizeof(headerName));
2471             snprintf(path, sizeof path, "%s" OS_DIRSEP "%s",
2472                      salvinfo->fileSysPath, headerName);
2473
2474             Log("Header file %s is damaged or no longer valid%s\n", path,
2475                 (check ? "" : "; repairing"));
2476             if (check)
2477                 return -1;
2478
2479             writefunc = VWriteVolumeDiskHeader;
2480         }
2481     }
2482     if (writefunc) {
2483         memcpy(&isp->volSummary->header, &tempHeader,
2484                sizeof(struct VolumeHeader));
2485         if (Testing) {
2486             if (!Showmode)
2487                 Log("It would have written a new header file for volume %" AFS_VOLID_FMT "\n",
2488                     afs_printable_VolumeId_lu(isp->volumeId));
2489         } else {
2490             afs_int32 code;
2491             VolumeHeaderToDisk(&diskHeader, &tempHeader);
2492             code = (*writefunc)(&diskHeader, salvinfo->fileSysPartition);
2493             if (code) {
2494                 Log("Error %ld writing volume header file for volume %" AFS_VOLID_FMT "\n",
2495                     afs_printable_int32_ld(code),
2496                     afs_printable_VolumeId_lu(diskHeader.id));
2497                 return -1;
2498             }
2499         }
2500     }
2501     IH_INIT(isp->volSummary->volumeInfoHandle, salvinfo->fileSysDevice, isp->RWvolumeId,
2502             isp->volSummary->header.volumeInfo);
2503     return 0;
2504 }
2505
2506 int
2507 SalvageHeader(struct SalvInfo *salvinfo, struct afs_inode_info *sp,
2508               struct InodeSummary *isp, int check, int *deleteMe)
2509 {
2510     union {
2511         VolumeDiskData volumeInfo;
2512         struct versionStamp fileHeader;
2513     } header;
2514     IHandle_t *specH;
2515     int recreate = 0;
2516     ssize_t nBytes;
2517     FdHandle_t *fdP;
2518
2519     if (sp->obsolete)
2520         return 0;
2521 #ifndef AFS_NAMEI_ENV
2522     if (sp->inodeType == VI_LINKTABLE)
2523         return 0; /* header magic was already checked */
2524 #endif
2525     if (*(sp->inode) == 0) {
2526         if (check) {
2527             Log("Missing inode in volume header (%s)\n", sp->description);
2528             return -1;
2529         }
2530         if (!Showmode)
2531             Log("Missing inode in volume header (%s); %s\n", sp->description,
2532                 (Testing ? "it would have recreated it" : "recreating"));
2533         if (!Testing) {
2534             *(sp->inode) =
2535                 IH_CREATE(NULL, salvinfo->fileSysDevice, salvinfo->fileSysPath, 0, isp->volumeId,
2536                           INODESPECIAL, sp->inodeType, isp->RWvolumeId);
2537             if (!VALID_INO(*(sp->inode)))
2538                 Abort
2539                     ("Unable to allocate inode (%s) for volume header (error = %d)\n",
2540                      sp->description, errno);
2541         }
2542         recreate = 1;
2543     }
2544
2545     IH_INIT(specH, salvinfo->fileSysDevice, isp->RWvolumeId, *(sp->inode));
2546     fdP = IH_OPEN(specH);
2547     if (OKToZap && (fdP == NULL) && BadError(errno)) {
2548         /* bail out early and destroy the volume */
2549         if (!Showmode)
2550             Log("Still can't open volume header inode (%s), destroying volume\n", sp->description);
2551         if (deleteMe)
2552             *deleteMe = 1;
2553         IH_RELEASE(specH);
2554         return -1;
2555     }
2556     if (fdP == NULL)
2557         Abort("Unable to open inode (%s) of volume header (error = %d)\n",
2558               sp->description, errno);
2559
2560     if (!recreate
2561         && (FDH_PREAD(fdP, (char *)&header, sp->size, 0) != sp->size
2562             || header.fileHeader.magic != sp->stamp.magic)) {
2563         if (check) {
2564             Log("Part of the header (%s) is corrupted\n", sp->description);
2565             FDH_REALLYCLOSE(fdP);
2566             IH_RELEASE(specH);
2567             return -1;
2568         }
2569         Log("Part of the header (%s) is corrupted; recreating\n",
2570             sp->description);
2571         recreate = 1;
2572         /* header can be garbage; make sure we don't read garbage data from
2573          * it below */
2574         memset(&header, 0, sizeof(header));
2575     }
2576 #ifdef AFS_NAMEI_ENV
2577     if (namei_FixSpecialOGM(fdP, check)) {
2578         Log("Error with namei header OGM data (%s)\n", sp->description);
2579         FDH_REALLYCLOSE(fdP);
2580         IH_RELEASE(specH);
2581         return -1;
2582     }
2583 #endif
2584     if (sp->inodeType == VI_VOLINFO
2585         && header.volumeInfo.destroyMe == DESTROY_ME) {
2586         if (deleteMe)
2587             *deleteMe = 1;
2588         FDH_REALLYCLOSE(fdP);
2589         IH_RELEASE(specH);
2590         return -1;
2591     }
2592     if (recreate && !Testing) {
2593         if (check)
2594             Abort
2595                 ("Internal error: recreating volume header (%s) in check mode\n",
2596                  sp->description);
2597         nBytes = FDH_TRUNC(fdP, 0);
2598         if (nBytes == -1)
2599             Abort("Unable to truncate volume header file (%s) (error = %d)\n",
2600                   sp->description, errno);
2601
2602         /* The following code should be moved into vutil.c */
2603         if (sp->inodeType == VI_VOLINFO) {
2604             struct timeval tp;
2605             memset(&header.volumeInfo, 0, sizeof(header.volumeInfo));
2606             header.volumeInfo.stamp = sp->stamp;
2607             header.volumeInfo.id = isp->volumeId;
2608             header.volumeInfo.parentId = isp->RWvolumeId;
2609             sprintf(header.volumeInfo.name, "bogus.%" AFS_VOLID_FMT, afs_printable_VolumeId_lu(isp->volumeId));
2610             Log("Warning: the name of volume %" AFS_VOLID_FMT " is now \"bogus.%" AFS_VOLID_FMT "\"\n",
2611                 afs_printable_VolumeId_lu(isp->volumeId), afs_printable_VolumeId_lu(isp->volumeId));
2612             header.volumeInfo.inService = 0;
2613             header.volumeInfo.blessed = 0;
2614             /* The + 1000 is a hack in case there are any files out in venus caches */
2615             header.volumeInfo.uniquifier = (isp->maxUniquifier + 1) + 1000;
2616             header.volumeInfo.type = (isp->volumeId == isp->RWvolumeId ? readwriteVolume : readonlyVolume);     /* XXXX */
2617             header.volumeInfo.needsCallback = 0;
2618             gettimeofday(&tp, NULL);
2619             header.volumeInfo.creationDate = tp.tv_sec;
2620             nBytes =
2621                 FDH_PWRITE(fdP, (char *)&header.volumeInfo,
2622                            sizeof(header.volumeInfo), 0);
2623             if (nBytes != sizeof(header.volumeInfo)) {
2624                 if (nBytes < 0)
2625                     Abort
2626                         ("Unable to write volume header file (%s) (errno = %d)\n",
2627                          sp->description, errno);
2628                 Abort("Unable to write entire volume header file (%s)\n",
2629                       sp->description);
2630             }
2631         } else {
2632             nBytes = FDH_PWRITE(fdP, (char *)&sp->stamp, sizeof(sp->stamp), 0);
2633             if (nBytes != sizeof(sp->stamp)) {
2634                 if (nBytes < 0)
2635                     Abort
2636                         ("Unable to write version stamp in volume header file (%s) (errno = %d)\n",
2637                          sp->description, errno);
2638                 Abort
2639                     ("Unable to write entire version stamp in volume header file (%s)\n",
2640                      sp->description);
2641             }
2642         }
2643     }
2644     FDH_REALLYCLOSE(fdP);
2645     IH_RELEASE(specH);
2646     if (sp->inodeType == VI_VOLINFO) {
2647         salvinfo->VolInfo = header.volumeInfo;
2648         if (check) {
2649             char update[64];
2650             char buffer[64];
2651
2652             if (salvinfo->VolInfo.updateDate) {
2653                 strcpy(update, TimeStamp(buffer, sizeof(buffer), salvinfo->VolInfo.updateDate, 0));
2654                 if (!Showmode)
2655                     Log("%s (%" AFS_VOLID_FMT ") %supdated %s\n", salvinfo->VolInfo.name,
2656                         afs_printable_VolumeId_lu(salvinfo->VolInfo.id),
2657                         (Testing ? "it would have been " : ""), update);
2658             } else {
2659                 strcpy(update, TimeStamp(buffer, sizeof(buffer), salvinfo->VolInfo.creationDate, 0));
2660                 if (!Showmode)
2661                     Log("%s (%" AFS_VOLID_FMT ") not updated (created %s)\n",
2662                         salvinfo->VolInfo.name, afs_printable_VolumeId_lu(salvinfo->VolInfo.id), update);
2663             }
2664
2665         }
2666     }
2667
2668     return 0;
2669 }
2670
2671 int
2672 SalvageVnodes(struct SalvInfo *salvinfo,
2673               struct InodeSummary *rwIsp,
2674               struct InodeSummary *thisIsp,
2675               struct ViceInodeInfo *inodes, int check)
2676 {
2677     int ilarge, ismall, ioffset, RW, nInodes;
2678     ioffset = rwIsp->index + rwIsp->nSpecialInodes;     /* first inode */
2679     if (Showmode)
2680         return 0;
2681     RW = (rwIsp == thisIsp);
2682     nInodes = (rwIsp->nInodes - rwIsp->nSpecialInodes);
2683     ismall =
2684         SalvageIndex(salvinfo, thisIsp->volSummary->header.smallVnodeIndex, vSmall, RW,
2685                      &inodes[ioffset], nInodes, thisIsp->volSummary, check);
2686     if (check && ismall == -1)
2687         return -1;
2688     ilarge =
2689         SalvageIndex(salvinfo, thisIsp->volSummary->header.largeVnodeIndex, vLarge, RW,
2690                      &inodes[ioffset], nInodes, thisIsp->volSummary, check);
2691     return (ilarge == 0 && ismall == 0 ? 0 : -1);
2692 }
2693
2694 int
2695 SalvageIndex(struct SalvInfo *salvinfo, Inode ino, VnodeClass class, int RW,
2696              struct ViceInodeInfo *ip, int nInodes,
2697              struct VolumeSummary *volSummary, int check)
2698 {
2699     char buf[SIZEOF_LARGEDISKVNODE];
2700     struct VnodeDiskObject *vnode = (struct VnodeDiskObject *)buf;
2701     int err = 0;
2702     StreamHandle_t *file;
2703     struct VnodeClassInfo *vcp;
2704     afs_sfsize_t size;
2705     afs_sfsize_t nVnodes;
2706     afs_fsize_t vnodeLength;
2707     int vnodeIndex;
2708     afs_ino_str_t stmp1, stmp2;
2709     IHandle_t *handle;
2710     FdHandle_t *fdP;
2711
2712     IH_INIT(handle, salvinfo->fileSysDevice, volSummary->header.parent, ino);
2713     fdP = IH_OPEN(handle);
2714     opr_Assert(fdP != NULL);
2715     file = FDH_FDOPEN(fdP, "r+");
2716     opr_Assert(file != NULL);
2717     vcp = &VnodeClassInfo[class];
2718     size = FDH_SIZE(fdP);
2719     opr_Assert(size != -1);
2720     nVnodes = (size / vcp->diskSize) - 1;
2721     if (nVnodes > 0) {
2722         opr_Assert((nVnodes + 1) * vcp->diskSize == size);
2723         opr_Verify(STREAM_ASEEK(file, vcp->diskSize) == 0);
2724     } else {
2725         nVnodes = 0;
2726     }
2727     for (vnodeIndex = 0;
2728          nVnodes && STREAM_READ(vnode, vcp->diskSize, 1, file) == 1;
2729          nVnodes--, vnodeIndex++) {
2730         if (vnode->type != vNull) {
2731             int vnodeChanged = 0;
2732             int vnodeNumber = bitNumberToVnodeNumber(vnodeIndex, class);
2733             if (VNDISK_GET_INO(vnode) == 0) {
2734                 if (RW) {
2735                     /* Log("### DEBUG ### Deleted Vnode with 0 inode (vnode %d)\n", vnodeNumber); */
2736                     memset(vnode, 0, vcp->diskSize);
2737                     vnodeChanged = 1;
2738                 }
2739             } else {
2740                 if (vcp->magic != vnode->vnodeMagic) {
2741                     /* bad magic #, probably partially created vnode */
2742                     if (check) {
2743                        Log("Partially allocated vnode %d: bad magic (is %lx should be %lx)\n",
2744                            vnodeNumber, afs_printable_uint32_lu(vnode->vnodeMagic),
2745                            afs_printable_uint32_lu(vcp->magic));
2746                        memset(vnode, 0, vcp->diskSize);
2747                        err = -1;
2748                        goto zooks;
2749                     }
2750                     Log("Partially allocated vnode %d deleted.\n",
2751                         vnodeNumber);
2752                     memset(vnode, 0, vcp->diskSize);
2753                     vnodeChanged = 1;
2754                     goto vnodeDone;
2755                 }
2756                 /* ****** Should do a bit more salvage here:  e.g. make sure
2757                  * vnode type matches what it should be given the index */
2758                 while (nInodes && ip->u.vnode.vnodeNumber < vnodeNumber) {
2759 /*                  if (vnodeIdToClass(ip->u.vnode.vnodeNumber) == class && RW) {
2760  *                     Log("Inode %d: says it belongs to non-existing vnode %d\n",
2761  *                         ip->inodeNumber, ip->u.vnode.vnodeNumber);
2762  *                  }
2763  */
2764                     ip++;
2765                     nInodes--;
2766                 }
2767                 if (!RW) {
2768                     while (nInodes && ip->u.vnode.vnodeNumber == vnodeNumber) {
2769                         /* The following doesn't work, because the version number
2770                          * is not maintained correctly by the file server */
2771                         /*if (vnode->uniquifier == ip->u.vnode.vnodeUniquifier &&
2772                          * vnode->dataVersion == ip->u.vnode.inodeDataVersion)
2773                          * break; */
2774                         if (VNDISK_GET_INO(vnode) == ip->inodeNumber)
2775                             break;
2776                         ip++;
2777                         nInodes--;
2778                     }
2779                 } else {
2780                     /* For RW volume, look for vnode with matching inode number;
2781                      * if no such match, take the first determined by our sort
2782                      * order */
2783                     struct ViceInodeInfo *lip = ip;
2784                     int lnInodes = nInodes;
2785                     while (lnInodes
2786                            && lip->u.vnode.vnodeNumber == vnodeNumber) {
2787                         if (VNDISK_GET_INO(vnode) == lip->inodeNumber) {
2788                             ip = lip;
2789                             nInodes = lnInodes;
2790                             break;
2791                         }
2792                         lip++;
2793                         lnInodes--;
2794                     }
2795                 }
2796                 if (nInodes && ip->u.vnode.vnodeNumber == vnodeNumber) {
2797                     /* "Matching" inode */
2798                     if (RW) {
2799                         Unique vu, iu;
2800                         FileVersion vd, id;
2801                         vu = vnode->uniquifier;
2802                         iu = ip->u.vnode.vnodeUniquifier;
2803                         vd = vnode->dataVersion;
2804                         id = ip->u.vnode.inodeDataVersion;
2805                         /*
2806                          * Because of the possibility of the uniquifier overflows (> 4M)
2807                          * we compare them modulo the low 22-bits; we shouldn't worry
2808                          * about mismatching since they shouldn't to many old
2809                          * uniquifiers of the same vnode...
2810                          */
2811                         if (IUnique(vu) != IUnique(iu)) {
2812                             if (!Showmode) {
2813                                 Log("Vnode %u: vnode.unique, %u, does not match inode unique, %u; fixed, but status will be wrong\n", vnodeNumber, IUnique(vu), IUnique(iu));
2814                             }
2815
2816                             vnode->uniquifier = iu;
2817 #ifdef  AFS_3DISPARES
2818                             vnode->dataVersion = (id >= vd ?
2819                                                   /* 90% of 2.1M */
2820                                                   ((id - vd) >
2821                                                    1887437 ? vd : id) :
2822                                                   /* 90% of 2.1M */
2823                                                   ((vd - id) >
2824                                                    1887437 ? id : vd));
2825 #else
2826 #if defined(AFS_SGI_EXMAG)
2827                             vnode->dataVersion = (id >= vd ?
2828                                                   /* 90% of 16M */
2829                                                   ((id - vd) >
2830                                                    15099494 ? vd : id) :
2831                                                   /* 90% of 16M */
2832                                                   ((vd - id) >
2833                                                    15099494 ? id : vd));
2834 #else
2835                             vnode->dataVersion = (id > vd ? id : vd);
2836 #endif /* AFS_SGI_EXMAG */
2837 #endif /* AFS_3DISPARES */
2838                             vnodeChanged = 1;
2839                         } else {
2840                             /* don't bother checking for vd > id any more, since
2841                              * partial file transfers always result in this state,
2842                              * and you can't do much else anyway (you've already
2843                              * found the best data you can) */
2844 #ifdef  AFS_3DISPARES
2845                             if (!vnodeIsDirectory(vnodeNumber)
2846                                 && ((vd < id && (id - vd) < 1887437)
2847                                     || ((vd > id && (vd - id) > 1887437)))) {
2848 #else
2849 #if defined(AFS_SGI_EXMAG)
2850                             if (!vnodeIsDirectory(vnodeNumber)
2851                                 && ((vd < id && (id - vd) < 15099494)
2852                                     || ((vd > id && (vd - id) > 15099494)))) {
2853 #else
2854                             if (!vnodeIsDirectory(vnodeNumber) && vd < id) {
2855 #endif /* AFS_SGI_EXMAG */
2856 #endif
2857                                 if (!Showmode)
2858                                     Log("Vnode %d: version < inode version; fixed (old status)\n", vnodeNumber);
2859                                 vnode->dataVersion = id;
2860                                 vnodeChanged = 1;
2861                             }
2862                         }
2863                     }
2864                     if (ip->inodeNumber != VNDISK_GET_INO(vnode)) {
2865                         if (check) {
2866                             if (!Showmode) {
2867                                 Log("Vnode %d:  inode number incorrect (is %s should be %s). FileSize=%llu\n", vnodeNumber, PrintInode(stmp1, VNDISK_GET_INO(vnode)), PrintInode(stmp2, ip->inodeNumber), (afs_uintmax_t) ip->byteCount);
2868                             }
2869                             VNDISK_SET_INO(vnode, ip->inodeNumber);
2870                             err = -1;
2871                             goto zooks;
2872                         }
2873                         if (!Showmode) {
2874                             Log("Vnode %d: inode number incorrect; changed from %s to %s. FileSize=%llu\n", vnodeNumber, PrintInode(stmp1, VNDISK_GET_INO(vnode)), PrintInode(stmp2, ip->inodeNumber), (afs_uintmax_t) ip->byteCount);
2875                         }
2876                         VNDISK_SET_INO(vnode, ip->inodeNumber);
2877                         vnodeChanged = 1;
2878                     }
2879                     VNDISK_GET_LEN(vnodeLength, vnode);
2880                     if (ip->byteCount != vnodeLength) {
2881                         if (check) {
2882                             if (!Showmode)
2883                                 Log("Vnode %d: length incorrect; (is %llu should be %llu)\n", vnodeNumber, (afs_uintmax_t) vnodeLength, (afs_uintmax_t) ip->byteCount);
2884                             err = -1;
2885                             goto zooks;
2886                         }
2887                         if (!Showmode)
2888                             Log("Vnode %d: length incorrect; changed from %llu to %llu\n", vnodeNumber, (afs_uintmax_t) vnodeLength, (afs_uintmax_t) ip->byteCount);
2889                         VNDISK_SET_LEN(vnode, ip->byteCount);
2890                         vnodeChanged = 1;
2891                     }
2892                     if (!check)
2893                         ip->linkCount--;        /* Keep the inode around */
2894                     ip++;
2895                     nInodes--;
2896                 } else {        /* no matching inode */
2897                     afs_ino_str_t stmp;
2898                     if (VNDISK_GET_INO(vnode) != 0
2899                         || vnode->type == vDirectory) {
2900                         /* No matching inode--get rid of the vnode */
2901                         if (check) {
2902                             if (VNDISK_GET_INO(vnode)) {
2903                                 if (!Showmode) {
2904                                     Log("Vnode %d (unique %u): corresponding inode %s is missing\n", vnodeNumber, vnode->uniquifier, PrintInode(stmp, VNDISK_GET_INO(vnode)));
2905                                 }
2906                             } else {
2907                                 if (!Showmode)
2908                                     Log("Vnode %d (unique %u): bad directory vnode (no inode number listed)\n", vnodeNumber, vnode->uniquifier);
2909                             }
2910                             err = -1;
2911                             goto zooks;
2912                         }
2913                         if (VNDISK_GET_INO(vnode)) {
2914                             if (!Showmode) {
2915                                 time_t serverModifyTime = vnode->serverModifyTime;
2916                                 Log("Vnode %d (unique %u): corresponding inode %s is missing; vnode deleted, vnode mod time=%s", vnodeNumber, vnode->uniquifier, PrintInode(stmp, VNDISK_GET_INO(vnode)), ctime(&serverModifyTime));
2917                             }
2918                         } else {
2919                             if (!Showmode) {
2920                                 time_t serverModifyTime = vnode->serverModifyTime;
2921                                 Log("Vnode %d (unique %u): bad directory vnode (no inode number listed); vnode deleted, vnode mod time=%s", vnodeNumber, vnode->uniquifier, ctime(&serverModifyTime));
2922                             }
2923                         }
2924                         memset(vnode, 0, vcp->diskSize);
2925                         vnodeChanged = 1;
2926                     } else {
2927                         /* Should not reach here becuase we checked for
2928                          * (inodeNumber == 0) above. And where we zero the vnode,
2929                          * we also goto vnodeDone.
2930                          */
2931                     }
2932                 }
2933                 while (nInodes && ip->u.vnode.vnodeNumber == vnodeNumber) {
2934                     ip++;
2935                     nInodes--;
2936                 }
2937             }                   /* VNDISK_GET_INO(vnode) != 0 */
2938           vnodeDone:
2939             opr_Assert(!(vnodeChanged && check));
2940             if (vnodeChanged && !Testing) {
2941                 opr_Verify(IH_IWRITE(handle,
2942                                      vnodeIndexOffset(vcp, vnodeNumber),
2943                                      (char *)vnode, vcp->diskSize)
2944                                 == vcp->diskSize);
2945                 salvinfo->VolumeChanged = 1;    /* For break call back */
2946             }
2947         }
2948     }
2949   zooks:
2950     STREAM_CLOSE(file);
2951     FDH_CLOSE(fdP);
2952     IH_RELEASE(handle);
2953     return err;
2954 }
2955
2956 struct VnodeEssence *
2957 CheckVnodeNumber(struct SalvInfo *salvinfo, VnodeId vnodeNumber)
2958 {
2959     VnodeClass class;
2960     struct VnodeInfo *vip;
2961     int offset;
2962
2963     class = vnodeIdToClass(vnodeNumber);
2964     vip = &salvinfo->vnodeInfo[class];
2965     offset = vnodeIdToBitNumber(vnodeNumber);
2966     return (offset >= vip->nVnodes ? NULL : &vip->vnodes[offset]);
2967 }
2968
2969 void
2970 CopyOnWrite(struct SalvInfo *salvinfo, struct DirSummary *dir)
2971 {
2972     /* Copy the directory unconditionally if we are going to change it:
2973      * not just if was cloned.
2974      */
2975     struct VnodeDiskObject vnode;
2976     struct VnodeClassInfo *vcp = &VnodeClassInfo[vLarge];
2977     Inode oldinode, newinode;
2978     afs_sfsize_t code;
2979
2980     if (dir->copied || Testing)
2981         return;
2982     DFlush();                   /* Well justified paranoia... */
2983
2984     code =
2985         IH_IREAD(salvinfo->vnodeInfo[vLarge].handle,
2986                  vnodeIndexOffset(vcp, dir->vnodeNumber), (char *)&vnode,
2987                  sizeof(vnode));
2988     opr_Assert(code == sizeof(vnode));
2989     oldinode = VNDISK_GET_INO(&vnode);
2990     /* Increment the version number by a whole lot to avoid problems with
2991      * clients that were promised new version numbers--but the file server
2992      * crashed before the versions were written to disk.
2993      */
2994     newinode =
2995         IH_CREATE(dir->ds_linkH, salvinfo->fileSysDevice, salvinfo->fileSysPath, 0, dir->rwVid,
2996                   dir->vnodeNumber, vnode.uniquifier, vnode.dataVersion +=
2997                   200);
2998     opr_Assert(VALID_INO(newinode));
2999     opr_Verify(CopyInode(salvinfo->fileSysDevice, oldinode, newinode,
3000                          dir->rwVid) == 0);
3001     vnode.cloned = 0;
3002     VNDISK_SET_INO(&vnode, newinode);
3003     code =
3004         IH_IWRITE(salvinfo->vnodeInfo[vLarge].handle,
3005                   vnodeIndexOffset(vcp, dir->vnodeNumber), (char *)&vnode,
3006                   sizeof(vnode));
3007     opr_Assert(code == sizeof(vnode));
3008
3009     SetSalvageDirHandle(&dir->dirHandle, dir->dirHandle.dirh_handle->ih_vid,
3010                         salvinfo->fileSysDevice, newinode,
3011                         &salvinfo->VolumeChanged);
3012     /* Don't delete the original inode right away, because the directory is
3013      * still being scanned.
3014      */
3015     dir->copied = 1;
3016 }
3017
3018 /*
3019  * This function should either successfully create a new dir, or give up
3020  * and leave things the way they were.  In particular, if it fails to write
3021  * the new dir properly, it should return w/o changing the reference to the
3022  * old dir.
3023  */
3024 void
3025 CopyAndSalvage(struct SalvInfo *salvinfo, struct DirSummary *dir)
3026 {
3027     struct VnodeDiskObject vnode;
3028     struct VnodeClassInfo *vcp = &VnodeClassInfo[vLarge];
3029     Inode oldinode, newinode;
3030     DirHandle newdir;
3031     FdHandle_t *fdP;
3032     afs_int32 code;
3033     afs_sfsize_t lcode;
3034     afs_int32 parentUnique = 1;
3035     struct VnodeEssence *vnodeEssence;
3036     afs_fsize_t length;
3037
3038     if (Testing)
3039         return;
3040     Log("Salvaging directory %u...\n", dir->vnodeNumber);
3041     lcode =
3042         IH_IREAD(salvinfo->vnodeInfo[vLarge].handle,
3043                  vnodeIndexOffset(vcp, dir->vnodeNumber), (char *)&vnode,
3044                  sizeof(vnode));
3045     opr_Assert(lcode == sizeof(vnode));
3046     oldinode = VNDISK_GET_INO(&vnode);
3047     /* Increment the version number by a whole lot to avoid problems with
3048      * clients that were promised new version numbers--but the file server
3049      * crashed before the versions were written to disk.
3050      */
3051     newinode =
3052         IH_CREATE(dir->ds_linkH, salvinfo->fileSysDevice, salvinfo->fileSysPath, 0, dir->rwVid,
3053                   dir->vnodeNumber, vnode.uniquifier, vnode.dataVersion +=
3054                   200);
3055     opr_Assert(VALID_INO(newinode));
3056     SetSalvageDirHandle(&newdir, dir->rwVid, salvinfo->fileSysDevice, newinode,
3057                         &salvinfo->VolumeChanged);
3058
3059     /* Assign . and .. vnode numbers from dir and vnode.parent.
3060      * The uniquifier for . is in the vnode.
3061      * The uniquifier for .. might be set to a bogus value of 1 and
3062      * the salvager will later clean it up.
3063      */
3064     if (vnode.parent && (vnodeEssence = CheckVnodeNumber(salvinfo, vnode.parent))) {
3065         parentUnique = (vnodeEssence->unique ? vnodeEssence->unique : 1);
3066     }
3067     code =
3068         DirSalvage(&dir->dirHandle, &newdir, dir->vnodeNumber,
3069                    vnode.uniquifier,
3070                    (vnode.parent ? vnode.parent : dir->vnodeNumber),
3071                    parentUnique);
3072     if (code == 0)
3073         code = DFlush();
3074     if (code) {
3075         /* didn't really build the new directory properly, let's just give up. */
3076         code = IH_DEC(dir->ds_linkH, newinode, dir->rwVid);
3077         Log("Directory salvage returned code %d, continuing.\n", code);
3078         if (code) {
3079             Log("also failed to decrement link count on new inode");
3080         }
3081         opr_Assert(0);
3082     }
3083     Log("Checking the results of the directory salvage...\n");
3084     if (!DirOK(&newdir)) {
3085         Log("Directory salvage failed!!!; restoring old version of the directory.\n");
3086         code = IH_DEC(dir->ds_linkH, newinode, dir->rwVid);
3087         opr_Assert(code == 0);
3088         opr_Assert(0);
3089     }
3090     vnode.cloned = 0;
3091     VNDISK_SET_INO(&vnode, newinode);
3092     length = afs_dir_Length(&newdir);
3093     VNDISK_SET_LEN(&vnode, length);
3094     lcode =
3095         IH_IWRITE(salvinfo->vnodeInfo[vLarge].handle,
3096                   vnodeIndexOffset(vcp, dir->vnodeNumber), (char *)&vnode,
3097                   sizeof(vnode));
3098     opr_Assert(lcode == sizeof(vnode));
3099     IH_CONDSYNC(salvinfo->vnodeInfo[vLarge].handle);
3100
3101     /* make sure old directory file is really closed */
3102     fdP = IH_OPEN(dir->dirHandle.dirh_handle);
3103     FDH_REALLYCLOSE(fdP);
3104
3105     code = IH_DEC(dir->ds_linkH, oldinode, dir->rwVid);
3106     opr_Assert(code == 0);
3107     dir->dirHandle = newdir;
3108 }
3109
3110 /**
3111  * arguments for JudgeEntry.
3112  */
3113 struct judgeEntry_params {
3114     struct DirSummary *dir;    /**< directory we're examining entries in */
3115     struct SalvInfo *salvinfo; /**< SalvInfo for the current salvage job */
3116 };
3117
3118 int
3119 JudgeEntry(void *arock, char *name, afs_int32 vnodeNumber,
3120            afs_int32 unique)
3121 {
3122     struct judgeEntry_params *params = arock;
3123     struct DirSummary *dir = params->dir;
3124     struct SalvInfo *salvinfo = params->salvinfo;
3125     struct VnodeEssence *vnodeEssence;
3126     afs_int32 dirOrphaned, todelete;
3127
3128     dirOrphaned = IsVnodeOrphaned(salvinfo, dir->vnodeNumber);
3129
3130     vnodeEssence = CheckVnodeNumber(salvinfo, vnodeNumber);
3131     if (vnodeEssence == NULL) {
3132         if (!Showmode) {
3133             Log("dir vnode %u: invalid entry deleted: %s" OS_DIRSEP "%s (vnode %u, unique %u)\n", dir->vnodeNumber, dir->name ? dir->name : "??", name, vnodeNumber, unique);
3134         }
3135         if (!Testing) {
3136             CopyOnWrite(salvinfo, dir);
3137             opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3138         }
3139         return 0;
3140     }
3141 #ifdef AFS_AIX_ENV
3142 #ifndef AFS_NAMEI_ENV
3143     /* On AIX machines, don't allow entries to point to inode 0. That is a special
3144      * mount inode for the partition. If this inode were deleted, it would crash
3145      * the machine.
3146      */
3147     if (vnodeEssence->InodeNumber == 0) {
3148         Log("dir vnode %d: invalid entry: %s" OS_DIRSEP "%s has no inode (vnode %d, unique %d)%s\n", dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeNumber, unique, (Testing ? "-- would have deleted" : " -- deleted"));
3149         if (!Testing) {
3150             CopyOnWrite(salvinfo, dir);
3151             opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3152         }
3153         return 0;
3154     }
3155 #endif
3156 #endif
3157
3158     if (!(vnodeNumber & 1) && !Showmode
3159         && !(vnodeEssence->count || vnodeEssence->unique
3160              || vnodeEssence->modeBits)) {
3161         Log("dir vnode %u: invalid entry: %s" OS_DIRSEP "%s (vnode %u, unique %u)%s\n",
3162             dir->vnodeNumber, (dir->name ? dir->name : "??"), name,
3163             vnodeNumber, unique,
3164             ((!unique) ? (Testing ? "-- would have deleted" : " -- deleted") :
3165              ""));
3166         if (!unique) {
3167             if (!Testing) {
3168                 CopyOnWrite(salvinfo, dir);
3169                 opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3170             }
3171             return 0;
3172         }
3173     }
3174
3175     /* Check if the Uniquifiers match. If not, change the directory entry
3176      * so its unique matches the vnode unique. Delete if the unique is zero
3177      * or if the directory is orphaned.
3178      */
3179     if (!vnodeEssence->unique || (vnodeEssence->unique) != unique) {
3180         todelete = ((!vnodeEssence->unique || dirOrphaned) ? 1 : 0);
3181
3182         if (todelete
3183             && ((strcmp(name, "..") == 0) || (strcmp(name, ".") == 0))) {
3184                 if (dirOrphaned) {
3185                     /* This is an orphaned directory. Don't delete the . or ..
3186                      * entry. Otherwise, it will get created in the next
3187                      * salvage and deleted again here. So Just skip it.
3188                      * */
3189                     return 0;
3190                 }
3191                 /* (vnodeEssence->unique == 0 && ('.' || '..'));
3192                  * Entries arriving here should be deleted, but the directory
3193                  * is not orphaned. Therefore, the entry must be pointing at
3194                  * the wrong vnode.  Skip the 'else' clause and fall through;
3195                  * the code below will repair the entry so it correctly points
3196                  * at the vnode of the current directory (if '.') or the parent
3197                  * directory (if '..'). */
3198         } else {
3199             if (!Showmode) {
3200                 Log("dir vnode %u: %s" OS_DIRSEP "%s (vnode %u): unique changed from %u to %u %s\n",
3201                     dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeNumber, unique,
3202                     vnodeEssence->unique, (!todelete ? "" : (Testing ? "-- would have deleted" : "-- deleted")));
3203             }
3204             if (!Testing) {
3205                 AFSFid fid;
3206                 fid.Vnode = vnodeNumber;
3207                 fid.Unique = vnodeEssence->unique;
3208                 CopyOnWrite(salvinfo, dir);
3209                 opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3210                 if (!todelete)
3211                     opr_Verify(afs_dir_Create(&dir->dirHandle, name, &fid) == 0);
3212             }
3213             if (todelete)
3214                 return 0;               /* no need to continue */
3215         }
3216     }
3217
3218     if (strcmp(name, ".") == 0) {
3219         if (dir->vnodeNumber != vnodeNumber || (dir->unique != unique)) {
3220             if (!Showmode)
3221                 Log("directory vnode %u.%u: bad '.' entry (was %u.%u); fixed\n", dir->vnodeNumber, dir->unique, vnodeNumber, unique);
3222             if (!Testing) {
3223                 AFSFid fid;
3224                 CopyOnWrite(salvinfo, dir);
3225                 opr_Verify(afs_dir_Delete(&dir->dirHandle, ".") == 0);
3226                 fid.Vnode = dir->vnodeNumber;
3227                 fid.Unique = dir->unique;
3228                 opr_Verify(afs_dir_Create(&dir->dirHandle, ".", &fid) == 0);
3229                 vnodeNumber = fid.Vnode;        /* Get the new Essence */
3230                 unique = fid.Unique;
3231                 vnodeEssence = CheckVnodeNumber(salvinfo, vnodeNumber);
3232             }
3233         }
3234         dir->haveDot = 1;
3235     } else if (strcmp(name, "..") == 0) {
3236         AFSFid pa;
3237         if (dir->parent) {
3238             struct VnodeEssence *dotdot;
3239             pa.Vnode = dir->parent;
3240             dotdot = CheckVnodeNumber(salvinfo, pa.Vnode);
3241             opr_Assert(dotdot != NULL); /* XXX Should not be assert */
3242             pa.Unique = dotdot->unique;
3243         } else {
3244             pa.Vnode = dir->vnodeNumber;
3245             pa.Unique = dir->unique;
3246         }
3247         if ((pa.Vnode != vnodeNumber) || (pa.Unique != unique)) {
3248             if (!Showmode)
3249                 Log("directory vnode %u.%u: bad '..' entry (was %u.%u); fixed\n", dir->vnodeNumber, dir->unique, vnodeNumber, unique);
3250             if (!Testing) {
3251                 CopyOnWrite(salvinfo, dir);
3252                 opr_Verify(afs_dir_Delete(&dir->dirHandle, "..") == 0);
3253                 opr_Verify(afs_dir_Create(&dir->dirHandle, "..", &pa) == 0);
3254             }
3255
3256             vnodeNumber = pa.Vnode;     /* Get the new Essence */
3257             unique = pa.Unique;
3258             vnodeEssence = CheckVnodeNumber(salvinfo, vnodeNumber);
3259         }
3260         dir->haveDotDot = 1;
3261     } else if (strncmp(name, ".__afs", 6) == 0) {
3262         if (!Showmode) {
3263             Log("dir vnode %u: special old unlink-while-referenced file %s %s deleted (vnode %u)\n", dir->vnodeNumber, name, (Testing ? "would have been" : "is"), vnodeNumber);
3264         }
3265         if (!Testing) {
3266             CopyOnWrite(salvinfo, dir);
3267             opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3268         }
3269         vnodeEssence->claimed = 0;      /* Not claimed: Orphaned */
3270         vnodeEssence->todelete = 1;     /* Will later delete vnode and decr inode */
3271         return 0;
3272     } else {
3273         if (ShowSuid && (vnodeEssence->modeBits & 06000))
3274             Log("FOUND suid/sgid file: %s" OS_DIRSEP "%s (%u.%u %05o) author %u (vnode %u dir %u)\n", dir->name ? dir->name : "??", name, vnodeEssence->owner, vnodeEssence->group, vnodeEssence->modeBits, vnodeEssence->author, vnodeNumber, dir->vnodeNumber);
3275         if (/* ShowMounts && */ (vnodeEssence->type == vSymlink)
3276             && !(vnodeEssence->modeBits & 0111)) {
3277             afs_sfsize_t nBytes;
3278             afs_sfsize_t size;
3279             char buf[1025];
3280             IHandle_t *ihP;
3281             FdHandle_t *fdP;
3282
3283             IH_INIT(ihP, salvinfo->fileSysDevice, dir->dirHandle.dirh_handle->ih_vid,
3284                     vnodeEssence->InodeNumber);
3285             fdP = IH_OPEN(ihP);
3286             if (fdP == NULL) {
3287                 Log("ERROR %s could not open mount point vnode %u\n", dir->vname, vnodeNumber);
3288                 IH_RELEASE(ihP);
3289                 return 0;
3290             }
3291             size = FDH_SIZE(fdP);
3292             if (size < 0) {
3293                 Log("ERROR %s mount point has invalid size %d, vnode %u\n", dir->vname, (int)size, vnodeNumber);
3294                 FDH_REALLYCLOSE(fdP);
3295                 IH_RELEASE(ihP);
3296                 return 0;
3297             }
3298
3299             if (size > 1024)
3300                 size = 1024;
3301             nBytes = FDH_PREAD(fdP, buf, size, 0);
3302             if (nBytes == size) {
3303                 buf[size] = '\0';
3304                 if ( (*buf != '#' && *buf != '%') || buf[strlen(buf)-1] != '.' ) {
3305                     Log("Volume %" AFS_VOLID_FMT " (%s) mount point %s" OS_DIRSEP "%s to '%s' invalid, %s to symbolic link\n",
3306                         afs_printable_VolumeId_lu(dir->dirHandle.dirh_handle->ih_vid), dir->vname, dir->name ? dir->name : "??", name, buf,
3307                         Testing ? "would convert" : "converted");
3308                     vnodeEssence->modeBits |= 0111;
3309                     vnodeEssence->changed = 1;
3310                 } else if (ShowMounts) 
3311                     Log("In volume %" AFS_VOLID_FMT " (%s) found mountpoint %s" OS_DIRSEP "%s to '%s'\n",
3312                         afs_printable_VolumeId_lu(dir->dirHandle.dirh_handle->ih_vid),
3313                         dir->vname, dir->name ? dir->name : "??", name, buf);
3314             } else {
3315                 Log("Volume %s cound not read mount point vnode %u size %d code %d\n",
3316                     dir->vname, vnodeNumber, (int)size, (int)nBytes);
3317             }
3318             FDH_REALLYCLOSE(fdP);
3319             IH_RELEASE(ihP);
3320         }
3321         if (ShowRootFiles && vnodeEssence->owner == 0 && vnodeNumber != 1)
3322             Log("FOUND root file: %s" OS_DIRSEP "%s (%u.%u %05o) author %u (vnode %u dir %u)\n", dir->name ? dir->name : "??", name, vnodeEssence->owner, vnodeEssence->group, vnodeEssence->modeBits, vnodeEssence->author, vnodeNumber, dir->vnodeNumber);
3323         if (vnodeIdToClass(vnodeNumber) == vLarge
3324             && vnodeEssence->name == NULL) {
3325             vnodeEssence->name = strdup(name);
3326         }
3327
3328         /* The directory entry points to the vnode. Check to see if the
3329          * vnode points back to the directory. If not, then let the
3330          * directory claim it (else it might end up orphaned). Vnodes
3331          * already claimed by another directory are deleted from this
3332          * directory: hardlinks to the same vnode are not allowed
3333          * from different directories.
3334          */
3335         if (vnodeEssence->parent != dir->vnodeNumber) {
3336             if (!vnodeEssence->claimed && !dirOrphaned && vnodeNumber != 1) {
3337                 /* Vnode does not point back to this directory.
3338                  * Orphaned dirs cannot claim a file (it may belong to
3339                  * another non-orphaned dir).
3340                  */
3341                 if (!Showmode) {
3342                     Log("dir vnode %u: %s" OS_DIRSEP "%s (vnode %u, unique %u) -- parent vnode %schanged from %u to %u\n", dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeNumber, unique, (Testing ? "would have been " : ""), vnodeEssence->parent, dir->vnodeNumber);
3343                 }
3344                 vnodeEssence->parent = dir->vnodeNumber;
3345                 vnodeEssence->changed = 1;
3346             } else {
3347                 /* Vnode was claimed by another directory */
3348                 if (!Showmode) {
3349                     if (dirOrphaned) {
3350                         Log("dir vnode %u: %s" OS_DIRSEP "%s parent vnode is %u (vnode %u, unique %u) -- %sdeleted\n", dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeEssence->parent, vnodeNumber, unique, (Testing ? "would have been " : ""));
3351                     } else if (vnodeNumber == 1) {
3352                         Log("dir vnode %d: %s" OS_DIRSEP "%s is invalid (vnode %d, unique %d) -- %sdeleted\n", dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeNumber, unique, (Testing ? "would have been " : ""));
3353                     } else {
3354                         Log("dir vnode %u: %s" OS_DIRSEP "%s already claimed by directory vnode %u (vnode %u, unique %u) -- %sdeleted\n", dir->vnodeNumber, (dir->name ? dir->name : "??"), name, vnodeEssence->parent, vnodeNumber, unique, (Testing ? "would have been " : ""));
3355                     }
3356                 }
3357                 if (!Testing) {
3358                     CopyOnWrite(salvinfo, dir);
3359                     opr_Verify(afs_dir_Delete(&dir->dirHandle, name) == 0);
3360                 }
3361                 return 0;
3362             }
3363         }
3364         /* This directory claims the vnode */
3365         vnodeEssence->claimed = 1;
3366     }
3367     vnodeEssence->count--;
3368     return 0;
3369 }
3370
3371 void
3372 DistilVnodeEssence(struct SalvInfo *salvinfo, VolumeId rwVId,
3373                    VnodeClass class, Inode ino, Unique * maxu)
3374 {
3375     struct VnodeInfo *vip = &salvinfo->vnodeInfo[class];
3376     struct VnodeClassInfo *vcp = &VnodeClassInfo[class];
3377     char buf[SIZEOF_LARGEDISKVNODE];
3378     struct VnodeDiskObject *vnode = (struct VnodeDiskObject *)buf;
3379     afs_sfsize_t size;
3380     StreamHandle_t *file;