Changeset 980671e7 in mainline

Timestamp:

2011-09-09T18:08:06Z (13 years ago)

Author:

Maurizio Lombardi <m.lombardi85@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

3781092

Parents:

77ec4d9

Message:

Improve comments in mfs_rw.c

File:

• uspace/srv/fs/mfs/mfs_rw.c (modified) (3 diffs)

uspace/srv/fs/mfs/mfs_rw.c

@@ -53 +53 @@
  *bytes, this function returns the on-disk block
  *relative to that position.
- *Returns zero if the block does not exist.
+ *
+ * @param b     Pointer to a 32bit number where the block number will be stored
+ * @param mnode Pointer to a generic MINIX inode in memory.
+ * @param pos   Position in file.
+ *
+ * @return      EOK on success or a negative error code.
  */
 int
@@ -227 +232 @@
 }
 
-/*Free unused indirect zones*/
+/**Free unused indirect zones from a MINIX inode according to it's new size.
+ *
+ * @param mnode         Pointer to a generic MINIX inode in memory.
+ * @param new_size      The new size of the inode.
+ *
+ * @return              EOK on success or a negative error code.
+ */
 int
 mfs_prune_ind_zones(struct mfs_node *mnode, size_t new_size)
@@ -239 +250 @@
         mfs_version_t fs_version = sbi->fs_version;
         
+        assert(new_size <= ino_i->i_size);
+
         if (fs_version == MFS_VERSION_V1) {
                 nr_direct = V1_NR_DIRECT_ZONES;