From: Steve Peters Date: Mon, 2 Jan 2006 14:24:58 +0000 (+0000) Subject: Note that the "unlink"ing directories is attempted when running as a X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=c69adce39458d65db6bf9adbc7d99cf7524bd8ee;p=p5sagit%2Fp5-mst-13.2.git Note that the "unlink"ing directories is attempted when running as a superuser, and that some operating systems may not support it. p4raw-id: //depot/perl@26571 --- diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index e33b030..abc8355 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -6606,10 +6606,11 @@ deleted. unlink @goners; unlink <*.bak>; -Note: C will not delete directories unless you are superuser and -the B<-U> flag is supplied to Perl. Even if these conditions are +Note: C will not attempt to delete directories unless you are superuser +and the B<-U> flag is supplied to Perl. Even if these conditions are met, be warned that unlinking a directory can inflict damage on your -filesystem. Use C instead. +filesystem. Finally, using C on directories is not supported on +many operating systems. Use C instead. If LIST is omitted, uses C<$_>. diff --git a/pod/perlrun.pod b/pod/perlrun.pod index d497074..6eb6bbf 100644 --- a/pod/perlrun.pod +++ b/pod/perlrun.pod @@ -883,11 +883,11 @@ for details. X<-U> allows Perl to do unsafe operations. Currently the only "unsafe" -operations are the unlinking of directories while running as superuser, -and running setuid programs with fatal taint checks turned into -warnings. Note that the B<-w> switch (or the C<$^W> variable) must -be used along with this option to actually I the -taint-check warnings. +operations are attempting to unlink directories while running as +superuser, and running setuid programs with fatal taint checks turned +into warnings. Note that the B<-w> switch (or the C<$^W> variable) +must be used along with this option to actually I the +taint-check warnings. =item B<-v> X<-v>