DrvTAPOs2.cpp revision 45ea16ba0edc801c40f7fad732d071ac388b439d
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/** $Id$ */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/** @file
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * VBox network devices: OS/2 TAP network transport driver.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/*
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste *
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * Copyright (C) 2006-2007 Sun Microsystems, Inc.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste *
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * This file is part of VirtualBox Open Source Edition (OSE), as
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * available from http://www.virtualbox.org. This file is free software;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * you can redistribute it and/or modify it under the terms of the GNU
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * General Public License (GPL) as published by the Free Software
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * Foundation, in version 2 as it comes in the "COPYING" file of the
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste *
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * Clara, CA 95054 USA or visit http://www.sun.com if you need
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * additional information or have any questions.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/*******************************************************************************
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste* Header Files *
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste*******************************************************************************/
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste#define LOG_GROUP LOG_GROUP_DRV_TUN
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste#include <VBox/pdmdrv.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/assert.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/file.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/string.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/thread.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/alloca.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include <iprt/asm.h>
f98586c941297abc552ef48985827a399b1c7048Jaco Jooste#include <iprt/semaphore.h>
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste#include "Builtins.h"
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste#define INCL_BASE
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste#include <os2.h>
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste#include "DrvTAPOs2.h"
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/*******************************************************************************
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste* Structures and Typedefs *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste*******************************************************************************/
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste/**
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * Block driver instance data.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste */
7cbae22b7560eefcf086863923459880aa87f014Jaco Joostetypedef struct DRVTAPOS2
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste{
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** The network interface. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste PDMINETWORKCONNECTOR INetworkConnector;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** The network interface. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste PPDMINETWORKPORT pPort;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** Pointer to the driver instance. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste PPDMDRVINS pDrvIns;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** TAP device file handle. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste RTFILE hDevice;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** Out LAN number. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste int32_t iLan;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** The LAN number we're connected to. -1 if not connected. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste int32_t iConnectedTo;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** Receiver thread. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste PPDMTHREAD pThread;
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste /** Set if the link is down.
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * When the link is down all incoming packets will be dropped. */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste bool volatile fLinkDown;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** The log and thread name. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste char szName[16];
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** The \DEV\TAP$ device name. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey char szDevice[32];
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey#ifdef VBOX_WITH_STATISTICS
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** Number of sent packets. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAMCOUNTER StatPktSent;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** Number of sent bytes. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAMCOUNTER StatPktSentBytes;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** Number of received packets. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAMCOUNTER StatPktRecv;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** Number of received bytes. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAMCOUNTER StatPktRecvBytes;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** Profiling packet transmit runs. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste STAMPROFILE StatTransmit;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** Profiling packet receive runs. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste STAMPROFILEADV StatReceive;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste#endif /* VBOX_WITH_STATISTICS */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
ec9620c671467d796eb3f86c50401dafe7da2a3dCraig McDonnell#ifdef LOG_ENABLED
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /** The nano ts of the last transfer. */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey uint64_t u64LastTransferTS;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /** The nano ts of the last receive. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste uint64_t u64LastReceiveTS;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey#endif
d1223bcffd2990e20fa832378b5825504fab5721Brian Bailey} DRVTAPOS2, *PDRVTAPOS2;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste/** Converts a pointer to TAP::INetworkConnector to a PRDVTAP. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste#define PDMINETWORKCONNECTOR_2_DRVTAPOS2(pInterface) ( (PDRVTAPOS2)((uintptr_t)pInterface - RT_OFFSETOF(DRVTAPOS2, INetworkConnector)) )
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey/**
d1223bcffd2990e20fa832378b5825504fab5721Brian Bailey * Send data to the network.
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey *
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey * @returns VBox status code.
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey * @param pInterface Pointer to the interface structure containing the called function pointer.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pvBuf Data to send.
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey * @param cb Number of bytes to send.
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey * @thread EMT
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Baileystatic DECLCALLBACK(int) drvTAPOs2Send(PPDMINETWORKCONNECTOR pInterface, const void *pvBuf, size_t cb)
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey{
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDRVTAPOS2 pThis = PDMINETWORKCONNECTOR_2_DRVTAPOS2(pInterface);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAM_COUNTER_INC(&pThis->StatPktSent);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAM_COUNTER_ADD(&pThis->StatPktSentBytes, cb);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey STAM_PROFILE_START(&pThis->StatTransmit, a);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * If the pvBuf is a high address, we'll have to copy it onto a
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * stack buffer of the tap driver will trap.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste if ((uintptr_t)pvBuf >= _1M*512)
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste {
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste void *pvBufCopy = alloca(cb);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste memcpy(pvBufCopy, pvBuf, cb);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pvBuf = pvBufCopy;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste }
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste#ifdef LOG_ENABLED
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste uint64_t u64Now = RTTimeProgramNanoTS();
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste LogFlow(("%s: Send: %-4d bytes at %RU64 ns deltas: recv=%RU64 xmit=%RU64\n", pThis->szName,
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste cb, u64Now, u64Now - pThis->u64LastReceiveTS, u64Now - pThis->u64LastTransferTS));
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->u64LastTransferTS = u64Now;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste Log2(("%s Send: pvBuf=%p cb=%#zx\n"
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste "%.*Vhxd\n",
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->szName, pvBuf, cb, cb, pvBuf));
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste#endif
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste ULONG Parm[2] = { ~0UL, ~0UL }; /* mysterious output */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste ULONG cbParm = sizeof(Parm);
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste ULONG cbData = cb;
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste int rc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_WRITE_PACKET,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste &Parm[0], cbParm, &cbParm,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste (void *)pvBuf, cbData, &cbData);
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste if (RT_UNLIKELY(rc || Parm[0]))
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste {
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste static unsigned cComplaints = 0;
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste if (cComplaints++ < 256)
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste LogRel(("%s: send failed. rc=%d Parm={%ld,%ld} cb=%d\n",
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste pThis->szName, rc, Parm[0], Parm[1], cb));
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste if (rc)
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste rc = RTErrConvertFromOS2(rc);
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste else
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste rc = VERR_IO_GEN_FAILURE;
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste }
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste Log3(("%s: Send completed %d ns\n", pThis->szName, RTTimeProgramNanoTS() - pThis->u64LastTransferTS));
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste STAM_PROFILE_STOP(&pThis->StatTransmit, a);
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste AssertRC(rc);
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste return rc;
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste}
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste/**
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Set promiscuous mode.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste *
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste * This is called when the promiscuous mode is set. This means that there doesn't have
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * to be a mode change when it's called.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey *
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @param pInterface Pointer to the interface structure containing the called function pointer.
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian * @param fPromiscuous Set if the adaptor is now in promiscuous mode. Clear if it is not.
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian * @thread EMT
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian */
49a10996acfcd6a5a04b7077ca84126f856a4f56Brianstatic DECLCALLBACK(void) drvTAPOs2SetPromiscuousMode(PPDMINETWORKCONNECTOR pInterface, bool fPromiscuous)
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian{
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian PDRVTAPOS2 pThis = PDMINETWORKCONNECTOR_2_DRVTAPOS2(pInterface);
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian LogFlow(("%s: SetPromiscuousMode: fPromiscuous=%d\n", pThis->szName, fPromiscuous));
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian NOREF(pThis);
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian /** @todo is it always in promiscuous mode? */
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian}
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian/**
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian * Notification on link status changes.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey *
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @param pInterface Pointer to the interface structure containing the called function pointer.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @param enmLinkState The new link state.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @thread EMT
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Baileystatic DECLCALLBACK(void) drvTAPOs2NotifyLinkChanged(PPDMINETWORKCONNECTOR pInterface, PDMNETWORKLINKSTATE enmLinkState)
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey{
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey PDRVTAPOS2 pThis = PDMINETWORKCONNECTOR_2_DRVTAPOS2(pInterface);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey bool fLinkDown;
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey switch (enmLinkState)
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey {
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey case PDMNETWORKLINKSTATE_DOWN:
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey case PDMNETWORKLINKSTATE_DOWN_RESUME:
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey fLinkDown = true;
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey break;
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey default:
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey AssertMsgFailed(("enmLinkState=%d\n", enmLinkState));
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey case PDMNETWORKLINKSTATE_UP:
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey fLinkDown = false;
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian break;
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian }
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian LogFlow(("%s: NotifyLinkChanged: enmLinkState=%d %d->%d\n", pThis->szName, pThis->fLinkDown, fLinkDown));
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian ASMAtomicXchgBool(&pThis->fLinkDown, fLinkDown);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey}
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey/**
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * Receiver thread.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey *
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @returns VBox status code. Returning failure will naturally terminate the thread.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @param pDrvIns The pcnet device instance.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * @param pThread The thread.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
49a10996acfcd6a5a04b7077ca84126f856a4f56Brianstatic DECLCALLBACK(int) drvTAPOs2ReceiveThread(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian{
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian PDRVTAPOS2 pThis = PDMINS2DATA(pDrvIns, PDRVTAPOS2);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey /*
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * No initialization work to do, just return immediately.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey if (pThread->enmState == PDMTHREADSTATE_INITIALIZING)
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey return VINF_SUCCESS;
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey Assert(pThread->enmState == PDMTHREADSTATE_RUNNING);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey /*
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * Loop while the thread is running, quit immediately when
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * we're supposed to suspend or terminate.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey while (pThread->enmState == PDMTHREADSTATE_RUNNING)
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey {
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey /*
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey * Read a frame, this will block for a while if nothing to read.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey char abBuf[4096];
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey ULONG Parm[2] = { ~0UL, ~0UL }; /* mysterious output */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey ULONG cbParm = sizeof(Parm); /* this one is actually ignored... */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey ULONG cbBuf = sizeof(abBuf);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey int rc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_READ_PACKET,
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey &Parm[0], cbParm, &cbParm,
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey &abBuf[0], cbBuf, &cbBuf);
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey if (pThread->enmState != PDMTHREADSTATE_RUNNING)
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey break;
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey const size_t cbRead = Parm[1];
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey if ( !rc
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey && !Parm[0]
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste && cbRead > 0 /* cbRead */)
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste {
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste AssertMsg(cbRead <= 1536, ("cbRead=%d\n", cbRead));
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Wait for the device to have some room. A return code != VINF_SUCCESS
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * means that we were woken up during a VM state transition. Drop the
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * current packet and wait for the next one.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste rc = pThis->pPort->pfnWaitReceiveAvail(pThis->pPort, RT_INDEFINITE_WAIT);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste if (RT_FAILURE(rc))
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste continue;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Pass the data up.
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey#ifdef LOG_ENABLED
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste uint64_t u64Now = RTTimeProgramNanoTS();
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogFlow(("%s: ReceiveThread: %-4d bytes at %RU64 ns deltas: recv=%RU64 xmit=%RU64\n", pThis->szName,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste cbRead, u64Now, u64Now - pThis->u64LastReceiveTS, u64Now - pThis->u64LastTransferTS));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->u64LastReceiveTS = u64Now;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste#endif
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste Log2(("%s: ReceiveThread: cbRead=%#x\n"
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste "%.*Vhxd\n",
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->szName, cbRead, cbRead, abBuf));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste STAM_COUNTER_INC(&pThis->StatPktRecv);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste STAM_COUNTER_ADD(&pThis->StatPktRecvBytes, cbRead);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste rc = pThis->pPort->pfnReceive(pThis->pPort, abBuf, cbRead);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste AssertRC(rc);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /* we'll be returning ~1 per second with no data; rc=0 Parm[0] = 1, Parm[1] = 0. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste else if (rc)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste {
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogFlow(("%s: ReceiveThread: DoDevIOCtl -> %s Parm={%ld, %ld}\n",
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->szName, rc, Parm[0], Parm[1]));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste rc = RTErrConvertFromOS2(rc);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (rc == VERR_INVALID_HANDLE)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return rc;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste RTThreadYield();
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /* The thread is being suspended or terminated. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return VINF_SUCCESS;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste}
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste/**
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Unblock the send thread so it can respond to a state change.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @returns VBox status code.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pDrvIns The pcnet device instance.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pThread The send thread.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Joostestatic DECLCALLBACK(int) drvTAPOs2WakeupReceiveThread(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste{
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDRVTAPOS2 pThis = PDMINS2DATA(pDrvIns, PDRVTAPOS2);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogFlow(("%s: WakeupReceiveThread\n", pThis->szName));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /* cancel any pending reads */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG Parm[2] = { ~0UL, ~0UL }; /* mysterious output */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG cbParm = sizeof(Parm);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG Data = pThis->iLan; /* right? */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG cbData = sizeof(Data);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste int orc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_CANCEL_READ,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste &Parm[0], cbParm, &cbParm,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste &Data, cbData, &cbData);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste AssertMsg(orc == 0, ("%d\n", orc)); NOREF(orc);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return VINF_SUCCESS;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste}
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste/**
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Queries an interface to the driver.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @returns Pointer to interface.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @returns NULL if the interface was not supported by the driver.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pInterface Pointer to this interface structure.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param enmInterface The requested interface identification.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @thread Any thread.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Joostestatic DECLCALLBACK(void *) drvTAPOs2QueryInterface(PPDMIBASE pInterface, PDMINTERFACE enmInterface)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste{
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDRVTAPOS2 pThis = PDMINS2DATA(pDrvIns, PDRVTAPOS2);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste switch (enmInterface)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste {
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste case PDMINTERFACE_BASE:
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return &pDrvIns->IBase;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste case PDMINTERFACE_NETWORK_CONNECTOR:
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return &pThis->INetworkConnector;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste default:
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return NULL;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste}
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste/**
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Destruct a driver instance.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Most VM resources are freed by the VM. This callback is provided so that any non-VM
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * resources can be freed correctly.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pDrvIns The driver instance data.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Joostestatic DECLCALLBACK(void) drvTAPOs2Destruct(PPDMDRVINS pDrvIns)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste{
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDRVTAPOS2 pThis = PDMINS2DATA(pDrvIns, PDRVTAPOS2);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogFlow(("%s: Destruct\n", pThis->szName));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /* PDM will destroy the thread for us, it's suspended right now. */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /*
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Disconnect from the lan if we made a connection and close it.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (pThis->iConnectedTo != -1)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste {
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG Parm[2] = { ~0UL, ~0UL }; /* mysterious output */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG cbParm = sizeof(Parm);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG Data = pThis->iConnectedTo;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste ULONG cbData = sizeof(Data);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste int orc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_DISCONNECT_NIC,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste &Parm, cbParm, &cbParm,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste &Data, cbData, &cbData);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if ( orc
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste || Parm[0])
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogRel(("%s: Failed to disconnect %d from %d! orc=%d Parm={%ld,%ld}\n",
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->szName, pThis->iLan, pThis->iConnectedTo, orc, Parm[0], Parm[1]));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->iConnectedTo = -1;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (pThis->hDevice != NIL_RTFILE)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste {
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste int rc = RTFileClose(pThis->hDevice);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste AssertRC(rc);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste pThis->hDevice = NIL_RTFILE;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste}
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste/**
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Construct a TAP network transport driver instance.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste *
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @returns VBox status.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pDrvIns The driver instance data.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * If the registration structure is needed, pDrvIns->pDrvReg points to it.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * @param pCfgHandle Configuration node handle for the driver. Use this to obtain the configuration
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * of the driver instance. It's also found in pDrvIns->pCfgHandle, but like
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * iInstance it's expected to be used a bit in this function.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Joostestatic DECLCALLBACK(int) drvTAPOs2Construct(PPDMDRVINS pDrvIns, PCFGMNODE pCfgHandle)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste{
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDRVTAPOS2 pThis = PDMINS2DATA(pDrvIns, PDRVTAPOS2);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Init the static parts.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->pDrvIns = pDrvIns;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->hDevice = NIL_RTFILE;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->iLan = -1;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->iConnectedTo = -1;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->pThread = NULL;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste RTStrPrintf(pThis->szName, sizeof(pThis->szName), "TAP%d", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /* IBase */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pDrvIns->IBase.pfnQueryInterface = drvTAPOs2QueryInterface;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /* INetwork */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->INetworkConnector.pfnSend = drvTAPOs2Send;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->INetworkConnector.pfnSetPromiscuousMode = drvTAPOs2SetPromiscuousMode;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->INetworkConnector.pfnNotifyLinkChanged = drvTAPOs2NotifyLinkChanged;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Validate the config.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste if (!CFGMR3AreValuesValid(pCfgHandle, "Device\0ConnectTo\0"))
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_DRVINS_UNKNOWN_CFG_VALUES, "");
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Check that no-one is attached to us.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste int rc = pDrvIns->pDrvHlp->pfnAttach(pDrvIns, NULL);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste if (rc != VERR_PDM_NO_ATTACHED_DRIVER)
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_DRVINS_NO_ATTACH,
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste N_("Configuration error: Cannot attach drivers to the TAP driver"));
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Query the network port interface.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste pThis->pPort = (PPDMINETWORKPORT)pDrvIns->pUpBase->pfnQueryInterface(pDrvIns->pUpBase, PDMINTERFACE_NETWORK_PORT);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste if (!pThis->pPort)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_MISSING_INTERFACE_ABOVE,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste N_("Configuration error: The above device/driver didn't export the network port interface"));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste /*
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste * Read the configuration.
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste */
7cbae22b7560eefcf086863923459880aa87f014Jaco Jooste rc = CFGMR3QueryString(pCfgHandle, "Device", &pThis->szDevice[0], sizeof(pThis->szDevice));
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste if (rc == VERR_CFGM_VALUE_NOT_FOUND)
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste strcpy(pThis->szDevice, "\\DEV\\TAP$");
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste else if (VBOX_FAILURE(rc))
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste return PDMDRV_SET_ERROR(pDrvIns, rc,
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste N_("Configuration error: Query for \"Device\" failed"));
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste int32_t iConnectTo;
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste rc = CFGMR3QueryS32(pCfgHandle, "ConnectTo", &iConnectTo);
f98586c941297abc552ef48985827a399b1c7048Jaco Jooste if (rc == VERR_CFGM_VALUE_NOT_FOUND)
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste iConnectTo = -1;
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste else if (VBOX_FAILURE(rc))
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste return PDMDRV_SET_ERROR(pDrvIns, rc,
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste N_("Configuration error: Query for \"ConnectTo\" failed"));
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste /*
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste * Open the device.
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste * Keep in mind that the destructor is always called!
f1f35895dc6dc528d590c6077b0bbae248bc0fd8Jaco Jooste */
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste rc = RTFileOpen(&pThis->hDevice, pThis->szDevice, RTFILE_O_DENY_NONE | RTFILE_O_READ);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (VBOX_FAILURE(rc))
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return PDMDrvHlpVMSetError(pDrvIns, rc, RT_SRC_POS,
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste N_("Failed to open tap device '%s'"), pThis->szDevice);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste ULONG Parm[2] = { ~0UL, ~0UL }; /* mysterious output */
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste ULONG cbParm = sizeof(Parm);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste ULONG Data = ~0UL;
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste ULONG cbData = sizeof(Data);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste int orc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_GET_LAN_NUMBER,
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste &Parm, cbParm, &cbParm,
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste &Data, cbData, &cbData);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste if (orc)
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste rc = RTErrConvertFromOS2(orc);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste else if (Parm[0])
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste rc = VERR_GENERAL_FAILURE;
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste if (VBOX_FAILURE(rc))
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste return PDMDrvHlpVMSetError(pDrvIns, rc, RT_SRC_POS,
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste N_("Failed to query LanNumber! orc=%d Parm={%ld,%ld}"),
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste orc, Parm[0], Parm[1]);
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste pThis->iLan = (int32_t)Data;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste Log(("%s: iLan=%d Parm[1]=%ld\n", pThis->szName, pThis->iLan, Parm[1]));
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste /*
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste * Connect it requested.
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (iConnectTo != -1)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste {
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey if (iConnectTo == pThis->iLan)
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey return PDMDrvHlpVMSetError(pDrvIns, VERR_INVALID_PARAMETER, RT_SRC_POS,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey N_("Cannot connect to ourself (%d)"), iConnectTo);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey Parm[0] = Parm[1] = ~0UL; /* mysterious output */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey cbParm = sizeof(Parm);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey Data = iConnectTo;
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey cbData = sizeof(Data);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste int orc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_CONNECT_NIC,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey &Parm, cbParm, &cbParm,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey &Data, cbData, &cbData);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey if (orc)
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey rc = RTErrConvertFromOS2(orc);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste else if (Parm[0])
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste rc = VERR_GENERAL_FAILURE;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste if (VBOX_FAILURE(rc))
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste return PDMDrvHlpVMSetError(pDrvIns, rc, RT_SRC_POS,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey N_("Failed to connect %d to %d! orc=%d Parm={%ld,%ld}"),
ec9620c671467d796eb3f86c50401dafe7da2a3dCraig McDonnell pThis->iLan, iConnectTo, orc, Parm[0], Parm[1]);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey Log(("%s: Connected to %d\n", pThis->szName, iConnectTo));
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey pThis->iConnectedTo = iConnectTo;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste }
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /*
d1223bcffd2990e20fa832378b5825504fab5721Brian Bailey * Log the config.
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey */
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey Parm[0] = Parm[1] = ~0UL; /* mysterious output */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste PDMMAC Mac;
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste cbParm = sizeof(Parm);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey cbData = sizeof(Mac);
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste orc = DosDevIOCtl(pThis->hDevice, PROT_CATEGORY, TAP_READ_MAC_ADDRESS,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey &Parm[0], cbParm, &cbParm,
d1223bcffd2990e20fa832378b5825504fab5721Brian Bailey &Mac, cbData, &cbData);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey if ( !orc
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey && !Parm[0]
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey /*&& !Parm[1]?*/)
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste LogRel(("%s: iLan=%d iConnectedTo=%d Mac=%02x:%02x:%02x:%02x:%02x:%02x\n",
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey pThis->szName, pThis->iLan, pThis->iConnectedTo,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey Mac.au8[0], Mac.au8[1], Mac.au8[2], Mac.au8[3], Mac.au8[4], Mac.au8[5]));
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey else
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey LogRel(("%s: iLan=%d iConnectedTo Mac=failed - orc=%d Parm={%ld,%ld}\n",
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey pThis->szName, pThis->iLan, pThis->iConnectedTo, Parm[0], Parm[1]));
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey rc = PDMDrvHlpPDMThreadCreate(pDrvIns, &pThis->pThread, pThis, drvTAPOs2ReceiveThread, drvTAPOs2WakeupReceiveThread,
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey 0, RTTHREADTYPE_IO, pThis->szName);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey AssertRCReturn(rc, rc);
d04cb187fca1113d2306bbd6157bbc7cad75db7bBrian Bailey
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste#ifdef VBOX_WITH_STATISTICS
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /*
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * Statistics.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatPktSent, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Number of sent packets.", "/Drivers/TAP%d/Packets/Sent", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatPktSentBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of sent bytes.", "/Drivers/TAP%d/Bytes/Sent", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatPktRecv, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Number of received packets.", "/Drivers/TAP%d/Packets/Received", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatPktRecvBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of received bytes.", "/Drivers/TAP%d/Bytes/Received", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatTransmit, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_TICKS_PER_CALL, "Profiling packet transmit runs.", "/Drivers/TAP%d/Transmit", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste PDMDrvHlpSTAMRegisterF(pDrvIns, &pThis->StatReceive, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_TICKS_PER_CALL, "Profiling packet receive runs.", "/Drivers/TAP%d/Receive", pDrvIns->iInstance);
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste#endif /* VBOX_WITH_STATISTICS */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste return rc;
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste}
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste/**
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste * TAP network transport driver registration record.
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Joosteconst PDMDRVREG g_DrvHostInterface =
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste{
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* u32Version */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste PDM_DRVREG_VERSION,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* szDriverName */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste "HostInterface",
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* pszDescription */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste "TAP Network Transport Driver",
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* fFlags */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* fClass. */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste PDM_DRVREG_CLASS_NETWORK,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* cMaxInstances */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste ~0,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* cbInstance */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste sizeof(DRVTAPOS2),
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* pfnConstruct */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste drvTAPOs2Construct,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* pfnDestruct */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste drvTAPOs2Destruct,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* pfnIOCtl */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste NULL,
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste /* pfnPowerOn */
d5a3ebf08d19cae1ceac3d409b927cde02eb1b62Jaco Jooste NULL,
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /* pfnReset */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste NULL,
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /* pfnSuspend */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste NULL,
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste /* pfnResume */
11ddc496a78229c9c3e6f48a12f743e2d16d5180Jaco Jooste NULL,
62639ee1329be2d687701dfa01fc006314440bf7Jaco Jooste /* pfnDetach */
c423fd5d4f121413c5e72c134412b6ce5daa0dd9Jaco Jooste NULL,
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey /* pfnPowerOff */
95ac3084c619fd042f83410e5436ec3f1c3da190Brian Bailey NULL
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian};
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian
49a10996acfcd6a5a04b7077ca84126f856a4f56Brian