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.
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.

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).

Generated on 7 Oct 2015 for cctools by  doxygen 1.6.1