file.h

Go to the documentation of this file.

 
#ifndef MUTT_MUTT_FILE_H
#define MUTT_MUTT_FILE_H
 
#include "config.h"
#include <dirent.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <sys/types.h>
 
struct Buffer;
struct stat;
extern const char FilenameSafeChars[];

enum ReadLineFlag
{
  MUTT_RL_NONE =       0,  
  MUTT_RL_CONT = 1U << 0,  
  MUTT_RL_EOL  = 1U << 1,  
};
typedef uint8_t ReadLineFlags;
 
struct timespec;

enum MuttStatType
{
  MUTT_STAT_ATIME, 
  MUTT_STAT_MTIME, 
  MUTT_STAT_CTIME, 
};

enum MuttOpenDirMode
{
  MUTT_OPENDIR_NONE,   
  MUTT_OPENDIR_CREATE, 
};

struct MuttFileIter
{
  char *line;   
  size_t size;  
  int line_num; 
};

typedef bool (*mutt_file_map_t)(char *line, int line_num, void *user_data);
 
int         mutt_file_check_empty(const char *path);
int         mutt_file_chmod_add(const char *path, mode_t mode);
int         mutt_file_chmod_add_stat(const char *path, mode_t mode, struct stat *st);
int         mutt_file_chmod_rm_stat(const char *path, mode_t mode, struct stat *st);
int         mutt_file_copy_bytes(FILE *fp_in, FILE *fp_out, size_t size);
int         mutt_file_copy_stream(FILE *fp_in, FILE *fp_out);
time_t      mutt_file_decrease_mtime(const char *fp, struct stat *st);
void        mutt_file_expand_fmt(struct Buffer *dest, const char *fmt, const char *src);
void        mutt_file_expand_fmt_quote(char *dest, size_t destlen, const char *fmt, const char *src);
int         mutt_file_fclose_full(FILE **fp, const char *file, int line, const char *func);
FILE *      mutt_file_fopen_full(const char *path, const char *mode, const mode_t perms, const char *file, int line, const char *func);
FILE *      mutt_file_fopen_masked_full(const char *path, const char *mode, const char *file, int line, const char *func);
int         mutt_file_fsync_close(FILE **fp);
long        mutt_file_get_size(const char *path);
long        mutt_file_get_size_fp(FILE* fp);
void        mutt_file_get_stat_timespec(struct timespec *dest, struct stat *st, enum MuttStatType type);
bool        mutt_file_iter_line(struct MuttFileIter *iter, FILE *fp, ReadLineFlags flags);
int         mutt_file_lock(int fd, bool excl, bool timeout);
bool        mutt_file_map_lines(mutt_file_map_t func, void *user_data, FILE *fp, ReadLineFlags flags);
int         mutt_file_mkdir(const char *path, mode_t mode);
int         mutt_file_open(const char *path, uint32_t flags, mode_t mode);
DIR *       mutt_file_opendir(const char *path, enum MuttOpenDirMode mode);
char *      mutt_file_read_keyword(const char *file, char *buf, size_t buflen);
char *      mutt_file_read_line(char *line, size_t *size, FILE *fp, int *line_num, ReadLineFlags flags);
int         mutt_file_rename(const char *oldfile, const char *newfile);
int         mutt_file_rmtree(const char *path);
const char *mutt_file_rotate(const char *path, int num);
int         mutt_file_safe_rename(const char *src, const char *target);
void        mutt_file_sanitize_filename(char *path, bool slash);
int         mutt_file_sanitize_regex(struct Buffer *dest, const char *src);
size_t      mutt_file_save_str(FILE *fp, const char *str);
bool        mutt_file_seek(FILE *fp, LOFF_T offset, int whence);
void        mutt_file_set_mtime(const char *from, const char *to);
int         mutt_file_stat_compare(struct stat *st1, enum MuttStatType st1_type, struct stat *st2, enum MuttStatType st2_type);
int         mutt_file_stat_timespec_compare(struct stat *st, enum MuttStatType type, struct timespec *b);
int         mutt_file_symlink(const char *oldpath, const char *newpath);
int         mutt_file_timespec_compare(struct timespec *a, struct timespec *b);
bool        mutt_file_touch(const char *path);
void        mutt_file_touch_atime(int fd);
void        mutt_file_unlink(const char *s);
void        mutt_file_unlink_empty(const char *path);
int         mutt_file_unlock(int fd);
void        mutt_file_resolve_symlink(struct Buffer *buf);
 
void        buf_quote_filename(struct Buffer *buf, const char *filename, bool add_outer);
void        buf_file_expand_fmt_quote(struct Buffer *dest, const char *fmt, const char *src);
 
// Safest default permissions should be 0600
#define mutt_file_fopen(PATH, MODE) mutt_file_fopen_full(PATH, MODE, 0600, __FILE__, __LINE__, __func__)
#define mutt_file_fclose(FP)        mutt_file_fclose_full(FP, __FILE__, __LINE__, __func__)
 
#endif /* MUTT_MUTT_FILE_H */