1 /*
2 FUSE: Filesystem in Userspace
3 Copyright (C) 2001-2007 Miklos Szeredi <miklos@szeredi.hu>
4 Copyright (C) 2022 Tofik Sonono <tofik.sonono@intel.com>
5
6 This program can be distributed under the terms of the GNU GPLv2.
7 See the file COPYING.
8 */
9
10 /** @file
11 *
12 * minimal example filesystem using low-level API and a custom io. This custom
13 * io is implemented using UNIX domain sockets (of type SOCK_STREAM)
14 *
15 * Compile with:
16 *
17 * gcc -Wall hello_ll_uds.c `pkg-config fuse3 --cflags --libs` -o hello_ll_uds
18 *
19 * ## Source code ##
20 * \include hello_ll.c
21 */
22
23 #define FUSE_USE_VERSION 34
24
25
26 #ifndef _GNU_SOURCE
27 #define _GNU_SOURCE
28 #endif
29
30 #include <fuse_lowlevel.h>
31 #include <fuse_kernel.h>
32 #include <stdio.h>
33 #include <stdlib.h>
34 #include <string.h>
35 #include <errno.h>
36 #include <fcntl.h>
37 #include <unistd.h>
38 #include <assert.h>
39 #include <sys/socket.h>
40 #include <sys/un.h>
41
42 static const char *hello_str = "Hello World!\n";
43 static const char *hello_name = "hello";
44
hello_stat(fuse_ino_t ino,struct stat * stbuf)45 static int hello_stat(fuse_ino_t ino, struct stat *stbuf)
46 {
47 stbuf->st_ino = ino;
48 switch (ino) {
49 case 1:
50 stbuf->st_mode = S_IFDIR | 0755;
51 stbuf->st_nlink = 2;
52 break;
53
54 case 2:
55 stbuf->st_mode = S_IFREG | 0444;
56 stbuf->st_nlink = 1;
57 stbuf->st_size = strlen(hello_str);
58 break;
59
60 default:
61 return -1;
62 }
63 return 0;
64 }
65
hello_ll_getattr(fuse_req_t req,fuse_ino_t ino,struct fuse_file_info * fi)66 static void hello_ll_getattr(fuse_req_t req, fuse_ino_t ino,
67 struct fuse_file_info *fi)
68 {
69 struct stat stbuf;
70
71 (void) fi;
72
73 memset(&stbuf, 0, sizeof(stbuf));
74 if (hello_stat(ino, &stbuf) == -1)
75 fuse_reply_err(req, ENOENT);
76 else
77 fuse_reply_attr(req, &stbuf, 1.0);
78 }
79
hello_ll_lookup(fuse_req_t req,fuse_ino_t parent,const char * name)80 static void hello_ll_lookup(fuse_req_t req, fuse_ino_t parent, const char *name)
81 {
82 struct fuse_entry_param e;
83
84 if (parent != 1 || strcmp(name, hello_name) != 0)
85 fuse_reply_err(req, ENOENT);
86 else {
87 memset(&e, 0, sizeof(e));
88 e.ino = 2;
89 e.attr_timeout = 1.0;
90 e.entry_timeout = 1.0;
91 hello_stat(e.ino, &e.attr);
92
93 fuse_reply_entry(req, &e);
94 }
95 }
96
97 struct dirbuf {
98 char *p;
99 size_t size;
100 };
101
dirbuf_add(fuse_req_t req,struct dirbuf * b,const char * name,fuse_ino_t ino)102 static void dirbuf_add(fuse_req_t req, struct dirbuf *b, const char *name,
103 fuse_ino_t ino)
104 {
105 struct stat stbuf;
106 size_t oldsize = b->size;
107 b->size += fuse_add_direntry(req, NULL, 0, name, NULL, 0);
108 b->p = (char *) realloc(b->p, b->size);
109 memset(&stbuf, 0, sizeof(stbuf));
110 stbuf.st_ino = ino;
111 fuse_add_direntry(req, b->p + oldsize, b->size - oldsize, name, &stbuf,
112 b->size);
113 }
114
115 #define min(x, y) ((x) < (y) ? (x) : (y))
116
reply_buf_limited(fuse_req_t req,const char * buf,size_t bufsize,off_t off,size_t maxsize)117 static int reply_buf_limited(fuse_req_t req, const char *buf, size_t bufsize,
118 off_t off, size_t maxsize)
119 {
120 if (off < bufsize)
121 return fuse_reply_buf(req, buf + off,
122 min(bufsize - off, maxsize));
123 else
124 return fuse_reply_buf(req, NULL, 0);
125 }
126
hello_ll_readdir(fuse_req_t req,fuse_ino_t ino,size_t size,off_t off,struct fuse_file_info * fi)127 static void hello_ll_readdir(fuse_req_t req, fuse_ino_t ino, size_t size,
128 off_t off, struct fuse_file_info *fi)
129 {
130 (void) fi;
131
132 if (ino != 1)
133 fuse_reply_err(req, ENOTDIR);
134 else {
135 struct dirbuf b;
136
137 memset(&b, 0, sizeof(b));
138 dirbuf_add(req, &b, ".", 1);
139 dirbuf_add(req, &b, "..", 1);
140 dirbuf_add(req, &b, hello_name, 2);
141 reply_buf_limited(req, b.p, b.size, off, size);
142 free(b.p);
143 }
144 }
145
hello_ll_open(fuse_req_t req,fuse_ino_t ino,struct fuse_file_info * fi)146 static void hello_ll_open(fuse_req_t req, fuse_ino_t ino,
147 struct fuse_file_info *fi)
148 {
149 if (ino != 2)
150 fuse_reply_err(req, EISDIR);
151 else if ((fi->flags & O_ACCMODE) != O_RDONLY)
152 fuse_reply_err(req, EACCES);
153 else
154 fuse_reply_open(req, fi);
155 }
156
hello_ll_read(fuse_req_t req,fuse_ino_t ino,size_t size,off_t off,struct fuse_file_info * fi)157 static void hello_ll_read(fuse_req_t req, fuse_ino_t ino, size_t size,
158 off_t off, struct fuse_file_info *fi)
159 {
160 (void) fi;
161
162 assert(ino == 2);
163 reply_buf_limited(req, hello_str, strlen(hello_str), off, size);
164 }
165
166 static const struct fuse_lowlevel_ops hello_ll_oper = {
167 .lookup = hello_ll_lookup,
168 .getattr = hello_ll_getattr,
169 .readdir = hello_ll_readdir,
170 .open = hello_ll_open,
171 .read = hello_ll_read,
172 };
173
create_socket(const char * socket_path)174 static int create_socket(const char *socket_path) {
175 struct sockaddr_un addr;
176
177 if (strnlen(socket_path, sizeof(addr.sun_path)) >=
178 sizeof(addr.sun_path)) {
179 printf("Socket path may not be longer than %lu characters\n",
180 sizeof(addr.sun_path) - 1);
181 return -1;
182 }
183
184 if (remove(socket_path) == -1 && errno != ENOENT) {
185 printf("Could not delete previous socket file entry at %s. Error: "
186 "%s\n", socket_path, strerror(errno));
187 return -1;
188 }
189
190 memset(&addr, 0, sizeof(struct sockaddr_un));
191 strcpy(addr.sun_path, socket_path);
192
193 int sfd = socket(AF_UNIX, SOCK_STREAM, 0);
194 if (sfd == -1) {
195 printf("Could not create socket. Error: %s\n", strerror(errno));
196 return -1;
197 }
198
199 addr.sun_family = AF_UNIX;
200 if (bind(sfd, (struct sockaddr *) &addr,
201 sizeof(struct sockaddr_un)) == -1) {
202 printf("Could not bind socket. Error: %s\n", strerror(errno));
203 return -1;
204 }
205
206 if (listen(sfd, 1) == -1)
207 return -1;
208
209 printf("Awaiting connection on socket at %s...\n", socket_path);
210 int cfd = accept(sfd, NULL, NULL);
211 if (cfd == -1) {
212 printf("Could not accept connection. Error: %s\n",
213 strerror(errno));
214 return -1;
215 } else {
216 printf("Accepted connection!\n");
217 }
218 return cfd;
219 }
220
stream_writev(int fd,struct iovec * iov,int count,void * userdata)221 static ssize_t stream_writev(int fd, struct iovec *iov, int count,
222 void *userdata) {
223 (void)userdata;
224
225 ssize_t written = 0;
226 int cur = 0;
227 for (;;) {
228 written = writev(fd, iov+cur, count-cur);
229 if (written < 0)
230 return written;
231
232 while (cur < count && written >= iov[cur].iov_len)
233 written -= iov[cur++].iov_len;
234 if (cur == count)
235 break;
236
237 iov[cur].iov_base = (char *)iov[cur].iov_base + written;
238 iov[cur].iov_len -= written;
239 }
240 return written;
241 }
242
243
readall(int fd,void * buf,size_t len)244 static ssize_t readall(int fd, void *buf, size_t len) {
245 size_t count = 0;
246
247 while (count < len) {
248 int i = read(fd, (char *)buf + count, len - count);
249 if (!i)
250 break;
251
252 if (i < 0)
253 return i;
254
255 count += i;
256 }
257 return count;
258 }
259
stream_read(int fd,void * buf,size_t buf_len,void * userdata)260 static ssize_t stream_read(int fd, void *buf, size_t buf_len, void *userdata) {
261 (void)userdata;
262
263 int res = readall(fd, buf, sizeof(struct fuse_in_header));
264 if (res == -1)
265 return res;
266
267
268 uint32_t packet_len = ((struct fuse_in_header *)buf)->len;
269 if (packet_len > buf_len)
270 return -1;
271
272 int prev_res = res;
273
274 res = readall(fd, (char *)buf + sizeof(struct fuse_in_header),
275 packet_len - sizeof(struct fuse_in_header));
276
277 return (res == -1) ? res : (res + prev_res);
278 }
279
stream_splice_send(int fdin,off_t * offin,int fdout,off_t * offout,size_t len,unsigned int flags,void * userdata)280 static ssize_t stream_splice_send(int fdin, off_t *offin, int fdout,
281 off_t *offout, size_t len,
282 unsigned int flags, void *userdata) {
283 (void)userdata;
284
285 size_t count = 0;
286 while (count < len) {
287 int i = splice(fdin, offin, fdout, offout, len - count, flags);
288 if (i < 1)
289 return i;
290
291 count += i;
292 }
293 return count;
294 }
295
fuse_cmdline_help_uds(void)296 static void fuse_cmdline_help_uds(void)
297 {
298 printf(" -h --help print help\n"
299 " -V --version print version\n"
300 " -d -o debug enable debug output (implies -f)\n");
301 }
302
main(int argc,char * argv[])303 int main(int argc, char *argv[])
304 {
305 struct fuse_args args = FUSE_ARGS_INIT(argc, argv);
306 struct fuse_session *se;
307 struct fuse_cmdline_opts opts;
308 const struct fuse_custom_io io = {
309 .writev = stream_writev,
310 .read = stream_read,
311 .splice_receive = NULL,
312 .splice_send = stream_splice_send,
313 };
314 int cfd = -1;
315 int ret = -1;
316
317 if (fuse_parse_cmdline(&args, &opts) != 0)
318 return 1;
319 if (opts.show_help) {
320 printf("usage: %s [options]\n\n", argv[0]);
321 fuse_cmdline_help_uds();
322 fuse_lowlevel_help();
323 ret = 0;
324 goto err_out1;
325 } else if (opts.show_version) {
326 printf("FUSE library version %s\n", fuse_pkgversion());
327 fuse_lowlevel_version();
328 ret = 0;
329 goto err_out1;
330 }
331
332 se = fuse_session_new(&args, &hello_ll_oper,
333 sizeof(hello_ll_oper), NULL);
334 if (se == NULL)
335 goto err_out1;
336
337 if (fuse_set_signal_handlers(se) != 0)
338 goto err_out2;
339
340 cfd = create_socket("/tmp/libfuse-hello-ll.sock");
341 if (cfd == -1)
342 goto err_out3;
343
344 if (fuse_session_custom_io(se, &io, cfd) != 0)
345 goto err_out3;
346
347 /* Block until ctrl+c */
348 ret = fuse_session_loop(se);
349 err_out3:
350 fuse_remove_signal_handlers(se);
351 err_out2:
352 fuse_session_destroy(se);
353 err_out1:
354 free(opts.mountpoint);
355 fuse_opt_free_args(&args);
356
357 return ret ? 1 : 0;
358 }
359