Changeset 2add9ec in mainline for uspace/lib/ext4/libext4_inode.c

Timestamp:

2012-05-06T08:15:01Z (12 years ago)

Author:

Frantisek Princ <frantisek.princ@…>

Branches:

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

Children:

3169f3b0

Parents:

2226cc3

Message:

some i-node comments

File:

• uspace/lib/ext4/libext4_inode.c (modified) (9 diffs)

uspace/lib/ext4/libext4_inode.c

@@ -136 +136 @@
 }
 
+/** Get time, when i-node was last accessed.
+ *
+ * @param inode         i-node
+ * @return                      time of the last access (POSIX)
+ */
 uint32_t ext4_inode_get_access_time(ext4_inode_t *inode)
 {
@@ -141 +146 @@
 }
 
-/** TODO comment
- *
+/** Set time, when i-node was last accessed.
+ *
+ * @param inode         i-node
+ * @param time          time of the last access (POSIX)
  */
 void ext4_inode_set_access_time(ext4_inode_t *inode, uint32_t time)
@@ -237 +244 @@
 }
 
-/** TODO comment
- *
+/** Get number of 512-bytes blocks used for i-node.
+ *
+ * @param sb            superblock
+ * @param inode         i-node
+ * @return                      number of 512-bytes blocks
  */
 uint64_t ext4_inode_get_blocks_count(ext4_superblock_t *sb, ext4_inode_t *inode)
@@ -258 +268 @@
                 return uint32_t_le2host(inode->blocks_count_lo);
     }
-
-}
-
-
-/** TODO comment
- *
+}
+
+/** Set number of 512-bytes blocks used for i-node.
+ *
+ * @param sb            superblock
+ * @param inode         i-node
+ * @param count         number of 512-bytes blocks
+ * @return                      error code
  */
 int ext4_inode_set_blocks_count(ext4_superblock_t *sb, ext4_inode_t *inode,
@@ -279 +291 @@
     }
 
+    // Check if there can be used huge files (many blocks)
     if (!ext4_superblock_has_feature_read_only(sb, EXT4_FEATURE_RO_COMPAT_HUGE_FILE)) {
         return EINVAL;
@@ -320 +333 @@
 }
 
-/** TODO comment
- *
+/** Get file generation (used by NFS).
+ *
+ * @param inode         i-node
+ * @return                      file generation
  */
 uint32_t ext4_inode_get_generation(ext4_inode_t *inode)
@@ -328 +343 @@
 }
 
-/** TODO comment
- *
+/** Set file generation (used by NFS).
+ *
+ * @param inode                 i-node
+ * @param generation    file generation
  */
 void ext4_inode_set_generation(ext4_inode_t *inode, uint32_t generation)
@@ -336 +353 @@
 }
 
-/** TODO comment
- *
+/** Get address of block, where are extended attributes located.
+ *
+ * @param inode                 i-node
+ * @param sb                    superblock
+ * @return                              block address
  */
 uint64_t ext4_inode_get_file_acl(ext4_inode_t *inode, ext4_superblock_t *sb)
@@ -349 +369 @@
 }
 
-/** TODO comment
- *
+/** Set address of block, where are extended attributes located.
+ *
+ * @param inode                 i-node
+ * @param sb                    superblock
+ * @param file_acl              block address
  */
 void ext4_inode_set_file_acl(ext4_inode_t *inode, ext4_superblock_t *sb,