linux/include/linux/ceph/osd_client.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0 */
   2#ifndef _FS_CEPH_OSD_CLIENT_H
   3#define _FS_CEPH_OSD_CLIENT_H
   4
   5#include <linux/bitrev.h>
   6#include <linux/completion.h>
   7#include <linux/kref.h>
   8#include <linux/mempool.h>
   9#include <linux/rbtree.h>
  10#include <linux/refcount.h>
  11
  12#include <linux/ceph/types.h>
  13#include <linux/ceph/osdmap.h>
  14#include <linux/ceph/messenger.h>
  15#include <linux/ceph/msgpool.h>
  16#include <linux/ceph/auth.h>
  17#include <linux/ceph/pagelist.h>
  18
  19struct ceph_msg;
  20struct ceph_snap_context;
  21struct ceph_osd_request;
  22struct ceph_osd_client;
  23
  24/*
  25 * completion callback for async writepages
  26 */
  27typedef void (*ceph_osdc_callback_t)(struct ceph_osd_request *);
  28
  29#define CEPH_HOMELESS_OSD       -1
  30
  31/* a given osd we're communicating with */
  32struct ceph_osd {
  33        refcount_t o_ref;
  34        struct ceph_osd_client *o_osdc;
  35        int o_osd;
  36        int o_incarnation;
  37        struct rb_node o_node;
  38        struct ceph_connection o_con;
  39        struct rb_root o_requests;
  40        struct rb_root o_linger_requests;
  41        struct rb_root o_backoff_mappings;
  42        struct rb_root o_backoffs_by_id;
  43        struct list_head o_osd_lru;
  44        struct ceph_auth_handshake o_auth;
  45        unsigned long lru_ttl;
  46        struct list_head o_keepalive_item;
  47        struct mutex lock;
  48};
  49
  50#define CEPH_OSD_SLAB_OPS       2
  51#define CEPH_OSD_MAX_OPS        16
  52
  53enum ceph_osd_data_type {
  54        CEPH_OSD_DATA_TYPE_NONE = 0,
  55        CEPH_OSD_DATA_TYPE_PAGES,
  56        CEPH_OSD_DATA_TYPE_PAGELIST,
  57#ifdef CONFIG_BLOCK
  58        CEPH_OSD_DATA_TYPE_BIO,
  59#endif /* CONFIG_BLOCK */
  60        CEPH_OSD_DATA_TYPE_BVECS,
  61};
  62
  63struct ceph_osd_data {
  64        enum ceph_osd_data_type type;
  65        union {
  66                struct {
  67                        struct page     **pages;
  68                        u64             length;
  69                        u32             alignment;
  70                        bool            pages_from_pool;
  71                        bool            own_pages;
  72                };
  73                struct ceph_pagelist    *pagelist;
  74#ifdef CONFIG_BLOCK
  75                struct {
  76                        struct ceph_bio_iter    bio_pos;
  77                        u32                     bio_length;
  78                };
  79#endif /* CONFIG_BLOCK */
  80                struct {
  81                        struct ceph_bvec_iter   bvec_pos;
  82                        u32                     num_bvecs;
  83                };
  84        };
  85};
  86
  87struct ceph_osd_req_op {
  88        u16 op;           /* CEPH_OSD_OP_* */
  89        u32 flags;        /* CEPH_OSD_OP_FLAG_* */
  90        u32 indata_len;   /* request */
  91        u32 outdata_len;  /* reply */
  92        s32 rval;
  93
  94        union {
  95                struct ceph_osd_data raw_data_in;
  96                struct {
  97                        u64 offset, length;
  98                        u64 truncate_size;
  99                        u32 truncate_seq;
 100                        struct ceph_osd_data osd_data;
 101                } extent;
 102                struct {
 103                        u32 name_len;
 104                        u32 value_len;
 105                        __u8 cmp_op;       /* CEPH_OSD_CMPXATTR_OP_* */
 106                        __u8 cmp_mode;     /* CEPH_OSD_CMPXATTR_MODE_* */
 107                        struct ceph_osd_data osd_data;
 108                } xattr;
 109                struct {
 110                        const char *class_name;
 111                        const char *method_name;
 112                        struct ceph_osd_data request_info;
 113                        struct ceph_osd_data request_data;
 114                        struct ceph_osd_data response_data;
 115                        __u8 class_len;
 116                        __u8 method_len;
 117                        u32 indata_len;
 118                } cls;
 119                struct {
 120                        u64 cookie;
 121                        __u8 op;           /* CEPH_OSD_WATCH_OP_ */
 122                        u32 gen;
 123                } watch;
 124                struct {
 125                        struct ceph_osd_data request_data;
 126                } notify_ack;
 127                struct {
 128                        u64 cookie;
 129                        struct ceph_osd_data request_data;
 130                        struct ceph_osd_data response_data;
 131                } notify;
 132                struct {
 133                        struct ceph_osd_data response_data;
 134                } list_watchers;
 135                struct {
 136                        u64 expected_object_size;
 137                        u64 expected_write_size;
 138                } alloc_hint;
 139                struct {
 140                        u64 snapid;
 141                        u64 src_version;
 142                        u8 flags;
 143                        u32 src_fadvise_flags;
 144                        struct ceph_osd_data osd_data;
 145                } copy_from;
 146        };
 147};
 148
 149struct ceph_osd_request_target {
 150        struct ceph_object_id base_oid;
 151        struct ceph_object_locator base_oloc;
 152        struct ceph_object_id target_oid;
 153        struct ceph_object_locator target_oloc;
 154
 155        struct ceph_pg pgid;               /* last raw pg we mapped to */
 156        struct ceph_spg spgid;             /* last actual spg we mapped to */
 157        u32 pg_num;
 158        u32 pg_num_mask;
 159        struct ceph_osds acting;
 160        struct ceph_osds up;
 161        int size;
 162        int min_size;
 163        bool sort_bitwise;
 164        bool recovery_deletes;
 165
 166        unsigned int flags;                /* CEPH_OSD_FLAG_* */
 167        bool paused;
 168
 169        u32 epoch;
 170        u32 last_force_resend;
 171
 172        int osd;
 173};
 174
 175/* an in-flight request */
 176struct ceph_osd_request {
 177        u64             r_tid;              /* unique for this client */
 178        struct rb_node  r_node;
 179        struct rb_node  r_mc_node;          /* map check */
 180        struct work_struct r_complete_work;
 181        struct ceph_osd *r_osd;
 182
 183        struct ceph_osd_request_target r_t;
 184#define r_base_oid      r_t.base_oid
 185#define r_base_oloc     r_t.base_oloc
 186#define r_flags         r_t.flags
 187
 188        struct ceph_msg  *r_request, *r_reply;
 189        u32               r_sent;      /* >0 if r_request is sending/sent */
 190
 191        /* request osd ops array  */
 192        unsigned int            r_num_ops;
 193
 194        int               r_result;
 195
 196        struct ceph_osd_client *r_osdc;
 197        struct kref       r_kref;
 198        bool              r_mempool;
 199        struct completion r_completion;       /* private to osd_client.c */
 200        ceph_osdc_callback_t r_callback;
 201
 202        struct inode *r_inode;                /* for use by callbacks */
 203        struct list_head r_private_item;      /* ditto */
 204        void *r_priv;                         /* ditto */
 205
 206        /* set by submitter */
 207        u64 r_snapid;                         /* for reads, CEPH_NOSNAP o/w */
 208        struct ceph_snap_context *r_snapc;    /* for writes */
 209        struct timespec64 r_mtime;            /* ditto */
 210        u64 r_data_offset;                    /* ditto */
 211        bool r_linger;                        /* don't resend on failure */
 212
 213        /* internal */
 214        unsigned long r_stamp;                /* jiffies, send or check time */
 215        unsigned long r_start_stamp;          /* jiffies */
 216        int r_attempts;
 217        u32 r_map_dne_bound;
 218
 219        struct ceph_osd_req_op r_ops[];
 220};
 221
 222struct ceph_request_redirect {
 223        struct ceph_object_locator oloc;
 224};
 225
 226/*
 227 * osd request identifier
 228 *
 229 * caller name + incarnation# + tid to unique identify this request
 230 */
 231struct ceph_osd_reqid {
 232        struct ceph_entity_name name;
 233        __le64 tid;
 234        __le32 inc;
 235} __packed;
 236
 237struct ceph_blkin_trace_info {
 238        __le64 trace_id;
 239        __le64 span_id;
 240        __le64 parent_span_id;
 241} __packed;
 242
 243typedef void (*rados_watchcb2_t)(void *arg, u64 notify_id, u64 cookie,
 244                                 u64 notifier_id, void *data, size_t data_len);
 245typedef void (*rados_watcherrcb_t)(void *arg, u64 cookie, int err);
 246
 247struct ceph_osd_linger_request {
 248        struct ceph_osd_client *osdc;
 249        u64 linger_id;
 250        bool committed;
 251        bool is_watch;                  /* watch or notify */
 252
 253        struct ceph_osd *osd;
 254        struct ceph_osd_request *reg_req;
 255        struct ceph_osd_request *ping_req;
 256        unsigned long ping_sent;
 257        unsigned long watch_valid_thru;
 258        struct list_head pending_lworks;
 259
 260        struct ceph_osd_request_target t;
 261        u32 map_dne_bound;
 262
 263        struct timespec64 mtime;
 264
 265        struct kref kref;
 266        struct mutex lock;
 267        struct rb_node node;            /* osd */
 268        struct rb_node osdc_node;       /* osdc */
 269        struct rb_node mc_node;         /* map check */
 270        struct list_head scan_item;
 271
 272        struct completion reg_commit_wait;
 273        struct completion notify_finish_wait;
 274        int reg_commit_error;
 275        int notify_finish_error;
 276        int last_error;
 277
 278        u32 register_gen;
 279        u64 notify_id;
 280
 281        rados_watchcb2_t wcb;
 282        rados_watcherrcb_t errcb;
 283        void *data;
 284
 285        struct page ***preply_pages;
 286        size_t *preply_len;
 287};
 288
 289struct ceph_watch_item {
 290        struct ceph_entity_name name;
 291        u64 cookie;
 292        struct ceph_entity_addr addr;
 293};
 294
 295struct ceph_spg_mapping {
 296        struct rb_node node;
 297        struct ceph_spg spgid;
 298
 299        struct rb_root backoffs;
 300};
 301
 302struct ceph_hobject_id {
 303        void *key;
 304        size_t key_len;
 305        void *oid;
 306        size_t oid_len;
 307        u64 snapid;
 308        u32 hash;
 309        u8 is_max;
 310        void *nspace;
 311        size_t nspace_len;
 312        s64 pool;
 313
 314        /* cache */
 315        u32 hash_reverse_bits;
 316};
 317
 318static inline void ceph_hoid_build_hash_cache(struct ceph_hobject_id *hoid)
 319{
 320        hoid->hash_reverse_bits = bitrev32(hoid->hash);
 321}
 322
 323/*
 324 * PG-wide backoff: [begin, end)
 325 * per-object backoff: begin == end
 326 */
 327struct ceph_osd_backoff {
 328        struct rb_node spg_node;
 329        struct rb_node id_node;
 330
 331        struct ceph_spg spgid;
 332        u64 id;
 333        struct ceph_hobject_id *begin;
 334        struct ceph_hobject_id *end;
 335};
 336
 337#define CEPH_LINGER_ID_START    0xffff000000000000ULL
 338
 339struct ceph_osd_client {
 340        struct ceph_client     *client;
 341
 342        struct ceph_osdmap     *osdmap;       /* current map */
 343        struct rw_semaphore    lock;
 344
 345        struct rb_root         osds;          /* osds */
 346        struct list_head       osd_lru;       /* idle osds */
 347        spinlock_t             osd_lru_lock;
 348        u32                    epoch_barrier;
 349        struct ceph_osd        homeless_osd;
 350        atomic64_t             last_tid;      /* tid of last request */
 351        u64                    last_linger_id;
 352        struct rb_root         linger_requests; /* lingering requests */
 353        struct rb_root         map_checks;
 354        struct rb_root         linger_map_checks;
 355        atomic_t               num_requests;
 356        atomic_t               num_homeless;
 357        int                    abort_err;
 358        struct delayed_work    timeout_work;
 359        struct delayed_work    osds_timeout_work;
 360#ifdef CONFIG_DEBUG_FS
 361        struct dentry          *debugfs_file;
 362#endif
 363
 364        mempool_t              *req_mempool;
 365
 366        struct ceph_msgpool     msgpool_op;
 367        struct ceph_msgpool     msgpool_op_reply;
 368
 369        struct workqueue_struct *notify_wq;
 370        struct workqueue_struct *completion_wq;
 371};
 372
 373static inline bool ceph_osdmap_flag(struct ceph_osd_client *osdc, int flag)
 374{
 375        return osdc->osdmap->flags & flag;
 376}
 377
 378extern int ceph_osdc_setup(void);
 379extern void ceph_osdc_cleanup(void);
 380
 381extern int ceph_osdc_init(struct ceph_osd_client *osdc,
 382                          struct ceph_client *client);
 383extern void ceph_osdc_stop(struct ceph_osd_client *osdc);
 384extern void ceph_osdc_reopen_osds(struct ceph_osd_client *osdc);
 385
 386extern void ceph_osdc_handle_reply(struct ceph_osd_client *osdc,
 387                                   struct ceph_msg *msg);
 388extern void ceph_osdc_handle_map(struct ceph_osd_client *osdc,
 389                                 struct ceph_msg *msg);
 390void ceph_osdc_update_epoch_barrier(struct ceph_osd_client *osdc, u32 eb);
 391void ceph_osdc_abort_requests(struct ceph_osd_client *osdc, int err);
 392void ceph_osdc_clear_abort_err(struct ceph_osd_client *osdc);
 393
 394#define osd_req_op_data(oreq, whch, typ, fld)                           \
 395({                                                                      \
 396        struct ceph_osd_request *__oreq = (oreq);                       \
 397        unsigned int __whch = (whch);                                   \
 398        BUG_ON(__whch >= __oreq->r_num_ops);                            \
 399        &__oreq->r_ops[__whch].typ.fld;                                 \
 400})
 401
 402extern void osd_req_op_init(struct ceph_osd_request *osd_req,
 403                            unsigned int which, u16 opcode, u32 flags);
 404
 405extern void osd_req_op_raw_data_in_pages(struct ceph_osd_request *,
 406                                        unsigned int which,
 407                                        struct page **pages, u64 length,
 408                                        u32 alignment, bool pages_from_pool,
 409                                        bool own_pages);
 410
 411extern void osd_req_op_extent_init(struct ceph_osd_request *osd_req,
 412                                        unsigned int which, u16 opcode,
 413                                        u64 offset, u64 length,
 414                                        u64 truncate_size, u32 truncate_seq);
 415extern void osd_req_op_extent_update(struct ceph_osd_request *osd_req,
 416                                        unsigned int which, u64 length);
 417extern void osd_req_op_extent_dup_last(struct ceph_osd_request *osd_req,
 418                                       unsigned int which, u64 offset_inc);
 419
 420extern struct ceph_osd_data *osd_req_op_extent_osd_data(
 421                                        struct ceph_osd_request *osd_req,
 422                                        unsigned int which);
 423
 424extern void osd_req_op_extent_osd_data_pages(struct ceph_osd_request *,
 425                                        unsigned int which,
 426                                        struct page **pages, u64 length,
 427                                        u32 alignment, bool pages_from_pool,
 428                                        bool own_pages);
 429extern void osd_req_op_extent_osd_data_pagelist(struct ceph_osd_request *,
 430                                        unsigned int which,
 431                                        struct ceph_pagelist *pagelist);
 432#ifdef CONFIG_BLOCK
 433void osd_req_op_extent_osd_data_bio(struct ceph_osd_request *osd_req,
 434                                    unsigned int which,
 435                                    struct ceph_bio_iter *bio_pos,
 436                                    u32 bio_length);
 437#endif /* CONFIG_BLOCK */
 438void osd_req_op_extent_osd_data_bvecs(struct ceph_osd_request *osd_req,
 439                                      unsigned int which,
 440                                      struct bio_vec *bvecs, u32 num_bvecs,
 441                                      u32 bytes);
 442void osd_req_op_extent_osd_data_bvec_pos(struct ceph_osd_request *osd_req,
 443                                         unsigned int which,
 444                                         struct ceph_bvec_iter *bvec_pos);
 445
 446extern void osd_req_op_cls_request_data_pagelist(struct ceph_osd_request *,
 447                                        unsigned int which,
 448                                        struct ceph_pagelist *pagelist);
 449extern void osd_req_op_cls_request_data_pages(struct ceph_osd_request *,
 450                                        unsigned int which,
 451                                        struct page **pages, u64 length,
 452                                        u32 alignment, bool pages_from_pool,
 453                                        bool own_pages);
 454void osd_req_op_cls_request_data_bvecs(struct ceph_osd_request *osd_req,
 455                                       unsigned int which,
 456                                       struct bio_vec *bvecs, u32 num_bvecs,
 457                                       u32 bytes);
 458extern void osd_req_op_cls_response_data_pages(struct ceph_osd_request *,
 459                                        unsigned int which,
 460                                        struct page **pages, u64 length,
 461                                        u32 alignment, bool pages_from_pool,
 462                                        bool own_pages);
 463int osd_req_op_cls_init(struct ceph_osd_request *osd_req, unsigned int which,
 464                        const char *class, const char *method);
 465extern int osd_req_op_xattr_init(struct ceph_osd_request *osd_req, unsigned int which,
 466                                 u16 opcode, const char *name, const void *value,
 467                                 size_t size, u8 cmp_op, u8 cmp_mode);
 468extern void osd_req_op_alloc_hint_init(struct ceph_osd_request *osd_req,
 469                                       unsigned int which,
 470                                       u64 expected_object_size,
 471                                       u64 expected_write_size);
 472
 473extern struct ceph_osd_request *ceph_osdc_alloc_request(struct ceph_osd_client *osdc,
 474                                               struct ceph_snap_context *snapc,
 475                                               unsigned int num_ops,
 476                                               bool use_mempool,
 477                                               gfp_t gfp_flags);
 478int ceph_osdc_alloc_messages(struct ceph_osd_request *req, gfp_t gfp);
 479
 480extern struct ceph_osd_request *ceph_osdc_new_request(struct ceph_osd_client *,
 481                                      struct ceph_file_layout *layout,
 482                                      struct ceph_vino vino,
 483                                      u64 offset, u64 *len,
 484                                      unsigned int which, int num_ops,
 485                                      int opcode, int flags,
 486                                      struct ceph_snap_context *snapc,
 487                                      u32 truncate_seq, u64 truncate_size,
 488                                      bool use_mempool);
 489
 490extern void ceph_osdc_get_request(struct ceph_osd_request *req);
 491extern void ceph_osdc_put_request(struct ceph_osd_request *req);
 492
 493extern int ceph_osdc_start_request(struct ceph_osd_client *osdc,
 494                                   struct ceph_osd_request *req,
 495                                   bool nofail);
 496extern void ceph_osdc_cancel_request(struct ceph_osd_request *req);
 497extern int ceph_osdc_wait_request(struct ceph_osd_client *osdc,
 498                                  struct ceph_osd_request *req);
 499extern void ceph_osdc_sync(struct ceph_osd_client *osdc);
 500
 501extern void ceph_osdc_flush_notifies(struct ceph_osd_client *osdc);
 502void ceph_osdc_maybe_request_map(struct ceph_osd_client *osdc);
 503
 504int ceph_osdc_call(struct ceph_osd_client *osdc,
 505                   struct ceph_object_id *oid,
 506                   struct ceph_object_locator *oloc,
 507                   const char *class, const char *method,
 508                   unsigned int flags,
 509                   struct page *req_page, size_t req_len,
 510                   struct page **resp_pages, size_t *resp_len);
 511
 512extern int ceph_osdc_readpages(struct ceph_osd_client *osdc,
 513                               struct ceph_vino vino,
 514                               struct ceph_file_layout *layout,
 515                               u64 off, u64 *plen,
 516                               u32 truncate_seq, u64 truncate_size,
 517                               struct page **pages, int nr_pages,
 518                               int page_align);
 519
 520extern int ceph_osdc_writepages(struct ceph_osd_client *osdc,
 521                                struct ceph_vino vino,
 522                                struct ceph_file_layout *layout,
 523                                struct ceph_snap_context *sc,
 524                                u64 off, u64 len,
 525                                u32 truncate_seq, u64 truncate_size,
 526                                struct timespec64 *mtime,
 527                                struct page **pages, int nr_pages);
 528
 529int ceph_osdc_copy_from(struct ceph_osd_client *osdc,
 530                        u64 src_snapid, u64 src_version,
 531                        struct ceph_object_id *src_oid,
 532                        struct ceph_object_locator *src_oloc,
 533                        u32 src_fadvise_flags,
 534                        struct ceph_object_id *dst_oid,
 535                        struct ceph_object_locator *dst_oloc,
 536                        u32 dst_fadvise_flags,
 537                        u8 copy_from_flags);
 538
 539/* watch/notify */
 540struct ceph_osd_linger_request *
 541ceph_osdc_watch(struct ceph_osd_client *osdc,
 542                struct ceph_object_id *oid,
 543                struct ceph_object_locator *oloc,
 544                rados_watchcb2_t wcb,
 545                rados_watcherrcb_t errcb,
 546                void *data);
 547int ceph_osdc_unwatch(struct ceph_osd_client *osdc,
 548                      struct ceph_osd_linger_request *lreq);
 549
 550int ceph_osdc_notify_ack(struct ceph_osd_client *osdc,
 551                         struct ceph_object_id *oid,
 552                         struct ceph_object_locator *oloc,
 553                         u64 notify_id,
 554                         u64 cookie,
 555                         void *payload,
 556                         u32 payload_len);
 557int ceph_osdc_notify(struct ceph_osd_client *osdc,
 558                     struct ceph_object_id *oid,
 559                     struct ceph_object_locator *oloc,
 560                     void *payload,
 561                     u32 payload_len,
 562                     u32 timeout,
 563                     struct page ***preply_pages,
 564                     size_t *preply_len);
 565int ceph_osdc_watch_check(struct ceph_osd_client *osdc,
 566                          struct ceph_osd_linger_request *lreq);
 567int ceph_osdc_list_watchers(struct ceph_osd_client *osdc,
 568                            struct ceph_object_id *oid,
 569                            struct ceph_object_locator *oloc,
 570                            struct ceph_watch_item **watchers,
 571                            u32 *num_watchers);
 572#endif
 573
 574