php man page for eio_fstat

EIO_FSTAT(3)								 1							      EIO_FSTAT(3)

eio_fstat - Get file status

SYNOPSIS
       resource eio_fstat (mixed  $fd, int  $pri, callable  $callback, [mixed  $data])

DESCRIPTION
       eio_fstat(3) returns file status information in $result argument of $callback

PARAMETERS
	      o $fd
		- Stream, Socket resource, or numeric file descriptor.

	      o $pri
		-The  request  priority:  EIO_PRI_DEFAULT,  EIO_PRI_MIN,  EIO_PRI_MAX,	or  NULL.  If  NULL  passed,  $pri  internally	is  set to
		EIO_PRI_DEFAULT.

	      o $callback
		-$callback function is called when the request is done. It should match the following prototype:

	      void callback(mixed $data, int $result[, resource $req]);

		     o $data
		       -is custom data passed to the request.

		     o $result
		       -request-specific result value; basically, the value returned by corresponding system call.

		     o $req
		       -is optional request resource which can be used with functions like eio_get_last_error(3)

	      o $data
		- Arbitrary variable passed to $callback.

RETURN VALUES
       eio_busy(3) returns request resource on success or FALSE on error.

EXAMPLES
       Example #1

	      eio_lstat(3) example

	      <?php
	      // Create temporary file
	      $tmp_filename = dirname(__FILE__) ."/eio-file.tmp";
	      touch($tmp_filename);

	      /* Is called when eio_fstat() done */
	      function my_res_cb($data, $result) {
	       // Should output array with stat info
	       var_dump($result);

	       if ($data['fd']) {
		// Close temporary file
		eio_close($data['fd']);
		eio_event_loop();
	       }
	       // Remove temporary file
	       @unlink($data['file']);
	      }

	      /* Is called when eio_open() done */
	      function my_open_cb($data, $result) {
	       // Prepare data for callback
	       $d = array(
		'fd'  => $result,
		'file'=> $data
	       );
	       // Request stat info
	       eio_fstat($result, EIO_PRI_DEFAULT, "my_res_cb", $d);
	       // Process request(s)
	       eio_event_loop();
	      }

	      // Open temporary file
	      eio_open($tmp_filename, EIO_O_RDONLY, NULL, EIO_PRI_DEFAULT,
		"my_open_cb", $tmp_filename);
	      eio_event_loop();
	      ?>

	      The above example will output something similar to:

	      array(12) {
	       ["st_dev"]=>
		int(2050)
		["st_ino"]=>
		int(2489159)
		["st_mode"]=>
		int(33188)
		["st_nlink"]=>
		int(1)
		["st_uid"]=>
		int(1000)
		["st_gid"]=>
		int(100)
		["st_rdev"]=>
		int(0)
		["st_blksize"]=>
		int(4096)
		["st_blocks"]=>
		int(0)
		["st_atime"]=>
		int(1318239506)
		["st_mtime"]=>
		int(1318239506)
		["st_ctime"]=>
		int(1318239506)
	      }

SEE ALSO eio_lstat, eio_stat.
PHP Documentation Group 													      EIO_FSTAT(3)