2 * net/tipc/msg.h: Include file for TIPC message header routines
4 * Copyright (c) 2000-2007, Ericsson AB
5 * Copyright (c) 2005-2007, Wind River Systems
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are met:
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
16 * 3. Neither the names of the copyright holders nor the names of its
17 * contributors may be used to endorse or promote products derived from
18 * this software without specific prior written permission.
20 * Alternatively, this software may be distributed under the terms of the
21 * GNU General Public License ("GPL") version 2 as published by the Free
22 * Software Foundation.
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
28 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34 * POSSIBILITY OF SUCH DAMAGE.
42 #define TIPC_VERSION 2
43 #define DATA_LOW TIPC_LOW_IMPORTANCE
44 #define DATA_MEDIUM TIPC_MEDIUM_IMPORTANCE
45 #define DATA_HIGH TIPC_HIGH_IMPORTANCE
46 #define DATA_CRITICAL TIPC_CRITICAL_IMPORTANCE
47 #define SHORT_H_SIZE 24 /* Connected,in cluster */
48 #define DIR_MSG_H_SIZE 32 /* Directly addressed messages */
49 #define CONN_MSG_H_SIZE 36 /* Routed connected msgs*/
50 #define LONG_H_SIZE 40 /* Named Messages */
51 #define MCAST_H_SIZE 44 /* Multicast messages */
52 #define MAX_H_SIZE 60 /* Inclusive full options */
53 #define MAX_MSG_SIZE (MAX_H_SIZE + TIPC_MAX_USER_MSG_SIZE)
54 #define LINK_CONFIG 13
58 TIPC user data message header format, version 2
60 - Fundamental definitions available to privileged TIPC users
61 are located in tipc_msg.h.
62 - Remaining definitions available to TIPC internal users appear below.
66 static inline void msg_set_word(struct tipc_msg
*m
, u32 w
, u32 val
)
68 m
->hdr
[w
] = htonl(val
);
71 static inline void msg_set_bits(struct tipc_msg
*m
, u32 w
,
72 u32 pos
, u32 mask
, u32 val
)
74 val
= (val
& mask
) << pos
;
76 mask
= htonl(mask
<< pos
);
85 static inline u32
msg_version(struct tipc_msg
*m
)
87 return msg_bits(m
, 0, 29, 7);
90 static inline void msg_set_version(struct tipc_msg
*m
)
92 msg_set_bits(m
, 0, 29, 0xf, TIPC_VERSION
);
95 static inline u32
msg_user(struct tipc_msg
*m
)
97 return msg_bits(m
, 0, 25, 0xf);
100 static inline u32
msg_isdata(struct tipc_msg
*m
)
102 return (msg_user(m
) <= DATA_CRITICAL
);
105 static inline void msg_set_user(struct tipc_msg
*m
, u32 n
)
107 msg_set_bits(m
, 0, 25, 0xf, n
);
110 static inline void msg_set_importance(struct tipc_msg
*m
, u32 i
)
115 static inline void msg_set_hdr_sz(struct tipc_msg
*m
,u32 n
)
117 msg_set_bits(m
, 0, 21, 0xf, n
>>2);
120 static inline int msg_non_seq(struct tipc_msg
*m
)
122 return msg_bits(m
, 0, 20, 1);
125 static inline void msg_set_non_seq(struct tipc_msg
*m
)
127 msg_set_bits(m
, 0, 20, 1, 1);
130 static inline int msg_dest_droppable(struct tipc_msg
*m
)
132 return msg_bits(m
, 0, 19, 1);
135 static inline void msg_set_dest_droppable(struct tipc_msg
*m
, u32 d
)
137 msg_set_bits(m
, 0, 19, 1, d
);
140 static inline int msg_src_droppable(struct tipc_msg
*m
)
142 return msg_bits(m
, 0, 18, 1);
145 static inline void msg_set_src_droppable(struct tipc_msg
*m
, u32 d
)
147 msg_set_bits(m
, 0, 18, 1, d
);
150 static inline void msg_set_size(struct tipc_msg
*m
, u32 sz
)
152 m
->hdr
[0] = htonl((msg_word(m
, 0) & ~0x1ffff) | sz
);
160 static inline void msg_set_type(struct tipc_msg
*m
, u32 n
)
162 msg_set_bits(m
, 1, 29, 0x7, n
);
165 static inline void msg_set_errcode(struct tipc_msg
*m
, u32 err
)
167 msg_set_bits(m
, 1, 25, 0xf, err
);
170 static inline u32
msg_reroute_cnt(struct tipc_msg
*m
)
172 return msg_bits(m
, 1, 21, 0xf);
175 static inline void msg_incr_reroute_cnt(struct tipc_msg
*m
)
177 msg_set_bits(m
, 1, 21, 0xf, msg_reroute_cnt(m
) + 1);
180 static inline void msg_reset_reroute_cnt(struct tipc_msg
*m
)
182 msg_set_bits(m
, 1, 21, 0xf, 0);
185 static inline u32
msg_lookup_scope(struct tipc_msg
*m
)
187 return msg_bits(m
, 1, 19, 0x3);
190 static inline void msg_set_lookup_scope(struct tipc_msg
*m
, u32 n
)
192 msg_set_bits(m
, 1, 19, 0x3, n
);
195 static inline void msg_set_options(struct tipc_msg
*m
, const char *opt
, u32 sz
)
197 u32 hsz
= msg_hdr_sz(m
);
198 char *to
= (char *)&m
->hdr
[hsz
/4];
200 if ((hsz
< DIR_MSG_H_SIZE
) || ((hsz
+ sz
) > MAX_H_SIZE
))
202 msg_set_bits(m
, 1, 16, 0x7, (hsz
- 28)/4);
203 msg_set_hdr_sz(m
, hsz
+ sz
);
207 static inline u32
msg_bcast_ack(struct tipc_msg
*m
)
209 return msg_bits(m
, 1, 0, 0xffff);
212 static inline void msg_set_bcast_ack(struct tipc_msg
*m
, u32 n
)
214 msg_set_bits(m
, 1, 0, 0xffff, n
);
222 static inline u32
msg_ack(struct tipc_msg
*m
)
224 return msg_bits(m
, 2, 16, 0xffff);
227 static inline void msg_set_ack(struct tipc_msg
*m
, u32 n
)
229 msg_set_bits(m
, 2, 16, 0xffff, n
);
232 static inline u32
msg_seqno(struct tipc_msg
*m
)
234 return msg_bits(m
, 2, 0, 0xffff);
237 static inline void msg_set_seqno(struct tipc_msg
*m
, u32 n
)
239 msg_set_bits(m
, 2, 0, 0xffff, n
);
248 static inline void msg_set_prevnode(struct tipc_msg
*m
, u32 a
)
250 msg_set_word(m
, 3, a
);
253 static inline void msg_set_origport(struct tipc_msg
*m
, u32 p
)
255 msg_set_word(m
, 4, p
);
258 static inline void msg_set_destport(struct tipc_msg
*m
, u32 p
)
260 msg_set_word(m
, 5, p
);
263 static inline void msg_set_mc_netid(struct tipc_msg
*m
, u32 p
)
265 msg_set_word(m
, 5, p
);
268 static inline void msg_set_orignode(struct tipc_msg
*m
, u32 a
)
270 msg_set_word(m
, 6, a
);
273 static inline void msg_set_destnode(struct tipc_msg
*m
, u32 a
)
275 msg_set_word(m
, 7, a
);
278 static inline int msg_is_dest(struct tipc_msg
*m
, u32 d
)
280 return(msg_short(m
) || (msg_destnode(m
) == d
));
283 static inline u32
msg_routed(struct tipc_msg
*m
)
285 if (likely(msg_short(m
)))
287 return(msg_destnode(m
) ^ msg_orignode(m
)) >> 11;
290 static inline void msg_set_nametype(struct tipc_msg
*m
, u32 n
)
292 msg_set_word(m
, 8, n
);
295 static inline u32
msg_transp_seqno(struct tipc_msg
*m
)
297 return msg_word(m
, 8);
300 static inline void msg_set_timestamp(struct tipc_msg
*m
, u32 n
)
302 msg_set_word(m
, 8, n
);
305 static inline u32
msg_timestamp(struct tipc_msg
*m
)
307 return msg_word(m
, 8);
310 static inline void msg_set_transp_seqno(struct tipc_msg
*m
, u32 n
)
312 msg_set_word(m
, 8, n
);
315 static inline void msg_set_namelower(struct tipc_msg
*m
, u32 n
)
317 msg_set_word(m
, 9, n
);
320 static inline void msg_set_nameinst(struct tipc_msg
*m
, u32 n
)
322 msg_set_namelower(m
, n
);
325 static inline void msg_set_nameupper(struct tipc_msg
*m
, u32 n
)
327 msg_set_word(m
, 10, n
);
330 static inline struct tipc_msg
*msg_get_wrapped(struct tipc_msg
*m
)
332 return (struct tipc_msg
*)msg_data(m
);
335 static inline void msg_expand(struct tipc_msg
*m
, u32 destnode
)
339 msg_set_hdr_sz(m
, LONG_H_SIZE
);
340 msg_set_orignode(m
, msg_prevnode(m
));
341 msg_set_destnode(m
, destnode
);
342 memset(&m
->hdr
[8], 0, 12);
348 TIPC internal message header format, version 2
350 1 0 9 8 7 6 5 4|3 2 1 0 9 8 7 6|5 4 3 2 1 0 9 8|7 6 5 4 3 2 1 0
351 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
352 w0:|vers |msg usr|hdr sz |n|resrv| packet size |
353 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
354 w1:|m typ|rsv=0| sequence gap | broadcast ack no |
355 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
356 w2:| link level ack no/bc_gap_from | seq no / bcast_gap_to |
357 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
359 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
360 w4:| next sent broadcast/fragm no | next sent pkt/ fragm msg no |
361 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
362 w5:| session no |rsv=0|r|berid|link prio|netpl|p|
363 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
364 w6:| originating node |
365 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
366 w7:| destination node |
367 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
368 w8:| transport sequence number |
369 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
370 w9:| msg count / bcast tag | link tolerance |
371 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
373 / User Specific Data /
375 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
377 NB: CONN_MANAGER use data message format. LINK_CONFIG has own format.
384 #define BCAST_PROTOCOL 5
385 #define MSG_BUNDLER 6
386 #define LINK_PROTOCOL 7
387 #define CONN_MANAGER 8
388 #define ROUTE_DISTRIBUTOR 9
389 #define CHANGEOVER_PROTOCOL 10
390 #define NAME_DISTRIBUTOR 11
391 #define MSG_FRAGMENTER 12
392 #define LINK_CONFIG 13
393 #define INT_H_SIZE 40
394 #define DSC_H_SIZE 40
397 * Connection management protocol messages
401 #define CONN_PROBE_REPLY 1
405 * Name distributor messages
408 #define PUBLICATION 0
416 static inline u32
msg_seq_gap(struct tipc_msg
*m
)
418 return msg_bits(m
, 1, 16, 0xff);
421 static inline void msg_set_seq_gap(struct tipc_msg
*m
, u32 n
)
423 msg_set_bits(m
, 1, 16, 0xff, n
);
426 static inline u32
msg_req_links(struct tipc_msg
*m
)
428 return msg_bits(m
, 1, 16, 0xfff);
431 static inline void msg_set_req_links(struct tipc_msg
*m
, u32 n
)
433 msg_set_bits(m
, 1, 16, 0xfff, n
);
441 static inline u32
msg_dest_domain(struct tipc_msg
*m
)
443 return msg_word(m
, 2);
446 static inline void msg_set_dest_domain(struct tipc_msg
*m
, u32 n
)
448 msg_set_word(m
, 2, n
);
451 static inline u32
msg_bcgap_after(struct tipc_msg
*m
)
453 return msg_bits(m
, 2, 16, 0xffff);
456 static inline void msg_set_bcgap_after(struct tipc_msg
*m
, u32 n
)
458 msg_set_bits(m
, 2, 16, 0xffff, n
);
461 static inline u32
msg_bcgap_to(struct tipc_msg
*m
)
463 return msg_bits(m
, 2, 0, 0xffff);
466 static inline void msg_set_bcgap_to(struct tipc_msg
*m
, u32 n
)
468 msg_set_bits(m
, 2, 0, 0xffff, n
);
476 static inline u32
msg_last_bcast(struct tipc_msg
*m
)
478 return msg_bits(m
, 4, 16, 0xffff);
481 static inline void msg_set_last_bcast(struct tipc_msg
*m
, u32 n
)
483 msg_set_bits(m
, 4, 16, 0xffff, n
);
487 static inline u32
msg_fragm_no(struct tipc_msg
*m
)
489 return msg_bits(m
, 4, 16, 0xffff);
492 static inline void msg_set_fragm_no(struct tipc_msg
*m
, u32 n
)
494 msg_set_bits(m
, 4, 16, 0xffff, n
);
498 static inline u32
msg_next_sent(struct tipc_msg
*m
)
500 return msg_bits(m
, 4, 0, 0xffff);
503 static inline void msg_set_next_sent(struct tipc_msg
*m
, u32 n
)
505 msg_set_bits(m
, 4, 0, 0xffff, n
);
509 static inline u32
msg_long_msgno(struct tipc_msg
*m
)
511 return msg_bits(m
, 4, 0, 0xffff);
514 static inline void msg_set_long_msgno(struct tipc_msg
*m
, u32 n
)
516 msg_set_bits(m
, 4, 0, 0xffff, n
);
519 static inline u32
msg_bc_netid(struct tipc_msg
*m
)
521 return msg_word(m
, 4);
524 static inline void msg_set_bc_netid(struct tipc_msg
*m
, u32 id
)
526 msg_set_word(m
, 4, id
);
529 static inline u32
msg_link_selector(struct tipc_msg
*m
)
531 return msg_bits(m
, 4, 0, 1);
534 static inline void msg_set_link_selector(struct tipc_msg
*m
, u32 n
)
536 msg_set_bits(m
, 4, 0, 1, (n
& 1));
543 static inline u32
msg_session(struct tipc_msg
*m
)
545 return msg_bits(m
, 5, 16, 0xffff);
548 static inline void msg_set_session(struct tipc_msg
*m
, u32 n
)
550 msg_set_bits(m
, 5, 16, 0xffff, n
);
553 static inline u32
msg_probe(struct tipc_msg
*m
)
555 return msg_bits(m
, 5, 0, 1);
558 static inline void msg_set_probe(struct tipc_msg
*m
, u32 val
)
560 msg_set_bits(m
, 5, 0, 1, (val
& 1));
563 static inline char msg_net_plane(struct tipc_msg
*m
)
565 return msg_bits(m
, 5, 1, 7) + 'A';
568 static inline void msg_set_net_plane(struct tipc_msg
*m
, char n
)
570 msg_set_bits(m
, 5, 1, 7, (n
- 'A'));
573 static inline u32
msg_linkprio(struct tipc_msg
*m
)
575 return msg_bits(m
, 5, 4, 0x1f);
578 static inline void msg_set_linkprio(struct tipc_msg
*m
, u32 n
)
580 msg_set_bits(m
, 5, 4, 0x1f, n
);
583 static inline u32
msg_bearer_id(struct tipc_msg
*m
)
585 return msg_bits(m
, 5, 9, 0x7);
588 static inline void msg_set_bearer_id(struct tipc_msg
*m
, u32 n
)
590 msg_set_bits(m
, 5, 9, 0x7, n
);
593 static inline u32
msg_redundant_link(struct tipc_msg
*m
)
595 return msg_bits(m
, 5, 12, 0x1);
598 static inline void msg_set_redundant_link(struct tipc_msg
*m
)
600 msg_set_bits(m
, 5, 12, 0x1, 1);
603 static inline void msg_clear_redundant_link(struct tipc_msg
*m
)
605 msg_set_bits(m
, 5, 12, 0x1, 0);
613 static inline u32
msg_msgcnt(struct tipc_msg
*m
)
615 return msg_bits(m
, 9, 16, 0xffff);
618 static inline void msg_set_msgcnt(struct tipc_msg
*m
, u32 n
)
620 msg_set_bits(m
, 9, 16, 0xffff, n
);
623 static inline u32
msg_bcast_tag(struct tipc_msg
*m
)
625 return msg_bits(m
, 9, 16, 0xffff);
628 static inline void msg_set_bcast_tag(struct tipc_msg
*m
, u32 n
)
630 msg_set_bits(m
, 9, 16, 0xffff, n
);
633 static inline u32
msg_max_pkt(struct tipc_msg
*m
)
635 return (msg_bits(m
, 9, 16, 0xffff) * 4);
638 static inline void msg_set_max_pkt(struct tipc_msg
*m
, u32 n
)
640 msg_set_bits(m
, 9, 16, 0xffff, (n
/ 4));
643 static inline u32
msg_link_tolerance(struct tipc_msg
*m
)
645 return msg_bits(m
, 9, 0, 0xffff);
648 static inline void msg_set_link_tolerance(struct tipc_msg
*m
, u32 n
)
650 msg_set_bits(m
, 9, 0, 0xffff, n
);
654 * Routing table message data
658 static inline u32
msg_remote_node(struct tipc_msg
*m
)
660 return msg_word(m
, msg_hdr_sz(m
)/4);
663 static inline void msg_set_remote_node(struct tipc_msg
*m
, u32 a
)
665 msg_set_word(m
, msg_hdr_sz(m
)/4, a
);
668 static inline int msg_dataoctet(struct tipc_msg
*m
, u32 pos
)
670 return(msg_data(m
)[pos
+ 4] != 0);
673 static inline void msg_set_dataoctet(struct tipc_msg
*m
, u32 pos
)
675 msg_data(m
)[pos
+ 4] = 1;
679 * Segmentation message types
682 #define FIRST_FRAGMENT 0
684 #define LAST_FRAGMENT 2
687 * Link management protocol message types
692 #define ACTIVATE_MSG 2
695 * Changeover tunnel message types
697 #define DUPLICATE_MSG 0
698 #define ORIGINAL_MSG 1
701 * Routing table message types
703 #define EXT_ROUTING_TABLE 0
704 #define LOCAL_ROUTING_TABLE 1
705 #define SLAVE_ROUTING_TABLE 2
706 #define ROUTE_ADDITION 3
707 #define ROUTE_REMOVAL 4
710 * Config protocol message types
713 #define DSC_REQ_MSG 0
714 #define DSC_RESP_MSG 1
716 static inline u32
msg_tot_importance(struct tipc_msg
*m
)
718 if (likely(msg_isdata(m
))) {
719 if (likely(msg_orignode(m
) == tipc_own_addr
))
720 return msg_importance(m
);
721 return msg_importance(m
) + 4;
723 if ((msg_user(m
) == MSG_FRAGMENTER
) &&
724 (msg_type(m
) == FIRST_FRAGMENT
))
725 return msg_importance(msg_get_wrapped(m
));
726 return msg_importance(m
);
730 static inline void msg_init(struct tipc_msg
*m
, u32 user
, u32 type
,
731 u32 err
, u32 hsize
, u32 destnode
)
735 msg_set_user(m
, user
);
736 msg_set_hdr_sz(m
, hsize
);
737 msg_set_size(m
, hsize
);
738 msg_set_prevnode(m
, tipc_own_addr
);
739 msg_set_type(m
, type
);
740 msg_set_errcode(m
, err
);
742 msg_set_orignode(m
, tipc_own_addr
);
743 msg_set_destnode(m
, destnode
);
748 * msg_calc_data_size - determine total data size for message
751 static inline int msg_calc_data_size(struct iovec
const *msg_sect
, u32 num_sect
)
756 for (i
= 0; i
< num_sect
; i
++)
757 dsz
+= msg_sect
[i
].iov_len
;
762 * msg_build - create message using specified header and data
764 * Note: Caller must not hold any locks in case copy_from_user() is interrupted!
766 * Returns message data size or errno
769 static inline int msg_build(struct tipc_msg
*hdr
,
770 struct iovec
const *msg_sect
, u32 num_sect
,
771 int max_size
, int usrmem
, struct sk_buff
** buf
)
773 int dsz
, sz
, hsz
, pos
, res
, cnt
;
775 dsz
= msg_calc_data_size(msg_sect
, num_sect
);
776 if (unlikely(dsz
> TIPC_MAX_USER_MSG_SIZE
)) {
781 pos
= hsz
= msg_hdr_sz(hdr
);
783 msg_set_size(hdr
, sz
);
784 if (unlikely(sz
> max_size
)) {
789 *buf
= buf_acquire(sz
);
792 skb_copy_to_linear_data(*buf
, hdr
, hsz
);
793 for (res
= 1, cnt
= 0; res
&& (cnt
< num_sect
); cnt
++) {
795 res
= !copy_from_user((*buf
)->data
+ pos
,
796 msg_sect
[cnt
].iov_base
,
797 msg_sect
[cnt
].iov_len
);
799 skb_copy_to_linear_data_offset(*buf
, pos
,
800 msg_sect
[cnt
].iov_base
,
801 msg_sect
[cnt
].iov_len
);
802 pos
+= msg_sect
[cnt
].iov_len
;
812 static inline void msg_set_media_addr(struct tipc_msg
*m
, struct tipc_media_addr
*a
)
814 memcpy(&((int *)m
)[5], a
, sizeof(*a
));
817 static inline void msg_get_media_addr(struct tipc_msg
*m
, struct tipc_media_addr
*a
)
819 memcpy(a
, &((int*)m
)[5], sizeof(*a
));