mirror of
https://github.com/torvalds/linux.git
synced 2024-11-30 08:01:59 +00:00
ec23eb54fb
There are 3 remaining files without an extension inside the fs docs dir. Manually convert them to ReST. In the case of the nfs/exporting.rst file, as the nfs docs aren't ported yet, I opted to convert and add a :orphan: there, with should be removed when it gets added into a nfs-specific part of the fs documentation. Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org> Signed-off-by: Jonathan Corbet <corbet@lwn.net>
194 lines
5.2 KiB
C
194 lines
5.2 KiB
C
// SPDX-License-Identifier: GPL-2.0
|
|
/*
|
|
* fs/isofs/export.c
|
|
*
|
|
* (C) 2004 Paul Serice - The new inode scheme requires switching
|
|
* from iget() to iget5_locked() which means
|
|
* the NFS export operations have to be hand
|
|
* coded because the default routines rely on
|
|
* iget().
|
|
*
|
|
* The following files are helpful:
|
|
*
|
|
* Documentation/filesystems/nfs/exporting.rst
|
|
* fs/exportfs/expfs.c.
|
|
*/
|
|
|
|
#include "isofs.h"
|
|
|
|
static struct dentry *
|
|
isofs_export_iget(struct super_block *sb,
|
|
unsigned long block,
|
|
unsigned long offset,
|
|
__u32 generation)
|
|
{
|
|
struct inode *inode;
|
|
|
|
if (block == 0)
|
|
return ERR_PTR(-ESTALE);
|
|
inode = isofs_iget(sb, block, offset);
|
|
if (IS_ERR(inode))
|
|
return ERR_CAST(inode);
|
|
if (generation && inode->i_generation != generation) {
|
|
iput(inode);
|
|
return ERR_PTR(-ESTALE);
|
|
}
|
|
return d_obtain_alias(inode);
|
|
}
|
|
|
|
/* This function is surprisingly simple. The trick is understanding
|
|
* that "child" is always a directory. So, to find its parent, you
|
|
* simply need to find its ".." entry, normalize its block and offset,
|
|
* and return the underlying inode. See the comments for
|
|
* isofs_normalize_block_and_offset(). */
|
|
static struct dentry *isofs_export_get_parent(struct dentry *child)
|
|
{
|
|
unsigned long parent_block = 0;
|
|
unsigned long parent_offset = 0;
|
|
struct inode *child_inode = d_inode(child);
|
|
struct iso_inode_info *e_child_inode = ISOFS_I(child_inode);
|
|
struct iso_directory_record *de = NULL;
|
|
struct buffer_head * bh = NULL;
|
|
struct dentry *rv = NULL;
|
|
|
|
/* "child" must always be a directory. */
|
|
if (!S_ISDIR(child_inode->i_mode)) {
|
|
printk(KERN_ERR "isofs: isofs_export_get_parent(): "
|
|
"child is not a directory!\n");
|
|
rv = ERR_PTR(-EACCES);
|
|
goto out;
|
|
}
|
|
|
|
/* It is an invariant that the directory offset is zero. If
|
|
* it is not zero, it means the directory failed to be
|
|
* normalized for some reason. */
|
|
if (e_child_inode->i_iget5_offset != 0) {
|
|
printk(KERN_ERR "isofs: isofs_export_get_parent(): "
|
|
"child directory not normalized!\n");
|
|
rv = ERR_PTR(-EACCES);
|
|
goto out;
|
|
}
|
|
|
|
/* The child inode has been normalized such that its
|
|
* i_iget5_block value points to the "." entry. Fortunately,
|
|
* the ".." entry is located in the same block. */
|
|
parent_block = e_child_inode->i_iget5_block;
|
|
|
|
/* Get the block in question. */
|
|
bh = sb_bread(child_inode->i_sb, parent_block);
|
|
if (bh == NULL) {
|
|
rv = ERR_PTR(-EACCES);
|
|
goto out;
|
|
}
|
|
|
|
/* This is the "." entry. */
|
|
de = (struct iso_directory_record*)bh->b_data;
|
|
|
|
/* The ".." entry is always the second entry. */
|
|
parent_offset = (unsigned long)isonum_711(de->length);
|
|
de = (struct iso_directory_record*)(bh->b_data + parent_offset);
|
|
|
|
/* Verify it is in fact the ".." entry. */
|
|
if ((isonum_711(de->name_len) != 1) || (de->name[0] != 1)) {
|
|
printk(KERN_ERR "isofs: Unable to find the \"..\" "
|
|
"directory for NFS.\n");
|
|
rv = ERR_PTR(-EACCES);
|
|
goto out;
|
|
}
|
|
|
|
/* Normalize */
|
|
isofs_normalize_block_and_offset(de, &parent_block, &parent_offset);
|
|
|
|
rv = d_obtain_alias(isofs_iget(child_inode->i_sb, parent_block,
|
|
parent_offset));
|
|
out:
|
|
if (bh)
|
|
brelse(bh);
|
|
return rv;
|
|
}
|
|
|
|
static int
|
|
isofs_export_encode_fh(struct inode *inode,
|
|
__u32 *fh32,
|
|
int *max_len,
|
|
struct inode *parent)
|
|
{
|
|
struct iso_inode_info * ei = ISOFS_I(inode);
|
|
int len = *max_len;
|
|
int type = 1;
|
|
__u16 *fh16 = (__u16*)fh32;
|
|
|
|
/*
|
|
* WARNING: max_len is 5 for NFSv2. Because of this
|
|
* limitation, we use the lower 16 bits of fh32[1] to hold the
|
|
* offset of the inode and the upper 16 bits of fh32[1] to
|
|
* hold the offset of the parent.
|
|
*/
|
|
if (parent && (len < 5)) {
|
|
*max_len = 5;
|
|
return FILEID_INVALID;
|
|
} else if (len < 3) {
|
|
*max_len = 3;
|
|
return FILEID_INVALID;
|
|
}
|
|
|
|
len = 3;
|
|
fh32[0] = ei->i_iget5_block;
|
|
fh16[2] = (__u16)ei->i_iget5_offset; /* fh16 [sic] */
|
|
fh16[3] = 0; /* avoid leaking uninitialized data */
|
|
fh32[2] = inode->i_generation;
|
|
if (parent) {
|
|
struct iso_inode_info *eparent;
|
|
eparent = ISOFS_I(parent);
|
|
fh32[3] = eparent->i_iget5_block;
|
|
fh16[3] = (__u16)eparent->i_iget5_offset; /* fh16 [sic] */
|
|
fh32[4] = parent->i_generation;
|
|
len = 5;
|
|
type = 2;
|
|
}
|
|
*max_len = len;
|
|
return type;
|
|
}
|
|
|
|
struct isofs_fid {
|
|
u32 block;
|
|
u16 offset;
|
|
u16 parent_offset;
|
|
u32 generation;
|
|
u32 parent_block;
|
|
u32 parent_generation;
|
|
};
|
|
|
|
static struct dentry *isofs_fh_to_dentry(struct super_block *sb,
|
|
struct fid *fid, int fh_len, int fh_type)
|
|
{
|
|
struct isofs_fid *ifid = (struct isofs_fid *)fid;
|
|
|
|
if (fh_len < 3 || fh_type > 2)
|
|
return NULL;
|
|
|
|
return isofs_export_iget(sb, ifid->block, ifid->offset,
|
|
ifid->generation);
|
|
}
|
|
|
|
static struct dentry *isofs_fh_to_parent(struct super_block *sb,
|
|
struct fid *fid, int fh_len, int fh_type)
|
|
{
|
|
struct isofs_fid *ifid = (struct isofs_fid *)fid;
|
|
|
|
if (fh_len < 2 || fh_type != 2)
|
|
return NULL;
|
|
|
|
return isofs_export_iget(sb,
|
|
fh_len > 2 ? ifid->parent_block : 0,
|
|
ifid->parent_offset,
|
|
fh_len > 4 ? ifid->parent_generation : 0);
|
|
}
|
|
|
|
const struct export_operations isofs_export_ops = {
|
|
.encode_fh = isofs_export_encode_fh,
|
|
.fh_to_dentry = isofs_fh_to_dentry,
|
|
.fh_to_parent = isofs_fh_to_parent,
|
|
.get_parent = isofs_export_get_parent,
|
|
};
|