messenger.h 8.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302
  1. #ifndef __FS_CEPH_MESSENGER_H
  2. #define __FS_CEPH_MESSENGER_H
  3. #include <linux/kref.h>
  4. #include <linux/mutex.h>
  5. #include <linux/net.h>
  6. #include <linux/radix-tree.h>
  7. #include <linux/uio.h>
  8. #include <linux/workqueue.h>
  9. #include <linux/ceph/types.h>
  10. #include <linux/ceph/buffer.h>
  11. struct ceph_msg;
  12. struct ceph_connection;
  13. /*
  14. * Ceph defines these callbacks for handling connection events.
  15. */
  16. struct ceph_connection_operations {
  17. struct ceph_connection *(*get)(struct ceph_connection *);
  18. void (*put)(struct ceph_connection *);
  19. /* handle an incoming message. */
  20. void (*dispatch) (struct ceph_connection *con, struct ceph_msg *m);
  21. /* authorize an outgoing connection */
  22. struct ceph_auth_handshake *(*get_authorizer) (
  23. struct ceph_connection *con,
  24. int *proto, int force_new);
  25. int (*verify_authorizer_reply) (struct ceph_connection *con, int len);
  26. int (*invalidate_authorizer)(struct ceph_connection *con);
  27. /* there was some error on the socket (disconnect, whatever) */
  28. void (*fault) (struct ceph_connection *con);
  29. /* a remote host as terminated a message exchange session, and messages
  30. * we sent (or they tried to send us) may be lost. */
  31. void (*peer_reset) (struct ceph_connection *con);
  32. struct ceph_msg * (*alloc_msg) (struct ceph_connection *con,
  33. struct ceph_msg_header *hdr,
  34. int *skip);
  35. };
  36. /* use format string %s%d */
  37. #define ENTITY_NAME(n) ceph_entity_type_name((n).type), le64_to_cpu((n).num)
  38. struct ceph_messenger {
  39. struct ceph_entity_inst inst; /* my name+address */
  40. struct ceph_entity_addr my_enc_addr;
  41. atomic_t stopping;
  42. bool nocrc;
  43. /*
  44. * the global_seq counts connections i (attempt to) initiate
  45. * in order to disambiguate certain connect race conditions.
  46. */
  47. u32 global_seq;
  48. spinlock_t global_seq_lock;
  49. u32 supported_features;
  50. u32 required_features;
  51. };
  52. #define ceph_msg_has_pages(m) ((m)->p.type == CEPH_MSG_DATA_PAGES)
  53. #define ceph_msg_has_pagelist(m) ((m)->l.type == CEPH_MSG_DATA_PAGELIST)
  54. #ifdef CONFIG_BLOCK
  55. #define ceph_msg_has_bio(m) ((m)->b.type == CEPH_MSG_DATA_BIO)
  56. #endif /* CONFIG_BLOCK */
  57. #define ceph_msg_has_trail(m) ((m)->t.type == CEPH_MSG_DATA_PAGELIST)
  58. enum ceph_msg_data_type {
  59. CEPH_MSG_DATA_NONE, /* message contains no data payload */
  60. CEPH_MSG_DATA_PAGES, /* data source/destination is a page array */
  61. CEPH_MSG_DATA_PAGELIST, /* data source/destination is a pagelist */
  62. #ifdef CONFIG_BLOCK
  63. CEPH_MSG_DATA_BIO, /* data source/destination is a bio list */
  64. #endif /* CONFIG_BLOCK */
  65. };
  66. static __inline__ bool ceph_msg_data_type_valid(enum ceph_msg_data_type type)
  67. {
  68. switch (type) {
  69. case CEPH_MSG_DATA_NONE:
  70. case CEPH_MSG_DATA_PAGES:
  71. case CEPH_MSG_DATA_PAGELIST:
  72. #ifdef CONFIG_BLOCK
  73. case CEPH_MSG_DATA_BIO:
  74. #endif /* CONFIG_BLOCK */
  75. return true;
  76. default:
  77. return false;
  78. }
  79. }
  80. struct ceph_msg_data_cursor {
  81. bool last_piece; /* now at last piece of data item */
  82. struct page *page; /* current page in pagelist */
  83. size_t offset; /* pagelist bytes consumed */
  84. };
  85. struct ceph_msg_data {
  86. enum ceph_msg_data_type type;
  87. union {
  88. #ifdef CONFIG_BLOCK
  89. struct {
  90. struct bio *bio_iter; /* iterator */
  91. struct bio *bio;
  92. unsigned int bio_seg; /* current seg in bio */
  93. };
  94. #endif /* CONFIG_BLOCK */
  95. struct {
  96. struct page **pages; /* NOT OWNER. */
  97. size_t length; /* total # bytes */
  98. unsigned int alignment; /* first page */
  99. };
  100. struct ceph_pagelist *pagelist;
  101. };
  102. struct ceph_msg_data_cursor cursor; /* pagelist only */
  103. };
  104. /*
  105. * a single message. it contains a header (src, dest, message type, etc.),
  106. * footer (crc values, mainly), a "front" message body, and possibly a
  107. * data payload (stored in some number of pages).
  108. */
  109. struct ceph_msg {
  110. struct ceph_msg_header hdr; /* header */
  111. struct ceph_msg_footer footer; /* footer */
  112. struct kvec front; /* unaligned blobs of message */
  113. struct ceph_buffer *middle;
  114. /* data payload */
  115. struct ceph_msg_data p; /* pages */
  116. struct ceph_msg_data l; /* pagelist */
  117. #ifdef CONFIG_BLOCK
  118. struct ceph_msg_data b; /* bio */
  119. #endif /* CONFIG_BLOCK */
  120. struct ceph_msg_data t; /* trail */
  121. struct ceph_connection *con;
  122. struct list_head list_head; /* links for connection lists */
  123. struct kref kref;
  124. bool front_is_vmalloc;
  125. bool more_to_follow;
  126. bool needs_out_seq;
  127. int front_max;
  128. unsigned long ack_stamp; /* tx: when we were acked */
  129. struct ceph_msgpool *pool;
  130. };
  131. struct ceph_msg_pos {
  132. int page, page_pos; /* which page; offset in page */
  133. int data_pos; /* offset in data payload */
  134. bool did_page_crc; /* true if we've calculated crc for current page */
  135. };
  136. /* ceph connection fault delay defaults, for exponential backoff */
  137. #define BASE_DELAY_INTERVAL (HZ/2)
  138. #define MAX_DELAY_INTERVAL (5 * 60 * HZ)
  139. /*
  140. * A single connection with another host.
  141. *
  142. * We maintain a queue of outgoing messages, and some session state to
  143. * ensure that we can preserve the lossless, ordered delivery of
  144. * messages in the case of a TCP disconnect.
  145. */
  146. struct ceph_connection {
  147. void *private;
  148. const struct ceph_connection_operations *ops;
  149. struct ceph_messenger *msgr;
  150. atomic_t sock_state;
  151. struct socket *sock;
  152. struct ceph_entity_addr peer_addr; /* peer address */
  153. struct ceph_entity_addr peer_addr_for_me;
  154. unsigned long flags;
  155. unsigned long state;
  156. const char *error_msg; /* error message, if any */
  157. struct ceph_entity_name peer_name; /* peer name */
  158. unsigned peer_features;
  159. u32 connect_seq; /* identify the most recent connection
  160. attempt for this connection, client */
  161. u32 peer_global_seq; /* peer's global seq for this connection */
  162. int auth_retry; /* true if we need a newer authorizer */
  163. void *auth_reply_buf; /* where to put the authorizer reply */
  164. int auth_reply_buf_len;
  165. struct mutex mutex;
  166. /* out queue */
  167. struct list_head out_queue;
  168. struct list_head out_sent; /* sending or sent but unacked */
  169. u64 out_seq; /* last message queued for send */
  170. u64 in_seq, in_seq_acked; /* last message received, acked */
  171. /* connection negotiation temps */
  172. char in_banner[CEPH_BANNER_MAX_LEN];
  173. struct ceph_msg_connect out_connect;
  174. struct ceph_msg_connect_reply in_reply;
  175. struct ceph_entity_addr actual_peer_addr;
  176. /* message out temps */
  177. struct ceph_msg *out_msg; /* sending message (== tail of
  178. out_sent) */
  179. bool out_msg_done;
  180. struct ceph_msg_pos out_msg_pos;
  181. struct kvec out_kvec[8], /* sending header/footer data */
  182. *out_kvec_cur;
  183. int out_kvec_left; /* kvec's left in out_kvec */
  184. int out_skip; /* skip this many bytes */
  185. int out_kvec_bytes; /* total bytes left */
  186. bool out_kvec_is_msg; /* kvec refers to out_msg */
  187. int out_more; /* there is more data after the kvecs */
  188. __le64 out_temp_ack; /* for writing an ack */
  189. /* message in temps */
  190. struct ceph_msg_header in_hdr;
  191. struct ceph_msg *in_msg;
  192. struct ceph_msg_pos in_msg_pos;
  193. u32 in_front_crc, in_middle_crc, in_data_crc; /* calculated crc */
  194. char in_tag; /* protocol control byte */
  195. int in_base_pos; /* bytes read */
  196. __le64 in_temp_ack; /* for reading an ack */
  197. struct delayed_work work; /* send|recv work */
  198. unsigned long delay; /* current delay interval */
  199. };
  200. extern const char *ceph_pr_addr(const struct sockaddr_storage *ss);
  201. extern int ceph_parse_ips(const char *c, const char *end,
  202. struct ceph_entity_addr *addr,
  203. int max_count, int *count);
  204. extern int ceph_msgr_init(void);
  205. extern void ceph_msgr_exit(void);
  206. extern void ceph_msgr_flush(void);
  207. extern void ceph_messenger_init(struct ceph_messenger *msgr,
  208. struct ceph_entity_addr *myaddr,
  209. u32 supported_features,
  210. u32 required_features,
  211. bool nocrc);
  212. extern void ceph_con_init(struct ceph_connection *con, void *private,
  213. const struct ceph_connection_operations *ops,
  214. struct ceph_messenger *msgr);
  215. extern void ceph_con_open(struct ceph_connection *con,
  216. __u8 entity_type, __u64 entity_num,
  217. struct ceph_entity_addr *addr);
  218. extern bool ceph_con_opened(struct ceph_connection *con);
  219. extern void ceph_con_close(struct ceph_connection *con);
  220. extern void ceph_con_send(struct ceph_connection *con, struct ceph_msg *msg);
  221. extern void ceph_msg_revoke(struct ceph_msg *msg);
  222. extern void ceph_msg_revoke_incoming(struct ceph_msg *msg);
  223. extern void ceph_con_keepalive(struct ceph_connection *con);
  224. extern void ceph_msg_data_set_pages(struct ceph_msg *msg, struct page **pages,
  225. size_t length, size_t alignment);
  226. extern void ceph_msg_data_set_pagelist(struct ceph_msg *msg,
  227. struct ceph_pagelist *pagelist);
  228. extern void ceph_msg_data_set_bio(struct ceph_msg *msg, struct bio *bio);
  229. extern void ceph_msg_data_set_trail(struct ceph_msg *msg,
  230. struct ceph_pagelist *trail);
  231. extern struct ceph_msg *ceph_msg_new(int type, int front_len, gfp_t flags,
  232. bool can_fail);
  233. extern void ceph_msg_kfree(struct ceph_msg *m);
  234. static inline struct ceph_msg *ceph_msg_get(struct ceph_msg *msg)
  235. {
  236. kref_get(&msg->kref);
  237. return msg;
  238. }
  239. extern void ceph_msg_last_put(struct kref *kref);
  240. static inline void ceph_msg_put(struct ceph_msg *msg)
  241. {
  242. kref_put(&msg->kref, ceph_msg_last_put);
  243. }
  244. extern void ceph_msg_dump(struct ceph_msg *msg);
  245. #endif