VirtualBox

source: vbox/trunk/src/VBox/Devices/Network/DrvTAP.cpp@ 10690

Last change on this file since 10690 was 9124, checked in by vboxsync, 17 years ago

Cleanup of the Solaris 10 detection, reducing ifdef clutter in the C files and avoid using the system namespace.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 39.0 KB
Line 
1/** $Id: DrvTAP.cpp 9124 2008-05-26 13:48:23Z vboxsync $ */
2/** @file
3 * Universial TAP network transport driver.
4 */
5
6/*
7 * Copyright (C) 2006-2007 Sun Microsystems, Inc.
8 *
9 * This file is part of VirtualBox Open Source Edition (OSE), as
10 * available from http://www.virtualbox.org. This file is free software;
11 * you can redistribute it and/or modify it under the terms of the GNU
12 * General Public License (GPL) as published by the Free Software
13 * Foundation, in version 2 as it comes in the "COPYING" file of the
14 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
15 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
16 *
17 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
18 * Clara, CA 95054 USA or visit http://www.sun.com if you need
19 * additional information or have any questions.
20 */
21
22/*******************************************************************************
23* Header Files *
24*******************************************************************************/
25#define LOG_GROUP LOG_GROUP_DRV_TUN
26#include <VBox/log.h>
27#include <VBox/pdmdrv.h>
28
29#include <iprt/assert.h>
30#include <iprt/file.h>
31#include <iprt/string.h>
32#include <iprt/path.h>
33#include <iprt/thread.h>
34#include <iprt/asm.h>
35#include <iprt/semaphore.h>
36#ifdef RT_OS_SOLARIS
37# include <iprt/process.h>
38# include <iprt/env.h>
39# ifdef VBOX_WITH_CROSSBOW
40# include <iprt/mem.h>
41# endif
42#endif
43
44#include <sys/ioctl.h>
45#include <sys/poll.h>
46#ifdef RT_OS_SOLARIS
47# include <sys/stat.h>
48# include <sys/ethernet.h>
49# include <sys/sockio.h>
50# include <netinet/in.h>
51# include <netinet/in_systm.h>
52# include <netinet/ip.h>
53# include <netinet/ip_icmp.h>
54# include <netinet/udp.h>
55# include <netinet/tcp.h>
56# include <net/if.h>
57# include <stropts.h>
58# include <fcntl.h>
59# include <ctype.h>
60# include <stdlib.h>
61# include <stdio.h>
62# ifdef VBOX_WITH_CROSSBOW
63# include "solaris/vbox-libdlpi.h"
64# endif
65#else
66# include <sys/fcntl.h>
67#endif
68#include <errno.h>
69#include <unistd.h>
70
71#ifdef RT_OS_L4
72# include <l4/vboxserver/file.h>
73#endif
74
75#include "Builtins.h"
76
77
78/*******************************************************************************
79* Structures and Typedefs *
80*******************************************************************************/
81/**
82 * Block driver instance data.
83 */
84typedef struct DRVTAP
85{
86 /** The network interface. */
87 PDMINETWORKCONNECTOR INetworkConnector;
88 /** The network interface. */
89 PPDMINETWORKPORT pPort;
90 /** Pointer to the driver instance. */
91 PPDMDRVINS pDrvIns;
92 /** TAP device file handle. */
93 RTFILE FileDevice;
94 /** The configured TAP device name. */
95 char *pszDeviceName;
96#ifdef RT_OS_SOLARIS
97# ifdef VBOX_WITH_CROSSBOW
98 /** Crossbow: MAC address of the device. */
99 PDMMAC MacAddress;
100 /** Crossbow: Handle of the NIC. */
101 dlpi_handle_t pDeviceHandle;
102# else
103 /** IP device file handle (/dev/udp). */
104 RTFILE IPFileDevice;
105# endif
106 /** Whether device name is obtained from setup application. */
107 bool fStatic;
108#endif
109 /** TAP setup application. */
110 char *pszSetupApplication;
111 /** TAP terminate application. */
112 char *pszTerminateApplication;
113 /** The write end of the control pipe. */
114 RTFILE PipeWrite;
115 /** The read end of the control pipe. */
116 RTFILE PipeRead;
117 /** Reader thread. */
118 PPDMTHREAD pThread;
119
120#ifdef VBOX_WITH_STATISTICS
121 /** Number of sent packets. */
122 STAMCOUNTER StatPktSent;
123 /** Number of sent bytes. */
124 STAMCOUNTER StatPktSentBytes;
125 /** Number of received packets. */
126 STAMCOUNTER StatPktRecv;
127 /** Number of received bytes. */
128 STAMCOUNTER StatPktRecvBytes;
129 /** Profiling packet transmit runs. */
130 STAMPROFILE StatTransmit;
131 /** Profiling packet receive runs. */
132 STAMPROFILEADV StatReceive;
133#endif /* VBOX_WITH_STATISTICS */
134
135#ifdef LOG_ENABLED
136 /** The nano ts of the last transfer. */
137 uint64_t u64LastTransferTS;
138 /** The nano ts of the last receive. */
139 uint64_t u64LastReceiveTS;
140#endif
141} DRVTAP, *PDRVTAP;
142
143
144/** Converts a pointer to TAP::INetworkConnector to a PRDVTAP. */
145#define PDMINETWORKCONNECTOR_2_DRVTAP(pInterface) ( (PDRVTAP)((uintptr_t)pInterface - RT_OFFSETOF(DRVTAP, INetworkConnector)) )
146
147
148/*******************************************************************************
149* Internal Functions *
150*******************************************************************************/
151#ifdef RT_OS_SOLARIS
152# ifdef VBOX_WITH_CROSSBOW
153static int SolarisOpenVNIC(PDRVTAP pData);
154static int SolarisDLPIErr2VBoxErr(int rc);
155# else
156static int SolarisTAPAttach(PDRVTAP pData);
157# endif
158#endif
159
160
161/**
162 * Send data to the network.
163 *
164 * @returns VBox status code.
165 * @param pInterface Pointer to the interface structure containing the called function pointer.
166 * @param pvBuf Data to send.
167 * @param cb Number of bytes to send.
168 * @thread EMT
169 */
170static DECLCALLBACK(int) drvTAPSend(PPDMINETWORKCONNECTOR pInterface, const void *pvBuf, size_t cb)
171{
172 PDRVTAP pData = PDMINETWORKCONNECTOR_2_DRVTAP(pInterface);
173 STAM_COUNTER_INC(&pData->StatPktSent);
174 STAM_COUNTER_ADD(&pData->StatPktSentBytes, cb);
175 STAM_PROFILE_START(&pData->StatTransmit, a);
176
177#ifdef LOG_ENABLED
178 uint64_t u64Now = RTTimeProgramNanoTS();
179 LogFlow(("drvTAPSend: %-4d bytes at %llu ns deltas: r=%llu t=%llu\n",
180 cb, u64Now, u64Now - pData->u64LastReceiveTS, u64Now - pData->u64LastTransferTS));
181 pData->u64LastTransferTS = u64Now;
182#endif
183 Log2(("drvTAPSend: pvBuf=%p cb=%#x\n"
184 "%.*Vhxd\n",
185 pvBuf, cb, cb, pvBuf));
186
187 int rc = RTFileWrite(pData->FileDevice, pvBuf, cb, NULL);
188
189 STAM_PROFILE_STOP(&pData->StatTransmit, a);
190 AssertRC(rc);
191 return rc;
192}
193
194
195/**
196 * Set promiscuous mode.
197 *
198 * This is called when the promiscuous mode is set. This means that there doesn't have
199 * to be a mode change when it's called.
200 *
201 * @param pInterface Pointer to the interface structure containing the called function pointer.
202 * @param fPromiscuous Set if the adaptor is now in promiscuous mode. Clear if it is not.
203 * @thread EMT
204 */
205static DECLCALLBACK(void) drvTAPSetPromiscuousMode(PPDMINETWORKCONNECTOR pInterface, bool fPromiscuous)
206{
207 LogFlow(("drvTAPSetPromiscuousMode: fPromiscuous=%d\n", fPromiscuous));
208 /* nothing to do */
209}
210
211
212/**
213 * Notification on link status changes.
214 *
215 * @param pInterface Pointer to the interface structure containing the called function pointer.
216 * @param enmLinkState The new link state.
217 * @thread EMT
218 */
219static DECLCALLBACK(void) drvTAPNotifyLinkChanged(PPDMINETWORKCONNECTOR pInterface, PDMNETWORKLINKSTATE enmLinkState)
220{
221 LogFlow(("drvNATNotifyLinkChanged: enmLinkState=%d\n", enmLinkState));
222 /** @todo take action on link down and up. Stop the polling and such like. */
223}
224
225
226/**
227 * Asynchronous I/O thread for handling receive.
228 *
229 * @returns VINF_SUCCESS (ignored).
230 * @param Thread Thread handle.
231 * @param pvUser Pointer to a DRVTAP structure.
232 */
233static DECLCALLBACK(int) drvTAPAsyncIoThread(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
234{
235 PDRVTAP pData = PDMINS2DATA(pDrvIns, PDRVTAP);
236 LogFlow(("drvTAPAsyncIoThread: pData=%p\n", pData));
237
238 if (pThread->enmState == PDMTHREADSTATE_INITIALIZING)
239 return VINF_SUCCESS;
240
241 STAM_PROFILE_ADV_START(&pData->StatReceive, a);
242
243 /*
244 * Polling loop.
245 */
246 while (pThread->enmState == PDMTHREADSTATE_RUNNING)
247 {
248 /*
249 * Wait for something to become available.
250 */
251 struct pollfd aFDs[2];
252 aFDs[0].fd = pData->FileDevice;
253 aFDs[0].events = POLLIN | POLLPRI;
254 aFDs[0].revents = 0;
255 aFDs[1].fd = pData->PipeRead;
256 aFDs[1].events = POLLIN | POLLPRI | POLLERR | POLLHUP;
257 aFDs[1].revents = 0;
258 STAM_PROFILE_ADV_STOP(&pData->StatReceive, a);
259 errno=0;
260 int rc = poll(&aFDs[0], ELEMENTS(aFDs), -1 /* infinite */);
261
262 /* this might have changed in the meantime */
263 if (pThread->enmState != PDMTHREADSTATE_RUNNING)
264 break;
265
266 STAM_PROFILE_ADV_START(&pData->StatReceive, a);
267 if ( rc > 0
268 && (aFDs[0].revents & (POLLIN | POLLPRI))
269 && !aFDs[1].revents)
270 {
271 /*
272 * Read the frame.
273 */
274 char achBuf[4096];
275 size_t cbRead = 0;
276#ifdef VBOX_WITH_CROSSBOW
277 cbRead = sizeof(achBuf);
278 rc = g_pfnLibDlpiRecv(pData->pDeviceHandle, NULL, NULL, achBuf, &cbRead, -1, NULL);
279 rc = RT_LIKELY(rc == DLPI_SUCCESS) ? VINF_SUCCESS : SolarisDLPIErr2VBoxErr(rc);
280#else
281 /** @note At least on Linux we will never receive more than one network packet
282 * after poll() returned successfully. I don't know why but a second
283 * RTFileRead() operation will return with VERR_TRY_AGAIN in any case. */
284 rc = RTFileRead(pData->FileDevice, achBuf, sizeof(achBuf), &cbRead);
285#endif
286 if (VBOX_SUCCESS(rc))
287 {
288 AssertMsg(cbRead <= 1536, ("cbRead=%d\n", cbRead));
289
290 /*
291 * Wait for the device to have space for this frame.
292 * Most guests use frame-sized receive buffers, hence non-zero cbMax
293 * automatically means there is enough room for entire frame. Some
294 * guests (eg. Solaris) use large chains of small receive buffers
295 * (each 128 or so bytes large). We will still start receiving as soon
296 * as cbMax is non-zero because:
297 * - it would be quite expensive for pfnCanReceive to accurately
298 * determine free receive buffer space
299 * - if we were waiting for enough free buffers, there is a risk
300 * of deadlocking because the guest could be waiting for a receive
301 * overflow error to allocate more receive buffers
302 */
303 STAM_PROFILE_ADV_STOP(&pData->StatReceive, a);
304 int rc = pData->pPort->pfnWaitReceiveAvail(pData->pPort, RT_INDEFINITE_WAIT);
305 STAM_PROFILE_ADV_START(&pData->StatReceive, a);
306
307 /*
308 * A return code != VINF_SUCCESS means that we were woken up during a VM
309 * state transistion. Drop the packet and wait for the next one.
310 */
311 if (RT_FAILURE(rc))
312 continue;
313
314 /*
315 * Pass the data up.
316 */
317#ifdef LOG_ENABLED
318 uint64_t u64Now = RTTimeProgramNanoTS();
319 LogFlow(("drvTAPAsyncIoThread: %-4d bytes at %llu ns deltas: r=%llu t=%llu\n",
320 cbRead, u64Now, u64Now - pData->u64LastReceiveTS, u64Now - pData->u64LastTransferTS));
321 pData->u64LastReceiveTS = u64Now;
322#endif
323 Log2(("drvTAPAsyncIoThread: cbRead=%#x\n" "%.*Vhxd\n", cbRead, cbRead, achBuf));
324 STAM_COUNTER_INC(&pData->StatPktRecv);
325 STAM_COUNTER_ADD(&pData->StatPktRecvBytes, cbRead);
326 rc = pData->pPort->pfnReceive(pData->pPort, achBuf, cbRead);
327 AssertRC(rc);
328 }
329 else
330 {
331 LogFlow(("drvTAPAsyncIoThread: RTFileRead -> %Vrc\n", rc));
332 if (rc == VERR_INVALID_HANDLE)
333 break;
334 RTThreadYield();
335 }
336 }
337 else if ( rc > 0
338 && aFDs[1].revents)
339 {
340 LogFlow(("drvTAPAsyncIoThread: Control message: enmState=%d revents=%#x\n", pThread->enmState, aFDs[1].revents));
341 if (aFDs[1].revents & (POLLHUP | POLLERR | POLLNVAL))
342 break;
343
344 /* drain the pipe */
345 char ch;
346 size_t cbRead;
347 RTFileRead(pData->PipeRead, &ch, 1, &cbRead);
348 }
349 else
350 {
351 /*
352 * poll() failed for some reason. Yield to avoid eating too much CPU.
353 *
354 * EINTR errors have been seen frequently. They should be harmless, even
355 * if they are not supposed to occur in our setup.
356 */
357 if (errno == EINTR)
358 Log(("rc=%d revents=%#x,%#x errno=%p %s\n", rc, aFDs[0].revents, aFDs[1].revents, errno, strerror(errno)));
359 else
360 AssertMsgFailed(("rc=%d revents=%#x,%#x errno=%p %s\n", rc, aFDs[0].revents, aFDs[1].revents, errno, strerror(errno)));
361 RTThreadYield();
362 }
363 }
364
365
366 LogFlow(("drvTAPAsyncIoThread: returns %Vrc\n", VINF_SUCCESS));
367 STAM_PROFILE_ADV_STOP(&pData->StatReceive, a);
368 return VINF_SUCCESS;
369}
370
371
372/**
373 * Unblock the send thread so it can respond to a state change.
374 *
375 * @returns VBox status code.
376 * @param pDevIns The pcnet device instance.
377 * @param pThread The send thread.
378 */
379static DECLCALLBACK(int) drvTapAsyncIoWakeup(PPDMDRVINS pDrvIns, PPDMTHREAD pThread)
380{
381 PDRVTAP pData = PDMINS2DATA(pDrvIns, PDRVTAP);
382
383 int rc = RTFileWrite(pData->PipeWrite, "", 1, NULL);
384 AssertRC(rc);
385
386 return VINF_SUCCESS;
387}
388
389
390#if defined(RT_OS_SOLARIS)
391/**
392 * Calls OS-specific TAP setup application/script.
393 *
394 * @returns VBox error code.
395 * @param pData The instance data.
396 */
397static int drvTAPSetupApplication(PDRVTAP pData)
398{
399 char szCommand[4096];
400
401#ifdef VBOX_WITH_CROSSBOW
402 /* Convert MAC address bytes to string (required by Solaris' dladm). */
403 char *pszHex = "0123456789abcdef";
404 uint8_t *pMacAddr8 = pData->MacAddress.au8;
405 char szMacAddress[3 * sizeof(PDMMAC)];
406 for (unsigned int i = 0; i < sizeof(PDMMAC); i++)
407 {
408 szMacAddress[3 * i] = pszHex[((*pMacAddr8 >> 4) & 0x0f)];
409 szMacAddress[3 * i + 1] = pszHex[(*pMacAddr8 & 0x0f)];
410 szMacAddress[3 * i + 2] = ':';
411 *pMacAddr8++;
412 }
413 szMacAddress[sizeof(szMacAddress) - 1] = 0;
414
415 RTStrPrintf(szCommand, sizeof(szCommand), "%s %s %s", pData->pszSetupApplication,
416 szMacAddress, pData->fStatic ? pData->pszDeviceName : "");
417#else
418 RTStrPrintf(szCommand, sizeof(szCommand), "%s %s", pData->pszSetupApplication,
419 pData->fStatic ? pData->pszDeviceName : "");
420#endif
421
422 /* Pipe open the setup application. */
423 Log2(("Starting TAP setup application: %s\n", szCommand));
424 FILE* pfSetupHandle = popen(szCommand, "r");
425 if (pfSetupHandle == 0)
426 {
427 LogRel(("TAP#%d: Failed to run TAP setup application: %s\n", pData->pDrvIns->iInstance,
428 pData->pszSetupApplication, strerror(errno)));
429 return VERR_HOSTIF_INIT_FAILED;
430 }
431 if (!pData->fStatic)
432 {
433 /* Obtain device name from setup application. */
434 char acBuffer[64];
435 size_t cBufSize;
436 fgets(acBuffer, sizeof(acBuffer), pfSetupHandle);
437 cBufSize = strlen(acBuffer);
438 /* The script must return the name of the interface followed by a carriage return as the
439 first line of its output. We need a null-terminated string. */
440 if ((cBufSize < 2) || (acBuffer[cBufSize - 1] != '\n'))
441 {
442 pclose(pfSetupHandle);
443 LogRel(("The TAP interface setup script did not return the name of a TAP device.\n"));
444 return VERR_HOSTIF_INIT_FAILED;
445 }
446 /* Overwrite the terminating newline character. */
447 acBuffer[cBufSize - 1] = 0;
448 RTStrAPrintf(&pData->pszDeviceName, "%s", acBuffer);
449 }
450 int rc = pclose(pfSetupHandle);
451 if (!WIFEXITED(rc))
452 {
453 LogRel(("The TAP interface setup script terminated abnormally.\n"));
454 return VERR_HOSTIF_INIT_FAILED;
455 }
456 if (WEXITSTATUS(rc) != 0)
457 {
458 LogRel(("The TAP interface setup script returned a non-zero exit code.\n"));
459 return VERR_HOSTIF_INIT_FAILED;
460 }
461 return VINF_SUCCESS;
462}
463
464
465/**
466 * Calls OS-specific TAP terminate application/script.
467 *
468 * @returns VBox error code.
469 * @param pData The instance data.
470 */
471static int drvTAPTerminateApplication(PDRVTAP pData)
472{
473 char *pszArgs[3];
474 pszArgs[0] = pData->pszTerminateApplication;
475 pszArgs[1] = pData->pszDeviceName;
476 pszArgs[2] = NULL;
477
478 Log2(("Starting TAP terminate application: %s %s\n", pData->pszTerminateApplication, pData->pszDeviceName));
479 RTPROCESS pid = NIL_RTPROCESS;
480 int rc = RTProcCreate(pszArgs[0], pszArgs, RTENV_DEFAULT, 0, &pid);
481 if (RT_SUCCESS(rc))
482 {
483 RTPROCSTATUS Status;
484 rc = RTProcWait(pid, 0, &Status);
485 if (RT_SUCCESS(rc))
486 {
487 if ( Status.iStatus == 0
488 && Status.enmReason == RTPROCEXITREASON_NORMAL)
489 return VINF_SUCCESS;
490
491 LogRel(("TAP#%d: Error running TAP terminate application: %s\n", pData->pDrvIns->iInstance, pData->pszTerminateApplication));
492 }
493 else
494 LogRel(("TAP#%d: RTProcWait failed for: %s\n", pData->pDrvIns->iInstance, pData->pszTerminateApplication));
495 }
496 else
497 {
498 /* Bad. RTProcCreate() failed! */
499 LogRel(("TAP#%d: Failed to fork() process for running TAP terminate application: %s\n", pData->pDrvIns->iInstance,
500 pData->pszTerminateApplication, strerror(errno)));
501 }
502 return VERR_HOSTIF_TERM_FAILED;
503}
504
505#endif /* RT_OS_SOLARIS */
506
507
508#ifdef RT_OS_SOLARIS
509# ifdef VBOX_WITH_CROSSBOW
510/**
511 * Crossbow: Open & configure the virtual NIC.
512 *
513 * @returns VBox error code.
514 * @param pData The instance data.
515 */
516static int SolarisOpenVNIC(PDRVTAP pData)
517{
518 /*
519 * Open & bind the NIC using the datalink provider routine.
520 */
521 int rc = g_pfnLibDlpiOpen(pData->pszDeviceName, &pData->pDeviceHandle, DLPI_RAW);
522 if (rc != DLPI_SUCCESS)
523 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
524 N_("Failed to open VNIC \"%s\" in raw mode"), pData->pszDeviceName);
525
526 dlpi_info_t vnicInfo;
527 rc = g_pfnLibDlpiInfo(pData->pDeviceHandle, &vnicInfo, 0);
528 if (rc == DLPI_SUCCESS)
529 {
530 if (vnicInfo.di_mactype == DL_ETHER)
531 {
532 rc = g_pfnLibDlpiBind(pData->pDeviceHandle, DLPI_ANY_SAP, NULL);
533 if (rc == DLPI_SUCCESS)
534 {
535 rc = g_pfnLibDlpiSetPhysAddr(pData->pDeviceHandle, DL_CURR_PHYS_ADDR, &pData->MacAddress, ETHERADDRL);
536 if (rc == DLPI_SUCCESS)
537 {
538 rc = g_pfnLibDlpiPromiscon(pData->pDeviceHandle, DL_PROMISC_SAP);
539 if (rc == DLPI_SUCCESS)
540 {
541 /* Need to use DL_PROMIS_PHYS (not multicast) as we cannot be sure what the guest needs. */
542 rc = g_pfnLibDlpiPromiscon(pData->pDeviceHandle, DL_PROMISC_PHYS);
543 if (rc == DLPI_SUCCESS)
544 {
545 pData->FileDevice = g_pfnLibDlpiFd(pData->pDeviceHandle);
546 if (pData->FileDevice >= 0)
547 {
548 Log(("SolarisOpenVNIC: %s -> %d\n", pData->pszDeviceName, pData->FileDevice));
549 return VINF_SUCCESS;
550 }
551
552 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
553 N_("Failed to obtain file descriptor for VNIC"));
554 }
555 else
556 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
557 N_("Failed to set appropriate promiscous mode"));
558 }
559 else
560 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
561 N_("Failed to activate promiscous mode for VNIC"));
562 }
563 else
564 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
565 N_("Failed to set physical address for VNIC"));
566 }
567 else
568 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
569 N_("Failed to bind VNIC"));
570 }
571 else
572 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
573 N_("VNIC type is not ethernet"));
574 }
575 else
576 rc = PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
577 N_("Failed to obtain VNIC info"));
578 g_pfnLibDlpiClose(pData->pDeviceHandle);
579 return rc;
580}
581
582
583/**
584 * Crossbow: Converts a Solaris DLPI error code to a VBox error code.
585 *
586 * @returns corresponding VBox error code.
587 * @param rc DLPI error code (DLPI_* defines).
588 */
589static int SolarisDLPIErr2VBoxErr(int rc)
590{
591 switch (rc)
592 {
593 case DLPI_SUCCESS: return VINF_SUCCESS;
594 case DLPI_EINVAL: return VERR_INVALID_PARAMETER;
595 case DLPI_ELINKNAMEINVAL: return VERR_INVALID_NAME;
596 case DLPI_EINHANDLE: return VERR_INVALID_HANDLE;
597 case DLPI_ETIMEDOUT: return VERR_TIMEOUT;
598 case DLPI_FAILURE: return VERR_GENERAL_FAILURE;
599
600 case DLPI_EVERNOTSUP:
601 case DLPI_EMODENOTSUP:
602 case DLPI_ERAWNOTSUP:
603 /* case DLPI_ENOTENOTSUP: */
604 case DLPI_EUNAVAILSAP: return VERR_NOT_SUPPORTED;
605
606 /* Define VBox error codes for these, if really needed. */
607 case DLPI_ENOLINK:
608 case DLPI_EBADLINK:
609 /* case DLPI_ENOTEIDINVAL: */
610 case DLPI_EBADMSG:
611 case DLPI_ENOTSTYLE2: return VERR_GENERAL_FAILURE;
612 }
613
614 AssertMsgFailed(("SolarisDLPIErr2VBoxErr: Unhandled error %d\n", rc));
615 return VERR_UNRESOLVED_ERROR;
616}
617
618# else /* VBOX_WITH_CROSSBOW */
619
620/** From net/if_tun.h, installed by Universal TUN/TAP driver */
621# define TUNNEWPPA (('T'<<16) | 0x0001)
622/** Whether to enable ARP for TAP. */
623# define VBOX_SOLARIS_TAP_ARP 1
624
625/**
626 * Creates/Attaches TAP device to IP.
627 *
628 * @returns VBox error code.
629 * @param pData The instance data.
630 */
631static DECLCALLBACK(int) SolarisTAPAttach(PDRVTAP pData)
632{
633 LogFlow(("SolarisTapAttach: pData=%p\n", pData));
634
635
636 int IPFileDes = open("/dev/udp", O_RDWR, 0);
637 if (IPFileDes < 0)
638 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_PDM_HIF_OPEN_FAILED, RT_SRC_POS,
639 N_("Failed to open /dev/udp. errno=%d"), errno);
640
641 int TapFileDes = open("/dev/tap", O_RDWR, 0);
642 if (TapFileDes < 0)
643 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_PDM_HIF_OPEN_FAILED, RT_SRC_POS,
644 N_("Failed to open /dev/tap for TAP. errno=%d"), errno);
645
646 /* Use the PPA from the ifname if possible (e.g "tap2", then use 2 as PPA) */
647 int iPPA = -1;
648 if (pData->pszDeviceName)
649 {
650 size_t cch = strlen(pData->pszDeviceName);
651 if (cch > 1 && isdigit(pData->pszDeviceName[cch - 1]) != 0)
652 iPPA = pData->pszDeviceName[cch - 1] - '0';
653 }
654
655 struct strioctl ioIF;
656 ioIF.ic_cmd = TUNNEWPPA;
657 ioIF.ic_len = sizeof(iPPA);
658 ioIF.ic_dp = (char *)(&iPPA);
659 ioIF.ic_timout = 0;
660 iPPA = ioctl(TapFileDes, I_STR, &ioIF);
661 if (iPPA < 0)
662 {
663 close(TapFileDes);
664 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_IOCTL, RT_SRC_POS,
665 N_("Failed to get new interface. errno=%d"), errno);
666 }
667
668 int InterfaceFD = open("/dev/tap", O_RDWR, 0);
669 if (!InterfaceFD)
670 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_PDM_HIF_OPEN_FAILED, RT_SRC_POS,
671 N_("Failed to open interface /dev/tap. errno=%d"), errno);
672
673 if (ioctl(InterfaceFD, I_PUSH, "ip") == -1)
674 {
675 close(InterfaceFD);
676 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_IOCTL, RT_SRC_POS,
677 N_("Failed to push IP. errno=%d"), errno);
678 }
679
680 struct lifreq ifReq;
681 memset(&ifReq, 0, sizeof(ifReq));
682 if (ioctl(InterfaceFD, SIOCGLIFFLAGS, &ifReq) == -1)
683 LogRel(("TAP#%d: Failed to get interface flags.\n", pData->pDrvIns->iInstance));
684
685 ifReq.lifr_ppa = iPPA;
686 RTStrPrintf (ifReq.lifr_name, sizeof(ifReq.lifr_name), pData->pszDeviceName);
687
688 if (ioctl(InterfaceFD, SIOCSLIFNAME, &ifReq) == -1)
689 LogRel(("TAP#%d: Failed to set PPA. errno=%d\n", pData->pDrvIns->iInstance, errno));
690
691 if (ioctl(InterfaceFD, SIOCGLIFFLAGS, &ifReq) == -1)
692 LogRel(("TAP#%d: Failed to get interface flags after setting PPA. errno=%d\n", pData->pDrvIns->iInstance, errno));
693
694#ifdef VBOX_SOLARIS_TAP_ARP
695 /* Interface */
696 if (ioctl(InterfaceFD, I_PUSH, "arp") == -1)
697 LogRel(("TAP#%d: Failed to push ARP to Interface FD. errno=%d\n", pData->pDrvIns->iInstance, errno));
698
699 /* IP */
700 if (ioctl(IPFileDes, I_POP, NULL) == -1)
701 LogRel(("TAP#%d: Failed I_POP from IP FD. errno=%d\n", pData->pDrvIns->iInstance, errno));
702
703 if (ioctl(IPFileDes, I_PUSH, "arp") == -1)
704 LogRel(("TAP#%d: Failed to push ARP to IP FD. errno=%d\n", pData->pDrvIns->iInstance, errno));
705
706 /* ARP */
707 int ARPFileDes = open("/dev/tap", O_RDWR, 0);
708 if (ARPFileDes < 0)
709 LogRel(("TAP#%d: Failed to open for /dev/tap for ARP. errno=%d", pData->pDrvIns->iInstance, errno));
710
711 if (ioctl(ARPFileDes, I_PUSH, "arp") == -1)
712 LogRel(("TAP#%d: Failed to push ARP to ARP FD. errno=%d\n", pData->pDrvIns->iInstance, errno));
713
714 ioIF.ic_cmd = SIOCSLIFNAME;
715 ioIF.ic_timout = 0;
716 ioIF.ic_len = sizeof(ifReq);
717 ioIF.ic_dp = (char *)&ifReq;
718 if (ioctl(ARPFileDes, I_STR, &ioIF) == -1)
719 LogRel(("TAP#%d: Failed to set interface name to ARP.\n", pData->pDrvIns->iInstance));
720#endif
721
722 /* We must use I_LINK and not I_PLINK as I_PLINK makes the link persistent.
723 * Then we would not be able unlink the interface if we reuse it.
724 * Even 'unplumb' won't work after that.
725 */
726 int IPMuxID = ioctl(IPFileDes, I_LINK, InterfaceFD);
727 if (IPMuxID == -1)
728 {
729 close(InterfaceFD);
730#ifdef VBOX_SOLARIS_TAP_ARP
731 close(ARPFileDes);
732#endif
733 LogRel(("TAP#%d: Cannot link TAP device to IP.\n", pData->pDrvIns->iInstance));
734 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_IOCTL, RT_SRC_POS,
735 N_("Failed to link TAP device to IP. Check TAP interface name. errno=%d"), errno);
736 }
737
738#ifdef VBOX_SOLARIS_TAP_ARP
739 int ARPMuxID = ioctl(IPFileDes, I_LINK, ARPFileDes);
740 if (ARPMuxID == -1)
741 LogRel(("TAP#%d: Failed to link TAP device to ARP\n", pData->pDrvIns->iInstance));
742
743 close(ARPFileDes);
744#endif
745 close(InterfaceFD);
746
747 /* Reuse ifReq */
748 memset(&ifReq, 0, sizeof(ifReq));
749 RTStrPrintf (ifReq.lifr_name, sizeof(ifReq.lifr_name), pData->pszDeviceName);
750 ifReq.lifr_ip_muxid = IPMuxID;
751#ifdef VBOX_SOLARIS_TAP_ARP
752 ifReq.lifr_arp_muxid = ARPMuxID;
753#endif
754
755 if (ioctl(IPFileDes, SIOCSLIFMUXID, &ifReq) == -1)
756 {
757#ifdef VBOX_SOLARIS_TAP_ARP
758 ioctl(IPFileDes, I_PUNLINK, ARPMuxID);
759#endif
760 ioctl(IPFileDes, I_PUNLINK, IPMuxID);
761 close(IPFileDes);
762 LogRel(("TAP#%d: Failed to set Mux ID.\n", pData->pDrvIns->iInstance));
763 return PDMDrvHlpVMSetError(pData->pDrvIns, VERR_HOSTIF_IOCTL, RT_SRC_POS,
764 N_("Failed to set Mux ID. Check TAP interface name. errno=%d"), errno);
765 }
766
767 pData->FileDevice = (RTFILE)TapFileDes;
768 pData->IPFileDevice = (RTFILE)IPFileDes;
769
770 return VINF_SUCCESS;
771}
772
773# endif /* VBOX_WITH_CROSSBOW */
774#endif /* RT_OS_SOLARIS */
775
776
777/**
778 * Queries an interface to the driver.
779 *
780 * @returns Pointer to interface.
781 * @returns NULL if the interface was not supported by the driver.
782 * @param pInterface Pointer to this interface structure.
783 * @param enmInterface The requested interface identification.
784 * @thread Any thread.
785 */
786static DECLCALLBACK(void *) drvTAPQueryInterface(PPDMIBASE pInterface, PDMINTERFACE enmInterface)
787{
788 PPDMDRVINS pDrvIns = PDMIBASE_2_PDMDRV(pInterface);
789 PDRVTAP pData = PDMINS2DATA(pDrvIns, PDRVTAP);
790 switch (enmInterface)
791 {
792 case PDMINTERFACE_BASE:
793 return &pDrvIns->IBase;
794 case PDMINTERFACE_NETWORK_CONNECTOR:
795 return &pData->INetworkConnector;
796 default:
797 return NULL;
798 }
799}
800
801
802/**
803 * Destruct a driver instance.
804 *
805 * Most VM resources are freed by the VM. This callback is provided so that any non-VM
806 * resources can be freed correctly.
807 *
808 * @param pDrvIns The driver instance data.
809 */
810static DECLCALLBACK(void) drvTAPDestruct(PPDMDRVINS pDrvIns)
811{
812 LogFlow(("drvTAPDestruct\n"));
813 PDRVTAP pData = PDMINS2DATA(pDrvIns, PDRVTAP);
814
815 /*
816 * Terminate the control pipe.
817 */
818 if (pData->PipeWrite != NIL_RTFILE)
819 {
820 int rc = RTFileClose(pData->PipeWrite);
821 AssertRC(rc);
822 pData->PipeWrite = NIL_RTFILE;
823 }
824 if (pData->PipeRead != NIL_RTFILE)
825 {
826 int rc = RTFileClose(pData->PipeRead);
827 AssertRC(rc);
828 pData->PipeRead = NIL_RTFILE;
829 }
830
831#ifdef RT_OS_SOLARIS
832 /** @todo r=bird: This *does* need checking against ConsoleImpl2.cpp if used on non-solaris systems. */
833 if (pData->FileDevice != NIL_RTFILE)
834 {
835 int rc = RTFileClose(pData->FileDevice);
836 AssertRC(rc);
837 pData->FileDevice = NIL_RTFILE;
838 }
839
840# ifndef VBOX_WITH_CROSSBOW
841 if (pData->IPFileDevice != NIL_RTFILE)
842 {
843 int rc = RTFileClose(pData->IPFileDevice);
844 AssertRC(rc);
845 pData->IPFileDevice = NIL_RTFILE;
846 }
847# endif
848
849 /*
850 * Call TerminateApplication after closing the device otherwise
851 * TerminateApplication would not be able to unplumb it.
852 */
853 if (pData->pszTerminateApplication)
854 drvTAPTerminateApplication(pData);
855
856#endif /* RT_OS_SOLARIS */
857
858#ifdef RT_OS_SOLARIS
859 if (!pData->fStatic)
860 RTStrFree(pData->pszDeviceName); /* allocated by drvTAPSetupApplication */
861 else
862 MMR3HeapFree(pData->pszDeviceName);
863#else
864 MMR3HeapFree(pData->pszDeviceName);
865#endif
866 MMR3HeapFree(pData->pszSetupApplication);
867 MMR3HeapFree(pData->pszTerminateApplication);
868}
869
870
871/**
872 * Construct a TAP network transport driver instance.
873 *
874 * @returns VBox status.
875 * @param pDrvIns The driver instance data.
876 * If the registration structure is needed, pDrvIns->pDrvReg points to it.
877 * @param pCfgHandle Configuration node handle for the driver. Use this to obtain the configuration
878 * of the driver instance. It's also found in pDrvIns->pCfgHandle, but like
879 * iInstance it's expected to be used a bit in this function.
880 */
881static DECLCALLBACK(int) drvTAPConstruct(PPDMDRVINS pDrvIns, PCFGMNODE pCfgHandle)
882{
883 PDRVTAP pData = PDMINS2DATA(pDrvIns, PDRVTAP);
884
885 /*
886 * Init the static parts.
887 */
888 pData->pDrvIns = pDrvIns;
889 pData->FileDevice = NIL_RTFILE;
890 pData->pszDeviceName = NULL;
891#ifdef RT_OS_SOLARIS
892# ifdef VBOX_WITH_CROSSBOW
893 pData->pDeviceHandle = NULL;
894# else
895 pData->IPFileDevice = NIL_RTFILE;
896# endif
897 pData->fStatic = true;
898#endif
899 pData->pszSetupApplication = NULL;
900 pData->pszTerminateApplication = NULL;
901
902 /* IBase */
903 pDrvIns->IBase.pfnQueryInterface = drvTAPQueryInterface;
904 /* INetwork */
905 pData->INetworkConnector.pfnSend = drvTAPSend;
906 pData->INetworkConnector.pfnSetPromiscuousMode = drvTAPSetPromiscuousMode;
907 pData->INetworkConnector.pfnNotifyLinkChanged = drvTAPNotifyLinkChanged;
908
909 /*
910 * Validate the config.
911 */
912 if (!CFGMR3AreValuesValid(pCfgHandle, "Device\0InitProg\0TermProg\0FileHandle\0TAPSetupApplication\0TAPTerminateApplication\0MAC"))
913 return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_DRVINS_UNKNOWN_CFG_VALUES, "");
914
915 /*
916 * Check that no-one is attached to us.
917 */
918 int rc = pDrvIns->pDrvHlp->pfnAttach(pDrvIns, NULL);
919 if (rc != VERR_PDM_NO_ATTACHED_DRIVER)
920 return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_DRVINS_NO_ATTACH,
921 N_("Configuration error: Cannot attach drivers to the TAP driver"));
922
923 /*
924 * Query the network port interface.
925 */
926 pData->pPort = (PPDMINETWORKPORT)pDrvIns->pUpBase->pfnQueryInterface(pDrvIns->pUpBase, PDMINTERFACE_NETWORK_PORT);
927 if (!pData->pPort)
928 return PDMDRV_SET_ERROR(pDrvIns, VERR_PDM_MISSING_INTERFACE_ABOVE,
929 N_("Configuration error: The above device/driver didn't export the network port interface"));
930
931 /*
932 * Read the configuration.
933 */
934#if defined(RT_OS_SOLARIS) /** @todo Other platforms' TAP code should be moved here from ConsoleImpl & VBoxBFE. */
935 rc = CFGMR3QueryStringAlloc(pCfgHandle, "TAPSetupApplication", &pData->pszSetupApplication);
936 if (VBOX_SUCCESS(rc))
937 {
938 if (!RTPathExists(pData->pszSetupApplication))
939 return PDMDrvHlpVMSetError(pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
940 N_("Invalid TAP setup program path: %s"), pData->pszSetupApplication);
941 }
942 else if (rc != VERR_CFGM_VALUE_NOT_FOUND)
943 return PDMDRV_SET_ERROR(pDrvIns, rc, N_("Configuration error: failed to query \"TAPTerminateApplication\""));
944
945 rc = CFGMR3QueryStringAlloc(pCfgHandle, "TAPTerminateApplication", &pData->pszTerminateApplication);
946 if (VBOX_SUCCESS(rc))
947 {
948 if (!RTPathExists(pData->pszTerminateApplication))
949 return PDMDrvHlpVMSetError(pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
950 N_("Invalid TAP terminate program path: %s"), pData->pszTerminateApplication);
951 }
952 else if (rc != VERR_CFGM_VALUE_NOT_FOUND)
953 return PDMDRV_SET_ERROR(pDrvIns, rc, N_("Configuration error: failed to query \"TAPTerminateApplication\""));
954
955# ifdef VBOX_WITH_CROSSBOW
956 rc = CFGMR3QueryBytes(pCfgHandle, "MAC", &pData->MacAddress, sizeof(pData->MacAddress));
957 if (VBOX_FAILURE(rc))
958 return PDMDRV_SET_ERROR(pDrvIns, rc, N_("Configuration error: Failed to query \"MAC\""));
959# endif
960
961 rc = CFGMR3QueryStringAlloc(pCfgHandle, "Device", &pData->pszDeviceName);
962 if (VBOX_FAILURE(rc))
963 pData->fStatic = false;
964
965 /* Obtain the device name from the setup application (if none was specified). */
966 if (pData->pszSetupApplication)
967 {
968 rc = drvTAPSetupApplication(pData);
969 if (VBOX_FAILURE(rc))
970 return PDMDrvHlpVMSetError(pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
971 N_("Error running TAP setup application. rc=%d"), rc);
972 }
973
974 /*
975 * Do the setup.
976 */
977# ifdef VBOX_WITH_CROSSBOW
978 if (!VBoxLibDlpiFound())
979 {
980 return PDMDrvHlpVMSetError(pDrvIns, VERR_HOSTIF_INIT_FAILED, RT_SRC_POS,
981 N_("Failed to load library %s required for host interface networking."), LIB_DLPI);
982 }
983 rc = SolarisOpenVNIC(pData);
984# else
985 rc = SolarisTAPAttach(pData);
986# endif
987 if (VBOX_FAILURE(rc))
988 return rc;
989
990#else /* !RT_OS_SOLARIS */
991
992 int32_t iFile;
993 rc = CFGMR3QueryS32(pCfgHandle, "FileHandle", &iFile);
994 if (VBOX_FAILURE(rc))
995 return PDMDRV_SET_ERROR(pDrvIns, rc,
996 N_("Configuration error: Query for \"FileHandle\" 32-bit signed integer failed"));
997 pData->FileDevice = (RTFILE)iFile;
998 if (!RTFileIsValid(pData->FileDevice))
999 return PDMDrvHlpVMSetError(pDrvIns, VERR_INVALID_HANDLE, RT_SRC_POS,
1000 N_("The TAP file handle %RTfile is not valid"), pData->FileDevice);
1001#endif /* !RT_OS_SOLARIS */
1002
1003 /*
1004 * Make sure the descriptor is non-blocking and valid.
1005 *
1006 * We should actually query if it's a TAP device, but I haven't
1007 * found any way to do that.
1008 */
1009 if (fcntl(pData->FileDevice, F_SETFL, O_NONBLOCK) == -1)
1010 return PDMDrvHlpVMSetError(pDrvIns, VERR_HOSTIF_IOCTL, RT_SRC_POS,
1011 N_("Configuration error: Failed to configure /dev/net/tun. errno=%d"), errno);
1012 /** @todo determine device name. This can be done by reading the link /proc/<pid>/fd/<fd> */
1013 Log(("drvTAPContruct: %d (from fd)\n", pData->FileDevice));
1014 rc = VINF_SUCCESS;
1015
1016 /*
1017 * Create the control pipe.
1018 */
1019 int fds[2];
1020#ifdef RT_OS_L4
1021 /* XXX We need to tell the library which interface we are using */
1022 fds[0] = vboxrtLinuxFd2VBoxFd(VBOXRT_FT_TAP, 0);
1023#endif
1024 if (pipe(&fds[0]) != 0) /** @todo RTPipeCreate() or something... */
1025 {
1026 int rc = RTErrConvertFromErrno(errno);
1027 AssertRC(rc);
1028 return rc;
1029 }
1030 pData->PipeRead = fds[0];
1031 pData->PipeWrite = fds[1];
1032
1033 /*
1034 * Create the async I/O thread.
1035 */
1036 rc = PDMDrvHlpPDMThreadCreate(pDrvIns, &pData->pThread, pData, drvTAPAsyncIoThread, drvTapAsyncIoWakeup, 128 * _1K, RTTHREADTYPE_IO, "TAP");
1037 AssertRCReturn(rc, rc);
1038
1039#ifdef VBOX_WITH_STATISTICS
1040 /*
1041 * Statistics.
1042 */
1043 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatPktSent, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Number of sent packets.", "/Drivers/TAP%d/Packets/Sent", pDrvIns->iInstance);
1044 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatPktSentBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of sent bytes.", "/Drivers/TAP%d/Bytes/Sent", pDrvIns->iInstance);
1045 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatPktRecv, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_OCCURENCES, "Number of received packets.", "/Drivers/TAP%d/Packets/Received", pDrvIns->iInstance);
1046 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatPktRecvBytes, STAMTYPE_COUNTER, STAMVISIBILITY_ALWAYS, STAMUNIT_BYTES, "Number of received bytes.", "/Drivers/TAP%d/Bytes/Received", pDrvIns->iInstance);
1047 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatTransmit, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_TICKS_PER_CALL, "Profiling packet transmit runs.", "/Drivers/TAP%d/Transmit", pDrvIns->iInstance);
1048 PDMDrvHlpSTAMRegisterF(pDrvIns, &pData->StatReceive, STAMTYPE_PROFILE, STAMVISIBILITY_ALWAYS, STAMUNIT_TICKS_PER_CALL, "Profiling packet receive runs.", "/Drivers/TAP%d/Receive", pDrvIns->iInstance);
1049#endif /* VBOX_WITH_STATISTICS */
1050
1051 return rc;
1052}
1053
1054
1055/**
1056 * TAP network transport driver registration record.
1057 */
1058const PDMDRVREG g_DrvHostInterface =
1059{
1060 /* u32Version */
1061 PDM_DRVREG_VERSION,
1062 /* szDriverName */
1063 "HostInterface",
1064 /* pszDescription */
1065 "TAP Network Transport Driver",
1066 /* fFlags */
1067 PDM_DRVREG_FLAGS_HOST_BITS_DEFAULT,
1068 /* fClass. */
1069 PDM_DRVREG_CLASS_NETWORK,
1070 /* cMaxInstances */
1071 ~0,
1072 /* cbInstance */
1073 sizeof(DRVTAP),
1074 /* pfnConstruct */
1075 drvTAPConstruct,
1076 /* pfnDestruct */
1077 drvTAPDestruct,
1078 /* pfnIOCtl */
1079 NULL,
1080 /* pfnPowerOn */
1081 NULL,
1082 /* pfnReset */
1083 NULL,
1084 /* pfnSuspend */
1085 NULL, /** @todo Do power on, suspend and resume handlers! */
1086 /* pfnResume */
1087 NULL,
1088 /* pfnDetach */
1089 NULL,
1090 /* pfnPowerOff */
1091 NULL
1092};
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette