kwpar_err Kernel Service

Purpose

Logs an error message for a given Workload Partition.

Syntax

int kwpar_err(kcid,cat_file_name,msg_set_no,msg_no,default_fmt_msg)           
cid_t kcid;
char* cat_file_name;
unsigned int msg_set_no;
unsigned int msg_no;
char* default_fmt_msg;

Description

The kwpar_err interface provides a mechanism to log error messages for a given WPAR from a kernel routine. Each WPAR can hold up to 1 KB of error messages. If there is enough space to log the new message, the command logs the message; otherwise, it fails. The kwpar_err routine is pinned and as such can be called from the interrupt handlers as well.

Parameter

Item	Description
kcid	Specified the cid of the WPAR.
cat_file_name	Specifies the catalog file name to be used for translation.
msg_set_no	Specifies the message set number of the error message in the catalog file.
msg_no	Specifies the message number of the error message.
default_fmt_msg	Specifies the default message string. Follows the same syntax as the printf subroutine Format parameter. Floating point is not supported.
…	Specifies the arguments to the message if any.

Return values

Item	Description
0	Success
-1	Failure

Error codes

Item	Description
ENOMEM	Not enough memory
EINVAL	Invalid parameter

Example

To log an error message into WPAR with cid 4, enter

kwpar_err(4, “wparerrs.cat”,1,10,”%s : command failed”, “mycommand”);
…