windows-fix-recursion-detection-20070819
[openafs.git] / src / WINNT / afsd / cm_vnodeops.c
1 /*
2  * Copyright 2000, International Business Machines Corporation and others.
3  * All Rights Reserved.
4  * 
5  * This software has been released under the terms of the IBM Public
6  * License.  For details, see the LICENSE file in the top-level source
7  * directory or online at http://www.openafs.org/dl/license10.html
8  */
9
10 #include <afs/param.h>
11 #include <afs/stds.h>
12
13 #include <windows.h>
14 #include <winsock2.h>
15 #include <stddef.h>
16 #include <malloc.h>
17 #include <string.h>
18 #include <stdlib.h>
19 #include <errno.h>
20
21 #include <osi.h>
22
23 #include "afsd.h"
24
25 #ifdef DEBUG
26 extern void afsi_log(char *pattern, ...);
27 #endif
28
29 int cm_enableServerLocks = 1;
30
31 /*
32  * Case-folding array.  This was constructed by inspecting of SMBtrace output.
33  * I do not know anything more about it.
34  */
35 unsigned char cm_foldUpper[256] = {
36      0x0,  0x1,  0x2,  0x3,  0x4,  0x5,  0x6,  0x7,
37      0x8,  0x9,  0xa,  0xb,  0xc,  0xd,  0xe,  0xf,
38     0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17,
39     0x18, 0x19, 0x1a, 0x1b, 0x1c, 0x1d, 0x1e, 0x1f,
40     0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27,
41     0x28, 0x29, 0x2a, 0x2b, 0x2c, 0x2d, 0x2e, 0x2f,
42     0x30, 0x31, 0x32, 0x33, 0x34, 0x35, 0x36, 0x37,
43     0x38, 0x39, 0x3a, 0x3b, 0x3c, 0x3d, 0x3e, 0x3f,
44     0x40, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47,
45     0x48, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f,
46     0x50, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57,
47     0x58, 0x59, 0x5a, 0x5b, 0x5c, 0x5d, 0x5e, 0x5f,
48     0x60, 0x41, 0x42, 0x43, 0x44, 0x45, 0x46, 0x47,
49     0x48, 0x49, 0x4a, 0x4b, 0x4c, 0x4d, 0x4e, 0x4f,
50     0x50, 0x51, 0x52, 0x53, 0x54, 0x55, 0x56, 0x57,
51     0x58, 0x59, 0x5a, 0x7b, 0x7c, 0x7d, 0x7e, 0x7f,
52     0x80, 0x9a, 0x90, 0x41, 0x8e, 0x41, 0x8f, 0x80,
53     0x45, 0x45, 0x45, 0x49, 0x49, 0x49, 0x8e, 0x8f,
54     0x90, 0x92, 0x92, 0x4f, 0x99, 0x4f, 0x55, 0x55,
55     0x59, 0x99, 0x9a, 0x9b, 0x9c, 0x9d, 0x9e, 0x9f,
56     0x41, 0x49, 0x4f, 0x55, 0xa5, 0xa5, 0x56, 0xa7,
57     0xa8, 0xa9, 0xaa, 0xab, 0xac, 0xad, 0xae, 0xaf,
58     0xb0, 0xb1, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6, 0xb7,
59     0xb8, 0xb9, 0xba, 0xbb, 0xbc, 0xbd, 0xbe, 0xbf,
60     0xc0, 0xc1, 0xc2, 0xc3, 0xc4, 0xc5, 0xc6, 0xc7,
61     0xc8, 0xc9, 0xca, 0xcb, 0xcc, 0xcd, 0xce, 0xcf,
62     0xd0, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7,
63     0xd8, 0xd9, 0xda, 0xdb, 0xdc, 0xdd, 0xde, 0xdf,
64     0xe0, 0xe1, 0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7,
65     0xe8, 0xe9, 0xea, 0xeb, 0xec, 0xed, 0xee, 0xef,
66     0xf0, 0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7,
67     0xf8, 0xf9, 0xfa, 0xfb, 0xfc, 0xfd, 0xfe, 0xff
68 };
69
70 /*
71  * Case-insensitive string comparison.  We used to use stricmp, but it doesn't
72  * know about 8-bit characters (e.g. 129 is lowercase u-umlaut, 154 is
73  * upper-case u-umlaut).
74  */
75 int cm_stricmp(const char *str1, const char *str2)
76 {
77     char c1, c2;
78
79     while (1) {
80         if (*str1 == 0)
81             if (*str2 == 0)
82                 return 0;
83             else
84                 return -1;
85         if (*str2 == 0)
86             return 1;
87         c1 = (char) cm_foldUpper[(unsigned char)(*str1++)];
88         c2 = (char) cm_foldUpper[(unsigned char)(*str2++)];
89         if (c1 < c2)
90             return -1;
91         if (c1 > c2)
92             return 1;
93     }
94 }
95
96 /* characters that are legal in an 8.3 name */
97 /*
98  * We used to have 1's for all characters from 128 to 254.  But
99  * the NT client behaves better if we create an 8.3 name for any
100  * name that has a character with the high bit on, and if we
101  * delete those characters from 8.3 names.  In particular, see
102  * Sybase defect 10859.
103  */
104 char cm_LegalChars[256] = {
105  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
106  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
107  0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 0, 0,
108  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0,
109  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
110  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 1, 1,
111  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
112  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 1, 1, 1,
113  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
114  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
115  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
116  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
117  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
118  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
119  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
120  0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
121 };
122
123 /* return true iff component is a valid 8.3 name */
124 int cm_Is8Dot3(char *namep)
125 {
126     int sawDot = 0;
127     unsigned char tc;
128     int charCount = 0;
129         
130     /*
131      * can't have a leading dot;
132      * special case for . and ..
133      */
134     if (namep[0] == '.') {
135         if (namep[1] == 0)
136             return 1;
137         if (namep[1] == '.' && namep[2] == 0)
138             return 1;
139         return 0;
140     }
141     while (tc = *namep++) {
142         if (tc == '.') {
143             /* saw another dot */
144             if (sawDot) return 0;       /* second dot */
145             sawDot = 1;
146             charCount = 0;
147             continue;
148         }
149         if (cm_LegalChars[tc] == 0)
150             return 0;
151         charCount++;
152         if (!sawDot && charCount > 8)
153             /* more than 8 chars in name */
154             return 0;
155         if (sawDot && charCount > 3)
156             /* more than 3 chars in extension */
157             return 0;
158     }
159     return 1;
160 }
161
162 /*
163  * Number unparsing map for generating 8.3 names;
164  * The version taken from DFS was on drugs.  
165  * You can't include '&' and '@' in a file name.
166  */
167 char cm_8Dot3Mapping[42] =
168 {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
169  'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'J', 'K', 
170  'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 
171  'V', 'W', 'X', 'Y', 'Z', '_', '-', '$', '#', '!', '+', '='
172 };
173 int cm_8Dot3MapSize = sizeof(cm_8Dot3Mapping);
174
175 void cm_Gen8Dot3NameInt(const char * longname, cm_dirFid_t * pfid,
176                         char *shortName, char **shortNameEndp)
177 {
178     char number[12];
179     int i, nsize = 0;
180     int vnode = ntohl(pfid->vnode);
181     char *lastDot;
182     int validExtension = 0;
183     char tc, *temp;
184     const char *name;
185
186     /* Unparse the file's vnode number to get a "uniquifier" */
187     do {
188         number[nsize] = cm_8Dot3Mapping[vnode % cm_8Dot3MapSize];
189         nsize++;
190         vnode /= cm_8Dot3MapSize;
191     } while (vnode);
192
193     /*
194      * Look for valid extension.  There has to be a dot, and
195      * at least one of the characters following has to be legal.
196      */
197     lastDot = strrchr(longname, '.');
198     if (lastDot) {
199         temp = lastDot; temp++;
200         while (tc = *temp++)
201             if (cm_LegalChars[tc])
202                 break;
203         if (tc)
204             validExtension = 1;
205     }
206
207     /* Copy name characters */
208     for (i = 0, name = longname;
209           i < (7 - nsize) && name != lastDot; ) {
210         tc = *name++;
211
212         if (tc == 0)
213             break;
214         if (!cm_LegalChars[tc])
215             continue;
216         i++;
217         *shortName++ = toupper(tc);
218     }
219
220     /* tilde */
221     *shortName++ = '~';
222
223     /* Copy uniquifier characters */
224     memcpy(shortName, number, nsize);
225     shortName += nsize;
226
227     if (validExtension) {
228         /* Copy extension characters */
229         *shortName++ = *lastDot++;      /* copy dot */
230         for (i = 0, tc = *lastDot++;
231               i < 3 && tc;
232               tc = *lastDot++) {
233             if (cm_LegalChars[tc]) {
234                 i++;
235                 *shortName++ = toupper(tc);
236             }
237         }
238     }
239
240     /* Trailing null */
241     *shortName = 0;
242
243     if (shortNameEndp)
244         *shortNameEndp = shortName;
245 }       
246
247 /* return success if we can open this file in this mode */
248 long cm_CheckOpen(cm_scache_t *scp, int openMode, int trunc, cm_user_t *userp,
249                   cm_req_t *reqp)
250 {
251     long rights;
252     long code;
253
254     rights = 0;
255     if (openMode != 1) 
256         rights |= PRSFS_READ;
257     if (openMode == 1 || openMode == 2 || trunc) 
258         rights |= PRSFS_WRITE;
259         
260     lock_ObtainMutex(&scp->mx);
261
262     code = cm_SyncOp(scp, NULL, userp, reqp, rights,
263                       CM_SCACHESYNC_GETSTATUS
264                      | CM_SCACHESYNC_NEEDCALLBACK
265                      | CM_SCACHESYNC_LOCK);
266
267     if (code == 0 && 
268         ((rights & PRSFS_WRITE) || (rights & PRSFS_READ)) &&
269         scp->fileType == CM_SCACHETYPE_FILE) {
270
271         cm_key_t key;
272         unsigned int sLockType;
273         LARGE_INTEGER LOffset, LLength;
274
275         /* Check if there's some sort of lock on the file at the
276            moment. */
277
278         key = cm_GenerateKey(CM_SESSION_CMINT,0,0);
279
280         if (rights & PRSFS_WRITE)
281             sLockType = 0;
282         else
283             sLockType = LOCKING_ANDX_SHARED_LOCK;
284
285         LOffset.HighPart = CM_FLSHARE_OFFSET_HIGH;
286         LOffset.LowPart  = CM_FLSHARE_OFFSET_LOW;
287         LLength.HighPart = CM_FLSHARE_LENGTH_HIGH;
288         LLength.LowPart  = CM_FLSHARE_LENGTH_LOW;
289
290         code = cm_Lock(scp, sLockType, LOffset, LLength, key, 0, userp, reqp, NULL);
291
292         if (code == 0) {
293             cm_Unlock(scp, sLockType, LOffset, LLength, key, userp, reqp);
294         } else {
295             /* In this case, we allow the file open to go through even
296                though we can't enforce mandatory locking on the
297                file. */
298             if (code == CM_ERROR_NOACCESS &&
299                 !(rights & PRSFS_WRITE))
300                 code = 0;
301             else {
302                 switch (code) {
303                 case CM_ERROR_ALLOFFLINE:
304                 case CM_ERROR_ALLDOWN:
305                 case CM_ERROR_ALLBUSY:
306                 case CM_ERROR_TIMEDOUT:
307                 case CM_ERROR_RETRY:
308                 case CM_ERROR_WOULDBLOCK:
309                     break;
310                 default:
311                     code = CM_ERROR_SHARING_VIOLATION;
312                 }
313             }
314         }
315
316     } else if (code != 0) {
317         goto _done;
318     }
319
320     cm_SyncOpDone(scp, NULL, CM_SCACHESYNC_LOCK);
321
322  _done:
323
324     lock_ReleaseMutex(&scp->mx);
325
326     return code;
327 }
328
329 /* return success if we can open this file in this mode */
330 long cm_CheckNTOpen(cm_scache_t *scp, unsigned int desiredAccess,
331                     unsigned int createDisp, cm_user_t *userp, cm_req_t *reqp, 
332                     cm_lock_data_t **ldpp)
333 {
334     long rights;
335     long code;
336
337     osi_assert(ldpp != NULL);
338     *ldpp = NULL;
339
340     /* Always allow delete; the RPC will tell us if it's OK */
341     if (desiredAccess == DELETE)
342         return 0;
343
344     rights = 0;
345
346     if (desiredAccess & AFS_ACCESS_READ)
347         rights |= (scp->fileType == CM_SCACHETYPE_DIRECTORY ? PRSFS_LOOKUP : PRSFS_READ);
348
349     /* We used to require PRSFS_WRITE if createDisp was 4
350        (OPEN_ALWAYS) even if AFS_ACCESS_WRITE was not requested.
351        However, we don't need to do that since the existence of the
352        scp implies that we don't need to create it. */
353     if (desiredAccess & AFS_ACCESS_WRITE)
354         rights |= PRSFS_WRITE;
355
356     lock_ObtainMutex(&scp->mx);
357
358     code = cm_SyncOp(scp, NULL, userp, reqp, rights,
359                       CM_SCACHESYNC_GETSTATUS
360                      | CM_SCACHESYNC_NEEDCALLBACK
361                      | CM_SCACHESYNC_LOCK);
362
363     /*
364      * If the open will fail because the volume is readonly, then we will
365      * return an access denied error instead.  This is to help brain-dead
366      * apps run correctly on replicated volumes.
367      * See defect 10007 for more information.
368      */
369     if (code == CM_ERROR_READONLY)
370         code = CM_ERROR_NOACCESS;
371
372     if (code == 0 &&
373              ((rights & PRSFS_WRITE) || (rights & PRSFS_READ)) &&
374              scp->fileType == CM_SCACHETYPE_FILE) {
375         cm_key_t key;
376         unsigned int sLockType;
377         LARGE_INTEGER LOffset, LLength;
378
379         /* Check if there's some sort of lock on the file at the
380            moment. */
381
382         key = cm_GenerateKey(CM_SESSION_CMINT,0,0);
383         if (rights & PRSFS_WRITE)
384             sLockType = 0;
385         else
386             sLockType = LOCKING_ANDX_SHARED_LOCK;
387
388         /* single byte lock at offset 0x0100 0000 0000 0000 */
389         LOffset.HighPart = CM_FLSHARE_OFFSET_HIGH;
390         LOffset.LowPart  = CM_FLSHARE_OFFSET_LOW;
391         LLength.HighPart = CM_FLSHARE_LENGTH_HIGH;
392         LLength.LowPart  = CM_FLSHARE_LENGTH_LOW;
393
394         code = cm_Lock(scp, sLockType, LOffset, LLength, key, 0, userp, reqp, NULL);
395
396         if (code == 0) {
397             (*ldpp) = (cm_lock_data_t *)malloc(sizeof(cm_lock_data_t));
398             if (!*ldpp) {
399                 code = ENOMEM;
400                 goto _done;
401             }
402
403             (*ldpp)->key = key;
404             (*ldpp)->sLockType = sLockType;
405             (*ldpp)->LOffset.HighPart = LOffset.HighPart;
406             (*ldpp)->LOffset.LowPart = LOffset.LowPart;
407             (*ldpp)->LLength.HighPart = LLength.HighPart;
408             (*ldpp)->LLength.LowPart = LLength.LowPart;
409         } else {
410             /* In this case, we allow the file open to go through even
411                though we can't enforce mandatory locking on the
412                file. */
413             if (code == CM_ERROR_NOACCESS &&
414                 !(rights & PRSFS_WRITE))
415                 code = 0;
416             else {
417                 switch (code) {
418                 case CM_ERROR_ALLOFFLINE:
419                 case CM_ERROR_ALLDOWN:
420                 case CM_ERROR_ALLBUSY:
421                 case CM_ERROR_TIMEDOUT:
422                 case CM_ERROR_RETRY:
423                 case CM_ERROR_WOULDBLOCK:
424                     break;
425                 default:
426                     code = CM_ERROR_SHARING_VIOLATION;
427                 }
428             }
429         }
430     } else if (code != 0) {
431         goto _done;
432     }
433
434     cm_SyncOpDone(scp, NULL, CM_SCACHESYNC_LOCK);
435
436  _done:
437     lock_ReleaseMutex(&scp->mx);
438
439     return code;
440 }
441
442 extern long cm_CheckNTOpenDone(cm_scache_t *scp, cm_user_t *userp, cm_req_t *reqp, 
443                                cm_lock_data_t ** ldpp)
444 {
445     if (*ldpp) {
446         lock_ObtainMutex(&scp->mx);
447         cm_Unlock(scp, (*ldpp)->sLockType, (*ldpp)->LOffset, (*ldpp)->LLength, 
448                   (*ldpp)->key, userp, reqp);
449         lock_ReleaseMutex(&scp->mx);
450         free(*ldpp);
451         *ldpp = NULL;
452     }
453     return 0;
454 }
455 /*
456  * When CAP_NT_SMBS has been negotiated, deletion (of files or directories) is
457  * done in three steps:
458  * (1) open for deletion (NT_CREATE_AND_X)
459  * (2) set for deletion on close (NT_TRANSACTION2, SET_FILE_INFO)
460  * (3) close (CLOSE)
461  * We must not do the RPC until step 3.  But if we are going to return an error
462  * code (e.g. directory not empty), we must return it by step 2, otherwise most
463  * clients will not notice it.  So we do a preliminary check.  For deleting
464  * files, this is almost free, since we have already done the RPC to get the
465  * parent directory's status bits.  But for deleting directories, we must do an
466  * additional RPC to get the directory's data to check if it is empty.  Sigh.
467  */
468 long cm_CheckNTDelete(cm_scache_t *dscp, cm_scache_t *scp, cm_user_t *userp,
469         cm_req_t *reqp)
470 {
471     long code;
472     osi_hyper_t thyper;
473     cm_buf_t *bufferp;
474     cm_dirEntry_t *dep;
475     unsigned short *hashTable;
476     unsigned int i, idx;
477     int BeyondPage = 0, HaveDot = 0, HaveDotDot = 0;
478
479     /* First check permissions */
480     lock_ObtainMutex(&scp->mx);
481     code = cm_SyncOp(scp, NULL, userp, reqp, PRSFS_DELETE,
482                       CM_SCACHESYNC_GETSTATUS | CM_SCACHESYNC_NEEDCALLBACK);
483     cm_SyncOpDone(scp, NULL, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
484     lock_ReleaseMutex(&scp->mx);
485     if (code)
486         return code;
487
488     /* If deleting directory, must be empty */
489
490     if (scp->fileType != CM_SCACHETYPE_DIRECTORY)
491         return code;
492
493     thyper.HighPart = 0; thyper.LowPart = 0;
494     lock_ObtainRead(&scp->bufCreateLock);
495     code = buf_Get(scp, &thyper, &bufferp);
496     lock_ReleaseRead(&scp->bufCreateLock);
497     if (code)
498         return code;
499
500     lock_ObtainMutex(&bufferp->mx);
501     lock_ObtainMutex(&scp->mx);
502     while (1) {
503         code = cm_SyncOp(scp, bufferp, userp, reqp, 0,
504                           CM_SCACHESYNC_NEEDCALLBACK
505                           | CM_SCACHESYNC_READ
506                           | CM_SCACHESYNC_BUFLOCKED);
507         if (code)
508             break;
509
510         if (cm_HaveBuffer(scp, bufferp, 1))
511             break;
512
513         /* otherwise, load the buffer and try again */
514         lock_ReleaseMutex(&bufferp->mx);
515         code = cm_GetBuffer(scp, bufferp, NULL, userp, reqp);
516         lock_ReleaseMutex(&scp->mx);
517         lock_ObtainMutex(&bufferp->mx);
518         lock_ObtainMutex(&scp->mx);
519         cm_SyncOpDone(scp, bufferp, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_READ | CM_SCACHESYNC_BUFLOCKED);
520         if (code)
521             break;
522     }
523
524     /* We try to determine emptiness without looking beyond the first page,
525      * and without assuming "." and ".." are present and are on the first
526      * page (though these assumptions might, after all, be reasonable).
527      */
528     hashTable = (unsigned short *)(bufferp->datap + (32 * 5));
529     for (i=0; i<128; i++) {
530         idx = ntohs(hashTable[i]);
531         while (idx) {
532             if (idx >= 64) {
533                 BeyondPage = 1;
534                 break;
535             }
536             dep = (cm_dirEntry_t *)(bufferp->datap + (32 * idx));
537             if (strcmp(dep->name, ".") == 0)
538                 HaveDot = 1;
539             else if (strcmp(dep->name, "..") == 0)
540                 HaveDotDot = 1;
541             else {
542                 code = CM_ERROR_NOTEMPTY;
543                 goto done;
544             }
545             idx = ntohs(dep->next);
546         }
547     }
548     if (BeyondPage && HaveDot && HaveDotDot)
549         code = CM_ERROR_NOTEMPTY;
550     else
551         code = 0;
552   done:   
553     lock_ReleaseMutex(&bufferp->mx);
554     buf_Release(bufferp);
555     lock_ReleaseMutex(&scp->mx);
556     return code;
557 }       
558
559 /*
560  * Iterate through all entries in a directory.
561  * When the function funcp is called, the buffer is locked but the
562  * directory vnode is not.
563  *
564  * If the retscp parameter is not NULL, the parmp must be a 
565  * cm_lookupSearch_t object.  
566  */
567 long cm_ApplyDir(cm_scache_t *scp, cm_DirFuncp_t funcp, void *parmp,
568                   osi_hyper_t *startOffsetp, cm_user_t *userp, cm_req_t *reqp,
569                   cm_scache_t **retscp)
570 {
571     char *tp;
572     long code;
573     cm_dirEntry_t *dep;
574     cm_buf_t *bufferp;
575     long temp;
576     osi_hyper_t dirLength;
577     osi_hyper_t bufferOffset;
578     osi_hyper_t curOffset;
579     osi_hyper_t thyper;
580     long entryInDir;
581     long entryInBuffer;
582     cm_pageHeader_t *pageHeaderp;
583     int slotInPage;
584     long nextEntryCookie;
585     int numDirChunks;   /* # of 32 byte dir chunks in this entry */
586         
587     /* get the directory size */
588     lock_ObtainMutex(&scp->mx);
589     code = cm_SyncOp(scp, NULL, userp, reqp, PRSFS_LOOKUP,
590                       CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
591     if (code) {
592         lock_ReleaseMutex(&scp->mx);
593         return code;
594     }
595         
596     if (scp->fileType != CM_SCACHETYPE_DIRECTORY) {
597         lock_ReleaseMutex(&scp->mx);
598         return CM_ERROR_NOTDIR;
599     }   
600
601     if (retscp)                         /* if this is a lookup call */
602     {
603         cm_lookupSearch_t*      sp = parmp;
604
605         if (
606 #ifdef AFS_FREELANCE_CLIENT
607         /* Freelance entries never end up in the DNLC because they
608          * do not have an associated cm_server_t
609          */
610             !(cm_freelanceEnabled &&
611             sp->fid.cell==AFS_FAKE_ROOT_CELL_ID &&
612               sp->fid.volume==AFS_FAKE_ROOT_VOL_ID )
613 #else /* !AFS_FREELANCE_CLIENT */
614             TRUE
615 #endif
616             ) {
617         int casefold = sp->caseFold;
618         sp->caseFold = 0; /* we have a strong preference for exact matches */
619         if ( *retscp = cm_dnlcLookup(scp, sp))  /* dnlc hit */
620         {
621             sp->caseFold = casefold;
622             lock_ReleaseMutex(&scp->mx);
623             return 0;
624         }
625         sp->caseFold = casefold;
626
627             /* see if we can find it using the directory hash tables.
628                we can only do exact matches, since the hash is case
629                sensitive. */
630             {
631                 cm_dirOp_t dirop;
632
633                 code = ENOENT;
634
635                 code = cm_BeginDirOp(scp, userp, reqp, &dirop);
636                 if (code == 0) {
637                     code = cm_DirLookup(&dirop, sp->searchNamep, &sp->fid);
638                     cm_EndDirOp(&dirop);
639                 }
640
641                 if (code == 0) {
642                     /* found it */
643                     sp->found = TRUE;
644                     sp->ExactFound = TRUE;
645                     lock_ReleaseMutex(&scp->mx);
646
647                     *retscp = NULL; /* force caller to call cm_GetSCache() */
648
649                     return 0;
650                 }
651             }
652     }
653     }   
654
655     /*
656      * XXX We only get the length once.  It might change when we drop the
657      * lock.
658      */
659     dirLength = scp->length;
660
661     lock_ReleaseMutex(&scp->mx);
662
663     bufferp = NULL;
664     bufferOffset.LowPart = bufferOffset.HighPart = 0;
665     if (startOffsetp)
666         curOffset = *startOffsetp;
667     else {
668         curOffset.HighPart = 0;
669         curOffset.LowPart = 0;
670     }   
671
672     while (1) {
673         /* make sure that curOffset.LowPart doesn't point to the first
674          * 32 bytes in the 2nd through last dir page, and that it
675          * doesn't point at the first 13 32-byte chunks in the first
676          * dir page, since those are dir and page headers, and don't
677          * contain useful information.
678          */
679         temp = curOffset.LowPart & (2048-1);
680         if (curOffset.HighPart == 0 && curOffset.LowPart < 2048) {
681             /* we're in the first page */
682             if (temp < 13*32) temp = 13*32;
683         }
684         else {
685             /* we're in a later dir page */
686             if (temp < 32) temp = 32;
687         }       
688                 
689         /* make sure the low order 5 bits are zero */
690         temp &= ~(32-1);
691                 
692         /* now put temp bits back ito curOffset.LowPart */
693         curOffset.LowPart &= ~(2048-1);
694         curOffset.LowPart |= temp;
695
696         /* check if we've passed the dir's EOF */
697         if (LargeIntegerGreaterThanOrEqualTo(curOffset, dirLength))
698             break;
699                 
700         /* see if we can use the bufferp we have now; compute in which
701          * page the current offset would be, and check whether that's
702          * the offset of the buffer we have.  If not, get the buffer.
703          */
704         thyper.HighPart = curOffset.HighPart;
705         thyper.LowPart = curOffset.LowPart & ~(cm_data.buf_blockSize-1);
706         if (!bufferp || !LargeIntegerEqualTo(thyper, bufferOffset)) {
707             /* wrong buffer */
708             if (bufferp) {
709                 lock_ReleaseMutex(&bufferp->mx);
710                 buf_Release(bufferp);
711                 bufferp = NULL;
712             }
713
714             lock_ObtainRead(&scp->bufCreateLock);
715             code = buf_Get(scp, &thyper, &bufferp);
716             lock_ReleaseRead(&scp->bufCreateLock);
717             if (code) {
718                 /* if buf_Get() fails we do not have a buffer object to lock */
719                 bufferp = NULL;
720                 break;
721             }
722
723 #ifdef AFSIFS
724             /* for the IFS version, we bulkstat the dirents because this
725                routine is used in place of smb_ReceiveCoreSearchDir.  our
726                other option is to modify smb_ReceiveCoreSearchDir itself, 
727                but this seems to be the proper use for cm_ApplyDir. */
728             lock_ObtainMutex(&scp->mx);
729             if ((scp->flags & CM_SCACHEFLAG_BULKSTATTING) == 0
730                  && (scp->bulkStatProgress.QuadPart <= thyper.QuadPart))
731             {
732                 scp->flags |= CM_SCACHEFLAG_BULKSTATTING;
733                 code = cm_TryBulkStat(scp, &thyper, userp, reqp);
734                 scp->flags &= ~CM_SCACHEFLAG_BULKSTATTING;
735                 scp->bulkStatProgress = thyper;
736             }
737             lock_ReleaseMutex(&scp->mx);
738 #endif
739
740             lock_ObtainMutex(&bufferp->mx);
741             bufferOffset = thyper;
742
743             /* now get the data in the cache */
744             while (1) {
745                 lock_ObtainMutex(&scp->mx);
746                 code = cm_SyncOp(scp, bufferp, userp, reqp,
747                                   PRSFS_LOOKUP,
748                                   CM_SCACHESYNC_NEEDCALLBACK
749                                   | CM_SCACHESYNC_READ
750                                   | CM_SCACHESYNC_BUFLOCKED);
751                 if (code) {
752                     lock_ReleaseMutex(&scp->mx);
753                     break;
754                 }
755                 cm_SyncOpDone(scp, bufferp, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_READ | CM_SCACHESYNC_BUFLOCKED);
756                                 
757                 if (cm_HaveBuffer(scp, bufferp, 1)) {
758                     lock_ReleaseMutex(&scp->mx);
759                     break;
760                 }
761
762                 /* otherwise, load the buffer and try again */
763                 lock_ReleaseMutex(&bufferp->mx);
764                 code = cm_GetBuffer(scp, bufferp, NULL, userp,
765                                     reqp);
766                 lock_ReleaseMutex(&scp->mx);
767                 lock_ObtainMutex(&bufferp->mx);
768                 if (code) 
769                     break;
770             }
771             if (code) {
772                 lock_ReleaseMutex(&bufferp->mx);
773                 buf_Release(bufferp);
774                 bufferp = NULL;
775                 break;
776             }
777         }       /* if (wrong buffer) ... */
778            
779         /* now we have the buffer containing the entry we're interested
780          * in; copy it out if it represents a non-deleted entry.
781          */
782         entryInDir = curOffset.LowPart & (2048-1);
783         entryInBuffer = curOffset.LowPart & (cm_data.buf_blockSize - 1);
784
785         /* page header will help tell us which entries are free.  Page
786          * header can change more often than once per buffer, since
787          * AFS 3 dir page size may be less than (but not more than) a
788          * buffer package buffer.
789          */
790         /* only look intra-buffer */
791         temp = curOffset.LowPart & (cm_data.buf_blockSize - 1);
792         temp &= ~(2048 - 1);    /* turn off intra-page bits */
793         pageHeaderp = (cm_pageHeader_t *) (bufferp->datap + temp);
794
795         /* now determine which entry we're looking at in the page.  If
796          * it is free (there's a free bitmap at the start of the dir),
797          * we should skip these 32 bytes.
798          */
799         slotInPage = (entryInDir & 0x7e0) >> 5;
800         if (!(pageHeaderp->freeBitmap[slotInPage>>3]
801                & (1 << (slotInPage & 0x7)))) {
802             /* this entry is free */
803             numDirChunks = 1;   /* only skip this guy */
804             goto nextEntry;
805         }
806
807         tp = bufferp->datap + entryInBuffer;
808         dep = (cm_dirEntry_t *) tp;     /* now points to AFS3 dir entry */
809
810         /* while we're here, compute the next entry's location, too,
811          * since we'll need it when writing out the cookie into the
812          * dir listing stream.
813          */
814         numDirChunks = cm_NameEntries(dep->name, NULL);
815                 
816         /* compute the offset of the cookie representing the next entry */
817         nextEntryCookie = curOffset.LowPart
818             + (CM_DIR_CHUNKSIZE * numDirChunks);
819
820         if (dep->fid.vnode != 0) {
821             /* this is one of the entries to use: it is not deleted */
822             code = (*funcp)(scp, dep, parmp, &curOffset);
823             if (code) 
824                 break;
825         }       /* if we're including this name */
826                 
827       nextEntry:
828         /* and adjust curOffset to be where the new cookie is */
829         thyper.HighPart = 0;
830         thyper.LowPart = CM_DIR_CHUNKSIZE * numDirChunks;
831         curOffset = LargeIntegerAdd(thyper, curOffset);
832     }           /* while copying data for dir listing */
833
834     /* release the mutex */
835     if (bufferp) {
836         lock_ReleaseMutex(&bufferp->mx);
837         buf_Release(bufferp);
838     }
839     return code;
840 }
841
842 int cm_NoneUpper(char *s)
843 {
844     char c;
845     while (c = *s++)
846         if (c >= 'A' && c <= 'Z')
847             return 0;
848     return 1;
849 }
850
851 int cm_NoneLower(char *s)
852 {
853     char c;
854     while (c = *s++)
855         if (c >= 'a' && c <= 'z')
856             return 0;
857     return 1;
858 }
859
860 long cm_LookupSearchProc(cm_scache_t *scp, cm_dirEntry_t *dep, void *rockp,
861                           osi_hyper_t *offp)
862 {
863     cm_lookupSearch_t *sp;
864     int match;
865     char shortName[13];
866     char *matchName;
867
868     sp = (cm_lookupSearch_t *) rockp;
869
870     matchName = dep->name;
871     if (sp->caseFold)
872         match = cm_stricmp(matchName, sp->searchNamep);
873     else
874         match = strcmp(matchName, sp->searchNamep);
875
876     if (match != 0
877          && sp->hasTilde
878          && !cm_Is8Dot3(dep->name)) {
879         matchName = shortName;
880         cm_Gen8Dot3Name(dep, shortName, NULL);
881         if (sp->caseFold)
882             match = cm_stricmp(matchName, sp->searchNamep);
883         else
884             match = strcmp(matchName, sp->searchNamep);
885     }
886
887     if (match != 0)
888         return 0;
889
890     sp->found = 1;
891     if (!sp->caseFold) 
892         sp->ExactFound = 1;
893
894     if (!sp->caseFold || matchName == shortName) {
895         sp->fid.vnode = ntohl(dep->fid.vnode);
896         sp->fid.unique = ntohl(dep->fid.unique);
897         return CM_ERROR_STOPNOW;
898     }
899
900     /*
901      * If we get here, we are doing a case-insensitive search, and we
902      * have found a match.  Now we determine what kind of match it is:
903      * exact, lower-case, upper-case, or none of the above.  This is done
904      * in order to choose among matches, if there are more than one.
905      */
906
907     /* Exact matches are the best. */
908     match = strcmp(matchName, sp->searchNamep);
909     if (match == 0) {
910         sp->ExactFound = 1;
911         sp->fid.vnode = ntohl(dep->fid.vnode);
912         sp->fid.unique = ntohl(dep->fid.unique);
913         return CM_ERROR_STOPNOW;
914     }
915
916     /* Lower-case matches are next. */
917     if (sp->LCfound)
918         return 0;
919     if (cm_NoneUpper(matchName)) {
920         sp->LCfound = 1;
921         goto inexact;
922     }
923
924     /* Upper-case matches are next. */
925     if (sp->UCfound)
926         return 0;
927     if (cm_NoneLower(matchName)) {
928         sp->UCfound = 1;
929         goto inexact;
930     }
931
932     /* General matches are last. */
933     if (sp->NCfound)
934         return 0;
935     sp->NCfound = 1;
936
937   inexact:
938     sp->fid.vnode = ntohl(dep->fid.vnode);
939     sp->fid.unique = ntohl(dep->fid.unique);
940     return 0;
941 }       
942
943 /* read the contents of a mount point into the appropriate string.
944  * called with locked scp, and returns with locked scp.
945  */
946 long cm_ReadMountPoint(cm_scache_t *scp, cm_user_t *userp, cm_req_t *reqp)
947 {
948     long code;
949     cm_buf_t *bufp;
950     osi_hyper_t thyper;
951     int tlen;
952
953     if (scp->mountPointStringp[0]) 
954         return 0;
955         
956     /* otherwise, we have to read it in */
957     lock_ReleaseMutex(&scp->mx);
958
959     lock_ObtainRead(&scp->bufCreateLock);
960     thyper.LowPart = thyper.HighPart = 0;
961     code = buf_Get(scp, &thyper, &bufp);
962     lock_ReleaseRead(&scp->bufCreateLock);
963
964     lock_ObtainMutex(&scp->mx);
965     if (code)
966         return code;
967
968     while (1) {
969         code = cm_SyncOp(scp, bufp, userp, reqp, 0,
970                           CM_SCACHESYNC_READ | CM_SCACHESYNC_NEEDCALLBACK);
971         if (code)
972             goto done;
973
974         cm_SyncOpDone(scp, bufp, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_READ);
975
976         if (cm_HaveBuffer(scp, bufp, 0)) 
977             break;
978
979         /* otherwise load buffer */
980         code = cm_GetBuffer(scp, bufp, NULL, userp, reqp);
981         if (code)
982             goto done;
983     }
984     /* locked, has callback, has valid data in buffer */
985     if ((tlen = scp->length.LowPart) > MOUNTPOINTLEN - 1) 
986         return CM_ERROR_TOOBIG;
987     if (tlen <= 0) {
988         code = CM_ERROR_INVAL;
989         goto done;
990     }
991
992     /* someone else did the work while we were out */
993     if (scp->mountPointStringp[0]) {
994         code = 0;
995         goto done;
996     }
997
998     /* otherwise, copy out the link */
999     memcpy(scp->mountPointStringp, bufp->datap, tlen);
1000
1001     /* now make it null-terminated.  Note that the original contents of a
1002      * link that is a mount point is "#volname." where "." is there just to
1003      * be turned into a null.  That is, we can trash the last char of the
1004      * link without damaging the vol name.  This is a stupid convention,
1005      * but that's the protocol.
1006      */
1007     scp->mountPointStringp[tlen-1] = 0;
1008     code = 0;
1009
1010   done:
1011     if (bufp) 
1012         buf_Release(bufp);
1013     return code;
1014 }
1015
1016
1017 /* called with a locked scp and chases the mount point, yielding outScpp.
1018  * scp remains locked, just for simplicity of describing the interface.
1019  */
1020 long cm_FollowMountPoint(cm_scache_t *scp, cm_scache_t *dscp, cm_user_t *userp,
1021                          cm_req_t *reqp, cm_scache_t **outScpp)
1022 {
1023     char *cellNamep;
1024     char *volNamep;
1025     int tlen;
1026     long code;
1027     char *cp;
1028     char *mpNamep;
1029     cm_volume_t *volp = NULL;
1030     cm_cell_t *cellp;
1031     char mtType;
1032     cm_fid_t tfid;
1033     size_t vnLength;
1034     int type;
1035
1036     if (scp->mountRootFid.cell != 0 && scp->mountRootGen >= cm_data.mountRootGen) {
1037         tfid = scp->mountRootFid;
1038         lock_ReleaseMutex(&scp->mx);
1039         code = cm_GetSCache(&tfid, outScpp, userp, reqp);
1040         lock_ObtainMutex(&scp->mx);
1041         return code;
1042     }
1043
1044     /* parse the volume name */
1045     mpNamep = scp->mountPointStringp;
1046     if (!mpNamep[0])
1047         return CM_ERROR_NOSUCHPATH;
1048     tlen = (int)strlen(scp->mountPointStringp);
1049     mtType = *scp->mountPointStringp;
1050     cellNamep = malloc(tlen);
1051     volNamep = malloc(tlen);
1052
1053     cp = strrchr(mpNamep, ':');
1054     if (cp) {
1055         /* cellular mount point */
1056         memset(cellNamep, 0, tlen);
1057         strncpy(cellNamep, mpNamep+1, cp - mpNamep - 1);
1058         strcpy(volNamep, cp+1);
1059         /* now look up the cell */
1060         cellp = cm_GetCell(cellNamep, CM_FLAG_CREATE);
1061     }
1062     else {
1063         /* normal mt pt */
1064         strcpy(volNamep, mpNamep+1);
1065
1066         cellp = cm_FindCellByID(scp->fid.cell);
1067     }
1068
1069     if (!cellp) {
1070         code = CM_ERROR_NOSUCHCELL;
1071         goto done;
1072     }
1073
1074     vnLength = strlen(volNamep);
1075     if (vnLength >= 8 && strcmp(volNamep + vnLength - 7, ".backup") == 0)
1076         type = BACKVOL;
1077     else if (vnLength >= 10
1078               && strcmp(volNamep + vnLength - 9, ".readonly") == 0)
1079         type = ROVOL;
1080     else
1081         type = RWVOL;
1082
1083     /* check for backups within backups */
1084     if (type == BACKVOL
1085          && (scp->flags & (CM_SCACHEFLAG_RO | CM_SCACHEFLAG_PURERO))
1086          == CM_SCACHEFLAG_RO) {
1087         code = CM_ERROR_NOSUCHVOLUME;
1088         goto done;
1089     }
1090
1091     /* now we need to get the volume */
1092     lock_ReleaseMutex(&scp->mx);
1093     if (cm_VolNameIsID(volNamep)) {
1094         code = cm_GetVolumeByID(cellp, atoi(volNamep), userp, reqp, 
1095                                 CM_GETVOL_FLAG_CREATE, &volp);
1096     } else {
1097         code = cm_GetVolumeByName(cellp, volNamep, userp, reqp, 
1098                                   CM_GETVOL_FLAG_CREATE, &volp);
1099     }
1100     lock_ObtainMutex(&scp->mx);
1101         
1102     if (code == 0) {
1103         /* save the parent of the volume root for this is the 
1104          * place where the volume is mounted and we must remember 
1105          * this in the volume structure rather than just in the 
1106          * scache entry lest the scache entry gets recycled 
1107          * (defect 11489)
1108          */
1109         lock_ObtainMutex(&volp->mx);
1110         volp->dotdotFid = dscp->fid;
1111         lock_ReleaseMutex(&volp->mx);
1112
1113         scp->mountRootFid.cell = cellp->cellID;
1114         /* if the mt pt is in a read-only volume (not just a
1115          * backup), and if there is a read-only volume for the
1116          * target, and if this is a type '#' mount point, use
1117          * the read-only, otherwise use the one specified.
1118          */
1119         if (mtType == '#' && (scp->flags & CM_SCACHEFLAG_PURERO)
1120              && volp->ro.ID != 0 && type == RWVOL)
1121             type = ROVOL;
1122         if (type == ROVOL)
1123             scp->mountRootFid.volume = volp->ro.ID;
1124         else if (type == BACKVOL)
1125             scp->mountRootFid.volume = volp->bk.ID;
1126         else
1127             scp->mountRootFid.volume = volp->rw.ID;
1128
1129         /* the rest of the fid is a magic number */
1130         scp->mountRootFid.vnode = 1;
1131         scp->mountRootFid.unique = 1;
1132         scp->mountRootGen = cm_data.mountRootGen;
1133
1134         tfid = scp->mountRootFid;
1135         lock_ReleaseMutex(&scp->mx);
1136         code = cm_GetSCache(&tfid, outScpp, userp, reqp);
1137         lock_ObtainMutex(&scp->mx);
1138     }
1139
1140   done:
1141     if (volp)
1142         cm_PutVolume(volp);
1143     free(cellNamep);
1144     free(volNamep);
1145     return code;
1146 }       
1147
1148 long cm_LookupInternal(cm_scache_t *dscp, char *namep, long flags, cm_user_t *userp,
1149                        cm_req_t *reqp, cm_scache_t **outpScpp)
1150 {
1151     long code;
1152     int dnlcHit = 1;    /* did we hit in the dnlc? yes, we did */
1153     cm_scache_t *tscp = NULL;
1154     cm_scache_t *mountedScp;
1155     cm_lookupSearch_t rock;
1156     int getroot;
1157
1158     memset(&rock, 0, sizeof(rock));
1159
1160     if (dscp->fid.vnode == 1 && dscp->fid.unique == 1
1161          && strcmp(namep, "..") == 0) {
1162         if (dscp->dotdotFid.volume == 0)
1163             return CM_ERROR_NOSUCHVOLUME;
1164         rock.fid = dscp->dotdotFid;
1165         goto haveFid;
1166     } else if (strcmp(namep, ".") == 0) {
1167         rock.fid = dscp->fid;
1168         goto haveFid;
1169     }
1170
1171     if (flags & CM_FLAG_NOMOUNTCHASE) {
1172         /* In this case, we should go and call cm_Dir* functions
1173            directly since the following cm_ApplyDir() function will
1174            not. */
1175
1176         cm_dirOp_t dirop;
1177
1178         lock_ObtainMutex(&dscp->mx);
1179
1180         code = cm_BeginDirOp(dscp, userp, reqp, &dirop);
1181         if (code == 0) {
1182             code = cm_DirLookup(&dirop, namep, &rock.fid);
1183             cm_EndDirOp(&dirop);
1184         }
1185
1186         lock_ReleaseMutex(&dscp->mx);
1187
1188         if (code == 0) {
1189             /* found it */
1190             rock.found = TRUE;
1191             goto haveFid;
1192         }
1193     }
1194
1195     rock.fid.cell = dscp->fid.cell;
1196     rock.fid.volume = dscp->fid.volume;
1197     rock.searchNamep = namep;
1198     rock.caseFold = (flags & CM_FLAG_CASEFOLD);
1199     rock.hasTilde = ((strchr(namep, '~') != NULL) ? 1 : 0);
1200
1201     /* If NOMOUNTCHASE, bypass DNLC by passing NULL scp pointer */
1202     code = cm_ApplyDir(dscp, cm_LookupSearchProc, &rock, NULL, userp, reqp,
1203                         (flags & CM_FLAG_NOMOUNTCHASE) ? NULL : &tscp);
1204
1205     /* code == 0 means we fell off the end of the dir, while stopnow means
1206      * that we stopped early, probably because we found the entry we're
1207      * looking for.  Any other non-zero code is an error.
1208      */
1209     if (code && code != CM_ERROR_STOPNOW) {
1210         /* if the cm_scache_t we are searching in is not a directory 
1211          * we must return path not found because the error 
1212          * is to describe the final component not an intermediary
1213          */
1214         if (code == CM_ERROR_NOTDIR) {
1215             if (flags & CM_FLAG_CHECKPATH)
1216                 return CM_ERROR_NOSUCHPATH;
1217             else
1218                 return CM_ERROR_NOSUCHFILE;
1219         }
1220         return code;
1221     }
1222
1223     getroot = (dscp==cm_data.rootSCachep) ;
1224     if (!rock.found) {
1225         if (!cm_freelanceEnabled || !getroot) {
1226             if (flags & CM_FLAG_CHECKPATH)
1227                 return CM_ERROR_NOSUCHPATH;
1228             else
1229                 return CM_ERROR_NOSUCHFILE;
1230         }
1231         else {  /* nonexistent dir on freelance root, so add it */
1232             char fullname[200] = ".";
1233             int  found = 0;
1234
1235             osi_Log1(afsd_logp,"cm_Lookup adding mount for non-existent directory: %s", 
1236                       osi_LogSaveString(afsd_logp,namep));
1237             if (namep[0] == '.') {
1238                 if (cm_GetCell_Gen(&namep[1], &fullname[1], CM_FLAG_CREATE)) {
1239                     found = 1;
1240                     if ( stricmp(&namep[1], &fullname[1]) )
1241                         code = cm_FreelanceAddSymlink(namep, fullname, &rock.fid);
1242                     else
1243                         code = cm_FreelanceAddMount(namep, &fullname[1], "root.cell.", 1, &rock.fid);
1244                 }
1245             } else {
1246                 if (cm_GetCell_Gen(namep, fullname, CM_FLAG_CREATE)) {
1247                     found = 1;
1248                     if ( stricmp(namep, fullname) )
1249                         code = cm_FreelanceAddSymlink(namep, fullname, &rock.fid);
1250                     else
1251                         code = cm_FreelanceAddMount(namep, fullname, "root.cell.", 0, &rock.fid);
1252                 }
1253             }
1254             if (!found || code < 0) {   /* add mount point failed, so give up */
1255                 if (flags & CM_FLAG_CHECKPATH)
1256                     return CM_ERROR_NOSUCHPATH;
1257                 else
1258                     return CM_ERROR_NOSUCHFILE;
1259             }
1260             tscp = NULL;   /* to force call of cm_GetSCache */
1261         }
1262     }
1263
1264   haveFid:       
1265     if ( !tscp )    /* we did not find it in the dnlc */
1266     {
1267         dnlcHit = 0;    
1268         code = cm_GetSCache(&rock.fid, &tscp, userp, reqp);
1269         if (code) 
1270             return code;
1271     }       
1272     /* tscp is now held */
1273
1274     lock_ObtainMutex(&tscp->mx);
1275     code = cm_SyncOp(tscp, NULL, userp, reqp, 0,
1276                       CM_SCACHESYNC_GETSTATUS | CM_SCACHESYNC_NEEDCALLBACK);
1277     if (code) { 
1278         lock_ReleaseMutex(&tscp->mx);
1279         cm_ReleaseSCache(tscp);
1280         return code;
1281     }
1282     cm_SyncOpDone(tscp, NULL, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
1283     /* tscp is now locked */
1284
1285     if (!(flags & CM_FLAG_NOMOUNTCHASE)
1286          && tscp->fileType == CM_SCACHETYPE_MOUNTPOINT) {
1287         /* mount points are funny: they have a volume name to mount
1288          * the root of.
1289          */
1290         code = cm_ReadMountPoint(tscp, userp, reqp);
1291         if (code == 0)
1292             code = cm_FollowMountPoint(tscp, dscp, userp, reqp,
1293                                         &mountedScp);
1294         lock_ReleaseMutex(&tscp->mx);
1295         cm_ReleaseSCache(tscp);
1296         if (code) {
1297             return code;
1298         }
1299         tscp = mountedScp;
1300     }
1301     else {
1302         lock_ReleaseMutex(&tscp->mx);
1303     }
1304
1305     /* copy back pointer */
1306     *outpScpp = tscp;
1307
1308     /* insert scache in dnlc */
1309     if ( !dnlcHit && !(flags & CM_FLAG_NOMOUNTCHASE) && rock.ExactFound ) {
1310         /* lock the directory entry to prevent racing callback revokes */
1311         lock_ObtainMutex(&dscp->mx);
1312         if ( dscp->cbServerp != NULL && dscp->cbExpires > 0 )
1313             cm_dnlcEnter(dscp, namep, tscp);
1314         lock_ReleaseMutex(&dscp->mx);
1315     }
1316
1317     /* and return */
1318     return 0;
1319 }
1320
1321 int cm_ExpandSysName(char *inp, char *outp, long outSize, unsigned int index)
1322 {
1323     char *tp;
1324     int prefixCount;
1325
1326     tp = strrchr(inp, '@');
1327     if (tp == NULL) 
1328         return 0;               /* no @sys */
1329
1330     if (strcmp(tp, "@sys") != 0) 
1331         return 0;       /* no @sys */
1332
1333     /* caller just wants to know if this is a valid @sys type of name */
1334     if (outp == NULL) 
1335         return 1;
1336
1337     if (index >= MAXNUMSYSNAMES)
1338         return -1;
1339
1340     /* otherwise generate the properly expanded @sys name */
1341     prefixCount = (int)(tp - inp);
1342
1343     strncpy(outp, inp, prefixCount);    /* copy out "a." from "a.@sys" */
1344     outp[prefixCount] = 0;              /* null terminate the "a." */
1345     strcat(outp, cm_sysNameList[index]);/* append i386_nt40 */
1346     return 1;
1347 }   
1348
1349 long cm_EvaluateVolumeReference(char * namep, long flags, cm_user_t * userp,
1350                                 cm_req_t *reqp, cm_scache_t ** outpScpp)
1351 {
1352     long          code = 0;
1353     char          cellName[CELL_MAXNAMELEN];
1354     char          volumeName[VL_MAXNAMELEN];
1355     size_t        len;
1356     char *        cp;
1357     char *        tp;
1358
1359     cm_cell_t *   cellp = NULL;
1360     cm_volume_t * volp = NULL;
1361     cm_fid_t      fid;
1362     int           volType;
1363     int           mountType = RWVOL;
1364
1365     osi_Log1(afsd_logp, "cm_EvaluateVolumeReference for string [%s]",
1366              osi_LogSaveString(afsd_logp, namep));
1367
1368     if (strnicmp(namep, CM_PREFIX_VOL, CM_PREFIX_VOL_CCH) != 0) {
1369         goto _exit_invalid_path;
1370     }
1371
1372     /* namep is assumed to look like the following:
1373
1374        @vol:<cellname>%<volume>\0
1375        or
1376        @vol:<cellname>#<volume>\0
1377
1378      */
1379
1380     cp = namep + CM_PREFIX_VOL_CCH; /* cp points to cell name, hopefully */
1381     tp = strchr(cp, '%');
1382     if (tp == NULL)
1383         tp = strchr(cp, '#');
1384     if (tp == NULL ||
1385         (len = tp - cp) == 0 ||
1386         len > CELL_MAXNAMELEN)
1387         goto _exit_invalid_path;
1388     strncpy(cellName, cp, len);
1389     cellName[len] = '\0';
1390
1391     if (*tp == '#')
1392         mountType = ROVOL;
1393
1394     cp = tp+1;                  /* cp now points to volume, supposedly */
1395     strncpy(volumeName, cp, VL_MAXNAMELEN-1);
1396     volumeName[VL_MAXNAMELEN - 1] = 0;
1397
1398     /* OK, now we have the cell and the volume */
1399     osi_Log2(afsd_logp, "   Found cell [%s] and volume [%s]",
1400              osi_LogSaveString(afsd_logp, cellName),
1401              osi_LogSaveString(afsd_logp, volumeName));
1402
1403     cellp = cm_GetCell(cellName, CM_FLAG_CREATE);
1404     if (cellp == NULL) {
1405         goto _exit_invalid_path;
1406     }
1407
1408     len = strlen(volumeName);
1409     if (len >= 8 && strcmp(volumeName + len - 7, ".backup") == 0)
1410         volType = BACKVOL;
1411     else if (len >= 10 &&
1412              strcmp(volumeName + len - 9, ".readonly") == 0)
1413         volType = ROVOL;
1414     else
1415         volType = RWVOL;
1416
1417     if (cm_VolNameIsID(volumeName)) {
1418         code = cm_GetVolumeByID(cellp, atoi(volumeName), userp, reqp,
1419                                 CM_GETVOL_FLAG_CREATE, &volp);
1420     } else {
1421         code = cm_GetVolumeByName(cellp, volumeName, userp, reqp,
1422                                   CM_GETVOL_FLAG_CREATE, &volp);
1423     }
1424
1425     if (code != 0)
1426         goto _exit_cleanup;
1427
1428     fid.cell = cellp->cellID;
1429
1430     if (volType == BACKVOL)
1431         fid.volume = volp->bk.ID;
1432     else if (volType == ROVOL ||
1433              (volType == RWVOL && mountType == ROVOL && volp->ro.ID != 0))
1434         fid.volume = volp->ro.ID;
1435     else
1436         fid.volume = volp->rw.ID;
1437
1438     fid.vnode = 1;
1439     fid.unique = 1;
1440
1441     code = cm_GetSCache(&fid, outpScpp, userp, reqp);
1442
1443  _exit_cleanup:
1444     if (volp)
1445         cm_PutVolume(volp);
1446
1447     if (code == 0)
1448         return code;
1449
1450  _exit_invalid_path:
1451     if (flags & CM_FLAG_CHECKPATH)
1452         return CM_ERROR_NOSUCHPATH;
1453     else
1454         return CM_ERROR_NOSUCHFILE;
1455 }
1456
1457 #ifdef DEBUG_REFCOUNT
1458 long cm_LookupDbg(cm_scache_t *dscp, char *namep, long flags, cm_user_t *userp,
1459                cm_req_t *reqp, cm_scache_t **outpScpp, char * file, long line)
1460 #else
1461 long cm_Lookup(cm_scache_t *dscp, char *namep, long flags, cm_user_t *userp,
1462                cm_req_t *reqp, cm_scache_t **outpScpp)
1463 #endif
1464 {
1465     long code;
1466     char tname[256];
1467     int sysNameIndex = 0;
1468     cm_scache_t *scp = NULL;
1469
1470 #ifdef DEBUG_REFCOUNT
1471     afsi_log("%s:%d cm_Lookup dscp 0x%p ref %d", file, line, dscp, dscp->refCount, file, line);
1472     osi_Log2(afsd_logp, "cm_Lookup dscp 0x%p ref %d", dscp, dscp->refCount);
1473 #endif
1474
1475     if ( stricmp(namep,SMB_IOCTL_FILENAME_NOSLASH) == 0 ) {
1476         if (flags & CM_FLAG_CHECKPATH)
1477             return CM_ERROR_NOSUCHPATH;
1478         else
1479             return CM_ERROR_NOSUCHFILE;
1480     }
1481
1482     if (dscp == cm_data.rootSCachep &&
1483         strnicmp(namep, CM_PREFIX_VOL, CM_PREFIX_VOL_CCH) == 0) {
1484         return cm_EvaluateVolumeReference(namep, flags, userp, reqp, outpScpp);
1485     }
1486
1487     if (cm_ExpandSysName(namep, NULL, 0, 0) > 0) {
1488         for ( sysNameIndex = 0; sysNameIndex < MAXNUMSYSNAMES; sysNameIndex++) {
1489             code = cm_ExpandSysName(namep, tname, sizeof(tname), sysNameIndex);
1490             if (code > 0) {
1491                 code = cm_LookupInternal(dscp, tname, flags, userp, reqp, &scp);
1492 #ifdef DEBUG_REFCOUNT
1493                 afsi_log("%s:%d cm_LookupInternal (1) code 0x%x dscp 0x%p ref %d scp 0x%p ref %d", file, line, code, dscp, dscp->refCount, scp, scp ? scp->refCount : 0);
1494                 osi_Log3(afsd_logp, "cm_LookupInternal (1) code 0x%x dscp 0x%p scp 0x%p", code, dscp, scp);
1495 #endif
1496
1497                 if (code == 0) {
1498                     *outpScpp = scp;
1499                     return 0;
1500                 }
1501                 if (scp) {
1502                     cm_ReleaseSCache(scp);
1503                     scp = NULL;
1504                 }
1505             } else {
1506                 code = cm_LookupInternal(dscp, namep, flags, userp, reqp, &scp);
1507 #ifdef DEBUG_REFCOUNT
1508                 afsi_log("%s:%d cm_LookupInternal (2) code 0x%x dscp 0x%p ref %d scp 0x%p ref %d", file, line, code, dscp, dscp->refCount, scp, scp ? scp->refCount : 0);
1509                 osi_Log3(afsd_logp, "cm_LookupInternal (2) code 0x%x dscp 0x%p scp 0x%p", code, dscp, scp);
1510 #endif
1511                 *outpScpp = scp;
1512                 return code;
1513             }
1514         }
1515     } else {
1516         code = cm_LookupInternal(dscp, namep, flags, userp, reqp, &scp);
1517 #ifdef DEBUG_REFCOUNT
1518         afsi_log("%s:%d cm_LookupInternal (2) code 0x%x dscp 0x%p ref %d scp 0x%p ref %d", file, line, code, dscp, dscp->refCount, scp, scp ? scp->refCount : 0);
1519         osi_Log3(afsd_logp, "cm_LookupInternal (2) code 0x%x dscp 0x%p scp 0x%p", code, dscp, scp);
1520 #endif
1521         *outpScpp = scp;
1522         return code;
1523     }
1524
1525     /* None of the possible sysName expansions could be found */
1526     if (flags & CM_FLAG_CHECKPATH)
1527         return CM_ERROR_NOSUCHPATH;
1528     else
1529         return CM_ERROR_NOSUCHFILE;
1530 }
1531
1532 long cm_Unlink(cm_scache_t *dscp, char *namep, cm_user_t *userp, cm_req_t *reqp)
1533 {
1534     long code;
1535     cm_conn_t *connp;
1536     AFSFid afsFid;
1537     int sflags;
1538     AFSFetchStatus newDirStatus;
1539     AFSVolSync volSync;
1540     struct rx_connection * callp;
1541     cm_dirOp_t dirop;
1542
1543 #ifdef AFS_FREELANCE_CLIENT
1544     if (cm_freelanceEnabled && dscp == cm_data.rootSCachep) {
1545         /* deleting a mount point from the root dir. */
1546         code = cm_FreelanceRemoveMount(namep);
1547         return code;
1548     }
1549 #endif  
1550
1551     /* make sure we don't screw up the dir status during the merge */
1552     lock_ObtainMutex(&dscp->mx);
1553
1554     code = cm_BeginDirOp(dscp, userp, reqp, &dirop);
1555
1556     sflags = CM_SCACHESYNC_STOREDATA;
1557     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, sflags);
1558     lock_ReleaseMutex(&dscp->mx);
1559     if (code) {
1560         cm_EndDirOp(&dirop);
1561         return code;
1562     }
1563
1564     /* make the RPC */
1565     afsFid.Volume = dscp->fid.volume;
1566     afsFid.Vnode = dscp->fid.vnode;
1567     afsFid.Unique = dscp->fid.unique;
1568
1569     osi_Log1(afsd_logp, "CALL RemoveFile scp 0x%p", dscp);
1570     do {
1571         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
1572         if (code) 
1573             continue;
1574
1575         callp = cm_GetRxConn(connp);
1576         code = RXAFS_RemoveFile(callp, &afsFid, namep,
1577                                  &newDirStatus, &volSync);
1578         rx_PutConnection(callp);
1579
1580     } while (cm_Analyze(connp, userp, reqp, &dscp->fid, &volSync, NULL, NULL, code));
1581     code = cm_MapRPCError(code, reqp);
1582
1583     if (code)
1584         osi_Log1(afsd_logp, "CALL RemoveFile FAILURE, code 0x%x", code);
1585     else
1586         osi_Log0(afsd_logp, "CALL RemoveFile SUCCESS");
1587
1588     lock_ObtainMutex(&dscp->mx);
1589     cm_dnlcRemove(dscp, namep);
1590     cm_SyncOpDone(dscp, NULL, sflags);
1591     if (code == 0) {
1592         cm_MergeStatus(NULL, dscp, &newDirStatus, &volSync, userp, 0);
1593         if (cm_CheckDirOpForSingleChange(&dirop)) {
1594             cm_DirDeleteEntry(&dirop, namep);
1595         }
1596     } else if (code == CM_ERROR_NOSUCHFILE) {
1597         /* windows would not have allowed the request to delete the file 
1598          * if it did not believe the file existed.  therefore, we must 
1599          * have an inconsistent view of the world.
1600          */
1601         dscp->cbServerp = NULL;
1602     }
1603     cm_EndDirOp(&dirop);
1604     lock_ReleaseMutex(&dscp->mx);
1605
1606     return code;
1607 }
1608
1609 /* called with a locked vnode, and fills in the link info.
1610  * returns this the vnode still locked.
1611  */
1612 long cm_HandleLink(cm_scache_t *linkScp, cm_user_t *userp, cm_req_t *reqp)
1613 {
1614     long code;
1615     cm_buf_t *bufp;
1616     long temp;
1617     osi_hyper_t thyper;
1618
1619     lock_AssertMutex(&linkScp->mx);
1620     if (!linkScp->mountPointStringp[0]) {
1621         /* read the link data */
1622         lock_ReleaseMutex(&linkScp->mx);
1623         thyper.LowPart = thyper.HighPart = 0;
1624         code = buf_Get(linkScp, &thyper, &bufp);
1625         lock_ObtainMutex(&linkScp->mx);
1626         if (code) 
1627             return code;
1628         while (1) {
1629             code = cm_SyncOp(linkScp, bufp, userp, reqp, 0,
1630                               CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_READ);
1631             if (code) {
1632                 buf_Release(bufp);
1633                 return code;
1634             }
1635             cm_SyncOpDone(linkScp, bufp, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_READ);
1636
1637             if (cm_HaveBuffer(linkScp, bufp, 0)) 
1638                 break;
1639
1640             code = cm_GetBuffer(linkScp, bufp, NULL, userp, reqp);
1641             if (code) {
1642                 buf_Release(bufp);
1643                 return code;
1644             }
1645         } /* while loop to get the data */
1646                 
1647         /* now if we still have no link read in,
1648          * copy the data from the buffer */
1649         if ((temp = linkScp->length.LowPart) >= MOUNTPOINTLEN) {
1650             buf_Release(bufp);
1651             return CM_ERROR_TOOBIG;
1652         }
1653
1654         /* otherwise, it fits; make sure it is still null (could have
1655          * lost race with someone else referencing this link above),
1656          * and if so, copy in the data.
1657          */
1658         if (!linkScp->mountPointStringp[0]) {
1659             strncpy(linkScp->mountPointStringp, bufp->datap, temp);
1660             linkScp->mountPointStringp[temp] = 0;       /* null terminate */
1661         }
1662         buf_Release(bufp);
1663     }   /* don't have sym link contents cached */
1664
1665     return 0;
1666 }       
1667
1668 /* called with a held vnode and a path suffix, with the held vnode being a
1669  * symbolic link.  Our goal is to generate a new path to interpret, and return
1670  * this new path in newSpaceBufferp.  If the new vnode is relative to a dir
1671  * other than the directory containing the symbolic link, then the new root is
1672  * returned in *newRootScpp, otherwise a null is returned there.
1673  */
1674 long cm_AssembleLink(cm_scache_t *linkScp, char *pathSuffixp,
1675                       cm_scache_t **newRootScpp, cm_space_t **newSpaceBufferp,
1676                       cm_user_t *userp, cm_req_t *reqp)
1677 {
1678     long code = 0;
1679     long len;
1680     char *linkp;
1681     cm_space_t *tsp;
1682
1683     lock_ObtainMutex(&linkScp->mx);
1684     code = cm_HandleLink(linkScp, userp, reqp);
1685     if (code) 
1686         goto done;
1687
1688     /* if we may overflow the buffer, bail out; buffer is signficantly
1689      * bigger than max path length, so we don't really have to worry about
1690      * being a little conservative here.
1691      */
1692     if (strlen(linkScp->mountPointStringp) + strlen(pathSuffixp) + 2
1693          >= CM_UTILS_SPACESIZE)
1694         return CM_ERROR_TOOBIG;
1695
1696     tsp = cm_GetSpace();
1697     linkp = linkScp->mountPointStringp;
1698     if (strncmp(linkp, cm_mountRoot, cm_mountRootLen) == 0) {
1699         if (strlen(linkp) > cm_mountRootLen)
1700             strcpy(tsp->data, linkp+cm_mountRootLen+1);
1701         else
1702             tsp->data[0] = 0;
1703         *newRootScpp = cm_data.rootSCachep;
1704         cm_HoldSCache(cm_data.rootSCachep);
1705     } else if (linkp[0] == '\\' && linkp[1] == '\\') {
1706         if (!strnicmp(&linkp[2], cm_NetbiosName, (len = (long)strlen(cm_NetbiosName)))) 
1707         {
1708             char * p = &linkp[len + 3];
1709             if (strnicmp(p, "all", 3) == 0)
1710                 p += 4;
1711
1712             strcpy(tsp->data, p);
1713             for (p = tsp->data; *p; p++) {
1714                 if (*p == '\\')
1715                     *p = '/';
1716             }
1717             *newRootScpp = cm_data.rootSCachep;
1718             cm_HoldSCache(cm_data.rootSCachep);
1719         } else {
1720             linkScp->fileType = CM_SCACHETYPE_DFSLINK;
1721             strcpy(tsp->data, linkp);
1722             *newRootScpp = NULL;
1723             code = CM_ERROR_PATH_NOT_COVERED;
1724         }
1725     } else if ( !strnicmp(linkp, "msdfs:", (len = (long)strlen("msdfs:"))) ) {
1726         linkScp->fileType = CM_SCACHETYPE_DFSLINK;
1727         strcpy(tsp->data, linkp);
1728         *newRootScpp = NULL;
1729         code = CM_ERROR_PATH_NOT_COVERED;
1730     } else if (*linkp == '\\' || *linkp == '/') {
1731 #if 0   
1732         /* formerly, this was considered to be from the AFS root,
1733          * but this seems to create problems.  instead, we will just
1734          * reject the link */
1735         strcpy(tsp->data, linkp+1);
1736         *newRootScpp = cm_data.rootSCachep;
1737         cm_HoldSCache(cm_data.rootSCachep);
1738 #else
1739         /* we still copy the link data into the response so that 
1740          * the user can see what the link points to
1741          */
1742         linkScp->fileType = CM_SCACHETYPE_INVALID;
1743         strcpy(tsp->data, linkp);
1744         *newRootScpp = NULL;
1745         code = CM_ERROR_NOSUCHPATH;
1746 #endif  
1747     } else {
1748         /* a relative link */
1749         strcpy(tsp->data, linkp);
1750         *newRootScpp = NULL;
1751     }
1752     if (pathSuffixp[0] != 0) {  /* if suffix string is non-null */
1753         strcat(tsp->data, "\\");
1754         strcat(tsp->data, pathSuffixp);
1755     }
1756     *newSpaceBufferp = tsp;
1757
1758   done:
1759     lock_ReleaseMutex(&linkScp->mx);
1760     return code;
1761 }
1762 #ifdef DEBUG_REFCOUNT
1763 long cm_NameIDbg(cm_scache_t *rootSCachep, char *pathp, long flags,
1764                cm_user_t *userp, char *tidPathp, cm_req_t *reqp, cm_scache_t **outScpp, 
1765                char * file, long line)
1766 #else
1767 long cm_NameI(cm_scache_t *rootSCachep, char *pathp, long flags,
1768                cm_user_t *userp, char *tidPathp, cm_req_t *reqp, cm_scache_t **outScpp)
1769 #endif
1770 {
1771     long code;
1772     char *tp;                   /* ptr moving through input buffer */
1773     char tc;                    /* temp char */
1774     int haveComponent;          /* has new component started? */
1775     char component[256];        /* this is the new component */
1776     char *cp;                   /* component name being assembled */
1777     cm_scache_t *tscp;          /* current location in the hierarchy */
1778     cm_scache_t *nscp;          /* next dude down */
1779     cm_scache_t *dirScp;        /* last dir we searched */
1780     cm_scache_t *linkScp;       /* new root for the symlink we just
1781     * looked up */
1782     cm_space_t *psp;            /* space for current path, if we've hit
1783     * any symlinks */
1784     cm_space_t *tempsp;         /* temp vbl */
1785     char *restp;                /* rest of the pathname to interpret */
1786     int symlinkCount;           /* count of # of symlinks traversed */
1787     int extraFlag;              /* avoid chasing mt pts for dir cmd */
1788     int phase = 1;              /* 1 = tidPathp, 2 = pathp */
1789 #define MAX_FID_COUNT 512
1790     cm_fid_t fids[MAX_FID_COUNT]; /* array of fids processed in this path walk */
1791     int fid_count = 0;          /* number of fids processed in this path walk */
1792     int i;
1793
1794 #ifdef DEBUG_REFCOUNT
1795     afsi_log("%s:%d cm_NameI rootscp 0x%p ref %d", file, line, rootSCachep, rootSCachep->refCount);
1796     osi_Log4(afsd_logp,"cm_NameI rootscp 0x%p path %s tidpath %s flags 0x%x",
1797               rootSCachep, pathp ? pathp : "<NULL>", tidPathp ? tidPathp : "<NULL>", 
1798               flags);
1799 #endif
1800
1801     tp = tidPathp;
1802     if (tp == NULL) {
1803         tp = pathp;
1804         phase = 2;
1805     }
1806     if (tp == NULL) {
1807         tp = "";
1808     }
1809     haveComponent = 0;
1810     psp = NULL;
1811     tscp = rootSCachep;
1812     cm_HoldSCache(tscp);
1813     symlinkCount = 0;
1814     dirScp = NULL;
1815
1816
1817     while (1) {
1818         tc = *tp++;
1819
1820         /* map Unix slashes into DOS ones so we can interpret Unix
1821          * symlinks properly
1822          */
1823         if (tc == '/') 
1824             tc = '\\';
1825
1826         if (!haveComponent) {
1827             if (tc == '\\') {
1828                 continue;
1829             } else if (tc == 0) {
1830                 if (phase == 1) {
1831                     phase = 2;
1832                     tp = pathp;
1833                     continue;
1834                 }
1835                 code = 0;
1836                 break;
1837             } else {
1838                 haveComponent = 1;
1839                 cp = component;
1840                 *cp++ = tc;
1841             }
1842         } else {
1843             /* we have a component here */
1844             if (tc == 0 || tc == '\\') {
1845                 /* end of the component; we're at the last
1846                  * component if tc == 0.  However, if the last
1847                  * is a symlink, we have more to do.
1848                  */
1849                 *cp++ = 0;      /* add null termination */
1850                 extraFlag = 0;
1851                 if ((flags & CM_FLAG_DIRSEARCH) && tc == 0)
1852                     extraFlag = CM_FLAG_NOMOUNTCHASE;
1853                 code = cm_Lookup(tscp, component,
1854                                   flags | extraFlag,
1855                                   userp, reqp, &nscp);
1856
1857                 if (code == 0) {
1858                     if (!strcmp(component,".."))
1859                         fid_count -=2;
1860                     for ( i=0; i<fid_count; i++) {
1861                         if ( strcmp(component,".") && !cm_FidCmp(&nscp->fid, &fids[i]) ) {
1862                             code = CM_ERROR_TOO_MANY_SYMLINKS;
1863                             cm_ReleaseSCache(nscp);
1864                             nscp = NULL;
1865                             break;
1866                         }
1867                     }
1868                     if (i == fid_count && fid_count < MAX_FID_COUNT) {
1869                         fids[fid_count++] = nscp->fid;
1870                     }
1871                 }
1872                 
1873                 if (code) {
1874                     cm_ReleaseSCache(tscp);
1875                     if (dirScp)
1876                         cm_ReleaseSCache(dirScp);
1877                     if (psp) 
1878                         cm_FreeSpace(psp);
1879                     if (code == CM_ERROR_NOSUCHFILE && tscp->fileType == CM_SCACHETYPE_SYMLINK) {
1880                         osi_Log0(afsd_logp,"cm_NameI code CM_ERROR_NOSUCHPATH");
1881                         return CM_ERROR_NOSUCHPATH;
1882                     } else {
1883                         osi_Log1(afsd_logp,"cm_NameI code 0x%x", code);
1884                         return code;
1885                     }
1886                 }       
1887                 haveComponent = 0;      /* component done */
1888                 if (dirScp)
1889                     cm_ReleaseSCache(dirScp);
1890                 dirScp = tscp;          /* for some symlinks */
1891                 tscp = nscp;            /* already held */
1892                 nscp = NULL;
1893                 if (tc == 0 && !(flags & CM_FLAG_FOLLOW) && phase == 2) {
1894                     code = 0;
1895                     if (dirScp) {
1896                         cm_ReleaseSCache(dirScp);
1897                         dirScp = NULL;
1898                     }
1899                     break;
1900                 }
1901
1902                 /* now, if tscp is a symlink, we should follow
1903                  * it and assemble the path again.
1904                  */
1905                 lock_ObtainMutex(&tscp->mx);
1906                 code = cm_SyncOp(tscp, NULL, userp, reqp, 0,
1907                                   CM_SCACHESYNC_GETSTATUS
1908                                   | CM_SCACHESYNC_NEEDCALLBACK);
1909                 if (code) {
1910                     lock_ReleaseMutex(&tscp->mx);
1911                     cm_ReleaseSCache(tscp);
1912                     tscp = NULL;
1913                     if (dirScp) {
1914                         cm_ReleaseSCache(dirScp);
1915                         dirScp = NULL;
1916                     }
1917                     break;
1918                 }
1919                 cm_SyncOpDone(tscp, NULL, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
1920
1921                 if (tscp->fileType == CM_SCACHETYPE_SYMLINK) {
1922                     /* this is a symlink; assemble a new buffer */
1923                     lock_ReleaseMutex(&tscp->mx);
1924                     if (symlinkCount++ >= MAX_SYMLINK_COUNT) {
1925                         cm_ReleaseSCache(tscp);
1926                         tscp = NULL;
1927                         if (dirScp) {
1928                             cm_ReleaseSCache(dirScp);
1929                             dirScp = NULL;
1930                         }
1931                         if (psp) 
1932                             cm_FreeSpace(psp);
1933                         osi_Log0(afsd_logp,"cm_NameI code CM_ERROR_TOO_MANY_SYMLINKS");
1934                         return CM_ERROR_TOO_MANY_SYMLINKS;
1935                     }
1936                     if (tc == 0) 
1937                         restp = "";
1938                     else 
1939                         restp = tp;
1940                     code = cm_AssembleLink(tscp, restp, &linkScp, &tempsp, userp, reqp);
1941
1942                     if (code == 0 && linkScp != NULL) {
1943                         for ( i=0; i<fid_count; i++) {
1944                             if ( !cm_FidCmp(&linkScp->fid, &fids[i]) ) {
1945                                 code = CM_ERROR_TOO_MANY_SYMLINKS;
1946                                 cm_ReleaseSCache(linkScp);
1947                                 nscp = NULL;
1948                                 break;
1949                             }
1950                         }
1951                         if (i == fid_count && fid_count < MAX_FID_COUNT) {
1952                             fids[fid_count++] = linkScp->fid;
1953                         }
1954                     }
1955
1956                     if (code) {
1957                         /* something went wrong */
1958                         cm_ReleaseSCache(tscp);
1959                         tscp = NULL;
1960                         if (dirScp) {
1961                             cm_ReleaseSCache(dirScp);
1962                             dirScp = NULL;
1963                         }
1964                         break;
1965                     }
1966
1967                     /* otherwise, tempsp has the new path,
1968                      * and linkScp is the new root from
1969                      * which to interpret that path.
1970                      * Continue with the namei processing,
1971                      * also doing the bookkeeping for the
1972                      * space allocation and tracking the
1973                      * vnode reference counts.
1974                      */
1975                     if (psp) 
1976                         cm_FreeSpace(psp);
1977                     psp = tempsp;
1978                     tp = psp->data;
1979                     cm_ReleaseSCache(tscp);
1980                     tscp = linkScp;
1981                     linkScp = NULL;
1982                     /* already held
1983                      * by AssembleLink
1984                      * now, if linkScp is null, that's
1985                      * AssembleLink's way of telling us that
1986                      * the sym link is relative to the dir
1987                      * containing the link.  We have a ref
1988                      * to it in dirScp, and we hold it now
1989                      * and reuse it as the new spot in the
1990                      * dir hierarchy.
1991                      */
1992                     if (tscp == NULL) {
1993                         tscp = dirScp;
1994                         dirScp = NULL;
1995                     }
1996                 } else {
1997                     /* not a symlink, we may be done */
1998                     lock_ReleaseMutex(&tscp->mx);
1999                     if (tc == 0) {
2000                         if (phase == 1) {
2001                             phase = 2;
2002                             tp = pathp;
2003                             continue;
2004                         }
2005                         if (dirScp) {
2006                             cm_ReleaseSCache(dirScp);
2007                             dirScp = NULL;
2008                         }
2009                         code = 0;
2010                         break;
2011                     }
2012                 }
2013                 if (dirScp) {
2014                     cm_ReleaseSCache(dirScp);
2015                     dirScp = NULL;
2016                 }
2017             } /* end of a component */
2018             else 
2019                 *cp++ = tc;
2020         } /* we have a component */
2021     } /* big while loop over all components */
2022
2023     /* already held */
2024     if (dirScp)
2025         cm_ReleaseSCache(dirScp);
2026     if (psp) 
2027         cm_FreeSpace(psp);
2028     if (code == 0) 
2029         *outScpp = tscp;
2030     else if (tscp)
2031         cm_ReleaseSCache(tscp);
2032
2033 #ifdef DEBUG_REFCOUNT
2034     afsi_log("%s:%d cm_NameI code 0x%x outScpp 0x%p ref %d", file, line, code, *outScpp, (*outScpp)->refCount);
2035 #endif
2036     osi_Log2(afsd_logp,"cm_NameI code 0x%x outScpp 0x%p", code, *outScpp);
2037     return code;
2038 }
2039
2040 /* called with a dir, and a vnode within the dir that happens to be a symlink.
2041  * We chase the link, and return a held pointer to the target, if it exists,
2042  * in *outScpp.  If we succeed, we return 0, otherwise we return an error code
2043  * and do not hold or return a target vnode.
2044  *
2045  * This is very similar to calling cm_NameI with the last component of a name,
2046  * which happens to be a symlink, except that we've already passed by the name.
2047  *
2048  * This function is typically called by the directory listing functions, which
2049  * encounter symlinks but need to return the proper file length so programs
2050  * like "more" work properly when they make use of the attributes retrieved from
2051  * the dir listing.
2052  *
2053  * The input vnode should not be locked when this function is called.
2054  */
2055 long cm_EvaluateSymLink(cm_scache_t *dscp, cm_scache_t *linkScp,
2056                          cm_scache_t **outScpp, cm_user_t *userp, cm_req_t *reqp)
2057 {
2058     long code;
2059     cm_space_t *spacep;
2060     cm_scache_t *newRootScp;
2061
2062     osi_Log1(afsd_logp, "Evaluating symlink scp 0x%p", linkScp);
2063
2064     code = cm_AssembleLink(linkScp, "", &newRootScp, &spacep, userp, reqp);
2065     if (code) 
2066         return code;
2067
2068     /* now, if newRootScp is NULL, we're really being told that the symlink
2069      * is relative to the current directory (dscp).
2070      */
2071     if (newRootScp == NULL) {
2072         newRootScp = dscp;
2073         cm_HoldSCache(dscp);
2074     }
2075
2076     code = cm_NameI(newRootScp, spacep->data,
2077                      CM_FLAG_CASEFOLD | CM_FLAG_FOLLOW | CM_FLAG_DIRSEARCH,
2078                      userp, NULL, reqp, outScpp);
2079
2080     if (code == CM_ERROR_NOSUCHFILE)
2081         code = CM_ERROR_NOSUCHPATH;
2082
2083     /* this stuff is allocated no matter what happened on the namei call,
2084      * so free it */
2085     cm_FreeSpace(spacep);
2086     cm_ReleaseSCache(newRootScp);
2087
2088     if (linkScp == *outScpp) {
2089         cm_ReleaseSCache(*outScpp);
2090         *outScpp = NULL;
2091         code = CM_ERROR_NOSUCHPATH;
2092     }
2093
2094     return code;
2095 }
2096
2097 /* make this big enough so that one buffer of dir pages won't overflow.  We'll
2098  * check anyway, but we want to minimize the chance that we have to leave stuff
2099  * unstat'd.
2100  */
2101 #define CM_BULKMAX              (3 * AFSCBMAX)
2102
2103 /* rock for bulk stat calls */
2104 typedef struct cm_bulkStat {
2105     osi_hyper_t bufOffset;      /* only do it for things in this buffer page */
2106
2107     /* info for the actual call */
2108     int counter;                        /* next free slot */
2109     AFSFid fids[CM_BULKMAX];
2110     AFSFetchStatus stats[CM_BULKMAX];
2111     AFSCallBack callbacks[CM_BULKMAX];
2112 } cm_bulkStat_t;
2113
2114 /* for a given entry, make sure that it isn't in the stat cache, and then
2115  * add it to the list of file IDs to be obtained.
2116  *
2117  * Don't bother adding it if we already have a vnode.  Note that the dir
2118  * is locked, so we have to be careful checking the vnode we're thinking of
2119  * processing, to avoid deadlocks.
2120  */
2121 long cm_TryBulkProc(cm_scache_t *scp, cm_dirEntry_t *dep, void *rockp,
2122                      osi_hyper_t *offp)
2123 {
2124     osi_hyper_t thyper;
2125     cm_bulkStat_t *bsp;
2126     int i;
2127     cm_scache_t *tscp;
2128     cm_fid_t tfid;
2129
2130     bsp = rockp;
2131
2132     /* Don't overflow bsp. */
2133     if (bsp->counter >= CM_BULKMAX)
2134         return CM_ERROR_STOPNOW;
2135
2136     thyper.LowPart = cm_data.buf_blockSize;
2137     thyper.HighPart = 0;
2138     thyper = LargeIntegerAdd(thyper, bsp->bufOffset);
2139
2140     /* thyper is now the first byte past the end of the record we're
2141      * interested in, and bsp->bufOffset is the first byte of the record
2142      * we're interested in.
2143      * Skip data in the others.
2144      * Skip '.' and '..'
2145      */
2146     if (LargeIntegerLessThan(*offp, bsp->bufOffset))
2147         return 0;
2148     if (LargeIntegerGreaterThanOrEqualTo(*offp, thyper))
2149         return CM_ERROR_STOPNOW;
2150     if (strcmp(dep->name, ".") == 0 || strcmp(dep->name, "..") == 0)
2151         return 0;
2152
2153     tfid.cell = scp->fid.cell;
2154     tfid.volume = scp->fid.volume;
2155     tfid.vnode = ntohl(dep->fid.vnode);
2156     tfid.unique = ntohl(dep->fid.unique);
2157     tscp = cm_FindSCache(&tfid);
2158     if (tscp) {
2159         if (lock_TryMutex(&tscp->mx)) {
2160             /* we have an entry that we can look at */
2161             if (!(tscp->flags & CM_SCACHEFLAG_EACCESS) && cm_HaveCallback(tscp)) {
2162                 /* we have a callback on it.  Don't bother
2163                  * fetching this stat entry, since we're happy
2164                  * with the info we have.
2165                  */
2166                 lock_ReleaseMutex(&tscp->mx);
2167                 cm_ReleaseSCache(tscp);
2168                 return 0;
2169             }
2170             lock_ReleaseMutex(&tscp->mx);
2171         }       /* got lock */
2172         cm_ReleaseSCache(tscp);
2173     }   /* found entry */
2174
2175 #ifdef AFS_FREELANCE_CLIENT
2176     // yj: if this is a mountpoint under root.afs then we don't want it
2177     // to be bulkstat-ed, instead, we call getSCache directly and under
2178     // getSCache, it is handled specially.
2179     if  ( cm_freelanceEnabled &&
2180           tfid.cell==AFS_FAKE_ROOT_CELL_ID && 
2181           tfid.volume==AFS_FAKE_ROOT_VOL_ID &&
2182           !(tfid.vnode==0x1 && tfid.unique==0x1) )
2183     {       
2184         osi_Log0(afsd_logp, "cm_TryBulkProc Freelance calls cm_SCache on root.afs mountpoint");
2185         return cm_GetSCache(&tfid, &tscp, NULL, NULL);
2186     }
2187 #endif /* AFS_FREELANCE_CLIENT */
2188
2189     i = bsp->counter++;
2190     bsp->fids[i].Volume = scp->fid.volume;
2191     bsp->fids[i].Vnode = tfid.vnode;
2192     bsp->fids[i].Unique = tfid.unique;
2193     return 0;
2194 }       
2195
2196 /* called with a locked scp and a pointer to a buffer.  Make bulk stat
2197  * calls on all undeleted files in the page of the directory specified.
2198  */
2199 afs_int32
2200 cm_TryBulkStat(cm_scache_t *dscp, osi_hyper_t *offsetp, cm_user_t *userp,
2201                cm_req_t *reqp)
2202 {
2203     long code;
2204     cm_bulkStat_t bb;   /* this is *BIG*, probably 16K or so;
2205                          * watch for stack problems */
2206     AFSCBFids fidStruct;
2207     AFSBulkStats statStruct;
2208     cm_conn_t *connp;
2209     AFSCBs callbackStruct;
2210     long filex;
2211     AFSVolSync volSync;
2212     cm_callbackRequest_t cbReq;
2213     long filesThisCall;
2214     long i;
2215     long j;
2216     cm_scache_t *scp;
2217     cm_fid_t tfid;
2218     struct rx_connection * callp;
2219     int inlinebulk = 0;         /* Did we use InlineBulkStatus RPC or not? */
2220
2221     osi_Log1(afsd_logp, "cm_TryBulkStat dir 0x%p", dscp);
2222
2223     /* should be on a buffer boundary */
2224     osi_assert((offsetp->LowPart & (cm_data.buf_blockSize - 1)) == 0);
2225
2226     memset(&bb, 0, sizeof(bb));
2227     bb.bufOffset = *offsetp;
2228
2229     lock_ReleaseMutex(&dscp->mx);
2230     /* first, assemble the file IDs we need to stat */
2231     code = cm_ApplyDir(dscp, cm_TryBulkProc, (void *) &bb, offsetp, userp, reqp, NULL);
2232
2233     /* if we failed, bail out early */
2234     if (code && code != CM_ERROR_STOPNOW) {
2235         lock_ObtainMutex(&dscp->mx);
2236         return code;
2237     }
2238
2239     /* otherwise, we may have one or more bulk stat's worth of stuff in bb;
2240      * make the calls to create the entries.  Handle AFSCBMAX files at a
2241      * time.
2242      */
2243     filex = 0;
2244     while (filex < bb.counter) {
2245         filesThisCall = bb.counter - filex;
2246         if (filesThisCall > AFSCBMAX) 
2247             filesThisCall = AFSCBMAX;
2248
2249         fidStruct.AFSCBFids_len = filesThisCall;
2250         fidStruct.AFSCBFids_val = &bb.fids[filex];
2251         statStruct.AFSBulkStats_len = filesThisCall;
2252         statStruct.AFSBulkStats_val = &bb.stats[filex];
2253         callbackStruct.AFSCBs_len = filesThisCall;
2254         callbackStruct.AFSCBs_val = &bb.callbacks[filex];
2255         cm_StartCallbackGrantingCall(NULL, &cbReq);
2256         osi_Log1(afsd_logp, "CALL BulkStatus, %d entries", filesThisCall);
2257         do {
2258             code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
2259             if (code) 
2260                 continue;
2261
2262             callp = cm_GetRxConn(connp);
2263             if (!(connp->serverp->flags & CM_SERVERFLAG_NOINLINEBULK)) {
2264                 code = RXAFS_InlineBulkStatus(callp, &fidStruct,
2265                                      &statStruct, &callbackStruct, &volSync);
2266                 if (code == RXGEN_OPCODE) {
2267                     cm_SetServerNoInlineBulk(connp->serverp, 0);
2268                 } else {
2269                     inlinebulk = 1;
2270                 }
2271             }
2272             if (!inlinebulk) {
2273                 code = RXAFS_BulkStatus(callp, &fidStruct,
2274                                         &statStruct, &callbackStruct, &volSync);
2275             }
2276             rx_PutConnection(callp);
2277
2278         } while (cm_Analyze(connp, userp, reqp, &dscp->fid,
2279                              &volSync, NULL, &cbReq, code));
2280         code = cm_MapRPCError(code, reqp);
2281         if (code)
2282             osi_Log2(afsd_logp, "CALL %sBulkStatus FAILURE code 0x%x", 
2283                       inlinebulk ? "Inline" : "", code);
2284         else
2285             osi_Log1(afsd_logp, "CALL %sBulkStatus SUCCESS", inlinebulk ? "Inline" : "");
2286
2287         /* may as well quit on an error, since we're not going to do
2288          * much better on the next immediate call, either.
2289          */
2290         if (code) {
2291             cm_EndCallbackGrantingCall(NULL, &cbReq, NULL, 0);
2292             break;
2293         }
2294
2295         /* otherwise, we should do the merges */
2296         for (i = 0; i<filesThisCall; i++) {
2297             j = filex + i;
2298             tfid.cell = dscp->fid.cell;
2299             tfid.volume = bb.fids[j].Volume;
2300             tfid.vnode = bb.fids[j].Vnode;
2301             tfid.unique = bb.fids[j].Unique;
2302             code = cm_GetSCache(&tfid, &scp, userp, reqp);
2303             if (code != 0) 
2304                 continue;
2305
2306             /* otherwise, if this entry has no callback info, 
2307              * merge in this.
2308              */
2309             lock_ObtainMutex(&scp->mx);
2310             /* now, we have to be extra paranoid on merging in this
2311              * information, since we didn't use cm_SyncOp before
2312              * starting the fetch to make sure that no bad races
2313              * were occurring.  Specifically, we need to make sure
2314              * we don't obliterate any newer information in the
2315              * vnode than have here.
2316              *
2317              * Right now, be pretty conservative: if there's a
2318              * callback or a pending call, skip it.
2319              */
2320             if ((scp->cbServerp == NULL || (scp->flags & CM_SCACHEFLAG_EACCESS))
2321                  && !(scp->flags &
2322                        (CM_SCACHEFLAG_FETCHING
2323                          | CM_SCACHEFLAG_STORING
2324                          | CM_SCACHEFLAG_SIZESTORING))) {
2325                 cm_EndCallbackGrantingCall(scp, &cbReq,
2326                                             &bb.callbacks[j],
2327                                             CM_CALLBACK_MAINTAINCOUNT);
2328                 cm_MergeStatus(dscp, scp, &bb.stats[j], &volSync, userp, 0);
2329             }       
2330             lock_ReleaseMutex(&scp->mx);
2331             cm_ReleaseSCache(scp);
2332         } /* all files in the response */
2333         /* now tell it to drop the count,
2334          * after doing the vnode processing above */
2335         cm_EndCallbackGrantingCall(NULL, &cbReq, NULL, 0);
2336
2337         filex += filesThisCall;
2338     }   /* while there are still more files to process */
2339     lock_ObtainMutex(&dscp->mx);
2340
2341     /* If we did the InlineBulk RPC pull out the return code and log it */
2342     if (inlinebulk) {
2343         if ((&bb.stats[0])->errorCode) {
2344             osi_Log1(afsd_logp, "cm_TryBulkStat bulk stat error: %d", 
2345                      (&bb.stats[0])->errorCode);
2346         }
2347     }
2348
2349     osi_Log0(afsd_logp, "END cm_TryBulkStat");
2350     return 0;
2351 }       
2352
2353 void cm_StatusFromAttr(AFSStoreStatus *statusp, cm_scache_t *scp, cm_attr_t *attrp)
2354 {
2355     long mask;
2356
2357     /* initialize store back mask as inexpensive local variable */
2358     mask = 0;
2359     memset(statusp, 0, sizeof(AFSStoreStatus));
2360
2361     /* copy out queued info from scache first, if scp passed in */
2362     if (scp) {
2363         if (scp->mask & CM_SCACHEMASK_CLIENTMODTIME) {
2364             statusp->ClientModTime = scp->clientModTime;
2365             mask |= AFS_SETMODTIME;
2366             scp->mask &= ~CM_SCACHEMASK_CLIENTMODTIME;
2367         }
2368     }
2369
2370     if (attrp) {
2371         /* now add in our locally generated request */
2372         if (attrp->mask & CM_ATTRMASK_CLIENTMODTIME) {
2373             statusp->ClientModTime = attrp->clientModTime;
2374             mask |= AFS_SETMODTIME;
2375         }
2376         if (attrp->mask & CM_ATTRMASK_UNIXMODEBITS) {
2377             statusp->UnixModeBits = attrp->unixModeBits;
2378             mask |= AFS_SETMODE;
2379         }
2380         if (attrp->mask & CM_ATTRMASK_OWNER) {
2381             statusp->Owner = attrp->owner;
2382             mask |= AFS_SETOWNER;
2383         }
2384         if (attrp->mask & CM_ATTRMASK_GROUP) {
2385             statusp->Group = attrp->group;
2386             mask |= AFS_SETGROUP;
2387         }
2388     }
2389     statusp->Mask = mask;
2390 }       
2391
2392 /* set the file size, and make sure that all relevant buffers have been
2393  * truncated.  Ensure that any partially truncated buffers have been zeroed
2394  * to the end of the buffer.
2395  */
2396 long cm_SetLength(cm_scache_t *scp, osi_hyper_t *sizep, cm_user_t *userp,
2397                    cm_req_t *reqp)
2398 {
2399     long code;
2400     int shrinking;
2401
2402     /* start by locking out buffer creation */
2403     lock_ObtainWrite(&scp->bufCreateLock);
2404
2405     /* verify that this is a file, not a dir or a symlink */
2406     lock_ObtainMutex(&scp->mx);
2407     code = cm_SyncOp(scp, NULL, userp, reqp, 0,
2408                       CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
2409     if (code) 
2410         goto done;
2411     cm_SyncOpDone(scp, NULL, CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS);
2412
2413     if (scp->fileType != CM_SCACHETYPE_FILE) {
2414         code = CM_ERROR_ISDIR;
2415         goto done;
2416     }
2417
2418   startover:
2419     if (LargeIntegerLessThan(*sizep, scp->length))
2420         shrinking = 1;
2421     else
2422         shrinking = 0;
2423
2424     lock_ReleaseMutex(&scp->mx);
2425
2426     /* can't hold scp->mx lock here, since we may wait for a storeback to
2427      * finish if the buffer package is cleaning a buffer by storing it to
2428      * the server.
2429      */
2430     if (shrinking)
2431         buf_Truncate(scp, userp, reqp, sizep);
2432
2433     /* now ensure that file length is short enough, and update truncPos */
2434     lock_ObtainMutex(&scp->mx);
2435
2436     /* make sure we have a callback (so we have the right value for the
2437      * length), and wait for it to be safe to do a truncate.
2438      */
2439     code = cm_SyncOp(scp, NULL, userp, reqp, PRSFS_WRITE,
2440                       CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS
2441                       | CM_SCACHESYNC_SETSTATUS | CM_SCACHESYNC_SETSIZE);
2442
2443     /* If we only have 'i' bits, then we should still be able to set
2444        the size of a file we created. */
2445     if (code == CM_ERROR_NOACCESS && scp->creator == userp) {
2446         code = cm_SyncOp(scp, NULL, userp, reqp, PRSFS_INSERT,
2447                          CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS
2448                          | CM_SCACHESYNC_SETSTATUS | CM_SCACHESYNC_SETSIZE);
2449     }
2450
2451     if (code) 
2452         goto done;
2453
2454     if (LargeIntegerLessThan(*sizep, scp->length)) {
2455         /* a real truncation.  If truncPos is not set yet, or is bigger
2456          * than where we're truncating the file, set truncPos to this
2457          * new value.
2458          */
2459         if (!shrinking)
2460             goto startover;
2461         if (!(scp->mask & CM_SCACHEMASK_TRUNCPOS)
2462              || LargeIntegerLessThan(*sizep, scp->length)) {
2463             /* set trunc pos */
2464             scp->truncPos = *sizep;
2465             scp->mask |= CM_SCACHEMASK_TRUNCPOS;
2466         }
2467         /* in either case, the new file size has been changed */
2468         scp->length = *sizep;
2469         scp->mask |= CM_SCACHEMASK_LENGTH;
2470     }
2471     else if (LargeIntegerGreaterThan(*sizep, scp->length)) {
2472         /* really extending the file */
2473         scp->length = *sizep;
2474         scp->mask |= CM_SCACHEMASK_LENGTH;
2475     }
2476
2477     /* done successfully */
2478     code = 0;
2479
2480     cm_SyncOpDone(scp, NULL, 
2481                    CM_SCACHESYNC_NEEDCALLBACK | CM_SCACHESYNC_GETSTATUS
2482                    | CM_SCACHESYNC_SETSTATUS | CM_SCACHESYNC_SETSIZE);
2483
2484   done:
2485     lock_ReleaseMutex(&scp->mx);
2486     lock_ReleaseWrite(&scp->bufCreateLock);
2487
2488     return code;
2489 }
2490
2491 /* set the file size or other attributes (but not both at once) */
2492 long cm_SetAttr(cm_scache_t *scp, cm_attr_t *attrp, cm_user_t *userp,
2493                 cm_req_t *reqp)
2494 {
2495     long code;
2496     AFSFetchStatus afsOutStatus;
2497     AFSVolSync volSync;
2498     cm_conn_t *connp;
2499     AFSFid tfid;
2500     AFSStoreStatus afsInStatus;
2501     struct rx_connection * callp;
2502
2503     /* handle file length setting */
2504     if (attrp->mask & CM_ATTRMASK_LENGTH)
2505         return cm_SetLength(scp, &attrp->length, userp, reqp);
2506
2507     lock_ObtainMutex(&scp->mx);
2508     /* otherwise, we have to make an RPC to get the status */
2509     code = cm_SyncOp(scp, NULL, userp, reqp, 0, CM_SCACHESYNC_STORESTATUS);
2510     if (code) {
2511         lock_ReleaseMutex(&scp->mx);
2512         return code;
2513     }
2514
2515     /* make the attr structure */
2516     cm_StatusFromAttr(&afsInStatus, scp, attrp);
2517
2518     tfid.Volume = scp->fid.volume;
2519     tfid.Vnode = scp->fid.vnode;
2520     tfid.Unique = scp->fid.unique;
2521         lock_ReleaseMutex(&scp->mx);
2522
2523     /* now make the RPC */
2524     osi_Log1(afsd_logp, "CALL StoreStatus scp 0x%p", scp);
2525     do {
2526         code = cm_ConnFromFID(&scp->fid, userp, reqp, &connp);
2527         if (code) 
2528             continue;
2529
2530         callp = cm_GetRxConn(connp);
2531         code = RXAFS_StoreStatus(callp, &tfid,
2532                                   &afsInStatus, &afsOutStatus, &volSync);
2533         rx_PutConnection(callp);
2534
2535     } while (cm_Analyze(connp, userp, reqp,
2536                          &scp->fid, &volSync, NULL, NULL, code));
2537     code = cm_MapRPCError(code, reqp);
2538
2539     if (code)
2540         osi_Log1(afsd_logp, "CALL StoreStatus FAILURE, code 0x%x", code);
2541     else
2542         osi_Log0(afsd_logp, "CALL StoreStatus SUCCESS");
2543
2544     lock_ObtainMutex(&scp->mx);
2545     cm_SyncOpDone(scp, NULL, CM_SCACHESYNC_STORESTATUS);
2546     if (code == 0)
2547         cm_MergeStatus(NULL, scp, &afsOutStatus, &volSync, userp,
2548                         CM_MERGEFLAG_FORCE|CM_MERGEFLAG_STOREDATA);
2549         
2550     /* if we're changing the mode bits, discard the ACL cache, 
2551      * since we changed the mode bits.
2552      */
2553     if (afsInStatus.Mask & AFS_SETMODE) 
2554         cm_FreeAllACLEnts(scp);
2555     lock_ReleaseMutex(&scp->mx);
2556     return code;
2557 }       
2558
2559 long cm_Create(cm_scache_t *dscp, char *namep, long flags, cm_attr_t *attrp,
2560                cm_scache_t **scpp, cm_user_t *userp, cm_req_t *reqp)
2561 {       
2562     cm_conn_t *connp;
2563     long code;
2564     AFSFid dirAFSFid;
2565     cm_callbackRequest_t cbReq;
2566     AFSFid newAFSFid;
2567     cm_fid_t newFid;
2568     cm_scache_t *scp = NULL;
2569     int didEnd;
2570     AFSStoreStatus inStatus;
2571     AFSFetchStatus updatedDirStatus;
2572     AFSFetchStatus newFileStatus;
2573     AFSCallBack newFileCallback;
2574     AFSVolSync volSync;
2575     struct rx_connection * callp;
2576     cm_dirOp_t dirop;
2577
2578     /* can't create names with @sys in them; must expand it manually first.
2579      * return "invalid request" if they try.
2580      */
2581     if (cm_ExpandSysName(namep, NULL, 0, 0)) {
2582         return CM_ERROR_ATSYS;
2583     }
2584
2585     /* before starting the RPC, mark that we're changing the file data, so
2586      * that someone who does a chmod will know to wait until our call
2587      * completes.
2588      */
2589     lock_ObtainMutex(&dscp->mx);
2590     cm_BeginDirOp(dscp, userp, reqp, &dirop);
2591     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, CM_SCACHESYNC_STOREDATA);
2592     if (code == 0) {
2593         cm_StartCallbackGrantingCall(NULL, &cbReq);
2594     } else {
2595         cm_EndDirOp(&dirop);
2596     }
2597     lock_ReleaseMutex(&dscp->mx);
2598     if (code) {
2599         return code;
2600     }
2601     didEnd = 0;
2602
2603     cm_StatusFromAttr(&inStatus, NULL, attrp);
2604
2605     /* try the RPC now */
2606     osi_Log1(afsd_logp, "CALL CreateFile scp 0x%p", dscp);
2607     do {
2608         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
2609         if (code) 
2610             continue;
2611
2612         dirAFSFid.Volume = dscp->fid.volume;
2613         dirAFSFid.Vnode = dscp->fid.vnode;
2614         dirAFSFid.Unique = dscp->fid.unique;
2615
2616         callp = cm_GetRxConn(connp);
2617         code = RXAFS_CreateFile(connp->callp, &dirAFSFid, namep,
2618                                  &inStatus, &newAFSFid, &newFileStatus,
2619                                  &updatedDirStatus, &newFileCallback,
2620                                  &volSync);
2621         rx_PutConnection(callp);
2622
2623     } while (cm_Analyze(connp, userp, reqp,
2624                          &dscp->fid, &volSync, NULL, &cbReq, code));
2625     code = cm_MapRPCError(code, reqp);
2626         
2627     if (code)
2628         osi_Log1(afsd_logp, "CALL CreateFile FAILURE, code 0x%x", code);
2629     else
2630         osi_Log0(afsd_logp, "CALL CreateFile SUCCESS");
2631
2632     lock_ObtainMutex(&dscp->mx);
2633     cm_SyncOpDone(dscp, NULL, CM_SCACHESYNC_STOREDATA);
2634     if (code == 0) {
2635         cm_MergeStatus(NULL, dscp, &updatedDirStatus, &volSync, userp, 0);
2636     }
2637     lock_ReleaseMutex(&dscp->mx);
2638
2639     /* now try to create the file's entry, too, but be careful to 
2640      * make sure that we don't merge in old info.  Since we weren't locking
2641      * out any requests during the file's creation, we may have pretty old
2642      * info.
2643      */
2644     if (code == 0) {
2645         newFid.cell = dscp->fid.cell;
2646         newFid.volume = dscp->fid.volume;
2647         newFid.vnode = newAFSFid.Vnode;
2648         newFid.unique = newAFSFid.Unique;
2649         code = cm_GetSCache(&newFid, &scp, userp, reqp);
2650         if (code == 0) {
2651             lock_ObtainMutex(&scp->mx);
2652             scp->creator = userp;               /* remember who created it */
2653             if (!cm_HaveCallback(scp)) {
2654                 cm_MergeStatus(dscp, scp, &newFileStatus, &volSync,
2655                                 userp, 0);
2656                 cm_EndCallbackGrantingCall(scp, &cbReq,
2657                                             &newFileCallback, 0);
2658                 didEnd = 1;     
2659             }       
2660             lock_ReleaseMutex(&scp->mx);
2661             *scpp = scp;
2662         }
2663     }
2664
2665     /* make sure we end things properly */
2666     if (!didEnd)
2667         cm_EndCallbackGrantingCall(NULL, &cbReq, NULL, 0);
2668
2669     lock_ObtainMutex(&dscp->mx);
2670     if (scp && cm_CheckDirOpForSingleChange(&dirop)) {
2671         cm_DirCreateEntry(&dirop, namep, &newFid);
2672     }
2673     cm_EndDirOp(&dirop);
2674     lock_ReleaseMutex(&dscp->mx);
2675
2676     return code;
2677 }       
2678
2679 long cm_FSync(cm_scache_t *scp, cm_user_t *userp, cm_req_t *reqp)
2680 {
2681     long code;
2682
2683     lock_ObtainWrite(&scp->bufCreateLock);
2684     code = buf_CleanVnode(scp, userp, reqp);
2685     lock_ReleaseWrite(&scp->bufCreateLock);
2686     if (code == 0) {
2687         lock_ObtainMutex(&scp->mx);
2688
2689         if (scp->mask & (CM_SCACHEMASK_TRUNCPOS
2690                           | CM_SCACHEMASK_CLIENTMODTIME
2691                           | CM_SCACHEMASK_LENGTH))
2692             code = cm_StoreMini(scp, userp, reqp);
2693
2694         if (scp->flags & (CM_SCACHEFLAG_OVERQUOTA | CM_SCACHEFLAG_OUTOFSPACE)) {
2695             code = (scp->flags & CM_SCACHEFLAG_OVERQUOTA) ? CM_ERROR_QUOTA : CM_ERROR_SPACE;
2696             scp->flags &= ~(CM_SCACHEFLAG_OVERQUOTA | CM_SCACHEFLAG_OUTOFSPACE);
2697         }
2698
2699         lock_ReleaseMutex(&scp->mx);
2700     }
2701     return code;
2702 }
2703
2704 long cm_MakeDir(cm_scache_t *dscp, char *namep, long flags, cm_attr_t *attrp,
2705                  cm_user_t *userp, cm_req_t *reqp)
2706 {
2707     cm_conn_t *connp;
2708     long code;
2709     AFSFid dirAFSFid;
2710     cm_callbackRequest_t cbReq;
2711     AFSFid newAFSFid;
2712     cm_fid_t newFid;
2713     cm_scache_t *scp;
2714     int didEnd;
2715     AFSStoreStatus inStatus;
2716     AFSFetchStatus updatedDirStatus;
2717     AFSFetchStatus newDirStatus;
2718     AFSCallBack newDirCallback;
2719     AFSVolSync volSync;
2720     struct rx_connection * callp;
2721     cm_dirOp_t dirop;
2722
2723     /* can't create names with @sys in them; must expand it manually first.
2724      * return "invalid request" if they try.
2725      */
2726     if (cm_ExpandSysName(namep, NULL, 0, 0)) {
2727         return CM_ERROR_ATSYS;
2728     }
2729
2730     /* before starting the RPC, mark that we're changing the directory
2731      * data, so that someone who does a chmod on the dir will wait until
2732      * our call completes.
2733      */
2734     lock_ObtainMutex(&dscp->mx);
2735     cm_BeginDirOp(dscp, userp, reqp, &dirop);
2736     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, CM_SCACHESYNC_STOREDATA);
2737     if (code == 0) {
2738         cm_StartCallbackGrantingCall(NULL, &cbReq);
2739     } else {
2740         cm_EndDirOp(&dirop);
2741     }
2742     lock_ReleaseMutex(&dscp->mx);
2743     if (code) {
2744         return code;
2745     }
2746     didEnd = 0;
2747
2748     cm_StatusFromAttr(&inStatus, NULL, attrp);
2749
2750     /* try the RPC now */
2751     osi_Log1(afsd_logp, "CALL MakeDir scp 0x%p", dscp);
2752     do {
2753         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
2754         if (code) 
2755             continue;
2756
2757         dirAFSFid.Volume = dscp->fid.volume;
2758         dirAFSFid.Vnode = dscp->fid.vnode;
2759         dirAFSFid.Unique = dscp->fid.unique;
2760
2761         callp = cm_GetRxConn(connp);
2762         code = RXAFS_MakeDir(connp->callp, &dirAFSFid, namep,
2763                               &inStatus, &newAFSFid, &newDirStatus,
2764                               &updatedDirStatus, &newDirCallback,
2765                               &volSync);
2766         rx_PutConnection(callp);
2767
2768     } while (cm_Analyze(connp, userp, reqp,
2769                          &dscp->fid, &volSync, NULL, &cbReq, code));
2770     code = cm_MapRPCError(code, reqp);
2771         
2772     if (code)
2773         osi_Log1(afsd_logp, "CALL MakeDir FAILURE, code 0x%x", code);
2774     else
2775         osi_Log0(afsd_logp, "CALL MakeDir SUCCESS");
2776
2777     lock_ObtainMutex(&dscp->mx);
2778     cm_SyncOpDone(dscp, NULL, CM_SCACHESYNC_STOREDATA);
2779     if (code == 0) {
2780         cm_MergeStatus(NULL, dscp, &updatedDirStatus, &volSync, userp, 0);
2781     }
2782     lock_ReleaseMutex(&dscp->mx);
2783
2784     /* now try to create the new dir's entry, too, but be careful to 
2785      * make sure that we don't merge in old info.  Since we weren't locking
2786      * out any requests during the file's creation, we may have pretty old
2787      * info.
2788      */
2789     if (code == 0) {
2790         newFid.cell = dscp->fid.cell;
2791         newFid.volume = dscp->fid.volume;
2792         newFid.vnode = newAFSFid.Vnode;
2793         newFid.unique = newAFSFid.Unique;
2794         code = cm_GetSCache(&newFid, &scp, userp, reqp);
2795         if (code == 0) {
2796             lock_ObtainMutex(&scp->mx);
2797             if (!cm_HaveCallback(scp)) {
2798                 cm_MergeStatus(dscp, scp, &newDirStatus, &volSync,
2799                                 userp, 0);
2800                 cm_EndCallbackGrantingCall(scp, &cbReq,
2801                                             &newDirCallback, 0);
2802                 didEnd = 1;             
2803             }
2804             lock_ReleaseMutex(&scp->mx);
2805             cm_ReleaseSCache(scp);
2806         }
2807     }
2808
2809     /* make sure we end things properly */
2810     if (!didEnd)
2811         cm_EndCallbackGrantingCall(NULL, &cbReq, NULL, 0);
2812
2813     lock_ObtainMutex(&dscp->mx);
2814     if (scp && cm_CheckDirOpForSingleChange(&dirop)) {
2815         cm_DirCreateEntry(&dirop, namep, &newFid);
2816     }
2817     cm_EndDirOp(&dirop);
2818     lock_ReleaseMutex(&dscp->mx);
2819
2820     /* and return error code */
2821     return code;
2822 }       
2823
2824 long cm_Link(cm_scache_t *dscp, char *namep, cm_scache_t *sscp, long flags,
2825              cm_user_t *userp, cm_req_t *reqp)
2826 {
2827     cm_conn_t *connp;
2828     long code = 0;
2829     AFSFid dirAFSFid;
2830     AFSFid existingAFSFid;
2831     AFSFetchStatus updatedDirStatus;
2832     AFSFetchStatus newLinkStatus;
2833     AFSVolSync volSync;
2834     struct rx_connection * callp;
2835     cm_dirOp_t dirop;
2836
2837     if (dscp->fid.cell != sscp->fid.cell ||
2838         dscp->fid.volume != sscp->fid.volume) {
2839         return CM_ERROR_CROSSDEVLINK;
2840     }
2841
2842     lock_ObtainMutex(&dscp->mx);
2843     cm_BeginDirOp(dscp, userp, reqp, &dirop);
2844     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, CM_SCACHESYNC_STOREDATA);
2845     if (code != 0)
2846         cm_EndDirOp(&dirop);
2847     lock_ReleaseMutex(&dscp->mx);
2848
2849     if (code)
2850         return code;
2851
2852     /* try the RPC now */
2853     osi_Log1(afsd_logp, "CALL Link scp 0x%p", dscp);
2854     do {
2855         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
2856         if (code) continue;
2857
2858         dirAFSFid.Volume = dscp->fid.volume;
2859         dirAFSFid.Vnode = dscp->fid.vnode;
2860         dirAFSFid.Unique = dscp->fid.unique;
2861
2862         existingAFSFid.Volume = sscp->fid.volume;
2863         existingAFSFid.Vnode = sscp->fid.vnode;
2864         existingAFSFid.Unique = sscp->fid.unique;
2865
2866         callp = cm_GetRxConn(connp);
2867         code = RXAFS_Link(callp, &dirAFSFid, namep, &existingAFSFid,
2868             &newLinkStatus, &updatedDirStatus, &volSync);
2869         rx_PutConnection(callp);
2870         osi_Log1(smb_logp,"  RXAFS_Link returns 0x%x", code);
2871
2872     } while (cm_Analyze(connp, userp, reqp,
2873         &dscp->fid, &volSync, NULL, NULL, code));
2874
2875     code = cm_MapRPCError(code, reqp);
2876
2877     if (code)
2878         osi_Log1(afsd_logp, "CALL Link FAILURE, code 0x%x", code);
2879     else
2880         osi_Log0(afsd_logp, "CALL Link SUCCESS");
2881
2882     lock_ObtainMutex(&dscp->mx);
2883     cm_SyncOpDone(dscp, NULL, CM_SCACHESYNC_STOREDATA);
2884     if (code == 0) {
2885         cm_MergeStatus(NULL, dscp, &updatedDirStatus, &volSync, userp, 0);
2886         if (cm_CheckDirOpForSingleChange(&dirop)) {
2887             cm_DirCreateEntry(&dirop, namep, &sscp->fid);
2888         }
2889     }
2890     cm_EndDirOp(&dirop);
2891     lock_ReleaseMutex(&dscp->mx);
2892
2893     return code;
2894 }
2895
2896 long cm_SymLink(cm_scache_t *dscp, char *namep, char *contentsp, long flags,
2897                 cm_attr_t *attrp, cm_user_t *userp, cm_req_t *reqp)
2898 {
2899     cm_conn_t *connp;
2900     long code;
2901     AFSFid dirAFSFid;
2902     AFSFid newAFSFid;
2903     cm_fid_t newFid;
2904     cm_scache_t *scp;
2905     AFSStoreStatus inStatus;
2906     AFSFetchStatus updatedDirStatus;
2907     AFSFetchStatus newLinkStatus;
2908     AFSVolSync volSync;
2909     struct rx_connection * callp;
2910     cm_dirOp_t dirop;
2911
2912     /* before starting the RPC, mark that we're changing the directory data,
2913      * so that someone who does a chmod on the dir will wait until our
2914      * call completes.
2915      */
2916     lock_ObtainMutex(&dscp->mx);
2917     cm_BeginDirOp(dscp, userp, reqp, &dirop);
2918     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, CM_SCACHESYNC_STOREDATA);
2919     if (code != 0)
2920         cm_EndDirOp(&dirop);
2921     lock_ReleaseMutex(&dscp->mx);
2922     if (code) {
2923         return code;
2924     }
2925
2926     cm_StatusFromAttr(&inStatus, NULL, attrp);
2927
2928     /* try the RPC now */
2929     osi_Log1(afsd_logp, "CALL Symlink scp 0x%p", dscp);
2930     do {
2931         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
2932         if (code) 
2933             continue;
2934
2935         dirAFSFid.Volume = dscp->fid.volume;
2936         dirAFSFid.Vnode = dscp->fid.vnode;
2937         dirAFSFid.Unique = dscp->fid.unique;
2938
2939         callp = cm_GetRxConn(connp);
2940         code = RXAFS_Symlink(callp, &dirAFSFid, namep, contentsp,
2941                               &inStatus, &newAFSFid, &newLinkStatus,
2942                               &updatedDirStatus, &volSync);
2943         rx_PutConnection(callp);
2944
2945     } while (cm_Analyze(connp, userp, reqp,
2946                          &dscp->fid, &volSync, NULL, NULL, code));
2947     code = cm_MapRPCError(code, reqp);
2948         
2949     if (code)
2950         osi_Log1(afsd_logp, "CALL Symlink FAILURE, code 0x%x", code);
2951     else
2952         osi_Log0(afsd_logp, "CALL Symlink SUCCESS");
2953
2954     lock_ObtainMutex(&dscp->mx);
2955     cm_SyncOpDone(dscp, NULL, CM_SCACHESYNC_STOREDATA);
2956     if (code == 0) {
2957         cm_MergeStatus(NULL, dscp, &updatedDirStatus, &volSync, userp, 0);
2958         if (cm_CheckDirOpForSingleChange(&dirop)) {
2959             newFid.cell = dscp->fid.cell;
2960             newFid.volume = dscp->fid.volume;
2961             newFid.vnode = newAFSFid.Vnode;
2962             newFid.unique = newAFSFid.Unique;
2963
2964             cm_DirCreateEntry(&dirop, namep, &newFid);
2965         }
2966     }
2967     cm_EndDirOp(&dirop);
2968     lock_ReleaseMutex(&dscp->mx);
2969
2970     /* now try to create the new dir's entry, too, but be careful to 
2971      * make sure that we don't merge in old info.  Since we weren't locking
2972      * out any requests during the file's creation, we may have pretty old
2973      * info.
2974      */
2975     if (code == 0) {
2976         newFid.cell = dscp->fid.cell;
2977         newFid.volume = dscp->fid.volume;
2978         newFid.vnode = newAFSFid.Vnode;
2979         newFid.unique = newAFSFid.Unique;
2980         code = cm_GetSCache(&newFid, &scp, userp, reqp);
2981         if (code == 0) {
2982             lock_ObtainMutex(&scp->mx);
2983             if (!cm_HaveCallback(scp)) {
2984                 cm_MergeStatus(dscp, scp, &newLinkStatus, &volSync,
2985                                 userp, 0);
2986             }       
2987             lock_ReleaseMutex(&scp->mx);
2988             cm_ReleaseSCache(scp);
2989         }
2990     }
2991         
2992     /* and return error code */
2993     return code;
2994 }
2995
2996 long cm_RemoveDir(cm_scache_t *dscp, char *namep, cm_user_t *userp,
2997                    cm_req_t *reqp)
2998 {
2999     cm_conn_t *connp;
3000     long code;
3001     AFSFid dirAFSFid;
3002     int didEnd;
3003     AFSFetchStatus updatedDirStatus;
3004     AFSVolSync volSync;
3005     struct rx_connection * callp;
3006     cm_dirOp_t dirOp;
3007
3008     /* before starting the RPC, mark that we're changing the directory data,
3009      * so that someone who does a chmod on the dir will wait until our
3010      * call completes.
3011      */
3012     lock_ObtainMutex(&dscp->mx);
3013     cm_BeginDirOp(dscp, userp, reqp, &dirOp);
3014     code = cm_SyncOp(dscp, NULL, userp, reqp, 0, CM_SCACHESYNC_STOREDATA);
3015     if (code) {
3016         cm_EndDirOp(&dirOp);
3017         lock_ReleaseMutex(&dscp->mx);
3018         return code;
3019     }
3020     lock_ReleaseMutex(&dscp->mx);
3021     didEnd = 0;
3022
3023     /* try the RPC now */
3024     osi_Log1(afsd_logp, "CALL RemoveDir scp 0x%p", dscp);
3025     do {
3026         code = cm_ConnFromFID(&dscp->fid, userp, reqp, &connp);
3027         if (code) 
3028             continue;
3029
3030         dirAFSFid.Volume = dscp->fid.volume;
3031         dirAFSFid.Vnode = dscp->fid.vnode;
3032         dirAFSFid.Unique = dscp->fid.unique;
3033
3034         callp = cm_GetRxConn(connp);
3035         code = RXAFS_RemoveDir(callp, &dirAFSFid, namep,
3036                                 &updatedDirStatus, &volSync);
3037         rx_PutConnection(callp);
3038
3039     } while (cm_Analyze(connp, userp, reqp,
3040                          &dscp->fid, &volSync, NULL, NULL, code));
3041     code = cm_MapRPCErrorRmdir(code, reqp);
3042
3043     if (code)
3044         osi_Log1(afsd_logp, "CALL RemoveDir FAILURE, code 0x%x", code);
3045     else
3046         osi_Log0(afsd_logp, "CALL RemoveDir SUCCESS");
3047
3048     lock_ObtainMutex(&dscp->mx);
3049     cm_SyncOpDone(dscp, NULL, CM_SCACHESYNC_STOREDATA);
3050     if (code == 0) {
3051         cm_dnlcRemove(dscp, namep); 
3052         cm_MergeStatus(NULL, dscp, &updatedDirStatus, &volSync, userp, 0);
3053         if (cm_CheckDirOpForSingleChange(&dirOp)) {
3054             cm_DirDeleteEntry(&dirOp, namep);
3055     }
3056     }
3057     cm_EndDirOp(&dirOp);
3058     lock_ReleaseMutex(&dscp->mx);
3059
3060     /* and return error code */
3061     return code;
3062 }
3063
3064 long cm_Open(cm_scache_t *scp, int type, cm_user_t *userp)
3065 {
3066     /* grab mutex on contents */
3067     lock_ObtainMutex(&scp->mx);
3068
3069     /* reset the prefetch info */
3070     scp->prefetch.base.LowPart = 0;             /* base */
3071     scp->prefetch.base.HighPart = 0;
3072     scp->prefetch.end.LowPart = 0;              /* and end */
3073     scp->prefetch.end.HighPart = 0;
3074
3075     /* release mutex on contents */
3076     lock_ReleaseMutex(&scp->mx);
3077
3078     /* we're done */
3079     return 0;
3080 }       
3081
3082 long cm_Rename(cm_scache_t *oldDscp, char *oldNamep, cm_scache_t *newDscp,
3083                 char *newNamep, cm_user_t *userp, cm_req_t *reqp)
3084 {
3085     cm_conn_t *connp;
3086     long code;
3087     AFSFid oldDirAFSFid;
3088     AFSFid newDirAFSFid;
3089     int didEnd;
3090     AFSFetchStatus updatedOldDirStatus;
3091     AFSFetchStatus updatedNewDirStatus;
3092     AFSVolSync volSync;
3093     int oneDir;
3094     struct rx_connection * callp;
3095     cm_dirOp_t oldDirOp;
3096     cm_fid_t   fileFid;
3097     int        diropCode = -1;
3098     cm_dirOp_t newDirOp;
3099
3100     /* before starting the RPC, mark that we're changing the directory data,
3101      * so that someone who does a chmod on the dir will wait until our call
3102      * completes.  We do this in vnode order so that we don't deadlock,
3103      * which makes the code a little verbose.
3104      */
3105     if (oldDscp == newDscp) {
3106         /* check for identical names */
3107         if (strcmp(oldNamep, newNamep) == 0)
3108             return CM_ERROR_RENAME_IDENTICAL;
3109
3110         oneDir = 1;
3111         lock_ObtainMutex(&oldDscp->mx);
3112         cm_dnlcRemove(oldDscp, oldNamep);
3113         cm_dnlcRemove(oldDscp, newNamep);
3114         cm_BeginDirOp(oldDscp, userp, reqp, &oldDirOp);
3115         code = cm_SyncOp(oldDscp, NULL, userp, reqp, 0,
3116                           CM_SCACHESYNC_STOREDATA);
3117         if (code != 0) {
3118             cm_EndDirOp(&oldDirOp);
3119         }
3120         lock_ReleaseMutex(&oldDscp->mx);
3121     }
3122     else {
3123         /* two distinct dir vnodes */
3124         oneDir = 0;
3125         if (oldDscp->fid.cell != newDscp->fid.cell ||
3126              oldDscp->fid.volume != newDscp->fid.volume)
3127             return CM_ERROR_CROSSDEVLINK;
3128
3129         /* shouldn't happen that we have distinct vnodes for two
3130          * different files, but could due to deliberate attack, or
3131          * stale info.  Avoid deadlocks and quit now.
3132          */
3133         if (oldDscp->fid.vnode == newDscp->fid.vnode)
3134             return CM_ERROR_CROSSDEVLINK;
3135
3136         if (oldDscp->fid.vnode < newDscp->fid.vnode) {
3137             lock_ObtainMutex(&oldDscp->mx);
3138             cm_BeginDirOp(oldDscp, userp, reqp, &oldDirOp);
3139             cm_dnlcRemove(oldDscp, oldNamep);
3140             code = cm_SyncOp(oldDscp, NULL, userp, reqp, 0,
3141                               CM_SCACHESYNC_STOREDATA);
3142             if (code != 0)
3143                 cm_EndDirOp(&oldDirOp);
3144             lock_ReleaseMutex(&oldDscp->mx);
3145             if (code == 0) {
3146                 lock_ObtainMutex(&newDscp->mx);
3147                 cm_BeginDirOp(newDscp, userp, reqp, &newDirOp);
3148                 cm_dnlcRemove(newDscp, newNamep);
3149                 code = cm_SyncOp(newDscp, NULL, userp, reqp, 0,
3150                                   CM_SCACHESYNC_STOREDATA);
3151                 if (code != 0)
3152                     cm_EndDirOp(&newDirOp);
3153                 lock_ReleaseMutex(&newDscp->mx);
3154                 if (code) {
3155                     /* cleanup first one */
3156                     lock_ObtainMutex(&oldDscp->mx);
3157                     cm_SyncOpDone(oldDscp, NULL,
3158                                    CM_SCACHESYNC_STOREDATA);
3159                     cm_EndDirOp(&oldDirOp);
3160                     lock_ReleaseMutex(&oldDscp->mx);
3161                 }       
3162             }
3163         }
3164         else {
3165             /* lock the new vnode entry first */
3166             lock_ObtainMutex(&newDscp->mx);
3167             cm_BeginDirOp(newDscp, userp, reqp, &newDirOp);
3168             cm_dnlcRemove(newDscp, newNamep);
3169             code = cm_SyncOp(newDscp, NULL, userp, reqp, 0,
3170                               CM_SCACHESYNC_STOREDATA);
3171             if (code != 0)
3172                 cm_EndDirOp(&newDirOp);
3173             lock_ReleaseMutex(&newDscp->mx);
3174             if (code == 0) {
3175                 lock_ObtainMutex(&oldDscp->mx);
3176                 cm_BeginDirOp(oldDscp, userp, reqp, &oldDirOp);
3177                 cm_dnlcRemove(oldDscp, oldNamep);
3178                 code = cm_SyncOp(oldDscp, NULL, userp, reqp, 0,
3179                                   CM_SCACHESYNC_STOREDATA);
3180                 if (code != 0)
3181                     cm_EndDirOp(&oldDirOp);
3182                 lock_ReleaseMutex(&oldDscp->mx);
3183                 if (code) {
3184                     /* cleanup first one */
3185                     lock_ObtainMutex(&newDscp->mx);
3186                     cm_SyncOpDone(newDscp, NULL,
3187                                    CM_SCACHESYNC_STOREDATA);
3188                     cm_EndDirOp(&newDirOp);
3189                     lock_ReleaseMutex(&newDscp->mx);
3190                 }       
3191             }
3192         }
3193     }   /* two distinct vnodes */
3194
3195     if (code) {
3196         return code;
3197     }
3198     didEnd = 0;
3199
3200     /* try the RPC now */
3201     osi_Log2(afsd_logp, "CALL Rename old scp 0x%p new scp 0x%p", 
3202               oldDscp, newDscp);
3203     do {
3204         code = cm_ConnFromFID(&oldDscp->fid, userp, reqp, &connp);
3205         if (code) 
3206             continue;
3207
3208         oldDirAFSFid.Volume = oldDscp->fid.volume;
3209         oldDirAFSFid.Vnode = oldDscp->fid.vnode;
3210         oldDirAFSFid.Unique = oldDscp->fid.unique;
3211         newDirAFSFid.Volume = newDscp->fid.volume;
3212         newDirAFSFid.Vnode = newDscp->fid.vnode;
3213         newDirAFSFid.Unique = newDscp->fid.unique;
3214
3215         callp = cm_GetRxConn(connp);
3216         code = RXAFS_Rename(callp, &oldDirAFSFid, oldNamep,
3217                              &newDirAFSFid, newNamep,
3218                              &updatedOldDirStatus, &updatedNewDirStatus,
3219                              &volSync);
3220         rx_PutConnection(callp);
3221
3222     } while (cm_Analyze(connp, userp, reqp, &oldDscp->fid,
3223                          &volSync, NULL, NULL, code));
3224     code = cm_MapRPCError(code, reqp);
3225         
3226     if (code)
3227         osi_Log1(afsd_logp, "CALL Rename FAILURE, code 0x%x", code);
3228     else
3229         osi_Log0(afsd_logp, "CALL Rename SUCCESS");
3230
3231     /* update the individual stat cache entries for the directories */
3232     lock_ObtainMutex(&oldDscp->mx);
3233     cm_SyncOpDone(oldDscp, NULL, CM_SCACHESYNC_STOREDATA);
3234
3235     if (code == 0) {
3236         cm_MergeStatus(NULL, oldDscp, &updatedOldDirStatus, &volSync,
3237                         userp, 0);
3238
3239         if (cm_CheckDirOpForSingleChange(&oldDirOp)) {
3240
3241             diropCode = cm_DirLookup(&oldDirOp, oldNamep, &fileFid);
3242
3243             if (diropCode == 0) {
3244                 if (oneDir) {
3245                     diropCode = cm_DirCreateEntry(&oldDirOp, newNamep, &fileFid);
3246                 }
3247
3248                 if (diropCode == 0) {
3249                     diropCode = cm_DirDeleteEntry(&oldDirOp, oldNamep);
3250     }
3251             }
3252         }
3253     }
3254     cm_EndDirOp(&oldDirOp);
3255     lock_ReleaseMutex(&oldDscp->mx);
3256
3257     /* and update it for the new one, too, if necessary */
3258     if (!oneDir) {
3259         lock_ObtainMutex(&newDscp->mx);
3260         cm_SyncOpDone(newDscp, NULL, CM_SCACHESYNC_STOREDATA);
3261         if (code == 0) {
3262             cm_MergeStatus(NULL, newDscp, &updatedNewDirStatus, &volSync,
3263                             userp, 0);
3264
3265             /* we only make the local change if we successfully made
3266                the change in the old directory AND there was only one
3267                change in the new directory */
3268             if (diropCode == 0 && cm_CheckDirOpForSingleChange(&newDirOp)) {
3269                 cm_DirCreateEntry(&newDirOp, newNamep, &fileFid);
3270             }
3271         }
3272         cm_EndDirOp(&newDirOp);
3273         lock_ReleaseMutex(&newDscp->mx);
3274     }
3275
3276     /* and return error code */
3277     return code;
3278 }
3279
3280 /* Byte range locks:
3281
3282    The OpenAFS Windows client has to fake byte range locks given no
3283    server side support for such locks.  This is implemented as keyed
3284    byte range locks on the cache manager.
3285
3286    Keyed byte range locks:
3287
3288    Each cm_scache_t structure keeps track of a list of keyed locks.
3289    The key for a lock identifies an owner of a set of locks (referred
3290    to as a client).  Each key is represented by a value.  The set of
3291    key values used within a specific cm_scache_t structure form a
3292    namespace that has a scope of just that cm_scache_t structure.  The
3293    same key value can be used with another cm_scache_t structure and
3294    correspond to a completely different client.  However it is
3295    advantageous for the SMB or IFS layer to make sure that there is a
3296    1-1 mapping between client and keys over all cm_scache_t objects.
3297
3298    Assume a client C has key Key(C) (although, since the scope of the
3299    key is a cm_scache_t, the key can be Key(C,S), where S is the
3300    cm_scache_t.  But assume a 1-1 relation between keys and clients).
3301    A byte range (O,+L) denotes byte addresses (O) through (O+L-1)
3302    inclusive (a.k.a. [O,O+L-1]).  The function Key(x) is implemented
3303    through cm_generateKey() function for both SMB and IFS.
3304
3305    The list of locks for a cm_scache_t object S is maintained in
3306    S->fileLocks.  The cache manager will set a lock on the AFS file
3307    server in order to assert the locks in S->fileLocks.  If only
3308    shared locks are in place for S, then the cache manager will obtain
3309    a LockRead lock, while if there are any exclusive locks, it will
3310    obtain a LockWrite lock.  If the exclusive locks are all released
3311    while the shared locks remain, then the cache manager will
3312    downgrade the lock from LockWrite to LockRead.  Similarly, if an
3313    exclusive lock is obtained when only shared locks exist, then the
3314    cache manager will try to upgrade the lock from LockRead to
3315    LockWrite.
3316
3317    Each lock L owned by client C maintains a key L->key such that
3318    L->key == Key(C), the effective range defined by L->LOffset and
3319    L->LLength such that the range of bytes affected by the lock is
3320    (L->LOffset, +L->LLength), a type maintained in L->LockType which
3321    is either exclusive or shared.
3322
3323    Lock states:
3324
3325    A lock exists iff it is in S->fileLocks for some cm_scache_t
3326    S. Existing locks are in one of the following states: ACTIVE,
3327    WAITLOCK, WAITUNLOCK, LOST, DELETED.
3328
3329    The following sections describe each lock and the associated
3330    transitions.
3331
3332    1. ACTIVE: A lock L is ACTIVE iff the cache manager has asserted
3333       the lock with the AFS file server.  This type of lock can be
3334       exercised by a client to read or write to the locked region (as
3335       the lock allows).
3336
3337       1.1 ACTIVE->LOST: When the AFS file server fails to extend a
3338         server lock that was required to assert the lock.  Before
3339         marking the lock as lost, the cache manager checks if the file
3340         has changed on the server.  If the file has not changed, then
3341         the cache manager will attempt to obtain a new server lock
3342         that is sufficient to assert the client side locks for the
3343         file.  If any of these fail, the lock is marked as LOST.
3344         Otherwise, it is left as ACTIVE.
3345
3346       1.2 ACTIVE->DELETED: Lock is released.
3347
3348    2. WAITLOCK: A lock is in a WAITLOCK state if the cache manager
3349       grants the lock but the lock is yet to be asserted with the AFS
3350       file server.  Once the file server grants the lock, the state
3351       will transition to an ACTIVE lock.
3352
3353       2.1 WAITLOCK->ACTIVE: The server granted the lock.
3354
3355       2.2 WAITLOCK->DELETED: Lock is abandoned, or timed out during
3356         waiting.
3357
3358       2.3 WAITLOCK->LOST: One or more locks from this client were
3359         marked as LOST.  No further locks will be granted to this
3360         client until all lost locks are removed.
3361
3362    3. WAITUNLOCK: A lock is in a WAITUNLOCK state if the cache manager
3363       receives a request for a lock that conflicts with an existing
3364       ACTIVE or WAITLOCK lock.  The lock will be placed in the queue
3365       and will be granted at such time the conflicting locks are
3366       removed, at which point the state will transition to either
3367       WAITLOCK or ACTIVE.
3368
3369       3.1 WAITUNLOCK->ACTIVE: The conflicting lock was removed.  The
3370         current serverLock is sufficient to assert this lock, or a
3371         sufficient serverLock is obtained.
3372
3373       3.2 WAITUNLOCK->WAITLOCK: The conflicting lock was removed,
3374         however the required serverLock is yet to be asserted with the
3375         server.
3376
3377       3.3 WAITUNLOCK->DELETED: The lock is abandoned, timed out or
3378         released.
3379
3380       3.5 WAITUNLOCK->LOST: One or more locks from this client were
3381         marked as LOST.  No further locks will be granted to this
3382         client until all lost locks are removed.
3383
3384    4. LOST: A lock L is LOST if the server lock that was required to
3385       assert the lock could not be obtained or if it could not be
3386       extended, or if other locks by the same client were LOST.
3387       Essentially, once a lock is LOST, the contract between the cache
3388       manager and that specific client is no longer valid.
3389
3390       The cache manager rechecks the server lock once every minute and
3391       extends it as appropriate.  If this is not done for 5 minutes,
3392       the AFS file server will release the lock (the 5 minute timeout
3393       is based on current file server code and is fairly arbitrary).
3394       Once released, the lock cannot be re-obtained without verifying
3395       that the contents of the file hasn't been modified since the
3396       time the lock was released.  Re-obtaining the lock without
3397       verifying this may lead to data corruption.  If the lock can not
3398       be obtained safely, then all active locks for the cm_scache_t
3399       are marked as LOST.
3400
3401       4.1 LOST->DELETED: The lock is released.
3402
3403    5. DELETED: The lock is no longer relevant.  Eventually, it will
3404       get removed from the cm_scache_t. In the meantime, it will be
3405       treated as if it does not exist.
3406
3407       5.1 DELETED->not exist: The lock is removed from the
3408         cm_scache_t.
3409
3410    The following are classifications of locks based on their state.
3411
3412    6* A lock L is ACCEPTED if it is ACTIVE or WAITLOCK.  These locks
3413       have been accepted by the cache manager, but may or may not have
3414       been granted back to the client.
3415
3416    7* A lock L is QUEUED if it is ACTIVE, WAITLOCK or WAITUNLOCK.
3417
3418    8* A lock L is WAITING if it is WAITLOCK or WAITUNLOCK.
3419
3420    Lock operation:
3421
3422    A client C can READ range (Offset,+Length) of a file represented by
3423    cm_scache_t S iff (1):
3424
3425    1. for all _a_ in (Offset,+Length), all of the following is true:
3426
3427        1.1 For each ACTIVE lock L in S->fileLocks such that _a_ in
3428          (L->LOffset,+L->LLength); L->key == Key(C) OR L->LockType is
3429          shared.
3430
3431        1.2 For each LOST lock L in S->fileLocks such that _a_ in
3432          (L->LOffset,+L->LLength); L->LockType is shared AND L->key !=
3433          Key(C)
3434
3435        (When locks are lost on an cm_scache_t, all locks are lost.  By
3436        4.2 (below), if there is an exclusive LOST lock, then there
3437        can't be any overlapping ACTIVE locks.)
3438
3439    A client C can WRITE range (Offset,+Length) of cm_scache_t S iff (2):
3440
3441    2. for all _a_ in (Offset,+Length), one of the following is true:
3442
3443        2.1 Byte _a_ of S is unowned (as specified in 1.1) AND there
3444          does not exist a LOST lock L such that _a_ in
3445          (L->LOffset,+L->LLength).
3446
3447        2.2 Byte _a_ of S is owned by C under lock L (as specified in
3448          1.2) AND L->LockType is exclusive.
3449
3450    A client C can OBTAIN a lock L on cm_scache_t S iff (both 3 and 4):
3451
3452    3. for all _a_ in (L->LOffset,+L->LLength), ALL of the following is
3453       true:
3454
3455        3.1 If L->LockType is exclusive then there does NOT exist a
3456          ACCEPTED lock M in S->fileLocks such that _a_ in
3457          (M->LOffset,+M->LLength).
3458
3459