Debugging tools

Assertions, breakpoints, logging, and abnormal program termination. More...

Collaboration diagram for Debugging tools:

Topics
	Assertions
	Assert functions and macros.
	Breakpoints
	Trigger a debugger breakpoint.
	Logging
	Logging functions and macros.

Files
file	build-profile-test-suite.cc
	NS_BUILD_PROFILE macros test suite.
file	build-profile.h
	NS_BUILD_DEBUG, NS_BUILD_RELEASE, and NS_BUILD_OPTIMIZED macro definitions.

Classes
class	ns3::ShowProgress
	Periodically print a status message indicating simulator progress. More...

Macros
#define	NS_BUILD_DEBUG(code)
	Execute a code snippet in debug builds.
#define	NS_BUILD_OPTIMIZED(code)
	Execute a code snippet in optimized builds.
#define	NS_BUILD_PROFILE_NOOP(code)
	Build profile no-op macro.
#define	NS_BUILD_PROFILE_OP(code)
	Build profile macro to execute a code snippet.
#define	NS_BUILD_RELEASE(code)
	Execute a code snippet in release builds.

Detailed Description

Assertions, breakpoints, logging, and abnormal program termination.

Macro Definition Documentation

NS_BUILD_DEBUG

#define NS_BUILD_DEBUG

(

code

)

Value:

NS_BUILD_PROFILE_OP(code)

Execute a code snippet in debug builds.

Parameters

[in]

code

The code to execute.

Definition at line 49 of file build-profile.h.

Referenced by ns3::tests::BuildProfileTestCase::DoRun(), ns3::PcapFile::Write(), ns3::PcapFile::Write(), and ns3::PcapFile::WritePacketHeader().

NS_BUILD_OPTIMIZED

#define NS_BUILD_OPTIMIZED

(

code

)

Value:

NS_BUILD_PROFILE_OP(code)

Execute a code snippet in optimized builds.

Parameters

[in]

code

The code to execute.

Definition at line 71 of file build-profile.h.

Referenced by ns3::tests::BuildProfileTestCase::DoRun().

NS_BUILD_PROFILE_NOOP

#define NS_BUILD_PROFILE_NOOP

(

code

)

Value:

    do                                                                                             \
        if (false)                                                                                 \
        {                                                                                          \
            code;                                                                                  \
        }                                                                                          \
    while (false)

Build profile no-op macro.

Parameters

[in]

code

The code to skip.

Definition at line 24 of file build-profile.h.

NS_BUILD_PROFILE_OP

#define NS_BUILD_PROFILE_OP

(

code

)

Value:

    do                                                                                             \
    {                                                                                              \
        code;                                                                                      \
    } while (false)

Build profile macro to execute a code snippet.

Parameters

[in]

code

The code to execute.

Definition at line 37 of file build-profile.h.

NS_BUILD_RELEASE

#define NS_BUILD_RELEASE

(

code

)

Value:

NS_BUILD_PROFILE_OP(code)

Execute a code snippet in release builds.

Parameters

[in]

code

The code to execute.

Definition at line 60 of file build-profile.h.

Referenced by ns3::tests::BuildProfileTestCase::DoRun().