Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 1 | #ifndef _FS_CEPH_MDS_CLIENT_H |
| 2 | #define _FS_CEPH_MDS_CLIENT_H |
| 3 | |
| 4 | #include <linux/completion.h> |
Sage Weil | 153c8e6 | 2009-12-07 12:31:09 -0800 | [diff] [blame] | 5 | #include <linux/kref.h> |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 6 | #include <linux/list.h> |
| 7 | #include <linux/mutex.h> |
| 8 | #include <linux/radix-tree.h> |
| 9 | #include <linux/spinlock.h> |
| 10 | |
| 11 | #include "types.h" |
| 12 | #include "messenger.h" |
| 13 | #include "mdsmap.h" |
| 14 | |
| 15 | /* |
| 16 | * Some lock dependencies: |
| 17 | * |
| 18 | * session->s_mutex |
| 19 | * mdsc->mutex |
| 20 | * |
| 21 | * mdsc->snap_rwsem |
| 22 | * |
| 23 | * inode->i_lock |
| 24 | * mdsc->snap_flush_lock |
| 25 | * mdsc->cap_delay_lock |
| 26 | * |
| 27 | */ |
| 28 | |
| 29 | struct ceph_client; |
| 30 | struct ceph_cap; |
| 31 | |
| 32 | /* |
| 33 | * parsed info about a single inode. pointers are into the encoded |
| 34 | * on-wire structures within the mds reply message payload. |
| 35 | */ |
| 36 | struct ceph_mds_reply_info_in { |
| 37 | struct ceph_mds_reply_inode *in; |
| 38 | u32 symlink_len; |
| 39 | char *symlink; |
| 40 | u32 xattr_len; |
| 41 | char *xattr_data; |
| 42 | }; |
| 43 | |
| 44 | /* |
| 45 | * parsed info about an mds reply, including information about the |
| 46 | * target inode and/or its parent directory and dentry, and directory |
| 47 | * contents (for readdir results). |
| 48 | */ |
| 49 | struct ceph_mds_reply_info_parsed { |
| 50 | struct ceph_mds_reply_head *head; |
| 51 | |
| 52 | struct ceph_mds_reply_info_in diri, targeti; |
| 53 | struct ceph_mds_reply_dirfrag *dirfrag; |
| 54 | char *dname; |
| 55 | u32 dname_len; |
| 56 | struct ceph_mds_reply_lease *dlease; |
| 57 | |
| 58 | struct ceph_mds_reply_dirfrag *dir_dir; |
| 59 | int dir_nr; |
| 60 | char **dir_dname; |
| 61 | u32 *dir_dname_len; |
| 62 | struct ceph_mds_reply_lease **dir_dlease; |
| 63 | struct ceph_mds_reply_info_in *dir_in; |
| 64 | u8 dir_complete, dir_end; |
| 65 | |
| 66 | /* encoded blob describing snapshot contexts for certain |
| 67 | operations (e.g., open) */ |
| 68 | void *snapblob; |
| 69 | int snapblob_len; |
| 70 | }; |
| 71 | |
| 72 | |
| 73 | /* |
| 74 | * cap releases are batched and sent to the MDS en masse. |
| 75 | */ |
| 76 | #define CEPH_CAPS_PER_RELEASE ((PAGE_CACHE_SIZE - \ |
| 77 | sizeof(struct ceph_mds_cap_release)) / \ |
| 78 | sizeof(struct ceph_mds_cap_item)) |
| 79 | |
| 80 | |
| 81 | /* |
| 82 | * state associated with each MDS<->client session |
| 83 | */ |
| 84 | enum { |
| 85 | CEPH_MDS_SESSION_NEW = 1, |
| 86 | CEPH_MDS_SESSION_OPENING = 2, |
| 87 | CEPH_MDS_SESSION_OPEN = 3, |
| 88 | CEPH_MDS_SESSION_HUNG = 4, |
| 89 | CEPH_MDS_SESSION_CLOSING = 5, |
| 90 | CEPH_MDS_SESSION_RESTARTING = 6, |
| 91 | CEPH_MDS_SESSION_RECONNECTING = 7, |
| 92 | }; |
| 93 | |
| 94 | struct ceph_mds_session { |
| 95 | struct ceph_mds_client *s_mdsc; |
| 96 | int s_mds; |
| 97 | int s_state; |
| 98 | unsigned long s_ttl; /* time until mds kills us */ |
| 99 | u64 s_seq; /* incoming msg seq # */ |
| 100 | struct mutex s_mutex; /* serialize session messages */ |
| 101 | |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 102 | struct ceph_connection s_con; |
| 103 | |
Sage Weil | 4e7a5dc | 2009-11-18 16:19:57 -0800 | [diff] [blame] | 104 | struct ceph_authorizer *s_authorizer; |
| 105 | void *s_authorizer_buf, *s_authorizer_reply_buf; |
| 106 | size_t s_authorizer_buf_len, s_authorizer_reply_buf_len; |
| 107 | |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 108 | /* protected by s_cap_lock */ |
| 109 | spinlock_t s_cap_lock; |
| 110 | u32 s_cap_gen; /* inc each time we get mds stale msg */ |
| 111 | unsigned long s_cap_ttl; /* when session caps expire */ |
| 112 | struct list_head s_caps; /* all caps issued by this session */ |
| 113 | int s_nr_caps, s_trim_caps; |
| 114 | int s_num_cap_releases; |
| 115 | struct list_head s_cap_releases; /* waiting cap_release messages */ |
| 116 | struct list_head s_cap_releases_done; /* ready to send */ |
Sage Weil | 5dacf09 | 2009-12-21 20:40:34 -0800 | [diff] [blame] | 117 | bool s_iterating_caps; |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 118 | |
| 119 | /* protected by mutex */ |
| 120 | struct list_head s_cap_flushing; /* inodes w/ flushing caps */ |
| 121 | struct list_head s_cap_snaps_flushing; |
| 122 | unsigned long s_renew_requested; /* last time we sent a renew req */ |
| 123 | u64 s_renew_seq; |
| 124 | |
| 125 | atomic_t s_ref; |
| 126 | struct list_head s_waiting; /* waiting requests */ |
| 127 | struct list_head s_unsafe; /* unsafe requests */ |
| 128 | }; |
| 129 | |
| 130 | /* |
| 131 | * modes of choosing which MDS to send a request to |
| 132 | */ |
| 133 | enum { |
| 134 | USE_ANY_MDS, |
| 135 | USE_RANDOM_MDS, |
| 136 | USE_AUTH_MDS, /* prefer authoritative mds for this metadata item */ |
| 137 | }; |
| 138 | |
| 139 | struct ceph_mds_request; |
| 140 | struct ceph_mds_client; |
| 141 | |
| 142 | /* |
| 143 | * request completion callback |
| 144 | */ |
| 145 | typedef void (*ceph_mds_request_callback_t) (struct ceph_mds_client *mdsc, |
| 146 | struct ceph_mds_request *req); |
| 147 | |
| 148 | /* |
| 149 | * an in-flight mds request |
| 150 | */ |
| 151 | struct ceph_mds_request { |
| 152 | u64 r_tid; /* transaction id */ |
| 153 | |
| 154 | int r_op; /* mds op code */ |
| 155 | int r_mds; |
| 156 | |
| 157 | /* operation on what? */ |
| 158 | struct inode *r_inode; /* arg1 */ |
| 159 | struct dentry *r_dentry; /* arg1 */ |
| 160 | struct dentry *r_old_dentry; /* arg2: rename from or link from */ |
| 161 | char *r_path1, *r_path2; |
| 162 | struct ceph_vino r_ino1, r_ino2; |
| 163 | |
| 164 | struct inode *r_locked_dir; /* dir (if any) i_mutex locked by vfs */ |
| 165 | struct inode *r_target_inode; /* resulting inode */ |
| 166 | |
| 167 | union ceph_mds_request_args r_args; |
| 168 | int r_fmode; /* file mode, if expecting cap */ |
| 169 | |
| 170 | /* for choosing which mds to send this request to */ |
| 171 | int r_direct_mode; |
| 172 | u32 r_direct_hash; /* choose dir frag based on this dentry hash */ |
| 173 | bool r_direct_is_hash; /* true if r_direct_hash is valid */ |
| 174 | |
| 175 | /* data payload is used for xattr ops */ |
| 176 | struct page **r_pages; |
| 177 | int r_num_pages; |
| 178 | int r_data_len; |
| 179 | |
| 180 | /* what caps shall we drop? */ |
| 181 | int r_inode_drop, r_inode_unless; |
| 182 | int r_dentry_drop, r_dentry_unless; |
| 183 | int r_old_dentry_drop, r_old_dentry_unless; |
| 184 | struct inode *r_old_inode; |
| 185 | int r_old_inode_drop, r_old_inode_unless; |
| 186 | |
| 187 | struct ceph_msg *r_request; /* original request */ |
| 188 | struct ceph_msg *r_reply; |
| 189 | struct ceph_mds_reply_info_parsed r_reply_info; |
| 190 | int r_err; |
Sage Weil | 5b1daec | 2010-01-25 11:33:08 -0800 | [diff] [blame^] | 191 | bool r_aborted; |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 192 | |
| 193 | unsigned long r_timeout; /* optional. jiffies */ |
| 194 | unsigned long r_started; /* start time to measure timeout against */ |
| 195 | unsigned long r_request_started; /* start time for mds request only, |
| 196 | used to measure lease durations */ |
| 197 | |
| 198 | /* link unsafe requests to parent directory, for fsync */ |
| 199 | struct inode *r_unsafe_dir; |
| 200 | struct list_head r_unsafe_dir_item; |
| 201 | |
| 202 | struct ceph_mds_session *r_session; |
| 203 | |
| 204 | int r_attempts; /* resend attempts */ |
| 205 | int r_num_fwd; /* number of forward attempts */ |
| 206 | int r_num_stale; |
| 207 | int r_resend_mds; /* mds to resend to next, if any*/ |
| 208 | |
Sage Weil | 153c8e6 | 2009-12-07 12:31:09 -0800 | [diff] [blame] | 209 | struct kref r_kref; |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 210 | struct list_head r_wait; |
| 211 | struct completion r_completion; |
| 212 | struct completion r_safe_completion; |
| 213 | ceph_mds_request_callback_t r_callback; |
| 214 | struct list_head r_unsafe_item; /* per-session unsafe list item */ |
| 215 | bool r_got_unsafe, r_got_safe; |
| 216 | |
| 217 | bool r_did_prepopulate; |
| 218 | u32 r_readdir_offset; |
| 219 | |
| 220 | struct ceph_cap_reservation r_caps_reservation; |
| 221 | int r_num_caps; |
| 222 | }; |
| 223 | |
| 224 | /* |
| 225 | * mds client state |
| 226 | */ |
| 227 | struct ceph_mds_client { |
| 228 | struct ceph_client *client; |
| 229 | struct mutex mutex; /* all nested structures */ |
| 230 | |
| 231 | struct ceph_mdsmap *mdsmap; |
| 232 | struct completion safe_umount_waiters, session_close_waiters; |
| 233 | struct list_head waiting_for_map; |
| 234 | |
| 235 | struct ceph_mds_session **sessions; /* NULL for mds if no session */ |
| 236 | int max_sessions; /* len of s_mds_sessions */ |
| 237 | int stopping; /* true if shutting down */ |
| 238 | |
| 239 | /* |
| 240 | * snap_rwsem will cover cap linkage into snaprealms, and |
| 241 | * realm snap contexts. (later, we can do per-realm snap |
| 242 | * contexts locks..) the empty list contains realms with no |
| 243 | * references (implying they contain no inodes with caps) that |
| 244 | * should be destroyed. |
| 245 | */ |
| 246 | struct rw_semaphore snap_rwsem; |
| 247 | struct radix_tree_root snap_realms; |
| 248 | struct list_head snap_empty; |
| 249 | spinlock_t snap_empty_lock; /* protect snap_empty */ |
| 250 | |
| 251 | u64 last_tid; /* most recent mds request */ |
| 252 | struct radix_tree_root request_tree; /* pending mds requests */ |
| 253 | struct delayed_work delayed_work; /* delayed work */ |
| 254 | unsigned long last_renew_caps; /* last time we renewed our caps */ |
| 255 | struct list_head cap_delay_list; /* caps with delayed release */ |
| 256 | spinlock_t cap_delay_lock; /* protects cap_delay_list */ |
| 257 | struct list_head snap_flush_list; /* cap_snaps ready to flush */ |
| 258 | spinlock_t snap_flush_lock; |
| 259 | |
| 260 | u64 cap_flush_seq; |
| 261 | struct list_head cap_dirty; /* inodes with dirty caps */ |
| 262 | int num_cap_flushing; /* # caps we are flushing */ |
| 263 | spinlock_t cap_dirty_lock; /* protects above items */ |
| 264 | wait_queue_head_t cap_flushing_wq; |
| 265 | |
Sage Weil | 039934b | 2009-11-12 15:05:52 -0800 | [diff] [blame] | 266 | #ifdef CONFIG_DEBUG_FS |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 267 | struct dentry *debugfs_file; |
Sage Weil | 039934b | 2009-11-12 15:05:52 -0800 | [diff] [blame] | 268 | #endif |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 269 | |
| 270 | spinlock_t dentry_lru_lock; |
| 271 | struct list_head dentry_lru; |
| 272 | int num_dentry; |
| 273 | }; |
| 274 | |
| 275 | extern const char *ceph_mds_op_name(int op); |
| 276 | |
| 277 | extern struct ceph_mds_session * |
| 278 | __ceph_lookup_mds_session(struct ceph_mds_client *, int mds); |
| 279 | |
| 280 | static inline struct ceph_mds_session * |
| 281 | ceph_get_mds_session(struct ceph_mds_session *s) |
| 282 | { |
| 283 | atomic_inc(&s->s_ref); |
| 284 | return s; |
| 285 | } |
| 286 | |
| 287 | extern void ceph_put_mds_session(struct ceph_mds_session *s); |
| 288 | |
| 289 | extern int ceph_send_msg_mds(struct ceph_mds_client *mdsc, |
| 290 | struct ceph_msg *msg, int mds); |
| 291 | |
Sage Weil | 5f44f14 | 2009-11-18 14:52:18 -0800 | [diff] [blame] | 292 | extern int ceph_mdsc_init(struct ceph_mds_client *mdsc, |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 293 | struct ceph_client *client); |
| 294 | extern void ceph_mdsc_close_sessions(struct ceph_mds_client *mdsc); |
| 295 | extern void ceph_mdsc_stop(struct ceph_mds_client *mdsc); |
| 296 | |
| 297 | extern void ceph_mdsc_sync(struct ceph_mds_client *mdsc); |
| 298 | |
| 299 | extern void ceph_mdsc_lease_release(struct ceph_mds_client *mdsc, |
| 300 | struct inode *inode, |
| 301 | struct dentry *dn, int mask); |
| 302 | |
| 303 | extern struct ceph_mds_request * |
| 304 | ceph_mdsc_create_request(struct ceph_mds_client *mdsc, int op, int mode); |
| 305 | extern void ceph_mdsc_submit_request(struct ceph_mds_client *mdsc, |
| 306 | struct ceph_mds_request *req); |
| 307 | extern int ceph_mdsc_do_request(struct ceph_mds_client *mdsc, |
| 308 | struct inode *dir, |
| 309 | struct ceph_mds_request *req); |
| 310 | static inline void ceph_mdsc_get_request(struct ceph_mds_request *req) |
| 311 | { |
Sage Weil | 153c8e6 | 2009-12-07 12:31:09 -0800 | [diff] [blame] | 312 | kref_get(&req->r_kref); |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 313 | } |
Sage Weil | 153c8e6 | 2009-12-07 12:31:09 -0800 | [diff] [blame] | 314 | extern void ceph_mdsc_release_request(struct kref *kref); |
| 315 | static inline void ceph_mdsc_put_request(struct ceph_mds_request *req) |
| 316 | { |
| 317 | kref_put(&req->r_kref, ceph_mdsc_release_request); |
| 318 | } |
Sage Weil | 2f2dc05 | 2009-10-06 11:31:09 -0700 | [diff] [blame] | 319 | |
| 320 | extern void ceph_mdsc_pre_umount(struct ceph_mds_client *mdsc); |
| 321 | |
| 322 | extern char *ceph_mdsc_build_path(struct dentry *dentry, int *plen, u64 *base, |
| 323 | int stop_on_nosnap); |
| 324 | |
| 325 | extern void __ceph_mdsc_drop_dentry_lease(struct dentry *dentry); |
| 326 | extern void ceph_mdsc_lease_send_msg(struct ceph_mds_session *session, |
| 327 | struct inode *inode, |
| 328 | struct dentry *dentry, char action, |
| 329 | u32 seq); |
| 330 | |
| 331 | extern void ceph_mdsc_handle_map(struct ceph_mds_client *mdsc, |
| 332 | struct ceph_msg *msg); |
| 333 | |
| 334 | #endif |