]>
Commit | Line | Data |
---|---|---|
53e1b683 | 1 | /* SPDX-License-Identifier: LGPL-2.1+ */ |
a5c32cff HH |
2 | #pragma once |
3 | ||
0d39fa9c LP |
4 | #include <dirent.h> |
5 | #include <stdbool.h> | |
a5c32cff | 6 | #include <stddef.h> |
b4bc041b | 7 | #include <stdio.h> |
7a309a8c | 8 | #include <sys/stat.h> |
8241f785 | 9 | #include <sys/fcntl.h> |
0d39fa9c | 10 | #include <sys/types.h> |
b4bc041b | 11 | |
a5c32cff | 12 | #include "macro.h" |
33d52ab9 | 13 | #include "time-util.h" |
a5c32cff | 14 | |
fde32028 ZJS |
15 | #define LONG_LINE_MAX (1U*1024U*1024U) |
16 | ||
4c1fc3e4 | 17 | typedef enum { |
ef31828d LP |
18 | WRITE_STRING_FILE_CREATE = 1 << 0, |
19 | WRITE_STRING_FILE_ATOMIC = 1 << 1, | |
20 | WRITE_STRING_FILE_AVOID_NEWLINE = 1 << 2, | |
21 | WRITE_STRING_FILE_VERIFY_ON_FAILURE = 1 << 3, | |
22 | WRITE_STRING_FILE_SYNC = 1 << 4, | |
23 | WRITE_STRING_FILE_DISABLE_BUFFER = 1 << 5, | |
835d18ba | 24 | WRITE_STRING_FILE_NOFOLLOW = 1 << 6, |
50ccd864 | 25 | WRITE_STRING_FILE_MKDIR_0755 = 1 << 7, |
95244ceb | 26 | WRITE_STRING_FILE_MODE_0600 = 1 << 8, |
7d7a99ac LP |
27 | |
28 | /* And before you wonder, why write_string_file_atomic_label_ts() is a separate function instead of just one | |
29 | more flag here: it's about linking: we don't want to pull -lselinux into all users of write_string_file() | |
30 | and friends. */ | |
31 | ||
4c1fc3e4 DM |
32 | } WriteStringFileFlags; |
33 | ||
15f8f026 | 34 | typedef enum { |
3177b927 LP |
35 | READ_FULL_FILE_SECURE = 1 << 0, /* erase any buffers we employ internally, after use */ |
36 | READ_FULL_FILE_UNBASE64 = 1 << 1, /* base64 decode what we read */ | |
37 | READ_FULL_FILE_UNHEX = 1 << 2, /* hex decode what we read */ | |
38 | READ_FULL_FILE_WARN_WORLD_READABLE = 1 << 3, /* if regular file, log at LOG_WARNING level if access mode above 0700 */ | |
39 | READ_FULL_FILE_CONNECT_SOCKET = 1 << 4, /* if socket inode, connect to it and read off it */ | |
15f8f026 YW |
40 | } ReadFullFileFlags; |
41 | ||
fdeea3f4 | 42 | int fopen_unlocked(const char *path, const char *options, FILE **ret); |
02e23d1a | 43 | int fdopen_unlocked(int fd, const char *options, FILE **ret); |
3ebbb6cb VC |
44 | int take_fdopen_unlocked(int *fd, const char *options, FILE **ret); |
45 | FILE* take_fdopen(int *fd, const char *options); | |
f61457b0 | 46 | DIR* take_fdopendir(int *dfd); |
2fe21124 | 47 | FILE* open_memstream_unlocked(char **ptr, size_t *sizeloc); |
673a1e6f | 48 | FILE* fmemopen_unlocked(void *buf, size_t size, const char *mode); |
fdeea3f4 | 49 | |
b1837133 LP |
50 | int write_string_stream_ts(FILE *f, const char *line, WriteStringFileFlags flags, struct timespec *ts); |
51 | static inline int write_string_stream(FILE *f, const char *line, WriteStringFileFlags flags) { | |
52 | return write_string_stream_ts(f, line, flags, NULL); | |
39c38d77 ZJS |
53 | } |
54 | int write_string_file_ts(const char *fn, const char *line, WriteStringFileFlags flags, struct timespec *ts); | |
55 | static inline int write_string_file(const char *fn, const char *line, WriteStringFileFlags flags) { | |
56 | return write_string_file_ts(fn, line, flags, NULL); | |
57 | } | |
b4bc041b | 58 | |
3130fca5 LP |
59 | int write_string_filef(const char *fn, WriteStringFileFlags flags, const char *format, ...) _printf_(3, 4); |
60 | ||
15f8f026 | 61 | int read_one_line_file(const char *filename, char **line); |
8241f785 | 62 | int read_full_file_full(int dir_fd, const char *filename, ReadFullFileFlags flags, char **contents, size_t *size); |
15f8f026 | 63 | static inline int read_full_file(const char *filename, char **contents, size_t *size) { |
8241f785 | 64 | return read_full_file_full(AT_FDCWD, filename, 0, contents, size); |
15f8f026 | 65 | } |
21b40f16 | 66 | int read_full_virtual_file(const char *filename, char **ret_contents, size_t *ret_size); |
50caae7b | 67 | int read_full_stream_full(FILE *f, const char *filename, ReadFullFileFlags flags, char **contents, size_t *size); |
15f8f026 | 68 | static inline int read_full_stream(FILE *f, char **contents, size_t *size) { |
50caae7b | 69 | return read_full_stream_full(f, NULL, 0, contents, size); |
15f8f026 | 70 | } |
a5c32cff | 71 | |
eb3da901 | 72 | int verify_file(const char *fn, const char *blob, bool accept_extra_nl); |
15dee3f0 | 73 | |
68fee104 | 74 | int executable_is_script(const char *path, char **interpreter); |
69ab8088 | 75 | |
c4cd1d4d | 76 | int get_proc_field(const char *filename, const char *pattern, const char *terminator, char **field); |
0d39fa9c LP |
77 | |
78 | DIR *xopendirat(int dirfd, const char *name, int flags); | |
0a38e6b9 | 79 | int xfopenat(int dir_fd, const char *path, const char *mode, int flags, FILE **ret); |
0d39fa9c LP |
80 | |
81 | int search_and_fopen(const char *path, const char *mode, const char *root, const char **search, FILE **_f); | |
82 | int search_and_fopen_nulstr(const char *path, const char *mode, const char *root, const char *search, FILE **_f); | |
83 | ||
0d39fa9c | 84 | int fflush_and_check(FILE *f); |
0675e94a | 85 | int fflush_sync_and_check(FILE *f); |
0d39fa9c | 86 | |
33d52ab9 LP |
87 | int write_timestamp_file_atomic(const char *fn, usec_t n); |
88 | int read_timestamp_file(const char *fn, usec_t *ret); | |
d390f8ef LP |
89 | |
90 | int fputs_with_space(FILE *f, const char *s, const char *separator, bool *space); | |
03532f0a | 91 | |
41f11239 | 92 | typedef enum ReadLineFlags { |
609ae0f5 LP |
93 | READ_LINE_ONLY_NUL = 1 << 0, |
94 | READ_LINE_IS_A_TTY = 1 << 1, | |
95 | READ_LINE_NOT_A_TTY = 1 << 2, | |
41f11239 | 96 | } ReadLineFlags; |
676bcb0f | 97 | |
41f11239 LP |
98 | int read_line_full(FILE *f, size_t limit, ReadLineFlags flags, char **ret); |
99 | ||
100 | static inline int read_line(FILE *f, size_t limit, char **ret) { | |
101 | return read_line_full(f, limit, 0, ret); | |
102 | } | |
103 | ||
104 | static inline int read_nul_string(FILE *f, size_t limit, char **ret) { | |
105 | return read_line_full(f, limit, READ_LINE_ONLY_NUL, ret); | |
106 | } | |
285a9b27 LP |
107 | |
108 | int safe_fgetc(FILE *f, char *ret); | |
7a309a8c YW |
109 | |
110 | int warn_file_is_world_accessible(const char *filename, struct stat *st, const char *unit, unsigned line); | |
494735f3 | 111 | |
90c81688 | 112 | int sync_rights(int from, int to); |
494735f3 | 113 | |
2da3dc69 | 114 | int rename_and_apply_smack_floor_label(const char *temp_path, const char *dest_path); |