[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

src_err_msg_r Subroutine


Gets the System Resource Controller (SRC) error message corresponding to the specified SRC error code.


System Resource Controller (libsrc.a)


#include <spc.h>

int src_err_msg_r (srcerrno, ErrorText) 
int srcerrno;
char **ErrorText;


The src_err_msg_r subroutine returns the message corresponding to the input srcerrno value in a caller-supplied buffer. This subroutine is threadsafe and reentrant.


srcerrno Specifies the SRC error code.
ErrorText Pointer to a variable containing the address of a caller-supplied buffer where the message will be returned. If the length of the message is unknown, the maximum message length can be used when allocating the buffer. The maximum message length is SRC_BUF_MAX in /usr/include/spc.h (2048 bytes).

Return Values

Upon successful completion, the src_err_msg_r subroutine returns a value of 0. Otherwise, no error message is returned and the subroutine returns a value of -1.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The srcsbuf_r, srcsrqt_r, srcrrqs_r, srcstat_r, and srcstattxt_r subroutines.

[ Previous | Next | Contents | Glossary | Home | Search ]