[src/trunk]: src/sys/net sync comment with latest kame

[itojun <itojun%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f820d61c6ccb
branches:  trunk
changeset: 503536:f820d61c6ccb
user:      itojun <itojun%NetBSD.org@localhost>
date:      Thu Feb 08 12:36:06 2001 +0000

description:
sync comment with latest kame

diffstat:

 sys/net/net_osdep.h |  47 ++++++++++++++++++++++++++++++++++++++---------
 1 files changed, 38 insertions(+), 9 deletions(-)

diffs (107 lines):

diff -r 94890c45c3d9 -r f820d61c6ccb sys/net/net_osdep.h
--- a/sys/net/net_osdep.h       Thu Feb 08 12:32:41 2001 +0000
+++ b/sys/net/net_osdep.h       Thu Feb 08 12:36:06 2001 +0000
@@ -1,5 +1,5 @@
-/*     $NetBSD: net_osdep.h,v 1.3 2000/08/19 08:15:53 itojun Exp $     */
-/*     $KAME: net_osdep.h,v 1.23 2000/08/19 00:58:11 itojun Exp $      */
+/*     $NetBSD: net_osdep.h,v 1.4 2001/02/08 12:36:06 itojun Exp $     */
+/*     $KAME: net_osdep.h,v 1.35 2001/02/06 01:33:03 itojun Exp $      */
 
 /*
  * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
@@ -36,16 +36,30 @@
 /*
  * OS dependencies:
  *
+ * - ifa_ifwithaf()
+ *   bsdi[34], netbsd, and openbsd define it in sys/net/if.c
+ *   freebsd (all versions) does not have it.
+ *  
  * - struct rt_addrinfo
- *   all *BSDs except bsdi4 only have two members; rti_addrs and rti_info[].
- *   bsdi4 has additional members; rti_flags, rti_ifa, rti_ifp, and rti_rtm.
+ *   bsdi4, netbsd 1.5R and beyond: rti_addrs, rti_info[], rti_flags, rti_ifa,
+ *     rti_ifp, and rti_rtm.
+ *   others: rti_addrs and rti_info[] only.
+ *
+ * - ifa->ifa_rtrequest
+ *   bsdi4, netbsd 1.5R and beyond: rt_addrinfo *
+ *   others: sockaddr * (note that sys/net/route.c:rtrequest() has an unsafe
+ *     typecast code, from 4.3BSD-reno)
  *
  * - side effects of rtrequest[1](RTM_DELETE)
  *     BSDI[34]: delete all cloned routes underneath the route.
  *     FreeBSD[234]: delete all protocol-cloned routes underneath the route.
  *                   note that cloned routes from an interface direct route
  *                   still remain.
- *     NetBSD, OpenBSD: no side effects.
+ *     NetBSD: official release versions (the latest is 1.5 as of Jan. 2001)
+ *             have no side effects.  KAME for NetBSD has the same effects
+ *             as of BSDI.
+ *     OpenBSD: no side effects.
+ *
  * - privileged process
  *     NetBSD, FreeBSD 3
  *             struct proc *p;
@@ -65,9 +79,9 @@
  *     OpenBSD, BSDI [34], FreeBSD 2
  *             do not need struct proc *
  * - bpf:
- *     OpenBSD, NetBSD, BSDI [34]
+ *     OpenBSD, NetBSD 1.5, BSDI [34]
  *             need caddr_t * (= if_bpf **) and struct ifnet *
- *     FreeBSD 2, FreeBSD 3
+ *     FreeBSD 2, FreeBSD 3, NetBSD 1.6? (1.5N and later)
  *             need only struct ifnet * as argument
  * - struct ifnet
  *                     use queue.h?    member names    if name
@@ -88,10 +102,12 @@
  *     FreeBSD 3
  *             non-mbuf manipulation using sooptcopy{in,out}()
  * - timeout() and untimeout()
- *     NetBSD, OpenBSD, BSDI [34], FreeBSD 2
+ *     NetBSD 1.4.x, OpenBSD, BSDI [34], FreeBSD 2
  *             timeout() is a void function
  *     FreeBSD 3
  *             timeout() is non-void, must keep returned value for untimeout()
+ *     NetBSD 1.5
+ *             timeout() is obsoleted, use callout_xx (sys/callout.h)
  * - sysctl
  *     NetBSD, OpenBSD
  *             foo_sysctl()
@@ -125,7 +141,8 @@
  * - struct ifnet for loopback interface
  *     BSDI3: struct ifnet loif;
  *     BSDI4: struct ifnet *loifp;
- *     NetBSD, OpenBSD, FreeBSD2: struct ifnet loif[NLOOP];
+ *     NetBSD, OpenBSD 2.8, FreeBSD2: struct ifnet loif[NLOOP];
+ *     OpenBSD 2.9: struct ifnet *lo0ifp;
  *
  *     odd thing is that many of them refers loif as ifnet *loif,
  *     not loif[NLOOP], from outside of if_loop.c.
@@ -145,6 +162,9 @@
  *     FreeBSD4: struct ipprotosw in netinet/ipprotosw.h
  *     others: struct protosw in sys/protosw.h
  *
+ * - protosw.  NetBSD 1.5 has extra member for ipfilter.  NetBSD 1.5 requires
+ *   PR_LISTEN flag bit with protocols that permit listen/accept (like tcp).
+ *
  * - header files with defopt (opt_xx.h)
  *     FreeBSD3: opt_{inet,ipsec,ip6fw,altq}.h
  *     FreeBSD4: opt_{inet,inet6,ipsec,ip6fw,altq}.h
@@ -157,6 +177,15 @@
  *
  * - (m->m_flags & M_EXT) != 0 does *not* mean that the max data length of
  *   the mbuf == MCLBYTES.
+ *
+ * - ifa_refcnt (struct ifaddr) management (IFAREF/IFAFREE).
+ *     NetBSD 1.5: always use IFAREF whenever reference gets added.
+ *             always use IFAFREE whenever reference gets freed.
+ *             IFAFREE frees ifaddr when ifa_refcnt reaches 0.
+ *     others: do not increase refcnt for ifp->if_addrlist and in_ifaddr.
+ *             use IFAFREE once when ifaddr is disconnected from
+ *             ifp->if_addrlist and in_ifaddr.  IFAFREE frees ifaddr when
+ *             ifa_refcnt goes negative.
  */
 
 #ifndef __NET_NET_OSDEP_H_DEFINED_