IPCNAMERASE(2)
Series 300 and 800 Only
NAME
ipcnamerase() − deletes a name associated with a call socket or destination call socket
SYNOPSIS
#include <sys/ns_ipc.h>
void ipcnamerase (socketname,nlen,result)
ns_int_t nlen,*result;
char *socketname;
DISCUSSION
ipcnamerase can be called to remove listings from the local node’s socket registry. Only the owner of a call socket or destination call socket may remove the socket’s name from the local socket registry. A process that attempts to erase the name of a socket it does not own will receive an NSR_NO_OWNERSHIP (code 38) error.
If a call socket descriptor or destination descriptor is destroyed via ipcshutdown, or if its last owner terminates, then any listings for it that exist at the local socket registry are automatically purged.
If multiple processes have descriptors for the same socket, the first ipcnamerase call will succeed; subsequent calls will fail.
This routine can be linked into a program by giving the -lnsipc option to cc(1) or ld(1).
PARAMETERS
socketname (input parameter) The ASCII-coded name that was previously associated with a call socket descriptor or destination descriptor via ipcname. Upper and lower case characters are considered equivalent.
nlen (input parameter) The length in bytes of the specified name. Maximum length is 16 bytes.
result (output parameter) The error code returned; zero or NSR_NO_ERROR if no error. See "Diagnostics" below for more information.
RETURNS
None. Errors are returned in the result parameter.
AUTHOR
HP.
SEE ALSO
DIAGNOSITICS
[NSR_NO_ERROR] The call was successful.
[NSR_xxxx] Refer to the errors listed in the NetIPC programmer’s manual for your system.
Hewlett-Packard Company — May 11, 2021