1 #ifndef UTIL_LINUX_PATH_H
2 #define UTIL_LINUX_PATH_H
3 
4 #include <stdio.h>
5 #include <stdint.h>
6 #include <sys/stat.h>
7 #include <sys/types.h>
8 #include <dirent.h>
9 
10 #include "c.h"
11 
12 struct path_cxt {
13 	int	dir_fd;
14 	char	*dir_path;
15 
16 	int	refcount;
17 
18 	char *prefix;
19 	char path_buffer[PATH_MAX];
20 
21 	void	*dialect;
22 	void	(*free_dialect)(struct path_cxt *);
23 	int	(*redirect_on_enoent)(struct path_cxt *, const char *, int *);
24 };
25 
26 struct path_cxt *ul_new_path(const char *dir, ...);
27 void ul_unref_path(struct path_cxt *pc);
28 void ul_ref_path(struct path_cxt *pc);
29 
30 void ul_path_init_debug(void);
31 
32 int ul_path_set_prefix(struct path_cxt *pc, const char *prefix);
33 const char *ul_path_get_prefix(struct path_cxt *pc);
34 
35 int ul_path_set_dir(struct path_cxt *pc, const char *dir);
36 const char *ul_path_get_dir(struct path_cxt *pc);
37 
38 int ul_path_set_dialect(struct path_cxt *pc, void *data, void free_data(struct path_cxt *));
39 void *ul_path_get_dialect(struct path_cxt *pc);
40 
41 int ul_path_set_enoent_redirect(struct path_cxt *pc, int (*func)(struct path_cxt *, const char *, int *));
42 int ul_path_get_dirfd(struct path_cxt *pc);
43 void ul_path_close_dirfd(struct path_cxt *pc);
44 int ul_path_isopen_dirfd(struct path_cxt *pc);
45 int ul_path_is_accessible(struct path_cxt *pc);
46 
47 char *ul_path_get_abspath(struct path_cxt *pc, char *buf, size_t bufsz, const char *path, ...)
48 				__attribute__ ((__format__ (__printf__, 4, 5)));
49 
50 int ul_path_stat(struct path_cxt *pc, struct stat *sb, const char *path);
51 int ul_path_access(struct path_cxt *pc, int mode, const char *path);
52 int ul_path_accessf(struct path_cxt *pc, int mode, const char *path, ...)
53 				__attribute__ ((__format__ (__printf__, 3, 4)));
54 
55 int ul_path_open(struct path_cxt *pc, int flags, const char *path);
56 int ul_path_openf(struct path_cxt *pc, int flags, const char *path, ...)
57 				__attribute__ ((__format__ (__printf__, 3, 4)));
58 int ul_path_vopenf(struct path_cxt *pc, int flags, const char *path, va_list ap);
59 
60 FILE *ul_path_fopen(struct path_cxt *pc, const char *mode, const char *path);
61 FILE *ul_path_fopenf(struct path_cxt *pc, const char *mode, const char *path, ...)
62 				__attribute__ ((__format__ (__printf__, 3, 4)));
63 FILE *ul_path_vfopenf(struct path_cxt *pc, const char *mode, const char *path, va_list ap);
64 
65 DIR *ul_path_opendir(struct path_cxt *pc, const char *path);
66 DIR *ul_path_vopendirf(struct path_cxt *pc, const char *path, va_list ap);
67 DIR *ul_path_opendirf(struct path_cxt *pc, const char *path, ...)
68 				__attribute__ ((__format__ (__printf__, 2, 3)));
69 
70 ssize_t ul_path_readlink(struct path_cxt *pc, char *buf, size_t bufsiz, const char *path);
71 ssize_t ul_path_readlinkf(struct path_cxt *pc, char *buf, size_t bufsiz, const char *path, ...)
72 				__attribute__ ((__format__ (__printf__, 4, 5)));
73 
74 int ul_path_read(struct path_cxt *pc, char *buf, size_t len, const char *path);
75 int ul_path_vreadf(struct path_cxt *pc, char *buf, size_t len, const char *path, va_list ap);
76 int ul_path_readf(struct path_cxt *pc, char *buf, size_t len, const char *path, ...)
77 				__attribute__ ((__format__ (__printf__, 4, 5)));
78 
79 int ul_path_read_string(struct path_cxt *pc, char **str, const char *path);
80 int ul_path_readf_string(struct path_cxt *pc, char **str, const char *path, ...)
81 				__attribute__ ((__format__ (__printf__, 3, 4)));
82 
83 int ul_path_read_buffer(struct path_cxt *pc, char *buf, size_t bufsz, const char *path);
84 int ul_path_readf_buffer(struct path_cxt *pc, char *buf, size_t bufsz, const char *path, ...)
85 				__attribute__ ((__format__ (__printf__, 4, 5)));
86 
87 int ul_path_scanf(struct path_cxt *pc, const char *path, const char *fmt, ...);
88 int ul_path_scanff(struct path_cxt *pc, const char *path, va_list ap, const char *fmt, ...)
89 				__attribute__ ((__format__ (__scanf__, 4, 5)));
90 
91 int ul_path_read_majmin(struct path_cxt *pc, dev_t *res, const char *path);
92 int ul_path_readf_majmin(struct path_cxt *pc, dev_t *res, const char *path, ...)
93 				__attribute__ ((__format__ (__printf__, 3, 4)));
94 
95 int ul_path_read_u32(struct path_cxt *pc, uint32_t *res, const char *path);
96 int ul_path_readf_u32(struct path_cxt *pc, uint32_t *res, const char *path, ...)
97 				__attribute__ ((__format__ (__printf__, 3, 4)));
98 
99 int ul_path_read_s32(struct path_cxt *pc, int32_t *res, const char *path);
100 int ul_path_readf_s32(struct path_cxt *pc, int32_t *res, const char *path, ...)
101 				__attribute__ ((__format__ (__printf__, 3, 4)));
102 
103 int ul_path_read_u64(struct path_cxt *pc, uint64_t *res, const char *path);
104 int ul_path_readf_u64(struct path_cxt *pc, uint64_t *res, const char *path, ...)
105 				__attribute__ ((__format__ (__printf__, 3, 4)));
106 
107 int ul_path_read_s64(struct path_cxt *pc, int64_t *res, const char *path);
108 int ul_path_readf_s64(struct path_cxt *pc, int64_t *res, const char *path, ...)
109 				__attribute__ ((__format__ (__printf__, 3, 4)));
110 
111 int ul_path_write_string(struct path_cxt *pc, const char *str, const char *path);
112 int ul_path_writef_string(struct path_cxt *pc, const char *str, const char *path, ...)
113 				__attribute__ ((__format__ (__printf__, 3, 4)));
114 
115 int ul_path_write_s64(struct path_cxt *pc, int64_t num, const char *path);
116 int ul_path_write_u64(struct path_cxt *pc, uint64_t num, const char *path);
117 int ul_path_writef_u64(struct path_cxt *pc, uint64_t num, const char *path, ...)
118 				__attribute__ ((__format__ (__printf__, 3, 4)));
119 
120 int ul_path_count_dirents(struct path_cxt *pc, const char *path);
121 int ul_path_countf_dirents(struct path_cxt *pc, const char *path, ...)
122 				__attribute__ ((__format__ (__printf__, 2, 3)));
123 
124 FILE *ul_prefix_fopen(const char *prefix, const char *path, const char *mode);
125 
126 
127 #ifdef HAVE_CPU_SET_T
128 # include "cpuset.h"
129 int ul_path_readf_cpuset(struct path_cxt *pc, cpu_set_t **set, int maxcpus, const char *path, ...)
130 				__attribute__ ((__format__ (__printf__, 4, 5)));
131 
132 int ul_path_readf_cpulist(struct path_cxt *pc, cpu_set_t **set, int maxcpus, const char *path, ...)
133 				__attribute__ ((__format__ (__printf__, 4, 5)));
134 #endif /* HAVE_CPU_SET_T */
135 #endif /* UTIL_LINUX_PATH_H */
136