1 /* SPDX-License-Identifier: LGPL-2.1+ */
5 This file is part of systemd.
7 Copyright 2010 Lennart Poettering
14 #include <sys/types.h>
17 #include "time-util.h"
20 WRITE_STRING_FILE_CREATE
= 1 << 0,
21 WRITE_STRING_FILE_ATOMIC
= 1 << 1,
22 WRITE_STRING_FILE_AVOID_NEWLINE
= 1 << 2,
23 WRITE_STRING_FILE_VERIFY_ON_FAILURE
= 1 << 3,
24 WRITE_STRING_FILE_SYNC
= 1 << 4,
25 WRITE_STRING_FILE_DISABLE_BUFFER
= 1 << 5,
27 /* And before you wonder, why write_string_file_atomic_label_ts() is a separate function instead of just one
28 more flag here: it's about linking: we don't want to pull -lselinux into all users of write_string_file()
31 } WriteStringFileFlags
;
33 int write_string_stream_ts(FILE *f
, const char *line
, WriteStringFileFlags flags
, struct timespec
*ts
);
34 static inline int write_string_stream(FILE *f
, const char *line
, WriteStringFileFlags flags
) {
35 return write_string_stream_ts(f
, line
, flags
, NULL
);
37 int write_string_file_ts(const char *fn
, const char *line
, WriteStringFileFlags flags
, struct timespec
*ts
);
38 static inline int write_string_file(const char *fn
, const char *line
, WriteStringFileFlags flags
) {
39 return write_string_file_ts(fn
, line
, flags
, NULL
);
42 int write_string_filef(const char *fn
, WriteStringFileFlags flags
, const char *format
, ...) _printf_(3, 4);
44 int read_one_line_file(const char *fn
, char **line
);
45 int read_full_file(const char *fn
, char **contents
, size_t *size
);
46 int read_full_stream(FILE *f
, char **contents
, size_t *size
);
48 int verify_file(const char *fn
, const char *blob
, bool accept_extra_nl
);
50 int parse_env_filev(FILE *f
, const char *fname
, const char *separator
, va_list ap
);
51 int parse_env_file(FILE *f
, const char *fname
, const char *separator
, ...) _sentinel_
;
52 int load_env_file(FILE *f
, const char *fname
, const char *separator
, char ***l
);
53 int load_env_file_pairs(FILE *f
, const char *fname
, const char *separator
, char ***l
);
55 int merge_env_file(char ***env
, FILE *f
, const char *fname
);
57 int write_env_file(const char *fname
, char **l
);
59 int executable_is_script(const char *path
, char **interpreter
);
61 int get_proc_field(const char *filename
, const char *pattern
, const char *terminator
, char **field
);
63 DIR *xopendirat(int dirfd
, const char *name
, int flags
);
65 int search_and_fopen(const char *path
, const char *mode
, const char *root
, const char **search
, FILE **_f
);
66 int search_and_fopen_nulstr(const char *path
, const char *mode
, const char *root
, const char *search
, FILE **_f
);
68 #define FOREACH_LINE(line, f, on_error) \
70 if (!fgets(line, sizeof(line), f)) { \
77 int fflush_and_check(FILE *f
);
78 int fflush_sync_and_check(FILE *f
);
80 int fopen_temporary(const char *path
, FILE **_f
, char **_temp_path
);
81 int mkostemp_safe(char *pattern
);
83 int tempfn_xxxxxx(const char *p
, const char *extra
, char **ret
);
84 int tempfn_random(const char *p
, const char *extra
, char **ret
);
85 int tempfn_random_child(const char *p
, const char *extra
, char **ret
);
87 int write_timestamp_file_atomic(const char *fn
, usec_t n
);
88 int read_timestamp_file(const char *fn
, usec_t
*ret
);
90 int fputs_with_space(FILE *f
, const char *s
, const char *separator
, bool *space
);
92 int open_tmpfile_unlinkable(const char *directory
, int flags
);
93 int open_tmpfile_linkable(const char *target
, int flags
, char **ret_path
);
94 int open_serialization_fd(const char *ident
);
96 int link_tmpfile(int fd
, const char *path
, const char *target
);
98 int read_nul_string(FILE *f
, char **ret
);
100 int mkdtemp_malloc(const char *template, char **ret
);
102 int read_line(FILE *f
, size_t limit
, char **ret
);