VirtualBox

Changeset 57004 in vbox for trunk/include/iprt


Ignore:
Timestamp:
Jul 19, 2015 12:53:13 AM (9 years ago)
Author:
vboxsync
Message:

iprt,*: Marked all format strings in the C part of IPRT and fixed the fallout.

Location:
trunk/include/iprt
Files:
20 edited

Legend:

Unmodified
Added
Removed
  • trunk/include/iprt/asn1-generator-pass.h

    r56291 r57004  
    932932            case RT_CONCAT(a_enmType,_NOT_PRESENT): \
    933933                rc = RTErrInfoSetF(pErrInfo, VERR_GENERAL_FAILURE, \
    934                                    "%s: Invalid " #a_enmMembNm " value: " #a_enmType "_NOT_PRESENT", \
    935                                    pszErrorTag, pThis->a_enmMembNm); \
     934                                   "%s: Invalid " #a_enmMembNm " value: " #a_enmType "_NOT_PRESENT", pszErrorTag); \
    936935                break; \
    937936        }
  • trunk/include/iprt/asn1.h

    r56291 r57004  
    15961596 * @param   ...                 Format arguments.
    15971597 */
    1598 RTDECL(int) RTAsn1CursorSetInfo(PRTASN1CURSOR pCursor, int rc, const char *pszMsg, ...);
     1598RTDECL(int) RTAsn1CursorSetInfo(PRTASN1CURSOR pCursor, int rc, const char *pszMsg, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    15991599
    16001600/**
     
    16071607 * @param   va                  Format arguments.
    16081608 */
    1609 RTDECL(int) RTAsn1CursorSetInfoV(PRTASN1CURSOR pCursor, int rc, const char *pszMsg, va_list va);
     1609RTDECL(int) RTAsn1CursorSetInfoV(PRTASN1CURSOR pCursor, int rc, const char *pszMsg, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    16101610
    16111611/**
  • trunk/include/iprt/cdefs.h

    r56919 r57004  
    925925#else
    926926# define RT_IPRT_FORMAT_ATTR(a_iFmt, a_iArgs)
     927#endif
     928
     929/** @def RT_IPRT_FORMAT_ATTR_MAYBE_NULL
     930 * Identifies a function taking an IPRT format string, NULL is allowed.
     931 * @param   a_iFmt  The index (1-based) of the format string argument.
     932 * @param   a_iArgs The index (1-based) of the first format argument, use 0 for
     933 *                  va_list.
     934 */
     935#if defined(__GNUC__) && defined(WITH_IPRT_FORMAT_ATTRIBUTE)
     936# define RT_IPRT_FORMAT_ATTR_MAYBE_NULL(a_iFmt, a_iArgs)   __attribute__((__iprt_format_maybe_null__(a_iFmt, a_iArgs)))
     937#else
     938# define RT_IPRT_FORMAT_ATTR_MAYBE_NULL(a_iFmt, a_iArgs)
    927939#endif
    928940
  • trunk/include/iprt/condvar.h

    r56291 r57004  
    7272 * @param   ...                 Format string arguments.
    7373 */
    74 RTDECL(int)  RTConvVarCreateEx(PRTCONDVAR phCondVar, uint32_t fFlags, RTLOCKVALCLASS hClass, const char *pszNameFmt, ...);
     74RTDECL(int)  RTConvVarCreateEx(PRTCONDVAR phCondVar, uint32_t fFlags, RTLOCKVALCLASS hClass,
     75                               const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(4, 5);
    7576
    7677/** @name RTConvVarCreateEx flags
  • trunk/include/iprt/critsect.h

    r56402 r57004  
    136136 * @param   ...             Format string arguments.
    137137 */
    138 RTDECL(int) RTCritSectInitEx(PRTCRITSECT pCritSect, uint32_t fFlags,
    139                              RTLOCKVALCLASS hClass, uint32_t uSubClass, const char *pszNameFmt, ...);
     138RTDECL(int) RTCritSectInitEx(PRTCRITSECT pCritSect, uint32_t fFlags, RTLOCKVALCLASS hClass, uint32_t uSubClass,
     139                             const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(5, 6);
    140140
    141141/**
     
    484484 * @param   ...             Format string arguments.
    485485 */
    486 RTDECL(int) RTCritSectRwInitEx(PRTCRITSECTRW pThis, uint32_t fFlags,
    487                                RTLOCKVALCLASS hClass, uint32_t uSubClass, const char *pszNameFmt, ...);
     486RTDECL(int) RTCritSectRwInitEx(PRTCRITSECTRW pThis, uint32_t fFlags, RTLOCKVALCLASS hClass, uint32_t uSubClass,
     487                               const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(5, 6);
    488488
    489489/**
  • trunk/include/iprt/dbg.h

    r56291 r57004  
    519519 * @param   va              Format arguments.
    520520 */
    521 RTDECL(int) RTDbgAsCreateV(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, va_list va);
     521RTDECL(int) RTDbgAsCreateV(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr,
     522                           const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR(4, 0);
    522523
    523524/**
     
    532533 * @param   ...             Format arguments.
    533534 */
    534 RTDECL(int) RTDbgAsCreateF(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr, const char *pszNameFmt, ...);
     535RTDECL(int) RTDbgAsCreateF(PRTDBGAS phDbgAs, RTUINTPTR FirstAddr, RTUINTPTR LastAddr,
     536                           const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(4, 5);
    535537
    536538/**
  • trunk/include/iprt/err.h

    r55951 r57004  
    506506 * @param   ...                 The format arguments.
    507507 */
    508 RTDECL(int)         RTErrInfoSetF(PRTERRINFO pErrInfo, int rc, const char *pszFormat, ...);
     508RTDECL(int)         RTErrInfoSetF(PRTERRINFO pErrInfo, int rc, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    509509
    510510/**
     
    518518 * @param   va                  The format arguments.
    519519 */
    520 RTDECL(int)         RTErrInfoSetV(PRTERRINFO pErrInfo, int rc, const char *pszFormat, va_list va);
     520RTDECL(int)         RTErrInfoSetV(PRTERRINFO pErrInfo, int rc, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    521521
    522522/**
     
    541541 * @param   ...                 The format arguments.
    542542 */
    543 RTDECL(int)         RTErrInfoAddF(PRTERRINFO pErrInfo, int rc, const char *pszFormat, ...);
     543RTDECL(int)         RTErrInfoAddF(PRTERRINFO pErrInfo, int rc, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    544544
    545545/**
     
    553553 * @param   va                  The format arguments.
    554554 */
    555 RTDECL(int)         RTErrInfoAddV(PRTERRINFO pErrInfo, int rc, const char *pszFormat, va_list va);
     555RTDECL(int)         RTErrInfoAddV(PRTERRINFO pErrInfo, int rc, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    556556
    557557/**
  • trunk/include/iprt/file.h

    r56291 r57004  
    271271 * @param   ...             Arguments to the format string.
    272272 */
    273 RTDECL(int)  RTFileOpenF(PRTFILE pFile, uint64_t fOpen, const char *pszFilenameFmt, ...);
     273RTDECL(int)  RTFileOpenF(PRTFILE pFile, uint64_t fOpen, const char *pszFilenameFmt, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    274274
    275275/**
     
    284284 * @param   va              Arguments to the format string.
    285285 */
    286 RTDECL(int)  RTFileOpenV(PRTFILE pFile, uint64_t fOpen, const char *pszFilenameFmt, va_list va);
     286RTDECL(int)  RTFileOpenV(PRTFILE pFile, uint64_t fOpen, const char *pszFilenameFmt, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    287287
    288288/**
  • trunk/include/iprt/heap.h

    r56291 r57004  
    181181 * @param   ...         Format arguments.
    182182 */
    183 typedef DECLCALLBACK(void) FNRTHEAPSIMPLEPRINTF(const char *pszFormat, ...);
     183typedef DECLCALLBACK(void) FNRTHEAPSIMPLEPRINTF(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    184184/** Pointer to a FNRTHEAPSIMPLEPRINTF function. */
    185185typedef FNRTHEAPSIMPLEPRINTF *PFNRTHEAPSIMPLEPRINTF;
     
    336336 * @param   ...         Format arguments.
    337337 */
    338 typedef DECLCALLBACK(void) FNRTHEAPOFFSETPRINTF(const char *pszFormat, ...);
     338typedef DECLCALLBACK(void) FNRTHEAPOFFSETPRINTF(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    339339/** Pointer to a FNRTHEAPOFFSETPRINTF function. */
    340340typedef FNRTHEAPOFFSETPRINTF *PFNRTHEAPOFFSETPRINTF;
  • trunk/include/iprt/linux/sysfs.h

    r56291 r57004  
    4848 * @param   va          The format args.
    4949 */
    50 RTDECL(bool) RTLinuxSysFsExistsV(const char *pszFormat, va_list va);
     50RTDECL(bool) RTLinuxSysFsExistsV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    5151
    5252/**
     
    5757 * @param   ...         The format args.
    5858 */
    59 RTDECL(bool) RTLinuxSysFsExists(const char *pszFormat, ...);
     59RTDECL(bool) RTLinuxSysFsExists(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    6060
    6161/**
     
    6666 * @param   va          The format args.
    6767 */
    68 RTDECL(int) RTLinuxSysFsOpenV(const char *pszFormat, va_list va);
     68RTDECL(int) RTLinuxSysFsOpenV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    6969
    7070/**
     
    7575 * @param   ...         The format args.
    7676 */
    77 RTDECL(int) RTLinuxSysFsOpen(const char *pszFormat, ...);
     77RTDECL(int) RTLinuxSysFsOpen(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    7878
    7979/**
     
    115115 * @param   va          Format args.
    116116 */
    117 RTDECL(int64_t) RTLinuxSysFsReadIntFileV(unsigned uBase, const char *pszFormat, va_list va);
     117RTDECL(int64_t) RTLinuxSysFsReadIntFileV(unsigned uBase, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    118118
    119119/**
     
    125125 * @param   ...         Format args.
    126126 */
    127 RTDECL(int64_t) RTLinuxSysFsReadIntFile(unsigned uBase, const char *pszFormat, ...);
     127RTDECL(int64_t) RTLinuxSysFsReadIntFile(unsigned uBase, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    128128
    129129/**
     
    134134 * @param   va          Format args.
    135135 */
    136 RTDECL(dev_t) RTLinuxSysFsReadDevNumFileV(const char *pszFormat, va_list va);
     136RTDECL(dev_t) RTLinuxSysFsReadDevNumFileV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    137137
    138138/**
     
    143143 * @param   ...         Format args.
    144144 */
    145 RTDECL(dev_t) RTLinuxSysFsReadDevNumFile(const char *pszFormat, ...);
     145RTDECL(dev_t) RTLinuxSysFsReadDevNumFile(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    146146
    147147/**
     
    156156 * @param   va          Format args.
    157157 */
    158 RTDECL(ssize_t) RTLinuxSysFsReadStrFileV(char *pszBuf, size_t cchBuf, const char *pszFormat, va_list va);
     158RTDECL(ssize_t) RTLinuxSysFsReadStrFileV(char *pszBuf, size_t cchBuf, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    159159
    160160/**
     
    169169 * @param   ...         Format args.
    170170 */
    171 RTDECL(ssize_t) RTLinuxSysFsReadStrFile(char *pszBuf, size_t cchBuf, const char *pszFormat, ...);
     171RTDECL(ssize_t) RTLinuxSysFsReadStrFile(char *pszBuf, size_t cchBuf, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    172172
    173173/**
     
    187187 * @param   va           Format args.
    188188 */
    189 RTDECL(ssize_t) RTLinuxSysFsGetLinkDestV(char *pszBuf, size_t cchBuf, const char *pszFormat, va_list va);
     189RTDECL(ssize_t) RTLinuxSysFsGetLinkDestV(char *pszBuf, size_t cchBuf, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    190190
    191191/**
     
    205205 * @param   ...         Format args.
    206206 */
    207 RTDECL(ssize_t) RTLinuxSysFsGetLinkDest(char *pszBuf, size_t cchBuf, const char *pszFormat, ...);
     207RTDECL(ssize_t) RTLinuxSysFsGetLinkDest(char *pszBuf, size_t cchBuf, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    208208
    209209/**
     
    223223 * @param   va             Format args.
    224224 */
    225 RTDECL(ssize_t) RTLinuxCheckDevicePathV(dev_t DevNum, RTFMODE fMode,
    226                                         char *pszBuf, size_t cchBuf,
    227                                         const char *pszPattern, va_list va);
     225RTDECL(ssize_t) RTLinuxCheckDevicePathV(dev_t DevNum, RTFMODE fMode, char *pszBuf, size_t cchBuf,
     226                                        const char *pszPattern, va_list va) RT_IPRT_FORMAT_ATTR(5, 0);
    228227
    229228/**
     
    243242 * @param   ...             Format args.
    244243 */
    245 RTDECL(ssize_t) RTLinuxCheckDevicePath(dev_t DevNum, RTFMODE fMode,
    246                                        char *pszBuf, size_t cchBuf,
    247                                        const char *pszPattern, ...);
     244RTDECL(ssize_t) RTLinuxCheckDevicePath(dev_t DevNum, RTFMODE fMode, char *pszBuf, size_t cchBuf,
     245                                       const char *pszPattern, ...) RT_IPRT_FORMAT_ATTR(5, 6);
    248246
    249247/** @} */
  • trunk/include/iprt/lockvalidator.h

    r56291 r57004  
    265265 * @param   ...                 Format string arguments.
    266266 */
    267 RTDECL(void) RTLockValidatorRecExclInit(PRTLOCKVALRECEXCL pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    268                                         void *hLock, bool fEnabled, const char *pszNameFmt, ...);
     267RTDECL(void) RTLockValidatorRecExclInit(PRTLOCKVALRECEXCL pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass, void *hLock,
     268                                        bool fEnabled, const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(6, 7);
    269269/**
    270270 * Initialize a lock validator record.
     
    286286 * @param   va                  Format string arguments.
    287287 */
    288 RTDECL(void) RTLockValidatorRecExclInitV(PRTLOCKVALRECEXCL pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    289                                          void *hLock, bool fEnabled, const char *pszNameFmt, va_list va);
     288RTDECL(void) RTLockValidatorRecExclInitV(PRTLOCKVALRECEXCL pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass, void *hLock,
     289                                         bool fEnabled, const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(6, 0);
    290290/**
    291291 * Uninitialize a lock validator record previously initialized by
     
    317317 * @param   ...                 Format string arguments.
    318318 */
    319 RTDECL(int)  RTLockValidatorRecExclCreate(PRTLOCKVALRECEXCL *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    320                                           void *hLock, bool fEnabled, const char *pszNameFmt, ...);
     319RTDECL(int)  RTLockValidatorRecExclCreate(PRTLOCKVALRECEXCL *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass, void *hLock,
     320                                          bool fEnabled, const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(6, 7);
    321321
    322322/**
     
    341341 * @param   va                  Format string arguments.
    342342 */
    343 RTDECL(int)  RTLockValidatorRecExclCreateV(PRTLOCKVALRECEXCL *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    344                                            void *hLock, bool fEnabled, const char *pszNameFmt, va_list va);
     343RTDECL(int)  RTLockValidatorRecExclCreateV(PRTLOCKVALRECEXCL *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass, void *hLock,
     344                                           bool fEnabled, const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(6, 0);
    345345
    346346/**
     
    565565 */
    566566RTDECL(void) RTLockValidatorRecSharedInit(PRTLOCKVALRECSHRD pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    567                                           void *hLock, bool fSignaller, bool fEnabled, const char *pszNameFmt, ...);
     567                                          void *hLock, bool fSignaller, bool fEnabled,
     568                                          const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(7, 8);
    568569
    569570/**
     
    590591 */
    591592RTDECL(void) RTLockValidatorRecSharedInitV(PRTLOCKVALRECSHRD pRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    592                                            void *hLock, bool fSignaller, bool fEnabled, const char *pszNameFmt, va_list va);
     593                                           void *hLock, bool fSignaller, bool fEnabled,
     594                                           const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(7, 0);
    593595
    594596/**
     
    625627 */
    626628RTDECL(int) RTLockValidatorRecSharedCreate(PRTLOCKVALRECSHRD *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    627                                            void *pvLock, bool fSignaller, bool fEnabled, const char *pszNameFmt, ...);
     629                                           void *pvLock, bool fSignaller, bool fEnabled,
     630                                           const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(7, 8);
    628631
    629632/**
     
    652655 */
    653656RTDECL(int) RTLockValidatorRecSharedCreateV(PRTLOCKVALRECSHRD *ppRec, RTLOCKVALCLASS hClass, uint32_t uSubClass,
    654                                             void *pvLock, bool fSignaller, bool fEnabled, const char *pszNameFmt, va_list va);
     657                                            void *pvLock, bool fSignaller, bool fEnabled,
     658                                            const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(7, 0);
    655659
    656660/**
     
    945949                                         bool fAutodidact, bool fRecursionOk, bool fStrictReleaseOrder,
    946950                                         RTMSINTERVAL cMsMinDeadlock, RTMSINTERVAL cMsMinOrder,
    947                                          const char *pszNameFmt, ...);
     951                                         const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(8, 9);
    948952
    949953/**
     
    974978                                          bool fAutodidact, bool fRecursionOk, bool fStrictReleaseOrder,
    975979                                          RTMSINTERVAL cMsMinDeadlock, RTMSINTERVAL cMsMinOrder,
    976                                           const char *pszNameFmt, va_list va);
     980                                          const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(8, 0);
    977981
    978982/**
     
    991995 * @param   ...                 Format string arguments.
    992996 */
    993 RTDECL(int) RTLockValidatorClassCreate(PRTLOCKVALCLASS phClass, bool fAutodidact, RT_SRC_POS_DECL, const char *pszNameFmt, ...);
     997RTDECL(int) RTLockValidatorClassCreate(PRTLOCKVALCLASS phClass, bool fAutodidact, RT_SRC_POS_DECL,
     998                                       const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(6, 7);
    994999
    9951000/**
     
    10091014 * @param   ...                 Format string arguments.
    10101015 */
    1011 RTDECL(RTLOCKVALCLASS) RTLockValidatorClassCreateUnique(RT_SRC_POS_DECL, const char *pszNameFmt, ...);
     1016RTDECL(RTLOCKVALCLASS) RTLockValidatorClassCreateUnique(RT_SRC_POS_DECL,
     1017                                                        const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(4, 5);
    10121018
    10131019/**
     
    10301036 * @param   ...                 Format string arguments.
    10311037 */
    1032 RTDECL(RTLOCKVALCLASS) RTLockValidatorClassForSrcPos(RT_SRC_POS_DECL, const char *pszNameFmt, ...);
     1038RTDECL(RTLOCKVALCLASS) RTLockValidatorClassForSrcPos(RT_SRC_POS_DECL,
     1039                                                     const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(4, 5);
    10331040
    10341041/**
  • trunk/include/iprt/log.h

    r56919 r57004  
    19561956RTDECL(int) RTLogCreate(PRTLOGGER *ppLogger, uint32_t fFlags, const char *pszGroupSettings,
    19571957                        const char *pszEnvVarBase, unsigned cGroups, const char * const * papszGroups,
    1958                         uint32_t fDestFlags, const char *pszFilenameFmt, ...) RT_IPRT_FORMAT_ATTR(8, 9);
     1958                        uint32_t fDestFlags, const char *pszFilenameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(8, 9);
    19591959
    19601960/**
     
    19921992                          const char *pszEnvVarBase, unsigned cGroups, const char * const * papszGroups,
    19931993                          uint32_t fDestFlags, PFNRTLOGPHASE pfnPhase, uint32_t cHistory,
    1994                           uint64_t cbHistoryFileMax, uint32_t cSecsHistoryTimeSlot,
    1995                           char *pszErrorMsg, size_t cchErrorMsg, const char *pszFilenameFmt, ...) RT_IPRT_FORMAT_ATTR(14, 15);
     1994                          uint64_t cbHistoryFileMax, uint32_t cSecsHistoryTimeSlot, char *pszErrorMsg, size_t cchErrorMsg,
     1995                          const char *pszFilenameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(14, 15);
    19961996
    19971997/**
     
    20312031                           const char *pszEnvVarBase, unsigned cGroups, const char * const * papszGroups,
    20322032                           uint32_t fDestFlags, PFNRTLOGPHASE pfnPhase, uint32_t cHistory,
    2033                            uint64_t cbHistoryFileMax, uint32_t cSecsHistoryTimeSlot,
    2034                            char *pszErrorMsg, size_t cchErrorMsg,
    2035                            const char *pszFilenameFmt, va_list args) RT_IPRT_FORMAT_ATTR(14, 0);
     2033                           uint64_t cbHistoryFileMax, uint32_t cSecsHistoryTimeSlot, char *pszErrorMsg, size_t cchErrorMsg,
     2034                           const char *pszFilenameFmt, va_list args) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(14, 0);
    20362035
    20372036/**
  • trunk/include/iprt/semaphore.h

    r56291 r57004  
    131131 * @param   ...                 Format string arguments.
    132132 */
    133 RTDECL(int)  RTSemEventCreateEx(PRTSEMEVENT phEventSem, uint32_t fFlags, RTLOCKVALCLASS hClass, const char *pszNameFmt, ...);
     133RTDECL(int)  RTSemEventCreateEx(PRTSEMEVENT phEventSem, uint32_t fFlags, RTLOCKVALCLASS hClass,
     134                                const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(4, 5);
    134135
    135136/** @name RTSemMutexCreateEx flags
     
    301302 */
    302303RTDECL(int)  RTSemEventMultiCreateEx(PRTSEMEVENTMULTI phEventMultiSem, uint32_t fFlags, RTLOCKVALCLASS hClass,
    303                                      const char *pszNameFmt, ...);
     304                                     const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(4, 5);
    304305
    305306/** @name RTSemMutexCreateEx flags
     
    481482 * @param   ...                 Format string arguments.
    482483 */
    483 RTDECL(int) RTSemMutexCreateEx(PRTSEMMUTEX phMutexSem, uint32_t fFlags,
    484                                RTLOCKVALCLASS hClass, uint32_t uSubClass, const char *pszNameFmt, ...);
     484RTDECL(int) RTSemMutexCreateEx(PRTSEMMUTEX phMutexSem, uint32_t fFlags, RTLOCKVALCLASS hClass, uint32_t uSubClass,
     485                               const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(5, 6);
    485486
    486487/** @name RTSemMutexCreateEx flags
     
    845846 * @param   ...                 Format string arguments.
    846847 */
    847 RTDECL(int)   RTSemRWCreateEx(PRTSEMRW phRWSem, uint32_t fFlags,
    848                               RTLOCKVALCLASS hClass, uint32_t uSubClass, const char *pszNameFmt, ...);
     848RTDECL(int)   RTSemRWCreateEx(PRTSEMRW phRWSem, uint32_t fFlags, RTLOCKVALCLASS hClass, uint32_t uSubClass,
     849                              const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(5, 6);
    849850
    850851/** @name RTSemRWCreateEx flags
  • trunk/include/iprt/string.h

    r56980 r57004  
    19531953 * @param   args        The format argument.
    19541954 */
    1955 RTDECL(size_t) RTStrPrintfV(char *pszBuffer, size_t cchBuffer, const char *pszFormat, va_list args);
     1955RTDECL(size_t) RTStrPrintfV(char *pszBuffer, size_t cchBuffer, const char *pszFormat, va_list args) RT_IPRT_FORMAT_ATTR(3, 0);
    19561956
    19571957/**
     
    20402040 * @param   ...         The format argument.
    20412041 */
    2042 DECLINLINE(int) RT_IPRT_FORMAT_ATTR(2, 3)
    2043 RTStrAPrintf(char **ppszBuffer, const char *pszFormat, ...)
     2042DECLINLINE(int) RT_IPRT_FORMAT_ATTR(2, 3) RTStrAPrintf(char **ppszBuffer, const char *pszFormat, ...)
    20442043{
    20452044    int     cbRet;
     
    20642063 * @param   ...         The format argument.
    20652064 */
    2066 DECLINLINE(int) RT_IPRT_FORMAT_ATTR(3, 4)
    2067 RTStrAPrintfTag(char **ppszBuffer, const char *pszTag, const char *pszFormat, ...)
     2065DECLINLINE(int) RT_IPRT_FORMAT_ATTR(3, 4) RTStrAPrintfTag(char **ppszBuffer, const char *pszTag, const char *pszFormat, ...)
    20682066{
    20692067    int     cbRet;
     
    21042102 * @param   ...         The format argument.
    21052103 */
    2106 DECLINLINE(char *) RT_IPRT_FORMAT_ATTR(1, 2)
    2107 RTStrAPrintf2(const char *pszFormat, ...)
     2104DECLINLINE(char *) RT_IPRT_FORMAT_ATTR(1, 2) RTStrAPrintf2(const char *pszFormat, ...)
    21082105{
    21092106    char   *pszRet;
     
    21242121 * @param   ...         The format argument.
    21252122 */
    2126 DECLINLINE(char *) RT_IPRT_FORMAT_ATTR(2, 3)
    2127 RTStrAPrintf2Tag(const char *pszTag, const char *pszFormat, ...)
     2123DECLINLINE(char *) RT_IPRT_FORMAT_ATTR(2, 3) RTStrAPrintf2Tag(const char *pszTag, const char *pszFormat, ...)
    21282124{
    21292125    char   *pszRet;
  • trunk/include/iprt/test.h

    r56291 r57004  
    262262 * @param   va          Arguments.
    263263 */
    264 RTR3DECL(int) RTTestPrintfNlV(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, va_list va);
     264RTR3DECL(int) RTTestPrintfNlV(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    265265
    266266/**
     
    274274 * @param   ...         Arguments.
    275275 */
    276 RTR3DECL(int) RTTestPrintfNl(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, ...);
     276RTR3DECL(int) RTTestPrintfNl(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    277277
    278278/**
     
    286286 * @param   va          Arguments.
    287287 */
    288 RTR3DECL(int) RTTestPrintfV(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, va_list va);
     288RTR3DECL(int) RTTestPrintfV(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    289289
    290290/**
     
    298298 * @param   ...         Arguments.
    299299 */
    300 RTR3DECL(int) RTTestPrintf(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, ...);
     300RTR3DECL(int) RTTestPrintf(RTTEST hTest, RTTESTLVL enmLevel, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    301301
    302302/**
     
    327327 * @param   va              Arguments for the reason format string.
    328328 */
    329 RTR3DECL(RTEXITCODE) RTTestSkipAndDestroyV(RTTEST hTest, const char *pszReasonFmt, va_list va);
     329RTR3DECL(RTEXITCODE) RTTestSkipAndDestroyV(RTTEST hTest, const char *pszReasonFmt, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    330330
    331331/**
     
    338338 * @param   ...             Arguments for the reason format string.
    339339 */
    340 RTR3DECL(RTEXITCODE) RTTestSkipAndDestroy(RTTEST hTest, const char *pszReasonFmt, ...);
     340RTR3DECL(RTEXITCODE) RTTestSkipAndDestroy(RTTEST hTest, const char *pszReasonFmt, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    341341
    342342/**
     
    364364 * @param   ...             Arguments.
    365365 */
    366 RTR3DECL(int) RTTestSubF(RTTEST hTest, const char *pszSubTestFmt, ...);
     366RTR3DECL(int) RTTestSubF(RTTEST hTest, const char *pszSubTestFmt, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    367367
    368368/**
     
    377377 * @param   va              Arguments.
    378378 */
    379 RTR3DECL(int) RTTestSubV(RTTEST hTest, const char *pszSubTestFmt, va_list va);
     379RTR3DECL(int) RTTestSubV(RTTEST hTest, const char *pszSubTestFmt, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    380380
    381381/**
     
    400400 * @param   va          The arguments.
    401401 */
    402 RTR3DECL(int) RTTestPassedV(RTTEST hTest, const char *pszFormat, va_list va);
     402RTR3DECL(int) RTTestPassedV(RTTEST hTest, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    403403
    404404/**
     
    414414 * @param   ...         The arguments.
    415415 */
    416 RTR3DECL(int) RTTestPassed(RTTEST hTest, const char *pszFormat, ...);
     416RTR3DECL(int) RTTestPassed(RTTEST hTest, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    417417
    418418/**
     
    426426 * @param   ...         The arguments.
    427427 */
    428 RTR3DECL(int) RTTestSkipped(RTTEST hTest, const char *pszFormat, ...);
     428RTR3DECL(int) RTTestSkipped(RTTEST hTest, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(2, 3);
    429429
    430430/**
     
    438438 * @param   va          The arguments.
    439439 */
    440 RTR3DECL(int) RTTestSkippedV(RTTEST hTest, const char *pszFormat, va_list va);
     440RTR3DECL(int) RTTestSkippedV(RTTEST hTest, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR_MAYBE_NULL(2, 0);
    441441
    442442
     
    527527 * @param   ...         String arguments.
    528528 */
    529 RTR3DECL(int) RTTestValueF(RTTEST hTest, uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, ...);
     529RTR3DECL(int) RTTestValueF(RTTEST hTest, uint64_t u64Value, RTTESTUNIT enmUnit,
     530                           const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(4, 5);
    530531
    531532/**
     
    541542 * @param   va_list     String arguments.
    542543 */
    543 RTR3DECL(int) RTTestValueV(RTTEST hTest, uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, va_list va);
     544RTR3DECL(int) RTTestValueV(RTTEST hTest, uint64_t u64Value, RTTESTUNIT enmUnit,
     545                           const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR(4, 0);
    544546
    545547/**
     
    579581 * @param   va          The arguments.
    580582 */
    581 RTR3DECL(int) RTTestFailedV(RTTEST hTest, const char *pszFormat, va_list va);
     583RTR3DECL(int) RTTestFailedV(RTTEST hTest, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    582584
    583585/**
     
    590592 * @param   ...         The arguments.
    591593 */
    592 RTR3DECL(int) RTTestFailed(RTTEST hTest, const char *pszFormat, ...);
     594RTR3DECL(int) RTTestFailed(RTTEST hTest, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    593595
    594596/**
     
    601603 * @param   va          Arguments.
    602604 */
    603 RTR3DECL(int) RTTestFailureDetailsV(RTTEST hTest, const char *pszFormat, va_list va);
     605RTR3DECL(int) RTTestFailureDetailsV(RTTEST hTest, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    604606
    605607/**
     
    612614 * @param   ...         Arguments.
    613615 */
    614 RTR3DECL(int) RTTestFailureDetails(RTTEST hTest, const char *pszFormat, ...);
     616RTR3DECL(int) RTTestFailureDetails(RTTEST hTest, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    615617
    616618
     
    878880 * @param   va          Arguments.
    879881 */
    880 RTR3DECL(int) RTTestIPrintfV(RTTESTLVL enmLevel, const char *pszFormat, va_list va);
     882RTR3DECL(int) RTTestIPrintfV(RTTESTLVL enmLevel, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    881883
    882884/**
     
    888890 * @param   ...         Arguments.
    889891 */
    890 RTR3DECL(int) RTTestIPrintf(RTTESTLVL enmLevel, const char *pszFormat, ...);
     892RTR3DECL(int) RTTestIPrintf(RTTESTLVL enmLevel, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    891893
    892894/**
     
    910912 * @param   ...             Arguments.
    911913 */
    912 RTR3DECL(int) RTTestISubF(const char *pszSubTestFmt, ...);
     914RTR3DECL(int) RTTestISubF(const char *pszSubTestFmt, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    913915
    914916/**
     
    921923 * @param   va              Arguments.
    922924 */
    923 RTR3DECL(int) RTTestISubV(const char *pszSubTestFmt, va_list va);
     925RTR3DECL(int) RTTestISubV(const char *pszSubTestFmt, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    924926
    925927/**
     
    940942 * @param   va          The arguments.
    941943 */
    942 RTR3DECL(int) RTTestIPassedV(const char *pszFormat, va_list va);
     944RTR3DECL(int) RTTestIPassedV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    943945
    944946/**
     
    952954 * @param   ...         The arguments.
    953955 */
    954 RTR3DECL(int) RTTestIPassed(const char *pszFormat, ...);
     956RTR3DECL(int) RTTestIPassed(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    955957
    956958/**
     
    979981 * @param   ...         String arguments.
    980982 */
    981 RTR3DECL(int) RTTestIValueF(uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, ...);
     983RTR3DECL(int) RTTestIValueF(uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(3, 4);
    982984
    983985/**
     
    991993 * @param   va_list     String arguments.
    992994 */
    993 RTR3DECL(int) RTTestIValueV(uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, va_list va);
     995RTR3DECL(int) RTTestIValueV(uint64_t u64Value, RTTESTUNIT enmUnit, const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR(3, 0);
    994996
    995997/**
     
    10141016 * @param   va          The arguments.
    10151017 */
    1016 RTR3DECL(int) RTTestIFailedV(const char *pszFormat, va_list va);
     1018RTR3DECL(int) RTTestIFailedV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    10171019
    10181020/**
     
    10231025 * @param   ...         The arguments.
    10241026 */
    1025 RTR3DECL(int) RTTestIFailed(const char *pszFormat, ...);
     1027RTR3DECL(int) RTTestIFailed(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    10261028
    10271029/**
     
    10371039 * @param   va          The arguments.
    10381040 */
    1039 RTR3DECL(int) RTTestIFailedRcV(int rcRet, const char *pszFormat, va_list va);
     1041RTR3DECL(int) RTTestIFailedRcV(int rcRet, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    10401042
    10411043/**
     
    10511053 * @param   ...         The arguments.
    10521054 */
    1053 RTR3DECL(int) RTTestIFailedRc(int rcRet, const char *pszFormat, ...);
     1055RTR3DECL(int) RTTestIFailedRc(int rcRet, const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(2, 3);
    10541056
    10551057/**
     
    10601062 * @param   va          Arguments.
    10611063 */
    1062 RTR3DECL(int) RTTestIFailureDetailsV(const char *pszFormat, va_list va);
     1064RTR3DECL(int) RTTestIFailureDetailsV(const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(1, 0);
    10631065
    10641066/**
     
    10691071 * @param   ...         Arguments.
    10701072 */
    1071 RTR3DECL(int) RTTestIFailureDetails(const char *pszFormat, ...);
     1073RTR3DECL(int) RTTestIFailureDetails(const char *pszFormat, ...) RT_IPRT_FORMAT_ATTR(1, 2);
    10721074
    10731075
  • trunk/include/iprt/thread.h

    r56291 r57004  
    299299 */
    300300RTDECL(int) RTThreadCreateV(PRTTHREAD pThread, PFNRTTHREAD pfnThread, void *pvUser, size_t cbStack,
    301                             RTTHREADTYPE enmType, uint32_t fFlags, const char *pszNameFmt, va_list va);
     301                            RTTHREADTYPE enmType, uint32_t fFlags, const char *pszNameFmt, va_list va) RT_IPRT_FORMAT_ATTR(7, 0);
    302302
    303303/**
     
    317317 */
    318318RTDECL(int) RTThreadCreateF(PRTTHREAD pThread, PFNRTTHREAD pfnThread, void *pvUser, size_t cbStack,
    319                             RTTHREADTYPE enmType, uint32_t fFlags, const char *pszNameFmt, ...);
     319                            RTTHREADTYPE enmType, uint32_t fFlags, const char *pszNameFmt, ...) RT_IPRT_FORMAT_ATTR(7, 8);
    320320
    321321/**
  • trunk/include/iprt/trace.h

    r56291 r57004  
    176176
    177177RTDECL(int)         RTTraceBufAddMsg(      RTTRACEBUF hTraceBuf, const char *pszMsg);
    178 RTDECL(int)         RTTraceBufAddMsgF(     RTTRACEBUF hTraceBuf, const char *pszMsgFmt, ...);
    179 RTDECL(int)         RTTraceBufAddMsgV(     RTTRACEBUF hTraceBuf, const char *pszMsgFmt, va_list va);
     178RTDECL(int)         RTTraceBufAddMsgF(     RTTRACEBUF hTraceBuf, const char *pszMsgFmt, ...) RT_IPRT_FORMAT_ATTR(2, 3);
     179RTDECL(int)         RTTraceBufAddMsgV(     RTTRACEBUF hTraceBuf, const char *pszMsgFmt, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    180180RTDECL(int)         RTTraceBufAddMsgEx(    RTTRACEBUF hTraceBuf, const char *pszMsg, size_t cbMaxMsg);
    181181
     
    183183RTDECL(int)         RTTraceBufAddPosMsg(   RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsg);
    184184RTDECL(int)         RTTraceBufAddPosMsgEx( RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsg, size_t cbMaxMsg);
    185 RTDECL(int)         RTTraceBufAddPosMsgF(  RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsgFmt, ...);
    186 RTDECL(int)         RTTraceBufAddPosMsgV(  RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsgFmt, va_list va);
     185RTDECL(int)         RTTraceBufAddPosMsgF(  RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsgFmt, ...) RT_IPRT_FORMAT_ATTR(5, 6);
     186RTDECL(int)         RTTraceBufAddPosMsgV(  RTTRACEBUF hTraceBuf, RT_SRC_POS_DECL, const char *pszMsgFmt, va_list va) RT_IPRT_FORMAT_ATTR(5, 0);
    187187
    188188
  • trunk/include/iprt/types.h

    r56291 r57004  
    7171#  include <sys/types.h>
    7272#  ifndef offsetof
    73 #   error "offsetof is not defined..."
     73#   error "offsetof is not defined!"
    7474#  endif
    7575
     
    21992199 * @param   va              Arguments for the format string.
    22002200 */
    2201 typedef DECLCALLBACK(void) FNRTDUMPPRINTFV(void *pvUser, const char *pszFormat, va_list va);
     2201typedef DECLCALLBACK(void) FNRTDUMPPRINTFV(void *pvUser, const char *pszFormat, va_list va) RT_IPRT_FORMAT_ATTR(2, 0);
    22022202/** Pointer to a generic printf-like function for dumping. */
    22032203typedef FNRTDUMPPRINTFV *PFNRTDUMPPRINTFV;
     
    24162416typedef union RTPTRUNION
    24172417{
    2418     /** Pointer into the void... */
     2418    /** Pointer into the void. */
    24192419    void                   *pv;
    24202420    /** As a signed integer. */
     
    24552455typedef union RTCPTRUNION
    24562456{
    2457     /** Pointer into the void... */
     2457    /** Pointer into the void. */
    24582458    void const             *pv;
    24592459    /** As a signed integer. */
     
    24942494typedef union RTVPTRUNION
    24952495{
    2496     /** Pointer into the void... */
     2496    /** Pointer into the void. */
    24972497    void volatile          *pv;
    24982498    /** As a signed integer. */
     
    25332533typedef union RTCVPTRUNION
    25342534{
    2535     /** Pointer into the void... */
     2535    /** Pointer into the void. */
    25362536    void const volatile            *pv;
    25372537    /** As a signed integer. */
  • trunk/include/iprt/uri.h

    r53615 r57004  
    5555 * @param   pszFragment         The fragment part of the URI (optional).
    5656 */
    57 RTR3DECL(char *) RTUriCreate(const char *pszScheme, const char *pszAuthority, const char *pszPath, const char *pszQuery, const char *pszFragment);
     57RTR3DECL(char *) RTUriCreate(const char *pszScheme, const char *pszAuthority, const char *pszPath, const char *pszQuery,
     58                             const char *pszFragment);
    5859
    5960/**
  • trunk/include/iprt/vector.h

    r56291 r57004  
    11/** @file
    2  * IPRT - Vector
    3  * STL-inspired vector implementation in C
     2 * IPRT - Vector - STL-inspired vector implementation in C.
    43 */
    54
     
    6564 *       (or passing them as anonymously) makes it easier to take care of this.
    6665 */
     66
    6767#ifndef ___iprt_vector_h
    68 # define ___iprt_vector_h
     68#define ___iprt_vector_h
    6969
    7070/*******************************************************************************
     
    373373                                         pfnDelete)
    374374
    375 #endif /* ___iprt_vector_h */
     375#endif /* !___iprt_vector_h */
     376
Note: See TracChangeset for help on using the changeset viewer.

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