This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
t/op/filetest.t: Provide descriptions for remaining tests lacking them.
[perl5.git] / t / op / filetest.t
CommitLineData
42e55ab1
JH
1#!./perl
2
3# There are few filetest operators that are portable enough to test.
4# See pod/perlport.pod for details.
5
6BEGIN {
7 chdir 't' if -d 't';
20822f61 8 @INC = '../lib';
fbb0b3b3 9 require './test.pl';
42e55ab1
JH
10}
11
bce3b594 12plan(tests => 49 + 27*14);
42e55ab1 13
8c5e482d
JK
14# Tests presume we are in t/op directory and that file 'TEST' is found
15# therein.
16is(-d 'op', 1, "-d: directory correctly identified");
17is(-f 'TEST', 1, "-f: plain file correctly identified");
18isnt(-f 'op', 1, "-f: directory is not a plain file");
19isnt(-d 'TEST', 1, "-d: plain file is not a directory");
20is(-r 'TEST', 1, "-r: file readable by effective uid/gid not found");
42e55ab1 21
e687eccd
NC
22# Make a read only file. This happens to be empty, so we also use it later.
23my $ro_empty_file = tempfile();
d4188802
NC
24
25{
e687eccd 26 open my $fh, '>', $ro_empty_file or die "open $fh: $!";
d4188802
NC
27 close $fh or die "close $fh: $!";
28}
29
e687eccd 30chmod 0555, $ro_empty_file or die "chmod 0555, '$ro_empty_file' failed: $!";
846f25a3 31
fbb0b3b3 32SKIP: {
dcefe67b
NC
33 my $restore_root;
34 if ($> == 0) {
35 # root can read and write anything, so switch uid (may not be
36 # implemented)
37 eval '$> = 1';
38
39 skip("Can't drop root privs to test read-only files") if $> == 0;
40 note("Dropped root privs to test read-only files. \$> == $>");
41 ++$restore_root;
fbb0b3b3 42 }
42e55ab1 43
8c5e482d 44 isnt(-w $ro_empty_file, 1, "-w: file writable by effective uid/gid");
42e55ab1 45
dcefe67b
NC
46 if ($restore_root) {
47 # If the previous assignment to $> worked, so should this:
48 $> = 0;
49 note("Restored root privs after testing read-only files. \$> == $>");
50 }
51}
fd1e013e 52
64f0b68d 53# these would fail for the euid 1
fd1e013e 54# (unless we have unpacked the source code as uid 1...)
8c5e482d
JK
55is(-r 'op', 1, "-r: directory readable by effective uid/gid");
56is(-w 'op', 1, "-w: directory writable by effective uid/gid");
57is(-x 'op', 1, "-x: executable by effective uid/gid"); # Hohum. Are directories -x everywhere?
fbb0b3b3 58
8c5e482d
JK
59is( "@{[grep -r, qw(foo io noo op zoo)]}", "io op",
60 "-r: found directories readable by effective uid/gid" );
fbb0b3b3
RGS
61
62# Test stackability of filetest operators
42e55ab1 63
8c5e482d
JK
64is(defined( -f -d 'TEST' ), 1, "-f and -d stackable: plain file found");
65isnt(-f -d _, 1, "-f and -d stackable: no plain file found");
66isnt(defined( -e 'zoo' ), 1, "-e: file does not exist");
67isnt(defined( -e -d 'zoo' ), 1, "-e and -d: neither file nor directory exists");
68isnt(defined( -f -e 'zoo' ), 1, "-f and -e: not a plain file and does not exist");
69is(-f -e 'TEST', 1, "-f and -e: plain file and exists");
70is(-e -f 'TEST', 1, "-e and -f: exists and is plain file");
71is(defined(-d -e 'TEST'), 1, "-d and -e: file at least exists");
72is(defined(-e -d 'TEST'), 1, "-e and -d: file at least exists");
73isnt( -f -d 'op', 1, "-f and -d: directory found but is not a plain file");
74is(-x -d -x 'op', 1, "-x, -d and -x again: directory exists and is executable");
fea55e48
NC
75my ($size) = (stat 'TEST')[7];
76cmp_ok($size, '>', 1, 'TEST is longer than 1 byte');
77is( (-s -f 'TEST'), $size, "-s returns real size" );
8c5e482d 78is(-f -s 'TEST', 1, "-f and -s: plain file with non-zero size");
7294df96 79
e7d3eb55 80# now with an empty file
8c5e482d
JK
81is(-f $ro_empty_file, 1, "-f: plain file found");
82is(-s $ro_empty_file, 0, "-s: file has 0 bytes");
83is(-f -s $ro_empty_file, 0, "-f and -s: plain file with 0 bytes");
84is(-s -f $ro_empty_file, 0, "-s and -f: file with 0 bytes is plain file");
e7d3eb55 85
1f26655e
FC
86# stacked -l
87eval { -l -e "TEST" };
88like $@, qr/^The stat preceding -l _ wasn't an lstat at /,
89 'stacked -l non-lstat error with warnings off';
90{
91 local $^W = 1;
92 eval { -l -e "TEST" };
93 like $@, qr/^The stat preceding -l _ wasn't an lstat at /,
94 'stacked -l non-lstat error with warnings on';
95}
96# Make sure -l is using the previous stat buffer, and not using the previ-
97# ous op’s return value as a file name.
8f67f7cf 98# t/TEST can be a symlink under -Dmksymlinks, so use our temporary file.
1f26655e
FC
99SKIP: {
100 use Perl::OSType 'os_type';
61602f40 101 if (os_type ne 'Unix') { skip "Not Unix", 2 }
1f26655e 102 chomp(my $ln = `which ln`);
61602f40 103 if ( ! -e $ln ) { skip "No ln" , 2 }
8f67f7cf
NC
104 lstat $ro_empty_file;
105 `ln -s $ro_empty_file 1`;
bce3b594 106 isnt(-l -e _, 1, 'stacked -l uses previous stat, not previous retval');
1f26655e 107 unlink 1;
433644ee
FC
108
109 # Since we already have our skip block set up, we might as well put this
110 # test here, too:
111 # -l always treats a non-bareword argument as a file name
8f67f7cf 112 system 'ln', '-s', $ro_empty_file, \*foo;
433644ee 113 local $^W = 1;
bce3b594 114 is(-l \*foo, 1, '-l \*foo is a file name');
433644ee 115 unlink \*foo;
1f26655e
FC
116}
117
7294df96
RGS
118# test that _ is a bareword after filetest operators
119
120-f 'TEST';
8c5e482d 121is(-f _, 1, "_ is bareword after filetest operator");
7294df96 122sub _ { "this is not a file name" }
8c5e482d 123is(-f _, 1, "_ is bareword after filetest operator");
d89f1457
BM
124
125my $over;
126{
127 package OverFtest;
128
4d57d24f 129 use overload
c1d4704a 130 fallback => 1,
4d57d24f 131 -X => sub {
c1d4704a 132 $over = [qq($_[0]), $_[1]];
4d57d24f
BM
133 "-$_[1]";
134 };
d89f1457 135}
f6aa8023
BM
136{
137 package OverString;
138
139 # No fallback. -X should fall back to string overload even without
140 # it.
141 use overload q/""/ => sub { $over = 1; "TEST" };
142}
143{
144 package OverBoth;
145
146 use overload
147 q/""/ => sub { "TEST" },
148 -X => sub { "-$_[1]" };
149}
150{
151 package OverNeither;
152
4d57d24f 153 # Need fallback. Previous versions of perl required 'fallback' to do
f6aa8023
BM
154 # -X operations on an object with no "" overload.
155 use overload
156 '+' => sub { 1 },
157 fallback => 1;
158}
159
160my $ft = bless [], "OverFtest";
c1d4704a 161my $ftstr = qq($ft);
f6aa8023
BM
162my $str = bless [], "OverString";
163my $both = bless [], "OverBoth";
164my $neither = bless [], "OverNeither";
c1d4704a 165my $nstr = qq($neither);
d89f1457 166
d0c91b6a
BM
167open my $gv, "<", "TEST";
168bless $gv, "OverString";
169open my $io, "<", "TEST";
170$io = *{$io}{IO};
171bless $io, "OverString";
172
822146ea
RGS
173my $fcntl_not_available;
174eval { require Fcntl } or $fcntl_not_available = 1;
fa7f7498 175
d89f1457 176for my $op (split //, "rwxoRWXOezsfdlpSbctugkTMBAC") {
d3ebc3eb 177 $over = [];
bce3b594
NC
178 my $rv = eval "-$op \$ft";
179 isnt( $rv, undef, "overloaded -$op succeeds" )
f6aa8023
BM
180 or diag( $@ );
181 is( $over->[0], $ftstr, "correct object for overloaded -$op" );
d89f1457
BM
182 is( $over->[1], $op, "correct op for overloaded -$op" );
183 is( $rv, "-$op", "correct return value for overloaded -$op");
f6aa8023 184
fa7f7498 185 my ($exp, $is) = (1, "is");
186 if (
822146ea 187 !$fcntl_not_available and (
fa7f7498 188 $op eq "u" and not eval { Fcntl::S_ISUID() } or
189 $op eq "g" and not eval { Fcntl::S_ISGID() } or
190 $op eq "k" and not eval { Fcntl::S_ISVTX() }
822146ea 191 )
fa7f7498 192 ) {
193 ($exp, $is) = (0, "not");
194 }
195
f6aa8023
BM
196 $over = 0;
197 $rv = eval "-$op \$str";
bce3b594 198 is($@, "", "-$op succeeds with string overloading");
f6aa8023 199 is( $rv, eval "-$op 'TEST'", "correct -$op on string overload" );
fa7f7498 200 is( $over, $exp, "string overload $is called for -$op" );
f6aa8023 201
fa7f7498 202 ($exp, $is) = $op eq "l" ? (1, "is") : (0, "not");
d0c91b6a
BM
203
204 $over = 0;
205 eval "-$op \$gv";
206 is( $over, $exp, "string overload $is called for -$op on GLOB" );
207
52f7f5ab
BM
208 # IO refs always get string overload called. This might be a bug.
209 $op eq "t" || $op eq "T" || $op eq "B"
210 and ($exp, $is) = (1, "is");
211
d0c91b6a
BM
212 $over = 0;
213 eval "-$op \$io";
214 is( $over, $exp, "string overload $is called for -$op on IO");
215
f6aa8023
BM
216 $rv = eval "-$op \$both";
217 is( $rv, "-$op", "correct -$op on string/-X overload" );
218
219 $rv = eval "-$op \$neither";
bce3b594 220 is($@, "", "-$op succeeds with random overloading");
f6aa8023 221 is( $rv, eval "-$op \$nstr", "correct -$op with random overloading" );
f6aa8023 222
4d57d24f
BM
223 is( eval "-r -$op \$ft", "-r", "stacked overloaded -$op" );
224 is( eval "-$op -r \$ft", "-$op", "overloaded stacked -$op" );
225}
ca867162
FC
226
227# -l stack corruption: this bug occurred from 5.8 to 5.14
228{
229 push my @foo, "bar", -l baz;
230 is $foo[0], "bar", '-l bareword does not corrupt the stack';
231}
49498caf 232
31b139ba
FC
233# -l and fatal warnings
234stat "test.pl";
235eval { use warnings FATAL => io; -l cradd };
bce3b594
NC
236isnt(stat _, 1,
237 'fatal warnings do not prevent -l HANDLE from setting stat status');
31b139ba 238
49498caf
FC
239# File test ops should not call get-magic on the topmost SV on the stack if
240# it belongs to another op.
241{
242 my $w;
243 sub oon::TIESCALAR{bless[],'oon'}
244 sub oon::FETCH{$w++}
245 tie my $t, 'oon';
246 push my @a, $t, -t;
247 is $w, 1, 'file test does not call FETCH on stack item not its own';
248}
5731662b 249
97c226b8
FC
250# -T and -B
251
bd5f6c01
FC
252my $Perl = which_perl();
253
5731662b 254SKIP: {
2ad48547 255 skip "no -T on filehandles", 8 unless eval { -T STDERR; 1 };
97c226b8
FC
256
257 # Test that -T HANDLE sets the last stat type
5731662b
FC
258 -l "perl.c"; # last stat type is now lstat
259 -T STDERR; # should set it to stat, since -T does a stat
260 eval { -l _ }; # should die, because the last stat type is not lstat
261 like $@, qr/^The stat preceding -l _ wasn't an lstat at /,
262 '-T HANDLE sets the stat type';
97c226b8
FC
263
264 # statgv should be cleared when freed
265 fresh_perl_is
266 'open my $fh, "test.pl"; -r $fh; undef $fh; open my $fh2, '
bd5f6c01 267 . "q\0$Perl\0; print -B _",
97c226b8
FC
268 '',
269 { switches => ['-l'] },
270 'PL_statgv should not point to freed-and-reused SV';
271
272 # or coerced into a non-glob
273 fresh_perl_is
274 'open Fh, "test.pl"; -r($h{i} = *Fh); $h{i} = 3; undef %h;'
275 . 'open my $fh2, ' . "q\0" . which_perl() . "\0; print -B _",
276 '',
277 { switches => ['-l'] },
278 'PL_statgv should not point to coerced-freed-and-reused GV';
bd5f6c01
FC
279
280 # -T _ should work after stat $ioref
281 open my $fh, 'test.pl';
282 stat $Perl; # a binary file
283 stat *$fh{IO};
bce3b594 284 is(-T _, 1, '-T _ works after stat $ioref');
bd5f6c01
FC
285
286 # and after -r $ioref
287 -r *$fh{IO};
bce3b594 288 is(-T _, 1, '-T _ works after -r $ioref');
eb4c377a
FC
289
290 # -T _ on closed filehandle should still reset stat info
291 stat $fh;
292 close $fh;
293 -T _;
bce3b594 294 isnt(stat _, 1, '-T _ on closed filehandle resets stat info');
21a64c3e
FC
295
296 lstat "test.pl";
297 -T $fh; # closed
298 eval { lstat _ };
299 like $@, qr/^The stat preceding lstat\(\) wasn't an lstat at /,
300 '-T on closed handle resets last stat type';
2ad48547
FC
301
302 # Fatal warnings should not affect the setting of errno.
303 $! = 7;
304 -T cradd;
305 my $errno = $!;
306 $! = 7;
307 eval { use warnings FATAL => unopened; -T cradd };
308 my $errno2 = $!;
309 is $errno2, $errno,
310 'fatal warnings do not affect errno after -T BADHADNLE';
5731662b 311}
de61bf2a
FC
312
313is runperl(prog => '-T _', switches => ['-w'], stderr => 1), "",
314 'no uninit warnings from -T with no preceding stat';
7b7309af 315
ad2d99e3 316SKIP: {
bee528ec 317 my $rand_file_name = 'filetest-' . rand =~ y/.//dr;
ad2d99e3
FC
318 if (-e $rand_file_name) { skip "File $rand_file_name exists", 1 }
319 stat 'test.pl';
320 -T $rand_file_name;
bce3b594 321 isnt(stat _, 1, '-T "nonexistent" resets stat success status');
ad2d99e3
FC
322}
323
7b7309af
FC
324# Unsuccessful filetests on filehandles should leave stat buffers in the
325# same state whether fatal warnings are on or off.
326{
327 stat "test.pl";
328 # This GV has no IO
329 -r *phlon;
330 my $failed_stat1 = stat _;
331
332 stat "test.pl";
333 eval { use warnings FATAL => unopened; -r *phlon };
334 my $failed_stat2 = stat _;
335
336 is $failed_stat2, $failed_stat1,
337 'failed -r($gv_without_io) with and w/out fatal warnings';
338
339 stat "test.pl";
340 -r cength; # at compile time autovivifies IO, but with no fp
341 $failed_stat1 = stat _;
342
343 stat "test.pl";
344 eval { use warnings FATAL => unopened; -r cength };
345 $failed_stat2 = stat _;
346
347 is $failed_stat2, $failed_stat1,
348 'failed -r($gv_with_io_but_no_fp) with and w/out fatal warnings';
349}