WebSVN – HelenOS – Diff – /branches/fs/uspace/fs/path.c

-/* This file contains the procedures that look up path names in the directory
-* system and determine the inode number that goes with a given path name.
-*/
 /*
  * Copyright (c) 1987,1997, Prentice Hall
  * All rights reserved.
+ *
  * Redistribution and use of the MINIX operating system in source and
  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
+/** @addtogroup FileSystemImpl
+* @{
+*/
+/**
-/* Methods:
+ * @file    path.c
- * eat_path:        the 'main' routine of the path-to-inode conversion mechanism
+ * @brief   This file contains the procedures that look up path names in the directory
- * last_dir:        find the final directory on a given path
+ *        system and determine the inode number that goes with a given path name.
- * advance:     parse one component of a path name
- * search_dir:      search a directory for a string and return its inode number
- * search_dir_ex:   used for extended versions
- */
+*/
 #include <string.h>
 #include "fs.h"
 #include "block.h"
 #include "super.h"
 static char *get_name(char *old_name, char *string, int string_length);
+/**
+ * The 'main' routine of the path-to-inode conversion mechanism
+ */
 inode_t *eat_path(char *path)
+{
     /* Parse the path 'path' and put its inode in the inode table. If not possible,
      * return NIL_INODE as function value and an error code in 'err_code'.
     rip = advance(ldip, string, name_len);
     put_inode(ldip);
     return rip;
+}
+/**
+ * Find the final directory on a given path
+ */
 inode_t *last_dir(char *path, char *string, int string_length)
+{
     /* Given a path, 'path', located in the fs address space, parse it as
      * far as the last directory, fetch the inode for the last directory into
         path = new_name;
         rip = new_ip;
+    }
+}
+/**
+ * Parse one component of a path name
+ */
 char *get_name(char *old_name, char *string, int string_length)
+{
     /* Given a pointer to a path name in fs space, 'old_name', copy the next
      * component to 'string' and pad with zeros.  A pointer to that part of
         return((char *) 0);
+    }
     return rnp;
+}
+/**
+ *
+ */
 inode_t *advance(inode_t *dirp, char *string, int string_length)
+{
     /* Given a directory and a component of a path, look up the component in
      * the directory, find the inode, open it, and return a pointer to its inode
         return NIL_INODE;
     return rip;          /* return pointer to inode's component */
+}
+/**
+ * Search a directory for a string and return its inode number
+ */
 int search_dir(register inode_t *ldir_ptr, char string[NAME_MAX], ino_t *numb, int flag)
+{
     /* This function searches the directory whose inode is pointed to by 'ldip':
      * if (flag == LOOK_UP) search for 'string' and return inode # in 'numb';
     /* The whole directory has now been searched. */
     return(flag == IS_EMPTY ? OK : FS_ENOENT);
+}
+/**
+ * Used for extended versions
+ */
 int search_dir_ex(register inode_t *ldir_ptr, char string[NAME_MAX_EX], ino_t *numb, int flag)
+{
     /* Same as above, but for extened directory etries - 30 chars in name of file. */
     /* The whole directory has now been searched. */
     return(flag == IS_EMPTY ? OK : FS_ENOENT);
+}
+/**
+ * }
+ */

Subversion Repositories HelenOS

(root)/branches/fs/uspace/fs/path.c – Rev 2404 → 2435