platform_bionic/libc/include/sys/statvfs.h
Elliott Hughes 261bd745ee Support statvfs on API levels before 19.
Split statfs and statvfs. The former has been available forever, and the
latter is implemented in terms of the former. The implementation has
been moved into headers so that it can be used at low API levels.

There's no reason for any Android or Linux code to use statvfs rather
than statfs, but code that needs to build on Darwin too will want to use
statvfs because Darwin's statfs is very spartan.

Bug: https://github.com/android-ndk/ndk/issues/609
Test: treehugger
Change-Id: Icf3d5723a260099fddb2d9f902e3047b0f041647
2019-08-29 21:57:58 -07:00

149 lines
4.1 KiB
C

/*
* Copyright (C) 2013 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#pragma once
/**
* @file sys/statvfs.h
* @brief Filesystem statistics.
*/
#include <stdint.h>
#include <sys/cdefs.h>
#include <sys/types.h>
__BEGIN_DECLS
struct statvfs {
/** Block size. */
unsigned long f_bsize;
/** Fragment size. */
unsigned long f_frsize;
/** Total size of filesystem in `f_frsize` blocks. */
fsblkcnt_t f_blocks;
/** Number of free blocks. */
fsblkcnt_t f_bfree;
/** Number of free blocks for non-root. */
fsblkcnt_t f_bavail;
/** Number of inodes. */
fsfilcnt_t f_files;
/** Number of free inodes. */
fsfilcnt_t f_ffree;
/** Number of free inodes for non-root. */
fsfilcnt_t f_favail;
/** Filesystem id. */
unsigned long f_fsid;
/** Mount flags. (See `ST_` constants.) */
unsigned long f_flag;
/** Maximum filename length. */
unsigned long f_namemax;
#if defined(__LP64__)
uint32_t __f_reserved[6];
#endif
};
struct statvfs64 {
/** Block size. */
unsigned long f_bsize;
/** Fragment size. */
unsigned long f_frsize;
/** Total size of filesystem in `f_frsize` blocks. */
fsblkcnt_t f_blocks;
/** Number of free blocks. */
fsblkcnt_t f_bfree;
/** Number of free blocks for non-root. */
fsblkcnt_t f_bavail;
/** Number of inodes. */
fsfilcnt_t f_files;
/** Number of free inodes. */
fsfilcnt_t f_ffree;
/** Number of free inodes for non-root. */
fsfilcnt_t f_favail;
/** Filesystem id. */
unsigned long f_fsid;
/** Mount flags. (See `ST_` constants.) */
unsigned long f_flag;
/** Maximum filename length. */
unsigned long f_namemax;
#if defined(__LP64__)
uint32_t __f_reserved[6];
#endif
};
/** Flag for `f_flag` in `struct statvfs`: mounted read-only. */
#define ST_RDONLY 0x0001
/** Flag for `f_flag` in `struct statvfs`: setuid/setgid ignored. */
#define ST_NOSUID 0x0002
/** Flag for `f_flag` in `struct statvfs`: access to device files disallowed. */
#define ST_NODEV 0x0004
/** Flag for `f_flag` in `struct statvfs`: execution disallowed. */
#define ST_NOEXEC 0x0008
/** Flag for `f_flag` in `struct statvfs`: writes synced immediately. */
#define ST_SYNCHRONOUS 0x0010
/** Flag for `f_flag` in `struct statvfs`: mandatory locking permitted. */
#define ST_MANDLOCK 0x0040
/** Flag for `f_flag` in `struct statvfs`: access times not updated. */
#define ST_NOATIME 0x0400
/** Flag for `f_flag` in `struct statvfs`: directory access times not updated. */
#define ST_NODIRATIME 0x0800
/** Flag for `f_flag` in `struct statvfs`: see `MS_RELATIME`. */
#define ST_RELATIME 0x1000
#if __ANDROID_API__ >= 19
// These functions are implemented as static inlines before API level 19.
/**
* [statvfs(3)](http://man7.org/linux/man-pages/man3/statvfs.3.html)
* queries filesystem statistics for the given path.
*
* Returns 0 on success, and returns -1 and sets `errno` on failure.
*/
int statvfs(const char* __path, struct statvfs* __buf) __INTRODUCED_IN(19);
/**
* [fstatvfs(3)](http://man7.org/linux/man-pages/man3/fstatvfs.3.html)
* queries filesystem statistics for the given file descriptor.
*
* Returns 0 on success, and returns -1 and sets `errno` on failure.
*/
int fstatvfs(int __fd, struct statvfs* __buf) __INTRODUCED_IN(19);
#endif
#if __ANDROID_API__ >= 21
// These functions are implemented as static inlines before API level 21.
/** Equivalent to statvfs(). */
int statvfs64(const char* __path, struct statvfs64* __buf) __INTRODUCED_IN(21);
/** Equivalent to fstatvfs(). */
int fstatvfs64(int __fd, struct statvfs64* __buf) __INTRODUCED_IN(21);
#endif
__END_DECLS
#include <android/legacy_sys_statvfs_inlines.h>