draft-ietf-ipngwg-rfc2292bis-02.txt

bind-3.2.

2.2.  The icmp6_hdr Structure

   The ICMPv6 header is needed by numerous IPv6 applications including
   Ping, Traceroute, router discovery daemons, and neighbor discovery
   daemons.  The following structure is defined as a result of including
   <netinet/icmp6.h>.  Note that this is a new header.

       struct icmp6_hdr {
         uint8_t     icmp6_type;   /* type field */
         uint8_t     icmp6_code;   /* code field */
         uint16_t    icmp6_cksum;  /* checksum field */
         union {
           uint32_t  icmp6_un_data32[1]; /* type-specific field */
           uint16_t  icmp6_un_data16[2]; /* type-specific field */
           uint8_t   icmp6_un_data8[4];  /* type-specific field */
         } icmp6_dataun;
       };

       #define icmp6_data32    icmp6_dataun.icmp6_un_data32
       #define icmp6_data16    icmp6_dataun.icmp6_un_data16
       #define icmp6_data8     icmp6_dataun.icmp6_un_data8
       #define icmp6_pptr      icmp6_data32[0]  /* parameter prob */
       #define icmp6_mtu       icmp6_data32[0]  /* packet too big */
       #define icmp6_id        icmp6_data16[0]  /* echo request/reply */
       #define icmp6_seq       icmp6_data16[1]  /* echo request/reply */
       #define icmp6_maxdelay  icmp6_data16[0]  /* mcast group membership */



2.2.1.  ICMPv6 Type and Code Values

   In addition to a common structure for the ICMPv6 header, common
   definitions are required for the ICMPv6 type and code fields.  The
   following constants are also defined as a result of including
   <netinet/icmp6.h>.

       #define ICMP6_DST_UNREACH             1
       #define ICMP6_PACKET_TOO_BIG          2
       #define ICMP6_TIME_EXCEEDED           3



draft-ietf-ipngwg-2292bis-02.txt                               [Page 13]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


       #define ICMP6_PARAM_PROB              4

       #define ICMP6_INFOMSG_MASK  0x80    /* all informational messages */

       #define ICMP6_ECHO_REQUEST          128
       #define ICMP6_ECHO_REPLY            129

       #define ICMP6_DST_UNREACH_NOROUTE     0 /* no route to destination */
       #define ICMP6_DST_UNREACH_ADMIN       1 /* communication with */
                                               /* destination */
                                               /* admin. prohibited */
       #define ICMP6_DST_UNREACH_BEYONDSCOPE 2 /* beyond scope of source address */
       #define ICMP6_DST_UNREACH_ADDR        3 /* address unreachable */
       #define ICMP6_DST_UNREACH_NOPORT      4 /* bad port */

       #define ICMP6_TIME_EXCEED_TRANSIT     0 /* Hop Limit == 0 in transit */
       #define ICMP6_TIME_EXCEED_REASSEMBLY  1 /* Reassembly time out */

       #define ICMP6_PARAMPROB_HEADER        0 /* erroneous header field */
       #define ICMP6_PARAMPROB_NEXTHEADER    1 /* unrecognized Next Header */
       #define ICMP6_PARAMPROB_OPTION        2 /* unrecognized IPv6 option */

   The five ICMP message types defined by IPv6 neighbor discovery (133-
   137) are defined in the next section.


