EIO_SYMLINK(3)								 1							    EIO_SYMLINK(3)

eio_symlink - Create a symbolic link

SYNOPSIS

       resource eio_symlink (string  $path, string  $new_path, [int  $pri = EIO_PRI_DEFAULT], [callable  $callback = NULL], [mixed  $data = NULL])

DESCRIPTION

       eio_symlink(3) creates a symbolic link $new_path to $path.

PARAMETERS

	      o $path
		- Source path

	      o $new_path
		- Target path

	      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_symlink(3) returns request resource on success or FALSE on error.

EXAMPLES

       Example #1

	      eio_symlink(3) example

	      <?php
	      $filename = dirname(__FILE__)."/symlink.dat";
	      touch($filename);
	      $link = dirname(__FILE__)."/symlink.link";

	      function my_symlink_cb($data, $result) {
		  global $link, $filename;
		  var_dump(file_exists($data) && is_link($data));

		  if (!eio_readlink($data, EIO_PRI_DEFAULT, "my_readlink_cb", NULL)) {
		      @unlink($link);
		      @unlink($filename);
		  }
	      }

	      function my_readlink_cb($data, $result) {
		  global $filename, $link;
		  var_dump($result);

		  @unlink($link);
		  @unlink($filename);
	      }

	      eio_symlink($filename, $link, EIO_PRI_DEFAULT, "my_symlink_cb", $link);
	      eio_event_loop();
	      ?>

	      The above example will output something similar to:

	      bool(true)
	      string(16) "/tmp/symlink.dat"

SEE ALSO eio_link.
PHP Documentation Group 													    EIO_SYMLINK(3)