src/basic/fileio.h

   1 #pragma once
   2
   3 /***
   4   This file is part of systemd.
   5
   6   Copyright 2010 Lennart Poettering
   7
   8   systemd is free software; you can redistribute it and/or modify it
   9   under the terms of the GNU Lesser General Public License as published by
  10   the Free Software Foundation; either version 2.1 of the License, or
  11   (at your option) any later version.
  12
  13   systemd is distributed in the hope that it will be useful, but
  14   WITHOUT ANY WARRANTY; without even the implied warranty of
  15   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  16   Lesser General Public License for more details.
  17
  18   You should have received a copy of the GNU Lesser General Public License
  19   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  20 ***/
  21
  22 #include <dirent.h>
  23 #include <stdbool.h>
  24 #include <stddef.h>
  25 #include <stdio.h>
  26 #include <sys/types.h>
  27
  28 #include "macro.h"
  29 #include "time-util.h"
  30
  31 typedef enum {
  32         WRITE_STRING_FILE_CREATE            = 1<<0,
  33         WRITE_STRING_FILE_ATOMIC            = 1<<1,
  34         WRITE_STRING_FILE_AVOID_NEWLINE     = 1<<2,
  35         WRITE_STRING_FILE_VERIFY_ON_FAILURE = 1<<3,
  36         WRITE_STRING_FILE_SYNC              = 1<<4,
  37         WRITE_STRING_FILE_DISABLE_BUFFER    = 1<<5,
  38
  39         /* And before you wonder, why write_string_file_atomic_label_ts() is a separate function instead of just one
  40            more flag here: it's about linking: we don't want to pull -lselinux into all users of write_string_file()
  41            and friends. */
  42
  43 } WriteStringFileFlags;
  44
  45 int write_string_stream_ts(FILE *f, const char *line, WriteStringFileFlags flags, struct timespec *ts);
  46 static inline int write_string_stream(FILE *f, const char *line, WriteStringFileFlags flags) {
  47         return write_string_stream_ts(f, line, flags, NULL);
  48 }
  49 int write_string_file_ts(const char *fn, const char *line, WriteStringFileFlags flags, struct timespec *ts);
  50 static inline int write_string_file(const char *fn, const char *line, WriteStringFileFlags flags) {
  51         return write_string_file_ts(fn, line, flags, NULL);
  52 }
  53
  54 int read_one_line_file(const char *fn, char **line);
  55 int read_full_file(const char *fn, char **contents, size_t *size);
  56 int read_full_stream(FILE *f, char **contents, size_t *size);
  57
  58 int verify_file(const char *fn, const char *blob, bool accept_extra_nl);
  59
  60 int parse_env_file(const char *fname, const char *separator, ...) _sentinel_;
  61 #if 0 /// UNNEEDED by elogind
  62 int load_env_file(FILE *f, const char *fname, const char *separator, char ***l);
  63 #endif // 0
  64 int load_env_file_pairs(FILE *f, const char *fname, const char *separator, char ***l);
  65
  66 #if 0 /// UNNEEDED by elogind
  67 int merge_env_file(char ***env, FILE *f, const char *fname);
  68
  69 int write_env_file(const char *fname, char **l);
  70
  71 int executable_is_script(const char *path, char **interpreter);
  72 #endif // 0
  73
  74 int get_proc_field(const char *filename, const char *pattern, const char *terminator, char **field);
  75
  76 DIR *xopendirat(int dirfd, const char *name, int flags);
  77
  78 #if 0 /// UNNEEDED by elogind
  79 int search_and_fopen(const char *path, const char *mode, const char *root, const char **search, FILE **_f);
  80 int search_and_fopen_nulstr(const char *path, const char *mode, const char *root, const char *search, FILE **_f);
  81 #endif // 0
  82
  83 #define FOREACH_LINE(line, f, on_error)                         \
  84         for (;;)                                                \
  85                 if (!fgets(line, sizeof(line), f)) {            \
  86                         if (ferror(f)) {                        \
  87                                 on_error;                       \
  88                         }                                       \
  89                         break;                                  \
  90                 } else
  91
  92 int fflush_and_check(FILE *f);
  93 int fflush_sync_and_check(FILE *f);
  94
  95 int fopen_temporary(const char *path, FILE **_f, char **_temp_path);
  96 int mkostemp_safe(char *pattern);
  97
  98 int tempfn_xxxxxx(const char *p, const char *extra, char **ret);
  99 int tempfn_random(const char *p, const char *extra, char **ret);
 100 #if 0 /// UNNEEDED by elogind
 101 int tempfn_random_child(const char *p, const char *extra, char **ret);
 102
 103 int write_timestamp_file_atomic(const char *fn, usec_t n);
 104 int read_timestamp_file(const char *fn, usec_t *ret);
 105
 106 int fputs_with_space(FILE *f, const char *s, const char *separator, bool *space);
 107 #endif // 0
 108
 109 int open_tmpfile_unlinkable(const char *directory, int flags);
 110 #if 0 /// UNNEEDED by elogind
 111 int open_tmpfile_linkable(const char *target, int flags, char **ret_path);
 112 #endif // 0
 113 int open_serialization_fd(const char *ident);
 114
 115 #if 0 /// UNNEEDED by elogind
 116 int link_tmpfile(int fd, const char *path, const char *target);
 117
 118 int read_nul_string(FILE *f, char **ret);
 119
 120 int mkdtemp_malloc(const char *template, char **ret);
 121 #endif // 0
 122
 123 int read_line(FILE *f, size_t limit, char **ret);