NAME

ipcerrmsg(), ipcerrstr() − provide text describing a NetIPC error number

SYNOPSIS

#include<sys/ns_ipc.h>

char ∗ipcerrstr(int error);

void ipcerrmsg(

int error,
char ∗buffer,
int ∗len,
int ∗result);

DESCRIPTION

ipcerrstr() Takes as input a Net IPC error number and returns a pointer to a NULL -terminated string describing the error.  If the error is unknown, NULL is returned. 

ipcerrmsg() Copies an error message for a NetIPC error into a supplied buffer.  It copies len−1 bytes into the buffer to ensure that the result is null-terminated. 

ipcerrmsg() parameters are as follows:

error (input parameter) The Net IPC error number to be described. 

buffer (input parameter) A data buffer into which the description is to be copied. 

len (input/output parameter) A pointer to the length of the buffer.  On output it contains the length of the description. 

result (output parameter) The result code returned.  Refer to ERRORS below for more information. 

RETURN VALUE

ipcerrstr() returns NULL if the error number is unknown. 

ipcerrmsg() returns results in the result parameter. 

ERRORS

ipcerrmsg() sets result to the value indicated when any of these conditions are encountered:

[NSR_NO_ERROR] The call was successful. 

[NSR_ERRNUM] An unknown error number was passed to ipcerrmsg. 

AUTHOR

ipcerrmsg() was developed by HP. 

SEE ALSO

ipcconnect(2), ipccontrol(2), ipccreate(2), ipcdest(2), ipcgetnodename(2), ipclookup(2), ipcname(2), ipcnamerase(2), ipcrecv(2), ipcrecvcn(2), ipcselect(2), ipcsend(2), ipcsetnodename(2), ipcshutdown(2), addopt(3N), initopt(3N), optoverhead(3N), readopt(3N). 

Hewlett-Packard Company  —  HP-UX Release 9.10: April 1995