forked from mirrors/linux
		
	Fix multiple kernel-doc warnings in freevxfs: fs/freevxfs/vxfs_subr.c:45: warning: Function parameter or member 'mapping' not described in 'vxfs_get_page' fs/freevxfs/vxfs_subr.c:45: warning: Excess function parameter 'ip' description in 'vxfs_get_page' 2 warnings fs/freevxfs/vxfs_subr.c:101: warning: expecting prototype for vxfs_get_block(). Prototype was for vxfs_getblk() instead fs/freevxfs/vxfs_super.c:184: warning: expecting prototype for vxfs_read_super(). Prototype was for vxfs_fill_super() instead Link: https://lkml.kernel.org/r/20230109022915.17504-1-rdunlap@infradead.org Signed-off-by: Randy Dunlap <rdunlap@infradead.org> Reviewed-by: Christoph Hellwig <hch@lst.de> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
		
			
				
	
	
		
			152 lines
		
	
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			152 lines
		
	
	
	
		
			3.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
// SPDX-License-Identifier: GPL-2.0-only
 | 
						|
/*
 | 
						|
 * Copyright (c) 2000-2001 Christoph Hellwig.
 | 
						|
 */
 | 
						|
 | 
						|
/*
 | 
						|
 * Veritas filesystem driver - shared subroutines.
 | 
						|
 */
 | 
						|
#include <linux/fs.h>
 | 
						|
#include <linux/buffer_head.h>
 | 
						|
#include <linux/kernel.h>
 | 
						|
#include <linux/pagemap.h>
 | 
						|
 | 
						|
#include "vxfs_extern.h"
 | 
						|
 | 
						|
 | 
						|
static int		vxfs_read_folio(struct file *, struct folio *);
 | 
						|
static sector_t		vxfs_bmap(struct address_space *, sector_t);
 | 
						|
 | 
						|
const struct address_space_operations vxfs_aops = {
 | 
						|
	.read_folio =		vxfs_read_folio,
 | 
						|
	.bmap =			vxfs_bmap,
 | 
						|
};
 | 
						|
 | 
						|
inline void
 | 
						|
vxfs_put_page(struct page *pp)
 | 
						|
{
 | 
						|
	kunmap(pp);
 | 
						|
	put_page(pp);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * vxfs_get_page - read a page into memory.
 | 
						|
 * @mapping:	mapping to read from
 | 
						|
 * @n:		page number
 | 
						|
 *
 | 
						|
 * Description:
 | 
						|
 *   vxfs_get_page reads the @n th page of @ip into the pagecache.
 | 
						|
 *
 | 
						|
 * Returns:
 | 
						|
 *   The wanted page on success, else a NULL pointer.
 | 
						|
 */
 | 
						|
struct page *
 | 
						|
vxfs_get_page(struct address_space *mapping, u_long n)
 | 
						|
{
 | 
						|
	struct page *			pp;
 | 
						|
 | 
						|
	pp = read_mapping_page(mapping, n, NULL);
 | 
						|
 | 
						|
	if (!IS_ERR(pp)) {
 | 
						|
		kmap(pp);
 | 
						|
		/** if (!PageChecked(pp)) **/
 | 
						|
			/** vxfs_check_page(pp); **/
 | 
						|
	}
 | 
						|
	
 | 
						|
	return (pp);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * vxfs_bread - read buffer for a give inode,block tuple
 | 
						|
 * @ip:		inode
 | 
						|
 * @block:	logical block
 | 
						|
 *
 | 
						|
 * Description:
 | 
						|
 *   The vxfs_bread function reads block no @block  of
 | 
						|
 *   @ip into the buffercache.
 | 
						|
 *
 | 
						|
 * Returns:
 | 
						|
 *   The resulting &struct buffer_head.
 | 
						|
 */
 | 
						|
struct buffer_head *
 | 
						|
vxfs_bread(struct inode *ip, int block)
 | 
						|
{
 | 
						|
	struct buffer_head	*bp;
 | 
						|
	daddr_t			pblock;
 | 
						|
 | 
						|
	pblock = vxfs_bmap1(ip, block);
 | 
						|
	bp = sb_bread(ip->i_sb, pblock);
 | 
						|
 | 
						|
	return (bp);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * vxfs_getblk - locate buffer for given inode,block tuple
 | 
						|
 * @ip:		inode
 | 
						|
 * @iblock:	logical block
 | 
						|
 * @bp:		buffer skeleton
 | 
						|
 * @create:	%TRUE if blocks may be newly allocated.
 | 
						|
 *
 | 
						|
 * Description:
 | 
						|
 *   The vxfs_getblk function fills @bp with the right physical
 | 
						|
 *   block and device number to perform a lowlevel read/write on
 | 
						|
 *   it.
 | 
						|
 *
 | 
						|
 * Returns:
 | 
						|
 *   Zero on success, else a negativ error code (-EIO).
 | 
						|
 */
 | 
						|
static int
 | 
						|
vxfs_getblk(struct inode *ip, sector_t iblock,
 | 
						|
	    struct buffer_head *bp, int create)
 | 
						|
{
 | 
						|
	daddr_t			pblock;
 | 
						|
 | 
						|
	pblock = vxfs_bmap1(ip, iblock);
 | 
						|
	if (pblock != 0) {
 | 
						|
		map_bh(bp, ip->i_sb, pblock);
 | 
						|
		return 0;
 | 
						|
	}
 | 
						|
 | 
						|
	return -EIO;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
 * vxfs_read_folio - read one page synchronously into the pagecache
 | 
						|
 * @file:	file context (unused)
 | 
						|
 * @folio:	folio to fill in.
 | 
						|
 *
 | 
						|
 * Description:
 | 
						|
 *   The vxfs_read_folio routine reads @folio synchronously into the
 | 
						|
 *   pagecache.
 | 
						|
 *
 | 
						|
 * Returns:
 | 
						|
 *   Zero on success, else a negative error code.
 | 
						|
 *
 | 
						|
 * Locking status:
 | 
						|
 *   @folio is locked and will be unlocked.
 | 
						|
 */
 | 
						|
static int vxfs_read_folio(struct file *file, struct folio *folio)
 | 
						|
{
 | 
						|
	return block_read_full_folio(folio, vxfs_getblk);
 | 
						|
}
 | 
						|
 
 | 
						|
/**
 | 
						|
 * vxfs_bmap - perform logical to physical block mapping
 | 
						|
 * @mapping:	logical to physical mapping to use
 | 
						|
 * @block:	logical block (relative to @mapping).
 | 
						|
 *
 | 
						|
 * Description:
 | 
						|
 *   Vxfs_bmap find out the corresponding phsical block to the
 | 
						|
 *   @mapping, @block pair.
 | 
						|
 *
 | 
						|
 * Returns:
 | 
						|
 *   Physical block number on success, else Zero.
 | 
						|
 *
 | 
						|
 * Locking status:
 | 
						|
 *   We are under the bkl.
 | 
						|
 */
 | 
						|
static sector_t
 | 
						|
vxfs_bmap(struct address_space *mapping, sector_t block)
 | 
						|
{
 | 
						|
	return generic_block_bmap(mapping, block, vxfs_getblk);
 | 
						|
}
 |