diff options
author | Márton Németh <nm127@freemail.hu> | 2009-02-20 08:12:51 +0100 |
---|---|---|
committer | Jens Axboe <jens.axboe@oracle.com> | 2009-02-26 10:45:48 +0100 |
commit | 9e8c0bccdc944bd09361672d47660810c027bcaa (patch) | |
tree | 2974fec8cbfdddc52d0a051b26dadc7898079d14 /block/genhd.c | |
parent | b2bf96833c5782befc3e7700f791fde754a47b01 (diff) | |
download | kernel_samsung_crespo-9e8c0bccdc944bd09361672d47660810c027bcaa.zip kernel_samsung_crespo-9e8c0bccdc944bd09361672d47660810c027bcaa.tar.gz kernel_samsung_crespo-9e8c0bccdc944bd09361672d47660810c027bcaa.tar.bz2 |
block: add documentation for register_blkdev()
Add documentation for register_blkdev() function and for the parameters.
Signed-off-by: Márton Németh <nm127@freemail.hu>
Cc: Greg Kroah-Hartman <gregkh@suse.de>
Signed-off-by: Jens Axboe <jens.axboe@oracle.com>
Diffstat (limited to 'block/genhd.c')
-rw-r--r-- | block/genhd.c | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/block/genhd.c b/block/genhd.c index e1eadcc..a9ec910 100644 --- a/block/genhd.c +++ b/block/genhd.c @@ -256,6 +256,22 @@ void blkdev_show(struct seq_file *seqf, off_t offset) } #endif /* CONFIG_PROC_FS */ +/** + * register_blkdev - register a new block device + * + * @major: the requested major device number [1..255]. If @major=0, try to + * allocate any unused major number. + * @name: the name of the new block device as a zero terminated string + * + * The @name must be unique within the system. + * + * The return value depends on the @major input parameter. + * - if a major device number was requested in range [1..255] then the + * function returns zero on success, or a negative error code + * - if any unused major number was requested with @major=0 parameter + * then the return value is the allocated major number in range + * [1..255] or a negative error code otherwise + */ int register_blkdev(unsigned int major, const char *name) { struct blk_major_name **n, *p; |