1 /* SPDX-License-Identifier: GPL-2.0 */ 2 #ifndef CEPH_MSGR_H 3 #define CEPH_MSGR_H 4 5 /* 6 * Data types for message passing layer used by Ceph. 7 */ 8 9 #define CEPH_MON_PORT 6789 /* default monitor port */ 10 11 /* 12 * tcp connection banner. include a protocol version. and adjust 13 * whenever the wire protocol changes. try to keep this string length 14 * constant. 15 */ 16 #define CEPH_BANNER "ceph v027" 17 #define CEPH_BANNER_LEN 9 18 #define CEPH_BANNER_MAX_LEN 30 19 20 21 /* 22 * messenger V2 connection banner prefix. 23 * The full banner string should have the form: "ceph v2\n<le16>" 24 * the 2 bytes are the length of the remaining banner. 25 */ 26 #define CEPH_BANNER_V2 "ceph v2\n" 27 #define CEPH_BANNER_V2_LEN 8 28 #define CEPH_BANNER_V2_PREFIX_LEN (CEPH_BANNER_V2_LEN + sizeof(__le16)) 29 30 /* 31 * messenger V2 features 32 */ 33 #define CEPH_MSGR2_INCARNATION_1 (0ull) 34 35 #define DEFINE_MSGR2_FEATURE(bit, incarnation, name) \ 36 static const uint64_t __maybe_unused CEPH_MSGR2_FEATURE_##name = (1ULL << bit); \ 37 static const uint64_t __maybe_unused CEPH_MSGR2_FEATUREMASK_##name = \ 38 (1ULL << bit | CEPH_MSGR2_INCARNATION_##incarnation); 39 40 #define HAVE_MSGR2_FEATURE(x, name) \ 41 (((x) & (CEPH_MSGR2_FEATUREMASK_##name)) == (CEPH_MSGR2_FEATUREMASK_##name)) 42 43 DEFINE_MSGR2_FEATURE( 0, 1, REVISION_1) // msgr2.1 44 45 #define CEPH_MSGR2_SUPPORTED_FEATURES (CEPH_MSGR2_FEATURE_REVISION_1) 46 47 #define CEPH_MSGR2_REQUIRED_FEATURES (CEPH_MSGR2_FEATURE_REVISION_1) 48 49 50 /* 51 * Rollover-safe type and comparator for 32-bit sequence numbers. 52 * Comparator returns -1, 0, or 1. 53 */ 54 typedef __u32 ceph_seq_t; 55 ceph_seq_cmp(__u32 a,__u32 b)56 static inline __s32 ceph_seq_cmp(__u32 a, __u32 b) 57 { 58 return (__s32)a - (__s32)b; 59 } 60 61 62 /* 63 * entity_name -- logical name for a process participating in the 64 * network, e.g. 'mds0' or 'osd3'. 65 */ 66 struct ceph_entity_name { 67 __u8 type; /* CEPH_ENTITY_TYPE_* */ 68 __le64 num; 69 } __attribute__ ((packed)); 70 71 #define CEPH_ENTITY_TYPE_MON 0x01 72 #define CEPH_ENTITY_TYPE_MDS 0x02 73 #define CEPH_ENTITY_TYPE_OSD 0x04 74 #define CEPH_ENTITY_TYPE_CLIENT 0x08 75 #define CEPH_ENTITY_TYPE_AUTH 0x20 76 77 #define CEPH_ENTITY_TYPE_ANY 0xFF 78 79 extern const char *ceph_entity_type_name(int type); 80 81 /* 82 * entity_addr -- network address 83 */ 84 struct ceph_entity_addr { 85 __le32 type; /* CEPH_ENTITY_ADDR_TYPE_* */ 86 __le32 nonce; /* unique id for process (e.g. pid) */ 87 struct sockaddr_storage in_addr; 88 } __attribute__ ((packed)); 89 ceph_addr_equal_no_type(const struct ceph_entity_addr * lhs,const struct ceph_entity_addr * rhs)90 static inline bool ceph_addr_equal_no_type(const struct ceph_entity_addr *lhs, 91 const struct ceph_entity_addr *rhs) 92 { 93 return !memcmp(&lhs->in_addr, &rhs->in_addr, sizeof(lhs->in_addr)) && 94 lhs->nonce == rhs->nonce; 95 } 96 97 struct ceph_entity_inst { 98 struct ceph_entity_name name; 99 struct ceph_entity_addr addr; 100 } __attribute__ ((packed)); 101 102 103 /* used by message exchange protocol */ 104 #define CEPH_MSGR_TAG_READY 1 /* server->client: ready for messages */ 105 #define CEPH_MSGR_TAG_RESETSESSION 2 /* server->client: reset, try again */ 106 #define CEPH_MSGR_TAG_WAIT 3 /* server->client: wait for racing 107 incoming connection */ 108 #define CEPH_MSGR_TAG_RETRY_SESSION 4 /* server->client + cseq: try again 109 with higher cseq */ 110 #define CEPH_MSGR_TAG_RETRY_GLOBAL 5 /* server->client + gseq: try again 111 with higher gseq */ 112 #define CEPH_MSGR_TAG_CLOSE 6 /* closing pipe */ 113 #define CEPH_MSGR_TAG_MSG 7 /* message */ 114 #define CEPH_MSGR_TAG_ACK 8 /* message ack */ 115 #define CEPH_MSGR_TAG_KEEPALIVE 9 /* just a keepalive byte! */ 116 #define CEPH_MSGR_TAG_BADPROTOVER 10 /* bad protocol version */ 117 #define CEPH_MSGR_TAG_BADAUTHORIZER 11 /* bad authorizer */ 118 #define CEPH_MSGR_TAG_FEATURES 12 /* insufficient features */ 119 #define CEPH_MSGR_TAG_SEQ 13 /* 64-bit int follows with seen seq number */ 120 #define CEPH_MSGR_TAG_KEEPALIVE2 14 /* keepalive2 byte + ceph_timespec */ 121 #define CEPH_MSGR_TAG_KEEPALIVE2_ACK 15 /* keepalive2 reply */ 122 #define CEPH_MSGR_TAG_CHALLENGE_AUTHORIZER 16 /* cephx v2 doing server challenge */ 123 124 /* 125 * connection negotiation 126 */ 127 struct ceph_msg_connect { 128 __le64 features; /* supported feature bits */ 129 __le32 host_type; /* CEPH_ENTITY_TYPE_* */ 130 __le32 global_seq; /* count connections initiated by this host */ 131 __le32 connect_seq; /* count connections initiated in this session */ 132 __le32 protocol_version; 133 __le32 authorizer_protocol; 134 __le32 authorizer_len; 135 __u8 flags; /* CEPH_MSG_CONNECT_* */ 136 } __attribute__ ((packed)); 137 138 struct ceph_msg_connect_reply { 139 __u8 tag; 140 __le64 features; /* feature bits for this session */ 141 __le32 global_seq; 142 __le32 connect_seq; 143 __le32 protocol_version; 144 __le32 authorizer_len; 145 __u8 flags; 146 } __attribute__ ((packed)); 147 148 #define CEPH_MSG_CONNECT_LOSSY 1 /* messages i send may be safely dropped */ 149 150 151 /* 152 * message header 153 */ 154 struct ceph_msg_header_old { 155 __le64 seq; /* message seq# for this session */ 156 __le64 tid; /* transaction id */ 157 __le16 type; /* message type */ 158 __le16 priority; /* priority. higher value == higher priority */ 159 __le16 version; /* version of message encoding */ 160 161 __le32 front_len; /* bytes in main payload */ 162 __le32 middle_len;/* bytes in middle payload */ 163 __le32 data_len; /* bytes of data payload */ 164 __le16 data_off; /* sender: include full offset; 165 receiver: mask against ~PAGE_MASK */ 166 167 struct ceph_entity_inst src, orig_src; 168 __le32 reserved; 169 __le32 crc; /* header crc32c */ 170 } __attribute__ ((packed)); 171 172 struct ceph_msg_header { 173 __le64 seq; /* message seq# for this session */ 174 __le64 tid; /* transaction id */ 175 __le16 type; /* message type */ 176 __le16 priority; /* priority. higher value == higher priority */ 177 __le16 version; /* version of message encoding */ 178 179 __le32 front_len; /* bytes in main payload */ 180 __le32 middle_len;/* bytes in middle payload */ 181 __le32 data_len; /* bytes of data payload */ 182 __le16 data_off; /* sender: include full offset; 183 receiver: mask against ~PAGE_MASK */ 184 185 struct ceph_entity_name src; 186 __le16 compat_version; 187 __le16 reserved; 188 __le32 crc; /* header crc32c */ 189 } __attribute__ ((packed)); 190 191 struct ceph_msg_header2 { 192 __le64 seq; /* message seq# for this session */ 193 __le64 tid; /* transaction id */ 194 __le16 type; /* message type */ 195 __le16 priority; /* priority. higher value == higher priority */ 196 __le16 version; /* version of message encoding */ 197 198 __le32 data_pre_padding_len; 199 __le16 data_off; /* sender: include full offset; 200 receiver: mask against ~PAGE_MASK */ 201 202 __le64 ack_seq; 203 __u8 flags; 204 /* oldest code we think can decode this. unknown if zero. */ 205 __le16 compat_version; 206 __le16 reserved; 207 } __attribute__ ((packed)); 208 209 #define CEPH_MSG_PRIO_LOW 64 210 #define CEPH_MSG_PRIO_DEFAULT 127 211 #define CEPH_MSG_PRIO_HIGH 196 212 #define CEPH_MSG_PRIO_HIGHEST 255 213 214 /* 215 * follows data payload 216 */ 217 struct ceph_msg_footer_old { 218 __le32 front_crc, middle_crc, data_crc; 219 __u8 flags; 220 } __attribute__ ((packed)); 221 222 struct ceph_msg_footer { 223 __le32 front_crc, middle_crc, data_crc; 224 // sig holds the 64 bits of the digital signature for the message PLR 225 __le64 sig; 226 __u8 flags; 227 } __attribute__ ((packed)); 228 229 #define CEPH_MSG_FOOTER_COMPLETE (1<<0) /* msg wasn't aborted */ 230 #define CEPH_MSG_FOOTER_NOCRC (1<<1) /* no data crc */ 231 #define CEPH_MSG_FOOTER_SIGNED (1<<2) /* msg was signed */ 232 233 234 #endif 235