Mirrors/u-boot
2
0
Fork 0
mirror of https://github.com/AsahiLinux/u-boot synced 2025-02-26 12:27:12 +00:00
Code Issues Projects Releases Packages Wiki Activity

efi_driver: use Sphinx style comments

Browse source 
Use Sphinx style comments for describing function parameters.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
This commit is contained in:
Heinrich Schuchardt 2019-07-14 11:52:33 +02:00
parent 9ce912758a
commit 3f33f30bba
1 changed files with 20 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

39
lib/efi_driver/efi_block_device.c
View file

@ -43,14 +43,14 @@ struct efi_blk_platdata {
struct efi_block_io *io; struct efi_block_io *io;
}; };
/* /**
* Read from block device * Read from block device
* *
* @dev device * @dev: device
* @blknr first block to be read * @blknr: first block to be read
* @blkcnt number of blocks to read * @blkcnt: number of blocks to read
* @buffer output buffer * @buffer: output buffer
* @return number of blocks transferred * Return: number of blocks transferred
*/ */
static ulong efi_bl_read(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt, static ulong efi_bl_read(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt,
void *buffer) void *buffer)
@ -72,14 +72,14 @@ static ulong efi_bl_read(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt,
return blkcnt; return blkcnt;
} }
/* /**
* Write to block device * Write to block device
* *
* @dev device * @dev: device
* @blknr first block to be write * @blknr: first block to be write
* @blkcnt number of blocks to write * @blkcnt: number of blocks to write
* @buffer input buffer * @buffer: input buffer
* @return number of blocks transferred * Return: number of blocks transferred
*/ */
static ulong efi_bl_write(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt, static ulong efi_bl_write(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt,
const void *buffer) const void *buffer)
@ -102,11 +102,12 @@ static ulong efi_bl_write(struct udevice *dev, lbaint_t blknr, lbaint_t blkcnt,
return blkcnt; return blkcnt;
} }
/* /**
* Create partions for the block device. * Create partions for the block device.
* *
* @handle EFI handle of the block device * @handle: EFI handle of the block device
* @dev udevice of the block device * @dev: udevice of the block device
* Return: number of partitions created
*/ */
static int efi_bl_bind_partitions(efi_handle_t handle, struct udevice *dev) static int efi_bl_bind_partitions(efi_handle_t handle, struct udevice *dev)
{ {
@ -120,12 +121,12 @@ static int efi_bl_bind_partitions(efi_handle_t handle, struct udevice *dev)
desc->devnum, dev->name); desc->devnum, dev->name);
} }
/* /**
* Create a block device for a handle * Create a block device for a handle
* *
* @handle handle * @handle: handle
* @interface block io protocol * @interface: block io protocol
* @return 0 = success * Return: 0 = success
*/ */
static int efi_bl_bind(efi_handle_t handle, void *interface) static int efi_bl_bind(efi_handle_t handle, void *interface)
{ {