disk_total_space(3) [php man page]

DISK_TOTAL_SPACE(3)							 1						       DISK_TOTAL_SPACE(3)

disk_total_space - Returns the total size of a filesystem or disk partition

SYNOPSIS

       float disk_total_space (string  $directory)

DESCRIPTION

	Given  a string containing a directory, this function will return the total number of bytes on the corresponding filesystem or disk parti-
       tion.

PARAMETERS

	      o $directory
		- A directory of the filesystem or disk partition.

RETURN VALUES

	Returns the total number of bytes as a float or FALSE on failure.

EXAMPLES

       Example #1

	      disk_total_space(3) example

	      <?php
	      // $ds contains the total number of bytes available on "/"
	      $ds = disk_total_space("/");

	      // On Windows:
	      $ds = disk_total_space("C:");
	      $ds = disk_total_space("D:");
	      ?>

NOTES

       Note

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

SEE ALSO

       disk_free_space(3).

PHP Documentation Group 												       DISK_TOTAL_SPACE(3)

RENAME(3)								 1								 RENAME(3)

rename - Renames a file or directory

SYNOPSIS

       bool rename (string  $oldname, string  $newname, [resource  $context])

DESCRIPTION

	Attempts to rename $oldname to $newname, moving it between directories if necessary. If $newname exists, it will be overwritten.

PARAMETERS

	      o $oldname
		-

	      Note

		      The old name. The wrapper used in $oldname must match the wrapper used in $newname.

	      o $newname
		- The new name.

	      o $context
		-

	      Note

		     Context support was added with PHP 5.0.0. For a description of contexts, refer to "Streams".

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.3.1	|						    |
       |	|						    |
       |	| rename(3)  can  now rename files across drives in |
       |	| Windows.					    |
       |	|						    |
       | 5.0.0	|						    |
       |	|						    |
       |	| rename(3) can now also  be  used  with  some	URL |
       |	| wrappers. Refer to "Supported Protocols and Wrap- |
       |	| pers" for a listing  of  which  wrappers  support |
       |	| rename(3).					    |
       |	|						    |
       | 4.3.3	|						    |
       |	|						    |
       |	| rename(3)  may now be able to rename files across |
       |	| partitions on *nix based  systems,  provided	the |
       |	| appropriate permissions are held. Warnings may be |
       |	| generated if the destination	filesystem  doesn't |
       |	| permit chown() or chmod() system calls to be made |
       |	| on files  --	for  example,  if  the	destination |
       |	| filesystem is a FAT filesystem.		    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      Example with rename(3)

	      <?php
	      rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
	      ?>

SEE ALSO

       copy(3), unlink(3), move_uploaded_file(3).

PHP Documentation Group 														 RENAME(3)