1dat_psp_free(3DAT) Direct Access Transport Library Functionsdat_psp_free(3DAT)
2
3
4

NAME

6       dat_psp_free - destroy an instance of the Public Service Point
7

SYNOPSIS

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

PARAMETERS

19       psp_handle    Handle for an instance of the Public Service Point.
20
21

DESCRIPTION

23       The dat_psp_free() function destroys a specified instance of the Public
24       Service Point.
25
26
27       Any incoming Connection Requests for the Connection  Qualifier  on  the
28       destroyed  Service  Point  it  had  been listening on are automatically
29       rejected by the Provider with the return analogous to the no  listening
30       Service 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 has been generated for the Event
36       Dispatcher 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 shall have no effect on previously generated  Connection
42       Requested  Events.  This  includes  Connection  Request  instances and,
43       potentially, Endpoint instances created by the Provider.
44
45
46       The behavior of this operation with creation of a Service Point on  the
47       same  Connection  Qualifier  at the same time is not defined. Consumers
48       are advised to avoid this scenario.
49
50
51       Use of the handle of the destroyed Public Service Point in  any  conse‐
52       quent operation fails.
53

RETURN VALUES

55       DAT_SUCCESS           The operation was successful.
56
57
58       DAT_INVALID_HANDLE    The psp_handle parameter is invalid.
59
60

ATTRIBUTES

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

SEE ALSO

76       libdat(3LIB), attributes(5)
77
78
79
80SunOS 5.11                        16 Jul 2004               dat_psp_free(3DAT)
Impressum