Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20652 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

dat_rsp_free(3DAT) Direct Access Transport Library Functionsdat_rsp_free(3DAT)

NAME
       dat_rsp_free - destroy an instance of the Reserved Service Point

SYNOPSIS
       cc [ flag... ] file... -ldat [ library... ]
       #include <dat/udat.h>

       DAT_RETURN
	   dat_rsp_free (
	   IN	 DAT_RSP_HANDLE	   rsp_handle
	   )

PARAMETERS
       rsp_handle      Handle for an instance of the Reserved Service Point.

DESCRIPTION
       The  dat_rsp_free()  function  destroys	a  specified  instance	of the
       Reserved Service Point.

       Any incoming Connection Requests for the Connection  Qualifier  on  the
       destroyed  Service Point was listening on are automatically rejected by
       the Provider with the return analogous  to  the	no  listening  Service
       Point.

       The  behavior  of  the Connection Requests in progress is undefined and
       left to an implementation, but it must be consistent. This  means  that
       either  a  Connection  Requested Event was generated for the Event Dis‐
       patcher associated with the Service Point, including  the  creation  of
       the  Connection Request instance, or the Connection Request is rejected
       by the Provider without any local notification.

       This operation has no effect on previously generated Connection Request
       Event and Connection Request.

       The  behavior of this operation with creation of a Service Point on the
       same Connection Qualifier at the same time is  not  defined.  Consumers
       are advised to avoid this scenario.

       For  the Reserved Service Point, the Consumer-provided Endpoint reverts
       to Consumer control. Consumers shall be aware that due to a race condi‐
       tion,  this  Reserved  Service  Point might have generated a Connection
       Request Event and passed the associated Endpoint to a Consumer in it.

       Use of the handle of the destroyed  Service  Point  in  any  consequent
       operation fails.

RETURN VALUES
       DAT_SUCCESS	       The operation was successful.

       DAT_INVALID_HANDLE      The rsp_handle parameter is invalid.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Standard: uDAPL, 1.1, 1.2	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Unsafe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       libdat(3LIB), attributes(5)

SunOS 5.10			  16 Jul 2004		    dat_rsp_free(3DAT)

Vote for polarhome