The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/netinet6/nd6.h

Version: -  FREEBSD  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-2  -  FREEBSD-11-1  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-4  -  FREEBSD-10-3  -  FREEBSD-10-2  -  FREEBSD-10-1  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-3  -  FREEBSD-9-2  -  FREEBSD-9-1  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-4  -  FREEBSD-8-3  -  FREEBSD-8-2  -  FREEBSD-8-1  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-4  -  FREEBSD-7-3  -  FREEBSD-7-2  -  FREEBSD-7-1  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-4  -  FREEBSD-6-3  -  FREEBSD-6-2  -  FREEBSD-6-1  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-5  -  FREEBSD-5-4  -  FREEBSD-5-3  -  FREEBSD-5-2  -  FREEBSD-5-1  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  linux-2.6  -  linux-2.4.22  -  MK83  -  MK84  -  PLAN9  -  DFBSD  -  NETBSD  -  NETBSD5  -  NETBSD4  -  NETBSD3  -  NETBSD20  -  OPENBSD  -  xnu-517  -  xnu-792  -  xnu-792.6.70  -  xnu-1228  -  xnu-1456.1.26  -  xnu-1699.24.8  -  xnu-2050.18.24  -  OPENSOLARIS  -  minix-3-1-1 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
    3  * All rights reserved.
    4  *
    5  * Redistribution and use in source and binary forms, with or without
    6  * modification, are permitted provided that the following conditions
    7  * are met:
    8  * 1. Redistributions of source code must retain the above copyright
    9  *    notice, this list of conditions and the following disclaimer.
   10  * 2. Redistributions in binary form must reproduce the above copyright
   11  *    notice, this list of conditions and the following disclaimer in the
   12  *    documentation and/or other materials provided with the distribution.
   13  * 3. Neither the name of the project nor the names of its contributors
   14  *    may be used to endorse or promote products derived from this software
   15  *    without specific prior written permission.
   16  *
   17  * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
   18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
   21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   27  * SUCH DAMAGE.
   28  *
   29  *      $KAME: nd6.h,v 1.76 2001/12/18 02:10:31 itojun Exp $
   30  * $FreeBSD$
   31  */
   32 
   33 #ifndef _NETINET6_ND6_H_
   34 #define _NETINET6_ND6_H_
   35 
   36 /* see net/route.h, or net/if_inarp.h */
   37 #ifndef RTF_ANNOUNCE
   38 #define RTF_ANNOUNCE    RTF_PROTO2
   39 #endif
   40 
   41 #include <sys/queue.h>
   42 #include <sys/callout.h>
   43 
   44 struct  llinfo_nd6 {
   45         struct  llinfo_nd6 *ln_next;
   46         struct  llinfo_nd6 *ln_prev;
   47         struct  rtentry *ln_rt;
   48         struct  mbuf *ln_hold;  /* last packet until resolved/timeout */
   49         long    ln_asked;       /* number of queries already sent for this addr */
   50         u_long  ln_expire;      /* lifetime for NDP state transition */
   51         short   ln_state;       /* reachability state */
   52         short   ln_router;      /* 2^0: ND6 router bit */
   53         int     ln_byhint;      /* # of times we made it reachable by UL hint */
   54 
   55         long    ln_ntick;
   56         struct callout ln_timer_ch;
   57 };
   58 
   59 #define ND6_LLINFO_NOSTATE      -2
   60 /*
   61  * We don't need the WAITDELETE state any more, but we keep the definition
   62  * in a comment line instead of removing it. This is necessary to avoid
   63  * unintentionally reusing the value for another purpose, which might
   64  * affect backward compatibility with old applications.
   65  * (20000711 jinmei@kame.net)
   66  */
   67 /* #define ND6_LLINFO_WAITDELETE        -1 */
   68 #define ND6_LLINFO_INCOMPLETE   0
   69 #define ND6_LLINFO_REACHABLE    1
   70 #define ND6_LLINFO_STALE        2
   71 #define ND6_LLINFO_DELAY        3
   72 #define ND6_LLINFO_PROBE        4
   73 
   74 #define ND6_IS_LLINFO_PROBREACH(n) ((n)->ln_state > ND6_LLINFO_INCOMPLETE)
   75 #define ND6_LLINFO_PERMANENT(n) (((n)->ln_expire == 0) && ((n)->ln_state > ND6_LLINFO_INCOMPLETE))
   76 
   77 struct nd_ifinfo {
   78         u_int32_t linkmtu;              /* LinkMTU */
   79         u_int32_t maxmtu;               /* Upper bound of LinkMTU */
   80         u_int32_t basereachable;        /* BaseReachableTime */
   81         u_int32_t reachable;            /* Reachable Time */
   82         u_int32_t retrans;              /* Retrans Timer */
   83         u_int32_t flags;                /* Flags */
   84         int recalctm;                   /* BaseReacable re-calculation timer */
   85         u_int8_t chlim;                 /* CurHopLimit */
   86         u_int8_t initialized; /* Flag to see the entry is initialized */
   87         /* the following 3 members are for privacy extension for addrconf */
   88         u_int8_t randomseed0[8]; /* upper 64 bits of MD5 digest */
   89         u_int8_t randomseed1[8]; /* lower 64 bits (usually the EUI64 IFID) */
   90         u_int8_t randomid[8];   /* current random ID */
   91 };
   92 
   93 #define ND6_IFF_PERFORMNUD      0x1
   94 #define ND6_IFF_ACCEPT_RTADV    0x2
   95 #define ND6_IFF_PREFER_SOURCE   0x4 /* XXX: not related to ND. */
   96 #define ND6_IFF_IFDISABLED      0x8 /* IPv6 operation is disabled due to
   97                                      * DAD failure.  (XXX: not ND-specific)
   98                                      */
   99 #define ND6_IFF_DONT_SET_IFROUTE        0x10
  100 
  101 #ifdef _KERNEL
  102 #define ND_IFINFO(ifp) \
  103         (((struct in6_ifextra *)(ifp)->if_afdata[AF_INET6])->nd_ifinfo)
  104 #define IN6_LINKMTU(ifp) \
  105         ((ND_IFINFO(ifp)->linkmtu && ND_IFINFO(ifp)->linkmtu < (ifp)->if_mtu) \
  106             ? ND_IFINFO(ifp)->linkmtu \
  107             : ((ND_IFINFO(ifp)->maxmtu && ND_IFINFO(ifp)->maxmtu < (ifp)->if_mtu) \
  108                 ? ND_IFINFO(ifp)->maxmtu : (ifp)->if_mtu))
  109 #endif
  110 
  111 struct in6_nbrinfo {
  112         char ifname[IFNAMSIZ];  /* if name, e.g. "en0" */
  113         struct in6_addr addr;   /* IPv6 address of the neighbor */
  114         long    asked;          /* number of queries already sent for this addr */
  115         int     isrouter;       /* if it acts as a router */
  116         int     state;          /* reachability state */
  117         int     expire;         /* lifetime for NDP state transition */
  118 };
  119 
  120 #define DRLSTSIZ 10
  121 #define PRLSTSIZ 10
  122 struct  in6_drlist {
  123         char ifname[IFNAMSIZ];
  124         struct {
  125                 struct  in6_addr rtaddr;
  126                 u_char  flags;
  127                 u_short rtlifetime;
  128                 u_long  expire;
  129                 u_short if_index;
  130         } defrouter[DRLSTSIZ];
  131 };
  132 
  133 struct  in6_defrouter {
  134         struct  sockaddr_in6 rtaddr;
  135         u_char  flags;
  136         u_short rtlifetime;
  137         u_long  expire;
  138         u_short if_index;
  139 };
  140 
  141 #ifdef _KERNEL
  142 struct  in6_oprlist {
  143         char ifname[IFNAMSIZ];
  144         struct {
  145                 struct  in6_addr prefix;
  146                 struct prf_ra raflags;
  147                 u_char  prefixlen;
  148                 u_char  origin;
  149                 u_long vltime;
  150                 u_long pltime;
  151                 u_long expire;
  152                 u_short if_index;
  153                 u_short advrtrs; /* number of advertisement routers */
  154                 struct  in6_addr advrtr[DRLSTSIZ]; /* XXX: explicit limit */
  155         } prefix[PRLSTSIZ];
  156 };
  157 #endif
  158 
  159 struct  in6_prlist {
  160         char ifname[IFNAMSIZ];
  161         struct {
  162                 struct  in6_addr prefix;
  163                 struct prf_ra raflags;
  164                 u_char  prefixlen;
  165                 u_char  origin;
  166                 u_int32_t vltime;
  167                 u_int32_t pltime;
  168                 time_t expire;
  169                 u_short if_index;
  170                 u_short advrtrs; /* number of advertisement routers */
  171                 struct  in6_addr advrtr[DRLSTSIZ]; /* XXX: explicit limit */
  172         } prefix[PRLSTSIZ];
  173 };
  174 
  175 struct in6_prefix {
  176         struct  sockaddr_in6 prefix;
  177         struct prf_ra raflags;
  178         u_char  prefixlen;
  179         u_char  origin;
  180         u_int32_t vltime;
  181         u_int32_t pltime;
  182         time_t expire;
  183         u_int32_t flags;
  184         int refcnt;
  185         u_short if_index;
  186         u_short advrtrs; /* number of advertisement routers */
  187         /* struct sockaddr_in6 advrtr[] */
  188 };
  189 
  190 #ifdef _KERNEL
  191 struct  in6_ondireq {
  192         char ifname[IFNAMSIZ];
  193         struct {
  194                 u_int32_t linkmtu;      /* LinkMTU */
  195                 u_int32_t maxmtu;       /* Upper bound of LinkMTU */
  196                 u_int32_t basereachable; /* BaseReachableTime */
  197                 u_int32_t reachable;    /* Reachable Time */
  198                 u_int32_t retrans;      /* Retrans Timer */
  199                 u_int32_t flags;        /* Flags */
  200                 int recalctm;           /* BaseReacable re-calculation timer */
  201                 u_int8_t chlim;         /* CurHopLimit */
  202                 u_int8_t receivedra;
  203         } ndi;
  204 };
  205 #endif
  206 
  207 struct  in6_ndireq {
  208         char ifname[IFNAMSIZ];
  209         struct nd_ifinfo ndi;
  210 };
  211 
  212 struct  in6_ndifreq {
  213         char ifname[IFNAMSIZ];
  214         u_long ifindex;
  215 };
  216 
  217 /* Prefix status */
  218 #define NDPRF_ONLINK            0x1
  219 #define NDPRF_DETACHED          0x2
  220 
  221 /* protocol constants */
  222 #define MAX_RTR_SOLICITATION_DELAY      1       /* 1sec */
  223 #define RTR_SOLICITATION_INTERVAL       4       /* 4sec */
  224 #define MAX_RTR_SOLICITATIONS           3
  225 
  226 #define ND6_INFINITE_LIFETIME           0xffffffff
  227 
  228 #ifdef _KERNEL
  229 /* node constants */
  230 #define MAX_REACHABLE_TIME              3600000 /* msec */
  231 #define REACHABLE_TIME                  30000   /* msec */
  232 #define RETRANS_TIMER                   1000    /* msec */
  233 #define MIN_RANDOM_FACTOR               512     /* 1024 * 0.5 */
  234 #define MAX_RANDOM_FACTOR               1536    /* 1024 * 1.5 */
  235 #define DEF_TEMP_VALID_LIFETIME         604800  /* 1 week */
  236 #define DEF_TEMP_PREFERRED_LIFETIME     86400   /* 1 day */
  237 #define TEMPADDR_REGEN_ADVANCE          5       /* sec */
  238 #define MAX_TEMP_DESYNC_FACTOR          600     /* 10 min */
  239 #define ND_COMPUTE_RTIME(x) \
  240                 (((MIN_RANDOM_FACTOR * (x >> 10)) + (arc4random() & \
  241                 ((MAX_RANDOM_FACTOR - MIN_RANDOM_FACTOR) * (x >> 10)))) /1000)
  242 
  243 TAILQ_HEAD(nd_drhead, nd_defrouter);
  244 struct  nd_defrouter {
  245         TAILQ_ENTRY(nd_defrouter) dr_entry;
  246         struct  in6_addr rtaddr;
  247         u_char  flags;          /* flags on RA message */
  248         u_short rtlifetime;
  249         u_long  expire;
  250         struct  ifnet *ifp;
  251         int     installed;      /* is installed into kernel routing table */
  252 };
  253 
  254 struct nd_prefixctl {
  255         struct ifnet *ndpr_ifp;
  256 
  257         /* prefix */
  258         struct sockaddr_in6 ndpr_prefix;
  259         u_char  ndpr_plen;
  260 
  261         u_int32_t ndpr_vltime;  /* advertised valid lifetime */
  262         u_int32_t ndpr_pltime;  /* advertised preferred lifetime */
  263 
  264         struct prf_ra ndpr_flags;
  265 };
  266 
  267 
  268 struct nd_prefix {
  269         struct ifnet *ndpr_ifp;
  270         LIST_ENTRY(nd_prefix) ndpr_entry;
  271         struct sockaddr_in6 ndpr_prefix;        /* prefix */
  272         struct in6_addr ndpr_mask; /* netmask derived from the prefix */
  273 
  274         u_int32_t ndpr_vltime;  /* advertised valid lifetime */
  275         u_int32_t ndpr_pltime;  /* advertised preferred lifetime */
  276 
  277         time_t ndpr_expire;     /* expiration time of the prefix */
  278         time_t ndpr_preferred;  /* preferred time of the prefix */
  279         time_t ndpr_lastupdate; /* reception time of last advertisement */
  280 
  281         struct prf_ra ndpr_flags;
  282         u_int32_t ndpr_stateflags; /* actual state flags */
  283         /* list of routers that advertise the prefix: */
  284         LIST_HEAD(pr_rtrhead, nd_pfxrouter) ndpr_advrtrs;
  285         u_char  ndpr_plen;
  286         int     ndpr_refcnt;    /* reference couter from addresses */
  287 };
  288 
  289 #define ndpr_next               ndpr_entry.le_next
  290 
  291 #define ndpr_raf                ndpr_flags
  292 #define ndpr_raf_onlink         ndpr_flags.onlink
  293 #define ndpr_raf_auto           ndpr_flags.autonomous
  294 #define ndpr_raf_router         ndpr_flags.router
  295 
  296 /*
  297  * Message format for use in obtaining information about prefixes
  298  * from inet6 sysctl function
  299  */
  300 struct inet6_ndpr_msghdr {
  301         u_short inpm_msglen;    /* to skip over non-understood messages */
  302         u_char  inpm_version;   /* future binary compatibility */
  303         u_char  inpm_type;      /* message type */
  304         struct in6_addr inpm_prefix;
  305         u_long  prm_vltim;
  306         u_long  prm_pltime;
  307         u_long  prm_expire;
  308         u_long  prm_preferred;
  309         struct in6_prflags prm_flags;
  310         u_short prm_index;      /* index for associated ifp */
  311         u_char  prm_plen;       /* length of prefix in bits */
  312 };
  313 
  314 #define prm_raf_onlink          prm_flags.prf_ra.onlink
  315 #define prm_raf_auto            prm_flags.prf_ra.autonomous
  316 
  317 #define prm_statef_onlink       prm_flags.prf_state.onlink
  318 
  319 #define prm_rrf_decrvalid       prm_flags.prf_rr.decrvalid
  320 #define prm_rrf_decrprefd       prm_flags.prf_rr.decrprefd
  321 
  322 struct nd_pfxrouter {
  323         LIST_ENTRY(nd_pfxrouter) pfr_entry;
  324 #define pfr_next pfr_entry.le_next
  325         struct nd_defrouter *router;
  326 };
  327 
  328 LIST_HEAD(nd_prhead, nd_prefix);
  329 
  330 /* nd6.c */
  331 extern int nd6_prune;
  332 extern int nd6_delay;
  333 extern int nd6_umaxtries;
  334 extern int nd6_mmaxtries;
  335 extern int nd6_useloopback;
  336 extern int nd6_maxnudhint;
  337 extern int nd6_gctimer;
  338 extern struct llinfo_nd6 llinfo_nd6;
  339 extern struct nd_drhead nd_defrouter;
  340 extern struct nd_prhead nd_prefix;
  341 extern int nd6_debug;
  342 extern int nd6_onlink_ns_rfc4861;
  343 
  344 #define nd6log(x)       do { if (nd6_debug) log x; } while (/*CONSTCOND*/ 0)
  345 
  346 extern struct callout nd6_timer_ch;
  347 
  348 /* nd6_rtr.c */
  349 extern int nd6_defifindex;
  350 extern int ip6_desync_factor;   /* seconds */
  351 extern u_int32_t ip6_temp_preferred_lifetime; /* seconds */
  352 extern u_int32_t ip6_temp_valid_lifetime; /* seconds */
  353 extern int ip6_temp_regen_advance; /* seconds */
  354 
  355 union nd_opts {
  356         struct nd_opt_hdr *nd_opt_array[8];     /* max = target address list */
  357         struct {
  358                 struct nd_opt_hdr *zero;
  359                 struct nd_opt_hdr *src_lladdr;
  360                 struct nd_opt_hdr *tgt_lladdr;
  361                 struct nd_opt_prefix_info *pi_beg; /* multiple opts, start */
  362                 struct nd_opt_rd_hdr *rh;
  363                 struct nd_opt_mtu *mtu;
  364                 struct nd_opt_hdr *search;      /* multiple opts */
  365                 struct nd_opt_hdr *last;        /* multiple opts */
  366                 int done;
  367                 struct nd_opt_prefix_info *pi_end;/* multiple opts, end */
  368         } nd_opt_each;
  369 };
  370 #define nd_opts_src_lladdr      nd_opt_each.src_lladdr
  371 #define nd_opts_tgt_lladdr      nd_opt_each.tgt_lladdr
  372 #define nd_opts_pi              nd_opt_each.pi_beg
  373 #define nd_opts_pi_end          nd_opt_each.pi_end
  374 #define nd_opts_rh              nd_opt_each.rh
  375 #define nd_opts_mtu             nd_opt_each.mtu
  376 #define nd_opts_search          nd_opt_each.search
  377 #define nd_opts_last            nd_opt_each.last
  378 #define nd_opts_done            nd_opt_each.done
  379 
  380 /* XXX: need nd6_var.h?? */
  381 /* nd6.c */
  382 void nd6_init __P((void));
  383 struct nd_ifinfo *nd6_ifattach __P((struct ifnet *));
  384 void nd6_ifdetach __P((struct nd_ifinfo *));
  385 int nd6_is_addr_neighbor __P((struct sockaddr_in6 *, struct ifnet *));
  386 void nd6_option_init __P((void *, int, union nd_opts *));
  387 struct nd_opt_hdr *nd6_option __P((union nd_opts *));
  388 int nd6_options __P((union nd_opts *));
  389 struct  rtentry *nd6_lookup __P((struct in6_addr *, int, struct ifnet *));
  390 void nd6_setmtu __P((struct ifnet *));
  391 void nd6_llinfo_settimer __P((struct llinfo_nd6 *, long));
  392 void nd6_timer __P((void *));
  393 void nd6_purge __P((struct ifnet *));
  394 void nd6_nud_hint __P((struct rtentry *, struct in6_addr *, int));
  395 int nd6_resolve __P((struct ifnet *, struct rtentry *, struct mbuf *,
  396         struct sockaddr *, u_char *));
  397 void nd6_rtrequest __P((int, struct rtentry *, struct rt_addrinfo *));
  398 int nd6_ioctl __P((u_long, caddr_t, struct ifnet *));
  399 struct rtentry *nd6_cache_lladdr __P((struct ifnet *, struct in6_addr *,
  400         char *, int, int, int));
  401 int nd6_output __P((struct ifnet *, struct ifnet *, struct mbuf *,
  402         struct sockaddr_in6 *, struct rtentry *));
  403 int nd6_need_cache __P((struct ifnet *));
  404 int nd6_storelladdr __P((struct ifnet *, struct rtentry *, struct mbuf *,
  405         struct sockaddr *, u_char *));
  406 
  407 /* nd6_nbr.c */
  408 void nd6_na_input __P((struct mbuf *, int, int));
  409 void nd6_na_output __P((struct ifnet *, const struct in6_addr *,
  410         const struct in6_addr *, u_long, int, struct sockaddr *));
  411 void nd6_ns_input __P((struct mbuf *, int, int));
  412 void nd6_ns_output __P((struct ifnet *, const struct in6_addr *,
  413         const struct in6_addr *, struct llinfo_nd6 *, int));
  414 caddr_t nd6_ifptomac __P((struct ifnet *));
  415 void nd6_dad_start __P((struct ifaddr *, int));
  416 void nd6_dad_stop __P((struct ifaddr *));
  417 void nd6_dad_duplicated __P((struct ifaddr *));
  418 
  419 /* nd6_rtr.c */
  420 void nd6_rs_input __P((struct mbuf *, int, int));
  421 void nd6_ra_input __P((struct mbuf *, int, int));
  422 void prelist_del __P((struct nd_prefix *));
  423 void defrouter_addreq __P((struct nd_defrouter *));
  424 void defrouter_reset __P((void));
  425 void defrouter_select __P((void));
  426 void defrtrlist_del __P((struct nd_defrouter *));
  427 void prelist_remove __P((struct nd_prefix *));
  428 int nd6_prelist_add __P((struct nd_prefixctl *, struct nd_defrouter *,
  429         struct nd_prefix **));
  430 int nd6_prefix_onlink __P((struct nd_prefix *));
  431 int nd6_prefix_offlink __P((struct nd_prefix *));
  432 void pfxlist_onlink_check __P((void));
  433 struct nd_defrouter *defrouter_lookup __P((struct in6_addr *, struct ifnet *));
  434 struct nd_prefix *nd6_prefix_lookup __P((struct nd_prefixctl *));
  435 void rt6_flush __P((struct in6_addr *, struct ifnet *));
  436 int nd6_setdefaultiface __P((int));
  437 int in6_tmpifadd __P((const struct in6_ifaddr *, int, int));
  438 
  439 #endif /* _KERNEL */
  440 
  441 #endif /* _NETINET6_ND6_H_ */

Cache object: 2762abb730e3f2929efbbb12026fbb7e


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.