klpar_get_info Kernel Service

Purpose

Retrieves the calling partition's characteristics.

Syntax

#include  <sys/dr.h>

int klpar_get_info (command, lparinfo, bufsize)
int command; 
void *lparinfo;
size_t bufsize;

Parameters

Description

The klpar_get_info kernel service retrieves LPAR and Micro-Partitioning® attributes of both low-frequency use and high-frequency use and also retrieves processor module information. Because the low-frequency attributes, as defined in the lpar_info_format1_t structure, are static in nature, a reboot is required to effect any change. The high-frequncy attributes, as defined in the lpar_info_format2_t structure, can be changed dynamically while the partition is running. The signature of this kernel service, its parameter types, and the order of the member fields in both the lpar_info_format1_t and lpar_info_format2_t structures are specific to the AIX® platform. If you requests processor module information, the kernel service provides this information as an array of proc_module_info_t structures. To obtain this information, the caller must provide a buffer of the exact length to accommodate one proc_module_info_t structure for each module type. You can obtain the module count using the NUM_PROC_MODULE_TYPES command. The module count is in the form of a uint64_t type. Processor module information is reported for the entire system. This information is available on POWER6® and later systems.

To see the complete structures of lpar_info_format1_t, lpar_info_format2_t, and proc_module_info_t, refer to the dr.h header file.

Return Values

Upon success, the klpar_get_info kernel service returns a value of 0. Upon failure, the klpar_get_info kernel service returns an error code.

Error Codes