procmaps Class Reference

A simple API to access /proc/self/maps info. More...

#include <procmaps.h>

Collaboration diagram for procmaps:

Classes
struct	Entry

Public Types
typedef std::vector< Entry >	procmaps_t
typedef procmaps_t::const_iterator	const_iterator

Public Member Functions
	procmaps (size_t entries=1024)
const Entry *	getEntry (const void *address, bool tryReloadMaps=true)
	main entry point: get info for the page range containing address by default tries to reload /proc/self/maps when address is not found More...
const procmaps_t &	pmaps () const
	access underlying entries More...
const_iterator	begin () const
const_iterator	end () const
void	loadMaps (bool dump=false)
	load/refresh info from /proc/self/map More...

Private Attributes
procmaps_t	m_pmaps

Detailed Description

A simple API to access /proc/self/maps info.

On stopMonitoring/finalize the handler is uninstalled. On finalize a report of the accessed and unaccessed pages and addresses is produced. processing. Additional information can be added via setPageAccessControlInfo().

Properties: AutoMonitor: when true start monitoring on initialize, stop on finalize;

Author

Paolo Calafiura - LBNL, ATLAS Collaboration

Id

procmaps.h,v 1.3 2009-04-01 08:23:32 binet Exp

Definition at line 18 of file procmaps.h.

Member Typedef Documentation

const_iterator

typedef procmaps_t::const_iterator procmaps::const_iterator

Definition at line 38 of file procmaps.h.

procmaps_t

typedef std::vector<Entry> procmaps::procmaps_t

Definition at line 37 of file procmaps.h.

Constructor & Destructor Documentation

procmaps()

procmaps::procmaps

(

size_t

entries = 1024

)

Definition at line 41 of file procmaps.cxx.

                                 {
  m_pmaps.reserve(entries);
  loadMaps(false);
}

Member Function Documentation

begin()

const_iterator procmaps::begin ( ) const

inline

Definition at line 46 of file procmaps.h.

{ return pmaps().begin(); }

end()

const_iterator procmaps::end ( ) const

inline

Definition at line 47 of file procmaps.h.

{ return pmaps().end(); }

getEntry()

const procmaps::Entry * procmaps::getEntry	(	const void *	address,
		bool	tryReloadMaps = true
	)

main entry point: get info for the page range containing address by default tries to reload /proc/self/maps when address is not found

Definition at line 59 of file procmaps.cxx.

                                                         {
  unsigned long toMatch = reinterpret_cast<unsigned long>(address);
  auto i = std::upper_bound (this->begin(), this->end(),
                             toMatch,
                             [] (unsigned long addr, const Entry& ent)
                             { return addr < ent.begAddress; });
 
  if (i > this->begin()) {
    --i;
    if (toMatch >= i->begAddress && toMatch < i->endAddress) {
      return &*i;
    }
  }
 
  if (refreshMaps) {
    //if ! found recurse once by calling getEntry with refreshMaps false
    loadMaps();
    return getEntry(address,false);
  }
 
  return nullptr;
}

loadMaps()

void procmaps::loadMaps

(

bool

dump = false

)

load/refresh info from /proc/self/map

Definition at line 47 of file procmaps.cxx.

                            {
  m_pmaps.clear();
  std::ifstream f("/proc/self/maps");
  const int LMAX=256;
  char line[LMAX];
  while ( f.getline(line,LMAX) ) {
    if (dump) printf("%s",line);
   m_pmaps.emplace_back(line);
  }
}

pmaps()

const procmaps_t& procmaps::pmaps ( ) const

inline

access underlying entries

Definition at line 45 of file procmaps.h.

{ return m_pmaps; }

Member Data Documentation

m_pmaps

procmaps_t procmaps::m_pmaps

private

Definition at line 53 of file procmaps.h.

---

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

• procmaps.h
• procmaps.cxx