2 * Copyright 2000, International Business Machines Corporation and others.
5 * This software has been released under the terms of the IBM Public
6 * License. For details, see the LICENSE file in the top-level source
7 * directory or online at http://www.openafs.org/dl/license10.html
13 #include <afsconfig.h>
14 #include "afs/param.h"
20 #include "afs/sysincludes.h" /* Standard vendor system headers */
23 #if !defined(AFS_LINUX20_ENV) && !defined(AFS_FBSD_ENV)
25 #include <netinet/in.h>
29 #include "h/hashing.h"
31 #if !defined(AFS_HPUX110_ENV) && !defined(AFS_LINUX20_ENV) && !defined(AFS_FBSD_ENV) && !defined(AFS_DARWIN60_ENV)
32 #include <netinet/in_var.h>
36 #include "afsincludes.h" /* Afs-based standard headers */
37 #include "afs/afs_stats.h" /* afs statistics */
38 #include "afs/afs_util.h"
39 #include "afs/unified_afs.h"
41 #if defined(AFS_SUN56_ENV)
43 #include <inet/common.h>
44 #if defined(AFS_SUN58_ENV)
45 #include <netinet/ip6.h>
51 /* shouldn't do it this way, but for now will do */
52 #ifndef ERROR_TABLE_BASE_U
53 #define ERROR_TABLE_BASE_U (5376L)
54 #endif /* ubik error base define */
56 /* shouldn't do it this way, but for now will do */
57 #ifndef ERROR_TABLE_BASE_uae
58 #define ERROR_TABLE_BASE_uae (49733376L)
59 #endif /* unified afs error base define */
61 /* same hack for vlserver error base as for ubik error base */
62 #ifndef ERROR_TABLE_BASE_VL
63 #define ERROR_TABLE_BASE_VL (363520L)
64 #define VL_NOENT (363524L)
65 #endif /* vlserver error base define */
68 int afs_BusyWaitPeriod = 15; /* poll every 15 seconds */
70 afs_int32 hm_retry_RO = 0; /* don't wait */
71 afs_int32 hm_retry_RW = 0; /* don't wait */
72 afs_int32 hm_retry_int = 0; /* don't wait */
74 #define VSleep(at) afs_osi_Wait((at)*1000, 0, 0)
79 * 0 if the vldb record for a specific volume is different from what
80 * we have cached -- perhaps the volume has moved.
81 * 1 if the vldb record is the same
82 * 2 if we can't tell if it's the same or not.
84 * If 0, the caller will probably start over at the beginning of our
85 * list of servers for this volume and try to find one that is up. If
86 * not 0, we will probably just keep plugging with what we have
87 * cached. If we fail to contact the VL server, we should just keep
88 * trying with the information we have, rather than failing. */
93 VLDB_Same(struct VenusFid *afid, struct vrequest *areq)
100 struct nvldbentry ntve;
101 struct uvldbentry utve;
105 char *bp, tbuf[CVBS]; /* biggest volume id is 2^32, ~ 4*10^9 */
106 unsigned int changed;
107 struct server *(oldhosts[NMAXNSERVERS]);
109 AFS_STATCNT(CheckVLDB);
110 afs_FinalizeReq(areq);
112 if ((i = afs_InitReq(&treq, afs_osi_credp)))
114 v = afs_osi_Alloc(sizeof(*v));
115 tcell = afs_GetCell(afid->Cell, READ_LOCK);
116 bp = afs_cv2string(&tbuf[CVBS], afid->Fid.Volume);
118 VSleep(2); /* Better safe than sorry. */
120 afs_ConnByMHosts(tcell->cellHosts, tcell->vlport, tcell->cellNum,
123 if (tconn->srvr->server->flags & SNO_LHOSTS) {
126 i = VL_GetEntryByNameO(tconn->id, bp, &v->tve);
128 } else if (tconn->srvr->server->flags & SYES_LHOSTS) {
131 i = VL_GetEntryByNameN(tconn->id, bp, &v->ntve);
136 i = VL_GetEntryByNameU(tconn->id, bp, &v->utve);
138 if (!(tconn->srvr->server->flags & SVLSRV_UUID)) {
139 if (i == RXGEN_OPCODE) {
142 i = VL_GetEntryByNameN(tconn->id, bp, &v->ntve);
144 if (i == RXGEN_OPCODE) {
146 tconn->srvr->server->flags |= SNO_LHOSTS;
148 i = VL_GetEntryByNameO(tconn->id, bp, &v->tve);
151 tconn->srvr->server->flags |= SYES_LHOSTS;
153 tconn->srvr->server->flags |= SVLSRV_UUID;
159 } while (afs_Analyze(tconn, i, NULL, &treq, -1, /* no op code for this */
160 SHARED_LOCK, tcell));
162 afs_PutCell(tcell, READ_LOCK);
163 afs_Trace2(afs_iclSetp, CM_TRACE_CHECKVLDB, ICL_TYPE_FID, &afid,
167 afs_osi_Free(v, sizeof(*v));
170 /* have info, copy into serverHost array */
172 tvp = afs_FindVolume(afid, WRITE_LOCK);
174 ObtainWriteLock(&tvp->lock, 107);
175 for (i = 0; i < NMAXNSERVERS && tvp->serverHost[i]; i++) {
176 oldhosts[i] = tvp->serverHost[i];
180 InstallUVolumeEntry(tvp, &v->utve, afid->Cell, tcell, &treq);
181 } else if (type == 1) {
182 InstallNVolumeEntry(tvp, &v->ntve, afid->Cell);
184 InstallVolumeEntry(tvp, &v->tve, afid->Cell);
187 if (i < NMAXNSERVERS && tvp->serverHost[i]) {
190 for (--i; !changed && i >= 0; i--) {
191 if (tvp->serverHost[i] != oldhosts[i]) {
192 changed = 1; /* also happens if prefs change. big deal. */
196 ReleaseWriteLock(&tvp->lock);
197 afs_PutVolume(tvp, WRITE_LOCK);
198 } else { /* can't find volume */
199 tvp = afs_GetVolume(afid, &treq, WRITE_LOCK);
201 afs_PutVolume(tvp, WRITE_LOCK);
202 afs_osi_Free(v, sizeof(*v));
205 afs_osi_Free(v, sizeof(*v));
210 afs_osi_Free(v, sizeof(*v));
211 return (changed ? DIFFERENT : SAME);
214 /*------------------------------------------------------------------------
218 * Mark a server as invalid for further attempts of this request only.
221 * areq : The request record associated with this operation.
222 * afid : The FID of the file involved in the action. This argument
223 * may be null if none was involved.
224 * tsp : pointer to a server struct for the server we wish to
228 * Non-zero value if further servers are available to try,
232 * This routine is typically called in situations where we believe
233 * one server out of a pool may have an error condition.
239 * The afs_Conn* routines use the list of invalidated servers to
240 * avoid reusing a server marked as invalid for this request.
241 *------------------------------------------------------------------------*/
243 afs_BlackListOnce(struct vrequest *areq, struct VenusFid *afid,
248 afs_int32 serversleft = 0;
251 tvp = afs_FindVolume(afid, READ_LOCK);
253 for (i = 0; i < MAXHOSTS; i++) {
254 if (tvp->serverHost[i] == tsp) {
255 areq->skipserver[i] = 1;
257 if (tvp->serverHost[i] &&
258 !(tvp->serverHost[i]->addr->sa_flags &
260 areq->skipserver[i] = 1;
263 afs_PutVolume(tvp, READ_LOCK);
266 for (i = 0; i < MAXHOSTS; i++) {
267 if (areq->skipserver[i] == 0) {
276 /*------------------------------------------------------------------------
277 * EXPORTED afs_Analyze
280 * Analyze the outcome of an RPC operation, taking whatever support
281 * actions are necessary.
284 * aconn : Ptr to the relevant connection on which the call was made.
285 * acode : The return code experienced by the RPC.
286 * afid : The FID of the file involved in the action. This argument
287 * may be null if none was involved.
288 * areq : The request record associated with this operation.
289 * op : which RPC we are analyzing.
290 * cellp : pointer to a cell struct. Must provide either fid or cell.
293 * Non-zero value if the related RPC operation should be retried,
297 * This routine is typically called in a do-while loop, causing the
298 * embedded RPC operation to be called repeatedly if appropriate
299 * until whatever error condition (if any) is intolerable.
305 * The retry return value is used by afs_StoreAllSegments to determine
306 * if this is a temporary or permanent error.
307 *------------------------------------------------------------------------*/
309 afs_Analyze(register struct conn *aconn, afs_int32 acode,
310 struct VenusFid *afid, register struct vrequest *areq, int op,
311 afs_int32 locktype, struct cell *cellp)
317 afs_int32 shouldRetry = 0;
318 afs_int32 serversleft = 1;
319 struct afs_stats_RPCErrors *aerrP;
320 afs_int32 markeddown;
323 if (AFS_IS_DISCONNECTED) {
324 /* SXW - This may get very tired after a while. We should try and
325 * intercept all RPCs before they get here ... */
326 /*printf("afs_Analyze: disconnected\n");*/
327 afs_FinalizeReq(areq);
329 /* SXW - I suspect that this will _never_ happen - we shouldn't
330 * get a connection because we're disconnected !!!*/
331 afs_PutConn(aconn, locktype);
336 AFS_STATCNT(afs_Analyze);
337 afs_Trace4(afs_iclSetp, CM_TRACE_ANALYZE, ICL_TYPE_INT32, op,
338 ICL_TYPE_POINTER, aconn, ICL_TYPE_INT32, acode, ICL_TYPE_LONG,
341 aerrP = (struct afs_stats_RPCErrors *)0;
343 if ((op >= 0) && (op < AFS_STATS_NUM_FS_RPC_OPS))
344 aerrP = &(afs_stats_cmfullperf.rpc.fsRPCErrors[op]);
346 afs_FinalizeReq(areq);
347 if (!aconn && areq->busyCount) { /* one RPC or more got VBUSY/VRESTARTING */
349 tvp = afs_FindVolume(afid, READ_LOCK);
351 afs_warnuser("afs: Waiting for busy volume %u (%s) in cell %s\n",
352 (afid ? afid->Fid.Volume : 0),
353 (tvp->name ? tvp->name : ""),
355 && tvp->serverHost[0]->cell) ? tvp->serverHost[0]->
356 cell->cellName : ""));
358 for (i = 0; i < MAXHOSTS; i++) {
359 if (tvp->status[i] != not_busy && tvp->status[i] != offline) {
360 tvp->status[i] = not_busy;
362 if (tvp->status[i] == not_busy)
365 afs_PutVolume(tvp, READ_LOCK);
367 afs_warnuser("afs: Waiting for busy volume %u\n",
368 (afid ? afid->Fid.Volume : 0));
371 if (areq->busyCount > 100) {
373 (aerrP->err_Volume)++;
374 areq->volumeError = VOLBUSY;
377 VSleep(afs_BusyWaitPeriod); /* poll periodically */
379 if (shouldRetry != 0)
382 return shouldRetry; /* should retry */
385 if (!aconn || !aconn->srvr) {
386 if (!areq->volumeError) {
388 (aerrP->err_Network)++;
389 if (hm_retry_int && !(areq->flags & O_NONBLOCK) && /* "hard" mount */
390 ((afid && afs_IsPrimaryCellNum(afid->Cell))
391 || (cellp && afs_IsPrimaryCell(cellp)))) {
394 ("afs: hard-mount waiting for a vlserver to return to service\n");
395 VSleep(hm_retry_int);
396 afs_CheckServers(1, cellp);
399 tvp = afs_FindVolume(afid, READ_LOCK);
400 if (!tvp || (tvp->states & VRO)) {
401 shouldRetry = hm_retry_RO;
403 shouldRetry = hm_retry_RW;
406 afs_PutVolume(tvp, READ_LOCK);
409 ("afs: hard-mount waiting for volume %u\n",
411 VSleep(hm_retry_int);
412 afs_CheckServers(1, cellp);
415 } /* if (hm_retry_int ... */
417 areq->networkError = 1;
423 /* Find server associated with this connection. */
427 /* Before we do anything with acode, make sure we translate it back to
429 if ((acode & ~0xff) == ERROR_TABLE_BASE_uae)
430 acode = et_to_sys_error(acode);
433 /* If we previously took an error, mark this volume not busy */
434 if (areq->volumeError) {
435 tvp = afs_FindVolume(afid, READ_LOCK);
437 for (i = 0; i < MAXHOSTS; i++) {
438 if (tvp->serverHost[i] == tsp) {
439 tvp->status[i] = not_busy;
442 afs_PutVolume(tvp, READ_LOCK);
446 afs_PutConn(aconn, locktype);
450 /* If network troubles, mark server as having bogued out again. */
451 /* VRESTARTING is < 0 because of backward compatibility issues
452 * with 3.4 file servers and older cache managers */
453 #ifdef AFS_64BIT_CLIENT
456 #endif /* AFS_64BIT_CLIENT */
457 if ((acode < 0) && (acode != VRESTARTING)) {
458 if (acode == RX_CALL_TIMEOUT) {
459 serversleft = afs_BlackListOnce(areq, afid, tsp);
466 /* By doing this, we avoid ever marking a server down
467 * in an idle timeout case. That's because the server is
468 * still responding and may only be letting a single vnode
469 * time out. We otherwise risk having the server continually
470 * be marked down, then up, then down again...
474 markeddown = afs_ServerDown(sa);
475 ForceNewConnections(sa); /**multi homed clients lock:afs_xsrvAddr? */
477 (aerrP->err_Server)++;
479 /* retry *once* when the server is timed out in case of NAT */
480 if (markeddown && acode == RX_CALL_DEAD) {
481 aconn->forceConnectFS = 1;
487 if (acode == VBUSY || acode == VRESTARTING) {
488 if (acode == VBUSY) {
491 (aerrP->err_VolumeBusies)++;
495 tvp = afs_FindVolume(afid, READ_LOCK);
497 for (i = 0; i < MAXHOSTS; i++) {
498 if (tvp->serverHost[i] == tsp) {
499 tvp->status[i] = rdwr_busy; /* can't tell which yet */
500 /* to tell which, have to look at the op code. */
503 afs_PutVolume(tvp, READ_LOCK);
505 afs_warnuser("afs: Waiting for busy volume %u in cell %s\n",
506 (afid ? afid->Fid.Volume : 0), tsp->cell->cellName);
507 VSleep(afs_BusyWaitPeriod); /* poll periodically */
511 } else if (acode == VICETOKENDEAD
512 || (acode & ~0xff) == ERROR_TABLE_BASE_RXK) {
513 /* any rxkad error is treated as token expiration */
516 * I'm calling these errors protection errors, since they involve
517 * faulty authentication.
520 (aerrP->err_Protection)++;
522 tu = afs_FindUser(areq->uid, tsp->cell->cellNum, READ_LOCK);
524 if (acode == VICETOKENDEAD) {
525 aconn->forceConnectFS = 1;
526 } else if (acode == RXKADEXPIRED) {
527 aconn->forceConnectFS = 0; /* don't check until new tokens set */
528 aconn->user->states |= UTokensBad;
530 ("afs: Tokens for user of AFS id %d for cell %s have expired\n",
531 tu->vid, aconn->srvr->server->cell->cellName);
533 serversleft = afs_BlackListOnce(areq, afid, tsp);
538 ("afs: Tokens for user of AFS id %d for cell %s: rxkad error=%d\n",
539 tu->vid, aconn->srvr->server->cell->cellName, acode);
542 areq->tokenError = 0;
543 aconn->forceConnectFS = 0; /* don't check until new tokens set */
544 aconn->user->states |= UTokensBad;
546 ("afs: Tokens for user of AFS id %d for cell %s are discarded (rxkad error=%d)\n",
547 tu->vid, aconn->srvr->server->cell->cellName, acode);
550 afs_PutUser(tu, READ_LOCK);
552 /* The else case shouldn't be possible and should probably be replaced by a panic? */
553 if (acode == VICETOKENDEAD) {
554 aconn->forceConnectFS = 1;
555 } else if (acode == RXKADEXPIRED) {
556 aconn->forceConnectFS = 0; /* don't check until new tokens set */
557 aconn->user->states |= UTokensBad;
559 ("afs: Tokens for user %d for cell %s have expired\n",
560 areq->uid, aconn->srvr->server->cell->cellName);
562 aconn->forceConnectFS = 0; /* don't check until new tokens set */
563 aconn->user->states |= UTokensBad;
565 ("afs: Tokens for user %d for cell %s are discarded (rxkad error = %d)\n",
566 areq->uid, aconn->srvr->server->cell->cellName, acode);
569 shouldRetry = 1; /* Try again (as root). */
571 /* Check for access violation. */
572 else if (acode == EACCES) {
573 /* should mark access error in non-existent per-user global structure */
575 (aerrP->err_Protection)++;
576 areq->accessError = 1;
577 if (op == AFS_STATS_FS_RPCIDX_STOREDATA)
578 areq->permWriteError = 1;
581 /* check for ubik errors; treat them like crashed servers */
582 else if (acode >= ERROR_TABLE_BASE_U && acode < ERROR_TABLE_BASE_U + 255) {
585 (aerrP->err_Server)++;
586 shouldRetry = 1; /* retryable (maybe one is working) */
587 VSleep(1); /* just in case */
589 /* Check for bad volume data base / missing volume. */
590 else if (acode == VSALVAGE || acode == VOFFLINE || acode == VNOVOL
591 || acode == VNOSERVICE || acode == VMOVED) {
596 areq->volumeError = VOLMISSING;
598 (aerrP->err_Volume)++;
599 if (afid && (tcell = afs_GetCell(afid->Cell, 0))) {
600 same = VLDB_Same(afid, areq);
601 tvp = afs_FindVolume(afid, READ_LOCK);
603 for (i = 0; i < MAXHOSTS && tvp->serverHost[i]; i++) {
604 if (tvp->serverHost[i] == tsp) {
605 if (tvp->status[i] == end_not_busy)
606 tvp->status[i] = offline;
610 tvp->status[i] = not_busy; /* reset the others */
613 afs_PutVolume(tvp, READ_LOCK);
616 } else if (acode >= ERROR_TABLE_BASE_VL && acode <= ERROR_TABLE_BASE_VL + 255) { /* vlserver errors */
618 areq->volumeError = VOLMISSING;
619 } else if (acode >= 0) {
621 (aerrP->err_Other)++;
622 if (op == AFS_STATS_FS_RPCIDX_STOREDATA)
623 areq->permWriteError = 1;
624 shouldRetry = 0; /* Other random Vice error. */
625 } else if (acode == RX_MSGSIZE) { /* same meaning as EMSGSIZE... */
626 VSleep(1); /* Just a hack for desperate times. */
628 (aerrP->err_Other)++;
629 shouldRetry = 1; /* packet was too big, please retry call */
632 if (acode < 0 && acode != RX_MSGSIZE && acode != VRESTARTING) {
633 /* If we get here, code < 0 and we have network/Server troubles.
634 * areq->networkError is not set here, since we always
635 * retry in case there is another server. However, if we find
636 * no connection (aconn == 0) we set the networkError flag.
638 afs_MarkServerUpOrDown(sa, SRVR_ISDOWN);
640 (aerrP->err_Server)++;
641 VSleep(1); /* Just a hack for desperate times. */
645 /* now unlock the connection and return */
646 afs_PutConn(aconn, locktype);
647 return (shouldRetry);