oshi.software.os.FileSystem Maven / Gradle / Ivy

package oshi.software.os;

import java.io.Serializable;

/**
 * @author angju
 * 
 */
public interface FileSystem extends Serializable {

    /**
     * Get file stores on this machine
     *
     * Instantiates an array of {@link OSFileStore} objects, representing a
     * storage pool, device, partition, volume, concrete file system or other
     * implementation specific means of file storage.
     *
     * @return An array of OSFileStore objects or an empty array if none are
     *         present.
     */
    OSFileStore[] getFileStores();

    /**
     * The current number of open file descriptors. A file descriptor is an
     * abstract handle used to access I/O resources such as files and network
     * connections. On UNIX-based systems there is a system-wide limit on the
     * number of open file descriptors.
     *
     * On Windows systems, this method returns 0. While Windows handles are
     * conceptually similar to file descriptors, they may also refer to a number
     * of non-I/O related objects, and there does not appear to be a system-wide
     * limit for open handles.
     *
     * @return The number of open file descriptors if available, 0 otherwise.
     */
    long getOpenFileDescriptors();

    /**
     * The maximum number of open file descriptors. A file descriptor is an
     * abstract handle used to access I/O resources such as files and network
     * connections. On UNIX-based systems there is a system-wide limit on the
     * number of open file descriptors.
     *
     * On Windows systems, this method returns 0. While Windows handles are
     * conceptually similar to file descriptors, they may also refer to a number
     * of non-I/O related objects, and there does not appear to be a system-wide
     * limit for open handles.
     *
     * @return The maximum number of file descriptors if available, 0 otherwise.
     */
    long getMaxFileDescriptors();
}