Changes by: flatcap
Update of /cvsroot/linux-ntfs/ntfsprogs/libntfs
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24966/libntfs
Modified Files:
attrib.c bitmap.c collate.c compat.c dir.c index.c inode.c
mft.c rich.c runlist.c tree.c unistr.c unix_io.c volume.c
Log Message:
provide some meaningful function descriptions
Index: attrib.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/attrib.c,v
retrieving revision 1.191
retrieving revision 1.192
diff -u -p -r1.191 -r1.192
--- attrib.c 30 Oct 2005 16:12:22 -0000 1.191
+++ attrib.c 2 Nov 2005 17:34:08 -0000 1.192
@@ -59,7 +59,7 @@
ntfschar AT_UNNAMED[] = { const_cpu_to_le16('\0') };
/**
- * ntfs_get_attribute_value_length -
+ * ntfs_get_attribute_value_length - Find the length of an attribute
* @a:
*
* Description...
@@ -82,7 +82,7 @@ s64 ntfs_get_attribute_value_length(cons
}
/**
- * ntfs_get_attribute_value -
+ * ntfs_get_attribute_value - Get a copy of an attribute
* @vol:
* @a:
* @b:
@@ -2967,7 +2967,7 @@ int ntfs_attr_add(ntfs_inode *ni, ATTR_T
/* @val is mandatory. */
if (!val) {
ntfs_log_trace("val is mandatory for always resident "
- "atributes.\n");
+ "attributes.\n");
errno = EINVAL;
return -1;
}
Index: bitmap.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/bitmap.c,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -p -r1.17 -r1.18
--- bitmap.c 30 Oct 2005 16:12:23 -0000 1.17
+++ bitmap.c 2 Nov 2005 17:34:08 -0000 1.18
@@ -228,7 +228,7 @@ int ntfs_bitmap_clear_run(ntfs_attr *na,
#include "rich.h"
/**
- * ntfs_bmp_rollback -
+ * ntfs_bmp_rollback - Discard the in-memory bitmap changes
* @bmp:
*
* Description...
@@ -257,7 +257,7 @@ int ntfs_bmp_rollback(struct ntfs_bmp *b
}
/**
- * ntfs_bmp_commit -
+ * ntfs_bmp_commit - Write the cached bitmap data to disk
* @bmp:
*
* Description...
@@ -311,7 +311,7 @@ int ntfs_bmp_commit(struct ntfs_bmp *bmp
}
/**
- * ntfs_bmp_free -
+ * ntfs_bmp_free - Destroy a bitmap object
* @bmp:
*
* Description...
@@ -332,7 +332,7 @@ void ntfs_bmp_free(struct ntfs_bmp *bmp)
}
/**
- * ntfs_bmp_create -
+ * ntfs_bmp_create - Create a representation of a bitmap
* @inode:
* @type:
* @name:
@@ -372,7 +372,7 @@ struct ntfs_bmp * ntfs_bmp_create(ntfs_i
}
/**
- * ntfs_bmp_add_data -
+ * ntfs_bmp_add_data - Add a bitmap block to the current cache
* @bmp:
* @vcn:
* @data:
@@ -416,7 +416,7 @@ int ntfs_bmp_add_data(struct ntfs_bmp *b
}
/**
- * ntfs_bmp_get_data -
+ * ntfs_bmp_get_data - Ask for a bitmap block from the cache
* @bmp:
* @vcn:
*
@@ -466,7 +466,7 @@ u8 * ntfs_bmp_get_data(struct ntfs_bmp *
}
/**
- * ntfs_bmp_set_range -
+ * ntfs_bmp_set_range - Set a range of bits in the bitmap
* @bmp:
* @vcn:
* @length:
@@ -563,7 +563,7 @@ int ntfs_bmp_set_range(struct ntfs_bmp *
}
/**
- * ntfs_bmp_find_last_set -
+ * ntfs_bmp_find_last_set - Find the last set bit in the bitmap
* @bmp:
*
* Description...
@@ -632,7 +632,7 @@ s64 ntfs_bmp_find_last_set(struct ntfs_b
}
/**
- * ntfs_bmp_find_space -
+ * ntfs_bmp_find_space - Find an unused block of bits in a bitmap
* @bmp:
* @start:
* @size:
Index: collate.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/collate.c,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -p -r1.12 -r1.13
--- collate.c 30 Oct 2005 16:12:23 -0000 1.12
+++ collate.c 2 Nov 2005 17:34:08 -0000 1.13
@@ -34,7 +34,7 @@
#include "logging.h"
/**
- * ntfs_collate_binary -
+ * ntfs_collate_binary - Which of two binary objects should be listed first
* @vol: unused
* @data1:
* @data1_len:
@@ -64,7 +64,7 @@ static int ntfs_collate_binary(ntfs_volu
}
/**
- * ntfs_collate_ntofs_ulong -
+ * ntfs_collate_ntofs_ulong - Which of two long ints should be listed first
* @vol: unused
* @data1:
* @data1_len:
@@ -102,7 +102,7 @@ static int ntfs_collate_ntofs_ulong(ntfs
}
/**
- * ntfs_collate_file_name -
+ * ntfs_collate_file_name - Which of two filenames should be listed first
* @vol:
* @data1:
* @data1_len: unused
Index: compat.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/compat.c,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -p -r1.9 -r1.10
--- compat.c 30 Oct 2005 16:12:23 -0000 1.9
+++ compat.c 2 Nov 2005 17:34:08 -0000 1.10
@@ -32,7 +32,7 @@
#ifndef HAVE_FFS
/**
- * ffs -
+ * ffs - Find the first set bit in an int
* @x:
*
* Description...
Index: dir.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/dir.c,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -p -r1.37 -r1.38
--- dir.c 31 Oct 2005 01:15:12 -0000 1.37
+++ dir.c 2 Nov 2005 17:34:08 -0000 1.38
@@ -1358,7 +1358,7 @@ search:
/*
* If hard link count is not equal to zero then we are done. In other
* case there are no reference to this inode left, so we should free all
- * non-resident atributes and mark inode as not in use.
+ * non-resident attributes and mark inode as not in use.
*/
if (ni->mrec->link_count)
goto out;
@@ -1372,13 +1372,13 @@ search:
if (!rl) {
err = errno;
ntfs_log_error("Failed to decompress runlist. "
- "Leaving inconsist metadata.");
+ "Leaving inconsistent metadata.");
continue;
}
if (ntfs_cluster_free_from_rl(ni->vol, rl)) {
err = errno;
ntfs_log_error("Failed to free clusters. "
- "Leaving inconsist metadata.");
+ "Leaving inconsistent metadata.");
continue;
}
free(rl);
@@ -1522,7 +1522,7 @@ err_out:
#include "rich.h"
/**
- * ntfs_dir_rollback -
+ * ntfs_dir_rollback - Discard the in-memory directory changes
* @dir:
*
* Description...
@@ -1554,7 +1554,7 @@ int ntfs_dir_rollback(struct ntfs_dir *d
}
/**
- * ntfs_dir_truncate -
+ * ntfs_dir_truncate - Shrink an index allocation
* @vol:
* @dir:
*
@@ -1707,7 +1707,7 @@ int ntfs_dir_truncate(ntfs_volume *vol,
}
/**
- * ntfs_dir_commit -
+ * ntfs_dir_commit - Write to disk the in-memory directory changes
* @dir:
*
* Description...
@@ -1744,7 +1744,7 @@ int ntfs_dir_commit(struct ntfs_dir *dir
}
/**
- * ntfs_dir_free -
+ * ntfs_dir_free - Destroy a directory object
* @dir:
*
* Description...
@@ -1789,7 +1789,7 @@ void ntfs_dir_free(struct ntfs_dir *dir)
}
/**
- * ntfs_dir_create -
+ * ntfs_dir_create - Create a representation of a directory
* @vol:
* @mft_num:
*
@@ -1863,7 +1863,7 @@ struct ntfs_dir * ntfs_dir_create(ntfs_v
}
/**
- * ntfs_dir_add -
+ * ntfs_dir_add - Add a directory to another as a child
* @parent:
* @child:
*
@@ -1890,7 +1890,7 @@ void ntfs_dir_add(struct ntfs_dir *paren
}
/**
- * ntfs_dir_find2 -
+ * ntfs_dir_find2 - Find a directory by name
* @dir:
* @name:
* @name_len:
Index: index.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/index.c,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -p -r1.21 -r1.22
--- index.c 30 Oct 2005 16:12:23 -0000 1.21
+++ index.c 2 Nov 2005 17:34:08 -0000 1.22
@@ -662,7 +662,7 @@ err_out:
#include "rich.h"
/**
- * ntfs_ie_free -
+ * ntfs_ie_free - Destroy an index entry object
* @ie:
*
* Description...
@@ -676,7 +676,7 @@ void ntfs_ie_free(INDEX_ENTRY *ie)
}
/**
- * ntfs_ie_create -
+ * ntfs_ie_create - Create a representation of an directory index entry
*
* Description...
*
@@ -702,7 +702,7 @@ INDEX_ENTRY * ntfs_ie_create(void)
}
/**
- * ntfs_ie_get_vcn -
+ * ntfs_ie_get_vcn - Get the VCN associated with an index entry
* @ie:
*
* Description...
@@ -721,7 +721,7 @@ VCN ntfs_ie_get_vcn(INDEX_ENTRY *ie)
}
/**
- * ntfs_ie_copy -
+ * ntfs_ie_copy - Create a copy of an index entry
* @ie:
*
* Description...
@@ -745,7 +745,7 @@ INDEX_ENTRY * ntfs_ie_copy(INDEX_ENTRY *
}
/**
- * ntfs_ie_set_vcn -
+ * ntfs_ie_set_vcn - Set VCN associated with an index entry
* @ie:
* @vcn:
*
@@ -773,7 +773,7 @@ INDEX_ENTRY * ntfs_ie_set_vcn(INDEX_ENTR
}
/**
- * ntfs_ie_remove_vcn -
+ * ntfs_ie_remove_vcn - Remove the VCN associated with an index entry
* @ie:
*
* Description...
@@ -795,7 +795,7 @@ INDEX_ENTRY * ntfs_ie_remove_vcn(INDEX_E
}
/**
- * ntfs_ie_set_name -
+ * ntfs_ie_set_name - Associate a name with an index entry
* @ie:
* @name:
* @namelen:
@@ -891,7 +891,7 @@ INDEX_ENTRY * ntfs_ie_set_name(INDEX_ENT
}
/**
- * ntfs_ie_remove_name -
+ * ntfs_ie_remove_name - Remove the name from an index-entry
* @ie:
*
* Description...
Index: inode.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/inode.c,v
retrieving revision 1.74
retrieving revision 1.75
diff -u -p -r1.74 -r1.75
--- inode.c 30 Oct 2005 16:12:23 -0000 1.74
+++ inode.c 2 Nov 2005 17:34:08 -0000 1.75
@@ -50,7 +50,7 @@
#include "logging.h"
/**
- * __ntfs_inode_allocate -
+ * __ntfs_inode_allocate - Create and initialise an NTFS inode object
* @vol:
*
* Description...
@@ -68,7 +68,7 @@ static __inline__ ntfs_inode *__ntfs_ino
}
/**
- * ntfs_inode_allocate -
+ * ntfs_inode_allocate - Create an NTFS inode object
* @vol:
*
* Description...
@@ -81,7 +81,7 @@ ntfs_inode *ntfs_inode_allocate(ntfs_vol
}
/**
- * __ntfs_inode_release -
+ * __ntfs_inode_release - Destroy an NTFS inode object
* @ni:
*
* Description...
@@ -1073,7 +1073,7 @@ put_err_out:
#include "rich.h"
/**
- * ntfs_inode_close2 -
+ * ntfs_inode_close2 - Close an inode, freeing any resources
* @ni:
*
* Description...
@@ -1101,7 +1101,7 @@ int ntfs_inode_close2(ntfs_inode *ni)
}
/**
- * ntfs_inode_open2 -
+ * ntfs_inode_open2 - Open an inode and initialise it
* @vol:
* @mref:
*
@@ -1156,7 +1156,7 @@ ntfs_inode * ntfs_inode_open2(ntfs_volum
}
/**
- * ntfs_inode_open3 -
+ * ntfs_inode_open3 - Open an inode and initialise it
* @vol:
* @mref:
*
Index: mft.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/mft.c,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -p -r1.40 -r1.41
--- mft.c 30 Oct 2005 16:12:23 -0000 1.40
+++ mft.c 2 Nov 2005 17:34:08 -0000 1.41
@@ -392,7 +392,7 @@ static const char *es = " Leaving incon
#endif
/**
- * ntfs_ffz -
+ * ntfs_ffz - Find the first unset (zero) bit in a word
* @word:
*
* Description...
@@ -1566,7 +1566,7 @@ sync_rollback:
#include "rich.h"
/**
- * ntfs_mft_remove_attr -
+ * ntfs_mft_remove_attr - Remove an attribute from an MFT record
* @bmp:
* @inode:
* @type:
@@ -1632,7 +1632,7 @@ int ntfs_mft_remove_attr(struct ntfs_bmp
}
/**
- * ntfs_mft_add_attr -
+ * ntfs_mft_add_attr - Add an attribute to an MFT record
* @inode:
* @type:
* @data:
@@ -1710,7 +1710,7 @@ ATTR_RECORD * ntfs_mft_add_attr(ntfs_ino
}
/**
- * ntfs_mft_resize_resident -
+ * ntfs_mft_resize_resident - Resize a resident attribute in an MFT record
* @inode:
* @type:
* @name:
@@ -1819,7 +1819,7 @@ done:
}
/**
- * ntfs_mft_free_space -
+ * ntfs_mft_free_space - Calculate the free space (bytes) in an MFT record
* @dir:
*
* Description...
@@ -1843,7 +1843,7 @@ int ntfs_mft_free_space(struct ntfs_dir
}
/**
- * ntfs_mft_add_index -
+ * ntfs_mft_add_index - Add an index (directory) to an MFT record
* @dir:
*
* Description...
Index: rich.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/rich.c,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -p -r1.5 -r1.6
--- rich.c 30 Oct 2005 16:12:23 -0000 1.5
+++ rich.c 2 Nov 2005 17:34:08 -0000 1.6
@@ -112,7 +112,7 @@ ATTR_RECORD * find_first_attribute(const
}
/**
- * ntfs_name_print -
+ * ntfs_name_print - Send a Unicode name to the debug log
* @name:
* @name_len:
*
@@ -134,7 +134,7 @@ void ntfs_name_print(ntfschar *name, int
}
/**
- * utils_free_non_residents3 -
+ * utils_free_non_residents3 - Free all the non-resident attributes of an inode
* @bmp:
* @inode:
* @attr:
@@ -178,7 +178,7 @@ int utils_free_non_residents3(struct ntf
}
/**
- * utils_free_non_residents2 -
+ * utils_free_non_residents2 - Find all the non-resident attributes of an inode
* @inode:
* @bmp:
*
Index: runlist.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/runlist.c,v
retrieving revision 1.65
retrieving revision 1.66
diff -u -p -r1.65 -r1.66
--- runlist.c 31 Oct 2005 01:15:12 -0000 1.65
+++ runlist.c 2 Nov 2005 17:34:08 -0000 1.66
@@ -1718,7 +1718,7 @@ s64 ntfs_rl_get_compressed_size(ntfs_vol
}
*/
/**
- * test_rl_dump_runlist -
+ * test_rl_dump_runlist - Runlist test: Display the contents of a runlist
* @rl:
*
* Description...
@@ -1770,7 +1770,7 @@ static void test_rl_dump_runlist(const r
}
/**
- * test_rl_runlists_merge -
+ * test_rl_runlists_merge - Runlist test: Merge two runlists
* @drl:
* @srl:
*
@@ -1796,7 +1796,7 @@ static runlist_element * test_rl_runlist
}
/**
- * test_rl_read_buffer -
+ * test_rl_read_buffer - Runlist test: Read a file containing a runlist
* @file:
* @buf:
* @bufsize:
@@ -1825,7 +1825,7 @@ static int test_rl_read_buffer(const cha
}
/**
- * test_rl_pure_src -
+ * test_rl_pure_src - Runlist test: Complicate the simple tests a little
* @contig:
* @multi:
* @vcn:
@@ -1860,7 +1860,7 @@ static runlist_element * test_rl_pure_sr
}
/**
- * test_rl_pure_test -
+ * test_rl_pure_test - Runlist test: Perform tests using simple runlists
* @test:
* @contig:
* @multi:
@@ -1891,7 +1891,7 @@ static void test_rl_pure_test(int test,
}
/**
- * test_rl_pure -
+ * test_rl_pure - Runlist test: Create tests using simple runlists
* @contig:
* @multi:
*
@@ -1991,7 +1991,7 @@ static void test_rl_pure(char *contig, c
}
/**
- * test_rl_zero -
+ * test_rl_zero - Runlist test: Merge a zero-length runlist
*
* Description...
*
@@ -2017,7 +2017,7 @@ static void test_rl_zero(void)
}
/**
- * test_rl_frag_combine -
+ * test_rl_frag_combine - Runlist test: Perform tests using fragmented files
* @vol:
* @attr1:
* @attr2:
@@ -2053,7 +2053,7 @@ static void test_rl_frag_combine(ntfs_vo
}
/**
- * test_rl_frag -
+ * test_rl_frag - Runlist test: Create tests using very fragmented files
* @test:
*
* Description...
@@ -2098,7 +2098,7 @@ out:
}
/**
- * test_rl_main -
+ * test_rl_main - Runlist test: Program start (main)
* @argc:
* @argv:
*
Index: tree.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/tree.c,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -p -r1.8 -r1.9
--- tree.c 30 Oct 2005 16:12:23 -0000 1.8
+++ tree.c 2 Nov 2005 17:34:08 -0000 1.9
@@ -42,7 +42,7 @@
#include "rich.h"
/**
- * ntfs_dt_free -
+ * ntfs_dt_free - Destroy a directory-tree object
* @dt:
*
* Description...
@@ -71,7 +71,7 @@ void ntfs_dt_free(struct ntfs_dt *dt)
}
/**
- * ntfs_dt_rollback -
+ * ntfs_dt_rollback - Discard the in-memory directory-tree changes
* @dt:
*
* Description...
@@ -123,7 +123,7 @@ int ntfs_dt_rollback(struct ntfs_dt *dt)
}
/**
- * ntfs_dt_commit -
+ * ntfs_dt_commit - Write to disk the in-memory directory-tree changes
* @dt:
*
* Description...
@@ -186,7 +186,7 @@ int ntfs_dt_commit(struct ntfs_dt *dt)
}
/**
- * ntfs_dt_create_children2 -
+ * ntfs_dt_create_children2 - Allocate space for the directory-tree's children
* @dt:
* @count:
*
@@ -220,7 +220,7 @@ BOOL ntfs_dt_create_children2(struct ntf
}
/**
- * ntfs_dt_resize_children3 -
+ * ntfs_dt_resize_children3 - Resize a directory-tree's children arrays
* @dt:
* @new:
*
@@ -266,7 +266,7 @@ BOOL ntfs_dt_resize_children3(struct ntf
}
/**
- * ntfs_dt_root_count -
+ * ntfs_dt_root_count - Count the index entries in an index root
* @dt:
*
* Description...
@@ -334,7 +334,7 @@ int ntfs_dt_root_count(struct ntfs_dt *d
}
/**
- * ntfs_dt_alloc_count -
+ * ntfs_dt_alloc_count - Count the index entries in an index allocation
* @dt:
*
* Description...
@@ -398,7 +398,7 @@ int ntfs_dt_alloc_count(struct ntfs_dt *
}
/**
- * ntfs_dt_initialise2 -
+ * ntfs_dt_initialise2 - Setup a directory-tree object
* @vol:
* @dt:
*
@@ -447,7 +447,7 @@ int ntfs_dt_initialise2(ntfs_volume *vol
}
/**
- * ntfs_dt_create -
+ * ntfs_dt_create - Create a representation of a directory index
* @dir:
* @parent:
* @vcn:
@@ -554,7 +554,7 @@ struct ntfs_dt * ntfs_dt_create(struct n
}
/**
- * ntfs_dt_find -
+ * ntfs_dt_find - Find an index entry by name
* @dt:
* @name:
* @name_len:
@@ -634,7 +634,7 @@ MFT_REF ntfs_dt_find(struct ntfs_dt *dt,
}
/**
- * ntfs_dt_find2 -
+ * ntfs_dt_find2 - Find an index entry by name
* @dt:
* @name:
* @name_len:
@@ -718,7 +718,7 @@ struct ntfs_dt * ntfs_dt_find2(struct nt
}
/**
- * ntfs_dt_find3 -
+ * ntfs_dt_find3 - Find an index entry by name
* @dt:
* @name:
* @name_len:
@@ -784,7 +784,7 @@ struct ntfs_dt * ntfs_dt_find3(struct nt
}
/**
- * ntfs_dt_find4 -
+ * ntfs_dt_find4 - Find an index entry by name
* @dt:
* @name:
* @name_len:
@@ -858,7 +858,7 @@ struct ntfs_dt * ntfs_dt_find4(struct nt
}
/**
- * ntfs_dt_find_all -
+ * ntfs_dt_find_all - Recurse the directory-tree, mapping all elements
* @dt:
*
* maps all dt's into memory
@@ -887,7 +887,7 @@ void ntfs_dt_find_all(struct ntfs_dt *dt
}
/**
- * ntfs_dt_find_parent -
+ * ntfs_dt_find_parent - Find the index of ourself in the parent's array
* @dt:
*
* Description...
@@ -915,7 +915,7 @@ int ntfs_dt_find_parent(struct ntfs_dt *
}
/**
- * ntfs_dt_isroot -
+ * ntfs_dt_isroot - Does this directory-tree represent an index root
* @dt:
*
* Description...
@@ -931,7 +931,7 @@ BOOL ntfs_dt_isroot(struct ntfs_dt *dt)
}
/**
- * ntfs_dt_root_freespace -
+ * ntfs_dt_root_freespace - Give the free space (bytes) in an index root
* @dt:
*
* Description...
@@ -957,7 +957,7 @@ int ntfs_dt_root_freespace(struct ntfs_d
}
/**
- * ntfs_dt_alloc_freespace -
+ * ntfs_dt_alloc_freespace - Give the free space (bytes) in an index allocation
* @dt:
*
* Description...
@@ -983,7 +983,7 @@ int ntfs_dt_alloc_freespace(struct ntfs_
}
/**
- * ntfs_dt_transfer -
+ * ntfs_dt_transfer - Transfer several index entries between directory-trees
* @old:
* @new:
* @start:
@@ -1141,7 +1141,7 @@ int ntfs_dt_transfer(struct ntfs_dt *old
}
/**
- * ntfs_dt_alloc_insert -
+ * ntfs_dt_alloc_insert - Insert an index entry into an index allocation
* @dt:
* @first:
* @count:
@@ -1212,7 +1212,7 @@ int ntfs_dt_alloc_insert(struct ntfs_dt
}
/**
- * ntfs_dt_alloc_insert2 -
+ * ntfs_dt_alloc_insert2 - Insert an index entry into an index allocation
* @dt:
* @before:
* @count:
@@ -1287,7 +1287,7 @@ INDEX_ENTRY * ntfs_dt_alloc_insert2(stru
}
/**
- * ntfs_dt_root_insert -
+ * ntfs_dt_root_insert - Insert an index entry into an index root
* @dt:
* @first:
* @count:
@@ -1308,7 +1308,7 @@ int ntfs_dt_root_insert(struct ntfs_dt *
}
/**
- * ntfs_dt_alloc_remove2 -
+ * ntfs_dt_alloc_remove2 - Remove an index entry from an index allocation
* @dt:
* @start:
* @count:
@@ -1335,7 +1335,7 @@ int ntfs_dt_alloc_remove2(struct ntfs_dt
}
/**
- * ntfs_dt_root_remove2 -
+ * ntfs_dt_root_remove2 - Remove an index entry from an index root
* @dt:
* @start:
* @count:
@@ -1384,7 +1384,7 @@ int ntfs_dt_root_remove2(struct ntfs_dt
}
/**
- * ntfs_dt_transfer2 -
+ * ntfs_dt_transfer2 - Transfer several index entries between directory-trees
* @old:
* @new:
* @start:
@@ -1553,7 +1553,7 @@ int ntfs_dt_transfer2(struct ntfs_dt *ol
}
/**
- * ntfs_dt_root_replace -
+ * ntfs_dt_root_replace - Replace an index entry in an index root
* @del:
* @del_num:
* @del_ie:
@@ -1641,7 +1641,7 @@ int ntfs_dt_root_replace(struct ntfs_dt
}
/**
- * ntfs_dt_alloc_replace -
+ * ntfs_dt_alloc_replace - Replace an index entry in an index allocation
* @del:
* @del_num:
* @del_ie:
@@ -1712,7 +1712,7 @@ BOOL ntfs_dt_alloc_replace(struct ntfs_d
}
/**
- * ntfs_dt_root_remove -
+ * ntfs_dt_root_remove - Remove an index entry from an index root
* @del:
* @del_num:
*
@@ -1840,7 +1840,7 @@ BOOL ntfs_dt_root_remove(struct ntfs_dt
}
/**
- * ntfs_dt_alloc_remove -
+ * ntfs_dt_alloc_remove - Remove an index entry from an index allocation
* @del:
* @del_num:
*
@@ -1969,7 +1969,7 @@ BOOL ntfs_dt_alloc_remove(struct ntfs_dt
}
/**
- * ntfs_dt_alloc_add -
+ * ntfs_dt_alloc_add - Add an index entry to an index allocation
* @parent:
* @index_num:
* @ie:
@@ -2066,7 +2066,7 @@ int ntfs_dt_alloc_add(struct ntfs_dt *pa
}
/**
- * ntfs_dt_root_add -
+ * ntfs_dt_root_add - Add an index entry to an index root
* @parent:
* @index_num:
* @ie:
@@ -2177,7 +2177,7 @@ int ntfs_dt_root_add(struct ntfs_dt *par
}
/**
- * ntfs_dt_add2 -
+ * ntfs_dt_add2 - Add an index entry to a directory-tree
* @ie:
* @suc:
* @suc_num:
Index: unistr.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/unistr.c,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -p -r1.32 -r1.33
--- unistr.c 30 Oct 2005 16:12:23 -0000 1.32
+++ unistr.c 2 Nov 2005 17:34:08 -0000 1.33
@@ -307,7 +307,7 @@ ntfschar *ntfs_ucsndup(const ntfschar *s
}
/**
- * ntfs_name_upcase -
+ * ntfs_name_upcase - Map an Unicode name to its uppercase equivalent
* @name:
* @name_len:
* @upcase:
@@ -329,7 +329,7 @@ void ntfs_name_upcase(ntfschar *name, u3
}
/**
- * ntfs_file_value_upcase -
+ * ntfs_file_value_upcase - Convert a filename to upper case
* @file_name_attr:
* @upcase:
* @upcase_len:
@@ -346,7 +346,7 @@ void ntfs_file_value_upcase(FILE_NAME_AT
}
/**
- * ntfs_file_values_compare -
+ * ntfs_file_values_compare - Which of two filenames should be listed first
* @file_name_attr1:
* @file_name_attr2:
* @err_val:
Index: unix_io.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/unix_io.c,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -p -r1.7 -r1.8
--- unix_io.c 30 Oct 2005 16:12:23 -0000 1.7
+++ unix_io.c 2 Nov 2005 17:34:08 -0000 1.8
@@ -67,7 +67,7 @@
#define DEV_FD(dev) (*(int *)dev->d_private)
/**
- * ntfs_device_unix_io_open -
+ * ntfs_device_unix_io_open - Open a device and lock it exclusively
* @dev:
* @flags:
*
@@ -122,7 +122,7 @@ err_out:
}
/**
- * ntfs_device_unix_io_close -
+ * ntfs_device_unix_io_close - Close the device, releasing the lock
* @dev:
*
* Description...
@@ -157,7 +157,7 @@ static int ntfs_device_unix_io_close(str
}
/**
- * ntfs_device_unix_io_seek -
+ * ntfs_device_unix_io_seek - Seek to a place on the device
* @dev:
* @offset:
* @whence:
@@ -173,7 +173,7 @@ static s64 ntfs_device_unix_io_seek(stru
}
/**
- * ntfs_device_unix_io_read -
+ * ntfs_device_unix_io_read - Read from the device, from the current location
* @dev:
* @buf:
* @count:
@@ -189,7 +189,7 @@ static s64 ntfs_device_unix_io_read(stru
}
/**
- * ntfs_device_unix_io_write -
+ * ntfs_device_unix_io_write - Write to the device, at the current location
* @dev:
* @buf:
* @count:
@@ -210,7 +210,7 @@ static s64 ntfs_device_unix_io_write(str
}
/**
- * ntfs_device_unix_io_pread -
+ * ntfs_device_unix_io_pread - Perform a positioned read from the device
* @dev:
* @buf:
* @count:
@@ -227,7 +227,7 @@ static s64 ntfs_device_unix_io_pread(str
}
/**
- * ntfs_device_unix_io_pwrite -
+ * ntfs_device_unix_io_pwrite - Perform a positioned write to the device
* @dev:
* @buf:
* @count:
@@ -249,7 +249,7 @@ static s64 ntfs_device_unix_io_pwrite(st
}
/**
- * ntfs_device_unix_io_sync -
+ * ntfs_device_unix_io_sync - Flush any buffered changes to the device
* @dev:
*
* Description...
@@ -268,7 +268,7 @@ static int ntfs_device_unix_io_sync(stru
}
/**
- * ntfs_device_unix_io_stat -
+ * ntfs_device_unix_io_stat - Get information about the device
* @dev:
* @buf:
*
@@ -282,7 +282,7 @@ static int ntfs_device_unix_io_stat(stru
}
/**
- * ntfs_device_unix_io_ioctl -
+ * ntfs_device_unix_io_ioctl - Perform an ioctl on the device
* @dev:
* @request:
* @argp:
Index: volume.c
===================================================================
RCS file: /cvsroot/linux-ntfs/ntfsprogs/libntfs/volume.c,v
retrieving revision 1.62
retrieving revision 1.63
diff -u -p -r1.62 -r1.63
--- volume.c 30 Oct 2005 16:12:23 -0000 1.62
+++ volume.c 2 Nov 2005 17:34:08 -0000 1.63
@@ -67,7 +67,7 @@
#endif
/**
- * ntfs_volume_alloc -
+ * ntfs_volume_alloc - Create an NTFS volume object and initialise it
*
* Description...
*
@@ -95,7 +95,7 @@ ntfs_volume *ntfs_volume_alloc(void)
}
/**
- * __ntfs_volume_release -
+ * __ntfs_volume_release - Destroy an NTFS volume object
* @v:
*
* Description...
@@ -1606,7 +1606,7 @@ int utils_valid_device(const char *name,
}
/**
- * utils_mount_volume -
+ * utils_mount_volume - Mount an NTFS volume
* @device:
* @flags:
* @force:
@@ -1660,7 +1660,7 @@ ntfs_volume * utils_mount_volume(const c
}
/**
- * ntfs_volume_commit -
+ * ntfs_volume_commit - Write to disk the in-memory volume changes
* @vol:
*
* Description...
@@ -1687,7 +1687,7 @@ int ntfs_volume_commit(ntfs_volume *vol)
}
/**
- * ntfs_volume_rollback -
+ * ntfs_volume_rollback - Discard the in-memory volume changes
* @vol:
*
* Description...
@@ -1713,7 +1713,7 @@ int ntfs_volume_rollback(ntfs_volume *vo
}
/**
- * ntfs_volume_umount2 -
+ * ntfs_volume_umount2 - Unmount an NTFS volume, using the new directory support
* @vol:
* @force:
*
@@ -1748,7 +1748,7 @@ int ntfs_volume_umount2(ntfs_volume *vol
}
/**
- * ntfs_volume_mount2 -
+ * ntfs_volume_mount2 - Mount an NTFS volume, using the new directory support
* @device:
* @flags:
* @force:
|