php man page for lstat

LSTAT(3)								 1								  LSTAT(3)

lstat - Gives information about a file or symbolic link

SYNOPSIS
       array lstat (string  $filename)

DESCRIPTION
	Gathers the statistics of the file or symbolic link named by $filename.

PARAMETERS
	      o $filename
		- Path to a file or a symbolic link.

RETURN VALUES
	See  the  manual  page	for stat(3) for information on the structure of the array that lstat(3) returns. This function is identical to the
       stat(3) function except that if the $filename parameter is a symbolic link, the status of the symbolic link is returned, not the status	of
       the file pointed to by the symbolic link.

EXAMPLES
       Example #1

	      Comparison of stat(3) and lstat(3)

	      <?php
	      symlink('uploads.php', 'uploads');

	      // Contrast information for uploads.php and uploads
	      array_diff(stat('uploads'), lstat('uploads'));
	      ?>

	      The above example will output something similar to:

	       Information that differs between the two files.

	      Array
	      (
		  [ino] => 97236376
		  [mode] => 33188
		  [size] => 34
		  [atime] => 1223580003
		  [mtime] => 1223581848
		  [ctime] => 1223581848
		  [blocks] => 8
	      )

ERRORS
/EXCEPTIONS
	Upon failure, an E_WARNING is emitted.

NOTES
       Note

	      The results of this function are cached. See clearstatcache(3) for more details.

       Tip

	      As  of  PHP  5.0.0,  this function can also be used with some URL wrappers. Refer to "Supported Protocols and Wrappers" to determine
	      which wrappers support stat(3) family of functionality.

SEE ALSO
       stat(3).

PHP Documentation Group 														  LSTAT(3)