VirtualBox

Changeset 57974 in vbox


Ignore:
Timestamp:
Sep 30, 2015 6:27:04 PM (9 years ago)
Author:
vboxsync
svn:sync-xref-src-repo-rev:
102972
Message:

IPRT: Some more doxygen fixes.

Location:
trunk
Files:
19 edited

Legend:

Unmodified
Added
Removed

  • TabularUnified trunk/include/iprt/list-off32.h

    r57926 r57974  
    207207 * Checks if a node is the last element in the list.
    208208 *
    209  * @retval  @c true if the node is the last element in the list.
    210  * @retval  @c false otherwise
     209 * @retval  true if the node is the last element in the list.
     210 * @retval  false otherwise
    211211 *
    212212 * @param   pList               The list.
    … …  
    218218 * Checks if a node is the first element in the list.
    219219 *
    220  * @retval  @c true if the node is the first element in the list.
    221  * @retval  @c false otherwise.
     220 * @retval  true if the node is the first element in the list.
     221 * @retval  false otherwise.
    222222 *
    223223 * @param   pList               The list.
    … …  
    229229 * Checks if a type converted node is actually the dummy element (@a pList).
    230230 *
    231  * @retval  @c true if the node is the dummy element in the list.
    232  * @retval  @c false otherwise.
     231 * @retval  true if the node is the dummy element in the list.
     232 * @retval  false otherwise.
    233233 *
    234234 * @param   pList               The list.
    … …  
    250250 * Checks if a list is empty.
    251251 *
    252  * @retval  @c true if the list is empty.
    253  * @retval  @c false otherwise.
     252 * @retval  true if the list is empty.
     253 * @retval  false otherwise.
    254254 *
    255255 * @param   pList               The list to check.

  • TabularUnified trunk/include/iprt/log.h

    r57926 r57974  
    23262326 *
    23272327 * @param   pszFormat   Printf like format string.
    2328  * @param   args        Optional arguments as specified in pszFormat.
     2328 * @param   va          Optional arguments as specified in pszFormat.
    23292329 *
    23302330 * @remark The API doesn't support formatting of floating point numbers at the moment.
    23312331 */
    2332 RTDECL(void) RTLogPrintfV(const char *pszFormat, va_list args)  RT_IPRT_FORMAT_ATTR(1, 0);
     2332RTDECL(void) RTLogPrintfV(const char *pszFormat, va_list va)  RT_IPRT_FORMAT_ATTR(1, 0);
    23332333
    23342334/**

  • TabularUnified trunk/src/VBox/Runtime/Makefile.kmk

    r57949 r57974  
    27262726                $(comp-vars IPRT_DOXYFILE_OUTPUT,DOXYGEN_OUTPUT_PREV,FORCE) \
    27272727                | $$(dir $$@)
    2728         $(RM) -f $@ $@.tmp $@.dep
    2729         $(CP) -f $(VBOX_PATH_RUNTIME_SRC)/Doxyfile $@.tmp
    2730         $(APPEND) $@.tmp
    2731         $(APPEND) $@.tmp "OUTPUT_DIRECTORY = $(IPRT_DOXYFILE_OUTPUT)"
    2732         $(APPEND) $@.tmp "WARN_LOGFILE = $(IPRT_DOXYFILE_OUTPUT)/errors"
    2733         $(APPEND) $@.tmp "INCLUDE_PATH = $(PATH_ROOT)/include include . common/table"
    2734         $(APPEND) $@.tmp "INCLUDE_FILE_PATTERNS = *.cpp.h"
    2735         $(APPEND) $@.tmp "PREDEFINED += $(ARCH_BITS_DEFS)"
    2736         $(APPEND) $@.tmp 'EXCLUDE = '\
     2728        $(QUIET)$(RM) -f $@ $@.tmp $@.dep
     2729        $(QUIET)$(CP) -f $(VBOX_PATH_RUNTIME_SRC)/Doxyfile $@.tmp
     2730        $(QUIET)$(APPEND) $@.tmp
     2731        $(QUIET)$(APPEND) $@.tmp "OUTPUT_DIRECTORY = $(IPRT_DOXYFILE_OUTPUT)"
     2732        $(QUIET)$(APPEND) $@.tmp "WARN_LOGFILE = $(IPRT_DOXYFILE_OUTPUT)/errors"
     2733        $(QUIET)$(APPEND) $@.tmp "INCLUDE_PATH = $(PATH_ROOT)/include include . common/table"
     2734        $(QUIET)$(APPEND) $@.tmp "INCLUDE_FILE_PATTERNS = *.cpp.h"
     2735        $(QUIET)$(APPEND) $@.tmp "PREDEFINED += $(ARCH_BITS_DEFS)"
     2736        $(QUIET)$(APPEND) $@.tmp 'EXCLUDE = '\
    27372737                '$(VBOX_PATH_RUNTIME_SRC)/common/string/unidata-flags.cpp' \
    27382738        '$(VBOX_PATH_RUNTIME_SRC)/common/string/unidata-lower.cpp' \
    2739         '$(VBOX_PATH_RUNTIME_SRC)/common/string/unidata-upper.cpp'
    2740         $(APPEND) $@.tmp
    2741         $(APPEND) $@.tmp "INPUT = $(IPRT_DOXYFILE_INPUT)"
    2742         $(APPEND) $@.tmp
    2743         $(MV) -f $@.tmp $@
    2744         @$(APPEND) $@.dep "DOXYGEN_OUTPUT_PREV = $(IPRT_DOXYFILE_OUTPUT)"
    2745         @$(APPEND) $@.dep "DOXYGEN_INPUT_PREV = $(IPRT_DOXYFILE_INPUT)"
     2739        '$(VBOX_PATH_RUNTIME_SRC)/common/string/unidata-upper.cpp' \
     2740        '$(VBOX_PATH_RUNTIME_SRC)/common/ldr/ldrkStuff.cpp'
     2741        $(QUIET)$(APPEND) $@.tmp
     2742        $(QUIET)$(APPEND) $@.tmp "INPUT = $(IPRT_DOXYFILE_INPUT)"
     2743        $(QUIET)$(APPEND) $@.tmp
     2744        $(QUIET)$(MV) -f $@.tmp $@
     2745        $(QUIET)$(APPEND) $@.dep "DOXYGEN_OUTPUT_PREV = $(IPRT_DOXYFILE_OUTPUT)"
     2746        $(QUIET)$(APPEND) $@.dep "DOXYGEN_INPUT_PREV = $(IPRT_DOXYFILE_INPUT)"
    27462747
    27472748# Do the actual job.
    27482749$(IPRT_OUT_DIR)/docs.iprt: $(IPRT_OUT_DIR)/Doxyfile.iprt $$(IPRT_DOXYFILE_INPUT) | $(IPRT_DOXYFILE_OUTPUT)/
    2749         $(RM) -f $(wildcard $(IPRT_DOXYFILE_OUTPUT)/html/*) $(IPRT_OUT_DIR)/docs.iprt
    2750         doxygen $(IPRT_OUT_DIR)/Doxyfile.iprt
     2750        $(QUIET)$(RM) -f $(wildcard $(IPRT_DOXYFILE_OUTPUT)/html/*) $(IPRT_OUT_DIR)/docs.iprt
     2751        doxygen $(DOXYGEN_OPTS) $(IPRT_OUT_DIR)/Doxyfile.iprt
    27512752        $(APPEND) $(IPRT_OUT_DIR)/docs.iprt
    27522753

  • TabularUnified trunk/src/VBox/Runtime/VBox/log-vbox.cpp

    r57358 r57974  
    7373 *
    7474 *
    75  * @section sec_logging_destination     The Group Specifier.
     75 * @section sec_logging_group           The Group Specifier.
    7676 *
    7777 * The {logger-env-base} environment variable can be used to specify which

  • TabularUnified trunk/src/VBox/Runtime/VBox/logbackdoor-redirect.cpp

    r57358 r57974  
    114114
    115115/* Do nothing for now. */
    116 RTDECL(void) RTLogFlush(PRTLOGGER)
     116RTDECL(void) RTLogFlush(PRTLOGGER pLogger)
    117117{
     118    NOREF(pLogger);
    118119}
    119120

  • TabularUnified trunk/src/VBox/Runtime/common/checksum/manifest2.cpp

    r57926 r57974  
    309309
    310310/**
    311  * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation.}
     311 * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation}
    312312 */
    313313static DECLCALLBACK(int) rtManifestAttributeClearVisited(PRTSTRSPACECORE pStr, void *pvUser)
    … …  
    321321
    322322/**
    323  * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation.}
     323 * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation}
    324324 */
    325325static DECLCALLBACK(int) rtManifestEntryClearVisited(PRTSTRSPACECORE pStr, void *pvUser)
    … …  
    334334
    335335/**
    336  * @callback_method_impl{FNRTSTRSPACECALLBACK, Finds the first missing.}
     336 * @callback_method_impl{FNRTSTRSPACECALLBACK, Finds the first missing}
    337337 */
    338338static DECLCALLBACK(int) rtManifestAttributeFindMissing2(PRTSTRSPACECORE pStr, void *pvUser)
    … …  
    375375
    376376/**
    377  * @callback_method_impl{FNRTSTRSPACECALLBACK, Finds the first missing.}
     377 * @callback_method_impl{FNRTSTRSPACECALLBACK, Finds the first missing}
    378378 */
    379379static DECLCALLBACK(int) rtManifestEntryFindMissing2(PRTSTRSPACECORE pStr, void *pvUser)
    … …  
    411411
    412412/**
    413  * @callback_method_impl{FNRTSTRSPACECALLBACK, Compares attributes.}
     413 * @callback_method_impl{FNRTSTRSPACECALLBACK, Compares attributes}
    414414 */
    415415static DECLCALLBACK(int) rtManifestAttributeCompare(PRTSTRSPACECORE pStr, void *pvUser)
    … …  
    489489
    490490/**
    491  * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation.}
     491 * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation}
    492492 */
    493493DECLINLINE (int) rtManifestEntryCompare2(PRTMANIFESTEQUALS pEquals, PRTMANIFESTENTRY pEntry1, PRTMANIFESTENTRY pEntry2)
    … …  
    518518
    519519/**
    520  * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation.}
     520 * @callback_method_impl{FNRTSTRSPACECALLBACK, Prepare equals operation}
    521521 */
    522522static DECLCALLBACK(int) rtManifestEntryCompare(PRTSTRSPACECORE pStr, void *pvUser)

  • TabularUnified trunk/src/VBox/Runtime/common/checksum/x509.cpp

    r57358 r57974  
    6767 * @returns IPRT status code.
    6868 *
    69  * @param   pvBuf           String representation containing X509
     69 * @param   pvPem           String representation containing X509
    7070 *                          certificate in PEM format.
    71  * @param   cbBuf           The amount of data @a pvBuf points to.
     71 * @param   cbPem           The amount of data @a pvBuf points to.
    7272 * @param   ppOutCert       Where to store the pointer to the structure where
    7373 *                          the info about X509 certificate will be stored.

  • TabularUnified trunk/src/VBox/Runtime/common/dbg/dbgmodexports.cpp

    r57944 r57974  
    5555
    5656
    57 /** @callback_method_impl{FNRTLDRENUMSYMS,
     57/**
     58 * @callback_method_impl{FNRTLDRENUMSYMS,
    5859 *      Copies the symbols over into the container} */
    5960static DECLCALLBACK(int) rtDbgModExportsAddSymbolCallback(RTLDRMOD hLdrMod, const char *pszSymbol, unsigned uSymbol,

  • TabularUnified trunk/src/VBox/Runtime/common/dbg/dbgmodldr.cpp

    r57944 r57974  
    133133
    134134/** @interface_method_impl{RTDBGMODVTIMG,pfnRvaToSegOffset} */
    135 static DECLCALLBACK(int) rtDbgModLdr_RvaToSegOffset(PRTDBGMODINT pMod, RTLDRADDR uRva,
    136                                                     PRTDBGSEGIDX piSeg, PRTLDRADDR poffSeg)
    137 {
    138     PRTDBGMODLDR pThis = (PRTDBGMODLDR)pMod->pvImgPriv;
    139     return RTLdrRvaToSegOffset(pThis->hLdrMod, uRva, piSeg, poffSeg);
     135static DECLCALLBACK(int) rtDbgModLdr_RvaToSegOffset(PRTDBGMODINT pMod, RTLDRADDR Rva, PRTDBGSEGIDX piSeg, PRTLDRADDR poffSeg)
     136{
     137    PRTDBGMODLDR pThis = (PRTDBGMODLDR)pMod->pvImgPriv;
     138    return RTLdrRvaToSegOffset(pThis->hLdrMod, Rva, piSeg, poffSeg);
    140139}
    141140
    … …  
    150149
    151150
    152 /** @interface_method_impl{RTDBGMODVTIMG,pfnEnumSegments} */
     151/** @interface_method_impl{RTDBGMODVTIMG,pfnEnumSymbols} */
    153152static DECLCALLBACK(int) rtDbgModLdr_EnumSymbols(PRTDBGMODINT pMod, uint32_t fFlags, RTLDRADDR BaseAddress,
    154153                                                 PFNRTLDRENUMSYMS pfnCallback, void *pvUser)

  • TabularUnified trunk/src/VBox/Runtime/common/ldr/ldrMemory.cpp

    r57358 r57974  
    7676
    7777
    78 /** @callback_method_impl{FNRTLDRRDRMEMDTOR,
    79  *  Default destructor - pvUser points to the image memory block.}
     78/**
     79 * @callback_method_impl{FNRTLDRRDRMEMDTOR,
     80 *      Default destructor - pvUser points to the image memory block}
    8081 */
    8182static DECLCALLBACK(void) rtldrRdrMemDefaultDtor(void *pvUser)
    … …  
    8586
    8687
    87 /** @callback_method_impl{FNRTLDRRDRMEMREAD,
    88  *  Default memory reader - pvUser points to the image memory block.}
     88/**
     89 * @callback_method_impl{FNRTLDRRDRMEMREAD,
     90 *      Default memory reader - pvUser points to the image memory block}
    8991 */
    9092static DECLCALLBACK(int) rtldrRdrMemDefaultReader(void *pvBuf, size_t cb, size_t off, void *pvUser)
    … …  
    9597
    9698
    97 /** @copydoc RTLDRREADER::pfnRead */
     99/** @interface_method_impl{RTLDRREADER,pfnRead} */
    98100static DECLCALLBACK(int) rtldrRdrMem_Read(PRTLDRREADER pReader, void *pvBuf, size_t cb, RTFOFF off)
    99101{
    … …  
    118120
    119121
    120 /** @copydoc RTLDRREADER::pfnTell */
     122/** @interface_method_impl{RTLDRREADER,pfnTell} */
    121123static DECLCALLBACK(RTFOFF) rtldrRdrMem_Tell(PRTLDRREADER pReader)
    122124{
    … …  
    126128
    127129
    128 /** @copydoc RTLDRREADER::pfnSize */
     130/** @interface_method_impl{RTLDRREADER,pfnSize} */
    129131static DECLCALLBACK(RTFOFF) rtldrRdrMem_Size(PRTLDRREADER pReader)
    130132{
    … …  
    134136
    135137
    136 /** @copydoc RTLDRREADER::pfnLogName */
     138/** @interface_method_impl{RTLDRREADER,pfnLogName} */
    137139static DECLCALLBACK(const char *) rtldrRdrMem_LogName(PRTLDRREADER pReader)
    138140{
    … …  
    142144
    143145
    144 /** @copydoc RTLDRREADER::pfnMap */
     146/** @interface_method_impl{RTLDRREADER,pfnMap} */
    145147static DECLCALLBACK(int) rtldrRdrMem_Map(PRTLDRREADER pReader, const void **ppvBits)
    146148{
    … …  
    179181
    180182
    181 /** @copydoc RTLDRREADER::pfnUnmap */
     183/** @interface_method_impl{RTLDRREADER,pfnUnmap} */
    182184static DECLCALLBACK(int) rtldrRdrMem_Unmap(PRTLDRREADER pReader, const void *pvBits)
    183185{
    … …  
    196198
    197199
    198 /** @copydoc RTLDRREADER::pfnDestroy */
     200/** @interface_method_impl{RTLDRREADER,pfnDestroy} */
    199201static DECLCALLBACK(int) rtldrRdrMem_Destroy(PRTLDRREADER pReader)
    200202{

  • TabularUnified trunk/src/VBox/Runtime/common/ldr/ldrPE.cpp

    r57358 r57974  
    472472
    473473
    474 /** @copydoc RTLDROPS::pfnGetImageSize */
     474/** @interface_method_impl{RTLDROPS,pfnGetImageSize} */
    475475static DECLCALLBACK(size_t) rtldrPEGetImageSize(PRTLDRMODINTERNAL pMod)
    476476{
    … …  
    569569
    570570
    571 /** @copydoc RTLDROPS::pfnGetBits */
     571/** @interface_method_impl{RTLDROPS,pfnGetBits} */
    572572static DECLCALLBACK(int) rtldrPEGetBits(PRTLDRMODINTERNAL pMod, void *pvBits, RTUINTPTR BaseAddress, PFNRTLDRIMPORT pfnGetImport, void *pvUser)
    573573{
    … …  
    877877
    878878
    879 /** @copydoc RTLDROPS::pfnRelocate. */
     879/** @interface_method_impl{RTLDROPS,pfnRelocate} */
    880880static DECLCALLBACK(int) rtldrPERelocate(PRTLDRMODINTERNAL pMod, void *pvBits, RTUINTPTR NewBaseAddress, RTUINTPTR OldBaseAddress,
    881881                                         PFNRTLDRIMPORT pfnGetImport, void *pvUser)
    … …  
    10111011
    10121012
    1013 /** @copydoc RTLDROPS::pfnGetSymbolEx. */
     1013/** @interface_method_impl{RTLDROPS,pfnGetSymbolEx} */
    10141014static DECLCALLBACK(int) rtldrPEGetSymbolEx(PRTLDRMODINTERNAL pMod, const void *pvBits, RTUINTPTR BaseAddress,
    10151015                                            uint32_t iOrdinal, const char *pszSymbol, RTUINTPTR *pValue)
    … …  
    10371037
    10381038
    1039 /** @copydoc RTLDROPS::pfnQueryForwarderInfo. */
     1039/** @interface_method_impl{RTLDROPS,pfnQueryForwarderInfo} */
    10401040static DECLCALLBACK(int) rtldrPE_QueryForwarderInfo(PRTLDRMODINTERNAL pMod, const void *pvBits,  uint32_t iOrdinal,
    10411041                                                    const char *pszSymbol, PRTLDRIMPORTINFO pInfo, size_t cbInfo)
    … …  
    12641264
    12651265
    1266 /** @copydoc RTLDROPS::pfnEnumSymbols */
     1266/** @interface_method_impl{RTLDROPS,pfnEnumSymbols} */
    12671267static DECLCALLBACK(int) rtldrPEEnumSymbols(PRTLDRMODINTERNAL pMod, unsigned fFlags, const void *pvBits, RTUINTPTR BaseAddress,
    12681268                                            PFNRTLDRENUMSYMS pfnCallback, void *pvUser)
    … …  
    13691369
    13701370
    1371 /** @copydoc RTLDROPS::pfnEnumDbgInfo. */
     1371/** @interface_method_impl{RTLDROPS,pfnEnumDbgInfo} */
    13721372static DECLCALLBACK(int) rtldrPE_EnumDbgInfo(PRTLDRMODINTERNAL pMod, const void *pvBits,
    13731373                                             PFNRTLDRENUMDBG pfnCallback, void *pvUser)
    … …  
    15581558
    15591559
    1560 /** @copydoc RTLDROPS::pfnEnumSegments. */
     1560/** @interface_method_impl{RTLDROPS,pfnEnumSegments} */
    15611561static DECLCALLBACK(int) rtldrPE_EnumSegments(PRTLDRMODINTERNAL pMod, PFNRTLDRENUMSEGS pfnCallback, void *pvUser)
    15621562{
    … …  
    16501650
    16511651
    1652 /** @copydoc RTLDROPS::pfnLinkAddressToSegOffset. */
     1652/** @interface_method_impl{RTLDROPS,pfnLinkAddressToSegOffset} */
    16531653static DECLCALLBACK(int) rtldrPE_LinkAddressToSegOffset(PRTLDRMODINTERNAL pMod, RTLDRADDR LinkAddress,
    16541654                                                        uint32_t *piSeg, PRTLDRADDR poffSeg)
    … …  
    16901690
    16911691
    1692 /** @copydoc RTLDROPS::pfnLinkAddressToRva. */
     1692/** @interface_method_impl{RTLDROPS,pfnLinkAddressToRva} */
    16931693static DECLCALLBACK(int) rtldrPE_LinkAddressToRva(PRTLDRMODINTERNAL pMod, RTLDRADDR LinkAddress, PRTLDRADDR pRva)
    16941694{
    … …  
    17041704
    17051705
    1706 /** @copydoc RTLDROPS::pfnSegOffsetToRva. */
     1706/** @interface_method_impl{RTLDROPS,pfnSegOffsetToRva} */
    17071707static DECLCALLBACK(int) rtldrPE_SegOffsetToRva(PRTLDRMODINTERNAL pMod, uint32_t iSeg, RTLDRADDR offSeg,
    17081708                                                PRTLDRADDR pRva)
    … …  
    17241724
    17251725
    1726 /** @copydoc RTLDROPS::pfnRvaToSegOffset. */
     1726/** @interface_method_impl{RTLDROPS,pfnRvaToSegOffset} */
    17271727static DECLCALLBACK(int) rtldrPE_RvaToSegOffset(PRTLDRMODINTERNAL pMod, RTLDRADDR Rva,
    17281728                                                uint32_t *piSeg, PRTLDRADDR poffSeg)
    … …  
    27762776
    27772777
    2778 /** @copydoc RTLDROPS::pfnDone */
     2778/** @interface_method_impl{RTLDROPS,pfnDone}  */
    27792779static DECLCALLBACK(int) rtldrPEDone(PRTLDRMODINTERNAL pMod)
    27802780{
    … …  
    27892789
    27902790
    2791 /** @copydoc RTLDROPS::pfnClose */
     2791/** @interface_method_impl{RTLDROPS,pfnClose} */
    27922792static DECLCALLBACK(int) rtldrPEClose(PRTLDRMODINTERNAL pMod)
    27932793{

  • TabularUnified trunk/src/VBox/Runtime/common/ldr/ldrkStuff.cpp

    r57358 r57974  
    228228
    229229
    230 /** @copydoc KLDRRDROPS::pfnCreate
     230/** @interface_method_impl{KLDRRDROPS,pfnCreate}
    231231 * @remark This is a dummy which isn't used. */
    232232static int      rtkldrRdr_Create(  PPKRDR ppRdr, const char *pszFilename)
    … …  
    238238
    239239
    240 /** @copydoc KLDRRDROPS::pfnDestroy */
     240/** @interface_method_impl{KLDRRDROPS,pfnDestroy} */
    241241static int      rtkldrRdr_Destroy( PKRDR pRdr)
    242242{
    … …  
    248248
    249249
    250 /** @copydoc KLDRRDROPS::pfnRead */
     250/** @interface_method_impl{KLDRRDROPS,pfnRead} */
    251251static int      rtkldrRdr_Read(    PKRDR pRdr, void *pvBuf, KSIZE cb, KFOFF off)
    252252{
    … …  
    257257
    258258
    259 /** @copydoc KLDRRDROPS::pfnAllMap */
     259/** @interface_method_impl{KLDRRDROPS,pfnAllMap} */
    260260static int      rtkldrRdr_AllMap(  PKRDR pRdr, const void **ppvBits)
    261261{
    … …  
    266266
    267267
    268 /** @copydoc KLDRRDROPS::pfnAllUnmap */
     268/** @interface_method_impl{KLDRRDROPS,pfnAllUnmap} */
    269269static int      rtkldrRdr_AllUnmap(PKRDR pRdr, const void *pvBits)
    270270{
    … …  
    275275
    276276
    277 /** @copydoc KLDRRDROPS::pfnSize */
     277/** @interface_method_impl{KLDRRDROPS,pfnSize} */
    278278static KFOFF rtkldrRdr_Size(    PKRDR pRdr)
    279279{
    … …  
    283283
    284284
    285 /** @copydoc KLDRRDROPS::pfnTell */
     285/** @interface_method_impl{KLDRRDROPS,pfnTell} */
    286286static KFOFF rtkldrRdr_Tell(    PKRDR pRdr)
    287287{
    … …  
    291291
    292292
    293 /** @copydoc KLDRRDROPS::pfnName */
     293/** @interface_method_impl{KLDRRDROPS,pfnName} */
    294294static const char * rtkldrRdr_Name(PKRDR pRdr)
    295295{
    … …  
    299299
    300300
    301 /** @copydoc KLDRRDROPS::pfnNativeFH */
     301/** @interface_method_impl{KLDRRDROPS,pfnNativeFH} */
    302302static KIPTR rtkldrRdr_NativeFH(PKRDR pRdr)
    303303{
    … …  
    308308
    309309
    310 /** @copydoc KLDRRDROPS::pfnPageSize */
     310/** @interface_method_impl{KLDRRDROPS,pfnPageSize} */
    311311static KSIZE rtkldrRdr_PageSize(PKRDR pRdr)
    312312{
    … …  
    316316
    317317
    318 /** @copydoc KLDRRDROPS::pfnMap */
     318/** @interface_method_impl{KLDRRDROPS,pfnMap} */
    319319static int      rtkldrRdr_Map(     PKRDR pRdr, void **ppvBase, KU32 cSegments, PCKLDRSEG paSegments, KBOOL fFixed)
    320320{
    … …  
    326326
    327327
    328 /** @copydoc KLDRRDROPS::pfnRefresh */
     328/** @interface_method_impl{KLDRRDROPS,pfnRefresh} */
    329329static int      rtkldrRdr_Refresh( PKRDR pRdr, void *pvBase, KU32 cSegments, PCKLDRSEG paSegments)
    330330{
    … …  
    336336
    337337
    338 /** @copydoc KLDRRDROPS::pfnProtect */
     338/** @interface_method_impl{KLDRRDROPS,pfnProtect} */
    339339static int      rtkldrRdr_Protect( PKRDR pRdr, void *pvBase, KU32 cSegments, PCKLDRSEG paSegments, KBOOL fUnprotectOrProtect)
    340340{
    … …  
    346346
    347347
    348 /** @copydoc KLDRRDROPS::pfnUnmap */
     348/** @interface_method_impl{KLDRRDROPS,pfnUnmap} */
    349349static int      rtkldrRdr_Unmap(   PKRDR pRdr, void *pvBase, KU32 cSegments, PCKLDRSEG paSegments)
    350350{
    … …  
    355355}
    356356
    357 /** @copydoc KLDRRDROPS::pfnDone */
     357/** @interface_method_impl{KLDRRDROPS,pfnDone} */
    358358static void     rtkldrRdr_Done(    PKRDR pRdr)
    359359{
    … …  
    394394
    395395
    396 /** @copydoc RTLDROPS::pfnClose */
     396/** @interface_method_impl{RTLDROPS,pfnClose} */
    397397static DECLCALLBACK(int) rtkldr_Close(PRTLDRMODINTERNAL pMod)
    398398{
    … …  
    403403
    404404
    405 /** @copydoc RTLDROPS::pfnDone */
     405/** @interface_method_impl{RTLDROPS,pfnDone} */
    406406static DECLCALLBACK(int) rtkldr_Done(PRTLDRMODINTERNAL pMod)
    407407{
    … …  
    443443
    444444
    445 /** @copydoc RTLDROPS::pfnEnumSymbols */
     445/** @interface_method_impl{RTLDROPS,pfnEnumSymbols} */
    446446static DECLCALLBACK(int) rtkldr_EnumSymbols(PRTLDRMODINTERNAL pMod, unsigned fFlags, const void *pvBits, RTUINTPTR BaseAddress,
    447447                                            PFNRTLDRENUMSYMS pfnCallback, void *pvUser)
    … …  
    465465
    466466
    467 /** @copydoc RTLDROPS::pfnGetImageSize */
     467/** @interface_method_impl{RTLDROPS,pfnGetImageSize} */
    468468static DECLCALLBACK(size_t) rtkldr_GetImageSize(PRTLDRMODINTERNAL pMod)
    469469{
    … …  
    519519
    520520
    521 /** @copydoc RTLDROPS::pfnGetBits */
     521/** @interface_method_impl{RTLDROPS,pfnGetBits} */
    522522static DECLCALLBACK(int) rtkldr_GetBits(PRTLDRMODINTERNAL pMod, void *pvBits, RTUINTPTR BaseAddress,
    523523                                        PFNRTLDRIMPORT pfnGetImport, void *pvUser)
    … …  
    539539
    540540
    541 /** @copydoc RTLDROPS::pfnRelocate */
     541/** @interface_method_impl{RTLDROPS,pfnRelocate} */
    542542static DECLCALLBACK(int) rtkldr_Relocate(PRTLDRMODINTERNAL pMod, void *pvBits, RTUINTPTR NewBaseAddress,
    543543                                         RTUINTPTR OldBaseAddress, PFNRTLDRIMPORT pfnGetImport, void *pvUser)
    … …  
    559559
    560560
    561 /** @copydoc RTLDROPS::pfnGetSymbolEx */
     561/** @interface_method_impl{RTLDROPS,pfnGetSymbolEx} */
    562562static DECLCALLBACK(int) rtkldr_GetSymbolEx(PRTLDRMODINTERNAL pMod, const void *pvBits, RTUINTPTR BaseAddress,
    563563                                            uint32_t iOrdinal, const char *pszSymbol, RTUINTPTR *pValue)
    … …  
    651651
    652652
    653 /** @copydoc RTLDROPS::pfnEnumDbgInfo */
     653/** @interface_method_impl{RTLDROPS,pfnEnumDbgInfo} */
    654654static DECLCALLBACK(int) rtkldr_EnumDbgInfo(PRTLDRMODINTERNAL pMod, const void *pvBits,
    655655                                            PFNRTLDRENUMDBG pfnCallback, void *pvUser)
    … …  
    669669
    670670
    671 /** @copydoc RTLDROPS::pfnEnumSegments. */
     671/** @interface_method_impl{RTLDROPS,pfnEnumSegments} */
    672672static DECLCALLBACK(int) rtkldr_EnumSegments(PRTLDRMODINTERNAL pMod, PFNRTLDRENUMSEGS pfnCallback, void *pvUser)
    673673{
    … …  
    739739
    740740
    741 /** @copydoc RTLDROPS::pfnLinkAddressToSegOffset. */
     741/** @interface_method_impl{RTLDROPS,pfnLinkAddressToSegOffset} */
    742742static DECLCALLBACK(int) rtkldr_LinkAddressToSegOffset(PRTLDRMODINTERNAL pMod, RTLDRADDR LinkAddress,
    743743                                                       uint32_t *piSeg, PRTLDRADDR poffSeg)
    … …  
    763763
    764764
    765 /** @copydoc RTLDROPS::pfnLinkAddressToRva. */
     765/** @interface_method_impl{RTLDROPS,pfnLinkAddressToRva}. */
    766766static DECLCALLBACK(int) rtkldr_LinkAddressToRva(PRTLDRMODINTERNAL pMod, RTLDRADDR LinkAddress, PRTLDRADDR pRva)
    767767{
    … …  
    785785
    786786
    787 /** @copydoc RTLDROPS::pfnSegOffsetToRva. */
    788 static DECLCALLBACK(int) rtkldr_SegOffsetToRva(PRTLDRMODINTERNAL pMod, uint32_t iSeg, RTLDRADDR offSeg,
    789                                                PRTLDRADDR pRva)
     787/** @interface_method_impl{RTLDROPS,pfnSegOffsetToRva} */
     788static DECLCALLBACK(int) rtkldr_SegOffsetToRva(PRTLDRMODINTERNAL pMod, uint32_t iSeg, RTLDRADDR offSeg, PRTLDRADDR pRva)
    790789{
    791790    PRTLDRMODKLDR pThis = (PRTLDRMODKLDR)pMod;
    … …  
    806805
    807806
    808 /** @copydoc RTLDROPS::pfnRvaToSegOffset. */
    809 static DECLCALLBACK(int) rtkldr_RvaToSegOffset(PRTLDRMODINTERNAL pMod, RTLDRADDR Rva,
    810                                                uint32_t *piSeg, PRTLDRADDR poffSeg)
     807/** @interface_method_impl{RTLDROPS,pfnRvaToSegOffset} */
     808static DECLCALLBACK(int) rtkldr_RvaToSegOffset(PRTLDRMODINTERNAL pMod, RTLDRADDR Rva, uint32_t *piSeg, PRTLDRADDR poffSeg)
    811809{
    812810    PRTLDRMODKLDR   pThis      = (PRTLDRMODKLDR)pMod;
    … …  
    830828
    831829
    832 /** @copydoc RTLDROPS::pfnReadDbgInfo. */
     830/** @interface_method_impl{RTLDROPS,pfnReadDbgInfo} */
    833831static DECLCALLBACK(int) rtkldr_ReadDbgInfo(PRTLDRMODINTERNAL pMod, uint32_t iDbgInfo, RTFOFF off, size_t cb, void *pvBuf)
    834832{

  • TabularUnified trunk/src/VBox/Runtime/common/log/log.cpp

    r57809 r57974  
    30663066 *
    30673067 * @param   pszFormat   Printf like format string.
    3068  * @param   args        Optional arguments as specified in pszFormat.
     3068 * @param   va          Optional arguments as specified in pszFormat.
    30693069 *
    30703070 * @remark The API doesn't support formatting of floating point numbers at the moment.
    30713071 */
    3072 RTDECL(void) RTLogPrintfV(const char *pszFormat, va_list args)
     3072RTDECL(void) RTLogPrintfV(const char *pszFormat, va_list va)
    30733073{
    30743074    RTLogLoggerV(NULL, pszFormat, args);
    … …  
    31463146 *
    31473147 * @param   pLogger     The logger instance to update. NULL is not allowed!
    3148  * @param   uTimeSlit   Current time slot (for tikme based rotation).
     3148 * @param   uTimeSlot   Current time slot (for tikme based rotation).
    31493149 * @param   fFirst      Flag whether this is the beginning of logging, i.e.
    31503150 *                      called from RTLogCreateExV.  Prevents pfnPhase from

  • TabularUnified trunk/src/VBox/Runtime/common/misc/lockvalidator.cpp

    r57944 r57974  
    397397 * Launch a simple assertion like complaint w/ panic.
    398398 *
    399  * @param   pszFile             Where from - file.
    400  * @param   iLine               Where from - line.
    401  * @param   pszFunction         Where from - function.
     399 * @param   SRC_POS             The source position where call is being made from.
    402400 * @param   pszWhat             What we're complaining about.
    403401 * @param   ...                 Format arguments.
    … …  
    12041202 * Destroys a class once there are not more references to it.
    12051203 *
    1206  * @param   Class               The class.
     1204 * @param   pClass              The class.
    12071205 */
    12081206static void rtLockValidatorClassDestroy(RTLOCKVALCLASSINT *pClass)
    … …  
    22072205 * @param   pRec                The lock record.
    22082206 * @param   pSrcPos             The source position of the locking operation.
     2207 * @param   pFirstBadClass      The first bad class.
     2208 * @param   pFirstBadRec        The first bad lock record.
     2209 * @param   pFirstBadDown       The next record on the lock stack.
    22092210 */
    22102211static int rtLockValidatorStackCheckLockingOrder2(RTLOCKVALCLASSINT * const pClass, uint32_t const uSubClass,

  • TabularUnified trunk/src/VBox/Runtime/generic/http-curl.cpp

    r57944 r57974  
    598598 * Configures a proxy given a "URL" like specification.
    599599 *
    600  * Format is:
    601  * <pre> [<scheme>"://"][<userid>[@<password>]:]<server>[":"<port>] </pre>
     600 * The format is:
     601 * @verbatim
     602 *      [<scheme>"://"][<userid>[@<password>]:]<server>[":"<port>]
     603 * @endverbatim
     604 *
     605 * Where the scheme gives the type of proxy server we're dealing with rather
     606 * than the protocol of the external server we wish to talk to.
    602607 *
    603608 * @returns IPRT status code.

  • TabularUnified trunk/src/VBox/Runtime/include/internal/ldr.h

    r56290 r57974  
    358358     *
    359359     * @param   pMod            Pointer to the loader module structure.
    360      * @param   enmLdrProp      The property to query (valid).
     360     * @param   enmProp         The property to query (valid).
    361361     * @param   pvBits          Pointer to the bits returned by
    362362     *                          RTLDROPS::pfnGetBits(), optional.
    … …  
    395395     *
    396396     * @returns IPRT status code.
    397      * @param   hLdrMod         The module handle.
     397     * @param   pMod            The module handle.
    398398     * @param   enmDigest       Which kind of digest.
    399399     * @param   pszDigest       Where to store the image digest.

  • TabularUnified trunk/src/VBox/Runtime/r3/win/fs-win.cpp

    r57613 r57974  
    6262    ULONG FileSystemAttributes;
    6363    LONG MaximumComponentNameLength;
    64     ULONG FIleSystemNameLength;
     64    ULONG FileSystemNameLength;
    6565    WCHAR FileSystemName[1];
    6666} FILE_FS_ATTRIBUTE_INFORMATION, *PFILE_FS_ATTRIBUTE_INFORMATION;
    … …  
    349349 * @returns @c true if equal, @c false if not.
    350350 * @param   pwsz1               The first string.
    351  * @param   cb1                 The length of the first string, in bytes.
     351 * @param   cch1                The length of the first string, in bytes.
    352352 * @param   psz2                The second string.
    353353 * @param   cch2                The length of the second string.
    … …  
    402402            {
    403403                PFILE_FS_ATTRIBUTE_INFORMATION pFsAttrInfo = (PFILE_FS_ATTRIBUTE_INFORMATION)abBuf;
    404                 if (pFsAttrInfo->FIleSystemNameLength)
    405                 {
    406                 }
    407404#define IS_FS(szName) \
    408     rtFsWinAreEqual(pFsAttrInfo->FileSystemName, pFsAttrInfo->FIleSystemNameLength, szName, sizeof(szName) - 1)
     405    rtFsWinAreEqual(pFsAttrInfo->FileSystemName, pFsAttrInfo->FileSystemNameLength, szName, sizeof(szName) - 1)
    409406                if (IS_FS("NTFS"))
    410407                    *penmType = RTFSTYPE_NTFS;

  • TabularUnified trunk/src/VBox/Runtime/r3/win/init-win.cpp

    r57865 r57974  
    258258    }
    259259
    260     /** @bugref 6861: Observed GUI issues on Vista (32-bit and 64-bit). */
     260    /** @bugref{6861} Observed GUI issues on Vista (32-bit and 64-bit). */
    261261    if (g_enmWinVer > kRTWinOSType_VISTA)
    262262    {

  • TabularUnified trunk/src/VBox/Runtime/r3/win/localipc-win.cpp

    r57928 r57974  
    200200 * @param   ppDesc              Where to store the allocated security descriptor on success.
    201201 *                              Must be free'd using LocalFree().
     202 * @param   fServer             Whether it's for a server or client instance.
    202203 */
    203204static int rtLocalIpcServerWinAllocSecurityDescriptior(PSECURITY_DESCRIPTOR *ppDesc, bool fServer)
    … …  
    224225         * users from screwing around.
    225226         */
     227        /** @todo r=bird: Why do you convert a string litteral? the 'L' prefix should
     228         *        be sufficient, shouldn't it?? */
    226229        PRTUTF16 pwszSDDL;
    227         rc = RTStrToUtf16(fServer
    228                           ? RTLOCALIPC_WIN_SDDL_SERVER : RTLOCALIPC_WIN_SDDL_CLIENT, &pwszSDDL);
     230        rc = RTStrToUtf16(fServer ? RTLOCALIPC_WIN_SDDL_SERVER : RTLOCALIPC_WIN_SDDL_CLIENT, &pwszSDDL);
    229231        if (RT_SUCCESS(rc))
    230232        {
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