dm_linux_disk_free Function

public function dm_linux_disk_free(path, file_system, size, used, available, capacity, mounted_on) result(rc)

Uses

  • proc~~dm_linux_disk_free~~UsesGraph proc~dm_linux_disk_free dm_linux_disk_free module~dm_ascii dm_ascii proc~dm_linux_disk_free->module~dm_ascii module~dm_file dm_file proc~dm_linux_disk_free->module~dm_file module~dm_error dm_error module~dm_file->module~dm_error module~dm_kind dm_kind module~dm_file->module~dm_kind module~dm_error->module~dm_ascii module~dm_error->module~dm_kind iso_fortran_env iso_fortran_env module~dm_kind->iso_fortran_env

Returns free disk space of file or directory. Argument path must be a file or directory, for example, / or .. The function calls df(1) internally and expects sizes in 1024K blocks.

Output of df(1):

$ df .
Filesystem                1K-blocks     Used Available Use% Mounted on
/dev/mapper/vgubuntu-root 486903968 66753060 395344100  15% /

The function returns the following error codes:

  • E_FORMAT if output format is unexpected.
  • E_INVALID if path is invalid or not readable.
  • E_PLATFORM if current system is not Linux.
  • E_NOT_FOUND if path does not exist.
  • E_READ if pipe returned no bytes.
  • E_SYSTEM if system call failed.

Arguments

Type IntentOptional Attributes Name
character(len=*), intent(in) :: path

File or directory.
character(len=*), intent(inout), optional :: file_system

File system path (device, ZFS pool).
integer(kind=i8), intent(out), optional :: size

Size [byte].
integer(kind=i8), intent(out), optional :: used

Used space [byte].
integer(kind=i8), intent(out), optional :: available

Available space [byte]
integer, intent(out), optional :: capacity

Capacity [%]
character(len=*), intent(inout), optional :: mounted_on

Mount point.

Return Value integer


Calls

proc~~dm_linux_disk_free~~CallsGraph proc~dm_linux_disk_free dm_linux_disk_free output output proc~dm_linux_disk_free->output proc~dm_file_exists dm_file_exists proc~dm_linux_disk_free->proc~dm_file_exists proc~dm_is_error dm_is_error proc~dm_linux_disk_free->proc~dm_is_error proc~dm_pipe_close dm_pipe_close proc~dm_linux_disk_free->proc~dm_pipe_close proc~dm_pipe_open dm_pipe_open proc~dm_linux_disk_free->proc~dm_pipe_open proc~dm_pipe_read_line dm_pipe_read_line proc~dm_linux_disk_free->proc~dm_pipe_read_line c_pclose c_pclose proc~dm_pipe_close->c_pclose proc~dm_pipe_is_connected dm_pipe_is_connected proc~dm_pipe_close->proc~dm_pipe_is_connected c_popen c_popen proc~dm_pipe_open->c_popen proc~dm_f_c_string dm_f_c_string proc~dm_pipe_open->proc~dm_f_c_string proc~dm_pipe_open->proc~dm_pipe_is_connected c_fgets c_fgets proc~dm_pipe_read_line->c_fgets proc~dm_pipe_read_line->proc~dm_pipe_is_connected

Called by

proc~~dm_linux_disk_free~~CalledByGraph proc~dm_linux_disk_free dm_linux_disk_free proc~dm_system_disk_free dm_system_disk_free proc~dm_system_disk_free->proc~dm_linux_disk_free