HPUX ipcnamerase[2]

 ipcnamerase(2)                                               ipcnamerase(2)





 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.



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






 ipcnamerase(2)                                               ipcnamerase(2)





 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            - 2 -     HP-UX Release 9.0: August 1992