Changeset 27973 in vbox for trunk/include

Timestamp:

Apr 4, 2010 12:33:03 AM (15 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

59679

Message:

PDM,Network/*: GSO preps.

Location:

trunk/include/VBox

Files:

• pdmnetifs.h (modified) (6 diffs)
• types.h (modified) (1 diff)

trunk/include/VBox/pdmnetifs.h

@@ -86 +86 @@
 /** Owner mask. */
 #define PDMSCATTERGATHER_FLAGS_OWNER_MASK   UINT32_C(0x00000003)
+/** Mask of flags available to general use.
+ * The parties using the SG must all agree upon how to use these of course. */
+#define PDMSCATTERGATHER_FLAGS_AVL_MASK     UINT32_C(0x0000f000)
+/** Flags reserved for future use, MBZ. */
+#define PDMSCATTERGATHER_FLAGS_RVD_MASK     UINT32_C(0x00000ff8)
 /** @} */
 
@@ -135 +140 @@
      */
     DECLR3CALLBACKMEMBER(int, pfnReceive,(PPDMINETWORKDOWN pInterface, const void *pvBuf, size_t cb));
-
 
     /**
@@ -145 +149 @@
      *
      * @param   pInterface      Pointer to this interface.
-     * @param   pSgBuf          Scatter/gather buffer of the size previously
-     *                          requested.  Pass to PDMINETWORKUP::pfnSendBuf or
-     *                          PDMINETWORKUP::pfnFreeBuf.
-     *
      * @thread  Non-EMT.
      */
@@ -195 +195 @@
      *          but there could of course be races.
      *
-     * @param   pInterface      Pointer to the interface structure containing the called function pointer.
+     * @param   pInterface      Pointer to the interface structure containing the
+     *                          called function pointer.
      * @param   cbMin           The minimum buffer size.
+     * @param   pGso            Pointer to a GSO context (only reference while in
+     *                          this call).  NULL indicates no segmentation
+     *                          offloading.  PDMSCATTERGATHER::pvUser is used to
+     *                          indicate that a network SG uses GSO, usually by
+     *                          pointing to a copy of @a pGso.
      * @param   ppSgBuf         Where to return the buffer.  The buffer will be
      *                          owned by the caller, designation owner number 1.
@@ -202 +208 @@
      * @thread  Any, but normally EMT.
      */
-    DECLR3CALLBACKMEMBER(int, pfnAllocBuf,(PPDMINETWORKUP pInterface, size_t cbMin, PPPDMSCATTERGATHER ppSgBuf));
+    DECLR3CALLBACKMEMBER(int, pfnAllocBuf,(PPDMINETWORKUP pInterface, size_t cbMin, PCPDMNETWORKGSO pGso,
+                                           PPPDMSCATTERGATHER ppSgBuf));
 
     /**
@@ -278 +285 @@
 } PDMINETWORKUP;
 /** PDMINETWORKUP interface ID. */
-#define PDMINETWORKUP_IID                       "f915243e-801a-4868-8979-b6b8594b09cc"
+#define PDMINETWORKUP_IID                       "0e603bc1-3016-41b4-b521-15c038cda16a"
 
 

trunk/include/VBox/types.h

@@ -738 +738 @@
 
 /**
+ * Forms of generic segment offloading.
+ */
+typedef enum PDMNETWORKGSOTYPE
+{
+    /** Invalid zero value. */
+    PDMNETWORKGSOTYPE_INVALID = 0,
+    /** TCP/IPv4. */
+    PDMNETWORKGSOTYPE_IPV4_TCP,
+#if 0 /* later */
+    /** TCP/IPv6. */
+    PDMNETWORKGSOTYPE_IPV6_TCP,
+    /** UDP/IPv4. */
+    PDMNETWORKGSOTYPE_IPV4_UDP,
+    /** UDP/IPv6. */
+    PDMNETWORKGSOTYPE_IPV6_UDP,
+    /** IPv6 over IPv4 tunneling. */
+    PDMNETWORKGSOTYPE_IPV4_TCPV6,
+    /** TCP/IPv6 over IPv4 tunneling.
+     * The header offsets and sizes relates to IPv4 and TCP, the IPv6 header is
+     * figured out as needed.
+     * @todo Needs checking against facts, this is just an outline of the idea. */
+    PDMNETWORKGSOTYPE_IPV4_TCPV6_TCP,
+    /** UDP/IPv6 over IPv4 tunneling.
+     * The header offsets and sizes relates to IPv4 and UDP, the IPv6 header is
+     * figured out as needed.
+     * @todo Needs checking against facts, this is just an outline of the idea. */
+    PDMNETWORKGSOTYPE_IPV4_TCPV6_UDP,
+#endif
+    /** The end of valid GSO types. */
+    PDMNETWORKGSOTYPE_END
+} PDMNETWORKGSOTYPE;
+
+
+/**
+ * Generic segment offloading context.
+ *
+ * We generally follow the E1000 specs wrt to which header fields we change.
+ * However the GSO type implies where the checksum fields are and that they are
+ * always updated from scratch (no half done pseudo checksums).
+ *
+ * @remarks This is part of the internal network GSO packets.  Take great care
+ *          when making changes.  The size is expected to be exactly 8 bytes.
+ */
+typedef struct PDMNETWORKGSO
+{
+    /** The type of segmentation offloading we're performing (PDMNETWORKGSOTYPE). */
+    uint8_t             u8Type;
+    /** The total header size. */
+    uint8_t             cbHdrs;
+    /** The max segment size (MSS) to apply. */
+    uint16_t            cbMaxSeg;
+
+    /** Offset of the first header (IPv4 / IPv6). */
+    uint8_t             offHdr1;
+    /** The size of the first header (IPv4 / IPv6). */
+    uint8_t             cbHdr1;
+
+    /** Offset of the second header (TCP / UDP). */
+    uint8_t             offHdr2;
+    /** The size of the second header (TCP / UDP). */
+    uint8_t             cbHdr2;
+} PDMNETWORKGSO;
+/** Pointer to a GSO context. */
+typedef PDMNETWORKGSO *PPDMNETWORKGSO;
+/** Pointer to a const GSO context. */
+typedef PDMNETWORKGSO const *PCPDMNETWORKGSO;
+
+
+/**
  * The current ROM page protection.
  *