2.2.2.  ICMPv6 Neighbor Discovery Definitions

   The following structures and definitions are defined as a result of
   including <netinet/icmp6.h>.

       #define ND_ROUTER_SOLICIT           133
       #define ND_ROUTER_ADVERT            134
       #define ND_NEIGHBOR_SOLICIT         135
       #define ND_NEIGHBOR_ADVERT          136
       #define ND_REDIRECT                 137

       struct nd_router_solicit {     /* router solicitation */
         struct icmp6_hdr  nd_rs_hdr;
           /* could be followed by options */
       };

       #define nd_rs_type               nd_rs_hdr.icmp6_type
       #define nd_rs_code               nd_rs_hdr.icmp6_code
       #define nd_rs_cksum              nd_rs_hdr.icmp6_cksum
       #define nd_rs_reserved           nd_rs_hdr.icmp6_data32[0]

       struct nd_router_advert {      /* router advertisement */



draft-ietf-ipngwg-2292bis-02.txt                               [Page 14]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


         struct icmp6_hdr  nd_ra_hdr;
         uint32_t   nd_ra_reachable;   /* reachable time */
         uint32_t   nd_ra_retransmit;  /* retransmit timer */
           /* could be followed by options */
       };

       #define nd_ra_type               nd_ra_hdr.icmp6_type
       #define nd_ra_code               nd_ra_hdr.icmp6_code
       #define nd_ra_cksum              nd_ra_hdr.icmp6_cksum
       #define nd_ra_curhoplimit        nd_ra_hdr.icmp6_data8[0]
       #define nd_ra_flags_reserved     nd_ra_hdr.icmp6_data8[1]
       #define ND_RA_FLAG_MANAGED       0x80
       #define ND_RA_FLAG_OTHER         0x40
       #define ND_RA_FLAG_HOME_AGENT    0x20
       #define nd_ra_router_lifetime    nd_ra_hdr.icmp6_data16[1]

       struct nd_neighbor_solicit {   /* neighbor solicitation */
         struct icmp6_hdr  nd_ns_hdr;
         struct in6_addr   nd_ns_target; /* target address */
           /* could be followed by options */
       };

       #define nd_ns_type               nd_ns_hdr.icmp6_type
       #define nd_ns_code               nd_ns_hdr.icmp6_code
       #define nd_ns_cksum              nd_ns_hdr.icmp6_cksum
       #define nd_ns_reserved           nd_ns_hdr.icmp6_data32[0]

       struct nd_neighbor_advert {    /* neighbor advertisement */
         struct icmp6_hdr  nd_na_hdr;
         struct in6_addr   nd_na_target; /* target address */
           /* could be followed by options */
       };

       #define nd_na_type               nd_na_hdr.icmp6_type
       #define nd_na_code               nd_na_hdr.icmp6_code
       #define nd_na_cksum              nd_na_hdr.icmp6_cksum
       #define nd_na_flags_reserved     nd_na_hdr.icmp6_data32[0]
       #if     BYTE_ORDER == BIG_ENDIAN
       #define ND_NA_FLAG_ROUTER        0x80000000
       #define ND_NA_FLAG_SOLICITED     0x40000000
       #define ND_NA_FLAG_OVERRIDE      0x20000000
       #else   /* BYTE_ORDER == LITTLE_ENDIAN */
       #define ND_NA_FLAG_ROUTER        0x00000080
       #define ND_NA_FLAG_SOLICITED     0x00000040
       #define ND_NA_FLAG_OVERRIDE      0x00000020
       #endif

       struct nd_redirect {           /* redirect */



draft-ietf-ipngwg-2292bis-02.txt                               [Page 15]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


         struct icmp6_hdr  nd_rd_hdr;
         struct in6_addr   nd_rd_target; /* target address */
         struct in6_addr   nd_rd_dst;    /* destination address */
           /* could be followed by options */
       };

       #define nd_rd_type               nd_rd_hdr.icmp6_type
       #define nd_rd_code               nd_rd_hdr.icmp6_code
       #define nd_rd_cksum              nd_rd_hdr.icmp6_cksum
       #define nd_rd_reserved           nd_rd_hdr.icmp6_data32[0]

       struct nd_opt_hdr {            /* Neighbor discovery option header */
         uint8_t  nd_opt_type;
         uint8_t  nd_opt_len;        /* in units of 8 octets */
           /* followed by option specific data */
       };

       #define  ND_OPT_SOURCE_LINKADDR       1
       #define  ND_OPT_TARGET_LINKADDR       2
       #define  ND_OPT_PREFIX_INFORMATION    3
       #define  ND_OPT_REDIRECTED_HEADER     4
       #define  ND_OPT_MTU                   5
       #define  ND_OPT_ADVINTERVAL           7
       #define  ND_OPT_HOMEAGENT_INFO        8

       struct nd_opt_prefix_info {    /* prefix information */
         uint8_t   nd_opt_pi_type;
         uint8_t   nd_opt_pi_len;
         uint8_t   nd_opt_pi_prefix_len;
         uint8_t   nd_opt_pi_flags_reserved;
         uint32_t  nd_opt_pi_valid_time;
         uint32_t  nd_opt_pi_preferred_time;
         uint32_t  nd_opt_pi_reserved2;
         /* XXX uint8_t  nd_opt_pi_reserved2[3]; */
         /* XXX uint8_t  nd_opt_pi_sitelen; */
         struct in6_addr  nd_opt_pi_prefix;
       };

       #define ND_OPT_PI_FLAG_ONLINK        0x80
       #define ND_OPT_PI_FLAG_AUTO          0x40
       #define ND_OPT_PI_FLAG_ROUTER        0x20    /* Added my Mobile IPv6 */
       #define ND_OPT_PI_FLAG_SITEPREF      0x10    /* XXX sitelen is valid */

       struct nd_opt_rd_hdr {         /* redirected header */
         uint8_t   nd_opt_rh_type;
         uint8_t   nd_opt_rh_len;
         uint16_t  nd_opt_rh_reserved1;
         uint32_t  nd_opt_rh_reserved2;



draft-ietf-ipngwg-2292bis-02.txt                               [Page 16]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


           /* followed by IP header and data */
       };

       struct nd_opt_mtu {            /* MTU option */
         uint8_t   nd_opt_mtu_type;
         uint8_t   nd_opt_mtu_len;
         uint16_t  nd_opt_mtu_reserved;
         uint32_t  nd_opt_mtu_mtu;
       };

       struct nd_opt_advinterval {    /* Advertisement Interval */
         uint8_t   nd_opt_adv_type;
         uint8_t   nd_opt_adv_len;
         uint16_t  nd_opt_adv_reserved;
         uint32_t  nd_opt_adv_interval; /* In milliseconds */
       };

       struct nd_opt_homeagent_info { /* Home Agent info */
         uint8_t   nd_opt_hai_type;
         uint8_t   nd_opt_hai_len;
         uint16_t  nd_opt_hai_reserved;
         int16_t  nd_opt_hai_preference;
         uint16_t  nd_opt_hai_lifetime;
       };

   We note that the nd_na_flags_reserved flags have the same byte
   ordering problems as we discussed with ip6f_offlg.


