diff options
author | Rolf Eike Beer <eike-kernel@sf-tec.de> | 2006-07-14 07:24:23 (GMT) |
---|---|---|
committer | Linus Torvalds <torvalds@g5.osdl.org> | 2006-07-15 04:53:54 (GMT) |
commit | d247e2c661f28a21e5f9a8d672e1e88a7c1c5d4a (patch) | |
tree | cb202ad2d4f3504ff31bf0e474aae855ac3dd41a /fs | |
parent | c259cc281255bdb30ceba190bfd7f37e3ae3fc85 (diff) | |
download | linux-d247e2c661f28a21e5f9a8d672e1e88a7c1c5d4a.tar.xz |
[PATCH] add function documentation for register_chrdev()
Documentation for register_chrdev() was missing completely.
[akpm@osdl.org: kerneldocification]
Signed-off-by: Rolf Eike Beer <eike-kernel@sf-tec.de>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Diffstat (limited to 'fs')
-rw-r--r-- | fs/char_dev.c | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/fs/char_dev.c b/fs/char_dev.c index a4cbc67..3483d3c 100644 --- a/fs/char_dev.c +++ b/fs/char_dev.c @@ -182,6 +182,28 @@ int alloc_chrdev_region(dev_t *dev, unsigned baseminor, unsigned count, return 0; } +/** + * register_chrdev() - Register a major number for character devices. + * @major: major device number or 0 for dynamic allocation + * @name: name of this range of devices + * @fops: file operations associated with this devices + * + * If @major == 0 this functions will dynamically allocate a major and return + * its number. + * + * If @major > 0 this function will attempt to reserve a device with the given + * major number and will return zero on success. + * + * Returns a -ve errno on failure. + * + * The name of this device has nothing to do with the name of the device in + * /dev. It only helps to keep track of the different owners of devices. If + * your module name has only one type of devices it's ok to use e.g. the name + * of the module here. + * + * This function registers a range of 256 minor numbers. The first minor number + * is 0. + */ int register_chrdev(unsigned int major, const char *name, const struct file_operations *fops) { |