oshi.software.os.mac.MacFileSystem Maven / Gradle / Ivy
The newest version!
/*
* Copyright 2016-2023 The OSHI Project Contributors
* SPDX-License-Identifier: MIT
*/
package oshi.software.os.mac;
import java.io.File;
import java.nio.charset.StandardCharsets;
import java.nio.file.PathMatcher;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.regex.Pattern;
import java.util.stream.Collectors;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.sun.jna.Native;
import com.sun.jna.Pointer;
import com.sun.jna.platform.mac.CoreFoundation;
import com.sun.jna.platform.mac.CoreFoundation.CFDictionaryRef;
import com.sun.jna.platform.mac.CoreFoundation.CFMutableDictionaryRef;
import com.sun.jna.platform.mac.CoreFoundation.CFStringRef;
import com.sun.jna.platform.mac.DiskArbitration;
import com.sun.jna.platform.mac.DiskArbitration.DADiskRef;
import com.sun.jna.platform.mac.DiskArbitration.DASessionRef;
import com.sun.jna.platform.mac.IOKit.IOIterator;
import com.sun.jna.platform.mac.IOKit.IORegistryEntry;
import com.sun.jna.platform.mac.IOKitUtil;
import com.sun.jna.platform.mac.SystemB;
import com.sun.jna.platform.mac.SystemB.Statfs;
import oshi.annotation.concurrent.ThreadSafe;
import oshi.software.common.AbstractFileSystem;
import oshi.software.os.OSFileStore;
import oshi.util.FileSystemUtil;
import oshi.util.platform.mac.CFUtil;
import oshi.util.platform.mac.SysctlUtil;
/**
* The Mac File System contains {@link oshi.software.os.OSFileStore}s which are a storage pool, device, partition,
* volume, concrete file system or other implementation specific means of file storage. In macOS, these are found in the
* /Volumes directory.
*/
@ThreadSafe
public class MacFileSystem extends AbstractFileSystem {
private static final Logger LOG = LoggerFactory.getLogger(MacFileSystem.class);
public static final String OSHI_MAC_FS_PATH_EXCLUDES = "oshi.os.mac.filesystem.path.excludes";
public static final String OSHI_MAC_FS_PATH_INCLUDES = "oshi.os.mac.filesystem.path.includes";
public static final String OSHI_MAC_FS_VOLUME_EXCLUDES = "oshi.os.mac.filesystem.volume.excludes";
public static final String OSHI_MAC_FS_VOLUME_INCLUDES = "oshi.os.mac.filesystem.volume.includes";
private static final List FS_PATH_EXCLUDES = FileSystemUtil
.loadAndParseFileSystemConfig(OSHI_MAC_FS_PATH_EXCLUDES);
private static final List FS_PATH_INCLUDES = FileSystemUtil
.loadAndParseFileSystemConfig(OSHI_MAC_FS_PATH_INCLUDES);
private static final List FS_VOLUME_EXCLUDES = FileSystemUtil
.loadAndParseFileSystemConfig(OSHI_MAC_FS_VOLUME_EXCLUDES);
private static final List FS_VOLUME_INCLUDES = FileSystemUtil
.loadAndParseFileSystemConfig(OSHI_MAC_FS_VOLUME_INCLUDES);
// Regexp matcher for /dev/disk1 etc.
private static final Pattern LOCAL_DISK = Pattern.compile("/dev/disk\\d");
// User specifiable flags.
private static final int MNT_RDONLY = 0x00000001;
private static final int MNT_SYNCHRONOUS = 0x00000002;
private static final int MNT_NOEXEC = 0x00000004;
private static final int MNT_NOSUID = 0x00000008;
private static final int MNT_NODEV = 0x00000010;
private static final int MNT_UNION = 0x00000020;
private static final int MNT_ASYNC = 0x00000040;
private static final int MNT_CPROTECT = 0x00000080;
private static final int MNT_EXPORTED = 0x00000100;
private static final int MNT_QUARANTINE = 0x00000400;
private static final int MNT_LOCAL = 0x00001000;
private static final int MNT_QUOTA = 0x00002000;
private static final int MNT_ROOTFS = 0x00004000;
private static final int MNT_DOVOLFS = 0x00008000;
private static final int MNT_DONTBROWSE = 0x00100000;
private static final int MNT_IGNORE_OWNERSHIP = 0x00200000;
private static final int MNT_AUTOMOUNTED = 0x00400000;
private static final int MNT_JOURNALED = 0x00800000;
private static final int MNT_NOUSERXATTR = 0x01000000;
private static final int MNT_DEFWRITE = 0x02000000;
private static final int MNT_MULTILABEL = 0x04000000;
private static final int MNT_NOATIME = 0x10000000;
private static final Map OPTIONS_MAP = new HashMap<>();
static {
OPTIONS_MAP.put(MNT_SYNCHRONOUS, "synchronous");
OPTIONS_MAP.put(MNT_NOEXEC, "noexec");
OPTIONS_MAP.put(MNT_NOSUID, "nosuid");
OPTIONS_MAP.put(MNT_NODEV, "nodev");
OPTIONS_MAP.put(MNT_UNION, "union");
OPTIONS_MAP.put(MNT_ASYNC, "asynchronous");
OPTIONS_MAP.put(MNT_CPROTECT, "content-protection");
OPTIONS_MAP.put(MNT_EXPORTED, "exported");
OPTIONS_MAP.put(MNT_QUARANTINE, "quarantined");
OPTIONS_MAP.put(MNT_LOCAL, "local");
OPTIONS_MAP.put(MNT_QUOTA, "quotas");
OPTIONS_MAP.put(MNT_ROOTFS, "rootfs");
OPTIONS_MAP.put(MNT_DOVOLFS, "volfs");
OPTIONS_MAP.put(MNT_DONTBROWSE, "nobrowse");
OPTIONS_MAP.put(MNT_IGNORE_OWNERSHIP, "noowners");
OPTIONS_MAP.put(MNT_AUTOMOUNTED, "automounted");
OPTIONS_MAP.put(MNT_JOURNALED, "journaled");
OPTIONS_MAP.put(MNT_NOUSERXATTR, "nouserxattr");
OPTIONS_MAP.put(MNT_DEFWRITE, "defwrite");
OPTIONS_MAP.put(MNT_MULTILABEL, "multilabel");
OPTIONS_MAP.put(MNT_NOATIME, "noatime");
}
@Override
public List getFileStores(boolean localOnly) {
// List of file systems
return getFileStoreMatching(null, localOnly);
}
// Called by MacOSFileStore
static List getFileStoreMatching(String nameToMatch) {
return getFileStoreMatching(nameToMatch, false);
}
private static List getFileStoreMatching(String nameToMatch, boolean localOnly) {
List fsList = new ArrayList<>();
// Use getfsstat to find fileSystems
// Query with null to get total # required
int numfs = SystemB.INSTANCE.getfsstat64(null, 0, 0);
if (numfs > 0) {
// Open a DiskArbitration session to get VolumeName of file systems
// with bsd names
DASessionRef session = DiskArbitration.INSTANCE
.DASessionCreate(CoreFoundation.INSTANCE.CFAllocatorGetDefault());
if (session == null) {
LOG.error("Unable to open session to DiskArbitration framework.");
} else {
CFStringRef daVolumeNameKey = CFStringRef.createCFString("DAVolumeName");
// Create array to hold results
Statfs s = new Statfs();
Statfs[] fs = (Statfs[]) s.toArray(numfs);
// Fill array with results
numfs = SystemB.INSTANCE.getfsstat64(fs, fs[0].size() * fs.length, SystemB.MNT_NOWAIT);
for (int f = 0; f < numfs; f++) {
// Mount on name will match mounted path, e.g. /Volumes/foo
// Mount to name will match canonical path., e.g., /dev/disk0s2
// Byte arrays are null-terminated strings
// Get volume and path name, and type
String volume = Native.toString(fs[f].f_mntfromname, StandardCharsets.UTF_8);
String path = Native.toString(fs[f].f_mntonname, StandardCharsets.UTF_8);
String type = Native.toString(fs[f].f_fstypename, StandardCharsets.UTF_8);
// Skip non-local drives if requested, skip system types
final int flags = fs[f].f_flags;
// Skip non-local drives if requested, and exclude pseudo file systems
if ((localOnly && (flags & MNT_LOCAL) == 0) || !path.equals("/")
&& (PSEUDO_FS_TYPES.contains(type) || FileSystemUtil.isFileStoreExcluded(path, volume,
FS_PATH_INCLUDES, FS_PATH_EXCLUDES, FS_VOLUME_INCLUDES, FS_VOLUME_EXCLUDES))) {
continue;
}
String description = "Volume";
if (LOCAL_DISK.matcher(volume).matches()) {
description = "Local Disk";
} else if (volume.startsWith("localhost:") || volume.startsWith("//") || volume.startsWith("smb://")
|| NETWORK_FS_TYPES.contains(type)) {
description = "Network Drive";
}
File file = new File(path);
String name = file.getName();
// getName() for / is still blank, so:
if (name.isEmpty()) {
name = file.getPath();
}
if (nameToMatch != null && !nameToMatch.equals(name)) {
continue;
}
StringBuilder options = new StringBuilder((MNT_RDONLY & flags) == 0 ? "rw" : "ro");
String moreOptions = OPTIONS_MAP.entrySet().stream().filter(e -> (e.getKey() & flags) > 0)
.map(Map.Entry::getValue).collect(Collectors.joining(","));
if (!moreOptions.isEmpty()) {
options.append(',').append(moreOptions);
}
String uuid = "";
// Use volume to find DiskArbitration volume name and search for
// the registry entry for UUID
String bsdName = volume.replace("/dev/disk", "disk");
if (bsdName.startsWith("disk")) {
// Get the DiskArbitration dictionary for this disk,
// which has volumename
DADiskRef disk = DiskArbitration.INSTANCE.DADiskCreateFromBSDName(
CoreFoundation.INSTANCE.CFAllocatorGetDefault(), session, volume);
if (disk != null) {
CFDictionaryRef diskInfo = DiskArbitration.INSTANCE.DADiskCopyDescription(disk);
if (diskInfo != null) {
// get volume name from its key
Pointer result = diskInfo.getValue(daVolumeNameKey);
name = CFUtil.cfPointerToString(result);
diskInfo.release();
}
disk.release();
}
// Search for bsd name in IOKit registry for UUID
CFMutableDictionaryRef matchingDict = IOKitUtil.getBSDNameMatchingDict(bsdName);
if (matchingDict != null) {
// search for all IOservices that match the bsd name
IOIterator fsIter = IOKitUtil.getMatchingServices(matchingDict);
if (fsIter != null) {
// getMatchingServices releases matchingDict
// Should only match one logical drive
IORegistryEntry fsEntry = fsIter.next();
if (fsEntry != null && fsEntry.conformsTo("IOMedia")) {
// Now get the UUID
uuid = fsEntry.getStringProperty("UUID");
if (uuid != null) {
uuid = uuid.toLowerCase(Locale.ROOT);
}
fsEntry.release();
}
fsIter.release();
}
}
}
fsList.add(new MacOSFileStore(name, volume, name, path, options.toString(),
uuid == null ? "" : uuid, "", description, type, file.getFreeSpace(), file.getUsableSpace(),
file.getTotalSpace(), fs[f].f_ffree, fs[f].f_files));
}
daVolumeNameKey.release();
// Close DA session
session.release();
}
}
return fsList;
}
@Override
public long getOpenFileDescriptors() {
return SysctlUtil.sysctl("kern.num_files", 0);
}
@Override
public long getMaxFileDescriptors() {
return SysctlUtil.sysctl("kern.maxfiles", 0);
}
@Override
public long getMaxFileDescriptorsPerProcess() {
return SysctlUtil.sysctl("kern.maxfilesperproc", 0);
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy