d843d87b592155487a08f9c7943b51cdc380fba8
[openafs.git] / src / WINNT / afsd / cm_volume.h
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 #ifndef OPENAFS_WINNT_AFSD_CM_VOLUME_H
11 #define OPENAFS_WINNT_AFSD_CM_VOLUME_H 1
12
13 #include <opr/jhash.h>
14
15 #define VL_MAXNAMELEN                   65
16
17 #define CM_VOLUME_MAGIC    ('V' | 'O' <<8 | 'L'<<16 | 'M'<<24)
18
19 /*
20  *
21  */
22
23 typedef struct cm_vol_state {
24     struct cm_volume *nextp;            /* volumeIDHashTable; by cm_volumeLock */
25     afs_uint32      ID;                 /* by rw */
26     struct cm_fid dotdotFid;            /* parent of volume root */
27     cm_serverRef_t *serversp;           /* by cm_serverLock */
28     enum volstatus  state;              /* by rw */
29     afs_uint32      flags;              /* by rw */
30     afs_uint32      qflags;             /* by cm_volumeLock */
31 } cm_vol_state_t;
32
33 /* RWVOL, ROVOL, BACKVOL are defined in cm.h */
34 #define NUM_VOL_TYPES 3
35
36 #define CM_VOL_STATE_FLAG_REPLICATED    1
37
38 typedef struct cm_volume {
39     osi_queue_t q;                      /* LRU queue; cm_volumeLock */
40     afs_uint32 qflags;                  /* by cm_volumeLock */
41     afs_uint32  magic;
42     struct cm_volume *allNextp;         /* allVolumes; by cm_volumeLock */
43     struct cm_volume *nameNextp;        /* volumeNameHashTable; by cm_volumeLock */
44     cm_cell_t *cellp;                   /* never changes */
45     char namep[VL_MAXNAMELEN];          /* name of the normal volume - assigned during allocation; */
46                                         /* by cm_volumeLock */
47     struct cm_vol_state vol[NUM_VOL_TYPES]; /* by cm_volumeLock */
48     osi_rwlock_t rw;
49     afs_uint32 flags;                   /* by rw */
50     afs_int32 refCount;                 /* by Interlocked operations */
51     struct cm_server *cbServerpRO;      /* server granting RO callback; by cm_scacheLock */
52     time_t cbExpiresRO;                 /* latest RO expiration time; by cm_scacheLock */
53     time_t cbIssuedRO;                  /* latest RO issue time; by cm_scacheLock */
54     time_t creationDateRO;              /* latest volume creation date; 0 if unknown; by cm_scacheLock */
55     time_t lastUpdateTime;              /* most recent volume location update cm_volumeLock */
56 } cm_volume_t;
57
58 #define CM_VOLUMEFLAG_RESET        1    /* reload this info on next use */
59 #define CM_VOLUMEFLAG_RO_MIXED     2
60 #define CM_VOLUMEFLAG_UPDATING_VL  8
61 #define CM_VOLUMEFLAG_DFS_VOLUME  16
62 #define CM_VOLUMEFLAG_NOEXIST     32
63
64 #define CM_VOLUME_QFLAG_IN_HASH      1
65 #define CM_VOLUME_QFLAG_IN_LRU_QUEUE 2
66
67 typedef struct cm_volumeRef {
68     struct cm_volumeRef * next;
69     afs_uint32  volID;
70 } cm_volumeRef_t;
71
72 extern void cm_InitVolume(int newFile, long maxVols);
73
74 extern long cm_FindVolumeByName(struct cm_cell *cellp, char *volNamep,
75                                struct cm_user *userp, struct cm_req *reqp,
76                                afs_uint32 flags, cm_volume_t **outVolpp);
77
78 extern long cm_FindVolumeByID(struct cm_cell *cellp, afs_uint32 volumeID,
79                              cm_user_t *userp, cm_req_t *reqp,
80                              afs_uint32 flags, cm_volume_t **outVolpp);
81
82 #define CM_GETVOL_FLAG_CREATE               1
83 #define CM_GETVOL_FLAG_NO_LRU_UPDATE        2
84 #define CM_GETVOL_FLAG_NO_RESET             4
85 #define CM_GETVOL_FLAG_IGNORE_LINKED_CELL   8
86
87 /* hash define.  Must not include the cell, since the callback revocation code
88  * doesn't necessarily know the cell in the case of a multihomed server
89  * contacting us from a mystery address.
90  */
91
92 #define CM_VOLUME_ID_HASH(volid) \
93     (opr_jhash_int((volid), 0) & (cm_data.volumeHashTableSize - 1))
94
95 #define CM_VOLUME_NAME_HASH(name)  (SDBMHash(name) % cm_data.volumeHashTableSize)
96
97 extern afs_uint32 SDBMHash(const char *);
98
99 extern void cm_GetVolume(cm_volume_t *volp);
100
101 extern cm_volume_t *cm_GetVolumeByFID(cm_fid_t *);
102
103 extern void cm_PutVolume(cm_volume_t *volp);
104
105 extern long cm_GetROVolumeID(cm_volume_t *volp);
106
107 extern long cm_ForceUpdateVolume(struct cm_fid *fidp, cm_user_t *userp,
108         cm_req_t *reqp);
109
110 extern cm_serverRef_t **cm_GetVolServers(cm_volume_t *volp, afs_uint32 volume,
111                                          cm_user_t *userp, cm_req_t *reqp);
112
113 extern void cm_ChangeRankVolume(cm_server_t *tsp);
114
115 extern void cm_RefreshVolumes(int lifetime);
116
117 extern long cm_ValidateVolume(void);
118
119 extern long cm_ShutdownVolume(void);
120
121 extern int cm_DumpVolumes(FILE *outputFile, char *cookie, int lock);
122
123 extern int cm_VolNameIsID(char *aname);
124
125 extern void cm_RemoveVolumeFromNameHashTable(cm_volume_t * volp);
126
127 extern void cm_RemoveVolumeFromIDHashTable(cm_volume_t * volp, afs_uint32 volType);
128
129 extern void cm_AddVolumeToNameHashTable(cm_volume_t * volp);
130
131 extern void cm_AddVolumeToIDHashTable(cm_volume_t * volp, afs_uint32 volType);
132
133 extern void cm_AdjustVolumeLRU(cm_volume_t *volp);
134
135 extern void cm_MoveVolumeToLRULast(cm_volume_t *volp);
136
137 extern void cm_RemoveVolumeFromLRU(cm_volume_t *volp);
138
139 extern void cm_CheckOfflineVolumes(void);
140
141 extern long cm_CheckOfflineVolume(cm_volume_t *volp, afs_uint32 volID);
142
143 extern void cm_CheckOfflineVolumeState(cm_volume_t *volp, cm_vol_state_t *statep,
144                                        afs_uint32 volID,  afs_uint32 *onlinep,
145                                        afs_uint32 *volumeUpdatedp);
146
147 extern void cm_UpdateVolumeStatus(cm_volume_t *volp, afs_uint32 volID);
148
149 extern void cm_VolumeStatusNotification(cm_volume_t * volp, afs_uint32 volID, enum volstatus oldState, enum volstatus newState);
150
151 extern enum volstatus cm_GetVolumeStatus(cm_volume_t *volp, afs_uint32 volID);
152
153 extern void cm_VolumeRenewROCallbacks(void);
154
155 extern cm_vol_state_t * cm_VolumeStateByType(cm_volume_t *volp, afs_uint32 type);
156
157 extern cm_vol_state_t * cm_VolumeStateByID(cm_volume_t *volp, afs_uint32 id);
158
159 extern cm_vol_state_t * cm_VolumeStateByName(cm_volume_t *volp, char *volname);
160
161 extern afs_int32 cm_VolumeType(cm_volume_t *volp, afs_uint32 id);
162
163 extern osi_rwlock_t cm_volumeLock;
164 #endif /*  OPENAFS_WINNT_AFSD_CM_VOLUME_H */