1dat_rsp_free(3DAT) Direct Access Transport Library Functionsdat_rsp_free(3DAT)
2
3
4

NAME

6       dat_rsp_free - destroy an instance of the Reserved Service Point
7

SYNOPSIS

9       cc [ flag... ] file... -ldat [ library... ]
10       #include <dat/udat.h>
11
12       DAT_RETURN
13           dat_rsp_free (
14           IN    DAT_RSP_HANDLE    rsp_handle
15           )
16
17

PARAMETERS

19       rsp_handle    Handle for an instance of the Reserved Service Point.
20
21

DESCRIPTION

23       The  dat_rsp_free()  function  destroys  a  specified  instance  of the
24       Reserved Service Point.
25
26
27       Any incoming Connection Requests for the Connection  Qualifier  on  the
28       destroyed  Service Point was listening on are automatically rejected by
29       the Provider with the return analogous  to  the  no  listening  Service
30       Point.
31
32
33       The  behavior  of  the Connection Requests in progress is undefined and
34       left to an implementation, but it must be consistent. This  means  that
35       either  a  Connection  Requested Event was generated for the Event Dis‐
36       patcher associated with the Service Point, including  the  creation  of
37       the  Connection Request instance, or the Connection Request is rejected
38       by the Provider without any local notification.
39
40
41       This operation has no effect on previously generated Connection Request
42       Event and Connection Request.
43
44
45       The  behavior of this operation with creation of a Service Point on the
46       same Connection Qualifier at the same time is  not  defined.  Consumers
47       are advised to avoid this scenario.
48
49
50       For  the Reserved Service Point, the Consumer-provided Endpoint reverts
51       to Consumer control. Consumers shall be aware that due to a race condi‐
52       tion,  this  Reserved  Service  Point might have generated a Connection
53       Request Event and passed the associated Endpoint to a Consumer in it.
54
55
56       Use of the handle of the destroyed  Service  Point  in  any  consequent
57       operation fails.
58

RETURN VALUES

60       DAT_SUCCESS           The operation was successful.
61
62
63       DAT_INVALID_HANDLE    The rsp_handle parameter is invalid.
64
65

ATTRIBUTES

67       See attributes(5) for descriptions of the following attributes:
68
69
70
71
72       ┌─────────────────────────────┬─────────────────────────────┐
73       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
74       ├─────────────────────────────┼─────────────────────────────┤
75       │Interface Stability          │Standard: uDAPL, 1.1, 1.2    │
76       ├─────────────────────────────┼─────────────────────────────┤
77       │MT-Level                     │Unsafe                       │
78       └─────────────────────────────┴─────────────────────────────┘
79

SEE ALSO

81       libdat(3LIB), attributes(5)
82
83
84
85SunOS 5.11                        16 Jul 2004               dat_rsp_free(3DAT)
Impressum