This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Put back madvise lost because of a typo.
[perl5.git] / lib / filetest.pm
index cc14e82..65fc170 100644 (file)
@@ -16,7 +16,8 @@ filetest - Perl pragma to control the filetest permission operators
 =head1 DESCRIPTION
 
 This pragma tells the compiler to change the behaviour of the filetest
-permissions operators, the -r -w -x -R -W -X (see L<perlfunc>).
+permissions operators, the C<-r> C<-w> C<-x> C<-R> C<-W> C<-X>
+(see L<perlfunc>).
 
 The default behaviour to use the mode bits as returned by the stat()
 family of calls.  This, however, may not be the right thing to do if
@@ -31,11 +32,11 @@ There may be a slight performance decrease in the filetests
 when C<use filetest> is in effect, because in some systems
 the extended functionality needs to be emulated.
 
-B<NOTE>: using the file tests is a lost case from the start: there is
-a window open for race conditions (who is to say that the permissions
-will not change between the test and the real operation?).  Therefore
-if you are serious about security, just try the real operation and
-test for its success.  Think atomicity.
+B<NOTE>: using the file tests for security purposes is a lost cause
+from the start: there is a window open for race conditions (who is to
+say that the permissions will not change between the test and the real
+operation?).  Therefore if you are serious about security, just try
+the real operation and test for its success.  Think atomicity.
 
 =head2 subpragma access