__protected_stream_set, __protected_unlimited_stream_set, __protected_unlimited_stream_set_go

Purpose

Establishes a limited- or unlimited-length protected stream which fetches from either incremental (forward) or decremental (backward) memory addresses. The stream is protected from being replaced by any hardware detected streams.

Prototype

void __protected_stream_set (unsigned int direction, const void* addr, unsigned int stream_ID);

void _protected_unlimited_stream_set (unsigned int direction, const void* addr, unsigned int ID);

void __protected_unlimited_stream_set_go (unsigned int direction, const void* addr, unsigned int stream_ID);

Parameters

direction
An integer with a value of 1 (forward) or 3 (backward).
addr
The beginning of the cache line.
stream_ID
An integer with a value 0-7 on POWER4™ and POWER5™ processors, a value 0 to 15 on POWER6™ processors, and a value 0 to 11 on POWER7 processors.

Usage

Valid only when -qarch is set to target POWER5, POWER6, or POWER7 processors.