2 Copyright © 1995-2009, The AROS Development Team. All rights reserved.
16 /*****************************************************************************
29 Returns information about a file. Information is stored in stat
30 structure having the following fields:
32 dev_t st_dev; - ID of device containing the file
33 ino_t st_ino; - inode number
34 mode_t st_mode; - protection mode
35 nlink_t st_nlink; - number of hard links
36 uid_t st_uid; - user ID of the file's owner
37 gid_t st_gid; - group ID of the file's group
38 dev_t st_rdev; - device ID (if the file is character
39 or block special file)
40 off_t st_size; - file size, in bytes
41 time_t st_atime; - time of last acces
42 time_t st_mtime; - time of last data modification
43 time_t st_ctime; - time of last file status change
44 blksize_t st_blksize; - optimal blocksize for I/O
45 blkcnt_t st_blocks; - number of blocks allocated for file
48 path - Pathname of the file
49 sb - Pointer to stat structure that will be filled by the stat() call.
52 0 on success and -1 on error. If an error occurred, the global
53 variable errno is set.
65 Value of st_ino field is computed as hash from the canonical path of
68 Values of st_atime, st_mtime and st_ctime fields are always set to
69 the last modification date of the file.
71 There are no special files in AROS, so the st_rdev field is never
74 If the given file cannot be examined because of FSA_EXAMINE not
75 implemented in the handler, stat structure is filled with some
76 default values. It's necessary to allow calling stat() on NIL:.
78 ******************************************************************************/
83 /* check for empty path before potential conversion from "." to "" */
84 if (__doupath
&& path
&& *path
== '\0')
90 path
= __path_u2a(path
);
94 lock
= Lock(path
, SHARED_LOCK
);
97 if (IoErr() == ERROR_OBJECT_IN_USE
)
99 /* the file is already locked exclusively, so the only way to get
100 info about it is to find it in the parent directory with the ExNext() function
104 return __stat_from_path(path
, sb
);
107 errno
= IoErr2errno(IoErr());
111 res
= __stat(lock
, sb
, FALSE
);