1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
## Copyright (C) 2005-2013 John W. Eaton
##
## This file is part of Octave.
##
## Octave is free software; you can redistribute it and/or modify it
## under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 3 of the License, or (at
## your option) any later version.
##
## Octave is distributed in the hope that it will be useful, but
## WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
## General Public License for more details.
##
## You should have received a copy of the GNU General Public License
## along with Octave; see the file COPYING. If not, see
## <http://www.gnu.org/licenses/>.
## -*- texinfo -*-
## @deftypefn {Function File} {[@var{status}, @var{result}, @var{msgid}] =} fileattrib (@var{file})
## Return information about @var{file}.
##
## If successful, @var{status} is 1, with @var{result} containing a
## structure with the following fields:
##
## @table @code
## @item Name
## Full name of @var{file}.
##
## @item archive
## True if @var{file} is an archive (Windows).
##
## @item system
## True if @var{file} is a system file (Windows).
##
## @item hidden
## True if @var{file} is a hidden file (Windows).
##
## @item directory
## True if @var{file} is a directory.
##
## @item UserRead
## @itemx GroupRead
## @itemx OtherRead
## True if the user (group; other users) has read permission for
## @var{file}.
##
## @item UserWrite
## @itemx GroupWrite
## @itemx OtherWrite
## True if the user (group; other users) has write permission for
## @var{file}.
##
## @item UserExecute
## @itemx GroupExecute
## @itemx OtherExecute
## True if the user (group; other users) has execute permission for
## @var{file}.
## @end table
##
## If an attribute does not apply (i.e., archive on a Unix system) then
## the field is set to NaN.
##
## With no input arguments, return information about the current
## directory.
##
## If @var{file} contains globbing characters, return information about
## all the matching files.
## @seealso{glob}
## @end deftypefn
function [status, msg, msgid] = fileattrib (file)
status = true;
msg = "";
msgid = "";
if (nargin == 0)
file = ".";
endif
if (ischar (file))
files = glob (file);
if (isempty (files))
files = {file};
nfiles = 1;
else
nfiles = length (files);
endif
else
error ("fileattrib: expecting first argument to be a character string");
endif
if (nargin == 0 || nargin == 1)
r_n = r_a = r_s = r_h = r_d ...
= r_u_r = r_u_w = r_u_x ...
= r_g_r = r_g_w = r_g_x ...
= r_o_r = r_o_w = r_o_x = cell (nfiles, 1);
curr_dir = pwd ();
for i = 1:nfiles
[info, err, msg] = stat (files{i});
if (! err)
r_n{i} = canonicalize_file_name (files{i});
r_a{i} = NaN;
r_s{i} = NaN;
r_h{i} = NaN;
r_d{i} = S_ISDIR (info.mode);
## FIXME -- maybe we should have S_IRUSR etc. masks?
modestr = info.modestr;
r_u_r{i} = modestr(2) == "r";
r_u_w{i} = modestr(3) == "w";
r_u_x{i} = modestr(4) == "x";
r_g_r{i} = modestr(5) == "r";
r_g_w{i} = modestr(6) == "w";
r_g_x{i} = modestr(7) == "x";
r_o_r{i} = modestr(8) == "r";
r_o_w{i} = modestr(9) == "w";
r_o_x{i} = modestr(10) == "x";
else
status = false;
msgid = "fileattrib";
break;
endif
endfor
if (status)
r = struct ("Name", r_n, "archive", r_a, "system", r_s,
"hidden", r_s, "directory", r_d, "UserRead", r_u_r,
"UserWrite", r_u_w, "UserExecute", r_u_x,
"GroupRead", r_g_r, "GroupWrite", r_g_w,
"GroupExecute", r_g_x, "OtherRead", r_o_r,
"OtherWrite", r_o_w, "OtherExecute", r_o_x);
if (nargout == 0)
status = r;
else
msg = r;
endif
endif
else
print_usage ();
endif
endfunction
|
