Memory and Thread Placement Optimization Developer's Guide

sun.com docs.sun.com

My Sun Worldwide Sites

Support

November 2008

This book has information on memory thread placement and optimization techniques for developers. Topics covered include the locality groups API and associated command-line tools.

Document Information

Preface

1. Overview of Locality Groups

Locality Groups Overview

MPO Observability Tools

2. MPO Observability Tools

The pmadvise utility

Using the madv.so.1 Shared Object

madv.so.1 Usage Examples

The plgrp tool

Specifying Lgroups

Specifying Process and Thread Arguments

The lgrpinfo Tool

Options for the lgrpinfo Tool

The Solaris::lgrp Module

Functions in the Solaris::lgrp Module

Object Methods in the Solaris::lgrp Module

3. Locality Group APIs

Verifying the Interface Version

Initializing the Locality Group Interface

Using lgrp_init()

Using lgrp_fini()

Locality Group Hierarchy

Using lgrp_cookie_stale()

Using lgrp_view()

Using lgrp_nlgrps()

Using lgrp_root()

Using lgrp_parents()

Using lgrp_children()

Locality Group Contents

Using lgrp_resources()

Using lgrp_cpus()

Using lgrp_mem_size()

Locality Group Characteristics

Using lgrp_latency_cookie()

Locality Groups and Thread and Memory Placement

Using lgrp_home()

Using madvise()

Using meminfo()

Locality Group Affinity

Using lgrp_affinity_get()

Using lgrp_affinity_set()

Examples of API Usage