OSD_MemInfo Class Reference

This class provide information about memory utilized by current process. This information includes: More...

#include <OSD_MemInfo.hxx>

Public Types
enum	Counter {   MemPrivate = 0, MemVirtual, MemWorkingSet, MemWorkingSetPeak,   MemSwapUsage, MemSwapUsagePeak, MemHeapUsage, MemCounter_NB }

Public Member Functions
	OSD_MemInfo (const Standard_Boolean theImmediateUpdate=Standard_True)
	Create and initialize. More...
void	Clear ()
	Clear counters. More...
void	Update ()
	Update counters. More...
TCollection_AsciiString	ToString () const
	Return the string representation for all available counter. More...
Standard_Size	Value (const OSD_MemInfo::Counter theCounter) const
	Return value of specified counter in bytes. Notice that NOT all counters are available on various systems. Standard_Size(-1) means invalid (unavailable) value. More...
Standard_Size	ValueMiB (const OSD_MemInfo::Counter theCounter) const
	Return value of specified counter in MiB. Notice that NOT all counters are available on various systems. Standard_Size(-1) means invalid (unavailable) value. More...
Standard_Real	ValuePreciseMiB (const OSD_MemInfo::Counter theCounter) const
	Return floating value of specified counter in MiB. Notice that NOT all counters are available on various systems. Standard_Real(-1) means invalid (unavailable) value. More...

Static Public Member Functions
static TCollection_AsciiString	PrintInfo ()
	Return the string representation for all available counter. More...

Detailed Description

This class provide information about memory utilized by current process. This information includes:

• Private Memory - synthetic value that tries to filter out the memory usage only by the process itself (allocated for data and stack), excluding dynamic libraries. These pages may be in RAM or in SWAP.
• Virtual Memory - amount of reserved and committed memory in the user-mode portion of the virtual address space. Notice that this counter includes reserved memory (not yet in used) and shared between processes memory (libraries).
• Working Set - set of memory pages in the virtual address space of the process that are currently resident in physical memory (RAM). These pages are available for an application to use without triggering a page fault.
• Pagefile Usage - space allocated for the pagefile, in bytes. Those pages may or may not be in memory (RAM) thus this counter couldn't be used to estimate how many active pages doesn't present in RAM.

Notice that none of these counters can be used as absolute measure of application memory consumption!

User should analyze all values in specific case to make correct decision about memory (over)usage. This is also prefferred to use specialized tools to detect memory leaks.

This also means that these values should not be used for intellectual memory management by application itself.

Member Enumeration Documentation

Counter

enum OSD_MemInfo::Counter

Enumerator
MemPrivate	Virtual memory allocated for data and stack excluding libraries.
MemVirtual	Reserved and committed memory of the virtual address space.
MemWorkingSet	Memory pages that are currently resident in physical memory.
MemWorkingSetPeak	Peak working set size.
MemSwapUsage	Space allocated for the pagefile.
MemSwapUsagePeak	Peak space allocated for the pagefile.
MemHeapUsage	Total space allocated from the heap.
MemCounter_NB	Indicates total counters number.

Constructor & Destructor Documentation

OSD_MemInfo()

OSD_MemInfo::OSD_MemInfo

(

const Standard_Boolean

theImmediateUpdate = Standard_True

)

Create and initialize.

Member Function Documentation

Clear()

void OSD_MemInfo::Clear

(

)

Clear counters.

PrintInfo()

static TCollection_AsciiString OSD_MemInfo::PrintInfo ( )

static

Return the string representation for all available counter.

ToString()

TCollection_AsciiString OSD_MemInfo::ToString

(

)

const

Return the string representation for all available counter.

Update()

void OSD_MemInfo::Update

(

)

Update counters.

Value()

Standard_Size OSD_MemInfo::Value

(

const OSD_MemInfo::Counter

theCounter

)

const

Return value of specified counter in bytes. Notice that NOT all counters are available on various systems. Standard_Size(-1) means invalid (unavailable) value.

ValueMiB()

Standard_Size OSD_MemInfo::ValueMiB

(

const OSD_MemInfo::Counter

theCounter

)

const

Return value of specified counter in MiB. Notice that NOT all counters are available on various systems. Standard_Size(-1) means invalid (unavailable) value.

ValuePreciseMiB()

Standard_Real OSD_MemInfo::ValuePreciseMiB

(

const OSD_MemInfo::Counter

theCounter

)

const

Return floating value of specified counter in MiB. Notice that NOT all counters are available on various systems. Standard_Real(-1) means invalid (unavailable) value.

---

The documentation for this class was generated from the following file:

• OSD_MemInfo.hxx