|
2926
|
1 /* |
|
|
2 |
|
|
3 Copyright (C) 1996, 1997 John W. Eaton |
|
|
4 |
|
|
5 This file is part of Octave. |
|
|
6 |
|
|
7 Octave is free software; you can redistribute it and/or modify it |
|
|
8 under the terms of the GNU General Public License as published by the |
|
7016
|
9 Free Software Foundation; either version 3 of the License, or (at your |
|
|
10 option) any later version. |
|
2926
|
11 |
|
|
12 Octave is distributed in the hope that it will be useful, but WITHOUT |
|
|
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
|
|
14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
|
|
15 for more details. |
|
|
16 |
|
|
17 You should have received a copy of the GNU General Public License |
|
7016
|
18 along with Octave; see the file COPYING. If not, see |
|
|
19 <http://www.gnu.org/licenses/>. |
|
2926
|
20 |
|
|
21 */ |
|
|
22 |
|
|
23 #if !defined (octave_file_stat_h) |
|
|
24 #define octave_file_stat_h 1 |
|
|
25 |
|
|
26 #include <string> |
|
|
27 |
|
3260
|
28 #include "oct-time.h" |
|
|
29 |
|
2926
|
30 #ifdef HAVE_SYS_TYPES_H |
|
|
31 #include <sys/types.h> |
|
|
32 #endif |
|
|
33 |
|
|
34 class |
|
6108
|
35 OCTAVE_API |
|
2926
|
36 file_stat |
|
|
37 { |
|
|
38 public: |
|
|
39 |
|
3504
|
40 file_stat (const std::string& n = std::string (), bool fl = true) |
|
2926
|
41 : file_name (n), follow_links (fl), initialized (false) |
|
|
42 { |
|
|
43 if (! file_name.empty ()) |
|
|
44 update_internal (); |
|
|
45 } |
|
|
46 |
|
|
47 file_stat (const file_stat& f) { copy (f); } |
|
|
48 |
|
|
49 file_stat& operator = (const file_stat& f) |
|
|
50 { |
|
|
51 if (this != &f) |
|
|
52 copy (f); |
|
|
53 |
|
|
54 return *this; |
|
|
55 } |
|
|
56 |
|
|
57 ~file_stat (void) { } |
|
|
58 |
|
|
59 void get_stats (bool force = false) |
|
|
60 { |
|
|
61 if (! initialized || force) |
|
|
62 update_internal (force); |
|
|
63 } |
|
|
64 |
|
3504
|
65 void get_stats (const std::string& n, bool force = false) |
|
2926
|
66 { |
|
|
67 if (n != file_name || ! initialized || force) |
|
|
68 { |
|
|
69 initialized = false; |
|
|
70 |
|
|
71 file_name = n; |
|
|
72 |
|
|
73 update_internal (force); |
|
|
74 } |
|
|
75 } |
|
|
76 |
|
|
77 // File status and info. These should only be called for objects |
|
|
78 // that are already properly initialized. |
|
|
79 |
|
|
80 bool is_blk (void) const; |
|
|
81 bool is_chr (void) const; |
|
|
82 bool is_dir (void) const; |
|
|
83 bool is_fifo (void) const; |
|
|
84 bool is_lnk (void) const; |
|
|
85 bool is_reg (void) const; |
|
|
86 bool is_sock (void) const; |
|
|
87 |
|
5476
|
88 static bool is_blk (mode_t mode); |
|
|
89 static bool is_chr (mode_t mode); |
|
|
90 static bool is_dir (mode_t mode); |
|
|
91 static bool is_fifo (mode_t mode); |
|
|
92 static bool is_lnk (mode_t mode); |
|
|
93 static bool is_reg (mode_t mode); |
|
|
94 static bool is_sock (mode_t mode); |
|
|
95 |
|
2926
|
96 ino_t ino (void) const { return fs_ino; } |
|
|
97 dev_t dev (void) const { return fs_dev; } |
|
|
98 |
|
|
99 nlink_t nlink (void) const { return fs_nlink; } |
|
|
100 |
|
|
101 uid_t uid (void) const { return fs_uid; } |
|
|
102 gid_t gid (void) const { return fs_gid; } |
|
|
103 |
|
|
104 off_t size (void) const { return fs_size; } |
|
|
105 |
|
3260
|
106 octave_time atime (void) const { return fs_atime; } |
|
|
107 octave_time mtime (void) const { return fs_mtime; } |
|
|
108 octave_time ctime (void) const { return fs_ctime; } |
|
2926
|
109 |
|
3887
|
110 #if defined (HAVE_STRUCT_STAT_ST_RDEV) |
|
2926
|
111 dev_t rdev (void) const { return fs_rdev; } |
|
|
112 #endif |
|
|
113 |
|
3887
|
114 #if defined (HAVE_STRUCT_STAT_ST_BLKSIZE) |
|
2926
|
115 long blksize (void) const { return fs_blksize; } |
|
|
116 #endif |
|
|
117 |
|
3887
|
118 #if defined (HAVE_STRUCT_STAT_ST_BLOCKS) |
|
2926
|
119 long blocks (void) const { return fs_blocks; } |
|
|
120 #endif |
|
|
121 |
|
5476
|
122 mode_t mode (void) const { return fs_mode; } |
|
|
123 |
|
3504
|
124 std::string mode_as_string (void) const; |
|
2926
|
125 |
|
|
126 bool ok (void) const { return initialized && ! fail; } |
|
|
127 |
|
3145
|
128 operator bool () const { return ok (); } |
|
2926
|
129 |
|
|
130 bool exists (void) const { return ok (); } |
|
|
131 |
|
3504
|
132 std::string error (void) const { return ok () ? std::string () : errmsg; } |
|
2926
|
133 |
|
|
134 // Has the file referenced by this object been modified since TIME? |
|
3260
|
135 bool is_newer (const octave_time& time) const { return fs_mtime > time; } |
|
2926
|
136 |
|
|
137 // It's nice to be able to hide the file_stat object if we don't |
|
|
138 // really care about it. |
|
3504
|
139 static int is_newer (const std::string&, const octave_time&); |
|
2926
|
140 |
|
|
141 private: |
|
|
142 |
|
|
143 // Name of the file. |
|
3504
|
144 std::string file_name; |
|
2926
|
145 |
|
|
146 // TRUE means follow symbolic links to the ultimate file (stat). |
|
|
147 // FALSE means get information about the link itself (lstat). |
|
|
148 bool follow_links; |
|
|
149 |
|
|
150 // TRUE means we have already called stat. |
|
|
151 bool initialized; |
|
|
152 |
|
|
153 // TRUE means the stat for this file failed. |
|
|
154 bool fail; |
|
|
155 |
|
|
156 // If a failure occurs, this contains the system error text. |
|
3504
|
157 std::string errmsg; |
|
2926
|
158 |
|
|
159 // file type and permissions |
|
|
160 mode_t fs_mode; |
|
|
161 |
|
|
162 // serial number |
|
|
163 ino_t fs_ino; |
|
|
164 |
|
|
165 // device number |
|
|
166 dev_t fs_dev; |
|
|
167 |
|
|
168 // number of links |
|
|
169 nlink_t fs_nlink; |
|
|
170 |
|
|
171 // user ID of owner |
|
|
172 uid_t fs_uid; |
|
|
173 |
|
|
174 // group ID of owner |
|
|
175 gid_t fs_gid; |
|
|
176 |
|
|
177 // size in bytes, for regular files |
|
|
178 off_t fs_size; |
|
|
179 |
|
|
180 // time of last access |
|
3260
|
181 octave_time fs_atime; |
|
2926
|
182 |
|
|
183 // time of last modification |
|
3260
|
184 octave_time fs_mtime; |
|
2926
|
185 |
|
|
186 // time of last file status change |
|
3260
|
187 octave_time fs_ctime; |
|
2926
|
188 |
|
3887
|
189 #if defined (HAVE_STRUCT_STAT_ST_RDEV) |
|
2926
|
190 // device number for special files |
|
|
191 dev_t fs_rdev; |
|
|
192 #endif |
|
|
193 |
|
3887
|
194 #if defined (HAVE_STRUCT_STAT_ST_BLKSIZE) |
|
2926
|
195 // best I/O block size |
|
|
196 long fs_blksize; |
|
|
197 #endif |
|
|
198 |
|
3887
|
199 #if defined (HAVE_STRUCT_STAT_ST_BLOCKS) |
|
2926
|
200 // number of 512-byte blocks allocated |
|
|
201 long fs_blocks; |
|
|
202 #endif |
|
|
203 |
|
|
204 void update_internal (bool force = false); |
|
|
205 |
|
|
206 void copy (const file_stat&); |
|
|
207 }; |
|
|
208 |
|
|
209 #endif |
|
|
210 |
|
|
211 /* |
|
|
212 ;;; Local Variables: *** |
|
|
213 ;;; mode: C++ *** |
|
|
214 ;;; End: *** |
|
|
215 */ |
