ras_control Exported Kernel Service

Purpose

Controls component RAS characteristics.

Syntax

#include <sys/ras.h>

kerrno_t ras_control ( ras_block_t ras_blk, ras_cmd_t command, void * arg, long argsize);

Description

The ras_control kernel service passes a command to the callback for the component referenced by the ras_blk parameter. If the ras_blk parameter is not known, use the ras_path_control call.

Note: During the ras_control process, callbacks to the registrant of the component might be initiated for changes that the RAS infrastructure makes to the component. The registrant should be aware of this for locking purposes (for instance, the registrant should not hold any locks that the callback needs).

If the ras_blk input parameter has a value of RAS_BLOCK_NULL, the ras_control kernel service returns without errors and takes no action.

Parameters

Item	Description
ras_blk	The target control block pointer.
command	Command passed to the callback. Commands are specific to a given RAS domain, such as Component Trace.
arg	Optional argument for the command.
argsize	Size of the argument, if a buffer or structure.

Execution Environment

The calling environment of the ras_control kernel service varies by individual command. The calling environment of a particular command is documented with the command itself.

Return Values

The ras_control kernel service returns 0 for success and a non-zero error code for failure.