Contents

Title and Copyright Information

About This Manual
Audience
Organization
Related Documents
Location of Code Examples
Location of Online Documentation
Reader's Comments
Conventions

1    Software Installation
1.1    Installing the MEMORY CHANNEL Software
1.1.1    Obtain IP Names and Addresses
1.1.2    Halt System and Set Console Variables
1.1.3    Boot to Single-User Mode and Deinstall Software
1.1.4    Install the DIGITAL UNIX Operating System
1.1.5    Register the MEMORY CHANNEL Software License
1.1.6    Load the Kit
1.1.7    Specify a Network Interface IP Name and Address
1.1.8    Select a Kernel Configuration File
1.1.9    Build and Install a New Kernel
1.1.10    Reboot the System
1.1.11    Installation Example
1.1.12    Verify the Installation with the clu_ivp Utility
1.2    Initializing the MEMORY CHANNEL API Library
1.3    The MEMORY CHANNEL Multirail Model
1.3.1    Single-Rail Style
1.3.2    Failover Pair Style
1.3.3    Configuring the MEMORY CHANNEL Multirail Model
1.4    Tuning Your MEMORY CHANNEL Configuration
1.4.1    Extending MEMORY CHANNEL Address Space
1.4.2    Increasing Wired Memory
1.4.3    Increasing Virtual Memory Map Entries
1.5    Troubleshooting
1.5.1    IMC_NOTINIT Return Code
1.5.2    MEMORY CHANNEL API Library Initialization Failure
1.5.3    Fatal MEMORY CHANNEL Errors
1.5.3.1    Logical Rail Failure
1.5.3.2    Logical Rail Initialization Failure
1.5.3.3    MEMORY CHANNEL Cables Crossed
1.5.4    IMC_MCFULL Return Code
1.5.5    IMC_RXFULL Return Code
1.5.6    IMC_WIRED_LIMIT Return Code
1.5.7    IMC_MAPENTRIES Return Code
1.5.8    IMC_NOMEM Return Code
1.5.9    IMC_NORESOURCES Return Code

2    Application Notes
2.1    Initializing the MEMORY CHANNEL API Library for a User Program
2.2    Accessing MEMORY CHANNEL Address Space
2.2.1    Attaching to MEMORY CHANNEL Address Space
2.2.1.1    Broadcast Attach
2.2.1.2    Point-to-Point Attach
2.2.1.3    Loopback Attach
2.2.2    Initial Coherency
2.2.3    Reading and Writing MEMORY CHANNEL Regions
2.2.4    Address Space Example
2.2.5    Latency Related Coherency
2.2.6    Error Management
2.3    Clusterwide Locks
2.4    Cluster Signals
2.5    Cluster Information
2.5.1    Using MEMORY CHANNEL API Functions to Access MEMORY CHANNEL API Cluster Information
2.5.2    Accessing MEMORY CHANNEL Status Information from the Command Line
2.6    Comparison of Shared Memory and Message Passing Models

3    MEMORY CHANNEL API Library Interface
3.1    Header Files
3.2    Library
3.3    Compiling Applications that Use the MEMORY CHANNEL API Library
3.4    Overview of MEMORY CHANNEL API Library Commands and Functions
imc(3)
3.5    Command Descriptions
imc_init(1)
imcs(1)
3.6    Function Descriptions
imc_api_init(3)
imc_asalloc(3)
imc_asattach(3)
imc_asattach_ptp(3)
imc_asdealloc(3)
imc_asdetach(3)
imc_bcopy(3)
imc_ckerrcnt(3)
imc_ckerrcnt_mr(3)
imc_getclusterinfo(3)
imc_kill(3)
imc_lkacquire(3)
imc_lkalloc(3)
imc_lkdealloc(3)
imc_lkrelease(3)
imc_perror(3)
imc_rderrcnt(3)
imc_rderrcnt_mr(3)
imc_wait_cluster_event(3)

A    Frequently Asked Questions
A.1    IMC_NOMAPPER Return Code
A.2    Efficient Data Copy
A.3    MEMORY CHANNEL Bandwidth Availability
A.4    MEMORY CHANNEL API Cluster Configuration Change
A.5    Bus Error Message
A.6    Deciding Which TruCluster Product To Use
A.7    Finding Out More About MEMORY CHANNEL

Examples

Figures