Skip to content

Commit

Permalink
fuse: implement open in passthrough mode
Browse files Browse the repository at this point in the history
After getting a backing file id with FUSE_DEV_IOC_BACKING_OPEN ioctl,
a FUSE server can reply to an OPEN request with flag FOPEN_PASSTHROUGH
and the backing file id.

The FUSE server should reuse the same backing file id for all the open
replies of the same FUSE inode and open will fail (with -EIO) if a the
server attempts to open the same inode with conflicting io modes or to
setup passthrough to two different backing files for the same FUSE inode.
Using the same backing file id for several different inodes is allowed.

Opening a new file with FOPEN_DIRECT_IO for an inode that is already
open for passthrough is allowed, but only if the FOPEN_PASSTHROUGH flag
and correct backing file id are specified as well.

The read/write IO of such files will not use passthrough operations to
the backing file, but mmap, which does not support direct_io, will use
the backing file insead of using the page cache as it always did.

Even though all FUSE passthrough files of the same inode use the same
backing file as a backing inode reference, each FUSE file opens a unique
instance of a backing_file object to store the FUSE path that was used
to open the inode and the open flags of the specific open file.

The per-file, backing_file object is released along with the FUSE file.
The inode associated fuse_backing object is released when the last FUSE
passthrough file of that inode is released AND when the backing file id
is closed by the server using the FUSE_DEV_IOC_BACKING_CLOSE ioctl.

Signed-off-by: Amir Goldstein <amir73il@gmail.com>
  • Loading branch information
amir73il committed Jan 31, 2024
1 parent 06b3581 commit 9422b02
Show file tree
Hide file tree
Showing 3 changed files with 144 additions and 9 deletions.
61 changes: 52 additions & 9 deletions fs/fuse/file.c
Original file line number Diff line number Diff line change
Expand Up @@ -166,27 +166,44 @@ static void fuse_file_cached_io_end(struct inode *inode)
}

/* Start strictly uncached io mode where cache access is not allowed */
static int fuse_file_uncached_io_start(struct inode *inode)
static int fuse_file_uncached_io_start(struct inode *inode,
struct fuse_backing *fb)
{
struct fuse_inode *fi = get_fuse_inode(inode);
bool ok;
struct fuse_backing *oldfb;
bool ok = false;

spin_lock(&fi->lock);
ok = fuse_inode_deny_io_cache(fi);
/* deny conflicting backing files on same fuse inode */
oldfb = fuse_inode_backing(fi);
if (!oldfb || oldfb == fb)
ok = fuse_inode_deny_io_cache(fi);
/* fuse inode holds a single refcount of backing file */
if (!oldfb && ok) {
oldfb = fuse_inode_backing_set(fi, fb);
WARN_ON_ONCE(oldfb != NULL);
} else if (ok) {
fuse_backing_put(fb);
}
spin_unlock(&fi->lock);
return ok ? 0 : -ETXTBSY;
}

static void fuse_file_uncached_io_end(struct inode *inode)
{
struct fuse_inode *fi = get_fuse_inode(inode);
struct fuse_backing *oldfb = NULL;
bool allow_cached_io;

spin_lock(&fi->lock);
allow_cached_io = fuse_inode_allow_io_cache(fi);
if (allow_cached_io)
oldfb = fuse_inode_backing_set(fi, NULL);
spin_unlock(&fi->lock);
if (allow_cached_io)
wake_up(&fi->direct_io_waitq);
if (oldfb)
fuse_backing_put(oldfb);
}

/*
Expand All @@ -204,18 +221,26 @@ static int fuse_file_passthrough_open(struct file *file, struct inode *inode)
{
struct fuse_file *ff = file->private_data;
struct fuse_conn *fc = get_fuse_conn(inode);
struct fuse_backing *fb;
int err;

/* Check allowed conditions for file open in passthrough mode */
if (!IS_ENABLED(CONFIG_FUSE_PASSTHROUGH) || !fc->passthrough ||
!(ff->open_flags & FOPEN_PASSTHROUGH) ||
(ff->open_flags & ~FOPEN_PASSTHROUGH_MASK))
return -EINVAL;

