/usr/include/lttng/save.h is in liblttng-ctl-dev 2.9.3-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 | /*
* Copyright (C) 2013 - Jérémie Galarneau <jeremie.galarneau@efficios.com>
*
* This library is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License, version 2.1 only,
* as published by the Free Software Foundation.
*
* This library is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
* for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with this library; if not, write to the Free Software Foundation,
* Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef LTTNG_SAVE_H
#define LTTNG_SAVE_H
#ifdef __cplusplus
extern "C" {
#endif
/*
* The lttng_save_session_attr object is opaque to the user. Use the helper
* functions below to use them.
*/
struct lttng_save_session_attr;
/*
* Return a newly allocated save session attribute object or NULL on error.
*/
struct lttng_save_session_attr *lttng_save_session_attr_create(void);
/*
* Free a given save session attribute object.
*/
void lttng_save_session_attr_destroy(struct lttng_save_session_attr *output);
/*
* Save session attribute getter family functions.
*/
/* Return session name. NULL indicated all sessions must be saved. */
const char *lttng_save_session_attr_get_session_name(
struct lttng_save_session_attr *attr);
/*
* Return destination URL. A NULL value indicates the default session
* configuration location. The URL format used is documented in lttng(1).
* NULL indicates that the default session configuration path is used.
*/
const char *lttng_save_session_attr_get_output_url(
struct lttng_save_session_attr *attr);
/*
* Return the configuration overwrite attribute. This attribute indicates
* whether or not existing configuration files must be overwritten.
*/
int lttng_save_session_attr_get_overwrite(
struct lttng_save_session_attr *attr);
/*
* Return the omit name configuration attribute. This attribute indicates
* whether or not the saved sessions' names should be omitted.
*/
int lttng_save_session_attr_get_omit_name(
struct lttng_save_session_attr *attr);
/*
* Return the omit output configuration attribute. This attribute indicates
* whether or not the saved sessions' output configuration should be omitted.
*/
int lttng_save_session_attr_get_omit_output(
struct lttng_save_session_attr *attr);
/*
* Save session attribute setter family functions.
*
* For every set* call, 0 is returned on success or else -LTTNG_ERR_INVALID is
* returned indicating that at least one given parameter is invalid.
*/
/*
* Set the name of the session to save. A NULL name means all sessions
* known to the session daemon will be saved.
*/
int lttng_save_session_attr_set_session_name(
struct lttng_save_session_attr *attr, const char *session_name);
/*
* Set the URL of the session configuration to save. A NULL value indicates the
* use of the default location being the session one. The URL's format is is
* documented in lttng(1).
*/
int lttng_save_session_attr_set_output_url(
struct lttng_save_session_attr *attr, const char *url);
/*
* Set the overwrite attribute. If set to true, files of the same name as the
* current session configuration URL will be overwritten.
*/
int lttng_save_session_attr_set_overwrite(
struct lttng_save_session_attr *attr, int overwrite);
/*
* Set the omit name attribute. If set to true, the sessions' names are omitted
* from the resulting session configuration file.
*/
int lttng_save_session_attr_set_omit_name(
struct lttng_save_session_attr *attr, int omit_name);
/*
* Set the omit output attribute. If set to true, the sessions' output
* configurations are omitted from the resulting session configuration file.
*/
int lttng_save_session_attr_set_omit_output(
struct lttng_save_session_attr *attr, int omit_output);
/*
* Save session configuration(s).
*
* The lttng_save_session_attr object must not be NULL. No ownership of the
* object is kept by the function; it must be released by the caller.
*
* Returns 0 on success or a negative LTTNG_ERR value on error.
*/
int lttng_save_session(struct lttng_save_session_attr *attr);
#ifdef __cplusplus
}
#endif
#endif /* LTTNG_SAVE_H */
|