Requires Optional LAN/X.25 Software

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

The first form, ipcerrstr, takes as input a NetIPC error number and returns a pointer to a NULL terminated string describing the error.  If the error is unknown, then NULL is returned. 

The second form, 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. 

Parameters

error (input parameter) The NetIPC 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 will contain the length of the description. 

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

RETURN VALUE

ipcerrstr returns NULL if the error number is unknown.  ipcerrmsg returns results in the result parameter. 

DIAGNOSTICS

[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 8.05: June 1991