path_disk_size_info.h File Reference

Query disk space on the given directory. More...

#include "int_sizes.h"
#include "list.h"

Go to the source code of this file.

Data Structures
struct	path_disk_size_info

Functions
int	path_disk_size_info_get (const char *path, int64_t *measured_size, int64_t *number_of_files)
	Get the total disk usage on path. More...
int	path_disk_size_info_get_r (const char *path, int64_t max_secs, struct path_disk_size_info **state)
	Get a (perhaps partial) disk usage on path, but measure by max_secs at a time. More...

Detailed Description

Query disk space on the given directory.

Function Documentation

int path_disk_size_info_get	(	const char *	path,
		int64_t *	measured_size,
		int64_t *	number_of_files
	)

Get the total disk usage on path.

Parameters

path	Directory to be measured.
*measured_size	A pointer to an integer that will be filled with the total space in bytes.
*number_of_files	A pointer to an integer that will be filled with the total number of files, directories, and symbolic links.

Returns

zero on success, -1 if an error is encounterd (see errno).

int path_disk_size_info_get_r	(	const char *	path,
		int64_t	max_secs,
		struct path_disk_size_info **	state
	)

Get a (perhaps partial) disk usage on path, but measure by max_secs at a time.

If *state is NULL, start a new measurement, otherwise continue from the state recorded in state (see path_disk_size_info). When the function returns, if *state->complete_measurement is 1, then the measurement was completed before a timeout.

Parameters

path	Directory to be measured.
max_secs	Maximum number of seconds to spend in the measurement.
*state	State of the measurement.

Returns

zero on success, -1 if an error is encounterd (see errno).