VirtualBox

Changeset 58340 in vbox for trunk/src/VBox


Ignore:
Timestamp:
Oct 20, 2015 1:58:41 PM (9 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
103540
Message:

HostDrivers: Doxygen fixes

Location:
trunk/src/VBox/HostDrivers
Files:
29 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/VBox/HostDrivers/Support/SUPDrv-dtrace.cpp

    r57358 r58340  
    10461046/**
    10471047 * Module initialization code.
    1048  *
    1049  * @param   hMod            Opque module handle.
    10501048 */
    10511049const SUPDRVTRACERREG * VBOXCALL supdrvDTraceInit(void)

  • trunk/src/VBox/HostDrivers/Support/SUPDrv.cpp

    r57735 r58340  
    23982398 * @param   pSession    Session data.
    23992399 * @param   pReqHdr     The request header.
     2400 * @param   cbReq       The size of the request buffer.
    24002401 */
    24012402int VBOXCALL supdrvIOCtl(uintptr_t uIOCtl, PSUPDRVDEVEXT pDevExt, PSUPDRVSESSION pSession, PSUPREQHDR pReqHdr, size_t cbReq)
    … …  
    26202621 *          All future reference must use this identifier.
    26212622 * @returns NULL on failure.
     2623 * @param   pSession        The caller's session.
     2624 * @param   enmType         The object type.
    26222625 * @param   pfnDestructor   The destructore function which will be called when the reference count reaches 0.
    26232626 * @param   pvUser1         The first user argument.
    … …  
    33813384 * @param   ppvR3       Where to store the address of the Ring-3 mapping.
    33823385 *                      NULL if no ring-3 mapping.
    3383  * @param   ppvR3       Where to store the address of the Ring-0 mapping.
     3386 * @param   ppvR0       Where to store the address of the Ring-0 mapping.
    33843387 *                      NULL if no ring-0 mapping.
    33853388 * @param   paPages     Where to store the addresses of the pages. Optional.
    … …  
    36463649 * Reports a bad context, currenctly that means EFLAGS.AC is 0 instead of 1.
    36473650 *
    3648  * @param   pSession        The session of the caller.
     3651 * @param   pDevExt         The device extension.
    36493652 * @param   pszFile         The source file where the caller detected the bad
    36503653 *                          context.
    … …  
    38693872 *
    38703873 * @returns VBox status code.
    3871  * @param   fIsSmxModeAmbiguous   Where to write whether the SMX mode causes
     3874 * @param   pfIsSmxModeAmbiguous  Where to return whether the SMX mode causes
    38723875 *                                ambiguity that makes us unsure whether we
    38733876 *                                really can use VT-x or not.
    … …  
    38763879 *          The caller is also expected to check that the CPU is an Intel (or
    38773880 *          VIA) CPU -and- that it supports VT-x.  Otherwise, this function
    3878  *          might throw a #GP fault as it tries to read/write MSRs that may not
     3881 *          might throw a \#GP fault as it tries to read/write MSRs that may not
    38793882 *          be present!
    38803883 */
    … …  
    52325235 * @returns IPRT status code.
    52335236 * @param   pDevExt             Device globals.
    5234  * @param   pSession            Session data.
    5235  * @param   pVMMR0              VMMR0 image handle.
     5237 * @param   pvVMMR0             VMMR0 image handle.
    52365238 * @param   pvVMMR0EntryFast    VMMR0EntryFast address.
    52375239 * @param   pvVMMR0EntryEx      VMMR0EntryEx address.

  • trunk/src/VBox/HostDrivers/Support/SUPDrvGip.cpp

    r57358 r58340  
    42424242 *          other error code on internal error.
    42434243 *
    4244  * @param   pThis           Pointer to the grant service instance data.
     4244 * @param   pDevExt         The device instance data.
    42454245 * @param   enmCurState     The current state.
    42464246 * @param   enmNewState     The new state we're waiting for it to enter.

  • trunk/src/VBox/HostDrivers/Support/SUPDrvIOC.h

    r57378 r58340  
    14421442                } Modify;
    14431443
    1444                 /** Reserve space for the future.. */
     1444                /** Reserve space for the future. */
    14451445                uint64_t        auPadding[3];
    14461446            } uArgs;

  • trunk/src/VBox/HostDrivers/Support/SUPDrvInternal.h

    r57378 r58340  
    231231#endif
    232232
     233#ifdef DOXYGEN_RUNNING
     234# define SUPDRV_WITH_MSR_PROBER
     235# define SUPDRV_WITHOUT_MSR_PROBER
     236#endif
     237
    233238#if 1
    234 /**  Use a dedicated kernel thread to service TSC-delta measurement requests.
    235  *   @todo Test on servers with many CPUs and sockets. */
    236 #define SUPDRV_USE_TSC_DELTA_THREAD
    237 #endif
     239/** @def SUPDRV_USE_TSC_DELTA_THREAD
     240 * Use a dedicated kernel thread to service TSC-delta measurement requests.
     241 * @todo Test on servers with many CPUs and sockets. */
     242# define SUPDRV_USE_TSC_DELTA_THREAD
     243#endif
     244
    238245
    239246/*******************************************************************************

  • trunk/src/VBox/HostDrivers/Support/SUPDrvTracer.cpp

    r57358 r58340  
    249249 * @param   uVtgHdrAddr         The address where the header is actually
    250250 *                              loaded.
    251  * @param   cbVtgObj            The alleged size of the header.
    252251 * @param   pbImage             The image base, if available.
    253252 * @param   cbImage             The image size, if available.
    … …  
    868867 *
    869868 * @returns VBox status code.
    870  * @param   pszName             The driver name.
     869 * @param   pDevExt             The device instance data.
    871870 * @param   pVtgHdr             The VTG object header.
    872871 * @param   pImage              The image if applicable.
    … …  
    11031102 *
    11041103 * @param   pSession            The support driver session handle.
    1105  * @param   pVtgHdr             The VTG header.
    11061104 */
    11071105SUPR0DECL(void) SUPR0TracerDeregisterDrv(PSUPDRVSESSION pSession)

  • trunk/src/VBox/HostDrivers/Support/SUPLib.cpp

    r57358 r58340  
    17911791 *
    17921792 * @param   pThis               The string table structure.
    1793  * @param   paProbLocs          The probe location array.
    1794  * @param   cProbLocs           The number of probe locations.
     1793 * @param   paProbeLocs32       The probe location array, 32-bit type variant.
     1794 * @param   paProbeLocs64       The probe location array, 64-bit type variant.
     1795 * @param   cProbeLocs          The number of elements in the array.
     1796 * @param   f32Bit              Set if @a paProbeLocs32 should be used, when
     1797 *                              clear use @a paProbeLocs64.
    17951798 */
    17961799static void supr3TracerDestroyStrTab(PSUPDRVTRACERSTRTAB pThis, PVTGPROBELOC32 paProbeLocs32, PVTGPROBELOC64 paProbeLocs64,
    … …  
    18191822 *
    18201823 * @returns Pointer to a string table structure.  NULL on failure.
    1821  * @param   paProbLocs          The probe location array.
    1822  * @param   cProbLocs           The number of elements in the array.
    1823  * @param   cBits
     1824 * @param   paProbeLocs32       The probe location array, 32-bit type variant.
     1825 * @param   paProbeLocs64       The probe location array, 64-bit type variant.
     1826 * @param   cProbeLocs          The number of elements in the array.
     1827 * @param   offDelta            Relocation offset for the string pointers.
     1828 * @param   f32Bit              Set if @a paProbeLocs32 should be used, when
     1829 *                              clear use @a paProbeLocs64.
    18241830 */
    18251831static PSUPDRVTRACERSTRTAB supr3TracerCreateStrTab(PVTGPROBELOC32 paProbeLocs32,

  • trunk/src/VBox/HostDrivers/Support/SUPLibLdr.cpp

    r57378 r58340  
    350350 *
    351351 * @returns VBox status code.
    352  * @param   pszFilename     Name of the VMMR0 image file
     352 * @param   pszFilename         Name of the VMMR0 image file
     353 * @param   pszModule           The modulen name.
     354 * @param   pszSrvReqHandler    The service request handler symbol name,
     355 *                              optional.
     356 * @param   pErrInfo            Where to store detailed error info. Optional.
     357 * @param   ppvImageBase        Where to return the load address.
    353358 */
    354359static int supLoadModule(const char *pszFilename, const char *pszModule, const char *pszSrvReqHandler,

  • trunk/src/VBox/HostDrivers/Support/SUPR0IdcClientStubs.c

    r57358 r58340  
    4040 *
    4141 * @param   pHandle     The IDC handle.
     42 * @param   ppfn        Where to return the address of the symbol.
    4243 * @param   pszName     The name of the symbol.
    4344 */
    … …  
    6667 * @returns Pointer to the symbol on success, NULL on failure.
    6768 *
    68  * @param   pHandle     The IDC handle.
     69 * @param   pSession    The IDC session.
     70 * @param   ppfn        Where to return the address of the symbol.
    6971 * @param   pszName     The name of the symbol.
    7072 */

  • trunk/src/VBox/HostDrivers/Support/SUPR3HardenedMain.cpp

    r58132 r58340  
    845845
    846846/**
    847  * Returns the full path to the executable.
     847 * Returns the full path to the executable in g_szSupLibHardenedExePath.
    848848 *
    849849 * @returns IPRT status code.
    850  * @param   pszPath     Where to store it.
    851  * @param   cchPath     How big that buffer is.
    852850 */
    853851static void supR3HardenedGetFullExePath(void)

  • trunk/src/VBox/HostDrivers/Support/SUPSvc.cpp

    r57358 r58340  
    305305 *
    306306 * @param   pszFormat   The log string. No trailing newline.
    307  * @param   ...         Format arguments.
     307 * @param   va          Format arguments.
    308308 *
    309309 * @todo    This should later be replaced by the release logger and callback destination(s).

  • trunk/src/VBox/HostDrivers/Support/SUPSvcInternal.h

    r56293 r58340  
    5454 * Logs the message to the appropriate system log.
    5555 *
    56  * @param   psMsg       The log string.
     56 * @param   pszMsg      The log string.
    5757 */
    5858void supSvcOsLogErrorStr(const char *pszMsg);

  • trunk/src/VBox/HostDrivers/Support/darwin/SUPDrv-darwin.cpp

    r58277 r58340  
    849849 *
    850850 * @returns VBox status code, see supdrvIDC.
    851  * @param   iReq        The request code.
     851 * @param   uReq        The request code.
    852852 * @param   pReq        The request.
    853853 */

  • trunk/src/VBox/HostDrivers/Support/freebsd/SUPDrv-freebsd.c

    r57358 r58340  
    7575static d_open_t     VBoxDrvFreeBSDOpenUsr;
    7676static d_open_t     VBoxDrvFreeBSDOpenSys;
    77 static void         VBoxDrvFreeBSDDtr(void *pData);
     77static void         VBoxDrvFreeBSDDtr(void *pvData);
    7878static d_ioctl_t    VBoxDrvFreeBSDIOCtl;
    7979static int          VBoxDrvFreeBSDIOCtlSlow(PSUPDRVSESSION pSession, u_long ulCmd, caddr_t pvData, struct thread *pTd);
    … …  
    225225 * @returns 0 on success, errno on failure.
    226226 *          EBUSY if the device is used by someone else.
    227  * @param   pDev        The device node.
    228  * @param   fOpen       The open flags.
    229  * @param   pTd         The thread.
    230  * @param   iDevType    ???
    231  */
    232 static int vboxdrvFreeBSDOpenCommon(struct cdev *pDev, int fOpen, int iDevtype, struct thread *pTd, bool fUnrestricted)
     227 * @param   pDev            The device node.
     228 * @param   fOpen           The open flags.
     229 * @param   iDevType        Some device type thing we don't use.
     230 * @param   pTd             The thread.
     231 * @param   fUnrestricted   Set if opening /dev/vboxdrv, clear if /dev/vboxdrvu.
     232 */
     233static int vboxdrvFreeBSDOpenCommon(struct cdev *pDev, int fOpen, int iDevType, struct thread *pTd, bool fUnrestricted)
    233234{
    234235    PSUPDRVSESSION pSession;
    … …  
    253254        pSession->Uid = stuff;
    254255        pSession->Gid = stuff; */
    255         devfs_set_cdevpriv(pSession, VBoxDrvFreeBSDDtr);
     256        rc = devfs_set_cdevpriv(pSession, vboxdrvFreeBSDDtr); Assert(rc == 0);
    256257        Log(("VBoxDrvFreeBSDOpen: pSession=%p\n", pSession));
    257258        ASMAtomicIncU32(&g_cUsers);
    … …  
    264265
    265266/** For vboxdrv. */
    266 static int VBoxDrvFreeBSDOpenSys(struct cdev *pDev, int fOpen, int iDevtype, struct thread *pTd)
    267 {
    268     return vboxdrvFreeBSDOpenCommon(pDev, fOpen, iDevtype, pTd, true);
     267static int VBoxDrvFreeBSDOpenSys(struct cdev *pDev, int fOpen, int iDevType, struct thread *pTd)
     268{
     269    return vboxdrvFreeBSDOpenCommon(pDev, fOpen, iDevType, pTd, true);
    269270}
    270271
    271272
    272273/** For vboxdrvu. */
    273 static int VBoxDrvFreeBSDOpenUsr(struct cdev *pDev, int fOpen, int iDevtype, struct thread *pTd)
    274 {
    275     return vboxdrvFreeBSDOpenCommon(pDev, fOpen, iDevtype, pTd, false);
    276 }
    277 
    278 
    279 /**
    280  * Close a file device previously opened by VBoxDrvFreeBSDOpen
     274static int VBoxDrvFreeBSDOpenUsr(struct cdev *pDev, int fOpen, int iDevType, struct thread *pTd)
     275{
     276    return vboxdrvFreeBSDOpenCommon(pDev, fOpen, iDevType, pTd, false);
     277}
     278
     279
     280/**
     281 * Close a file device previously opened by VBoxDrvFreeBSDOpen.
    281282 *
    282283 * @returns 0 on success.
    283  * @param   pDev        The device.
    284  * @param   fFile       The file descriptor flags.
    285  * @param   DevType     The device type (CHR.
    286  * @param   pTd         The calling thread.
    287  */
    288 static void VBoxDrvFreeBSDDtr(void *pData)
    289 {
    290     PSUPDRVSESSION pSession = pData;
    291     Log(("VBoxDrvFreeBSDDtr: pSession=%p\n", pSession));
     284 * @param   pvData      The session being closed.
     285 */
     286static void vboxdrvFreeBSDDtr(void *pvData)
     287{
     288    PSUPDRVSESSION pSession = pvData;
     289    Log(("vboxdrvFreeBSDDtr: pSession=%p\n", pSession));
    292290
    293291    /*
    … …  
    469467 *
    470468 * @returns VBox status code, see supdrvIDC.
    471  * @param   iReq        The request code.
     469 * @param   uReq        The request code.
    472470 * @param   pReq        The request.
    473471 */

  • trunk/src/VBox/HostDrivers/Support/linux/SUPDrv-linux.c

    r57840 r58340  
    604604 * Suspend callback.
    605605 * @param   pDev        Pointer to the platform device.
    606  * @param   State       message type, see Documentation/power/devices.txt.
    607  */
    608 # if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 30)
     606 * @param   State       Message type, see Documentation/power/devices.txt.
     607 *                      Ignored.
     608 */
     609# if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 30) && !defined(DOXYGEN_RUNNING)
    609610static int VBoxDrvSuspend(struct device *pDev)
    610611# else
    … …  
    640641 * @param   ulArg       The argument specified to ioctl().
    641642 */
    642 #ifdef HAVE_UNLOCKED_IOCTL
     643#if defined(HAVE_UNLOCKED_IOCTL) || defined(DOXYGEN_RUNNING)
    643644static long VBoxDrvLinuxIOCtl(struct file *pFilp, unsigned int uCmd, unsigned long ulArg)
    644645#else
    … …  
    811812 *
    812813 * @returns VBox status code, see supdrvIDC.
    813  * @param   iReq        The request code.
     814 * @param   uReq        The request code.
    814815 * @param   pReq        The request.
    815816 */

  • trunk/src/VBox/HostDrivers/Support/solaris/SUPDrv-solaris.c

    r57358 r58340  
    665665 * @param   Dev             Device number
    666666 * @param   Cmd             Operation identifier
    667  * @param   pArg            Arguments from user to driver
     667 * @param   pArgs           Arguments from user to driver
    668668 * @param   Mode            Information bitfield (read/write, address space etc.)
    669669 * @param   pCred           User credentials
    … …  
    745745 *
    746746 * @param   pSession    The session.
    747  * @param   Cmd         The IOCtl command.
     747 * @param   iCmd        The IOCtl command.
    748748 * @param   Mode        Information bitfield (for specifying ownership of data)
    749749 * @param   iArg        User space address of the request buffer.
    … …  
    849849 *
    850850 * @returns VBox status code, see supdrvIDC.
    851  * @param   iReq        The request code.
     851 * @param   uReq        The request code.
    852852 * @param   pReq        The request.
    853853 */

  • trunk/src/VBox/HostDrivers/Support/win/SUPDrv-win.cpp

    r57501 r58340  
    10051005 * @param   pvOutput            The output buffer as specfied by the user.
    10061006 * @param   cbOutput            The size of the output buffer.
    1007  * @param   uFunction           The function.
     1007 * @param   uCmd                The I/O command/function being invoked.
    10081008 * @param   pIoStatus           Where to return the status of the operation.
    10091009 * @param   pDevObj             The device object..
    … …  
    12591259 * @returns NT status code.
    12601260 *
    1261  * @param   pDevObj     Device object.
     1261 * @param   pDevExt     Device extension.
    12621262 * @param   pSession    The session.
    12631263 * @param   pIrp        Request packet.

  • trunk/src/VBox/HostDrivers/VBoxNetAdp/VBoxNetAdp.c

    r57358 r58340  
    12021202 *
    12031203 * @returns Pointer to the instance by the given name. NULL if not found.
    1204  * @param   pGlobals        The globals.
    12051204 * @param   pszName         The name of the instance.
    12061205 */

  • trunk/src/VBox/HostDrivers/VBoxNetAdp/darwin/VBoxNetAdp-darwin.cpp

    r58093 r58340  
    337337 * Device open. Called on open /dev/vboxnetctl
    338338 *
    339  * @param   pInode      Pointer to inode info structure.
    340  * @param   pFilp       Associated file pointer.
     339 * @param   Dev         The device number.
     340 * @param   fFlags      ???.
     341 * @param   fDevType    ???.
     342 * @param   pProcess    The process issuing this request.
    341343 */
    342344static int VBoxNetAdpDarwinOpen(dev_t Dev, int fFlags, int fDevType, struct proc *pProcess)

  • trunk/src/VBox/HostDrivers/VBoxNetFlt/VBoxNetFltInternal.h

    r56293 r58340  
    382382 *
    383383 * @param   pThis           The instance.
     384 * @param   fActive         Whether to active (@c true) or deactive.
    384385 *
    385386 * @remarks Owns the lock for the out-bound trunk port.

  • trunk/src/VBox/HostDrivers/VBoxNetFlt/linux/VBoxNetFlt-linux.c

    r58254 r58340  
    771771 * @param   pBuf                The sk_buff.
    772772 * @param   pSG                 The SG.
    773  * @param   pvFrame             The frame pointer, optional.
    774773 * @param   cSegs               The number of segments allocated for the SG.
    775774 *                              This should match the number in the mbuf exactly!
    776775 * @param   fSrc                The source of the frame.
    777  * @param   pGso                Pointer to the GSO context if it's a GSO
     776 * @param   pGsoCtx             Pointer to the GSO context if it's a GSO
    778777 *                              internal network frame.  NULL if regular frame.
    779778 */
    … …  
    846845
    847846/**
    848  * Packet handler,
    849  *
    850  * @returns 0 or EJUSTRETURN.
    851  * @param   pThis           The instance.
    852  * @param   pMBuf           The mbuf.
    853  * @param   pvFrame         The start of the frame, optional.
    854  * @param   fSrc            Where the packet (allegedly) comes from, one INTNETTRUNKDIR_* value.
    855  * @param   eProtocol       The protocol.
     847 * Packet handler; not really documented - figure it out yourself.
     848 *
     849 * @returns 0 or EJUSTRETURN - this is probably copy & pastry and thus wrong.
    856850 */
    857851#if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 14)
    … …  
    13721366
    13731367/**
    1374  *
     1368 * I won't disclose what I do, figure it out yourself, including pThis referencing.
     1369 *
     1370 * @param   pThis       The net filter instance.
    13751371 * @param   pBuf        The socket buffer.  This is consumed by this function.
    13761372 */
    … …  
    16091605 * @returns VBox status code.
    16101606 * @param   pThis           The instance.
    1611  * @param   fRediscovery    If set we're doing a rediscovery attempt, so, don't
    1612  *                          flood the release log.
     1607 * @param   pDev            The device to attach to.
    16131608 */
    16141609static int vboxNetFltLinuxAttachToInterface(PVBOXNETFLTINS pThis, struct net_device *pDev)

  • trunk/src/VBox/HostDrivers/VBoxNetFlt/solaris/VBoxNetFlt-solaris.c

    r57358 r58340  
    124124 * Stream Driver hooks.
    125125 */
    126 static int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pArg, void **ppResult);
     126static int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pArg, void **ppvResult);
    127127static int VBoxNetFltSolarisAttach(dev_info_t *pDip, ddi_attach_cmd_t enmCmd);
    128128static int VBoxNetFltSolarisDetach(dev_info_t *pDip, ddi_detach_cmd_t enmCmd);
    … …  
    718718 * @returns  corresponding solaris error code.
    719719 */
    720 static int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pvArg, void **ppResult)
     720static int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pvArg, void **ppvResult)
    721721{
    722722    LogFunc((DEVICE_NAME ":VBoxNetFltSolarisGetInfo pDip=%p enmCmd=%d pArg=%p instance=%d\n", pDip, enmCmd,
    … …  
    727727        case DDI_INFO_DEVT2DEVINFO:
    728728        {
    729             *ppResult = g_pVBoxNetFltSolarisDip;
     729            *ppvResult = g_pVBoxNetFltSolarisDip;
    730730            return DDI_SUCCESS;
    731731        }
    … …  
    734734        {
    735735            int instance = getminor((dev_t)pvArg);
    736             *ppResult = (void *)(uintptr_t)instance;
     736            *ppvResult = (void *)(uintptr_t)instance;
    737737            return DDI_SUCCESS;
    738738        }
    … …  
    13181318 *
    13191319 * @returns VBox status code.
    1320  * @param   pQueue      Pointer to the read queue.
     1320 * @param   pPromiscStream  Pointer to the read queue.
    13211321 */
    13221322static int vboxNetFltSolarisSetRawMode(vboxnetflt_promisc_stream_t *pPromiscStream)
    … …  
    18221822 *
    18231823 * @returns VBox status code.
     1824 * @param   pVNode  Pointer to the device vnode.
    18241825 * @param   MuxId   The multiplexor ID.
    18251826 * @param   pFd     Where to store the lower stream file descriptor.
    … …  
    19091910 *
    19101911 * @returns VBox status code.
     1912 * @param   fAttach     Is this an attach or detach.
    19111913 * @param   pVNode      Pointer to the lower stream vnode.
    19121914 * @param   pModPos     Where to store the module position.
    … …  
    26452647 * Ipv6 dynamic attachment timer callback to attach to the Ipv6 stream if needed.
    26462648 *
    2647  * @param   pThis           Pointer to the timer.
     2649 * @param   pTimer          Pointer to the timer.
    26482650 * @param   pvData          Opaque pointer to the instance.
    26492651 * @param   iTick           Timer tick (unused).
    … …  
    28512853 * @param   pThis           The instance.
    28522854 * @param   pSG             Pointer to the scatter-gather list.
     2855 * @param   fDst            The destination mask, INTNETTRUNKDIR_XXX. Ignored.
    28532856 */
    28542857static mblk_t *vboxNetFltSolarisMBlkFromSG(PVBOXNETFLTINS pThis, PINTNETSG pSG, uint32_t fDst)
    … …  
    29672970 * @returns VBox status code.
    29682971 * @param   pMsg        Pointer to the raw message.
    2969  * @param   pDlpiMsg    Where to store the M_PROTO message.
     2972 * @param   ppDlpiMsg   Where to store the M_PROTO message.
    29702973 *
    29712974 * @remarks The original raw message would be no longer valid and will be
    … …  
    33703373 * @param   pStream     Pointer to the stream.
    33713374 * @param   pQueue      Pointer to the read queue.
    3372  * @param   pOrigMsg    Pointer to the message.
     3375 * @param   pMsg        Pointer to the message.
    33733376 */
    33743377static int vboxNetFltSolarisRecv(PVBOXNETFLTINS pThis, vboxnetflt_stream_t *pStream, queue_t *pQueue, mblk_t *pMsg)

  • trunk/src/VBox/HostDrivers/VBoxNetFlt/solaris/VBoxNetFltBow-solaris.c

    r57867 r58340  
    121121LOCAL int VBoxNetFltSolarisAttach(dev_info_t *pDip, ddi_attach_cmd_t enmCmd);
    122122LOCAL int VBoxNetFltSolarisDetach(dev_info_t *pDip, ddi_detach_cmd_t enmCmd);
    123 LOCAL int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pArg, void **ppResult);
     123LOCAL int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pArg, void **ppvResult);
    124124
    125125
    … …  
    425425 * @returns corresponding solaris error code.
    426426 */
    427 LOCAL int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pvArg, void **ppResult)
     427LOCAL int VBoxNetFltSolarisGetInfo(dev_info_t *pDip, ddi_info_cmd_t enmCmd, void *pvArg, void **ppvResult)
    428428{
    429429    Log((DEVICE_NAME ":VBoxNetFltSolarisGetInfo pDip=%p enmCmd=%d pArg=%p instance=%d\n", pDip, enmCmd, getminor((dev_t)pvArg)));
    … …  
    433433        case DDI_INFO_DEVT2DEVINFO:
    434434        {
    435             *ppResult = g_pVBoxNetFltSolarisDip;
     435            *ppvResult = g_pVBoxNetFltSolarisDip;
    436436            return DDI_SUCCESS;
    437437        }
    … …  
    440440        {
    441441            int instance = getminor((dev_t)pvArg);
    442             *ppResult = (void *)(uintptr_t)instance;
     442            *ppvResult = (void *)(uintptr_t)instance;
    443443            return DDI_SUCCESS;
    444444        }
    … …  
    812812 * @param   pThis           The instance.
    813813 * @param   pVNIC           Pointer to the VNIC.
    814  * @param   pVNICTemplate   Pointer to the VNIC template initialize from, can be
    815  *                          NULL.
    816814 *
    817815 * @returns VBox status code.

  • trunk/src/VBox/HostDrivers/VBoxPci/VBoxPci.c

    r58132 r58340  
    293293
    294294/**
    295  * @interface_method_impl{RAWPCIDEVPORT,pfnUnapRegion}
     295 * @interface_method_impl{RAWPCIDEVPORT,pfnUnmapRegion}
    296296 */
    297297static DECLCALLBACK(int) vboxPciDevUnmapRegion(PRAWPCIDEVPORT pPort,

  • trunk/src/VBox/HostDrivers/VBoxPci/linux/VBoxPci-linux.c

    r57594 r58340  
    883883 * @param   iIrq            The IRQ number.
    884884 * @param   pvDevId         The device ID, a pointer to PVBOXRAWPCIINS.
    885  * @param   pvRegs          Register set. Removed in 2.6.19.
     885 * @param   pRegs           Register set. Removed in 2.6.19.
    886886 */
    887 #if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 19)
     887#if LINUX_VERSION_CODE >= KERNEL_VERSION(2, 6, 19) && !defined(DOXYGEN_RUNNING)
    888888static irqreturn_t vboxPciOsIrqHandler(int iIrq, void *pvDevId)
    889889#else

  • trunk/src/VBox/HostDrivers/VBoxUSB/VBoxUSBFilterMgr.cpp

    r57358 r58340  
    402402 *
    403403 * @returns Owner on if matched, VBOXUSBFILTER_CONTEXT_NIL it not matched.
    404  * @param   pDevice     The device data as a filter structure.
    405  *                      See USBFilterMatch for how to construct this.
    406  * @param   puId        Where to store the filter id (optional).
    407  * @param   pfFilter    Where to store whether the device must be filtered or not
    408  */
    409 VBOXUSBFILTER_CONTEXT VBoxUSBFilterMatchEx(PCUSBFILTER pDevice, uintptr_t *puId, bool fRemoveFltIfOneShot, bool *pfFilter, bool *pfIsOneShot)
     404 * @param   pDevice             The device data as a filter structure.
     405 *                              See USBFilterMatch for how to construct this.
     406 * @param   puId                Where to store the filter id (optional).
     407 * @param   fRemoveFltIfOneShot Whether or not to remove one-shot filters on
     408 *                              match.
     409 * @param   pfFilter            Where to store whether the device must be filtered or not
     410 * @param   pfIsOneShot         Where to return whetehr the match was a one-shot
     411 *                              filter or not.  Optional.
     412 *
     413 */
     414VBOXUSBFILTER_CONTEXT VBoxUSBFilterMatchEx(PCUSBFILTER pDevice, uintptr_t *puId,
     415                                           bool fRemoveFltIfOneShot, bool *pfFilter, bool *pfIsOneShot)
    410416{
    411417    /*

  • trunk/src/VBox/HostDrivers/VBoxUSB/VBoxUSBFilterMgr.h

    r56293 r58340  
    2323RT_C_DECLS_BEGIN
    2424
     25/** @todo r=bird: VBOXUSBFILTER_CONTEXT isn't following the coding
     26 *        guildlines. Don't know which clueless dude did this...  */
    2527#if defined(RT_OS_WINDOWS)
    2628typedef struct VBOXUSBFLTCTX *VBOXUSBFILTER_CONTEXT;

  • trunk/src/VBox/HostDrivers/VBoxUSB/solaris/VBoxUSB-solaris.c

    r57358 r58340  
    330330LOCAL bool vboxUSBSolarisIsUSBDevice(dev_info_t *pDip);
    331331
    332 /** Device Operation Hooks */
     332/** @name Device Operation Hooks
     333 * @{ */
    333334LOCAL int vboxUSBSolarisSendURB(vboxusb_state_t *pState, PVBOXUSBREQ_URB pUrbReq, int Mode);
    334335LOCAL int vboxUSBSolarisReapURB(vboxusb_state_t *pState, PVBOXUSBREQ_URB pUrbReq, int Mode);
    … …  
    340341LOCAL int vboxUSBSolarisAbortPipe(vboxusb_state_t *pState, uint8_t bEndpoint);
    341342LOCAL int vboxUSBSolarisGetConfigIndex(vboxusb_state_t *pState, uint_t uCfgValue);
    342 
    343 /** Hotplug & Power Management Hooks */
     343/** @} */
     344
     345/** @name Hotplug & Power Management Hooks
     346 * @{ */
    344347LOCAL inline void vboxUSBSolarisNotifyHotplug(vboxusb_state_t *pState);
    345348LOCAL int vboxUSBSolarisDeviceDisconnected(dev_info_t *pDip);
    … …  
    353356LOCAL void vboxUSBSolarisPowerBusy(vboxusb_state_t *pState);
    354357LOCAL void vboxUSBSolarisPowerIdle(vboxusb_state_t *pState);
    355 
    356 /** Monitor Hooks */
     358/** @} */
     359
     360/** @name Monitor Hooks
     361 * @{ */
    357362int VBoxUSBMonSolarisRegisterClient(dev_info_t *pClientDip, PVBOXUSB_CLIENT_INFO pClientInfo);
    358363int VBoxUSBMonSolarisUnregisterClient(dev_info_t *pClientDip);
    359 
    360 /** Callbacks from Monitor */
     364/** @} */
     365
     366/** @name Callbacks from Monitor
     367 * @{ */
    361368LOCAL int vboxUSBSolarisSetConsumerCredentials(RTPROCESS Process, int Instance, void *pvReserved);
     369/** @} */
    362370
    363371
    … …  
    15511559 * Convert Solaris' USBA device state to VBox's error code.
    15521560 *
    1553  * @param   UsbRc           Solaris USBA error code.
     1561 * @param   uDeviceState        The USB device state to convert.
    15541562 *
    15551563 * @returns VBox error code.
    … …  
    20602068 *
    20612069 * @param   pState          The USB device instance.
    2062  * @param   uCfgValue       The Configuration value.
     2070 * @param   bCfgValue       The Configuration value.
    20632071 *
    20642072 * @returns VBox error code.
    … …  
    22162224 *
    22172225 * @param   pState          The USB device instance.
    2218  * @param   ResetLevel      The reset level.
     2226 * @param   enmReset        The reset level.
    22192227 *
    22202228 * @returns VBox error code.
    … …  
    23502358 * @param   pEpData         The Endpoint data.
    23512359 * @param   uCfgValue       The Configuration value.
    2352  * @param   uCfgIndex       The Configuration index.
    23532360 * @param   uInterface      The Interface.
    23542361 * @param   uAlt            The Alternate setting.
    … …  
    23572364 */
    23582365LOCAL int vboxUSBSolarisInitEndPoint(vboxusb_state_t *pState, usb_ep_data_t *pEpData, uchar_t uCfgValue,
    2359                                 uchar_t uInterface, uchar_t uAlt)
     2366                                     uchar_t uInterface, uchar_t uAlt)
    23602367{
    23612368    LogFunc((DEVICE_NAME ":vboxUSBSolarisInitEndPoint pState=%p pEpData=%p CfgVal=%d Iface=%d Alt=%d", pState,
    … …  
    28152822 *
    28162823 * @param   pState          The USB device instance.
    2817  * @param   pUrb            The URB to initialize.
    28182824 * @param   pUrbReq         Opaque pointer to the complete request.
    2819  * @param   pMsg            Pointer to the allocated request data.
    28202825 *
    28212826 * @returns The allocated Isoc. In URB to be used.

  • trunk/src/VBox/HostDrivers/VBoxUSB/solaris/VBoxUSBMon-solaris.c

    r57358 r58340  
    669669 *
    670670 * @param   iFunction           The requested function.
    671  * @param   pvState             Opaque pointer to driver state used for getting ring-3 process (Id).
    672  * @param   pvData              The input/output data buffer. Can be NULL depending on the function.
     671 * @param   pvState             Opaque pointer to driver state used for getting
     672 *                              ring-3 process (Id).
     673 * @param   pvData              The input/output data buffer. Can be NULL
     674 *                              depending on the function.
    673675 * @param   cbData              The max size of the data buffer.
    674  * @param   pcbDataReturned     Where to store the amount of returned data. Can be NULL.
     676 * @param   pcbReturnedData     Where to store the amount of returned data.  Can
     677 *                              be NULL.
    675678 */
    676679static int vboxUSBMonSolarisProcessIOCtl(int iFunction, void *pvState, void *pvData, size_t cbData, size_t *pcbReturnedData)
    … …  
    904907 *
    905908 * @returns VBox status code.
    906  * @param   pszDevicePath       The device path of the client driver.
    907  * @param   Instance            The client driver instance.
    908909 */
    909910int VBoxUSBMonSolarisRegisterClient(dev_info_t *pClientDip, PVBOXUSB_CLIENT_INFO pClientInfo)
    … …  
    933934            return VINF_SUCCESS;
    934935        }
    935         else
    936             return VERR_NO_MEMORY;
    937     }
    938     else
    939         return VERR_INVALID_STATE;
     936        return VERR_NO_MEMORY;
     937    }
     938    return VERR_INVALID_STATE;
    940939}
    941940
    … …  
    945944 *
    946945 * @returns VBox status code.
    947  * @param   pszDevicePath       The device path of the client driver.
    948  * @param   Instance            The client driver instance.
    949946 */
    950947int VBoxUSBMonSolarisUnregisterClient(dev_info_t *pClientDip)
    … …  
    985982        return VERR_NOT_FOUND;
    986983    }
    987     else
    988         return VERR_INVALID_STATE;
     984    return VERR_INVALID_STATE;
    989985}
    990986
Note: See TracChangeset for help on using the changeset viewer.

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