21 #ifndef LIBREPORT_DUMP_DIR_H_
22 #define LIBREPORT_DUMP_DIR_H_
25 #include "libreport_types.h"
30 #include <sys/types.h>
44 int create_symlink_lockfile(
const char *filename,
const char *pid_str);
45 int create_symlink_lockfile_at(
int dir_fd,
const char *filename,
const char *pid_str);
50 int secure_openat_read(
int dir_fd,
const char *filename);
62 extern uid_t dd_g_super_user_uid;
72 extern gid_t dd_g_fs_group_gid;
79 DD_FAIL_QUIETLY_ENOENT = (1 << 0),
80 DD_FAIL_QUIETLY_EACCES = (1 << 1),
82 DD_OPEN_FOLLOW = (1 << 2),
83 DD_OPEN_READONLY = (1 << 3),
84 DD_LOAD_TEXT_RETURN_NULL_ON_FAILURE = (1 << 4),
85 DD_DONT_WAIT_FOR_LOCK = (1 << 5),
87 DD_CREATE_PARENTS = (1 << 6),
92 DD_OPEN_FD_ONLY = (1 << 7),
122 struct dump_dir *dd_opendir(
const char *dir,
int flags);
135 struct dump_dir *dd_create_skeleton(
const char *dir, uid_t uid, mode_t mode,
int flags);
136 int dd_reset_ownership(
struct dump_dir *dd);
140 struct dump_dir *dd_create(
const char *dir, uid_t uid, mode_t mode);
163 void dd_create_basic_files(
struct dump_dir *dd, uid_t uid,
const char *chroot_dir);
164 int dd_exist(
const struct dump_dir *dd,
const char *path);
165 void dd_sanitize_mode_and_owner(
struct dump_dir *dd);
173 DIR *dd_init_next_file(
struct dump_dir *dd);
182 int dd_get_next_file(
struct dump_dir *dd,
char **short_name,
char **full_name);
189 void dd_clear_next_file(
struct dump_dir *dd);
191 char *load_text_file(
const char *path,
unsigned flags);
193 char* dd_load_text_ext(
const struct dump_dir *dd,
const char *name,
unsigned flags);
194 char* dd_load_text(
const struct dump_dir *dd,
const char *name);
195 int dd_load_int32(
const struct dump_dir *dd,
const char *name, int32_t *value);
196 int dd_load_uint32(
const struct dump_dir *dd,
const char *name, uint32_t *value);
197 int dd_load_int64(
const struct dump_dir *dd,
const char *name, int64_t *value);
198 int dd_load_uint64(
const struct dump_dir *dd,
const char *name, uint64_t *value);
199 void dd_save_text(
struct dump_dir *dd,
const char *name,
const char *data);
200 void dd_save_binary(
struct dump_dir *dd,
const char *name,
const char *data,
unsigned size);
201 int dd_copy_file(
struct dump_dir *dd,
const char *name,
const char *source_path);
202 int dd_copy_file_unpack(
struct dump_dir *dd,
const char *name,
const char *source_path);
215 off_t dd_copy_fd(
struct dump_dir *dd,
const char *name,
int fd,
int copy_flags, off_t maxsize);
225 int dd_item_stat(
struct dump_dir *dd,
const char *name,
struct stat *statbuf);
231 long dd_get_item_size(
struct dump_dir *dd,
const char *name);
238 int dd_get_items_count(
struct dump_dir *dd);
244 int dd_delete_item(
struct dump_dir *dd,
const char *name);
247 int dd_rename(
struct dump_dir *dd,
const char *new_path);
256 int dd_chown(
struct dump_dir *dd, uid_t new_uid);
263 off_t dd_compute_size(
struct dump_dir *dd,
int flags);
270 int dd_set_owner(
struct dump_dir *dd, uid_t owner);
277 int dd_set_no_owner(
struct dump_dir *dd);
284 uid_t dd_get_owner(
struct dump_dir *dd);
306 #define add_reported_to_data libreport_add_reported_to_data
307 int add_reported_to_data(
char **reported_to,
const char *line);
321 #define add_reported_to_entry_data libreport_add_reported_to_entry_data
322 int add_reported_to_entry_data(
char **reported_to,
struct report_result *result);
328 #define add_reported_to libreport_add_reported_to
329 void add_reported_to(
struct dump_dir *dd,
const char *line);
335 #define add_reported_to_entry libreport_add_reported_to_entry
338 #define free_report_result libreport_free_report_result
340 #define find_in_reported_to_data libreport_find_in_reported_to_data
341 report_result_t *find_in_reported_to_data(
const char *reported_to,
const char *report_label);
342 #define find_in_reported_to libreport_find_in_reported_to
344 #define read_entire_reported_to_data libreport_read_entire_reported_to_data
345 GList *read_entire_reported_to_data(
const char* reported_to);
346 #define read_entire_reported_to libreport_read_entire_reported_to
347 GList *read_entire_reported_to(
struct dump_dir *dd);
350 void delete_dump_dir(
const char *dirname);
358 int dump_dir_accessible_by_uid(
const char *dirname, uid_t uid);
363 int dd_accessible_by_uid(
struct dump_dir *dd, uid_t uid);
366 DD_STAT_ACCESSIBLE_BY_UID = 1,
367 DD_STAT_OWNED_BY_UID = DD_STAT_ACCESSIBLE_BY_UID << 1,
368 DD_STAT_NO_OWNER = DD_STAT_OWNED_BY_UID << 1,
378 int dump_dir_stat_for_uid(
const char *dirname, uid_t uid);
383 int dd_stat_for_uid(
struct dump_dir *dd, uid_t uid);
391 int dd_mark_as_notreportable(
struct dump_dir *dd,
const char *reason);
393 typedef int (*save_data_call_back)(
struct dump_dir *,
void *args);
402 struct dump_dir *create_dump_dir(
const char *base_dir_name,
const char *type,
403 uid_t uid, save_data_call_back save_data,
void *args);
425 int dd_create_archive(
struct dump_dir *dd,
const char *archive_name,
426 const_string_vector_const_ptr_t exclude_elements,
int flags);