/* TODO: implement backing file open */
return -EOPNOTSUPP;
fb = fuse_passthrough_open(file, inode, ff->open_outargp->backing_id);
if (IS_ERR(fb))
return PTR_ERR(fb);

/* First passthrough file open denies caching inode io mode */
err = fuse_file_uncached_io_start(inode);
err = fuse_file_uncached_io_start(inode, fb);
if (!err)
return 0;

fuse_passthrough_release(ff, fb);
fuse_backing_put(fb);

return err;
}
Expand All @@ -228,6 +253,7 @@ static int fuse_file_passthrough_open(struct file *file, struct inode *inode)
static int fuse_file_io_open(struct file *file, struct inode *inode)
{
struct fuse_file *ff = file->private_data;
struct fuse_inode *fi = get_fuse_inode(inode);
int iomode_flags = ff->open_flags & FOPEN_IO_MODE_MASK;
int err;

Expand All @@ -242,7 +268,12 @@ static int fuse_file_io_open(struct file *file, struct inode *inode)
return 0;
}

if (ff->open_flags & FOPEN_PASSTHROUGH) {
/*
* Server is expected to use FOPEN_PASSTHROUGH for all opens of an inode
* which is already open for passthrough, but can also combine the
* FOPEN_DIRECT_IO flag to restrict passthrough to mmap.
*/
if (ff->open_flags & FOPEN_PASSTHROUGH || fuse_inode_backing(fi)) {
err = fuse_file_passthrough_open(file, inode);
if (err)
goto fail;
Expand Down Expand Up @@ -304,9 +335,14 @@ static void fuse_file_io_release(struct fuse_file *ff, struct inode *inode)
if (!ff->io_opened)
return;

/* Last caching file close exits caching inode io mode */
/*
* Last caching file close allows passthrough open of inode and
* Last passthrough file close allows caching open of inode.
*/
if (ff->open_flags & FOPEN_CACHE_IO)
fuse_file_cached_io_end(inode);
else if (ff->open_flags & FOPEN_PASSTHROUGH)
fuse_file_uncached_io_end(inode);

ff->io_opened = false;
}
Expand Down Expand Up @@ -500,6 +536,9 @@ static void fuse_prepare_release(struct fuse_inode *fi, struct fuse_file *ff,
struct fuse_conn *fc = ff->fm->fc;
struct fuse_release_args *ra = ff->release_args;

if (fuse_file_passthrough(ff))
fuse_passthrough_release(ff, fuse_inode_backing(fi));

/* Inode is NULL on error path of fuse_create_open() */
if (likely(fi)) {
spin_lock(&fi->lock);
Expand Down Expand Up @@ -1578,7 +1617,7 @@ static void fuse_dio_lock(struct kiocb *iocb, struct iov_iter *from,
* have raced, so check it again.
*/
if (fuse_io_past_eof(iocb, from) ||
fuse_file_uncached_io_start(inode) != 0) {
fuse_file_uncached_io_start(inode, NULL) != 0) {
inode_unlock_shared(inode);
inode_lock(inode);
*exclusive = true;
Expand Down Expand Up @@ -2728,6 +2767,10 @@ static int fuse_file_mmap(struct file *file, struct vm_area_struct *vma)
if (FUSE_IS_DAX(file_inode(file)))
return fuse_dax_mmap(file, vma);

/* TODO: implement mmap to backing file */
if (fuse_file_passthrough(ff))
return -ENODEV;

/*
* FOPEN_DIRECT_IO handling is special compared to O_DIRECT,
* as does not allow MAP_SHARED mmap without FUSE_DIRECT_IO_ALLOW_MMAP.
Expand Down
33 changes: 33 additions & 0 deletions fs/fuse/fuse_i.h
Original file line number Diff line number Diff line change
Expand Up @@ -271,6 +271,12 @@ struct fuse_file {
/** Wait queue head for poll */
wait_queue_head_t poll_wait;

#ifdef CONFIG_FUSE_PASSTHROUGH
/** Reference to backing file in passthrough mode */
struct file *passthrough;
const struct cred *cred;
#endif

/** Has flock been performed on this file? */
bool flock:1;

Expand Down Expand Up @@ -1482,11 +1488,38 @@ static inline struct fuse_backing *fuse_inode_backing_set(struct fuse_inode *fi,
#endif
}

#ifdef CONFIG_FUSE_PASSTHROUGH
struct fuse_backing *fuse_backing_get(struct fuse_backing *fb);
void fuse_backing_put(struct fuse_backing *fb);
#else

static inline struct fuse_backing *fuse_backing_get(struct fuse_backing *fb)
{
return NULL;
}

static inline void fuse_backing_put(struct fuse_backing *fb)
{
}
#endif

void fuse_backing_files_init(struct fuse_conn *fc);
void fuse_backing_files_free(struct fuse_conn *fc);
int fuse_backing_open(struct fuse_conn *fc, struct fuse_backing_map *map);
int fuse_backing_close(struct fuse_conn *fc, int backing_id);

struct fuse_backing *fuse_passthrough_open(struct file *file,
struct inode *inode,
int backing_id);
void fuse_passthrough_release(struct fuse_file *ff, struct fuse_backing *fb);

static inline struct file *fuse_file_passthrough(struct fuse_file *ff)
{
#ifdef CONFIG_FUSE_PASSTHROUGH
return ff->passthrough;
#else
return NULL;
#endif
}

#endif /* _FS_FUSE_I_H */
59 changes: 59 additions & 0 deletions fs/fuse/passthrough.c
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
#include "fuse_i.h"

#include <linux/file.h>
#include <linux/backing-file.h>

struct fuse_backing *fuse_backing_get(struct fuse_backing *fb)
{
Expand Down Expand Up @@ -163,3 +164,61 @@ int fuse_backing_close(struct fuse_conn *fc, int backing_id)

return err;
}

/*
* Setup passthrough to a backing file.
*
* Returns an fb object with elevated refcount to be stored in fuse inode.
*/
struct fuse_backing *fuse_passthrough_open(struct file *file,
struct inode *inode,
int backing_id)
{
struct fuse_file *ff = file->private_data;
struct fuse_conn *fc = ff->fm->fc;
struct fuse_backing *fb = NULL;
struct file *backing_file;
int err;

err = -EINVAL;
if (backing_id <= 0)
goto out;

rcu_read_lock();
fb = idr_find(&fc->backing_files_map, backing_id);
fb = fuse_backing_get(fb);
rcu_read_unlock();

err = -ENOENT;
if (!fb)
goto out;

/* Allocate backing file per fuse file to store fuse path */
backing_file = backing_file_open(&file->f_path, file->f_flags,
&fb->file->f_path, fb->cred);
err = PTR_ERR(backing_file);
if (IS_ERR(backing_file)) {
fuse_backing_put(fb);
goto out;
}

err = 0;
ff->passthrough = backing_file;
ff->cred = get_cred(fb->cred);
out:
pr_debug("%s: backing_id=%d, fb=0x%p, backing_file=0x%p, err=%i\n", __func__,
backing_id, fb, ff->passthrough, err);

return err ? ERR_PTR(err) : fb;
}

void fuse_passthrough_release(struct fuse_file *ff, struct fuse_backing *fb)
{
pr_debug("%s: fb=0x%p, backing_file=0x%p\n", __func__,
fb, ff->passthrough);

fput(ff->passthrough);
ff->passthrough = NULL;
put_cred(ff->cred);
ff->cred = NULL;
}

0 comments on commit 9422b02

Please sign in to comment.