usr/src/head/protocols/routed.h

   1 /*
   2  * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
   3  * Use is subject to license terms.
   4  */
   5
   6 /*      Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T     */
   7 /*        All Rights Reserved   */
   8
   9 /*
  10  * Copyright (c) 1983, 1989, 1993
  11  *      The Regents of the University of California.  All rights reserved.
  12  *
  13  * Redistribution and use in source and binary forms, with or without
  14  * modification, are permitted provided that the following conditions
  15  * are met:
  16  * 1. Redistributions of source code must retain the above copyright
  17  *    notice, this list of conditions and the following disclaimer.
  18  * 2. Redistributions in binary form must reproduce the above copyright
  19  *    notice, this list of conditions and the following disclaimer in the
  20  *    documentation and/or other materials provided with the distribution.
  21  * 3. All advertising materials mentioning features or use of this software
  22  *    must display the following acknowledgment:
  23  *      This product includes software developed by the University of
  24  *      California, Berkeley and its contributors.
  25  * 4. Neither the name of the University nor the names of its contributors
  26  *    may be used to endorse or promote products derived from this software
  27  *    without specific prior written permission.
  28  *
  29  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  30  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  31  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  32  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  33  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  34  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  35  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  36  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  37  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  38  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  39  * SUCH DAMAGE.
  40  */
  41
  42 /*
  43  * Routing Information Protocol
  44  *
  45  * Derived from Xerox NS Routing Information Protocol
  46  * by changing 32-bit net numbers to sockaddr's and
  47  * padding stuff to 32-bit boundaries.
  48  */
  49
  50 #ifndef _PROTOCOLS_ROUTED_H
  51 #define _PROTOCOLS_ROUTED_H
  52
  53 #pragma ident   "%Z%%M% %I%     %E% SMI"
  54
  55 #ifdef  __cplusplus
  56 extern "C" {
  57 #endif
  58
  59 /* The RIPv2 protocol is described in RFC 2453 */
  60
  61 #define RIPv1           1
  62 #define RIPv2           2
  63 #ifndef RIPVERSION
  64 #define RIPVERSION      RIPv1
  65 #endif
  66
  67 #define RIP_PORT        520
  68
  69 #if RIPVERSION == RIPv1
  70 struct netinfo {
  71         struct  sockaddr rip_dst;       /* destination net/host */
  72         uint32_t   rip_metric;          /* cost of route */
  73 };
  74 #else
  75 struct netinfo {
  76         uint16_t   n_family;
  77 #define RIP_AF_INET     htons(AF_INET)
  78 #define     RIP_AF_UNSPEC   0
  79 #define     RIP_AF_AUTH     0xffff
  80         uint16_t   n_tag;               /* optional in RIPv2 */
  81         uint32_t   n_dst;               /* destination net or host */
  82 #define     RIP_DEFAULT     0
  83         uint32_t   n_mask;              /* netmask in RIPv2 */
  84         uint32_t   n_nhop;              /* optional next hop in RIPv2 */
  85         uint32_t   n_metric;            /* cost of route */
  86 };
  87 #endif /* RIPv1 */
  88
  89 /* RIPv2 authentication */
  90 struct netauth {
  91         uint16_t   a_family;            /* always RIP_AF_AUTH */
  92         uint16_t   a_type;
  93 #define RIP_AUTH_NONE           0
  94 #define RIP_AUTH_TRAILER        htons(1)        /* authentication data */
  95 #define RIP_AUTH_PW             htons(2)        /* password type */
  96 #define RIP_AUTH_MD5            htons(3)        /* Keyed MD5 */
  97         union {
  98 #define     RIP_AUTH_PW_LEN 16
  99             uint8_t    au_pw[RIP_AUTH_PW_LEN];
 100             struct a_md5 {
 101                 int16_t md5_pkt_len;    /* RIP-II packet length */
 102                 int8_t  md5_keyid;      /* key ID and auth data len */
 103                 int8_t  md5_auth_len;   /* 16 */
 104                 uint32_t md5_seqno;     /* sequence number */
 105                 uint32_t rsvd[2];       /* must be 0 */
 106 #define     RIP_AUTH_MD5_LEN RIP_AUTH_PW_LEN
 107             } a_md5;
 108         } au;
 109 };
 110
 111 struct rip_emetric {
 112         uint16_t        rip_metric;
 113         uint16_t        rip_mask;
 114         uint32_t        rip_token[1];
 115 };
 116
 117 struct rip_sec_entry {
 118         uint32_t        rip_dst;
 119         uint32_t        rip_count;
 120         struct rip_emetric rip_emetric[1];
 121 };
 122
 123 struct rip {
 124         uint8_t    rip_cmd;             /* request/response */
 125         uint8_t    rip_vers;            /* protocol version # */
 126         uint16_t   rip_res1;            /* pad to 32-bit boundary */
 127         union {                         /* variable length... */
 128             struct netinfo ru_nets[1];  /* variable length... */
 129             char    ru_tracefile[1];    /* ditto ... */
 130             struct netauth ru_auth[1];
 131             struct {
 132                 uint32_t rip_generation;
 133                 struct rip_sec_entry rip_sec_entry[1];
 134             } ru_tsol;
 135         } ripun;
 136 #define rip_nets        ripun.ru_nets
 137 #define rip_tracefile   ripun.ru_tracefile
 138 #define rip_auths       ripun.ru_auth
 139 #define rip_tsol        ripun.ru_tsol
 140 };
 141
 142 struct entryinfo {
 143         struct  sockaddr rtu_dst;
 144         struct  sockaddr rtu_router;
 145         short   rtu_flags;
 146         short   rtu_state;
 147         int     rtu_timer;
 148         int     rtu_metric;
 149         int     int_flags;
 150         char    int_name[16];
 151 };
 152
 153 typedef struct rdisc_info_s {
 154         uint_t  info_type;
 155         uint_t  info_version;
 156         uint_t  info_num_of_routers;
 157 } rdisc_info_t;
 158
 159 /*
 160  * Structure that is returned with the default router info.
 161  */
 162 typedef struct defr_s {
 163         uint32_t        defr_info_type;
 164         uint32_t        defr_version;
 165         struct in_addr  defr_addr;
 166         uint32_t        defr_index;
 167         uint32_t        defr_life;
 168         uint32_t        defr_pref;
 169 } defr_t;
 170
 171
 172 /*
 173  * Packet types.
 174  */
 175 #define RIPCMD_REQUEST          1       /* want info - from suppliers */
 176 #define RIPCMD_RESPONSE         2       /* responding to request */
 177 #define RIPCMD_TRACEON          3       /* turn tracing on */
 178 #define RIPCMD_TRACEOFF         4       /* turn it off */
 179
 180 /*
 181  * Gated extended RIP to include a "poll" command instead of using
 182  * RIPCMD_REQUEST with (RIP_AF_UNSPEC, RIP_DEFAULT).  RFC 1058 says
 183  * command 5 is used by Sun Microsystems for its own purposes.
 184  */
 185 #define RIPCMD_POLL             5       /* like request, but anyone answers */
 186 #define RIPCMD_POLLENTRY        6       /* like poll, but for entire entry */
 187
 188 #define RIPCMD_SEC_RESPONSE     51      /* response includes E-metrics */
 189 #define RIPCMD_SEC_T_RESPONSE   52      /* tunneling */
 190
 191 #define RIPCMD_MAX              7
 192
 193 #define RDISC_SNMP_SOCKET       "/var/run/in.rdisc_mib"
 194
 195 #define RDISC_SNMP_INFO_REQ             1
 196 #define RDISC_SNMP_INFO_RESPONSE        2
 197 #define RDISC_DEF_ROUTER_INFO           3
 198
 199 #define RDISC_SNMP_INFO_VER     1
 200 #define RDISC_DEF_ROUTER_VER    1
 201
 202 #define HOPCNT_INFINITY         16      /* per Xerox NS */
 203 #define MAXPACKETSIZE           512     /* max broadcast size */
 204 #define NETS_LEN ((MAXPACKETSIZE - sizeof (struct rip)) \
 205         / sizeof (struct netinfo) +1)
 206
 207 #define INADDR_RIP_GROUP 0xe0000009U    /* 224.0.0.9 */
 208
 209 /*
 210  * Timer values used in managing the routing table.
 211  *
 212  * Complete tables are broadcast every SUPPLY_INTERVAL seconds.
 213  * If changes occur between updates, dynamic updates containing only changes
 214  * may be sent.  When these are sent, a timer is set for a random value
 215  * between MIN_WAITTIME and MAX_WAITTIME, and no additional dynamic updates
 216  * are sent until the timer expires.
 217  *
 218  * Every update of a routing entry forces an entry's timer to be reset.
 219  * After EXPIRE_TIME without updates, the entry is marked invalid,
 220  * but held onto until GARBAGE_TIME so that others may see it, to
 221  * "poison" the bad route.
 222  */
 223 #define TIMER_RATE              30      /* alarm clocks every 30 seconds */
 224
 225 #define SUPPLY_INTERVAL         30      /* time to supply tables */
 226 #define MIN_WAITTIME            2       /* min sec until next flash updates */
 227 #define MAX_WAITTIME            5       /* max sec until flash update */
 228
 229 #define STALE_TIME              90      /* switch to a new gateway */
 230 #define EXPIRE_TIME             180     /* time to mark entry invalid */
 231 #define GARBAGE_TIME            300     /* time to garbage collect */
 232
 233 #ifdef  __cplusplus
 234 }
 235 #endif
 236
 237 #endif  /* _PROTOCOLS_ROUTED_H */