home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _f264a355e1378d009729c1bc435fdcf6 < prev    next >
Encoding:
Text File  |  2000-03-23  |  3.4 KB  |  90 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>filetest - Perl pragma to control the filetest permission operators</TITLE>
  5. <LINK REL="stylesheet" HREF="../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> filetest - Perl pragma to control the filetest permission operators</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <UL>
  26.  
  27.         <LI><A HREF="#subpragma access">subpragma access</A></LI>
  28.     </UL>
  29.  
  30. </UL>
  31. <!-- INDEX END -->
  32.  
  33. <HR>
  34. <P>
  35. <H1><A NAME="name">NAME</A></H1>
  36. <P>filetest - Perl pragma to control the filetest permission operators</P>
  37. <P>
  38. <HR>
  39. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  40. <UL>
  41. <LI>Linux</LI>
  42. <LI>Solaris</LI>
  43. <LI>Windows</LI>
  44. </UL>
  45. <HR>
  46. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  47. <PRE>
  48.     $can_perhaps_read = -r "file";      # use the mode bits
  49.     {
  50.         use filetest 'access';          # intuit harder
  51.         $can_really_read = -r "file";
  52.     }
  53.     $can_perhaps_read = -r "file";      # use the mode bits again</PRE>
  54. <P>
  55. <HR>
  56. <H1><A NAME="description">DESCRIPTION</A></H1>
  57. <P>This pragma tells the compiler to change the behaviour of the filetest
  58. permissions operators, the <CODE>-r</CODE> <CODE>-w</CODE> <CODE>-x</CODE> <CODE>-R</CODE> <CODE>-W</CODE> <CODE>-X</CODE>
  59. (see <A HREF="../lib/Pod/perlfunc.html">the perlfunc manpage</A>).</P>
  60. <P>The default behaviour to use the mode bits as returned by the <A HREF="../lib/Pod/perlfunc.html#item_stat"><CODE>stat()</CODE></A>
  61. family of calls.  This, however, may not be the right thing to do if
  62. for example various ACL (access control lists) schemes are in use.
  63. For such environments, <CODE>use filetest</CODE> may help the permission
  64. operators to return results more consistent with other tools.</P>
  65. <P>Each ``use filetest'' or ``no filetest'' affects statements to the end of
  66. the enclosing block.</P>
  67. <P>There may be a slight performance decrease in the filetests
  68. when <CODE>use filetest</CODE> is in effect, because in some systems
  69. the extended functionality needs to be emulated.</P>
  70. <P><STRONG>NOTE</STRONG>: using the file tests for security purposes is a lost cause
  71. from the start: there is a window open for race conditions (who is to
  72. say that the permissions will not change between the test and the real
  73. operation?).  Therefore if you are serious about security, just try
  74. the real operation and test for its success.  Think atomicity.</P>
  75. <P>
  76. <H2><A NAME="subpragma access">subpragma access</A></H2>
  77. <P>Currently only one subpragma, <CODE>access</CODE> is implemented.  It enables
  78. (or disables) the use of <CODE>access()</CODE> or similar system calls.  This
  79. extended filetest functionality is used only when the argument of the
  80. operators is a filename, not when it is a filehandle.</P>
  81. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  82. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  83. <STRONG><P CLASS=block> filetest - Perl pragma to control the filetest permission operators</P></STRONG>
  84. </TD></TR>
  85. </TABLE>
  86.  
  87. </BODY>
  88.  
  89. </HTML>
  90.