linux/net/tipc/msg.h
<<
>>
Prefs
   1/*
   2 * net/tipc/msg.h: Include file for TIPC message header routines
   3 *
   4 * Copyright (c) 2000-2007, Ericsson AB
   5 * Copyright (c) 2005-2008, 2010-2011, Wind River Systems
   6 * All rights reserved.
   7 *
   8 * Redistribution and use in source and binary forms, with or without
   9 * modification, are permitted provided that the following conditions are met:
  10 *
  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.
  19 *
  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.
  23 *
  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.
  35 */
  36
  37#ifndef _TIPC_MSG_H
  38#define _TIPC_MSG_H
  39
  40#include "bearer.h"
  41
  42/*
  43 * Constants and routines used to read and write TIPC payload message headers
  44 *
  45 * Note: Some items are also used with TIPC internal message headers
  46 */
  47#define TIPC_VERSION              2
  48
  49/*
  50 * Payload message users are defined in TIPC's public API:
  51 * - TIPC_LOW_IMPORTANCE
  52 * - TIPC_MEDIUM_IMPORTANCE
  53 * - TIPC_HIGH_IMPORTANCE
  54 * - TIPC_CRITICAL_IMPORTANCE
  55 */
  56
  57/*
  58 * Payload message types
  59 */
  60#define TIPC_CONN_MSG           0
  61#define TIPC_MCAST_MSG          1
  62#define TIPC_NAMED_MSG          2
  63#define TIPC_DIRECT_MSG         3
  64
  65/*
  66 * Message header sizes
  67 */
  68#define SHORT_H_SIZE              24    /* In-cluster basic payload message */
  69#define BASIC_H_SIZE              32    /* Basic payload message */
  70#define NAMED_H_SIZE              40    /* Named payload message */
  71#define MCAST_H_SIZE              44    /* Multicast payload message */
  72#define INT_H_SIZE                40    /* Internal messages */
  73#define MIN_H_SIZE                24    /* Smallest legal TIPC header size */
  74#define MAX_H_SIZE                60    /* Largest possible TIPC header size */
  75
  76#define MAX_MSG_SIZE (MAX_H_SIZE + TIPC_MAX_USER_MSG_SIZE)
  77
  78#define TIPC_MEDIA_ADDR_OFFSET  5
  79
  80
  81struct tipc_msg {
  82        __be32 hdr[15];
  83};
  84
  85
  86static inline u32 msg_word(struct tipc_msg *m, u32 pos)
  87{
  88        return ntohl(m->hdr[pos]);
  89}
  90
  91static inline void msg_set_word(struct tipc_msg *m, u32 w, u32 val)
  92{
  93        m->hdr[w] = htonl(val);
  94}
  95
  96static inline u32 msg_bits(struct tipc_msg *m, u32 w, u32 pos, u32 mask)
  97{
  98        return (msg_word(m, w) >> pos) & mask;
  99}
 100
 101static inline void msg_set_bits(struct tipc_msg *m, u32 w,
 102                                u32 pos, u32 mask, u32 val)
 103{
 104        val = (val & mask) << pos;
 105        mask = mask << pos;
 106        m->hdr[w] &= ~htonl(mask);
 107        m->hdr[w] |= htonl(val);
 108}
 109
 110static inline void msg_swap_words(struct tipc_msg *msg, u32 a, u32 b)
 111{
 112        u32 temp = msg->hdr[a];
 113
 114        msg->hdr[a] = msg->hdr[b];
 115        msg->hdr[b] = temp;
 116}
 117
 118/*
 119 * Word 0
 120 */
 121static inline u32 msg_version(struct tipc_msg *m)
 122{
 123        return msg_bits(m, 0, 29, 7);
 124}
 125
 126static inline void msg_set_version(struct tipc_msg *m)
 127{
 128        msg_set_bits(m, 0, 29, 7, TIPC_VERSION);
 129}
 130
 131static inline u32 msg_user(struct tipc_msg *m)
 132{
 133        return msg_bits(m, 0, 25, 0xf);
 134}
 135
 136static inline u32 msg_isdata(struct tipc_msg *m)
 137{
 138        return msg_user(m) <= TIPC_CRITICAL_IMPORTANCE;
 139}
 140
 141static inline void msg_set_user(struct tipc_msg *m, u32 n)
 142{
 143        msg_set_bits(m, 0, 25, 0xf, n);
 144}
 145
 146static inline u32 msg_importance(struct tipc_msg *m)
 147{
 148        return msg_bits(m, 0, 25, 0xf);
 149}
 150
 151static inline void msg_set_importance(struct tipc_msg *m, u32 i)
 152{
 153        msg_set_user(m, i);
 154}
 155
 156static inline u32 msg_hdr_sz(struct tipc_msg *m)
 157{
 158        return msg_bits(m, 0, 21, 0xf) << 2;
 159}
 160
 161static inline void msg_set_hdr_sz(struct tipc_msg *m, u32 n)
 162{
 163        msg_set_bits(m, 0, 21, 0xf, n>>2);
 164}
 165
 166static inline u32 msg_size(struct tipc_msg *m)
 167{
 168        return msg_bits(m, 0, 0, 0x1ffff);
 169}
 170
 171static inline u32 msg_data_sz(struct tipc_msg *m)
 172{
 173        return msg_size(m) - msg_hdr_sz(m);
 174}
 175
 176static inline int msg_non_seq(struct tipc_msg *m)
 177{
 178        return msg_bits(m, 0, 20, 1);
 179}
 180
 181static inline void msg_set_non_seq(struct tipc_msg *m, u32 n)
 182{
 183        msg_set_bits(m, 0, 20, 1, n);
 184}
 185
 186static inline int msg_dest_droppable(struct tipc_msg *m)
 187{
 188        return msg_bits(m, 0, 19, 1);
 189}
 190
 191static inline void msg_set_dest_droppable(struct tipc_msg *m, u32 d)
 192{
 193        msg_set_bits(m, 0, 19, 1, d);
 194}
 195
 196static inline int msg_src_droppable(struct tipc_msg *m)
 197{
 198        return msg_bits(m, 0, 18, 1);
 199}
 200
 201static inline void msg_set_src_droppable(struct tipc_msg *m, u32 d)
 202{
 203        msg_set_bits(m, 0, 18, 1, d);
 204}
 205
 206static inline void msg_set_size(struct tipc_msg *m, u32 sz)
 207{
 208        m->hdr[0] = htonl((msg_word(m, 0) & ~0x1ffff) | sz);
 209}
 210
 211
 212/*
 213 * Word 1
 214 */
 215static inline u32 msg_type(struct tipc_msg *m)
 216{
 217        return msg_bits(m, 1, 29, 0x7);
 218}
 219
 220static inline void msg_set_type(struct tipc_msg *m, u32 n)
 221{
 222        msg_set_bits(m, 1, 29, 0x7, n);
 223}
 224
 225static inline u32 msg_named(struct tipc_msg *m)
 226{
 227        return msg_type(m) == TIPC_NAMED_MSG;
 228}
 229
 230static inline u32 msg_mcast(struct tipc_msg *m)
 231{
 232        return msg_type(m) == TIPC_MCAST_MSG;
 233}
 234
 235static inline u32 msg_connected(struct tipc_msg *m)
 236{
 237        return msg_type(m) == TIPC_CONN_MSG;
 238}
 239
 240static inline u32 msg_errcode(struct tipc_msg *m)
 241{
 242        return msg_bits(m, 1, 25, 0xf);
 243}
 244
 245static inline void msg_set_errcode(struct tipc_msg *m, u32 err)
 246{
 247        msg_set_bits(m, 1, 25, 0xf, err);
 248}
 249
 250static inline u32 msg_reroute_cnt(struct tipc_msg *m)
 251{
 252        return msg_bits(m, 1, 21, 0xf);
 253}
 254
 255static inline void msg_incr_reroute_cnt(struct tipc_msg *m)
 256{
 257        msg_set_bits(m, 1, 21, 0xf, msg_reroute_cnt(m) + 1);
 258}
 259
 260static inline void msg_reset_reroute_cnt(struct tipc_msg *m)
 261{
 262        msg_set_bits(m, 1, 21, 0xf, 0);
 263}
 264
 265static inline u32 msg_lookup_scope(struct tipc_msg *m)
 266{
 267        return msg_bits(m, 1, 19, 0x3);
 268}
 269
 270static inline void msg_set_lookup_scope(struct tipc_msg *m, u32 n)
 271{
 272        msg_set_bits(m, 1, 19, 0x3, n);
 273}
 274
 275static inline u32 msg_bcast_ack(struct tipc_msg *m)
 276{
 277        return msg_bits(m, 1, 0, 0xffff);
 278}
 279
 280static inline void msg_set_bcast_ack(struct tipc_msg *m, u32 n)
 281{
 282        msg_set_bits(m, 1, 0, 0xffff, n);
 283}
 284
 285
 286/*
 287 * Word 2
 288 */
 289static inline u32 msg_ack(struct tipc_msg *m)
 290{
 291        return msg_bits(m, 2, 16, 0xffff);
 292}
 293
 294static inline void msg_set_ack(struct tipc_msg *m, u32 n)
 295{
 296        msg_set_bits(m, 2, 16, 0xffff, n);
 297}
 298
 299static inline u32 msg_seqno(struct tipc_msg *m)
 300{
 301        return msg_bits(m, 2, 0, 0xffff);
 302}
 303
 304static inline void msg_set_seqno(struct tipc_msg *m, u32 n)
 305{
 306        msg_set_bits(m, 2, 0, 0xffff, n);
 307}
 308
 309/*
 310 * Words 3-10
 311 */
 312static inline u32 msg_prevnode(struct tipc_msg *m)
 313{
 314        return msg_word(m, 3);
 315}
 316
 317static inline void msg_set_prevnode(struct tipc_msg *m, u32 a)
 318{
 319        msg_set_word(m, 3, a);
 320}
 321
 322static inline u32 msg_origport(struct tipc_msg *m)
 323{
 324        return msg_word(m, 4);
 325}
 326
 327static inline void msg_set_origport(struct tipc_msg *m, u32 p)
 328{
 329        msg_set_word(m, 4, p);
 330}
 331
 332static inline u32 msg_destport(struct tipc_msg *m)
 333{
 334        return msg_word(m, 5);
 335}
 336
 337static inline void msg_set_destport(struct tipc_msg *m, u32 p)
 338{
 339        msg_set_word(m, 5, p);
 340}
 341
 342static inline u32 msg_mc_netid(struct tipc_msg *m)
 343{
 344        return msg_word(m, 5);
 345}
 346
 347static inline void msg_set_mc_netid(struct tipc_msg *m, u32 p)
 348{
 349        msg_set_word(m, 5, p);
 350}
 351
 352static inline int msg_short(struct tipc_msg *m)
 353{
 354        return msg_hdr_sz(m) == SHORT_H_SIZE;
 355}
 356
 357static inline u32 msg_orignode(struct tipc_msg *m)
 358{
 359        if (likely(msg_short(m)))
 360                return msg_prevnode(m);
 361        return msg_word(m, 6);
 362}
 363
 364static inline void msg_set_orignode(struct tipc_msg *m, u32 a)
 365{
 366        msg_set_word(m, 6, a);
 367}
 368
 369static inline u32 msg_destnode(struct tipc_msg *m)
 370{
 371        return msg_word(m, 7);
 372}
 373
 374static inline void msg_set_destnode(struct tipc_msg *m, u32 a)
 375{
 376        msg_set_word(m, 7, a);
 377}
 378
 379static inline u32 msg_nametype(struct tipc_msg *m)
 380{
 381        return msg_word(m, 8);
 382}
 383
 384static inline void msg_set_nametype(struct tipc_msg *m, u32 n)
 385{
 386        msg_set_word(m, 8, n);
 387}
 388
 389static inline u32 msg_nameinst(struct tipc_msg *m)
 390{
 391        return msg_word(m, 9);
 392}
 393
 394static inline u32 msg_namelower(struct tipc_msg *m)
 395{
 396        return msg_nameinst(m);
 397}
 398
 399static inline void msg_set_namelower(struct tipc_msg *m, u32 n)
 400{
 401        msg_set_word(m, 9, n);
 402}
 403
 404static inline void msg_set_nameinst(struct tipc_msg *m, u32 n)
 405{
 406        msg_set_namelower(m, n);
 407}
 408
 409static inline u32 msg_nameupper(struct tipc_msg *m)
 410{
 411        return msg_word(m, 10);
 412}
 413
 414static inline void msg_set_nameupper(struct tipc_msg *m, u32 n)
 415{
 416        msg_set_word(m, 10, n);
 417}
 418
 419static inline unchar *msg_data(struct tipc_msg *m)
 420{
 421        return ((unchar *)m) + msg_hdr_sz(m);
 422}
 423
 424static inline struct tipc_msg *msg_get_wrapped(struct tipc_msg *m)
 425{
 426        return (struct tipc_msg *)msg_data(m);
 427}
 428
 429/*
 430 * Constants and routines used to read and write TIPC internal message headers
 431 */
 432
 433/*
 434 * Internal message users
 435 */
 436#define  BCAST_PROTOCOL       5
 437#define  MSG_BUNDLER          6
 438#define  LINK_PROTOCOL        7
 439#define  CONN_MANAGER         8
 440#define  ROUTE_DISTRIBUTOR    9         /* obsoleted */
 441#define  CHANGEOVER_PROTOCOL  10
 442#define  NAME_DISTRIBUTOR     11
 443#define  MSG_FRAGMENTER       12
 444#define  LINK_CONFIG          13
 445
 446/*
 447 *  Connection management protocol message types
 448 */
 449#define CONN_PROBE        0
 450#define CONN_PROBE_REPLY  1
 451#define CONN_ACK          2
 452
 453/*
 454 * Name distributor message types
 455 */
 456#define PUBLICATION       0
 457#define WITHDRAWAL        1
 458
 459/*
 460 * Segmentation message types
 461 */
 462#define FIRST_FRAGMENT          0
 463#define FRAGMENT                1
 464#define LAST_FRAGMENT           2
 465
 466/*
 467 * Link management protocol message types
 468 */
 469#define STATE_MSG               0
 470#define RESET_MSG               1
 471#define ACTIVATE_MSG            2
 472
 473/*
 474 * Changeover tunnel message types
 475 */
 476#define DUPLICATE_MSG           0
 477#define ORIGINAL_MSG            1
 478
 479/*
 480 * Config protocol message types
 481 */
 482#define DSC_REQ_MSG             0
 483#define DSC_RESP_MSG            1
 484
 485
 486/*
 487 * Word 1
 488 */
 489static inline u32 msg_seq_gap(struct tipc_msg *m)
 490{
 491        return msg_bits(m, 1, 16, 0x1fff);
 492}
 493
 494static inline void msg_set_seq_gap(struct tipc_msg *m, u32 n)
 495{
 496        msg_set_bits(m, 1, 16, 0x1fff, n);
 497}
 498
 499static inline u32 msg_node_sig(struct tipc_msg *m)
 500{
 501        return msg_bits(m, 1, 0, 0xffff);
 502}
 503
 504static inline void msg_set_node_sig(struct tipc_msg *m, u32 n)
 505{
 506        msg_set_bits(m, 1, 0, 0xffff, n);
 507}
 508
 509
 510/*
 511 * Word 2
 512 */
 513static inline u32 msg_dest_domain(struct tipc_msg *m)
 514{
 515        return msg_word(m, 2);
 516}
 517
 518static inline void msg_set_dest_domain(struct tipc_msg *m, u32 n)
 519{
 520        msg_set_word(m, 2, n);
 521}
 522
 523static inline u32 msg_bcgap_after(struct tipc_msg *m)
 524{
 525        return msg_bits(m, 2, 16, 0xffff);
 526}
 527
 528static inline void msg_set_bcgap_after(struct tipc_msg *m, u32 n)
 529{
 530        msg_set_bits(m, 2, 16, 0xffff, n);
 531}
 532
 533static inline u32 msg_bcgap_to(struct tipc_msg *m)
 534{
 535        return msg_bits(m, 2, 0, 0xffff);
 536}
 537
 538static inline void msg_set_bcgap_to(struct tipc_msg *m, u32 n)
 539{
 540        msg_set_bits(m, 2, 0, 0xffff, n);
 541}
 542
 543
 544/*
 545 * Word 4
 546 */
 547static inline u32 msg_last_bcast(struct tipc_msg *m)
 548{
 549        return msg_bits(m, 4, 16, 0xffff);
 550}
 551
 552static inline void msg_set_last_bcast(struct tipc_msg *m, u32 n)
 553{
 554        msg_set_bits(m, 4, 16, 0xffff, n);
 555}
 556
 557static inline void msg_set_fragm_no(struct tipc_msg *m, u32 n)
 558{
 559        msg_set_bits(m, 4, 16, 0xffff, n);
 560}
 561
 562
 563static inline u32 msg_next_sent(struct tipc_msg *m)
 564{
 565        return msg_bits(m, 4, 0, 0xffff);
 566}
 567
 568static inline void msg_set_next_sent(struct tipc_msg *m, u32 n)
 569{
 570        msg_set_bits(m, 4, 0, 0xffff, n);
 571}
 572
 573static inline void msg_set_long_msgno(struct tipc_msg *m, u32 n)
 574{
 575        msg_set_bits(m, 4, 0, 0xffff, n);
 576}
 577
 578static inline u32 msg_bc_netid(struct tipc_msg *m)
 579{
 580        return msg_word(m, 4);
 581}
 582
 583static inline void msg_set_bc_netid(struct tipc_msg *m, u32 id)
 584{
 585        msg_set_word(m, 4, id);
 586}
 587
 588static inline u32 msg_link_selector(struct tipc_msg *m)
 589{
 590        return msg_bits(m, 4, 0, 1);
 591}
 592
 593static inline void msg_set_link_selector(struct tipc_msg *m, u32 n)
 594{
 595        msg_set_bits(m, 4, 0, 1, n);
 596}
 597
 598/*
 599 * Word 5
 600 */
 601static inline u32 msg_session(struct tipc_msg *m)
 602{
 603        return msg_bits(m, 5, 16, 0xffff);
 604}
 605
 606static inline void msg_set_session(struct tipc_msg *m, u32 n)
 607{
 608        msg_set_bits(m, 5, 16, 0xffff, n);
 609}
 610
 611static inline u32 msg_probe(struct tipc_msg *m)
 612{
 613        return msg_bits(m, 5, 0, 1);
 614}
 615
 616static inline void msg_set_probe(struct tipc_msg *m, u32 val)
 617{
 618        msg_set_bits(m, 5, 0, 1, val);
 619}
 620
 621static inline char msg_net_plane(struct tipc_msg *m)
 622{
 623        return msg_bits(m, 5, 1, 7) + 'A';
 624}
 625
 626static inline void msg_set_net_plane(struct tipc_msg *m, char n)
 627{
 628        msg_set_bits(m, 5, 1, 7, (n - 'A'));
 629}
 630
 631static inline u32 msg_linkprio(struct tipc_msg *m)
 632{
 633        return msg_bits(m, 5, 4, 0x1f);
 634}
 635
 636static inline void msg_set_linkprio(struct tipc_msg *m, u32 n)
 637{
 638        msg_set_bits(m, 5, 4, 0x1f, n);
 639}
 640
 641static inline u32 msg_bearer_id(struct tipc_msg *m)
 642{
 643        return msg_bits(m, 5, 9, 0x7);
 644}
 645
 646static inline void msg_set_bearer_id(struct tipc_msg *m, u32 n)
 647{
 648        msg_set_bits(m, 5, 9, 0x7, n);
 649}
 650
 651static inline u32 msg_redundant_link(struct tipc_msg *m)
 652{
 653        return msg_bits(m, 5, 12, 0x1);
 654}
 655
 656static inline void msg_set_redundant_link(struct tipc_msg *m, u32 r)
 657{
 658        msg_set_bits(m, 5, 12, 0x1, r);
 659}
 660
 661static inline char *msg_media_addr(struct tipc_msg *m)
 662{
 663        return (char *)&m->hdr[TIPC_MEDIA_ADDR_OFFSET];
 664}
 665
 666/*
 667 * Word 9
 668 */
 669static inline u32 msg_msgcnt(struct tipc_msg *m)
 670{
 671        return msg_bits(m, 9, 16, 0xffff);
 672}
 673
 674static inline void msg_set_msgcnt(struct tipc_msg *m, u32 n)
 675{
 676        msg_set_bits(m, 9, 16, 0xffff, n);
 677}
 678
 679static inline u32 msg_bcast_tag(struct tipc_msg *m)
 680{
 681        return msg_bits(m, 9, 16, 0xffff);
 682}
 683
 684static inline void msg_set_bcast_tag(struct tipc_msg *m, u32 n)
 685{
 686        msg_set_bits(m, 9, 16, 0xffff, n);
 687}
 688
 689static inline u32 msg_max_pkt(struct tipc_msg *m)
 690{
 691        return msg_bits(m, 9, 16, 0xffff) * 4;
 692}
 693
 694static inline void msg_set_max_pkt(struct tipc_msg *m, u32 n)
 695{
 696        msg_set_bits(m, 9, 16, 0xffff, (n / 4));
 697}
 698
 699static inline u32 msg_link_tolerance(struct tipc_msg *m)
 700{
 701        return msg_bits(m, 9, 0, 0xffff);
 702}
 703
 704static inline void msg_set_link_tolerance(struct tipc_msg *m, u32 n)
 705{
 706        msg_set_bits(m, 9, 0, 0xffff, n);
 707}
 708
 709u32 tipc_msg_tot_importance(struct tipc_msg *m);
 710void tipc_msg_init(struct tipc_msg *m, u32 user, u32 type, u32 hsize,
 711                   u32 destnode);
 712int tipc_msg_build(struct tipc_msg *hdr, struct iovec const *msg_sect,
 713                   unsigned int len, int max_size, struct sk_buff **buf);
 714#endif
 715