xnu-792.25.20.tar.gz

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

diff --git a/bsd/net/ndrv.h b/bsd/net/ndrv.h
index 7140ed56c43506b8a39e3639709db0b2d696c1c7..6aa8e14bd7e29616442c202cfd58a171e70220b3 100644 (file)
--- a/bsd/net/ndrv.h
+++ b/bsd/net/ndrv.h
@@ -28,6 +28,7 @@
 
 #ifndef _NET_NDRV_H
 #define _NET_NDRV_H
+#include <sys/appleapiopts.h>
 
 
 struct sockaddr_ndrv
@@ -41,9 +42,9 @@ struct sockaddr_ndrv
  * Support for user-mode protocol handlers
  */
 
-#define NDRV_DEMUXTYPE_ETHERTYPE       DLIL_DESC_ETYPE2
-#define        NDRV_DEMUXTYPE_SAP                      DLIL_DESC_SAP
-#define NDRV_DEMUXTYPE_SNAP                    DLIL_DESC_SNAP
+#define NDRV_DEMUXTYPE_ETHERTYPE       4
+#define        NDRV_DEMUXTYPE_SAP                      5
+#define NDRV_DEMUXTYPE_SNAP                    6
 
 #define        NDRVPROTO_NDRV                          0
 
@@ -114,14 +115,32 @@ struct ndrv_protocol_desc
 };
 
 #define SOL_NDRVPROTO          NDRVPROTO_NDRV  /* Use this socket level */
-/*             NDRV_DMXSPEC            0x01                       Obsolete */
 #define NDRV_DELDMXSPEC                0x02                    /* Delete the registered protocol */
-/*             NDRV_DMXSPECCNT         0x03                       Obsolete */
 #define NDRV_SETDMXSPEC                0x04                    /* Set the protocol spec */
+#define        NDRV_ADDMULTICAST       0x05                    /* Add a physical multicast address */
+#define NDRV_DELMULTICAST      0x06                    /* Delete a phyiscal multicast */
 
-#if KERNEL
-/* Additional Kernel APIs */
-struct ifnet*  ndrv_get_ifp(caddr_t ndrv_pcb);
-#endif
+/*
+ * SOL_NDRVPROTO - use this for the socket level when calling setsocketopt
+ * NDRV_DELDMXSPEC - removes the registered protocol and all related demuxes
+ * NDRV_SETDMXSPEC - set the protocol to receive, use struct ndrv_protocol_desc
+ *                                      as the parameter.
+ * NDRV_ADDMULTICAST - Enable reception of a phyiscal multicast address, use
+ *                     a sockaddr of the appropriate type for the media in use.
+ * NDRV_DELMULTICAST - Disable reception of a phyiscal multicast address, use
+ *                                        a sockaddr of the appropriate type for the media in use.
+ *
+ * When adding multicasts, the multicasts are ref counted. If the multicast is
+ * already registered in the kernel, the count will be bumped. When deleting
+ * the multicast, the count is decremented. If the count reaches zero the
+ * multicast is removed. If your process is killed, PF_NDRV will unregister
+ * the mulitcasts you've added. You can only delete multicasts you've added
+ * on the same socket.
+ *
+ * If the interface goes away while your socket is open, your protocol is
+ * immediately detached and sending/receiving is disabled on the socket.
+ * If you need a chance to do something, please file a bug and we can give
+ * you a second or two.
+ */
 
 #endif /* _NET_NDRV_H */