patch-2.3.99-pre9 linux/fs/devfs/util.c

• Lines: 109
• Date: Sat May 13 08:11:27 2000
• Orig file: v2.3.99-pre8/linux/fs/devfs/util.c
• Orig date: Wed Feb 16 17:03:52 2000

diff -u --recursive --new-file v2.3.99-pre8/linux/fs/devfs/util.c linux/fs/devfs/util.c
@@ -38,13 +38,14 @@
 
 /*  Private functions follow  */
 
+/**
+ *	_devfs_convert_name - Convert from an old style location-based name to new style.
+ *	@new: The new name will be written here.
+ *	@old: The old name.
+ *	@disc: If true, disc partitioning information should be processed.
+ */
+
 static void __init _devfs_convert_name (char *new, const char *old, int disc)
-/*  [SUMMARY] Convert from an old style location-based name to new style.
-    <new> The new name will be written here.
-    <old> The old name.
-    <disc> If true, disc partitioning information should be processed.
-    [RETURNS] Nothing.
-*/
 {
     int host, bus, target, lun;
     char *ptr;
@@ -73,12 +74,12 @@
 
 /*  Public functions follow  */
 
-/*PUBLIC_FUNCTION*/
+/**
+ *	devfs_make_root - Create the root FS device entry if required.
+ *	@name: The name of the root FS device, as passed by "root=".
+ */
+
 void __init devfs_make_root (const char *name)
-/*  [SUMMARY] Create the root FS device entry if required.
-    <name> The name of the root FS device, as passed by "root=".
-    [RETURNS] Nothing.
-*/
 {
     char dest[64];
 
@@ -97,12 +98,13 @@
     devfs_mk_symlink (NULL, name, 0, DEVFS_FL_DEFAULT, dest, 0, NULL,NULL);
 }   /*  End Function devfs_make_root  */
 
-/*PUBLIC_FUNCTION*/
+
+/**
+ *	devfs_register_tape - Register a tape device in the "/dev/tapes" hierarchy.
+ *	@de: Any tape device entry in the device directory.
+ */
+
 void devfs_register_tape (devfs_handle_t de)
-/*  [SUMMARY] Register a tape device in the "/dev/tapes" hierarchy.
-    <de> Any tape device entry in the device directory.
-    [RETURNS] Nothing.
-*/
 {
     int pos;
     devfs_handle_t parent, slave;
@@ -122,30 +124,31 @@
 }   /*  End Function devfs_register_tape  */
 EXPORT_SYMBOL(devfs_register_tape);
 
-/*PUBLIC_FUNCTION*/
+
+/**
+ *	devfs_register_series - Register a sequence of device entries.
+ *	@dir: The handle to the parent devfs directory entry. If this is %NULL the
+ *		new names are relative to the root of the devfs.
+ *	@format: The printf-style format string. A single "\%u" is allowed.
+ *	@flags: A set of bitwise-ORed flags (DEVFS_FL_*).
+ *	@major: The major number. Not needed for regular files.
+ *	@minor_start: The starting minor number. Not needed for regular files.
+ *	@mode: The default file mode.
+ *	@uid: The default UID of the file.
+ *	@guid: The default GID of the file.
+ *	@ops: The &file_operations or &block_device_operations structure.
+ *		This must not be externally deallocated.
+ *	@info: An arbitrary pointer which will be written to the private_data
+ *		field of the &file structure passed to the device driver. You can set
+ *		this to whatever you like, and change it once the file is opened (the next
+ *		file opened will not see this change).
+ */
+
 void devfs_register_series (devfs_handle_t dir, const char *format,
 			    unsigned int num_entries, unsigned int flags,
 			    unsigned int major, unsigned int minor_start,
 			    umode_t mode, uid_t uid, gid_t gid,
 			    void *ops, void *info)
-/*  [SUMMARY] Register a sequence of device entries.
-    <dir> The handle to the parent devfs directory entry. If this is NULL the
-    new names are relative to the root of the devfs.
-    <format> The printf-style format string. A single "%u" is allowed.
-    <flags> A set of bitwise-ORed flags (DEVFS_FL_*).
-    <major> The major number. Not needed for regular files.
-    <minor_start> The starting minor number. Not needed for regular files.
-    <mode> The default file mode.
-    <uid> The default UID of the file.
-    <guid> The default GID of the file.
-    <ops> The <<file_operations>> or <<block_device_operations>> structure.
-    This must not be externally deallocated.
-    <info> An arbitrary pointer which will be written to the <<private_data>>
-    field of the <<file>> structure passed to the device driver. You can set
-    this to whatever you like, and change it once the file is opened (the next
-    file opened will not see this change).
-    [RETURNS] Nothing.
-*/
 {
     unsigned int count;
     char devname[128];