6 * Copyright (C) 2010-2012 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Lesser General Public
10 * License as published by the Free Software Foundation; only
11 * version 2.1 of the License.
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 * Mimic system calls for:
24 * - session creation, returns an object descriptor or failure.
25 * - channel creation, returns an object descriptor or failure.
26 * - Operates on a session object descriptor
27 * - Takes all channel options as parameters.
28 * - stream get, returns an object descriptor or failure.
29 * - Operates on a channel object descriptor.
30 * - stream notifier get, returns an object descriptor or failure.
31 * - Operates on a channel object descriptor.
32 * - event creation, returns an object descriptor or failure.
33 * - Operates on a channel object descriptor
34 * - Takes an event name as parameter
35 * - Takes an instrumentation source as parameter
36 * - e.g. tracepoints, dynamic_probes...
37 * - Takes instrumentation source specific arguments.
41 #include <lttng/ust-abi.h>
42 #include <lttng/ust-error.h>
43 #include <urcu/compiler.h>
44 #include <urcu/list.h>
45 #include <lttng/ust-events.h>
46 #include <lttng/ust-version.h>
47 #include <lttng/tracepoint.h>
49 #include "tracepoint-internal.h"
50 #include <usterr-signal-safe.h>
52 #include "lttng-tracer.h"
53 #include "../libringbuffer/shm.h"
54 #include "../libringbuffer/frontend_types.h"
56 #define OBJ_NAME_LEN 16
58 static int lttng_ust_abi_close_in_progress
;
61 int lttng_abi_tracepoint_list(void *owner
);
63 int lttng_abi_tracepoint_field_list(void *owner
);
66 * Object descriptor table. Should be protected from concurrent access
70 struct lttng_ust_obj
{
74 const struct lttng_ust_objd_ops
*ops
;
76 int owner_ref
; /* has ref from owner */
78 char name
[OBJ_NAME_LEN
];
80 int freelist_next
; /* offset freelist. end is -1. */
84 struct lttng_ust_objd_table
{
85 struct lttng_ust_obj
*array
;
86 unsigned int len
, allocated_len
;
87 int freelist_head
; /* offset freelist head. end is -1 */
90 static struct lttng_ust_objd_table objd_table
= {
95 int objd_alloc(void *private_data
, const struct lttng_ust_objd_ops
*ops
,
96 void *owner
, const char *name
)
98 struct lttng_ust_obj
*obj
;
100 if (objd_table
.freelist_head
!= -1) {
101 obj
= &objd_table
.array
[objd_table
.freelist_head
];
102 objd_table
.freelist_head
= obj
->u
.freelist_next
;
106 if (objd_table
.len
>= objd_table
.allocated_len
) {
107 unsigned int new_allocated_len
, old_allocated_len
;
108 struct lttng_ust_obj
*new_table
, *old_table
;
110 old_allocated_len
= objd_table
.allocated_len
;
111 old_table
= objd_table
.array
;
112 if (!old_allocated_len
)
113 new_allocated_len
= 1;
115 new_allocated_len
= old_allocated_len
<< 1;
116 new_table
= zmalloc(sizeof(struct lttng_ust_obj
) * new_allocated_len
);
119 memcpy(new_table
, old_table
,
120 sizeof(struct lttng_ust_obj
) * old_allocated_len
);
122 objd_table
.array
= new_table
;
123 objd_table
.allocated_len
= new_allocated_len
;
125 obj
= &objd_table
.array
[objd_table
.len
];
128 obj
->u
.s
.private_data
= private_data
;
130 obj
->u
.s
.f_count
= 2; /* count == 1 : object is allocated */
131 /* count == 2 : allocated + hold ref */
132 obj
->u
.s
.owner_ref
= 1; /* One owner reference */
133 obj
->u
.s
.owner
= owner
;
134 strncpy(obj
->u
.s
.name
, name
, OBJ_NAME_LEN
);
135 obj
->u
.s
.name
[OBJ_NAME_LEN
- 1] = '\0';
136 return obj
- objd_table
.array
;
140 struct lttng_ust_obj
*_objd_get(int id
)
142 if (id
>= objd_table
.len
)
144 if (!objd_table
.array
[id
].u
.s
.f_count
)
146 return &objd_table
.array
[id
];
150 void *objd_private(int id
)
152 struct lttng_ust_obj
*obj
= _objd_get(id
);
154 return obj
->u
.s
.private_data
;
158 void objd_set_private(int id
, void *private_data
)
160 struct lttng_ust_obj
*obj
= _objd_get(id
);
162 obj
->u
.s
.private_data
= private_data
;
165 const struct lttng_ust_objd_ops
*objd_ops(int id
)
167 struct lttng_ust_obj
*obj
= _objd_get(id
);
175 void objd_free(int id
)
177 struct lttng_ust_obj
*obj
= _objd_get(id
);
180 obj
->u
.freelist_next
= objd_table
.freelist_head
;
181 objd_table
.freelist_head
= obj
- objd_table
.array
;
182 assert(obj
->u
.s
.f_count
== 1);
183 obj
->u
.s
.f_count
= 0; /* deallocated */
187 void objd_ref(int id
)
189 struct lttng_ust_obj
*obj
= _objd_get(id
);
194 int lttng_ust_objd_unref(int id
, int is_owner
)
196 struct lttng_ust_obj
*obj
= _objd_get(id
);
200 if (obj
->u
.s
.f_count
== 1) {
201 ERR("Reference counting error\n");
205 if (!obj
->u
.s
.owner_ref
) {
206 ERR("Error decrementing owner reference");
209 obj
->u
.s
.owner_ref
--;
211 if ((--obj
->u
.s
.f_count
) == 1) {
212 const struct lttng_ust_objd_ops
*ops
= objd_ops(id
);
222 void objd_table_destroy(void)
226 for (i
= 0; i
< objd_table
.allocated_len
; i
++) {
227 struct lttng_ust_obj
*obj
;
232 if (!obj
->u
.s
.owner_ref
)
233 continue; /* only unref owner ref. */
234 (void) lttng_ust_objd_unref(i
, 1);
236 free(objd_table
.array
);
237 objd_table
.array
= NULL
;
239 objd_table
.allocated_len
= 0;
240 objd_table
.freelist_head
= -1;
243 const char *lttng_ust_obj_get_name(int id
)
245 struct lttng_ust_obj
*obj
= _objd_get(id
);
249 return obj
->u
.s
.name
;
252 void lttng_ust_objd_table_owner_cleanup(void *owner
)
256 for (i
= 0; i
< objd_table
.allocated_len
; i
++) {
257 struct lttng_ust_obj
*obj
;
263 continue; /* skip root handles */
264 if (!obj
->u
.s
.owner_ref
)
265 continue; /* only unref owner ref. */
266 if (obj
->u
.s
.owner
== owner
)
267 (void) lttng_ust_objd_unref(i
, 1);
272 * This is LTTng's own personal way to create an ABI for sessiond.
273 * We send commands over a socket.
276 static const struct lttng_ust_objd_ops lttng_ops
;
277 static const struct lttng_ust_objd_ops lttng_session_ops
;
278 static const struct lttng_ust_objd_ops lttng_channel_ops
;
279 static const struct lttng_ust_objd_ops lttng_enabler_ops
;
280 static const struct lttng_ust_objd_ops lttng_tracepoint_list_ops
;
281 static const struct lttng_ust_objd_ops lttng_tracepoint_field_list_ops
;
283 int lttng_abi_create_root_handle(void)
287 /* root handles have NULL owners */
288 root_handle
= objd_alloc(NULL
, <tng_ops
, NULL
, "root");
293 int lttng_is_channel_ready(struct lttng_channel
*lttng_chan
)
295 struct channel
*chan
;
296 unsigned int nr_streams
, exp_streams
;
298 chan
= lttng_chan
->chan
;
299 nr_streams
= channel_handle_get_nr_streams(lttng_chan
->handle
);
300 exp_streams
= chan
->nr_streams
;
301 return nr_streams
== exp_streams
;
305 int lttng_abi_create_session(void *owner
)
307 struct lttng_session
*session
;
308 int session_objd
, ret
;
310 session
= lttng_session_create();
313 session_objd
= objd_alloc(session
, <tng_session_ops
, owner
, "session");
314 if (session_objd
< 0) {
318 session
->objd
= session_objd
;
319 session
->owner
= owner
;
323 lttng_session_destroy(session
);
328 long lttng_abi_tracer_version(int objd
,
329 struct lttng_ust_tracer_version
*v
)
331 v
->major
= LTTNG_UST_MAJOR_VERSION
;
332 v
->minor
= LTTNG_UST_MINOR_VERSION
;
333 v
->patchlevel
= LTTNG_UST_PATCHLEVEL_VERSION
;
338 long lttng_abi_add_context(int objd
,
339 struct lttng_ust_context
*context_param
,
340 union ust_args
*uargs
,
341 struct lttng_ctx
**ctx
, struct lttng_session
*session
)
343 return lttng_attach_context(context_param
, uargs
, ctx
, session
);
347 * lttng_cmd - lttng control through socket commands
349 * @objd: the object descriptor
352 * @uargs: UST arguments (internal)
355 * This descriptor implements lttng commands:
357 * Returns a LTTng trace session object descriptor
358 * LTTNG_UST_TRACER_VERSION
359 * Returns the LTTng kernel tracer version
360 * LTTNG_UST_TRACEPOINT_LIST
361 * Returns a file descriptor listing available tracepoints
362 * LTTNG_UST_TRACEPOINT_FIELD_LIST
363 * Returns a file descriptor listing available tracepoint fields
364 * LTTNG_UST_WAIT_QUIESCENT
365 * Returns after all previously running probes have completed
367 * The returned session will be deleted when its file descriptor is closed.
370 long lttng_cmd(int objd
, unsigned int cmd
, unsigned long arg
,
371 union ust_args
*uargs
, void *owner
)
374 case LTTNG_UST_SESSION
:
375 return lttng_abi_create_session(owner
);
376 case LTTNG_UST_TRACER_VERSION
:
377 return lttng_abi_tracer_version(objd
,
378 (struct lttng_ust_tracer_version
*) arg
);
379 case LTTNG_UST_TRACEPOINT_LIST
:
380 return lttng_abi_tracepoint_list(owner
);
381 case LTTNG_UST_TRACEPOINT_FIELD_LIST
:
382 return lttng_abi_tracepoint_field_list(owner
);
383 case LTTNG_UST_WAIT_QUIESCENT
:
391 static const struct lttng_ust_objd_ops lttng_ops
= {
395 int lttng_abi_map_channel(int session_objd
,
396 struct lttng_ust_channel
*ust_chan
,
397 union ust_args
*uargs
,
400 struct lttng_session
*session
= objd_private(session_objd
);
401 const char *transport_name
;
402 const struct lttng_transport
*transport
;
403 const char *chan_name
;
405 struct lttng_ust_shm_handle
*channel_handle
;
406 struct lttng_channel
*lttng_chan
;
407 struct channel
*chan
;
408 struct lttng_ust_lib_ring_buffer_config
*config
;
413 enum lttng_ust_chan_type type
;
415 chan_data
= uargs
->channel
.chan_data
;
416 wakeup_fd
= uargs
->channel
.wakeup_fd
;
418 type
= ust_chan
->type
;
421 case LTTNG_UST_CHAN_PER_CPU
:
428 if (session
->been_active
) {
430 goto active
; /* Refuse to add channel to active session */
433 channel_handle
= channel_handle_create(chan_data
, len
, wakeup_fd
);
434 if (!channel_handle
) {
439 chan
= shmp(channel_handle
, channel_handle
->chan
);
441 chan
->handle
= channel_handle
;
442 config
= &chan
->backend
.config
;
443 lttng_chan
= channel_get_private(chan
);
449 /* Lookup transport name */
451 case LTTNG_UST_CHAN_PER_CPU
:
452 if (config
->output
== RING_BUFFER_MMAP
) {
453 if (config
->mode
== RING_BUFFER_OVERWRITE
) {
454 if (config
->wakeup
== RING_BUFFER_WAKEUP_BY_WRITER
) {
455 transport_name
= "relay-overwrite-mmap";
457 transport_name
= "relay-overwrite-rt-mmap";
460 if (config
->wakeup
== RING_BUFFER_WAKEUP_BY_WRITER
) {
461 transport_name
= "relay-discard-mmap";
463 transport_name
= "relay-discard-rt-mmap";
470 chan_name
= "channel";
476 transport
= lttng_transport_find(transport_name
);
478 DBG("LTTng transport %s not found\n",
484 chan_objd
= objd_alloc(NULL
, <tng_channel_ops
, owner
, chan_name
);
490 /* Initialize our lttng chan */
491 lttng_chan
->chan
= chan
;
492 lttng_chan
->tstate
= 1;
493 lttng_chan
->enabled
= 1;
494 lttng_chan
->ctx
= NULL
;
495 lttng_chan
->session
= session
;
496 lttng_chan
->ops
= &transport
->ops
;
497 memcpy(<tng_chan
->chan
->backend
.config
,
498 transport
->client_config
,
499 sizeof(lttng_chan
->chan
->backend
.config
));
500 cds_list_add(<tng_chan
->node
, &session
->chan_head
);
501 lttng_chan
->header_type
= 0;
502 lttng_chan
->handle
= channel_handle
;
503 lttng_chan
->type
= type
;
506 * We tolerate no failure path after channel creation. It will stay
507 * invariant for the rest of the session.
509 objd_set_private(chan_objd
, lttng_chan
);
510 lttng_chan
->objd
= chan_objd
;
511 /* The channel created holds a reference on the session */
512 objd_ref(session_objd
);
515 /* error path after channel was created */
519 channel_destroy(chan
, channel_handle
, 0);
523 * error path before channel creation (owning chan_data and
532 lttng_ust_lock_fd_tracker();
533 close_ret
= close(wakeup_fd
);
534 lttng_ust_unlock_fd_tracker();
544 * lttng_session_cmd - lttng session object command
549 * @uargs: UST arguments (internal)
552 * This descriptor implements lttng commands:
554 * Returns a LTTng channel object descriptor
556 * Enables tracing for a session (weak enable)
558 * Disables tracing for a session (strong disable)
560 * The returned channel will be deleted when its file descriptor is closed.
563 long lttng_session_cmd(int objd
, unsigned int cmd
, unsigned long arg
,
564 union ust_args
*uargs
, void *owner
)
566 struct lttng_session
*session
= objd_private(objd
);
569 case LTTNG_UST_CHANNEL
:
570 return lttng_abi_map_channel(objd
,
571 (struct lttng_ust_channel
*) arg
,
573 case LTTNG_UST_SESSION_START
:
574 case LTTNG_UST_ENABLE
:
575 return lttng_session_enable(session
);
576 case LTTNG_UST_SESSION_STOP
:
577 case LTTNG_UST_DISABLE
:
578 return lttng_session_disable(session
);
579 case LTTNG_UST_SESSION_STATEDUMP
:
580 return lttng_session_statedump(session
);
587 * Called when the last file reference is dropped.
589 * Big fat note: channels and events are invariant for the whole session after
590 * their creation. So this session destruction also destroys all channel and
591 * event structures specific to this session (they are not destroyed when their
592 * individual file is released).
595 int lttng_release_session(int objd
)
597 struct lttng_session
*session
= objd_private(objd
);
600 lttng_session_destroy(session
);
607 static const struct lttng_ust_objd_ops lttng_session_ops
= {
608 .release
= lttng_release_session
,
609 .cmd
= lttng_session_cmd
,
613 long lttng_tracepoint_list_cmd(int objd
, unsigned int cmd
, unsigned long arg
,
614 union ust_args
*uargs
, void *owner
)
616 struct lttng_ust_tracepoint_list
*list
= objd_private(objd
);
617 struct lttng_ust_tracepoint_iter
*tp
=
618 (struct lttng_ust_tracepoint_iter
*) arg
;
619 struct lttng_ust_tracepoint_iter
*iter
;
622 case LTTNG_UST_TRACEPOINT_LIST_GET
:
624 iter
= lttng_ust_tracepoint_list_get_iter_next(list
);
626 return -LTTNG_UST_ERR_NOENT
;
627 memcpy(tp
, iter
, sizeof(*tp
));
636 int lttng_abi_tracepoint_list(void *owner
)
639 struct lttng_ust_tracepoint_list
*list
;
641 list_objd
= objd_alloc(NULL
, <tng_tracepoint_list_ops
, owner
, "tp_list");
646 list
= zmalloc(sizeof(*list
));
651 objd_set_private(list_objd
, list
);
653 /* populate list by walking on all registered probes. */
654 ret
= lttng_probes_get_event_list(list
);
666 err
= lttng_ust_objd_unref(list_objd
, 1);
674 int lttng_release_tracepoint_list(int objd
)
676 struct lttng_ust_tracepoint_list
*list
= objd_private(objd
);
679 lttng_probes_prune_event_list(list
);
687 static const struct lttng_ust_objd_ops lttng_tracepoint_list_ops
= {
688 .release
= lttng_release_tracepoint_list
,
689 .cmd
= lttng_tracepoint_list_cmd
,
693 long lttng_tracepoint_field_list_cmd(int objd
, unsigned int cmd
,
694 unsigned long arg
, union ust_args
*uargs
, void *owner
)
696 struct lttng_ust_field_list
*list
= objd_private(objd
);
697 struct lttng_ust_field_iter
*tp
= &uargs
->field_list
.entry
;
698 struct lttng_ust_field_iter
*iter
;
701 case LTTNG_UST_TRACEPOINT_FIELD_LIST_GET
:
703 iter
= lttng_ust_field_list_get_iter_next(list
);
705 return -LTTNG_UST_ERR_NOENT
;
706 memcpy(tp
, iter
, sizeof(*tp
));
715 int lttng_abi_tracepoint_field_list(void *owner
)
718 struct lttng_ust_field_list
*list
;
720 list_objd
= objd_alloc(NULL
, <tng_tracepoint_field_list_ops
, owner
,
726 list
= zmalloc(sizeof(*list
));
731 objd_set_private(list_objd
, list
);
733 /* populate list by walking on all registered probes. */
734 ret
= lttng_probes_get_field_list(list
);
746 err
= lttng_ust_objd_unref(list_objd
, 1);
754 int lttng_release_tracepoint_field_list(int objd
)
756 struct lttng_ust_field_list
*list
= objd_private(objd
);
759 lttng_probes_prune_field_list(list
);
767 static const struct lttng_ust_objd_ops lttng_tracepoint_field_list_ops
= {
768 .release
= lttng_release_tracepoint_field_list
,
769 .cmd
= lttng_tracepoint_field_list_cmd
,
773 int lttng_abi_map_stream(int channel_objd
, struct lttng_ust_stream
*info
,
774 union ust_args
*uargs
, void *owner
)
776 struct lttng_channel
*channel
= objd_private(channel_objd
);
779 ret
= channel_handle_add_stream(channel
->handle
,
780 uargs
->stream
.shm_fd
, uargs
->stream
.wakeup_fd
,
781 info
->stream_nr
, info
->len
);
783 goto error_add_stream
;
792 int lttng_abi_create_enabler(int channel_objd
,
793 struct lttng_ust_event
*event_param
,
795 enum lttng_enabler_type type
)
797 struct lttng_channel
*channel
= objd_private(channel_objd
);
798 struct lttng_enabler
*enabler
;
801 event_param
->name
[LTTNG_UST_SYM_NAME_LEN
- 1] = '\0';
802 event_objd
= objd_alloc(NULL
, <tng_enabler_ops
, owner
, "enabler");
803 if (event_objd
< 0) {
808 * We tolerate no failure path after event creation. It will stay
809 * invariant for the rest of the session.
811 enabler
= lttng_enabler_create(type
, event_param
, channel
);
816 objd_set_private(event_objd
, enabler
);
817 /* The event holds a reference on the channel */
818 objd_ref(channel_objd
);
825 err
= lttng_ust_objd_unref(event_objd
, 1);
833 * lttng_channel_cmd - lttng control through object descriptors
835 * @objd: the object descriptor
838 * @uargs: UST arguments (internal)
841 * This object descriptor implements lttng commands:
843 * Returns an event stream object descriptor or failure.
844 * (typically, one event stream records events from one CPU)
846 * Returns an event object descriptor or failure.
848 * Prepend a context field to each event in the channel
850 * Enable recording for events in this channel (weak enable)
852 * Disable recording for events in this channel (strong disable)
854 * Channel and event file descriptors also hold a reference on the session.
857 long lttng_channel_cmd(int objd
, unsigned int cmd
, unsigned long arg
,
858 union ust_args
*uargs
, void *owner
)
860 struct lttng_channel
*channel
= objd_private(objd
);
862 if (cmd
!= LTTNG_UST_STREAM
) {
864 * Check if channel received all streams.
866 if (!lttng_is_channel_ready(channel
))
871 case LTTNG_UST_STREAM
:
873 struct lttng_ust_stream
*stream
;
875 stream
= (struct lttng_ust_stream
*) arg
;
876 /* stream used as output */
877 return lttng_abi_map_stream(objd
, stream
, uargs
, owner
);
879 case LTTNG_UST_EVENT
:
881 struct lttng_ust_event
*event_param
=
882 (struct lttng_ust_event
*) arg
;
883 if (event_param
->name
[strlen(event_param
->name
) - 1] == '*') {
884 /* If ends with wildcard, create wildcard. */
885 return lttng_abi_create_enabler(objd
, event_param
,
886 owner
, LTTNG_ENABLER_WILDCARD
);
888 return lttng_abi_create_enabler(objd
, event_param
,
889 owner
, LTTNG_ENABLER_EVENT
);
892 case LTTNG_UST_CONTEXT
:
893 return lttng_abi_add_context(objd
,
894 (struct lttng_ust_context
*) arg
, uargs
,
895 &channel
->ctx
, channel
->session
);
896 case LTTNG_UST_ENABLE
:
897 return lttng_channel_enable(channel
);
898 case LTTNG_UST_DISABLE
:
899 return lttng_channel_disable(channel
);
900 case LTTNG_UST_FLUSH_BUFFER
:
901 return channel
->ops
->flush_buffer(channel
->chan
, channel
->handle
);
908 int lttng_channel_release(int objd
)
910 struct lttng_channel
*channel
= objd_private(objd
);
913 return lttng_ust_objd_unref(channel
->session
->objd
, 0);
917 static const struct lttng_ust_objd_ops lttng_channel_ops
= {
918 .release
= lttng_channel_release
,
919 .cmd
= lttng_channel_cmd
,
923 * lttng_enabler_cmd - lttng control through object descriptors
925 * @objd: the object descriptor
928 * @uargs: UST arguments (internal)
931 * This object descriptor implements lttng commands:
933 * Prepend a context field to each record of events of this
936 * Enable recording for this enabler
938 * Disable recording for this enabler
940 * Attach a filter to an enabler.
941 * LTTNG_UST_EXCLUSION
942 * Attach exclusions to an enabler.
945 long lttng_enabler_cmd(int objd
, unsigned int cmd
, unsigned long arg
,
946 union ust_args
*uargs
, void *owner
)
948 struct lttng_enabler
*enabler
= objd_private(objd
);
951 case LTTNG_UST_CONTEXT
:
952 return lttng_enabler_attach_context(enabler
,
953 (struct lttng_ust_context
*) arg
);
954 case LTTNG_UST_ENABLE
:
955 return lttng_enabler_enable(enabler
);
956 case LTTNG_UST_DISABLE
:
957 return lttng_enabler_disable(enabler
);
958 case LTTNG_UST_FILTER
:
962 ret
= lttng_enabler_attach_bytecode(enabler
,
963 (struct lttng_ust_filter_bytecode_node
*) arg
);
968 case LTTNG_UST_EXCLUSION
:
970 return lttng_enabler_attach_exclusion(enabler
,
971 (struct lttng_ust_excluder_node
*) arg
);
979 int lttng_enabler_release(int objd
)
981 struct lttng_enabler
*enabler
= objd_private(objd
);
984 return lttng_ust_objd_unref(enabler
->chan
->objd
, 0);
988 static const struct lttng_ust_objd_ops lttng_enabler_ops
= {
989 .release
= lttng_enabler_release
,
990 .cmd
= lttng_enabler_cmd
,
993 void lttng_ust_abi_exit(void)
995 lttng_ust_abi_close_in_progress
= 1;
997 objd_table_destroy();
999 lttng_ust_abi_close_in_progress
= 0;