1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
/*********************************************************************
* bfs *
* Copyright (C) 2016 Tavian Barnes <tavianator@tavianator.com> *
* *
* This program is free software. It comes without any warranty, to *
* the extent permitted by applicable law. You can redistribute it *
* and/or modify it under the terms of the Do What The Fuck You Want *
* To Public License, Version 2, as published by Sam Hocevar. See *
* the COPYING file or http://www.wtfpl.net/ for more details. *
*********************************************************************/
#ifndef BFS_UTIL_H
#define BFS_UTIL_H
#include <dirent.h>
#include <fcntl.h>
#include <fnmatch.h>
#include <regex.h>
#include <stdbool.h>
#include <sys/stat.h>
#include <time.h>
// Some portability concerns
#if __APPLE__
# define st_atim st_atimespec
# define st_ctim st_ctimespec
# define st_mtim st_mtimespec
#endif
#if !defined(FNM_CASEFOLD) && defined(FNM_IGNORECASE)
# define FNM_CASEFOLD FNM_IGNORECASE
#endif
#ifndef S_ISDOOR
# define S_ISDOOR(mode) false
#endif
#ifndef S_ISPORT
# define S_ISPORT(mode) false
#endif
#ifndef S_ISWHT
# define S_ISWHT(mode) false
#endif
/**
* readdir() wrapper that makes error handling cleaner.
*/
int xreaddir(DIR *dir, struct dirent **de);
/**
* readlinkat() wrapper that dynamically allocates the result.
*
* @param fd
* The base directory descriptor.
* @param path
* The path to the link, relative to fd.
* @param size
* An estimate for the size of the link name (pass 0 if unknown).
* @return The target of the link, allocated with malloc(), or NULL on failure.
*/
char *xreadlinkat(int fd, const char *path, size_t size);
/**
* Check if a file descriptor is open.
*/
bool isopen(int fd);
/**
* Open a file and redirect it to a particular descriptor.
*
* @param fd
* The file descriptor to redirect.
* @param path
* The path to open.
* @param flags
* The flags passed to open().
* @param mode
* The mode passed to open() (optional).
* @return fd on success, -1 on failure.
*/
int redirect(int fd, const char *path, int flags, ...);
/**
* Like dup(), but set the FD_CLOEXEC flag.
*
* @param fd
* The file descriptor to duplicate.
* @return A duplicated file descriptor, or -1 on failure.
*/
int dup_cloexec(int fd);
/**
* Dynamically allocate a regex error message.
*
* @param err
* The error code to stringify.
* @param regex
* The (partially) compiled regex.
* @return A human-readable description of the error, allocated with malloc().
*/
char *xregerror(int err, const regex_t *regex);
/**
* localtime_r() wrapper that calls tzset() first.
*
* @param timep
* The time_t to convert.
* @param result
* Buffer to hold the result.
* @return 0 on success, -1 on failure.
*/
int xlocaltime(const time_t *timep, struct tm *result);
/**
* Format a mode like ls -l (e.g. -rw-r--r--).
*
* @param mode
* The mode to format.
* @param str
* The string to hold the formatted mode.
*/
void format_mode(mode_t mode, char str[11]);
#endif // BFS_UTIL_H
|
