5 * Copyright (C) 2011 - David Goulet <david.goulet@polymtl.ca>
6 * Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License, version 2 only,
10 * as published by the Free Software Foundation.
12 * This program is distributed in the hope that it will be useful, but WITHOUT
13 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23 #include <sys/types.h>
26 #include <common/macros.h>
29 * The run-as process is launched by forking without an exec*() call. This means
30 * that any resource allocated before the run-as worker is launched should be
31 * cleaned-up after the fork(). This callback allows the user to perform this
34 * Note that the callback will _not_ be invoked if the LTTNG_DEBUG_NOCLONE
35 * environment variable is set as the clean-up is not needed (and may not be
38 * A negative return value will cause the run-as process to exit with a non-zero
41 typedef int (*post_fork_cleanup_cb
)(void *user_data
);
44 int run_as_mkdir_recursive(const char *path
, mode_t mode
, uid_t uid
, gid_t gid
);
46 int run_as_mkdirat_recursive(int dirfd
, const char *path
, mode_t mode
,
47 uid_t uid
, gid_t gid
);
49 int run_as_mkdir(const char *path
, mode_t mode
, uid_t uid
, gid_t gid
);
51 int run_as_mkdirat(int dirfd
, const char *path
, mode_t mode
,
52 uid_t uid
, gid_t gid
);
54 int run_as_open(const char *path
, int flags
, mode_t mode
, uid_t uid
, gid_t gid
);
56 int run_as_openat(int dirfd
, const char *filename
, int flags
, mode_t mode
,
57 uid_t uid
, gid_t gid
);
59 int run_as_unlink(const char *path
, uid_t uid
, gid_t gid
);
61 int run_as_unlinkat(int dirfd
, const char *filename
, uid_t uid
, gid_t gid
);
63 int run_as_rmdir(const char *path
, uid_t uid
, gid_t gid
);
65 int run_as_rmdir_recursive(const char *path
, uid_t uid
, gid_t gid
, int flags
);
67 int run_as_rmdirat(int dirfd
, const char *path
, uid_t uid
, gid_t gid
);
69 int run_as_rmdirat_recursive(int dirfd
, const char *path
, uid_t uid
, gid_t gid
, int flags
);
71 int run_as_rename(const char *old
, const char *new, uid_t uid
, gid_t gid
);
73 int run_as_renameat(int old_dirfd
, const char *old
,
74 int new_dirfd
, const char *new, uid_t uid
, gid_t gid
);
76 int run_as_extract_elf_symbol_offset(int fd
, const char* function
,
77 uid_t uid
, gid_t gid
, uint64_t *offset
);
79 int run_as_extract_sdt_probe_offsets(int fd
, const char *provider_name
,
80 const char* probe_name
, uid_t uid
, gid_t gid
,
81 uint64_t **offsets
, uint32_t *num_offset
);
83 int run_as_create_worker(const char *procname
,
84 post_fork_cleanup_cb clean_up_func
, void *clean_up_user_data
);
86 void run_as_destroy_worker(void);