/*
* Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
*
- * @APPLE_LICENSE_HEADER_START@
- *
- * Copyright (c) 1999-2003 Apple Computer, Inc. All Rights Reserved.
+ * @APPLE_OSREFERENCE_LICENSE_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. Please obtain a copy of the License at
- * http://www.opensource.apple.com/apsl/ and read it before using this
- * file.
+ * 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
* Please see the License for the specific language governing rights and
* limitations under the License.
*
- * @APPLE_LICENSE_HEADER_END@
+ * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
*/
/*
* Copyright (c) 1999 Apple Computer, Inc.
* Data Link Inteface Layer
* Author: Ted Walker
*/
-
-
#ifndef DLIL_H
#define DLIL_H
-#include <sys/appleapiopts.h>
+#ifdef KERNEL
+#include <sys/kernel_types.h>
+#include <net/kpi_interface.h>
#if __STDC__
struct ifnet;
struct mbuf;
struct ether_header;
+struct sockaddr_dl;
#endif
-#ifdef __APPLE_API_UNSTABLE
+#ifdef KERNEL_PRIVATE
#define DLIL_LAST_FILTER -1
#define DLIL_NULL_FILTER -2
#include <net/if_var.h>
#include <sys/kern_event.h>
+#endif KERNEL_PRIVATE
+
enum {
BPF_TAP_DISABLE,
BPF_TAP_INPUT,
BPF_TAP_INPUT_OUTPUT
};
-
-struct dl_tag_attr_str {
- u_long dl_tag;
- short if_flags;
- short if_unit;
- u_long if_family;
- u_long protocol_family;
-};
-
-
-struct dlil_pr_flt_str {
- caddr_t cookie;
-
- int (*filter_dl_input)(caddr_t cookie,
- struct mbuf **m,
- char **frame_header,
- struct ifnet **ifp);
-
-
- int (*filter_dl_output)(caddr_t cookie,
- struct mbuf **m,
- struct ifnet **ifp,
- struct sockaddr **dest,
- char *dest_linkaddr,
- char *frame_type);
-
- int (*filter_dl_event)(caddr_t cookie,
- struct kern_event_msg *event_msg);
-
- int (*filter_dl_ioctl)(caddr_t cookie,
- struct ifnet *ifp,
- u_long ioctl_cmd,
- caddr_t ioctl_arg);
-
- int (*filter_detach)(caddr_t cookie);
- u_long reserved[2];
-};
+#ifdef KERNEL_PRIVATE
+struct kev_msg;
+struct iff_filter;
struct dlil_if_flt_str {
caddr_t cookie;
int (*filter_if_input)(caddr_t cookie,
- struct ifnet **ifnet_ptr,
+ struct ifnet **ifp,
struct mbuf **mbuf_ptr,
char **frame_ptr);
int (*filter_if_event)(caddr_t cookie,
- struct ifnet **ifnet_ptr,
- struct kern_event_msg **event_msg_ptr);
+ struct ifnet *ifp,
+ struct kev_msg *event_msg_ptr);
int (*filter_if_output)(caddr_t cookie,
- struct ifnet **ifnet_ptr,
+ struct ifnet **ifp,
struct mbuf **mbuf_ptr);
int (*filter_if_ioctl)(caddr_t cookie,
- struct ifnet *ifnet_ptr,
+ struct ifnet *ifp,
u_long ioctl_code_ptr,
caddr_t ioctl_arg_ptr);
int (*filter_if_free)(caddr_t cookie,
- struct ifnet *ifnet_ptr);
+ struct ifnet *ifp);
- int (*filter_detach)(caddr_t cookie);
+ int (*filter_detach)(caddr_t cookie);
u_long reserved[2];
};
-
#define DLIL_PR_FILTER 1
#define DLIL_IF_FILTER 2
typedef int (*dl_input_func)(struct mbuf *m, char *frame_header,
- struct ifnet *ifp, u_long dl_tag, int sync_ok);
+ struct ifnet *ifp, u_long protocol_family, int sync_ok);
typedef int (*dl_pre_output_func)(struct ifnet *ifp,
- struct mbuf **m,
- struct sockaddr *dest,
- caddr_t route_entry,
- char *frame_type,
- char *dst_addr,
- u_long dl_tag);
+ u_long protocol_family,
+ struct mbuf **m,
+ const struct sockaddr *dest,
+ caddr_t route_entry,
+ char *frame_type,
+ char *dst_addr);
-typedef int (*dl_event_func)(struct kern_event_msg *event,
- u_long dl_tag);
+typedef void (*dl_event_func)(struct ifnet *ifp, struct kev_msg *event);
typedef int (*dl_offer_func)(struct mbuf *m, char *frame_header);
-typedef int (*dl_ioctl_func)(u_long dl_tag,
+typedef int (*dl_ioctl_func)(u_long protocol_family,
struct ifnet *ifp,
u_long ioctl_cmd,
caddr_t ioctl_arg);
+typedef int (*dl_detached_func)(u_long protocol_family, struct ifnet *ifp);
-
-
-#ifdef __APPLE_API_PRIVATE
-struct dlil_filterq_entry {
- TAILQ_ENTRY(dlil_filterq_entry) que;
- u_long filter_id;
- int type;
- union {
- struct dlil_if_flt_str if_filter;
- struct dlil_pr_flt_str pr_filter;
- } variants;
-};
-#else
-struct dlil_filterq_entry;
-#endif /* __APPLE_API_PRIVATE */
-
-TAILQ_HEAD(dlil_filterq_head, dlil_filterq_entry);
-
-
-struct if_proto {
- TAILQ_ENTRY(if_proto) next;
- u_long dl_tag;
- struct dlil_filterq_head pr_flt_head;
- struct ifnet *ifp;
- dl_input_func dl_input;
- dl_pre_output_func dl_pre_output;
- dl_event_func dl_event;
- dl_offer_func dl_offer;
- dl_ioctl_func dl_ioctl;
- u_long protocol_family;
- u_long reserved[4];
-
-};
-
-#ifdef __APPLE_API_PRIVATE
-TAILQ_HEAD(dlil_proto_head, if_proto);
-
-struct dlil_tag_list_entry {
- TAILQ_ENTRY(dlil_tag_list_entry) next;
- struct ifnet *ifp;
- u_long dl_tag;
-};
-#endif /* __APPLE_API_PRIVATE */
-
-
-#ifdef __APPLE_API_OBSOLETE
/* Obsolete types */
#define DLIL_DESC_RAW 1
#define DLIL_DESC_802_2 2
* DLIL_DESC_802_2_SNAP - obsolete, data in variants.desc_802_2_SNAP
* protocol field in host byte order
*/
-#endif /* __APPLE_API_OBSOLETE */
+#endif KERNEL_PRIVATE
-/* Ehernet specific types */
+/* Ethernet specific types */
#define DLIL_DESC_ETYPE2 4
#define DLIL_DESC_SAP 5
#define DLIL_DESC_SNAP 6
* variants.native_type_length.
*/
+#ifdef KERNEL_PRIVATE
struct dlil_demux_desc {
TAILQ_ENTRY(dlil_demux_desc) next;
TAILQ_HEAD(ddesc_head_str, dlil_demux_desc);
-
struct dlil_proto_reg_str {
struct ddesc_head_str demux_desc_head;
u_long interface_family;
dl_event_func event;
dl_offer_func offer;
dl_ioctl_func ioctl;
- u_long reserved[4];
+ dl_detached_func detached;
+ u_long reserved[3];
};
-int dlil_attach_interface_filter(struct ifnet *ifnet_ptr,
- struct dlil_if_flt_str *interface_filter,
- u_long *filter_id,
- int insertion_point);
+int dlil_attach_filter(struct ifnet *ifp, const struct iff_filter *if_filter,
+ interface_filter_t *filter_ref);
+
+struct ifnet_stat_increment_param;
+
+int
+dlil_input_with_stats(struct ifnet *ifp, struct mbuf *m_head, struct mbuf *m_tail,
+ const struct ifnet_stat_increment_param *stats);
int
dlil_input(struct ifnet *ifp, struct mbuf *m_head, struct mbuf *m_tail);
int
-dlil_output(u_long dl_tag,
+dlil_output_list(
+ struct ifnet *ifp,
+ u_long protocol_family,
+ struct mbuf *packetlist,
+ caddr_t route,
+ const struct sockaddr *dest,
+ int raw);
+
+int
+dlil_output(
+ struct ifnet *ifp,
+ u_long protocol_family,
struct mbuf *m,
caddr_t route,
- struct sockaddr *dest,
+ const struct sockaddr *dest,
int raw);
u_long ioctl_code,
caddr_t ioctl_arg);
+errno_t
+dlil_resolve_multi(
+ struct ifnet *ifp,
+ const struct sockaddr *proto_addr,
+ struct sockaddr *ll_addr,
+ size_t ll_len);
+
+/*
+ * Send arp internal bypasses the check for
+ * IPv4LL.
+ */
+errno_t
+dlil_send_arp_internal(
+ ifnet_t ifp,
+ u_int16_t arpop,
+ const struct sockaddr_dl* sender_hw,
+ const struct sockaddr* sender_proto,
+ const struct sockaddr_dl* target_hw,
+ const struct sockaddr* target_proto);
+
+errno_t
+dlil_send_arp(
+ ifnet_t ifp,
+ u_int16_t arpop,
+ const struct sockaddr_dl* sender_hw,
+ const struct sockaddr* sender_proto,
+ const struct sockaddr_dl* target_hw,
+ const struct sockaddr* target_proto);
+
+int
+dlil_ioctl_locked(u_long proto_family,
+ struct ifnet *ifp,
+ u_long ioctl_code,
+ caddr_t ioctl_arg);
+
int
-dlil_attach_protocol(struct dlil_proto_reg_str *proto,
- u_long *dl_tag);
+dlil_attach_protocol(struct dlil_proto_reg_str *proto);
int
-dlil_detach_protocol(u_long dl_tag);
+dlil_detach_protocol(struct ifnet *ifp, u_long protocol_family);
int
dlil_if_attach(struct ifnet *ifp);
+#ifdef BSD_KERNEL_PRIVATE
+
int
-dlil_attach_protocol_filter(u_long dl_tag,
- struct dlil_pr_flt_str *proto_filter,
- u_long *filter_id,
- int insertion_point);
+dlil_if_attach_with_address(
+ struct ifnet *ifp,
+ const struct sockaddr_dl *ll_addr);
+
int
-dlil_detach_filter(u_long filter_id);
+dlil_attach_protocol_kpi(ifnet_t ifp, protocol_family_t protocol,
+ const struct ifnet_attach_proto_param *proto_details);
+
+errno_t dlil_set_bpf_tap(ifnet_t ifp, bpf_tap_mode mode,
+ bpf_packet_func callback);
+
+#endif
+
+void
+dlil_detach_filter(interface_filter_t filter);
struct dlil_ifmod_reg_str {
int (*add_if)(struct ifnet *ifp);
int (*del_if)(struct ifnet *ifp);
- int (*add_proto)(struct ddesc_head_str *demux_desc_head,
- struct if_proto *proto, u_long dl_tag);
- int (*del_proto)(struct if_proto *proto, u_long dl_tag);
- int (*ifmod_ioctl)(struct ifnet *ifp, u_long ioctl_cmd, caddr_t data);
- int (*shutdown)();
+ int (*add_proto)(struct ifnet *ifp, u_long protocol_family,
+ struct ddesc_head_str *demux_desc_head);
+#ifdef __KPI_INTERFACE__
+ ifnet_del_proto_func del_proto;
+ ifnet_ioctl_func ifmod_ioctl;
+#else
+ void* del_proto;
+ void* ifmod_ioctl;
+#endif
+ int (*shutdown)(void);
int (*init_if)(struct ifnet *ifp);
u_long reserved[3];
};
int dlil_reg_if_modules(u_long interface_family,
struct dlil_ifmod_reg_str *ifmod_reg);
+/*
+
+Function : dlil_reg_proto_module
+
+ A DLIL protocol module is a piece of code that know how to handle a certain type
+ of protocol (PF_INET, PF_INET6, ...) for a certain family of interface (APPLE_IF_FAM_ETHERNET,
+ APPLE_IF_FAM_PPP, ...).
+
+ dlil_reg_proto_module() allows the registration of such a protocol/interface handler before any
+ interface is attached.
+ Typically, the attach and detach function of the protocol handler will call
+ dlil_{attach/detach}_protocol with the parameter specific to the protocol.
+
+ The goal of this modules is to insulate the actual protocol (IP, IPv6) from the DLIL details.
+
+Parameters :
+ 'protocol_family' is PF_INET, PF_INET6, ...
+ 'interface_family' is APPLE_IF_FAM_ETHERNET, APPLE_IF_FAM_PPP, ...
+ 'protomod_reg' is the protocol registration structure.
+ 'attach_proto' funtion is mandatory.
+ 'detach_proto' funtion is optional (DLIL will manage it).
+
+Return code :
+
+0 :
+
+ No error.
+
+ENOMEM:
+
+ No memory can be allocated for internal data structure.
+
+EEXIST:
+
+ The protocol family has already been registered for this interface family.
+
+EINVAL:
+
+ The dlil_protomod_reg_str structure contains incorrect values.
+
+*/
+
+int dlil_reg_proto_module(u_long protocol_family, u_long interface_family,
+ int (*attach)(struct ifnet *ifp, u_long protocol_family),
+ int (*detach)(struct ifnet *ifp, u_long protocol_family));
+
+/*
+
+Function : dlil_dereg_proto_module
+
+ dlil_dereg_proto_module() will unregister the protocol module previously
+ registered with dlil_dereg_proto_module().
+
+ There is no restriction when to call it.
+ Interfaces or protoco can be attached, it will not prevent the deregistration of the module.
+
+Parameters :
+ 'protocol_family' is PF_INET, PF_INET6, ...
+ 'interface_family' is APPLE_IF_FAM_ETHERNET, APPLE_IF_FAM_PPP, ...
+
+Return code :
+
+0 :
+
+ No error.
+
+ENOENT:
+
+ No module was registered..
+
+*/
+
+int dlil_dereg_proto_module(u_long protocol_family, u_long interface_family);
+
+/*
+
+Function : dlil_plumb_protocol
+
+ dlil_plumb_protocol() will plumb a protocol to an actual interface.
+ This will find a registered protocol module and call its attach function.
+ The module will typically call dlil_attach_protocol with the appropriate parameters.
+
+Parameters :
+ 'protocol_family' is PF_INET, PF_INET6, ...
+ 'ifp' is the interface to plumb the protocol to.
+
+Return code :
+
+0 :
+
+ No error.
+
+ENOENT:
+
+ No module was registered.
+
+other:
+
+ Error returned by the attach_proto function
+
+*/
+int dlil_plumb_protocol(u_long protocol_family, struct ifnet *ifp);
+
+/*
+
+Function : dlil_unplumb_protocol
+
+ dlil_unplumb_protocol() will unplumb a protocol from an interface.
+ This will find a registered protocol module and call its detach function.
+ The module will typically call dlil_detach_protocol with the appropriate parameters.
+ If no module is found, this function will call dlil_detach_protocol directly.
+
+Parameters :
+ 'protocol_family' is PF_INET, PF_INET6, ...
+ 'ifp' is APPLE_IF_FAM_ETHERNET, APPLE_IF_FAM_PPP, ...
+
+Return code :
+
+0 :
+
+ No error.
+
+ENOENT:
+
+ No module was registered.
+
+other:
+
+ Error returned by the attach_proto function
+
+*/
+int dlil_unplumb_protocol(u_long protocol_family, struct ifnet *ifp);
+
int
dlil_inject_if_input(struct mbuf *m, char *frame_header, u_long from_id);
int
dlil_inject_if_output(struct mbuf *m, u_long from_id);
-int
-dlil_find_dltag(u_long if_family, short unit, u_long proto_family, u_long *dl_tag);
-
+#ifdef KERNEL_PRIVATE
+void
+dlil_post_msg(struct ifnet *ifp,u_long event_subclass, u_long event_code,
+ struct net_event_data *event_data, u_long event_data_len);
+#endif
int
dlil_event(struct ifnet *ifp, struct kern_event_msg *event);
int
dlil_if_detach(struct ifnet *ifp);
+void
+ifp_reference(struct ifnet *ifp);
+
+void
+ifp_release(struct ifnet *ifp);
+
/*
*/
-int dlil_if_acquire(u_long family, void *uniqueid, size_t uniqueid_len,
+int dlil_if_acquire(u_long family, const void *uniqueid, size_t uniqueid_len,
struct ifnet **ifp);
The if_eflags IF_INUSE will be cleared.
The fields if_output, if_ioctl, if_free and if_set_bpf_tap will be changed
to point to DLIL private functions.
- After calling dlil_if_acquire, the driver can safely terminate and
+ After calling dlil_if_release, the driver can safely terminate and
unload if necessary.
- Note : if the call to dlil_if_detach returns DLIL_WAIT_FOR_FREE, the
- driver can safely ignore it and call dlil_if_release.
+ Note: your driver should only call dlil_if_release once your if_free
+ function has been called.
Parameters :
ifp is the pointer to the ifnet to release.
void dlil_if_release(struct ifnet *ifp);
-#endif /* __APPLE_API_UNSTABLE */
+#endif /* KERNEL_PRIVATE */
+#endif /* KERNEL */
#endif /* DLIL_H */
projects / apple / xnu.git / blobdiff