php man page for lchgrp

LCHGRP(3)								 1								 LCHGRP(3)

lchgrp - Changes group ownership of symlink

SYNOPSIS
       bool lchgrp (string  $filename, mixed  $group)

DESCRIPTION
	Attempts to change the group of the symlink $filename to $group.

	Only the superuser may change the group of a symlink arbitrarily; other users may change the group of a symlink to any group of which that
       user is a member.

PARAMETERS
	      o $filename
		- Path to the symlink.

	      o $group
		- The group specified by name or number.

RETURN VALUES
	Returns TRUE on success or FALSE on failure.

EXAMPLES
       Example #1

	      Changing the group of a symbolic link

	      <?php
	      $target = 'output.php';
	      $link = 'output.html';
	      symlink($target, $link);

	      lchgrp($link, 8);
	      ?>

NOTES
       Note

	      This function will not work on remote files as the file to be examined must be accessible via the server's filesystem.

       Note

	      When safe mode is enabled, PHP checks whether the files or directories being operated upon have the same UID (owner) as  the  script
	      that is being executed.

       Note

	      This function is not implemented on Windows platforms.

SEE ALSO
       chgrp(3), lchown(3), chown(3), chmod(3).

PHP Documentation Group 														 LCHGRP(3)