xnu-1699.22.81.tar.gz

[apple/xnu.git] / bsd / net / kpi_interface.h

diff --git a/bsd/net/kpi_interface.h b/bsd/net/kpi_interface.h
index 7e312fb751d75c75eb2597b48031ecd6ce20835c..e2fd084b63cf2ae9b3ddc403385ef4eae2ab4763 100644 (file)
--- a/bsd/net/kpi_interface.h
+++ b/bsd/net/kpi_interface.h
@@ -1,31 +1,29 @@
 /*
 /*

- * Copyright (c) 2006 Apple Computer, Inc. All Rights Reserved.
+ * Copyright (c) 2004-2011 Apple Inc. All rights reserved.
+ *
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_START@

  * 
  * 

- * @APPLE_LICENSE_OSREFERENCE_HEADER_START@
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. The rights granted to you under the License
+ * may not be used to create, or enable the creation or redistribution of,
+ * unlawful or unlicensed copies of an Apple operating system, or to
+ * circumvent, violate, or enable the circumvention or violation of, any
+ * terms of an Apple operating system software license agreement.

  * 
  * 

- * This file contains Original Code and/or Modifications of Original Code 
- * as defined in and that are subject to the Apple Public Source License 
- * Version 2.0 (the 'License'). You may not use this file except in 
- * compliance with the License.  The rights granted to you under the 
- * License may not be used to create, or enable the creation or 
- * redistribution of, unlawful or unlicensed copies of an Apple operating 
- * system, or to circumvent, violate, or enable the circumvention or 
- * violation of, any terms of an Apple operating system software license 
- * agreement.
- *
- * Please obtain a copy of the License at 
- * http://www.opensource.apple.com/apsl/ and read it before using this 
- * file.
- *
- * The Original Code and all software distributed under the License are 
- * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
- * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
- * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 
- * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
- * Please see the License for the specific language governing rights and 
+ * Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this file.
+ * 
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and

  * limitations under the License.
  * limitations under the License.

- *
- * @APPLE_LICENSE_OSREFERENCE_HEADER_END@
+ * 
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@

  */
 /*!
        @header kpi_interface.h
  */
 /*!
        @header kpi_interface.h


@@ -68,24 +66,26 @@ struct ifnet_demux_desc;
        @constant IFNET_FAMILY_STF A 6to4 interface.
        @constant IFNET_FAMILY_FIREWIRE An IEEE 1394 (firewire) interface.
        @constant IFNET_FAMILY_BOND A virtual bonded interface.
        @constant IFNET_FAMILY_STF A 6to4 interface.
        @constant IFNET_FAMILY_FIREWIRE An IEEE 1394 (firewire) interface.
        @constant IFNET_FAMILY_BOND A virtual bonded interface.

+       @constant IFNET_FAMILY_CELLULAR A cellular interface.

 */
 
 enum {
 */
 
 enum {

-               IFNET_FAMILY_ANY                = 0,
-               IFNET_FAMILY_LOOPBACK   = 1,
-               IFNET_FAMILY_ETHERNET   = 2,
-               IFNET_FAMILY_SLIP               = 3,
-               IFNET_FAMILY_TUN                = 4,
-               IFNET_FAMILY_VLAN               = 5,
-               IFNET_FAMILY_PPP                = 6,
-               IFNET_FAMILY_PVC                = 7,
-               IFNET_FAMILY_DISC               = 8,
-               IFNET_FAMILY_MDECAP             = 9,
-               IFNET_FAMILY_GIF                = 10,
-               IFNET_FAMILY_FAITH              = 11,
-               IFNET_FAMILY_STF                = 12,
-               IFNET_FAMILY_FIREWIRE   = 13,
-               IFNET_FAMILY_BOND               = 14
+       IFNET_FAMILY_ANY                = 0,
+       IFNET_FAMILY_LOOPBACK           = 1,
+       IFNET_FAMILY_ETHERNET           = 2,
+       IFNET_FAMILY_SLIP               = 3,
+       IFNET_FAMILY_TUN                = 4,
+       IFNET_FAMILY_VLAN               = 5,
+       IFNET_FAMILY_PPP                = 6,
+       IFNET_FAMILY_PVC                = 7,
+       IFNET_FAMILY_DISC               = 8,
+       IFNET_FAMILY_MDECAP             = 9,
+       IFNET_FAMILY_GIF                = 10,
+       IFNET_FAMILY_FAITH              = 11,
+       IFNET_FAMILY_STF                = 12,
+       IFNET_FAMILY_FIREWIRE           = 13,
+       IFNET_FAMILY_BOND               = 14,
+       IFNET_FAMILY_CELLULAR           = 15

 };
 /*!
        @typedef ifnet_family_t
 };
 /*!
        @typedef ifnet_family_t


@@ -93,6 +93,8 @@ enum {
 */
 typedef u_int32_t ifnet_family_t;
 
 */
 typedef u_int32_t ifnet_family_t;
 

+#ifndef BPF_TAP_MODE_T
+#define BPF_TAP_MODE_T

 /*!
        @enum BPF tap mode
        @abstract Constants defining interface families.
 /*!
        @enum BPF tap mode
        @abstract Constants defining interface families.


@@ -103,16 +105,17 @@ typedef u_int32_t ifnet_family_t;
 */
 
 enum {
 */
 
 enum {

-               BPF_MODE_DISABLED               = 0,
-               BPF_MODE_INPUT                  = 1,
-               BPF_MODE_OUTPUT                 = 2,
-               BPF_MODE_INPUT_OUTPUT   = 3
+       BPF_MODE_DISABLED               = 0,
+       BPF_MODE_INPUT                  = 1,
+       BPF_MODE_OUTPUT                 = 2,
+       BPF_MODE_INPUT_OUTPUT           = 3

 };
 /*!
        @typedef bpf_tap_mode
        @abstract Mode for tapping. BPF_MODE_DISABLED/BPF_MODE_INPUT_OUTPUT etc.
 */
 typedef u_int32_t bpf_tap_mode;
 };
 /*!
        @typedef bpf_tap_mode
        @abstract Mode for tapping. BPF_MODE_DISABLED/BPF_MODE_INPUT_OUTPUT etc.
 */
 typedef u_int32_t bpf_tap_mode;

+#endif /* !BPF_TAP_MODE_T */

 
 /*!
        @typedef protocol_family_t
 
 /*!
        @typedef protocol_family_t


@@ -128,21 +131,55 @@ typedef u_int32_t protocol_family_t;
        @constant IFNET_CSUM_UDP Hardware will calculate UDP checksums.
        @constant IFNET_CSUM_FRAGMENT Hardware will checksum IP fragments.
        @constant IFNET_IP_FRAGMENT Hardware will fragment IP packets.
        @constant IFNET_CSUM_UDP Hardware will calculate UDP checksums.
        @constant IFNET_CSUM_FRAGMENT Hardware will checksum IP fragments.
        @constant IFNET_IP_FRAGMENT Hardware will fragment IP packets.

+       @constant IFNET_CSUM_TCPIPV6 Hardware will calculate TCP IPv6 checksums.
+       @constant IFNET_CSUM_UDPIPV6 Hardware will calculate UDP IPv6 checksums.
+       @constant IFNET_IPV6_FRAGMENT Hardware will fragment IPv6 packets.

        @constant IFNET_VLAN_TAGGING Hardware will generate VLAN headers.
        @constant IFNET_VLAN_MTU Hardware supports VLAN MTU.
        @constant IFNET_VLAN_TAGGING Hardware will generate VLAN headers.
        @constant IFNET_VLAN_MTU Hardware supports VLAN MTU.

+       @constant IFNET_MULTIPAGES Driver is capable of handling packets
+               coming down from the network stack that reside in virtually,
+               but not in physically contiguous span of the external mbuf
+               clusters.  In this case, the data area of a packet in the
+               external mbuf cluster might cross one or more physical
+               pages that are disjoint, depending on the interface MTU
+               and the packet size.  Such a use of larger than system page
+               size clusters by the network stack is done for better system
+               efficiency.  Drivers that utilize the IOMbufNaturalMemoryCursor
+               with the getPhysicalSegmentsWithCoalesce interfaces and
+               enumerate the list of vectors should set this flag for
+               possible gain in performance during bulk data transfer.
+        @constant IFNET_TSO_IPV4 Hardware supports IPv4 TCP Segment Offloading.
+                If the Interface driver sets this flag, TCP will send larger frames (up to 64KB) as one
+                frame to the adapter which will perform the final packetization. The maximum TSO segment
+                supported by the interface can be set with "ifnet_set_tso_mtu". To retreive the real MTU
+                for the TCP connection the function "mbuf_get_tso_requested" is used by the driver. Note
+               that if TSO is active, all the packets will be flagged for TSO, not just large packets.
+        @constant IFNET_TSO_IPV6 Hardware supports IPv6 TCP Segment Offloading.
+                If the Interface driver sets this flag, TCP IPv6 will send larger frames (up to 64KB) as one
+                frame to the adapter which will perform the final packetization. The maximum TSO segment
+                supported by the interface can be set with "ifnet_set_tso_mtu". To retreive the real MTU
+                for the TCP IPv6 connection the function "mbuf_get_tso_requested" is used by the driver.
+               Note that if TSO is active, all the packets will be flagged for TSO, not just large packets.
+

 */
 
 enum {
 */
 
 enum {

-               IFNET_CSUM_IP           = 0x00000001,
-               IFNET_CSUM_TCP          = 0x00000002,
-               IFNET_CSUM_UDP          = 0x00000004,
-               IFNET_CSUM_FRAGMENT     = 0x00000008,
-               IFNET_IP_FRAGMENT       = 0x00000010,
+       IFNET_CSUM_IP           = 0x00000001,
+       IFNET_CSUM_TCP          = 0x00000002,
+       IFNET_CSUM_UDP          = 0x00000004,
+       IFNET_CSUM_FRAGMENT     = 0x00000008,
+       IFNET_IP_FRAGMENT       = 0x00000010,
+       IFNET_CSUM_TCPIPV6      = 0x00000020,
+       IFNET_CSUM_UDPIPV6      = 0x00000040,
+       IFNET_IPV6_FRAGMENT     = 0x00000080,

 #ifdef KERNEL_PRIVATE
 #ifdef KERNEL_PRIVATE

-               IFNET_CSUM_SUM16        = 0x00001000,
-#endif
-               IFNET_VLAN_TAGGING      = 0x00010000,
-               IFNET_VLAN_MTU          = 0x00020000,
+       IFNET_CSUM_SUM16        = 0x00001000,
+#endif /* KERNEL_PRIVATE */
+       IFNET_VLAN_TAGGING      = 0x00010000,
+       IFNET_VLAN_MTU          = 0x00020000,
+       IFNET_MULTIPAGES        = 0x00100000,
+       IFNET_TSO_IPV4          = 0x00200000,
+       IFNET_TSO_IPV6          = 0x00400000,

 };
 /*!
        @typedef ifnet_offload_t
 };
 /*!
        @typedef ifnet_offload_t


@@ -157,7 +194,7 @@ typedef u_int32_t ifnet_offload_t;
  */
 /*!
        @typedef bpf_packet_func
  */
 /*!
        @typedef bpf_packet_func

-       
+

        @discussion bpf_packet_func The bpf_packet_func is used to intercept
                inbound and outbound packets. The tap function will never free
                the mbuf. The tap function will only copy the mbuf in to various
        @discussion bpf_packet_func The bpf_packet_func is used to intercept
                inbound and outbound packets. The tap function will never free
                the mbuf. The tap function will only copy the mbuf in to various


@@ -171,7 +208,7 @@ typedef errno_t (*bpf_packet_func)(ifnet_t interface, mbuf_t data);
 
 /*!
        @typedef ifnet_output_func
 
 /*!
        @typedef ifnet_output_func

-       
+

        @discussion ifnet_output_func is used to transmit packets. The stack
                will pass fully formed packets, including frame header, to the
                ifnet_output function for an interface. The driver is
        @discussion ifnet_output_func is used to transmit packets. The stack
                will pass fully formed packets, including frame header, to the
                ifnet_output function for an interface. The driver is


@@ -186,26 +223,26 @@ typedef errno_t (*ifnet_output_func)(ifnet_t interface, mbuf_t data);
        @typedef ifnet_ioctl_func
        @discussion ifnet_ioctl_func is used to communicate ioctls from the
                stack to the driver.
        @typedef ifnet_ioctl_func
        @discussion ifnet_ioctl_func is used to communicate ioctls from the
                stack to the driver.

+
+               All undefined ioctls are reserved for future use by Apple. If
+               you need to communicate with your kext using an ioctl, please
+               use SIOCSIFKPI and SIOCGIFKPI.

        @param interface The interface the ioctl is being sent to.
        @param proto_family The protocol family to handle the ioctl, may be
                zero for no protocol_family.
        @param cmd The ioctl command.
        @param data A pointer to any data related to the ioctl.
  */
        @param interface The interface the ioctl is being sent to.
        @param proto_family The protocol family to handle the ioctl, may be
                zero for no protocol_family.
        @param cmd The ioctl command.
        @param data A pointer to any data related to the ioctl.
  */

-typedef errno_t (*ifnet_ioctl_func)(ifnet_t interface, u_int32_t cmd, void *data);
+typedef errno_t (*ifnet_ioctl_func)(ifnet_t interface, unsigned long cmd,
+    void *data);

 
 /*!
        @typedef ifnet_set_bpf_tap
 
 /*!
        @typedef ifnet_set_bpf_tap

-       @discussion ifnet_set_bpf_tap is used to set the bpf tap function to
-               be called when packets are sent and/or received.
-       @param interface The interface the bpf tap function is being set on.
-       @param mode Sets the mode of the tap to either disabled, input,
-               output, or input/output.
-       @param callback A function pointer to be called when a packet is
-               sent or received.
+       @discussion Deprecated. Specify NULL. Call bpf_tap_in/bpf_tap_out
+               for all packets.

  */
 typedef errno_t (*ifnet_set_bpf_tap)(ifnet_t interface, bpf_tap_mode mode,
  */
 typedef errno_t (*ifnet_set_bpf_tap)(ifnet_t interface, bpf_tap_mode mode,

-                               bpf_packet_func callback);
+    bpf_packet_func callback);

 
 /*!
        @typedef ifnet_detached_func
 
 /*!
        @typedef ifnet_detached_func


@@ -226,12 +263,13 @@ typedef void (*ifnet_detached_func)(ifnet_t interface);
 
 /*!
        @typedef ifnet_demux_func
 
 /*!
        @typedef ifnet_demux_func

-       @discussion ifnet_demux_func is called for each inbound packet to determine
-               which protocol family the packet belongs to. This information is then
-               used by the stack to determine which protocol to pass the packet to.
-               This function may return protocol families for protocols that are
-               not attached. If the protocol family has not been attached to the
-               interface, the packet will be discarded.
+       @discussion ifnet_demux_func is called for each inbound packet to
+               determine which protocol family the packet belongs to. This
+               information is then used by the stack to determine which
+               protocol to pass the packet to.  This function may return
+               protocol families for protocols that are not attached. If the
+               protocol family has not been attached to the interface, the
+               packet will be discarded.

        @param interface The interface the packet was received on.
        @param packet The mbuf containing the packet.
        @param frame_header A pointer to the frame header.
        @param interface The interface the packet was received on.
        @param packet The mbuf containing the packet.
        @param frame_header A pointer to the frame header.


@@ -239,12 +277,13 @@ typedef void (*ifnet_detached_func)(ifnet_t interface);
                packet should be stored here.
        @result
                If the result is zero, processing will continue normally.
                packet should be stored here.
        @result
                If the result is zero, processing will continue normally.

-               If the result is EJUSTRETURN, processing will stop but the packet will not be freed.
-               If the result is anything else, the processing will stop and the packet will be freed.
+               If the result is EJUSTRETURN, processing will stop but the
+                       packet will not be freed.
+               If the result is anything else, the processing will stop and
+                       the packet will be freed.

  */
 typedef errno_t (*ifnet_demux_func)(ifnet_t interface, mbuf_t packet,
  */
 typedef errno_t (*ifnet_demux_func)(ifnet_t interface, mbuf_t packet,

-                                                                       char *frame_header,
-                                                                       protocol_family_t *protocol_family);
+    char *frame_header, protocol_family_t *protocol_family);

 
 /*!
        @typedef ifnet_event_func
 
 /*!
        @typedef ifnet_event_func


@@ -273,13 +312,14 @@ typedef void (*ifnet_event_func)(ifnet_t interface, const struct kev_msg *msg);
                pre-output function.
        @result
                If the result is zero, processing will continue normally.
                pre-output function.
        @result
                If the result is zero, processing will continue normally.

-               If the result is EJUSTRETURN, processing will stop but the packet will not be freed.
-               If the result is anything else, the processing will stop and the packet will be freed.
+               If the result is EJUSTRETURN, processing will stop but the
+                       packet will not be freed.
+               If the result is anything else, the processing will stop and
+                       the packet will be freed.

  */
 typedef errno_t (*ifnet_framer_func)(ifnet_t interface, mbuf_t *packet,
  */
 typedef errno_t (*ifnet_framer_func)(ifnet_t interface, mbuf_t *packet,

-                                                                        const struct sockaddr *dest,
-                                                                        const char *desk_linkaddr,
-                                                                        const char *frame_type);
+    const struct sockaddr *dest, const char *desk_linkaddr,
+    const char *frame_type);

 
 /*!
        @typedef ifnet_add_proto_func
 
 /*!
        @typedef ifnet_add_proto_func


@@ -295,12 +335,12 @@ typedef errno_t (*ifnet_framer_func)(ifnet_t interface, mbuf_t *packet,
        @param demux_count The number of demux descriptors in the array.
        @result
                If the result is zero, processing will continue normally.
        @param demux_count The number of demux descriptors in the array.
        @result
                If the result is zero, processing will continue normally.

-               If the result is anything else, the add protocol will be aborted.
+               If the result is anything else, the add protocol will be
+                       aborted.

  */
 typedef errno_t (*ifnet_add_proto_func)(ifnet_t interface,
  */
 typedef errno_t (*ifnet_add_proto_func)(ifnet_t interface,

-                                                                               protocol_family_t protocol_family,
-                                                                               const struct ifnet_demux_desc *demux_array,
-                                                                               u_int32_t demux_count);
+    protocol_family_t protocol_family,
+    const struct ifnet_demux_desc *demux_array, u_int32_t demux_count);

 
 /*!
        @typedef if_del_proto_func
 
 /*!
        @typedef if_del_proto_func


@@ -316,7 +356,7 @@ typedef errno_t (*ifnet_add_proto_func)(ifnet_t interface,
                        and the error will be returned to the caller.
  */
 typedef errno_t (*ifnet_del_proto_func)(ifnet_t interface,
                        and the error will be returned to the caller.
  */
 typedef errno_t (*ifnet_del_proto_func)(ifnet_t interface,

-                                                                               protocol_family_t protocol_family);
+    protocol_family_t protocol_family);

 
 /*!
        @typedef ifnet_check_multi
 
 /*!
        @typedef ifnet_check_multi


@@ -324,7 +364,7 @@ typedef errno_t (*ifnet_del_proto_func)(ifnet_t interface,
                added to an interface. This gives the interface an opportunity
                to reject invalid multicast addresses before they are attached
                to the interface.
                added to an interface. This gives the interface an opportunity
                to reject invalid multicast addresses before they are attached
                to the interface.

-               
+

                To prevent an address from being added to your multicast list,
                return EADDRNOTAVAIL. If you don't know how to parse/translate
                the address, return EOPNOTSUPP.
                To prevent an address from being added to your multicast list,
                return EADDRNOTAVAIL. If you don't know how to parse/translate
                the address, return EOPNOTSUPP.


@@ -335,7 +375,7 @@ typedef errno_t (*ifnet_del_proto_func)(ifnet_t interface,
                EOPNOTSUPP for addresses the interface does not understand.
  */
 typedef errno_t (*ifnet_check_multi)(ifnet_t interface,
                EOPNOTSUPP for addresses the interface does not understand.
  */
 typedef errno_t (*ifnet_check_multi)(ifnet_t interface,

-                                                                        const struct sockaddr* mcast);
+    const struct sockaddr *mcast);

 
 /*!
        @typedef proto_media_input
 
 /*!
        @typedef proto_media_input


@@ -347,13 +387,34 @@ typedef errno_t (*ifnet_check_multi)(ifnet_t interface,
        @param packet The packet being input.
        @param header The frame header.
        @result
        @param packet The packet being input.
        @param header The frame header.
        @result

-               If the result is zero, the caller will assume the packet was passed
-               to the protocol.
-               If the result is non-zero and not EJUSTRETURN, the caller will free
-               the packet.
+               If the result is zero, the caller will assume the packet was
+                       passed to the protocol.
+               If the result is non-zero and not EJUSTRETURN, the caller will
+                       free the packet.

  */
 typedef errno_t (*proto_media_input)(ifnet_t ifp, protocol_family_t protocol,
  */
 typedef errno_t (*proto_media_input)(ifnet_t ifp, protocol_family_t protocol,

-                                                                        mbuf_t packet, char* header);
+    mbuf_t packet, char *header);
+
+/*!
+       @typedef proto_media_input_v2
+       @discussion proto_media_input_v2 is called for all inbound packets for
+               a specific protocol on a specific interface. This function is
+               registered on an interface using ifnet_attach_protocolv2.
+               proto_media_input_v2 differs from proto_media_input in that it
+               will be called for a list of packets instead of once for each
+               individual packet. The frame header can be retrieved using
+               mbuf_pkthdr_header.
+       @param ifp The interface the packet was received on.
+       @param protocol_family The protocol of the packet received.
+       @param packet The packet being input.
+       @result
+               If the result is zero, the caller will assume the packets were
+                       passed to the protocol.
+               If the result is non-zero and not EJUSTRETURN, the caller will
+                       free the packets.
+ */
+typedef errno_t (*proto_media_input_v2)(ifnet_t ifp, protocol_family_t protocol,
+    mbuf_t packet);

 
 /*!
        @typedef proto_media_preout
 
 /*!
        @typedef proto_media_preout


@@ -376,8 +437,8 @@ typedef errno_t (*proto_media_input)(ifnet_t ifp, protocol_family_t protocol,
                caller.
  */
 typedef errno_t (*proto_media_preout)(ifnet_t ifp, protocol_family_t protocol,
                caller.
  */
 typedef errno_t (*proto_media_preout)(ifnet_t ifp, protocol_family_t protocol,

-                                                                         mbuf_t *packet, const struct sockaddr *dest,
-                                                                         void *route, char *frame_type, char *link_layer_dest);
+    mbuf_t *packet, const struct sockaddr *dest, void *route, char *frame_type,
+    char *link_layer_dest);

 
 /*!
        @typedef proto_media_event
 
 /*!
        @typedef proto_media_event


@@ -388,7 +449,7 @@ typedef errno_t (*proto_media_preout)(ifnet_t ifp, protocol_family_t protocol,
        @param kev_msg The event.
  */
 typedef void (*proto_media_event)(ifnet_t ifp, protocol_family_t protocol,
        @param kev_msg The event.
  */
 typedef void (*proto_media_event)(ifnet_t ifp, protocol_family_t protocol,

-                                                                 const struct kev_msg *event);
+    const struct kev_msg *event);

 
 /*!
        @typedef proto_media_ioctl
 
 /*!
        @typedef proto_media_ioctl


@@ -400,6 +461,10 @@ typedef void (*proto_media_event)(ifnet_t ifp, protocol_family_t protocol,
                EOPNOTSUPP, other parts of the stack may not get an opportunity
                to process the ioctl. If you return EJUSTRETURN, processing will
                stop and a result of zero will be returned to the caller.
                EOPNOTSUPP, other parts of the stack may not get an opportunity
                to process the ioctl. If you return EJUSTRETURN, processing will
                stop and a result of zero will be returned to the caller.

+
+               All undefined ioctls are reserved for future use by Apple. If
+               you need to communicate with your kext using an ioctl, please
+               use SIOCSIFKPI and SIOCGIFKPI.

        @param ifp The interface.
        @param protocol_family The protocol family.
        @param command The ioctl command.
        @param ifp The interface.
        @param protocol_family The protocol family.
        @param command The ioctl command.


@@ -408,7 +473,7 @@ typedef void (*proto_media_event)(ifnet_t ifp, protocol_family_t protocol,
                See the discussion.
  */
 typedef errno_t (*proto_media_ioctl)(ifnet_t ifp, protocol_family_t protocol,
                See the discussion.
  */
 typedef errno_t (*proto_media_ioctl)(ifnet_t ifp, protocol_family_t protocol,

-                                                                        u_int32_t command, void* argument);
+    unsigned long command, void *argument);

 
 /*!
        @typedef proto_media_detached
 
 /*!
        @typedef proto_media_detached


@@ -421,7 +486,6 @@ typedef errno_t (*proto_media_ioctl)(ifnet_t ifp, protocol_family_t protocol,
  */
 typedef errno_t (*proto_media_detached)(ifnet_t ifp, protocol_family_t protocol);
 
  */
 typedef errno_t (*proto_media_detached)(ifnet_t ifp, protocol_family_t protocol);
 

-

 /*!
        @typedef proto_media_resolve_multi
        @discussion proto_media_resolve_multi is called to resolve a
 /*!
        @typedef proto_media_resolve_multi
        @discussion proto_media_resolve_multi is called to resolve a


@@ -434,8 +498,8 @@ typedef errno_t (*proto_media_detached)(ifnet_t ifp, protocol_family_t protocol)
        @result Return zero on success or an errno error value on failure.
  */
 typedef errno_t (*proto_media_resolve_multi)(ifnet_t ifp,
        @result Return zero on success or an errno error value on failure.
  */
 typedef errno_t (*proto_media_resolve_multi)(ifnet_t ifp,

-                                                                        const struct sockaddr *proto_addr,
-                                                                        struct sockaddr_dl *out_ll, size_t ll_len);
+    const struct sockaddr *proto_addr, struct sockaddr_dl *out_ll,
+    size_t ll_len);

 
 /*!
        @typedef proto_media_send_arp
 
 /*!
        @typedef proto_media_send_arp


@@ -463,12 +527,9 @@ typedef errno_t (*proto_media_resolve_multi)(ifnet_t ifp,
                NULL.
        @result Return zero on success or an errno error value on failure.
  */
                NULL.
        @result Return zero on success or an errno error value on failure.
  */

-typedef errno_t (*proto_media_send_arp)(ifnet_t ifp,
-                                       u_short arpop,
-                                       const struct sockaddr_dl* sender_hw,
-                                       const struct sockaddr* sender_proto,
-                                       const struct sockaddr_dl* target_hw,
-                                       const struct sockaddr* target_proto);
+typedef errno_t (*proto_media_send_arp)(ifnet_t ifp, u_short arpop,
+    const struct sockaddr_dl *sender_hw, const struct sockaddr *sender_proto,
+    const struct sockaddr_dl *target_hw, const struct sockaddr *target_proto);

 
 /*!
        @struct ifnet_stat_increment_param
 
 /*!
        @struct ifnet_stat_increment_param


@@ -483,16 +544,15 @@ typedef errno_t (*proto_media_send_arp)(ifnet_t ifp,
        @field collisions The number of collisions seen by this interface.
        @field dropped The number of packets dropped.
 */
        @field collisions The number of collisions seen by this interface.
        @field dropped The number of packets dropped.
 */

-

 struct ifnet_stat_increment_param {
        u_int32_t                               packets_in;
        u_int32_t                               bytes_in;
        u_int32_t                               errors_in;
 struct ifnet_stat_increment_param {
        u_int32_t                               packets_in;
        u_int32_t                               bytes_in;
        u_int32_t                               errors_in;

-       
+

        u_int32_t                               packets_out;
        u_int32_t                               bytes_out;
        u_int32_t                               errors_out;
        u_int32_t                               packets_out;
        u_int32_t                               bytes_out;
        u_int32_t                               errors_out;

-       
+

        u_int32_t                               collisions;
        u_int32_t                               dropped;
 };
        u_int32_t                               collisions;
        u_int32_t                               dropped;
 };


@@ -512,46 +572,50 @@ struct ifnet_stat_increment_param {
        @field type The interface type (see sys/if_types.h). Must be less
                than 256. For new types, use IFT_OTHER.
        @field output The output function for the interface. Every packet the
        @field type The interface type (see sys/if_types.h). Must be less
                than 256. For new types, use IFT_OTHER.
        @field output The output function for the interface. Every packet the

-               stack attempts to send through this interface will go out through
-               this function.
+               stack attempts to send through this interface will go out
+               through this function.

        @field demux The function used to determine the protocol family of an
                incoming packet.
        @field demux The function used to determine the protocol family of an
                incoming packet.

-       @field add_proto The function used to attach a protocol to this interface.
-       @field del_proto The function used to remove a protocol from this interface.
+       @field add_proto The function used to attach a protocol to this
+               interface.
+       @field del_proto The function used to remove a protocol from this
+               interface.

        @field framer The function used to frame outbound packets, may be NULL.
        @field framer The function used to frame outbound packets, may be NULL.

-       @field softc Driver specific storage. This value can be retrieved from the
-               ifnet using the ifnet_softc function.
+       @field softc Driver specific storage. This value can be retrieved from
+               the ifnet using the ifnet_softc function.

        @field ioctl The function used to handle ioctls.
        @field set_bpf_tap The function used to set the bpf_tap function.
        @field ioctl The function used to handle ioctls.
        @field set_bpf_tap The function used to set the bpf_tap function.

-       @field detach The function called to let the driver know the interface has been detached.
-       @field event The function to notify the interface of various interface specific kernel events.
-       @field broadcast_addr The link-layer broadcast address for this interface.
+       @field detach The function called to let the driver know the interface
+               has been detached.
+       @field event The function to notify the interface of various interface
+               specific kernel events.
+       @field broadcast_addr The link-layer broadcast address for this
+               interface.

        @field broadcast_len The length of the link-layer broadcast address.
 */
        @field broadcast_len The length of the link-layer broadcast address.
 */

-

 struct ifnet_init_params {
        /* used to match recycled interface */
 struct ifnet_init_params {
        /* used to match recycled interface */

-       const void*                             uniqueid;               /* optional */
-       u_int32_t                               uniqueid_len;   /* optional */
-       
+       const void              *uniqueid;              /* optional */
+       u_int32_t               uniqueid_len;           /* optional */
+

        /* used to fill out initial values for interface */
        /* used to fill out initial values for interface */

-       const char*                             name;                   /* required */
-       u_int32_t                               unit;                   /* required */
-       ifnet_family_t                  family;                 /* required */
-       u_int32_t                               type;                   /* required */
-       ifnet_output_func               output;                 /* required */
-       ifnet_demux_func                demux;                  /* required  */
+       const char              *name;                  /* required */
+       u_int32_t               unit;                   /* required */
+       ifnet_family_t          family;                 /* required */
+       u_int32_t               type;                   /* required */
+       ifnet_output_func       output;                 /* required */
+       ifnet_demux_func        demux;                  /* required  */

        ifnet_add_proto_func    add_proto;              /* required  */
        ifnet_del_proto_func    del_proto;              /* required  */
        ifnet_add_proto_func    add_proto;              /* required  */
        ifnet_del_proto_func    del_proto;              /* required  */

-       ifnet_check_multi               check_multi;    /* required for non point-to-point interfaces */
-       ifnet_framer_func               framer;                 /* optional */
-       void*                                   softc;                  /* optional */
-       ifnet_ioctl_func                ioctl;                  /* optional */
-       ifnet_set_bpf_tap               set_bpf_tap;    /* optional */
-       ifnet_detached_func             detach;                 /* optional */
-       ifnet_event_func                event;                  /* optional */
-       const void                              *broadcast_addr;/* required for non point-to-point interfaces */
-       u_int32_t                               broadcast_len;  /* required for non point-to-point interfaces */
+       ifnet_check_multi       check_multi;            /* required for non point-to-point interfaces */
+       ifnet_framer_func       framer;                 /* optional */
+       void                    *softc;                 /* optional */
+       ifnet_ioctl_func        ioctl;                  /* optional */
+       ifnet_set_bpf_tap       set_bpf_tap;            /* deprecated */
+       ifnet_detached_func     detach;                 /* optional */
+       ifnet_event_func        event;                  /* optional */
+       const void              *broadcast_addr;        /* required for non point-to-point interfaces */
+       u_int32_t               broadcast_len;          /* required for non point-to-point interfaces */

 };
 
 /*!
 };
 
 /*!


@@ -567,18 +631,17 @@ struct ifnet_init_params {
        @field collisions The number of collisions seen by this interface.
        @field dropped The number of packets dropped.
 */
        @field collisions The number of collisions seen by this interface.
        @field dropped The number of packets dropped.
 */

-

 struct ifnet_stats_param {
        u_int64_t       packets_in;
        u_int64_t       bytes_in;
        u_int64_t       multicasts_in;
        u_int64_t       errors_in;
 struct ifnet_stats_param {
        u_int64_t       packets_in;
        u_int64_t       bytes_in;
        u_int64_t       multicasts_in;
        u_int64_t       errors_in;

-       
+

        u_int64_t       packets_out;
        u_int64_t       bytes_out;
        u_int64_t       multicasts_out;
        u_int64_t       errors_out;
        u_int64_t       packets_out;
        u_int64_t       bytes_out;
        u_int64_t       multicasts_out;
        u_int64_t       errors_out;

-       
+

        u_int64_t       collisions;
        u_int64_t       dropped;
        u_int64_t       no_protocol;
        u_int64_t       collisions;
        u_int64_t       dropped;
        u_int64_t       no_protocol;


@@ -599,10 +662,9 @@ struct ifnet_stats_param {
        @field datalen The number of bytes of data used to describe the
                packet.
 */
        @field datalen The number of bytes of data used to describe the
                packet.
 */

-

 struct ifnet_demux_desc {
        u_int32_t       type;
 struct ifnet_demux_desc {
        u_int32_t       type;

-       void*           data;
+       void            *data;

        u_int32_t       datalen;
 };
 
        u_int32_t       datalen;
 };
 


@@ -626,13 +688,26 @@ struct ifnet_demux_desc {
 #endif /* KERNEL_PRIVATE */
 
 struct ifnet_attach_proto_param {
 #endif /* KERNEL_PRIVATE */
 
 struct ifnet_attach_proto_param {

-       struct ifnet_demux_desc *demux_array;   /* interface may/may not require */
-       u_int32_t                               demux_count;    /* interface may/may not require */
-       
-       proto_media_input                       input;          /* required */
-       proto_media_preout                      pre_output;     /* required */
-       proto_media_event                       event;          /* optional */
-       proto_media_ioctl                       ioctl;          /* optional */
+       struct ifnet_demux_desc         *demux_array;   /* interface may/may not require */
+       u_int32_t                       demux_count;    /* interface may/may not require */
+
+       proto_media_input               input;          /* required */
+       proto_media_preout              pre_output;     /* required */
+       proto_media_event               event;          /* optional */
+       proto_media_ioctl               ioctl;          /* optional */
+       proto_media_detached            detached;       /* optional */
+       proto_media_resolve_multi       resolve;        /* optional */
+       proto_media_send_arp            send_arp;       /* optional */
+};
+
+struct ifnet_attach_proto_param_v2 {
+       struct ifnet_demux_desc         *demux_array;   /* interface may/may not require */
+       u_int32_t                       demux_count;    /* interface may/may not require */
+
+       proto_media_input_v2            input;          /* required */
+       proto_media_preout              pre_output;     /* required */
+       proto_media_event               event;          /* optional */
+       proto_media_ioctl               ioctl;          /* optional */

        proto_media_detached            detached;       /* optional */
        proto_media_resolve_multi       resolve;        /* optional */
        proto_media_send_arp            send_arp;       /* optional */
        proto_media_detached            detached;       /* optional */
        proto_media_resolve_multi       resolve;        /* optional */
        proto_media_send_arp            send_arp;       /* optional */


@@ -666,7 +741,8 @@ __BEGIN_DECLS
                if an interface with the same uniqueid and family has already
                been allocated and is in use.
  */
                if an interface with the same uniqueid and family has already
                been allocated and is in use.
  */

-errno_t ifnet_allocate(const struct ifnet_init_params *init, ifnet_t *interface);
+extern errno_t ifnet_allocate(const struct ifnet_init_params *init,
+    ifnet_t *interface);

 
 /*!
        @function ifnet_reference
 
 /*!
        @function ifnet_reference


@@ -676,7 +752,7 @@ errno_t ifnet_allocate(const struct ifnet_init_params *init, ifnet_t *interface)
        @param interface The interface to increment the reference count of.
        @result May return EINVAL if the interface is not valid.
  */
        @param interface The interface to increment the reference count of.
        @result May return EINVAL if the interface is not valid.
  */

-errno_t ifnet_reference(ifnet_t interface);
+extern errno_t ifnet_reference(ifnet_t interface);

 
 /*!
        @function ifnet_release
 
 /*!
        @function ifnet_release


@@ -686,7 +762,7 @@ errno_t ifnet_reference(ifnet_t interface);
                and possibly free.
        @result May return EINVAL if the interface is not valid.
  */
                and possibly free.
        @result May return EINVAL if the interface is not valid.
  */

-errno_t ifnet_release(ifnet_t interface);
+extern errno_t ifnet_release(ifnet_t interface);

 
 /*!
        @function ifnet_attach
 
 /*!
        @function ifnet_attach


@@ -694,7 +770,7 @@ errno_t ifnet_release(ifnet_t interface);
                interface must be setup properly before calling attach. The
                stack will take a reference on the interface and hold it until
                ifnet_detach is called.
                interface must be setup properly before calling attach. The
                stack will take a reference on the interface and hold it until
                ifnet_detach is called.

-               
+

                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.


@@ -706,34 +782,54 @@ errno_t ifnet_release(ifnet_t interface);
        @result Will return an error if there is anything wrong with the
                interface.
  */
        @result Will return an error if there is anything wrong with the
                interface.
  */

-errno_t ifnet_attach(ifnet_t interface, const struct sockaddr_dl *ll_addr);
+extern errno_t ifnet_attach(ifnet_t interface,
+    const struct sockaddr_dl *ll_addr);

 
 /*!
        @function ifnet_detach
        @discussion Detaches the interface.
 
 /*!
        @function ifnet_detach
        @discussion Detaches the interface.

-               
+

                Call this to indicate this interface is no longer valid (i.e. PC
                Card was removed). This function will begin the process of
                removing knowledge of this interface from the stack.
                Call this to indicate this interface is no longer valid (i.e. PC
                Card was removed). This function will begin the process of
                removing knowledge of this interface from the stack.

-               
+

                The function will return before the interface is detached. The
                functions you supplied in to the interface may continue to be
                called. When the detach has been completed, your detached
                function will be called. Your kext must not unload until the
                detached function has been called. The interface will be
                properly freed when the reference count reaches zero.
                The function will return before the interface is detached. The
                functions you supplied in to the interface may continue to be
                called. When the detach has been completed, your detached
                function will be called. Your kext must not unload until the
                detached function has been called. The interface will be
                properly freed when the reference count reaches zero.

-               
+

                An interface may not be attached again. You must call
                ifnet_allocate to create a new interface to attach.
                An interface may not be attached again. You must call
                ifnet_allocate to create a new interface to attach.

-               
+

                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
        @param interface The interface to detach.
        @result 0 on success, otherwise errno error.
  */
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
        @param interface The interface to detach.
        @result 0 on success, otherwise errno error.
  */

-errno_t ifnet_detach(ifnet_t interface);
-
+extern errno_t ifnet_detach(ifnet_t interface);
+
+/*!
+       @function ifnet_interface_family_find
+       @discussion Look up the interface family identifier for a string. 
+               If there is no interface family identifier assigned for this string 
+               a new interface family identifier is created and assigned.
+               It is recommended to use the bundle id of the KEXT as the string 
+               to avoid collisions with other KEXTs.
+               The lookup operation is not optimized so a module should call this
+               function once during startup and cache the interface family identifier. 
+               The interface family identifier for a string will not be re-assigned until 
+               the system reboots.
+       @param module_string  A unique string identifying your interface family
+       @param family_id Upon return, a unique interface family identifier for use with
+               ifnet_* functions. This identifier is valid until the system
+               is rebooted.
+       @result 0 on success, otherwise errno error.
+*/
+extern errno_t ifnet_interface_family_find(const char *module_string, ifnet_family_t *family_id);
+       

 /*
  * Interface manipulation.
  */
 /*
  * Interface manipulation.
  */


@@ -744,7 +840,7 @@ errno_t ifnet_detach(ifnet_t interface);
        @param interface Interface to retrieve the storage from.
        @result Driver's private storage.
  */
        @param interface Interface to retrieve the storage from.
        @result Driver's private storage.
  */

-void* ifnet_softc(ifnet_t interface);
+extern void *ifnet_softc(ifnet_t interface);

 
 /*!
        @function ifnet_name
 
 /*!
        @function ifnet_name


@@ -752,15 +848,15 @@ void* ifnet_softc(ifnet_t interface);
        @param interface Interface to retrieve the name from.
        @result Pointer to the name.
  */
        @param interface Interface to retrieve the name from.
        @result Pointer to the name.
  */

-const char* ifnet_name(ifnet_t interface);
+extern const char *ifnet_name(ifnet_t interface);

 
 /*!
        @function ifnet_family
        @discussion Returns the family of the interface.
        @param interface Interface to retrieve the unit number from.
 
 /*!
        @function ifnet_family
        @discussion Returns the family of the interface.
        @param interface Interface to retrieve the unit number from.

-       @result Unit number.
+       @result Interface family type.

  */
  */

-ifnet_family_t ifnet_family(ifnet_t interface);
+extern ifnet_family_t ifnet_family(ifnet_t interface);

 
 /*!
        @function ifnet_unit
 
 /*!
        @function ifnet_unit


@@ -768,7 +864,7 @@ ifnet_family_t ifnet_family(ifnet_t interface);
        @param interface Interface to retrieve the unit number from.
        @result Unit number.
  */
        @param interface Interface to retrieve the unit number from.
        @result Unit number.
  */

-u_int32_t ifnet_unit(ifnet_t interface);
+extern u_int32_t ifnet_unit(ifnet_t interface);

 
 /*!
        @function ifnet_index
 
 /*!
        @function ifnet_index


@@ -780,7 +876,7 @@ u_int32_t ifnet_unit(ifnet_t interface);
        @param interface Interface to retrieve the index of.
        @result Index.
  */
        @param interface Interface to retrieve the index of.
        @result Index.
  */

-u_int32_t ifnet_index(ifnet_t interface);
+extern u_int32_t ifnet_index(ifnet_t interface);

 
 /*!
        @function ifnet_set_flags
 
 /*!
        @function ifnet_set_flags


@@ -794,7 +890,8 @@ u_int32_t ifnet_index(ifnet_t interface);
                flags are defined in net/if.h
        @result 0 on success otherwise the errno error.
  */
                flags are defined in net/if.h
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_set_flags(ifnet_t interface, u_int16_t new_flags, u_int16_t mask);
+extern errno_t ifnet_set_flags(ifnet_t interface, u_int16_t new_flags,
+    u_int16_t mask);

 
 /*!
        @function ifnet_flags
 
 /*!
        @function ifnet_flags


@@ -802,7 +899,7 @@ errno_t ifnet_set_flags(ifnet_t interface, u_int16_t new_flags, u_int16_t mask);
        @param interface Interface to retrieve the flags from.
        @result Flags. These flags are defined in net/if.h
  */
        @param interface Interface to retrieve the flags from.
        @result Flags. These flags are defined in net/if.h
  */

-u_int16_t ifnet_flags(ifnet_t interface);
+extern u_int16_t ifnet_flags(ifnet_t interface);

 
 
 #ifdef KERNEL_PRIVATE
 
 
 #ifdef KERNEL_PRIVATE


@@ -819,7 +916,8 @@ u_int16_t ifnet_flags(ifnet_t interface);
        @param mask The mask of flags to be modified.
        @result 0 on success otherwise the errno error.
  */
        @param mask The mask of flags to be modified.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_set_eflags(ifnet_t interface, u_int32_t new_flags, u_int32_t mask);
+extern errno_t ifnet_set_eflags(ifnet_t interface, u_int32_t new_flags,
+    u_int32_t mask);

 
 /*!
        @function ifnet_eflags
 
 /*!
        @function ifnet_eflags


@@ -827,8 +925,109 @@ errno_t ifnet_set_eflags(ifnet_t interface, u_int32_t new_flags, u_int32_t mask)
        @param interface Interface to retrieve the flags from.
        @result Extended flags. These flags are defined in net/if.h
  */
        @param interface Interface to retrieve the flags from.
        @result Extended flags. These flags are defined in net/if.h
  */

-u_int32_t ifnet_eflags(ifnet_t interface);
-#endif
+extern u_int32_t ifnet_eflags(ifnet_t interface);
+
+/*!
+       @function ifnet_set_idle_flags
+       @discussion Sets the if_idle_flags to new_flags. This function
+               lets you specify which flags you want to change using the
+               mask. The kernel will effectively take the lock, then set
+               the interface's idle flags to:
+                       (if_idle_flags & ~mask) | (new_flags & mask).
+               Setting the flags to any non-zero value will cause the
+               networking stack to aggressively purge expired objects,
+               such as route entries, etc.
+       @param interface The interface.
+       @param new_flags The new set of flags that should be set. These
+               flags are defined in net/if.h
+       @param mask The mask of flags to be modified.
+       @result 0 on success otherwise the errno error.  ENOTSUP is returned
+               when this call is made on non-supporting platforms.
+*/
+extern errno_t ifnet_set_idle_flags(ifnet_t interface, u_int32_t new_flags,
+    u_int32_t mask);
+
+/*!
+       @function ifnet_idle_flags
+       @discussion Returns the value of if_idle_flags.
+       @param interface Interface to retrieve the flags from.
+       @result if_idle_flags. These flags are defined in net/if.h
+*/
+extern u_int32_t ifnet_idle_flags(ifnet_t interface);
+
+#endif /* KERNEL_PRIVATE */
+
+/*!
+       @function ifnet_set_capabilities_supported
+       @discussion Specify the capabilities supported by the interface.
+       @discussion  This function lets you specify which capabilities are supported 
+               by the interface. Typically this function is called by the driver when 
+               the interface gets attached to the system.
+               The mask allows to control which capability to set or unset.
+               The kernel will effectively take the lock, then set the
+               interface's flags to (if_capabilities & ~mask) | (new_caps & mask).
+
+               This function is intended to be called by the driver. A kext
+               must not call this function on an interface the kext does not
+               own.
+       @param interface Interface to set the capabilities on.
+       @param new_caps The value of the capabilities that should be set or unset. These
+               flags are defined in net/if.h
+       @param mask Which capabilities that should be affected. These
+               flags are defined in net/if.h
+       @result 0 on success otherwise the errno error.
+ */
+extern errno_t ifnet_set_capabilities_supported(ifnet_t interface, u_int32_t new_caps,
+    u_int32_t mask);
+
+/*!
+       @function ifnet_capabilities_supported
+       @discussion Retrieve the interface capabilities supported by the interface.
+       @param interface Interface to retrieve the capabilities from.
+       @result Flags. Capabilities flags are defined in net/if.h
+ */
+extern u_int32_t ifnet_capabilities_supported(ifnet_t interface);
+
+/*!
+       @function ifnet_set_capabilities_enabled
+       @discussion Enable and/or disable the interface capabilities to match new_caps.
+       @discussion Sets the interface capabilities to new_caps. This function
+               lets you specify which capabilities you want to change using the mask.
+               The kernel will effectively take the lock, then set the
+               interface's flags to (if_capenable & ~mask) | (new_caps & mask).
+
+               This function is intended to be called by the driver. A kext
+               must not call this function on an interface the kext does not
+               own.
+               
+               Typically this function is called by the driver when the interface is 
+               created to specify which of the supported capabilities are enabled by 
+               default. This function is also meant to be called when the driver handles  
+               the interface ioctl SIOCSIFCAP.
+               
+               The driver should call ifnet_set_offlad() to indicate the corresponding  
+               hardware offload bits that will be used by the networking stack.
+               
+               It is an error to enable a capability that is not marked as 
+               supported by the interface.
+       @param interface Interface to set the capabilities on.
+       @param new_caps The value of the capabilities that should be set or unset. These
+               flags are defined in net/if.h
+       @param mask Which capabilities that should be affected. These
+               flags are defined in net/if.h
+       @result 0 on success otherwise the errno error.
+ */
+extern errno_t ifnet_set_capabilities_enabled(ifnet_t interface, u_int32_t new_caps,
+    u_int32_t mask);
+
+/*!
+       @function ifnet_capabilities_enabled
+       @discussion Retrieve the interface capabilities enabled on the interface.
+       @param interface Interface to retrieve the capabilities from.
+       @result Flags. Capabilities flags are defined in net/if.h
+ */
+extern u_int32_t ifnet_capabilities_enabled(ifnet_t interface);
+

 
 /*!
        @function ifnet_set_offload
 
 /*!
        @function ifnet_set_offload


@@ -836,13 +1035,17 @@ u_int32_t ifnet_eflags(ifnet_t interface);
                support provided by the interface such as hardware checksums and
                VLAN. This replaces the if_hwassist flags field. Any flags
                unrecognized by the stack will not be set.
                support provided by the interface such as hardware checksums and
                VLAN. This replaces the if_hwassist flags field. Any flags
                unrecognized by the stack will not be set.

+
+               Note the system will automatically set the interface capabilities 
+               that correspond to the offload flags modified -- i.e. the driver 
+               does not have to call ifnet_set_capabilities_enabled() and 
+               ifnet_set_capabilities_supported().

        @param interface The interface.
        @param offload The new set of flags indicating which offload options
                the device supports.
        @param interface The interface.
        @param offload The new set of flags indicating which offload options
                the device supports.

-       @param mask The mask of flags to be modified.

        @result 0 on success otherwise the errno error.
  */
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_set_offload(ifnet_t interface, ifnet_offload_t offload);
+extern errno_t ifnet_set_offload(ifnet_t interface, ifnet_offload_t offload);

 
 /*!
        @function ifnet_offload
 
 /*!
        @function ifnet_offload


@@ -851,7 +1054,62 @@ errno_t ifnet_set_offload(ifnet_t interface, ifnet_offload_t offload);
        @param interface Interface to retrieve the offload from.
        @result Abilities flags, see ifnet_offload_t.
  */
        @param interface Interface to retrieve the offload from.
        @result Abilities flags, see ifnet_offload_t.
  */

-ifnet_offload_t ifnet_offload(ifnet_t interface);
+extern ifnet_offload_t ifnet_offload(ifnet_t interface);
+
+/*!
+       @function ifnet_set_tso_mtu
+       @discussion Sets maximum TCP Segmentation Offload segment size for
+               the interface
+       @param interface The interface.
+       @param family The family for which the offload MTU is provided for
+               (AF_INET or AF_INET6)
+       @param mtuLen Maximum segment size supported by the interface
+       @result 0 on success otherwise the errno error.
+*/
+extern errno_t ifnet_set_tso_mtu(ifnet_t interface, sa_family_t family,
+    u_int32_t mtuLen);
+
+/*!
+       @function ifnet_get_tso_mtu
+       @discussion Returns maximum TCP Segmentation Offload segment size for
+               the interface
+       @param interface The interface.
+       @param family The family for which the offload MTU is provided for
+               (AF_INET or AF_INET6)
+       @param mtuLen Value of the maximum MTU supported for the interface
+               and family provided.
+       @result 0 on success otherwise the errno error.
+ */
+extern errno_t ifnet_get_tso_mtu(ifnet_t interface, sa_family_t family,
+    u_int32_t *mtuLen);
+
+/*!
+       @enum Interface wake properties
+       @abstract Constants defining Interface wake properties.
+       @constant IFNET_WAKE_ON_MAGIC_PACKET Wake on Magic Packet.
+*/
+enum {
+       IFNET_WAKE_ON_MAGIC_PACKET = 0x01
+};
+
+/*!
+       @function ifnet_set_wake_flags
+       @discussion Sets the wake properties of the underlying hardware. These are 
+               typically set by the driver.
+       @param interface The interface.
+       @param properties Properties to set or unset.
+       @param mask Mask of the properties to set of unset.
+       @result 0 on success otherwise the errno error.
+*/
+extern errno_t ifnet_set_wake_flags(ifnet_t interface, u_int32_t properties, u_int32_t mask);
+
+/*!
+       @function ifnet_get_wake_flags
+       @discussion Returns the wake properties set on the interface.
+       @param interface The interface.
+       @result The wake properties
+*/
+extern u_int32_t ifnet_get_wake_flags(ifnet_t interface);

 
 /*!
        @function ifnet_set_link_mib_data
 
 /*!
        @function ifnet_set_link_mib_data


@@ -860,7 +1118,7 @@ ifnet_offload_t ifnet_offload(ifnet_t interface);
                whenever the sysctl for getting interface specific MIB data is
                used. Since the ifnet_t stores a pointer to your data instead of
                a copy, you may update the data at the address at any time.
                whenever the sysctl for getting interface specific MIB data is
                used. Since the ifnet_t stores a pointer to your data instead of
                a copy, you may update the data at the address at any time.

-               
+

                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.


@@ -868,8 +1126,9 @@ ifnet_offload_t ifnet_offload(ifnet_t interface);
        @param mibData A pointer to the data.
        @param mibLen Length of data pointed to.
        @result 0 on success otherwise the errno error.
        @param mibData A pointer to the data.
        @param mibLen Length of data pointed to.
        @result 0 on success otherwise the errno error.

- */
-errno_t ifnet_set_link_mib_data(ifnet_t interface, void *mibData, u_int32_t mibLen);
+*/
+extern errno_t ifnet_set_link_mib_data(ifnet_t interface, void *mibData,
+    u_int32_t mibLen);

 
 /*!
        @function ifnet_get_link_mib_data
 
 /*!
        @function ifnet_get_link_mib_data


@@ -885,7 +1144,8 @@ errno_t ifnet_set_link_mib_data(ifnet_t interface, void *mibData, u_int32_t mibL
        @result Returns an error if the buffer size is too small or there is
                no data.
  */
        @result Returns an error if the buffer size is too small or there is
                no data.
  */

-errno_t ifnet_get_link_mib_data(ifnet_t interface, void *mibData, u_int32_t *mibLen);
+extern errno_t ifnet_get_link_mib_data(ifnet_t interface, void *mibData,
+    u_int32_t *mibLen);

 
 /*!
        @function ifnet_get_link_mib_data_length
 
 /*!
        @function ifnet_get_link_mib_data_length


@@ -894,7 +1154,7 @@ errno_t ifnet_get_link_mib_data(ifnet_t interface, void *mibData, u_int32_t *mib
        @result Returns the number of bytes of mib data associated with the
                interface.
  */
        @result Returns the number of bytes of mib data associated with the
                interface.
  */

-u_int32_t ifnet_get_link_mib_data_length(ifnet_t interface);
+extern u_int32_t ifnet_get_link_mib_data_length(ifnet_t interface);

 
 /*!
        @function ifnet_attach_protocol
 
 /*!
        @function ifnet_attach_protocol


@@ -905,8 +1165,24 @@ u_int32_t ifnet_get_link_mib_data_length(ifnet_t interface);
        @param proto_details Details of the protocol being attached.
        @result 0 on success otherwise the errno error.
  */
        @param proto_details Details of the protocol being attached.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_attach_protocol(ifnet_t interface, protocol_family_t protocol_family,
-                       const struct ifnet_attach_proto_param *proto_details);
+extern errno_t ifnet_attach_protocol(ifnet_t interface,
+    protocol_family_t protocol_family,
+    const struct ifnet_attach_proto_param *proto_details);
+
+/*!
+       @function ifnet_attach_protocol_v2
+       @discussion Attaches a protocol to an interface using the newer
+           version 2 style interface. So far the only difference is support
+           for packet chains which improve performance.
+       @param interface The interface.
+       @param protocol_family The protocol family being attached
+               (PF_INET/PF_APPLETALK/etc...).
+       @param proto_details Details of the protocol being attached.
+       @result 0 on success otherwise the errno error.
+ */
+extern errno_t ifnet_attach_protocol_v2(ifnet_t interface,
+    protocol_family_t protocol_family,
+    const struct ifnet_attach_proto_param_v2 *proto_details);

 
 /*!
        @function ifnet_detach_protocol
 
 /*!
        @function ifnet_detach_protocol


@@ -916,7 +1192,8 @@ errno_t ifnet_attach_protocol(ifnet_t interface, protocol_family_t protocol_fami
                detach.
        @result 0 on success otherwise the errno error.
  */
                detach.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_detach_protocol(ifnet_t interface, protocol_family_t protocol_family);
+extern errno_t ifnet_detach_protocol(ifnet_t interface,
+    protocol_family_t protocol_family);

 
 /*!
        @function ifnet_output
 
 /*!
        @function ifnet_output


@@ -927,8 +1204,7 @@ errno_t ifnet_detach_protocol(ifnet_t interface, protocol_family_t protocol_fami
                determine which preoutput function to call. The route and dest
                parameters will be passed to the preoutput function defined for
                the attachment of the specified protocol to the specified
                determine which preoutput function to call. The route and dest
                parameters will be passed to the preoutput function defined for
                the attachment of the specified protocol to the specified

-               interface. ifnet_output will free the mbuf chain in the event of
-               an error.
+               interface. ifnet_output will always free the mbuf chain.

        @param interface The interface.
        @param protocol_family The family of the protocol generating this
                packet (i.e. AF_INET).
        @param interface The interface.
        @param protocol_family The family of the protocol generating this
                packet (i.e. AF_INET).


@@ -941,8 +1217,9 @@ errno_t ifnet_detach_protocol(ifnet_t interface, protocol_family_t protocol_fami
                function does not require this value, you may pass NULL.
        @result 0 on success otherwise the errno error.
  */
                function does not require this value, you may pass NULL.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_output(ifnet_t interface, protocol_family_t protocol_family, mbuf_t packet,
-                                       void* route, const struct sockaddr *dest);
+extern errno_t ifnet_output(ifnet_t interface,
+    protocol_family_t protocol_family, mbuf_t packet, void *route,
+    const struct sockaddr *dest);

 
 /*!
        @function ifnet_output_raw
 
 /*!
        @function ifnet_output_raw


@@ -954,15 +1231,15 @@ errno_t ifnet_output(ifnet_t interface, protocol_family_t protocol_family, mbuf_
                packet. Processing, such as calling the protocol preoutput and
                interface framer functions will be bypassed. The packet will
                pass through the filters and be sent on the interface as is.
                packet. Processing, such as calling the protocol preoutput and
                interface framer functions will be bypassed. The packet will
                pass through the filters and be sent on the interface as is.

-               ifnet_output_raw will free the packet chain in the event of an
-               error.
+               ifnet_output_raw will always free the packet chain.

        @param interface The interface.
        @param protocol_family The family of the protocol generating this
                packet (i.e. AF_INET).
        @param packet The fully formed packet to be transmitted.
        @result 0 on success otherwise the errno error.
  */
        @param interface The interface.
        @param protocol_family The family of the protocol generating this
                packet (i.e. AF_INET).
        @param packet The fully formed packet to be transmitted.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_output_raw(ifnet_t interface, protocol_family_t protocol_family, mbuf_t packet);
+extern errno_t ifnet_output_raw(ifnet_t interface,
+    protocol_family_t protocol_family, mbuf_t packet);

 
 /*!
        @function ifnet_input
 
 /*!
        @function ifnet_input


@@ -978,13 +1255,17 @@ errno_t ifnet_output_raw(ifnet_t interface, protocol_family_t protocol_family, m
                stats. This parameter may be NULL.
        @result 0 on success otherwise the errno error.
  */
                stats. This parameter may be NULL.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_input(ifnet_t interface, mbuf_t first_packet,
-                                       const struct ifnet_stat_increment_param *stats);
+extern errno_t ifnet_input(ifnet_t interface, mbuf_t first_packet,
+    const struct ifnet_stat_increment_param *stats);

 
 /*!
        @function ifnet_ioctl
        @discussion Calls the interface's ioctl function with the parameters
                passed.
 
 /*!
        @function ifnet_ioctl
        @discussion Calls the interface's ioctl function with the parameters
                passed.

+
+               All undefined ioctls are reserved for future use by Apple. If
+               you need to communicate with your kext using an ioctl, please
+               use SIOCSIFKPI and SIOCGIFKPI.

        @param interface The interface.
        @param protocol The protocol family of the protocol to send the
                ioctl to (may be zero). Some ioctls apply to a protocol while
        @param interface The interface.
        @param protocol The protocol family of the protocol to send the
                ioctl to (may be zero). Some ioctls apply to a protocol while


@@ -993,8 +1274,8 @@ errno_t ifnet_input(ifnet_t interface, mbuf_t first_packet,
        @param ioctl_arg Any parameters to the ioctl.
        @result 0 on success otherwise the errno error.
  */
        @param ioctl_arg Any parameters to the ioctl.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_ioctl(ifnet_t interface, protocol_family_t protocol,
-                                       u_int32_t ioctl_code, void *ioctl_arg);
+extern errno_t ifnet_ioctl(ifnet_t interface, protocol_family_t protocol,
+    unsigned long ioctl_code, void *ioctl_arg);

 
 /*!
        @function ifnet_event
 
 /*!
        @function ifnet_event


@@ -1004,14 +1285,14 @@ errno_t ifnet_ioctl(ifnet_t interface, protocol_family_t protocol,
                event.
        @result 0 on success otherwise the errno error.
  */
                event.
        @result 0 on success otherwise the errno error.
  */

-errno_t        ifnet_event(ifnet_t interface, struct kern_event_msg* event_ptr);
+extern errno_t ifnet_event(ifnet_t interface, struct kern_event_msg *event_ptr);

 
 /*!
        @function ifnet_set_mtu
        @discussion Sets the value of the MTU in the interface structure.
                Calling this function will not notify the driver that the MTU
                should be changed. Use the appropriate ioctl.
 
 /*!
        @function ifnet_set_mtu
        @discussion Sets the value of the MTU in the interface structure.
                Calling this function will not notify the driver that the MTU
                should be changed. Use the appropriate ioctl.

-               
+

                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.


@@ -1019,21 +1300,21 @@ errno_t ifnet_event(ifnet_t interface, struct kern_event_msg* event_ptr);
        @param mtu The new MTU.
        @result 0 on success otherwise the errno error.
  */
        @param mtu The new MTU.
        @result 0 on success otherwise the errno error.
  */

-errno_t        ifnet_set_mtu(ifnet_t interface, u_int32_t mtu);
+extern errno_t ifnet_set_mtu(ifnet_t interface, u_int32_t mtu);

 
 /*!
        @function ifnet_mtu
        @param interface The interface.
        @result The MTU.
  */
 
 /*!
        @function ifnet_mtu
        @param interface The interface.
        @result The MTU.
  */

-u_int32_t      ifnet_mtu(ifnet_t interface);
+extern u_int32_t ifnet_mtu(ifnet_t interface);

 
 /*!
        @function ifnet_type
        @param interface The interface.
        @result The type. See net/if_types.h.
  */
 
 /*!
        @function ifnet_type
        @param interface The interface.
        @result The type. See net/if_types.h.
  */

-u_int8_t       ifnet_type(ifnet_t interface);
+extern u_int8_t ifnet_type(ifnet_t interface);

 
 /*!
        @function ifnet_set_addrlen
 
 /*!
        @function ifnet_set_addrlen


@@ -1045,14 +1326,14 @@ u_int8_t        ifnet_type(ifnet_t interface);
        @param addrlen The new address length.
        @result 0 on success otherwise the errno error.
  */
        @param addrlen The new address length.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_addrlen(ifnet_t interface, u_int8_t addrlen);
+extern errno_t ifnet_set_addrlen(ifnet_t interface, u_int8_t addrlen);

 
 /*!
        @function ifnet_addrlen
        @param interface The interface.
        @result The address length.
  */
 
 /*!
        @function ifnet_addrlen
        @param interface The interface.
        @result The address length.
  */

-u_int8_t       ifnet_addrlen(ifnet_t interface);
+extern u_int8_t ifnet_addrlen(ifnet_t interface);

 
 /*!
        @function ifnet_set_hdrlen
 
 /*!
        @function ifnet_set_hdrlen


@@ -1064,14 +1345,14 @@ u_int8_t        ifnet_addrlen(ifnet_t interface);
        @param hdrlen The new header length.
        @result 0 on success otherwise the errno error.
  */
        @param hdrlen The new header length.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_hdrlen(ifnet_t interface, u_int8_t hdrlen);
+extern errno_t ifnet_set_hdrlen(ifnet_t interface, u_int8_t hdrlen);

 
 /*!
        @function ifnet_hdrlen
        @param interface The interface.
        @result The header length.
  */
 
 /*!
        @function ifnet_hdrlen
        @param interface The interface.
        @result The header length.
  */

-u_int8_t       ifnet_hdrlen(ifnet_t interface);
+extern u_int8_t ifnet_hdrlen(ifnet_t interface);

 
 /*!
        @function ifnet_set_metric
 
 /*!
        @function ifnet_set_metric


@@ -1083,14 +1364,14 @@ u_int8_t        ifnet_hdrlen(ifnet_t interface);
        @param metric The new metric.
        @result 0 on success otherwise the errno error.
  */
        @param metric The new metric.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_metric(ifnet_t interface, u_int32_t metric);
+extern errno_t ifnet_set_metric(ifnet_t interface, u_int32_t metric);

 
 /*!
        @function ifnet_metric
        @param interface The interface.
        @result The metric.
  */
 
 /*!
        @function ifnet_metric
        @param interface The interface.
        @result The metric.
  */

-u_int32_t      ifnet_metric(ifnet_t interface);
+extern u_int32_t ifnet_metric(ifnet_t interface);

 
 /*!
        @function ifnet_set_baudrate
 
 /*!
        @function ifnet_set_baudrate


@@ -1102,14 +1383,14 @@ u_int32_t       ifnet_metric(ifnet_t interface);
        @param baudrate The new baudrate.
        @result 0 on success otherwise the errno error.
  */
        @param baudrate The new baudrate.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_baudrate(ifnet_t interface, u_int64_t baudrate);
+extern errno_t ifnet_set_baudrate(ifnet_t interface, u_int64_t baudrate);

 
 /*!
        @function ifnet_baudrate
        @param interface The interface.
        @result The baudrate.
  */
 
 /*!
        @function ifnet_baudrate
        @param interface The interface.
        @result The baudrate.
  */

-u_int64_t      ifnet_baudrate(ifnet_t interface);
+extern u_int64_t ifnet_baudrate(ifnet_t interface);

 
 /*!
        @function ifnet_stat_increment
 
 /*!
        @function ifnet_stat_increment


@@ -1123,8 +1404,8 @@ u_int64_t ifnet_baudrate(ifnet_t interface);
                ifnet_counter_increment structure are handled in the stack.
        @result 0 on success otherwise the errno error.
  */
                ifnet_counter_increment structure are handled in the stack.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_stat_increment(ifnet_t interface,
-                               const struct ifnet_stat_increment_param *counts);
+extern errno_t ifnet_stat_increment(ifnet_t interface,
+    const struct ifnet_stat_increment_param *counts);

 
 /*!
        @function ifnet_stat_increment_in
 
 /*!
        @function ifnet_stat_increment_in


@@ -1133,7 +1414,7 @@ errno_t           ifnet_stat_increment(ifnet_t interface,
                function allows a driver to update the inbound interface counts.
                The most efficient time to update these counts is when calling
                ifnet_input.
                function allows a driver to update the inbound interface counts.
                The most efficient time to update these counts is when calling
                ifnet_input.

-               
+

                A lock protects the counts, this makes the increment functions
                expensive. The increment function will update the lastchanged
                value.
                A lock protects the counts, this makes the increment functions
                expensive. The increment function will update the lastchanged
                value.


@@ -1143,16 +1424,16 @@ errno_t         ifnet_stat_increment(ifnet_t interface,
        @param errors_in The number of additional receive errors.
        @result 0 on success otherwise the errno error.
  */
        @param errors_in The number of additional receive errors.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_stat_increment_in(ifnet_t interface,
-                               u_int32_t packets_in, u_int32_t bytes_in,
-                               u_int32_t errors_in);
+extern errno_t ifnet_stat_increment_in(ifnet_t interface,
+    u_int32_t packets_in, u_int32_t bytes_in, u_int32_t errors_in);

 
 /*!
        @function ifnet_stat_increment_out
        @discussion
                This function is intended to be called by the driver. This
 
 /*!
        @function ifnet_stat_increment_out
        @discussion
                This function is intended to be called by the driver. This

-               function allows a driver to update the outbound interface counts.
-               
+               function allows a driver to update the outbound interface
+               counts.
+

                A lock protects the counts, this makes the increment functions
                expensive. The increment function will update the lastchanged
                value.
                A lock protects the counts, this makes the increment functions
                expensive. The increment function will update the lastchanged
                value.


@@ -1162,9 +1443,8 @@ errno_t           ifnet_stat_increment_in(ifnet_t interface,
        @param errors_out The number of additional send errors.
        @result 0 on success otherwise the errno error.
  */
        @param errors_out The number of additional send errors.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_stat_increment_out(ifnet_t interface,
-                               u_int32_t packets_out, u_int32_t bytes_out,
-                               u_int32_t errors_out);
+extern errno_t ifnet_stat_increment_out(ifnet_t interface,
+u_int32_t packets_out, u_int32_t bytes_out, u_int32_t errors_out);

 
 /*!
        @function ifnet_set_stat
 
 /*!
        @function ifnet_set_stat


@@ -1172,15 +1452,15 @@ errno_t         ifnet_stat_increment_out(ifnet_t interface,
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.
                This function is intended to be called by the driver. A kext
                must not call this function on an interface the kext does not
                own.

-               
+

                The one exception would be the case where a kext wants to zero
                all of the counters.
        @param interface The interface.
        @param counts The new stats values.
        @result 0 on success otherwise the errno error.
  */
                The one exception would be the case where a kext wants to zero
                all of the counters.
        @param interface The interface.
        @param counts The new stats values.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_stat(ifnet_t interface,
-                               const struct ifnet_stats_param *stats);
+extern errno_t ifnet_set_stat(ifnet_t interface,
+    const struct ifnet_stats_param *stats);

 
 /*!
        @function ifnet_stat
 
 /*!
        @function ifnet_stat


@@ -1188,8 +1468,8 @@ errno_t           ifnet_set_stat(ifnet_t interface,
        @param out_stats Storage for the values.
        @result 0 on success otherwise the errno error.
  */
        @param out_stats Storage for the values.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_stat(ifnet_t interface,
-                               struct ifnet_stats_param *out_stats);
+extern errno_t ifnet_stat(ifnet_t interface,
+    struct ifnet_stats_param *out_stats);

 
 /*!
        @function ifnet_set_promiscuous
 
 /*!
        @function ifnet_set_promiscuous


@@ -1206,7 +1486,7 @@ errno_t           ifnet_stat(ifnet_t interface,
                zero, promiscuous mode will be disabled.
        @result 0 on success otherwise the errno error.
  */
                zero, promiscuous mode will be disabled.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_set_promiscuous(ifnet_t interface, int on);
+extern errno_t ifnet_set_promiscuous(ifnet_t interface, int on);

 
 /*!
        @function ifnet_touch_lastchange
 
 /*!
        @function ifnet_touch_lastchange


@@ -1214,7 +1494,7 @@ errno_t           ifnet_set_promiscuous(ifnet_t interface, int on);
        @param interface The interface.
        @result 0 on success otherwise the errno error.
  */
        @param interface The interface.
        @result 0 on success otherwise the errno error.
  */

-errno_t                ifnet_touch_lastchange(ifnet_t interface);
+extern errno_t ifnet_touch_lastchange(ifnet_t interface);

 
 /*!
        @function ifnet_lastchange
 
 /*!
        @function ifnet_lastchange


@@ -1222,7 +1502,7 @@ errno_t           ifnet_touch_lastchange(ifnet_t interface);
        @param last_change A timeval struct to copy the last time changed in
                to.
  */
        @param last_change A timeval struct to copy the last time changed in
                to.
  */

-errno_t                ifnet_lastchange(ifnet_t interface, struct timeval *last_change);
+extern errno_t ifnet_lastchange(ifnet_t interface, struct timeval *last_change);

 
 /*!
        @function ifnet_get_address_list
 
 /*!
        @function ifnet_get_address_list


@@ -1237,7 +1517,7 @@ errno_t           ifnet_lastchange(ifnet_t interface, struct timeval *last_change);
        @param addresses A pointer to a NULL terminated array of ifaddr_ts.
        @result 0 on success otherwise the errno error.
  */
        @param addresses A pointer to a NULL terminated array of ifaddr_ts.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_get_address_list(ifnet_t interface, ifaddr_t **addresses);
+extern errno_t ifnet_get_address_list(ifnet_t interface, ifaddr_t **addresses);

 
 /*!
        @function ifnet_get_address_list_family
 
 /*!
        @function ifnet_get_address_list_family


@@ -1254,7 +1534,13 @@ errno_t ifnet_get_address_list(ifnet_t interface, ifaddr_t **addresses);
        @param addresses A pointer to a NULL terminated array of ifaddr_ts.
        @result 0 on success otherwise the errno error.
  */
        @param addresses A pointer to a NULL terminated array of ifaddr_ts.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_get_address_list_family(ifnet_t interface, ifaddr_t **addresses, sa_family_t family);
+extern errno_t ifnet_get_address_list_family(ifnet_t interface,
+    ifaddr_t **addresses, sa_family_t family);
+
+#ifdef KERNEL_PRIVATE
+__private_extern__ errno_t ifnet_get_address_list_family_internal(ifnet_t,
+    ifaddr_t **, sa_family_t, int, int);
+#endif /* KERNEL_PRIVATE */

 
 /*!
        @function ifnet_free_address_list
 
 /*!
        @function ifnet_free_address_list


@@ -1263,7 +1549,7 @@ errno_t ifnet_get_address_list_family(ifnet_t interface, ifaddr_t **addresses, s
                memory used for the array of references.
        @param addresses An array of ifaddr_ts.
  */
                memory used for the array of references.
        @param addresses An array of ifaddr_ts.
  */

-void ifnet_free_address_list(ifaddr_t *addresses);
+extern void ifnet_free_address_list(ifaddr_t *addresses);

 
 /*!
        @function ifnet_set_lladdr
 
 /*!
        @function ifnet_set_lladdr


@@ -1274,7 +1560,8 @@ void ifnet_free_address_list(ifaddr_t *addresses);
                the 6 byte ethernet address for ethernet).
        @param lladdr_len The length, in bytes, of the link layer address.
  */
                the 6 byte ethernet address for ethernet).
        @param lladdr_len The length, in bytes, of the link layer address.
  */

-errno_t ifnet_set_lladdr(ifnet_t interface, const void* lladdr, size_t lladdr_len);
+extern errno_t ifnet_set_lladdr(ifnet_t interface, const void *lladdr,
+    size_t lladdr_len);

 
 /*!
        @function ifnet_lladdr_copy_bytes
 
 /*!
        @function ifnet_lladdr_copy_bytes


@@ -1285,7 +1572,8 @@ errno_t ifnet_set_lladdr(ifnet_t interface, const void* lladdr, size_t lladdr_le
        @param length The length of the buffer. This value must match the
                length of the link-layer address.
  */
        @param length The length of the buffer. This value must match the
                length of the link-layer address.
  */

-errno_t ifnet_lladdr_copy_bytes(ifnet_t interface, void* lladdr, size_t length);
+extern errno_t ifnet_lladdr_copy_bytes(ifnet_t interface, void *lladdr,
+    size_t length);

 
 #ifdef KERNEL_PRIVATE
 /*!
 
 #ifdef KERNEL_PRIVATE
 /*!


@@ -1293,8 +1581,8 @@ errno_t ifnet_lladdr_copy_bytes(ifnet_t interface, void* lladdr, size_t length);
        @discussion Returns a pointer to the link-layer address.
        @param interface The interface the link-layer address is on.
  */
        @discussion Returns a pointer to the link-layer address.
        @param interface The interface the link-layer address is on.
  */

-void* ifnet_lladdr(ifnet_t interface);
-#endif KERNEL_PRIVATE
+extern void *ifnet_lladdr(ifnet_t interface);
+#endif /* KERNEL_PRIVATE */

 
 /*!
        @function ifnet_llbroadcast_copy_bytes
 
 /*!
        @function ifnet_llbroadcast_copy_bytes


@@ -1306,8 +1594,8 @@ void* ifnet_lladdr(ifnet_t interface);
        @param addr_len On return, the length of the broadcast address.
        @param lladdr_len The length, in bytes, of the link layer address.
  */
        @param addr_len On return, the length of the broadcast address.
        @param lladdr_len The length, in bytes, of the link layer address.
  */

-errno_t ifnet_llbroadcast_copy_bytes(ifnet_t interface, void* addr,
-                                                                        size_t bufferlen, size_t* addr_len);
+extern errno_t ifnet_llbroadcast_copy_bytes(ifnet_t interface, void *addr,
+    size_t bufferlen, size_t *addr_len);

 
 #ifdef KERNEL_PRIVATE
 /*!
 
 #ifdef KERNEL_PRIVATE
 /*!


@@ -1322,8 +1610,26 @@ errno_t ifnet_llbroadcast_copy_bytes(ifnet_t interface, void* addr,
        @param lladdr_len The length, in bytes, of the link layer address.
        @param type The link-layer address type.
  */
        @param lladdr_len The length, in bytes, of the link layer address.
        @param type The link-layer address type.
  */

-errno_t ifnet_set_lladdr_and_type(ifnet_t interface, const void* lladdr, size_t length, u_char type);
-#endif KERNEL_PRIVATE
+extern errno_t ifnet_set_lladdr_and_type(ifnet_t interface, const void *lladdr,
+    size_t length, u_char type);
+#endif /* KERNEL_PRIVATE */
+
+/*!
+       @function ifnet_resolve_multicast
+       @discussion Resolves a multicast address for an attached protocol to
+               a link-layer address. If a link-layer address is passed in, the
+               interface will verify that it is a valid multicast address.
+       @param interface The interface.
+       @param proto_addr A protocol address to be converted to a link-layer
+               address.
+       @param ll_addr Storage for the resulting link-layer address.
+       @param ll_len Length of the storage for the link-layer address.
+       @result 0 on success. EOPNOTSUPP indicates the multicast address was
+               not supported or could not be translated. Other errors may
+               indicate other failures.
+ */
+extern errno_t ifnet_resolve_multicast(ifnet_t ifp,
+    const struct sockaddr *proto_addr, struct sockaddr *ll_addr, size_t ll_len);

 
 /*!
        @function ifnet_add_multicast
 
 /*!
        @function ifnet_add_multicast


@@ -1333,14 +1639,14 @@ errno_t ifnet_set_lladdr_and_type(ifnet_t interface, const void* lladdr, size_t
                ifnet_remove_multicast and making sure you no longer have any
                references to the multicast.
        @param interface The interface.
                ifnet_remove_multicast and making sure you no longer have any
                references to the multicast.
        @param interface The interface.

-       @param maddr The multicast address to join. Either a physical
-               address or logical address to be translated to a physical
-               address.
+       @param maddr The multicast address (AF_UNSPEC/AF_LINK) to join. Either
+               a physical address or logical address to be translated to a
+               physical address.

        @param multicast The resulting ifmultiaddr_t multicast address.
        @result 0 on success otherwise the errno error.
  */
        @param multicast The resulting ifmultiaddr_t multicast address.
        @result 0 on success otherwise the errno error.
  */

-errno_t        ifnet_add_multicast(ifnet_t interface, const struct sockaddr *maddr,
-                                                       ifmultiaddr_t *multicast);
+extern errno_t ifnet_add_multicast(ifnet_t interface,
+    const struct sockaddr *maddr, ifmultiaddr_t *multicast);

 
 /*!
        @function ifnet_remove_multicast
 
 /*!
        @function ifnet_remove_multicast


@@ -1350,23 +1656,23 @@ errno_t ifnet_add_multicast(ifnet_t interface, const struct sockaddr *maddr,
                removed when the number of times ifnet_remove_multicast has been
                called matches the number of times ifnet_add_multicast has been
                called.
                removed when the number of times ifnet_remove_multicast has been
                called matches the number of times ifnet_add_multicast has been
                called.

-               
+

                The memory for the multicast address is not actually freed until
                the separate reference count has reached zero. Some parts of the
                stack may keep a pointer to the multicast even after that
                multicast has been removed from the interface.
                The memory for the multicast address is not actually freed until
                the separate reference count has reached zero. Some parts of the
                stack may keep a pointer to the multicast even after that
                multicast has been removed from the interface.

-               
+

                When an interface is detached, all of the multicasts are
                removed. If the interface of the multicast passed in is no
                longer attached, this function will gracefully return,
                performing no work.
                When an interface is detached, all of the multicasts are
                removed. If the interface of the multicast passed in is no
                longer attached, this function will gracefully return,
                performing no work.

-               
+

                It is the callers responsibility to release the multicast
                address after calling this function.
        @param multicast The multicast to be removed.
        @result 0 on success otherwise the errno error.
  */
                It is the callers responsibility to release the multicast
                address after calling this function.
        @param multicast The multicast to be removed.
        @result 0 on success otherwise the errno error.
  */

-errno_t        ifnet_remove_multicast(ifmultiaddr_t multicast);
+extern errno_t ifnet_remove_multicast(ifmultiaddr_t multicast);

 
 /*!
        @function ifnet_get_multicast_list
 
 /*!
        @function ifnet_get_multicast_list


@@ -1381,7 +1687,8 @@ errno_t   ifnet_remove_multicast(ifmultiaddr_t multicast);
                to the multicast addresses.
        @result 0 on success otherwise the errno error.
  */
                to the multicast addresses.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_get_multicast_list(ifnet_t interface, ifmultiaddr_t **addresses);
+extern errno_t ifnet_get_multicast_list(ifnet_t interface,
+    ifmultiaddr_t **addresses);

 
 /*!
        @function ifnet_free_multicast_list
 
 /*!
        @function ifnet_free_multicast_list


@@ -1391,7 +1698,7 @@ errno_t ifnet_get_multicast_list(ifnet_t interface, ifmultiaddr_t **addresses);
        @param multicasts An array of references to the multicast addresses.
        @result 0 on success otherwise the errno error.
  */
        @param multicasts An array of references to the multicast addresses.
        @result 0 on success otherwise the errno error.
  */

-void ifnet_free_multicast_list(ifmultiaddr_t *multicasts);
+extern void ifnet_free_multicast_list(ifmultiaddr_t *multicasts);

 
 /*!
        @function ifnet_find_by_name
 
 /*!
        @function ifnet_find_by_name


@@ -1404,7 +1711,7 @@ void ifnet_free_multicast_list(ifmultiaddr_t *multicasts);
                filled in if a matching interface is found.
        @result 0 on success otherwise the errno error.
  */
                filled in if a matching interface is found.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_find_by_name(const char *ifname, ifnet_t *interface);
+extern errno_t ifnet_find_by_name(const char *ifname, ifnet_t *interface);

 
 /*!
        @function ifnet_list_get
 
 /*!
        @function ifnet_list_get


@@ -1420,7 +1727,28 @@ errno_t ifnet_find_by_name(const char *ifname, ifnet_t *interface);
                matching interfaces in the array.
        @result 0 on success otherwise the errno error.
  */
                matching interfaces in the array.
        @result 0 on success otherwise the errno error.
  */

-errno_t ifnet_list_get(ifnet_family_t family, ifnet_t **interfaces, u_int32_t *count);
+extern errno_t ifnet_list_get(ifnet_family_t family, ifnet_t **interfaces,
+    u_int32_t *count);
+
+#ifdef KERNEL_PRIVATE
+/*!
+       @function ifnet_list_get_all
+       @discussion Get a list of attached interfaces. List will be set to
+               point to an array allocated by ifnet_list_get. The interfaces
+               are refcounted and the counts will be incremented before the
+               function returns. The list of interfaces must be freed using
+               ifnet_list_free.  This is similar to ifnet_list_get, except
+               that it includes interfaces that are detaching.
+       @param family The interface family (i.e. IFNET_FAMILY_ETHERNET). To
+               find interfaces of all families, use IFNET_FAMILY_ANY.
+       @param interfaces A pointer to an array of interface references.
+       @param count A pointer that will be filled in with the number of
+               matching interfaces in the array.
+       @result 0 on success otherwise the errno error.
+ */
+extern errno_t ifnet_list_get_all(ifnet_family_t family, ifnet_t **interfaces,
+    u_int32_t *count);
+#endif /* KERNEL_PRIVATE */

 
 /*!
        @function ifnet_list_free
 
 /*!
        @function ifnet_list_free


@@ -1431,11 +1759,11 @@ errno_t ifnet_list_get(ifnet_family_t family, ifnet_t **interfaces, u_int32_t *c
                ifnet_list_free.
        @param interfaces An array of interface references from ifnet_list_get.
  */
                ifnet_list_free.
        @param interfaces An array of interface references from ifnet_list_get.
  */

-void ifnet_list_free(ifnet_t *interfaces);
+extern void ifnet_list_free(ifnet_t *interfaces);

 
 

-/********************************************************************************************/
-/* ifaddr_t accessors                                                                                                                                          */
-/********************************************************************************************/
+/******************************************************************************/
+/* ifaddr_t accessors                                                         */
+/******************************************************************************/

 
 /*!
        @function ifaddr_reference
 
 /*!
        @function ifaddr_reference


@@ -1444,7 +1772,7 @@ void ifnet_list_free(ifnet_t *interfaces);
        @param ifaddr The interface address.
        @result 0 upon success
  */
        @param ifaddr The interface address.
        @result 0 upon success
  */

-errno_t        ifaddr_reference(ifaddr_t ifaddr);
+extern errno_t ifaddr_reference(ifaddr_t ifaddr);

 
 /*!
        @function ifaddr_release
 
 /*!
        @function ifaddr_release


@@ -1453,7 +1781,7 @@ errno_t   ifaddr_reference(ifaddr_t ifaddr);
        @param ifaddr The interface address.
        @result 0 upon success
  */
        @param ifaddr The interface address.
        @result 0 upon success
  */

-errno_t        ifaddr_release(ifaddr_t ifaddr);
+extern errno_t ifaddr_release(ifaddr_t ifaddr);

 
 /*!
        @function ifaddr_address
 
 /*!
        @function ifaddr_address


@@ -1463,7 +1791,8 @@ errno_t   ifaddr_release(ifaddr_t ifaddr);
        @param addr_size The size of the storage for the address.
        @result 0 upon success
  */
        @param addr_size The size of the storage for the address.
        @result 0 upon success
  */

-errno_t        ifaddr_address(ifaddr_t ifaddr, struct sockaddr *out_addr, u_int32_t addr_size);
+extern errno_t ifaddr_address(ifaddr_t ifaddr, struct sockaddr *out_addr,
+    u_int32_t addr_size);

 
 /*!
        @function ifaddr_address
 
 /*!
        @function ifaddr_address


@@ -1471,7 +1800,7 @@ errno_t   ifaddr_address(ifaddr_t ifaddr, struct sockaddr *out_addr, u_int32_t add
        @param ifaddr The interface address.
        @result 0 on failure, address family on success.
  */
        @param ifaddr The interface address.
        @result 0 on failure, address family on success.
  */

-sa_family_t    ifaddr_address_family(ifaddr_t ifaddr);
+extern sa_family_t ifaddr_address_family(ifaddr_t ifaddr);

 
 /*!
        @function ifaddr_dstaddress
 
 /*!
        @function ifaddr_dstaddress


@@ -1481,7 +1810,8 @@ sa_family_t       ifaddr_address_family(ifaddr_t ifaddr);
        @param dstaddr_size The size of the storage for the destination address.
        @result 0 upon success
  */
        @param dstaddr_size The size of the storage for the destination address.
        @result 0 upon success
  */

-errno_t        ifaddr_dstaddress(ifaddr_t ifaddr, struct sockaddr *out_dstaddr, u_int32_t dstaddr_size);
+extern errno_t ifaddr_dstaddress(ifaddr_t ifaddr, struct sockaddr *out_dstaddr,
+    u_int32_t dstaddr_size);

 
 /*!
        @function ifaddr_netmask
 
 /*!
        @function ifaddr_netmask


@@ -1491,7 +1821,8 @@ errno_t   ifaddr_dstaddress(ifaddr_t ifaddr, struct sockaddr *out_dstaddr, u_int32
        @param netmask_size The size of the storage for the netmask.
        @result 0 upon success
  */
        @param netmask_size The size of the storage for the netmask.
        @result 0 upon success
  */

-errno_t        ifaddr_netmask(ifaddr_t ifaddr, struct sockaddr *out_netmask, u_int32_t netmask_size);
+extern errno_t ifaddr_netmask(ifaddr_t ifaddr, struct sockaddr *out_netmask,
+    u_int32_t netmask_size);

 
 /*!
        @function ifaddr_ifnet
 
 /*!
        @function ifaddr_ifnet


@@ -1503,7 +1834,7 @@ errno_t   ifaddr_netmask(ifaddr_t ifaddr, struct sockaddr *out_netmask, u_int32_t
        @param ifaddr The interface address.
        @result A reference to the interface the address is attached to.
  */
        @param ifaddr The interface address.
        @result A reference to the interface the address is attached to.
  */

-ifnet_t        ifaddr_ifnet(ifaddr_t ifaddr);
+extern ifnet_t ifaddr_ifnet(ifaddr_t ifaddr);

 
 /*!
        @function ifaddr_withaddr
 
 /*!
        @function ifaddr_withaddr


@@ -1513,7 +1844,7 @@ ifnet_t   ifaddr_ifnet(ifaddr_t ifaddr);
        @param address The address to search for.
        @result A reference to the interface address.
  */
        @param address The address to search for.
        @result A reference to the interface address.
  */

-ifaddr_t       ifaddr_withaddr(const struct sockaddr* address);
+extern ifaddr_t ifaddr_withaddr(const struct sockaddr *address);

 
 /*!
        @function ifaddr_withdstaddr
 
 /*!
        @function ifaddr_withdstaddr


@@ -1524,7 +1855,7 @@ ifaddr_t  ifaddr_withaddr(const struct sockaddr* address);
        @param destination The destination to search for.
        @result A reference to the interface address.
  */
        @param destination The destination to search for.
        @result A reference to the interface address.
  */

-ifaddr_t       ifaddr_withdstaddr(const struct sockaddr* destination);
+extern ifaddr_t ifaddr_withdstaddr(const struct sockaddr *destination);

 
 /*!
        @function ifaddr_withnet
 
 /*!
        @function ifaddr_withnet


@@ -1535,7 +1866,7 @@ ifaddr_t  ifaddr_withdstaddr(const struct sockaddr* destination);
        @param net The network to search for.
        @result A reference to the interface address.
  */
        @param net The network to search for.
        @result A reference to the interface address.
  */

-ifaddr_t       ifaddr_withnet(const struct sockaddr* net);
+extern ifaddr_t ifaddr_withnet(const struct sockaddr *net);

 
 /*!
        @function ifaddr_withroute
 
 /*!
        @function ifaddr_withroute


@@ -1548,8 +1879,8 @@ ifaddr_t  ifaddr_withnet(const struct sockaddr* net);
        @param gateway A gateway to search for.
        @result A reference to the interface address.
  */
        @param gateway A gateway to search for.
        @result A reference to the interface address.
  */

-ifaddr_t       ifaddr_withroute(int flags, const struct sockaddr* destination,
-                                                        const struct sockaddr* gateway);
+extern ifaddr_t ifaddr_withroute(int flags, const struct sockaddr *destination,
+    const struct sockaddr *gateway);

 
 /*!
        @function ifaddr_findbestforaddr
 
 /*!
        @function ifaddr_findbestforaddr


@@ -1561,11 +1892,12 @@ ifaddr_t        ifaddr_withroute(int flags, const struct sockaddr* destination,
        @param interface The local interface.
        @result A reference to the interface address.
  */
        @param interface The local interface.
        @result A reference to the interface address.
  */

-ifaddr_t       ifaddr_findbestforaddr(const struct sockaddr *addr, ifnet_t interface);
+extern ifaddr_t        ifaddr_findbestforaddr(const struct sockaddr *addr,
+    ifnet_t interface);

 
 

-/********************************************************************************************/
-/* ifmultiaddr_t accessors                                                                                                                                     */
-/********************************************************************************************/
+/******************************************************************************/
+/* ifmultiaddr_t accessors                                                    */
+/******************************************************************************/

 
 /*!
        @function ifmaddr_reference
 
 /*!
        @function ifmaddr_reference


@@ -1574,7 +1906,7 @@ ifaddr_t  ifaddr_findbestforaddr(const struct sockaddr *addr, ifnet_t interface);
        @param ifmaddr The interface multicast address.
        @result 0 on success. Only error will be EINVAL if ifmaddr is not valid.
  */
        @param ifmaddr The interface multicast address.
        @result 0 on success. Only error will be EINVAL if ifmaddr is not valid.
  */

-errno_t        ifmaddr_reference(ifmultiaddr_t ifmaddr);
+extern errno_t ifmaddr_reference(ifmultiaddr_t ifmaddr);

 
 /*!
        @function ifmaddr_release
 
 /*!
        @function ifmaddr_release


@@ -1585,7 +1917,7 @@ errno_t   ifmaddr_reference(ifmultiaddr_t ifmaddr);
        @param ifmaddr The interface multicast address.
        @result 0 on success. Only error will be EINVAL if ifmaddr is not valid.
  */
        @param ifmaddr The interface multicast address.
        @result 0 on success. Only error will be EINVAL if ifmaddr is not valid.
  */

-errno_t        ifmaddr_release(ifmultiaddr_t ifmaddr);
+extern errno_t ifmaddr_release(ifmultiaddr_t ifmaddr);

 
 /*!
        @function ifmaddr_address
 
 /*!
        @function ifmaddr_address


@@ -1594,7 +1926,8 @@ errno_t   ifmaddr_release(ifmultiaddr_t ifmaddr);
        @param addr_size Size of the storage.
        @result 0 on success.
  */
        @param addr_size Size of the storage.
        @result 0 on success.
  */

-errno_t        ifmaddr_address(ifmultiaddr_t ifmaddr, struct sockaddr *out_multicast, u_int32_t addr_size);
+extern errno_t ifmaddr_address(ifmultiaddr_t ifmaddr,
+    struct sockaddr *out_multicast, u_int32_t addr_size);

 
 /*!
        @function ifmaddr_lladdress
 
 /*!
        @function ifmaddr_lladdress


@@ -1604,8 +1937,8 @@ errno_t   ifmaddr_address(ifmultiaddr_t ifmaddr, struct sockaddr *out_multicast, u
        @param addr_size Size of the storage.
        @result 0 on success.
  */
        @param addr_size Size of the storage.
        @result 0 on success.
  */

-errno_t        ifmaddr_lladdress(ifmultiaddr_t ifmaddr, struct sockaddr *out_link_layer_multicast,
-                                                 u_int32_t addr_size);
+extern errno_t ifmaddr_lladdress(ifmultiaddr_t ifmaddr,
+    struct sockaddr *out_link_layer_multicast, u_int32_t addr_size);

 
 /*!
        @function ifmaddr_ifnet
 
 /*!
        @function ifmaddr_ifnet


@@ -1618,8 +1951,68 @@ errno_t  ifmaddr_lladdress(ifmultiaddr_t ifmaddr, struct sockaddr *out_link_layer
        @param ifmaddr The interface multicast address.
        @result A reference to the interface.
  */
        @param ifmaddr The interface multicast address.
        @result A reference to the interface.
  */

-ifnet_t        ifmaddr_ifnet(ifmultiaddr_t ifmaddr);
+extern ifnet_t ifmaddr_ifnet(ifmultiaddr_t ifmaddr);
+
+#ifdef KERNEL_PRIVATE
+/******************************************************************************/
+/* interface cloner                                                           */
+/******************************************************************************/
+
+/*
+       @typedef ifnet_clone_create_func
+       @discussion ifnet_clone_create_func is called to create an interface.
+       @param ifcloner The interface cloner.
+       @param unit The interface unit number to create.
+       @param params Additional information specific to the interface cloner.
+       @result Return zero on success or an errno error value on failure.
+ */
+typedef errno_t (*ifnet_clone_create_func)(if_clone_t ifcloner, u_int32_t unit, void *params);
+
+/*
+       @typedef ifnet_clone_destroy_func
+       @discussion ifnet_clone_create_func is called to destroy an interface created 
+               by an interface cloner.
+       @param interface The interface to destroy.
+       @result Return zero on success or an errno error value on failure.
+ */
+typedef errno_t (*ifnet_clone_destroy_func)(ifnet_t interface);
+
+/*
+       @struct ifnet_clone_params
+       @discussion This structure is used to represent an interface cloner.
+       @field ifc_name The interface name handled by this interface cloner.
+       @field ifc_create The function to create an interface.
+       @field ifc_destroy The function to destroy an interface.
+*/
+struct ifnet_clone_params {
+       const char                                      *ifc_name;
+       ifnet_clone_create_func         ifc_create;
+       ifnet_clone_destroy_func        ifc_destroy;
+};
+
+/*
+       @function ifnet_clone_attach
+       @discussion Attaches a new interface cloner.
+       @param cloner_params The structure that defines an interface cloner.
+       @param interface A pointer to an opaque handle that represent the interface cloner 
+               that is attached upon success.
+       @result Returns 0 on success. 
+               May return ENOBUFS if there is insufficient memory.
+               May return EEXIST if an interface cloner with the same name is already attached.
+ */
+extern errno_t ifnet_clone_attach(struct ifnet_clone_params *cloner_params, if_clone_t *ifcloner);
+
+/*
+       @function ifnet_clone_detach
+       @discussion Detaches a previously attached interface cloner.
+       @param ifcloner The opaque handle returned when the interface cloner was attached.
+       @result Returns 0 on success. 
+ */
+extern errno_t ifnet_clone_detach(if_clone_t ifcloner);
+
+#endif /* KERNEL_PRIVATE */

 
 __END_DECLS
 
 
 __END_DECLS
 

-#endif
+#endif /* __KPI_INTERFACE__ */
+