[lttng-tools.git] / src / common / spawn-viewer.h

#ifndef LTTNG_SPAWN_VIEWER_H
#define LTTNG_SPAWN_VIEWER_H

/*
 * Copyright (C) 2020 Francis Deslauriers <francis.deslauriers@efficios.com>
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 */

#include <stdbool.h>

#if defined(__cplusplus)
extern "C" {
#endif

/*
 * Read the trace by `exec()ing` the provided viewer program if any. If
 * `opt_viewer` is NULL, try to read the trace with the default trace reader.
 * On success, this function doesn't return.
 * Returns -1 if the `opt_viewer` string or the default trace viewer can't be
 * `exec()`.
 *
 * This symbol was mistakenly made public before the 2.12 release. It can't
 * be removed (but it can be stubbed-out if necessary).
 */
int spawn_viewer(const char *trace_path, char *opt_viewer, bool opt_live_mode);

#if defined(__cplusplus)
}
#endif

#endif /* ifndef LTTNG_SPAWN_VIEWER_H */
Commit	Line	Data
dd392e94 FD	1	#ifndef LTTNG_SPAWN_VIEWER_H
	2	#define LTTNG_SPAWN_VIEWER_H
	3
	4	/*
	5	* Copyright (C) 2020 Francis Deslauriers <francis.deslauriers@efficios.com>
	6	*
	7	* SPDX-License-Identifier: GPL-2.0-only
	8	*
	9	*/
	10
	11	#include <stdbool.h>
	12
48a40005 SM	13	#if defined(__cplusplus)
	14	extern "C" {
	15	#endif
	16
dd392e94 FD	17	/*
	18	* Read the trace by `exec()ing` the provided viewer program if any. If
	19	* `opt_viewer` is NULL, try to read the trace with the default trace reader.
	20	* On success, this function doesn't return.
	21	* Returns -1 if the `opt_viewer` string or the default trace viewer can't be
	22	* `exec()`.
c84305ff JG	23	*
	24	* This symbol was mistakenly made public before the 2.12 release. It can't
	25	* be removed (but it can be stubbed-out if necessary).
dd392e94 FD	26	*/
	27	int spawn_viewer(const char trace_path, char opt_viewer, bool opt_live_mode);
	28
48a40005 SM	29	#if defined(__cplusplus)
	30	}
	31	#endif
	32
dd392e94	33	#endif /* ifndef LTTNG_SPAWN_VIEWER_H */