Some more nits.
Subject: eventfs: Implement functions to create files and dirs when accessed
On Thu, 13 Jul 2023 17:03:20 +0530
Ajay Kaher <akaher@xxxxxxxxxx> wrote:
> Adding create_file(), create_dir() to create file, dir
> at runtime when they are accessed.
>
> These function will be called either from lookup
> of inode_operations or open of file_operations.
Add create_file() and create_dir() functions to create the files and
directories respectively when they are accessed. The functions will be
called from the lookup operation of the inode_operations or from the open
function of file_operations.
>
> Signed-off-by: Ajay Kaher <akaher@xxxxxxxxxx>
> Co-developed-by: Steven Rostedt (VMware) <rostedt@xxxxxxxxxxx>
> Signed-off-by: Steven Rostedt (VMware) <rostedt@xxxxxxxxxxx>
> Tested-by: Ching-lin Yu <chinglinyu@xxxxxxxxxx>
> ---
> fs/tracefs/event_inode.c | 110 +++++++++++++++++++++++++++++++++++++++
> fs/tracefs/inode.c | 47 +++++++++++++++++
> include/linux/tracefs.h | 7 +++
> 3 files changed, 164 insertions(+)
>
> diff --git a/fs/tracefs/event_inode.c b/fs/tracefs/event_inode.c
> index 322a77be5a56..34b5d3d8005b 100644
> --- a/fs/tracefs/event_inode.c
> +++ b/fs/tracefs/event_inode.c
> @@ -46,6 +46,116 @@ struct eventfs_file {
>
> static DEFINE_MUTEX(eventfs_mutex);
> DEFINE_STATIC_SRCU(eventfs_srcu);
> +/**
> + * create_file - create a file in the tracefs filesystem
> + * @name: the name of the file to create.
> + * @mode: the permission that the file should have.
> + * @parent: parent dentry for this file.
> + * @data: something that the caller will want to get to later on.
> + * The inode.i_private pointer will point to this value on
> + * the open() call.
Again, should move the extra lines into the description.
> + * @fop: struct file_operations that should be used for this file.
> + *
> + * This is the basic "create a file" function for tracefs. It allows for a
> + * wide range of flexibility in creating a file.
> + *
> + * This function will return a pointer to a dentry if it succeeds. This
> + * pointer must be passed to the tracefs_remove() function when the file is
> + * to be removed (no automatic cleanup happens if your module is unloaded,
> + * you are responsible here.) If an error occurs, %NULL will be returned.
> + *
> + * If tracefs is not enabled in the kernel, the value -%ENODEV will be
> + * returned.
> + */
> +struct dentry *create_file(const char *name, umode_t mode,
> + struct dentry *parent, void *data,
> + const struct file_operations *fop)
> +{
> + struct tracefs_inode *ti;
> + struct dentry *dentry;
> + struct inode *inode;
> +
> + if (!(mode & S_IFMT))
> + mode |= S_IFREG;
> +
> + if (WARN_ON_ONCE(!S_ISREG(mode)))
> + return NULL;
> +
> + dentry = eventfs_start_creating(name, parent);
> +
> + if (IS_ERR(dentry))
> + return dentry;
> +
> + inode = tracefs_get_inode(dentry->d_sb);
> + if (unlikely(!inode))
> + return eventfs_failed_creating(dentry);
> +
> + inode->i_mode = mode;
> + inode->i_fop = fop;
> + inode->i_private = data;
> +
> + ti = get_tracefs(inode);
> + ti->flags |= TRACEFS_EVENT_INODE;
> + d_instantiate(dentry, inode);
> + fsnotify_create(dentry->d_parent->d_inode, dentry);
> + return eventfs_end_creating(dentry);
> +}
> +
> +/**
> + * create_dir - create a dir in the tracefs filesystem
> + * @name: the name of the file to create.
> + * @mode: the permission that the file should have.
> + * @parent: parent dentry for this file.
> + * @data: something that the caller will want to get to later on.
> + * The inode.i_private pointer will point to this value on
> + * the open() call.
Move the extra lines down into the description here too.
> + * @fop: struct file_operations that should be used for this dir.
> + * @iop: struct inode_operations that should be used for this dir.
> + *
> + * This is the basic "create a dir" function for eventfs. It allows for a
> + * wide range of flexibility in creating a dir.
> + *
> + * This function will return a pointer to a dentry if it succeeds. This
> + * pointer must be passed to the tracefs_remove() function when the file is
> + * to be removed (no automatic cleanup happens if your module is unloaded,
> + * you are responsible here.) If an error occurs, %NULL will be returned.
> + *
> + * If tracefs is not enabled in the kernel, the value -%ENODEV will be
> + * returned.
> + */
> +struct dentry *create_dir(const char *name, umode_t mode,
> + struct dentry *parent, void *data,
> + const struct file_operations *fop,
> + const struct inode_operations *iop)
> +{
> + struct tracefs_inode *ti;
> + struct dentry *dentry;
> + struct inode *inode;
> +
> + WARN_ON(!S_ISDIR(mode));
> +
> + dentry = eventfs_start_creating(name, parent);
> + if (IS_ERR(dentry))
> + return dentry;
> +
> + inode = tracefs_get_inode(dentry->d_sb);
> + if (unlikely(!inode))
> + return eventfs_failed_creating(dentry);
> +
> + inode->i_mode = mode;
> + inode->i_op = iop;
> + inode->i_fop = fop;
> + inode->i_private = data;
> +
> + ti = get_tracefs(inode);
> + ti->flags |= TRACEFS_EVENT_INODE;
> +
> + inc_nlink(inode);
> + d_instantiate(dentry, inode);
> + inc_nlink(dentry->d_parent->d_inode);
> + fsnotify_mkdir(dentry->d_parent->d_inode, dentry);
> + return eventfs_end_creating(dentry);
> +}
>
> static const struct file_operations eventfs_file_operations = {
> };
> diff --git a/fs/tracefs/inode.c b/fs/tracefs/inode.c
> index 7ef3a02766f5..7dc692a5fee1 100644
> --- a/fs/tracefs/inode.c
> +++ b/fs/tracefs/inode.c
> @@ -451,6 +451,53 @@ struct dentry *tracefs_end_creating(struct dentry *dentry)
> return dentry;
> }
>
This needs to be documented. What about:
/**
* eventfs_start_creating - start the process of creating a dentry
* @name: Name of the file created for the dentry
* @parent: The parent dentry where this dentry will be created
*
* This is a simple helper function for the dynamically created eventfs
* files. When the directory of the eventfs files are accessed, their
* dentries are created on the fly. This function is used to start that
* process.
*/
> +struct dentry *eventfs_start_creating(const char *name, struct dentry
> *parent) +{
> + struct dentry *dentry;
> + int error;
> +
> + error = simple_pin_fs(&trace_fs_type, &tracefs_mount,
> + &tracefs_mount_count);
> + if (error)
> + return ERR_PTR(error);
> +
> + /*
> + * If the parent is not specified, we create it in the root.
> + * We need the root dentry to do this, which is in the super
> + * block. A pointer to that is in the struct vfsmount that we
> + * have around.
> + */
> + if (!parent)
> + parent = tracefs_mount->mnt_root;
> +
> + if (unlikely(IS_DEADDIR(parent->d_inode)))
> + dentry = ERR_PTR(-ENOENT);
> + else
> + dentry = lookup_one_len(name, parent, strlen(name));
> +
> + if (!IS_ERR(dentry) && dentry->d_inode) {
> + dput(dentry);
> + dentry = ERR_PTR(-EEXIST);
> + }
> +
> + if (IS_ERR(dentry))
> + simple_release_fs(&tracefs_mount, &tracefs_mount_count);
> +
> + return dentry;
> +}
> +
/**
* eventfs_failed_creating - clean up a failed eventfs dentry creation
* @dentry: The dentry to clean up
*
* If after calling eventfs_start_creating(), a failure is detected, the
* resources created by eventfs_start_creating() needs to be cleaned up. In
* that case, this function should be called to perform that clean up.
*/
> +struct dentry *eventfs_failed_creating(struct dentry *dentry)
> +{
> + dput(dentry);
> + simple_release_fs(&tracefs_mount, &tracefs_mount_count);
> + return NULL;
> +}
> +
/**
* eventfs_end_creating - Finish the process of creating a eventfs dentry
* @dentry: The dentry that has successfully been created.
*
* This function is currently just a place holder to match
* eventfs_start_creating(). In case any synchronization needs to be added,
* this function will be used to implement that without having to modify
* the callers of eventfs_start_creating().
*/
> +struct dentry *eventfs_end_creating(struct dentry *dentry)
> +{
> + return dentry;
> +}
-- Steve
> +
> /**
> * tracefs_create_file - create a file in the tracefs filesystem
> * @name: a pointer to a string containing the name of the file to
> create. diff --git a/include/linux/tracefs.h b/include/linux/tracefs.h
> index 2c08edd4a739..47c1b4d21735 100644
> --- a/include/linux/tracefs.h
> +++ b/include/linux/tracefs.h
> @@ -23,6 +23,13 @@ struct file_operations;
>
> struct eventfs_file;
>
> +struct dentry *eventfs_start_creating(const char *name,
> + struct dentry *parent);
> +
> +struct dentry *eventfs_failed_creating(struct dentry *dentry);
> +
> +struct dentry *eventfs_end_creating(struct dentry *dentry);
> +
> struct dentry *eventfs_create_events_dir(const char *name,
> struct dentry *parent);
>
