NAME

ipcnamerase − delete a name associated with a NetIPC call socket or destination descriptor

SYNOPSIS

#include <sys/ns_ipc.h>

void ipcnamerase(

const char *socketname,
ns_int_t nlen,
ns_int_t *result);

DESCRIPTION

ipcnamerase() can be called to remove listings from the local node’s socket registry.  Only the owner of a call socket or destination descriptor can remove the socket’s name from the local socket registry. 

If a call socket descriptor or destination descriptor is destroyed by ipcshutdown() or if its last owner terminates, 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 succeeds; subsequent calls fail. 

Parameters

socketname (input parameter) The ASCII-coded name that was previously associated with a call socket descriptor or destination descriptor via ipcname().  Uppercase and lowercase characters are treated as equivalent. 

nlen (input parameter) The length in bytes of the specified name.  Maximum length is 16 bytes. 

result (output parameter) See ERRORS below. 

RETURN VALUE

None.  Errors are returned in the result parameter. 

ERRORS

[NSR_NO_ERROR] The call was successful. 

[NSR_NLEN] The value specified in the nlen parameter is invalid. 

[NSR_NAME_NOT_FOUND] The name specified by socketname does not exist in local socket registry. 

[NSR_NO_OWNERSHIP] The caller is not the owner of the named socket. 

AUTHOR

ipcnamerase() was developed by HP. 

SEE ALSO

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

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992