Merge branch 'linus' into sched/core
[linux-2.6/x86.git] / net / tipc / msg.h
blob8452454731faa9e67cafd3570971faf7df6c59e4
1 /*
2 * net/tipc/msg.h: Include file for TIPC message header routines
4 * Copyright (c) 2000-2007, Ericsson AB
5 * Copyright (c) 2005-2008, 2010-2011, Wind River Systems
6 * All rights reserved.
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.
37 #ifndef _TIPC_MSG_H
38 #define _TIPC_MSG_H
40 #include "bearer.h"
43 * Constants and routines used to read and write TIPC payload message headers
45 * Note: Some items are also used with TIPC internal message headers
48 #define TIPC_VERSION 2
51 * Payload message users are defined in TIPC's public API:
52 * - TIPC_LOW_IMPORTANCE
53 * - TIPC_MEDIUM_IMPORTANCE
54 * - TIPC_HIGH_IMPORTANCE
55 * - TIPC_CRITICAL_IMPORTANCE
59 * Payload message types
62 #define TIPC_CONN_MSG 0
63 #define TIPC_MCAST_MSG 1
64 #define TIPC_NAMED_MSG 2
65 #define TIPC_DIRECT_MSG 3
68 * Message header sizes
71 #define SHORT_H_SIZE 24 /* Connected, in-cluster messages */
72 #define DIR_MSG_H_SIZE 32 /* Directly addressed messages */
73 #define LONG_H_SIZE 40 /* Named messages */
74 #define MCAST_H_SIZE 44 /* Multicast messages */
75 #define INT_H_SIZE 40 /* Internal messages */
76 #define MIN_H_SIZE 24 /* Smallest legal TIPC header size */
77 #define MAX_H_SIZE 60 /* Largest possible TIPC header size */
79 #define MAX_MSG_SIZE (MAX_H_SIZE + TIPC_MAX_USER_MSG_SIZE)
82 struct tipc_msg {
83 __be32 hdr[15];
87 static inline u32 msg_word(struct tipc_msg *m, u32 pos)
89 return ntohl(m->hdr[pos]);
92 static inline void msg_set_word(struct tipc_msg *m, u32 w, u32 val)
94 m->hdr[w] = htonl(val);
97 static inline u32 msg_bits(struct tipc_msg *m, u32 w, u32 pos, u32 mask)
99 return (msg_word(m, w) >> pos) & mask;
102 static inline void msg_set_bits(struct tipc_msg *m, u32 w,
103 u32 pos, u32 mask, u32 val)
105 val = (val & mask) << pos;
106 mask = mask << pos;
107 m->hdr[w] &= ~htonl(mask);
108 m->hdr[w] |= htonl(val);
111 static inline void msg_swap_words(struct tipc_msg *msg, u32 a, u32 b)
113 u32 temp = msg->hdr[a];
115 msg->hdr[a] = msg->hdr[b];
116 msg->hdr[b] = temp;
120 * Word 0
123 static inline u32 msg_version(struct tipc_msg *m)
125 return msg_bits(m, 0, 29, 7);
128 static inline void msg_set_version(struct tipc_msg *m)
130 msg_set_bits(m, 0, 29, 7, TIPC_VERSION);
133 static inline u32 msg_user(struct tipc_msg *m)
135 return msg_bits(m, 0, 25, 0xf);
138 static inline u32 msg_isdata(struct tipc_msg *m)
140 return msg_user(m) <= TIPC_CRITICAL_IMPORTANCE;
143 static inline void msg_set_user(struct tipc_msg *m, u32 n)
145 msg_set_bits(m, 0, 25, 0xf, n);
148 static inline u32 msg_importance(struct tipc_msg *m)
150 return msg_bits(m, 0, 25, 0xf);
153 static inline void msg_set_importance(struct tipc_msg *m, u32 i)
155 msg_set_user(m, i);
158 static inline u32 msg_hdr_sz(struct tipc_msg *m)
160 return msg_bits(m, 0, 21, 0xf) << 2;
163 static inline void msg_set_hdr_sz(struct tipc_msg *m, u32 n)
165 msg_set_bits(m, 0, 21, 0xf, n>>2);
168 static inline u32 msg_size(struct tipc_msg *m)
170 return msg_bits(m, 0, 0, 0x1ffff);
173 static inline u32 msg_data_sz(struct tipc_msg *m)
175 return msg_size(m) - msg_hdr_sz(m);
178 static inline int msg_non_seq(struct tipc_msg *m)
180 return msg_bits(m, 0, 20, 1);
183 static inline void msg_set_non_seq(struct tipc_msg *m, u32 n)
185 msg_set_bits(m, 0, 20, 1, n);
188 static inline int msg_dest_droppable(struct tipc_msg *m)
190 return msg_bits(m, 0, 19, 1);
193 static inline void msg_set_dest_droppable(struct tipc_msg *m, u32 d)
195 msg_set_bits(m, 0, 19, 1, d);
198 static inline int msg_src_droppable(struct tipc_msg *m)
200 return msg_bits(m, 0, 18, 1);
203 static inline void msg_set_src_droppable(struct tipc_msg *m, u32 d)
205 msg_set_bits(m, 0, 18, 1, d);
208 static inline void msg_set_size(struct tipc_msg *m, u32 sz)
210 m->hdr[0] = htonl((msg_word(m, 0) & ~0x1ffff) | sz);
215 * Word 1
218 static inline u32 msg_type(struct tipc_msg *m)
220 return msg_bits(m, 1, 29, 0x7);
223 static inline void msg_set_type(struct tipc_msg *m, u32 n)
225 msg_set_bits(m, 1, 29, 0x7, n);
228 static inline u32 msg_named(struct tipc_msg *m)
230 return msg_type(m) == TIPC_NAMED_MSG;
233 static inline u32 msg_mcast(struct tipc_msg *m)
235 return msg_type(m) == TIPC_MCAST_MSG;
238 static inline u32 msg_connected(struct tipc_msg *m)
240 return msg_type(m) == TIPC_CONN_MSG;
243 static inline u32 msg_errcode(struct tipc_msg *m)
245 return msg_bits(m, 1, 25, 0xf);
248 static inline void msg_set_errcode(struct tipc_msg *m, u32 err)
250 msg_set_bits(m, 1, 25, 0xf, err);
253 static inline u32 msg_reroute_cnt(struct tipc_msg *m)
255 return msg_bits(m, 1, 21, 0xf);
258 static inline void msg_incr_reroute_cnt(struct tipc_msg *m)
260 msg_set_bits(m, 1, 21, 0xf, msg_reroute_cnt(m) + 1);
263 static inline void msg_reset_reroute_cnt(struct tipc_msg *m)
265 msg_set_bits(m, 1, 21, 0xf, 0);
268 static inline u32 msg_lookup_scope(struct tipc_msg *m)
270 return msg_bits(m, 1, 19, 0x3);
273 static inline void msg_set_lookup_scope(struct tipc_msg *m, u32 n)
275 msg_set_bits(m, 1, 19, 0x3, n);
278 static inline u32 msg_bcast_ack(struct tipc_msg *m)
280 return msg_bits(m, 1, 0, 0xffff);
283 static inline void msg_set_bcast_ack(struct tipc_msg *m, u32 n)
285 msg_set_bits(m, 1, 0, 0xffff, n);
290 * Word 2
293 static inline u32 msg_ack(struct tipc_msg *m)
295 return msg_bits(m, 2, 16, 0xffff);
298 static inline void msg_set_ack(struct tipc_msg *m, u32 n)
300 msg_set_bits(m, 2, 16, 0xffff, n);
303 static inline u32 msg_seqno(struct tipc_msg *m)
305 return msg_bits(m, 2, 0, 0xffff);
308 static inline void msg_set_seqno(struct tipc_msg *m, u32 n)
310 msg_set_bits(m, 2, 0, 0xffff, n);
314 * TIPC may utilize the "link ack #" and "link seq #" fields of a short
315 * message header to hold the destination node for the message, since the
316 * normal "dest node" field isn't present. This cache is only referenced
317 * when required, so populating the cache of a longer message header is
318 * harmless (as long as the header has the two link sequence fields present).
320 * Note: Host byte order is OK here, since the info never goes off-card.
323 static inline u32 msg_destnode_cache(struct tipc_msg *m)
325 return m->hdr[2];
328 static inline void msg_set_destnode_cache(struct tipc_msg *m, u32 dnode)
330 m->hdr[2] = dnode;
334 * Words 3-10
338 static inline u32 msg_prevnode(struct tipc_msg *m)
340 return msg_word(m, 3);
343 static inline void msg_set_prevnode(struct tipc_msg *m, u32 a)
345 msg_set_word(m, 3, a);
348 static inline u32 msg_origport(struct tipc_msg *m)
350 return msg_word(m, 4);
353 static inline void msg_set_origport(struct tipc_msg *m, u32 p)
355 msg_set_word(m, 4, p);
358 static inline u32 msg_destport(struct tipc_msg *m)
360 return msg_word(m, 5);
363 static inline void msg_set_destport(struct tipc_msg *m, u32 p)
365 msg_set_word(m, 5, p);
368 static inline u32 msg_mc_netid(struct tipc_msg *m)
370 return msg_word(m, 5);
373 static inline void msg_set_mc_netid(struct tipc_msg *m, u32 p)
375 msg_set_word(m, 5, p);
378 static inline int msg_short(struct tipc_msg *m)
380 return msg_hdr_sz(m) == 24;
383 static inline u32 msg_orignode(struct tipc_msg *m)
385 if (likely(msg_short(m)))
386 return msg_prevnode(m);
387 return msg_word(m, 6);
390 static inline void msg_set_orignode(struct tipc_msg *m, u32 a)
392 msg_set_word(m, 6, a);
395 static inline u32 msg_destnode(struct tipc_msg *m)
397 return msg_word(m, 7);
400 static inline void msg_set_destnode(struct tipc_msg *m, u32 a)
402 msg_set_word(m, 7, a);
405 static inline int msg_is_dest(struct tipc_msg *m, u32 d)
407 return msg_short(m) || (msg_destnode(m) == d);
410 static inline u32 msg_nametype(struct tipc_msg *m)
412 return msg_word(m, 8);
415 static inline void msg_set_nametype(struct tipc_msg *m, u32 n)
417 msg_set_word(m, 8, n);
420 static inline u32 msg_nameinst(struct tipc_msg *m)
422 return msg_word(m, 9);
425 static inline u32 msg_namelower(struct tipc_msg *m)
427 return msg_nameinst(m);
430 static inline void msg_set_namelower(struct tipc_msg *m, u32 n)
432 msg_set_word(m, 9, n);
435 static inline void msg_set_nameinst(struct tipc_msg *m, u32 n)
437 msg_set_namelower(m, n);
440 static inline u32 msg_nameupper(struct tipc_msg *m)
442 return msg_word(m, 10);
445 static inline void msg_set_nameupper(struct tipc_msg *m, u32 n)
447 msg_set_word(m, 10, n);
450 static inline unchar *msg_data(struct tipc_msg *m)
452 return ((unchar *)m) + msg_hdr_sz(m);
455 static inline struct tipc_msg *msg_get_wrapped(struct tipc_msg *m)
457 return (struct tipc_msg *)msg_data(m);
462 * Constants and routines used to read and write TIPC internal message headers
466 * Internal message users
469 #define BCAST_PROTOCOL 5
470 #define MSG_BUNDLER 6
471 #define LINK_PROTOCOL 7
472 #define CONN_MANAGER 8
473 #define ROUTE_DISTRIBUTOR 9 /* obsoleted */
474 #define CHANGEOVER_PROTOCOL 10
475 #define NAME_DISTRIBUTOR 11
476 #define MSG_FRAGMENTER 12
477 #define LINK_CONFIG 13
480 * Connection management protocol message types
483 #define CONN_PROBE 0
484 #define CONN_PROBE_REPLY 1
485 #define CONN_ACK 2
488 * Name distributor message types
491 #define PUBLICATION 0
492 #define WITHDRAWAL 1
495 * Segmentation message types
498 #define FIRST_FRAGMENT 0
499 #define FRAGMENT 1
500 #define LAST_FRAGMENT 2
503 * Link management protocol message types
506 #define STATE_MSG 0
507 #define RESET_MSG 1
508 #define ACTIVATE_MSG 2
511 * Changeover tunnel message types
513 #define DUPLICATE_MSG 0
514 #define ORIGINAL_MSG 1
517 * Config protocol message types
520 #define DSC_REQ_MSG 0
521 #define DSC_RESP_MSG 1
525 * Word 1
528 static inline u32 msg_seq_gap(struct tipc_msg *m)
530 return msg_bits(m, 1, 16, 0x1fff);
533 static inline void msg_set_seq_gap(struct tipc_msg *m, u32 n)
535 msg_set_bits(m, 1, 16, 0x1fff, n);
540 * Word 2
543 static inline u32 msg_dest_domain(struct tipc_msg *m)
545 return msg_word(m, 2);
548 static inline void msg_set_dest_domain(struct tipc_msg *m, u32 n)
550 msg_set_word(m, 2, n);
553 static inline u32 msg_bcgap_after(struct tipc_msg *m)
555 return msg_bits(m, 2, 16, 0xffff);
558 static inline void msg_set_bcgap_after(struct tipc_msg *m, u32 n)
560 msg_set_bits(m, 2, 16, 0xffff, n);
563 static inline u32 msg_bcgap_to(struct tipc_msg *m)
565 return msg_bits(m, 2, 0, 0xffff);
568 static inline void msg_set_bcgap_to(struct tipc_msg *m, u32 n)
570 msg_set_bits(m, 2, 0, 0xffff, n);
575 * Word 4
578 static inline u32 msg_last_bcast(struct tipc_msg *m)
580 return msg_bits(m, 4, 16, 0xffff);
583 static inline void msg_set_last_bcast(struct tipc_msg *m, u32 n)
585 msg_set_bits(m, 4, 16, 0xffff, n);
589 static inline u32 msg_fragm_no(struct tipc_msg *m)
591 return msg_bits(m, 4, 16, 0xffff);
594 static inline void msg_set_fragm_no(struct tipc_msg *m, u32 n)
596 msg_set_bits(m, 4, 16, 0xffff, n);
600 static inline u32 msg_next_sent(struct tipc_msg *m)
602 return msg_bits(m, 4, 0, 0xffff);
605 static inline void msg_set_next_sent(struct tipc_msg *m, u32 n)
607 msg_set_bits(m, 4, 0, 0xffff, n);
611 static inline u32 msg_long_msgno(struct tipc_msg *m)
613 return msg_bits(m, 4, 0, 0xffff);
616 static inline void msg_set_long_msgno(struct tipc_msg *m, u32 n)
618 msg_set_bits(m, 4, 0, 0xffff, n);
621 static inline u32 msg_bc_netid(struct tipc_msg *m)
623 return msg_word(m, 4);
626 static inline void msg_set_bc_netid(struct tipc_msg *m, u32 id)
628 msg_set_word(m, 4, id);
631 static inline u32 msg_link_selector(struct tipc_msg *m)
633 return msg_bits(m, 4, 0, 1);
636 static inline void msg_set_link_selector(struct tipc_msg *m, u32 n)
638 msg_set_bits(m, 4, 0, 1, (n & 1));
642 * Word 5
645 static inline u32 msg_session(struct tipc_msg *m)
647 return msg_bits(m, 5, 16, 0xffff);
650 static inline void msg_set_session(struct tipc_msg *m, u32 n)
652 msg_set_bits(m, 5, 16, 0xffff, n);
655 static inline u32 msg_probe(struct tipc_msg *m)
657 return msg_bits(m, 5, 0, 1);
660 static inline void msg_set_probe(struct tipc_msg *m, u32 val)
662 msg_set_bits(m, 5, 0, 1, (val & 1));
665 static inline char msg_net_plane(struct tipc_msg *m)
667 return msg_bits(m, 5, 1, 7) + 'A';
670 static inline void msg_set_net_plane(struct tipc_msg *m, char n)
672 msg_set_bits(m, 5, 1, 7, (n - 'A'));
675 static inline u32 msg_linkprio(struct tipc_msg *m)
677 return msg_bits(m, 5, 4, 0x1f);
680 static inline void msg_set_linkprio(struct tipc_msg *m, u32 n)
682 msg_set_bits(m, 5, 4, 0x1f, n);
685 static inline u32 msg_bearer_id(struct tipc_msg *m)
687 return msg_bits(m, 5, 9, 0x7);
690 static inline void msg_set_bearer_id(struct tipc_msg *m, u32 n)
692 msg_set_bits(m, 5, 9, 0x7, n);
695 static inline u32 msg_redundant_link(struct tipc_msg *m)
697 return msg_bits(m, 5, 12, 0x1);
700 static inline void msg_set_redundant_link(struct tipc_msg *m, u32 r)
702 msg_set_bits(m, 5, 12, 0x1, r);
707 * Word 9
710 static inline u32 msg_msgcnt(struct tipc_msg *m)
712 return msg_bits(m, 9, 16, 0xffff);
715 static inline void msg_set_msgcnt(struct tipc_msg *m, u32 n)
717 msg_set_bits(m, 9, 16, 0xffff, n);
720 static inline u32 msg_bcast_tag(struct tipc_msg *m)
722 return msg_bits(m, 9, 16, 0xffff);
725 static inline void msg_set_bcast_tag(struct tipc_msg *m, u32 n)
727 msg_set_bits(m, 9, 16, 0xffff, n);
730 static inline u32 msg_max_pkt(struct tipc_msg *m)
732 return msg_bits(m, 9, 16, 0xffff) * 4;
735 static inline void msg_set_max_pkt(struct tipc_msg *m, u32 n)
737 msg_set_bits(m, 9, 16, 0xffff, (n / 4));
740 static inline u32 msg_link_tolerance(struct tipc_msg *m)
742 return msg_bits(m, 9, 0, 0xffff);
745 static inline void msg_set_link_tolerance(struct tipc_msg *m, u32 n)
747 msg_set_bits(m, 9, 0, 0xffff, n);
750 u32 tipc_msg_tot_importance(struct tipc_msg *m);
751 void tipc_msg_init(struct tipc_msg *m, u32 user, u32 type,
752 u32 hsize, u32 destnode);
753 int tipc_msg_build(struct tipc_msg *hdr, struct iovec const *msg_sect,
754 u32 num_sect, unsigned int total_len,
755 int max_size, int usrmem, struct sk_buff **buf);
757 static inline void msg_set_media_addr(struct tipc_msg *m, struct tipc_media_addr *a)
759 memcpy(&((int *)m)[5], a, sizeof(*a));
762 static inline void msg_get_media_addr(struct tipc_msg *m, struct tipc_media_addr *a)
764 memcpy(a, &((int *)m)[5], sizeof(*a));
767 #endif