2.2.3.  Multicast Listener Discovery Definitions

   The following structures and definitions are defined as a result of
   including <netinet/icmp6.h>.

       #define MLD_LISTENER_QUERY          130
       #define MLD_LISTENER_REPORT         131
       #define MLD_LISTENER_REDUCTION      132

       struct mld_hdr {
         struct icmp6_hdr  mld_hdr;
         struct in6_addr   mld_addr; /* multicast address */
       };
       #define mld_type                 mld_hdr.icmp6_type
       #define mld_code                 mld_hdr.icmp6_code
       #define mld_cksum                mld_hdr.icmp6_cksum
       #define mld_maxdelay             mld_hdr.icmp6_data16[0]
       #define mld_reserved             mld_hdr.icmp6_data16[1]




draft-ietf-ipngwg-2292bis-02.txt                               [Page 17]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


2.2.4.  ICMPv6 Router Renumbering Definitions

   The following structures and definitions are defined as a result of
   including <netinet/icmp6.h>.

       #define ICMP6_ROUTER_RENUMBERING    138    /* router renumbering */

       struct icmp6_router_renum {  /* router renumbering header */
         struct icmp6_hdr  rr_hdr;
         u_int8_t          rr_segnum;
         u_int8_t          rr_flags;
         u_int16_t         rr_maxdelay;
         u_int32_t         rr_reserved;
       };
       #define rr_type                  rr_hdr.icmp6_type
       #define rr_code                  rr_hdr.icmp6_code
       #define rr_cksum                 rr_hdr.icmp6_cksum
       #define rr_seqnum                rr_hdr.icmp6_data32[0]

       /* Router renumbering flags */
       #define ICMP6_RR_FLAGS_TEST        0x80
       #define ICMP6_RR_FLAGS_REQRESULT   0x40
       #define ICMP6_RR_FLAGS_FORCEAPPLY  0x20
       #define ICMP6_RR_FLAGS_SPECSITE    0x10
       #define ICMP6_RR_FLAGS_PREVDONE    0x08


       struct rr_pco_match {    /* match prefix part */
         u_int8_t          rpm_code;
         u_int8_t          rpm_len;
         u_int8_t          rpm_ordinal;
         u_int8_t          rpm_matchlen;
         u_int8_t          rpm_minlen;
         u_int8_t          rpm_maxlen;
         u_int16_t         rpm_reserved;
         struct in6_addr   rpm_prefix;
       };

       /* PCO code values */
       #define RPM_PCO_ADD              1
       #define RPM_PCO_CHANGE           2
       #define RPM_PCO_SETGLOBAL        3

       struct rr_pco_use {    /* use prefix part */
         u_int8_t          rpu_uselen;
         u_int8_t          rpu_keeplen;
         u_int8_t          rpu_ramask;
         u_int8_t          rpu_raflags;



draft-ietf-ipngwg-2292bis-02.txt                               [Page 18]

INTERNET-DRAFT       Advanced Sockets API for IPv6          Nov. 7, 2000


         u_int32_t         rpu_vltime;
         u_int32_t         rpu_pltime;
         u_int32_t         rpu_flags;
         struct in6_addr   rpu_prefix;
       };
       #define ICMP6_RR_PCOUSE_RAFLAGS_ONLINK   0x20
       #define ICMP6_RR_PCOUSE_RAFLAGS_AUTO     0x10

       #if BYTE_ORDER == BIG_ENDIAN
       #define ICMP6_RR_PCOUSE_FLAGS_DECRVLTIME 0x80000000
       #define ICMP6_RR_PCOUSE_FLAGS_DECRPLTIME 0x40000000
       #elif BYTE_ORDER == LITTLE_ENDIAN