StackThreads/MP User's Manual

Jan 1999

This manual corresponds to StackThreads/MP version 0.76

• Introduction
  • Reporting Bugs
  • Platforms
  • Installation
• The Basics
  • An Example
  • Compiling
  • Running
  • Basic Primitives
• APIs
  • Creating A Thread
  • Polling
  • Synchronization
    • Join Counter
    • Semaphore
    • Mutex
    • Condition Variable
  • Spin-Locks
    • Initialization, Lock, and Unlock
    • Reading and Checking Locations
    • Try Lock and Lock Any
    • Fetch and Add
  • Yield
  • Stacks and Contexts
    • Examine Current Stack Size
    • Show Stack Trace
    • Invoke Stack Management
    • Stack Pointers and Frame Pointers
  • Profiler
  • Timing
  • Workers and Worker Groups
    • Create A Group
    • Add a Slave Worker
    • Check Messages between Workers
    • Deschedule Worker
  • Callback
  • Graceful Exits
  • Thread Manipulation
    • Suspending A Thread
    • Resuming A Thread
    • Procedure Information
  • Thread and Worker ID
• Memory Management
  • Parallel Conservative Garbage Collector (SGC)
    • GC_MALLOC and GC_FREE
    • Controlling GC behavior
  • Region-Based Memory Management
    • Region Basics
    • Creating A Region
  • How to Switch between Allocators
    • Changing the Underlying Allocator
    • Changing Region-based Allocator
  • Alloca is not supported (yet)
• Performance Profiler
  • Profiling your program
  • Viewing profiled results
• Cooperating with Sequential Modules
  • Calling Sequential Procedure from StackThreads/MP Procedure
  • Calling StackThreads/MP Procedure from Sequential Procedure
    • Create a Worker Group
    • Setup TLS Pointers
• Command Summary
  • STGCC/STG++: A wrapper for GCC
  • STLINK: A Wrapper for Linker
  • Command Line Options Common for All StackThreads/MP Programs
• Applying Safety Patches to GCC
  • How to Apply Patches
  • Using Patched GCC
  • Detailed Description of Patches
• Advanced Topics
  • How does it work, basically?
  • A recommended programming style for performance
  • Where should you insert ST_POLLING?
  • Implementing Synchronization Primitives
  • What Does stgcc Command Do?
  • What Does the Postprocessor Do?
• Known Limitations and Subtleties
  • Floating SP Problem
  • Possible Slowdown by Disabling Inline
  • Structure passing on SPARC
  • C++ Global Constructors
  • Alloca
  • Big arguments
  • Interaction with pragma interface
• FAQ
  • Why am I interested in it?
  • Does it subsume Pthreads?
  • Compilation fails
  • Link fails
  • How to obtain tools
  • Why is compilation slow?
  • Segmentation fault
  • Why is my program slow on a single processor?
  • Why is my program slow on multiprocessors
  • What is ST_POLLING for?
  • Why both spin-locks and mutex?

This document was generated on 3 April 2000 using the texi2html translator version 1.51.