sys-filesystem 1.5.5 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bff196a377aeaf2d5983fd6e15877a990c73e3fea18b6b94d7bc6a751d331419
-  data.tar.gz: 743b5452bd13840a977045a29a338b9240cfaa9eb0878385dcab66e9384c7335
+  metadata.gz: 6f90c58ef7ca15379ff41cffcd50a3686e048df7ae8e8a5ad9426983c79da6bc
+  data.tar.gz: 2675f569f9a8460f412e2b58084d8c269f20cac30c0d4b14ca042b72268300c0
 SHA512:
-  metadata.gz: 77443aaa680057b9e055a2c570a3fcbd8025f32ebc266d3b6628d775a5a4d5b9cc3dbaadf99d4ba584f8f5badb9ae8665ca9e557403c05efc28dd4358be94f18
-  data.tar.gz: b11463a784178cca2068211aa342de4b2e3c65acac6830bdea67b6793214f0f2b9ba0c5dda53a274837d7822201d2d90c89ba92d69dab6d7bf003d6c7fb2a15e
+  metadata.gz: 72241a34bb1556a24a6ba84b5dfaba655f61e4bb8dc83793994366260fcac80269f5a8cef091def654f30803478ad75766b667f85a6e352402d6effcc4e4f633
+  data.tar.gz: b95d9272c4e6a1afee451e571d1b90c61f17a1e95c707892508348fb78acc02425962b93350ae944675a896cf2da04551f2f95225b8d24ef3c4b9bd27d3ca706

data/CHANGES.md

@@ -1,3 +1,10 @@
+## 1.6.0 - 15-Jun-2026
+* Big refactor for BSD mainly, adds statfs, and zfs related properties if
+  you're using ZFS. Also works for Linux on ZFS.
+* Split out constants into platform specific files for easier maintenance.
+* Add MNT_NFS4ACLS constant for FreeBSD.
+* Update mount and umount methods, preferring nmount where supported.
+
 ## 1.5.5 - 6-Dec-2025
 * Replaced string concatenation operators with addition assignment operators
   since the current code generates a frozen string warning with Ruby 3.4 and

data/README.md

@@ -81,7 +81,7 @@ Apache-2.0
 
 ## Copyright
 
-(C) 2003-2025 Daniel J. Berger
+(C) 2003-2026 Daniel J. Berger
 All Rights Reserved
 
 ## Warranty

data/lib/sys/filesystem.rb

@@ -16,11 +16,25 @@ module Sys
   # return objects of other types. Do not instantiate.
   class Filesystem
     # The version of the sys-filesystem library
-    VERSION = '1.5.5'
+    VERSION = '1.6.0'
 
     # Stat objects are returned by the Sys::Filesystem.stat method. Here
     # we're adding universal methods.
     class Stat
+      ZFS_PROPERTIES = {
+        zfs_atime: 'atime',
+        zfs_casesensitivity: 'casesensitivity',
+        zfs_compression: 'compression',
+        zfs_compressratio: 'compressratio',
+        zfs_devices: 'devices',
+        zfs_exec: 'exec',
+        zfs_quota: 'quota',
+        zfs_readonly: 'readonly',
+        zfs_recordsize: 'recordsize',
+        zfs_reservation: 'reservation',
+        zfs_setuid: 'setuid'
+      }.freeze
+
       # Returns true if the filesystem is case sensitive for the current path.
       # Typically this will be any path on MS Windows or Macs using HFS.
       #
@@ -31,10 +45,15 @@ module Sys
       def case_insensitive?
         if path =~ /\w+/
           File.identical?(path, path.swapcase)
-        elsif RbConfig::CONFIG['host_os'] =~ /darwin|mac|windows|mswin|mingw/i
-          true # Assumes HFS/APFS on Mac
         else
-          false
+          zfs_case = zfs_case_insensitive?
+          return zfs_case unless zfs_case.nil?
+
+          if RbConfig::CONFIG['host_os'] =~ /darwin|mac|windows|mswin|mingw/i
+            true # Assumes HFS/APFS on Mac
+          else
+            false
+          end
         end
       end
 
@@ -43,6 +62,57 @@ module Sys
       def case_sensitive?
         !case_insensitive?
       end
+
+      # Returns a native ZFS property value for this path's dataset.
+      # Returns nil if the path is not on ZFS or libzfs is unavailable.
+      def zfs_property(property)
+        return nil unless base_type == 'zfs'
+        return nil unless Sys::Filesystem.respond_to?(:zfs_property, true)
+
+        dataset = zfs_dataset
+        return nil unless dataset
+
+        Sys::Filesystem.send(:zfs_property, dataset, property.to_s)
+      rescue SystemCallError
+        nil
+      end
+
+      ZFS_PROPERTIES.each do |method_name, property|
+        define_method(method_name) do
+          zfs_property(property)
+        end
+      end
+
+      private
+
+      def zfs_case_insensitive?
+        return nil unless base_type == 'zfs'
+
+        value = zfs_property('casesensitivity')
+        return nil unless value
+
+        case value.strip
+          when 'insensitive'
+            true
+          when 'sensitive'
+            false
+          else
+            nil
+        end
+      rescue SystemCallError
+        nil
+      end
+
+      def zfs_dataset
+        return mount_source if respond_to?(:mount_source) && mount_source
+
+        mount_point = Sys::Filesystem.mount_point(path)
+        mount = Sys::Filesystem.mounts.find{ |mnt| mnt.mount_point == mount_point }
+
+        mount&.name
+      rescue SystemCallError
+        nil
+      end
     end
   end
 end

data/lib/sys/unix/sys/filesystem/constants/bsd.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Sys
+  class Filesystem
+    module Constants
+      MNT_RDONLY      = 0x00000001 # read only filesystem
+      MNT_SYNCHRONOUS = 0x00000002 # file system written synchronously
+      MNT_NOEXEC      = 0x00000004 # can't exec from filesystem
+      MNT_NOSUID      = 0x00000008 # don't honor setuid bits on fs
+      MNT_UNION       = 0x00000020 # union with underlying filesystem
+      MNT_ASYNC       = 0x00000040 # file system written asynchronously
+      MNT_EXPORTED    = 0x00000100 # filesystem is exported
+      MNT_LOCAL       = 0x00001000 # filesystem is stored locally
+      MNT_QUOTA       = 0x00002000 # quotas are enabled on filesystem
+      MNT_ROOTFS      = 0x00004000 # identifies the root filesystem
+      MNT_NOATIME     = 0x10000000 # disable update of file access time
+
+      MNT_VISFLAGMASK = (
+        MNT_RDONLY | MNT_SYNCHRONOUS | MNT_NOEXEC |
+        MNT_NOSUID | MNT_UNION | MNT_ASYNC |
+        MNT_EXPORTED | MNT_LOCAL | MNT_QUOTA |
+        MNT_ROOTFS | MNT_NOATIME
+      )
+
+      MNT_FORCE = 1
+
+      MOUNT_OPTION_NAMES = {
+        MNT_RDONLY => 'read-only',
+        MNT_SYNCHRONOUS => 'synchronous',
+        MNT_NOEXEC => 'noexec',
+        MNT_NOSUID => 'nosuid',
+        MNT_UNION => 'union',
+        MNT_ASYNC => 'asynchronous',
+        MNT_EXPORTED => 'exported',
+        MNT_LOCAL => 'local',
+        MNT_QUOTA => 'quotas',
+        MNT_ROOTFS => 'rootfs',
+        MNT_NOATIME => 'noatime'
+      }.freeze
+    end
+  end
+end

data/lib/sys/unix/sys/filesystem/constants/darwin.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Sys
+  class Filesystem
+    module Constants
+      MNT_RDONLY      = 0x00000001 # read only filesystem
+      MNT_SYNCHRONOUS = 0x00000002 # file system written synchronously
+      MNT_NOEXEC      = 0x00000004 # can't exec from filesystem
+      MNT_NOSUID      = 0x00000008 # don't honor setuid bits on fs
+      MNT_NODEV       = 0x00000010 # don't interpret special files
+      MNT_UNION       = 0x00000020 # union with underlying filesystem
+      MNT_ASYNC       = 0x00000040 # file system written asynchronously
+      MNT_CPROTECT    = 0x00000080 # file system supports content protection
+      MNT_EXPORTED    = 0x00000100 # file system is exported
+      MNT_QUARANTINE  = 0x00000400 # file system is quarantined
+      MNT_LOCAL       = 0x00001000 # filesystem is stored locally
+      MNT_QUOTA       = 0x00002000 # quotas are enabled on filesystem
+      MNT_ROOTFS      = 0x00004000 # identifies the root filesystem
+      MNT_DOVOLFS     = 0x00008000 # FS supports volfs (deprecated)
+      MNT_DONTBROWSE  = 0x00100000 # FS is not appropriate path to user data
+      MNT_IGNORE_OWNERSHIP = 0x00200000 # VFS will ignore ownership info on FS objects
+      MNT_AUTOMOUNTED = 0x00400000 # filesystem was mounted by automounter
+      MNT_JOURNALED   = 0x00800000 # filesystem is journaled
+      MNT_NOUSERXATTR = 0x01000000 # Don't allow user extended attributes
+      MNT_DEFWRITE    = 0x02000000 # filesystem should defer writes
+      MNT_MULTILABEL  = 0x04000000 # MAC support for individual labels
+      MNT_NOATIME     = 0x10000000 # disable update of file access time
+      MNT_NOCLUSTERR  = 0x40000000 # disable cluster read
+      MNT_NOCLUSTERW  = 0x80000000 # disable cluster write
+
+      MNT_VISFLAGMASK = (
+        MNT_RDONLY | MNT_SYNCHRONOUS | MNT_NOEXEC |
+        MNT_NOSUID | MNT_NODEV | MNT_UNION |
+        MNT_ASYNC  | MNT_EXPORTED | MNT_QUARANTINE |
+        MNT_LOCAL  | MNT_QUOTA |
+        MNT_ROOTFS | MNT_DOVOLFS | MNT_DONTBROWSE |
+        MNT_IGNORE_OWNERSHIP | MNT_AUTOMOUNTED | MNT_JOURNALED |
+        MNT_NOUSERXATTR | MNT_DEFWRITE | MNT_MULTILABEL |
+        MNT_NOATIME | MNT_CPROTECT
+      )
+
+      MNT_FORCE = 1
+
+      MOUNT_OPTION_NAMES = {
+        MNT_RDONLY => 'read-only',
+        MNT_SYNCHRONOUS => 'synchronous',
+        MNT_NOEXEC => 'noexec',
+        MNT_NOSUID => 'nosuid',
+        MNT_NODEV => 'nodev',
+        MNT_UNION => 'union',
+        MNT_ASYNC => 'asynchronous',
+        MNT_CPROTECT => 'content-protection',
+        MNT_EXPORTED => 'exported',
+        MNT_QUARANTINE => 'quarantined',
+        MNT_LOCAL => 'local',
+        MNT_QUOTA => 'quotas',
+        MNT_ROOTFS => 'rootfs',
+        MNT_DONTBROWSE => 'nobrowse',
+        MNT_IGNORE_OWNERSHIP => 'noowners',
+        MNT_AUTOMOUNTED => 'automounted',
+        MNT_JOURNALED => 'journaled',
+        MNT_NOUSERXATTR => 'nouserxattr',
+        MNT_DEFWRITE => 'defwrite',
+        MNT_NOATIME => 'noatime'
+      }.freeze
+    end
+  end
+end

data/lib/sys/unix/sys/filesystem/constants/dragonfly.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative 'bsd'

data/lib/sys/unix/sys/filesystem/constants/freebsd.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Sys
+  class Filesystem
+    module Constants
+      MNT_RDONLY      = 0x0000000000000001 # read only filesystem
+      MNT_SYNCHRONOUS = 0x0000000000000002 # file system written synchronously
+      MNT_NOEXEC      = 0x0000000000000004 # can't exec from filesystem
+      MNT_NOSUID      = 0x0000000000000008 # don't honor setuid bits on fs
+      MNT_NFS4ACLS    = 0x0000000000000010 # enable NFS version 4 ACLs
+      MNT_UNION       = 0x0000000000000020 # union with underlying filesystem
+      MNT_ASYNC       = 0x0000000000000040 # file system written asynchronously
+      MNT_EXRDONLY    = 0x0000000000000080 # exported read only
+      MNT_EXPORTED    = 0x0000000000000100 # filesystem is exported
+      MNT_DEFEXPORTED = 0x0000000000000200 # exported to the world
+      MNT_EXPORTANON  = 0x0000000000000400 # anon uid mapping for all
+      MNT_EXKERB      = 0x0000000000000800 # exported with Kerberos
+      MNT_LOCAL       = 0x0000000000001000 # filesystem is stored locally
+      MNT_QUOTA       = 0x0000000000002000 # quotas are enabled on filesystem
+      MNT_ROOTFS      = 0x0000000000004000 # identifies the root filesystem
+      MNT_USER        = 0x0000000000008000 # mounted by a user
+      MNT_SUIDDIR     = 0x0000000000100000 # special SUID dir handling
+      MNT_SOFTDEP     = 0x0000000000200000 # using soft updates
+      MNT_NOSYMFOLLOW = 0x0000000000400000 # do not follow symlinks
+      MNT_IGNORE      = 0x0000000000800000 # do not show entry in df
+      MNT_GJOURNAL    = 0x0000000002000000 # GEOM journal support enabled
+      MNT_MULTILABEL  = 0x0000000004000000 # MAC support for objects
+      MNT_ACLS        = 0x0000000008000000 # ACL support enabled
+      MNT_NOATIME     = 0x0000000010000000 # disable update of file access time
+      MNT_EXPUBLIC    = 0x0000000020000000 # public export (WebNFS)
+      MNT_NOCLUSTERR  = 0x0000000040000000 # disable cluster read
+      MNT_NOCLUSTERW  = 0x0000000080000000 # disable cluster write
+      MNT_SUJ         = 0x0000000100000000 # using journaled soft updates
+      MNT_AUTOMOUNTED = 0x0000000200000000 # filesystem was mounted by automounter
+      MNT_VERIFIED    = 0x0000000400000000 # filesystem is verified
+      MNT_UNTRUSTED   = 0x0000000800000000 # filesystem metadata is untrusted
+      MNT_NAMEDATTR   = 0x0000020000000000 # named attributes enabled
+
+      MNT_VISFLAGMASK = (
+        MNT_RDONLY | MNT_SYNCHRONOUS | MNT_NOEXEC |
+        MNT_NOSUID | MNT_NFS4ACLS | MNT_UNION |
+        MNT_ASYNC | MNT_EXRDONLY | MNT_EXPORTED |
+        MNT_DEFEXPORTED | MNT_EXPORTANON | MNT_EXKERB |
+        MNT_LOCAL | MNT_USER | MNT_QUOTA |
+        MNT_ROOTFS | MNT_NOATIME | MNT_NOCLUSTERR |
+        MNT_NOCLUSTERW | MNT_SUIDDIR | MNT_SOFTDEP |
+        MNT_IGNORE | MNT_EXPUBLIC | MNT_NOSYMFOLLOW |
+        MNT_GJOURNAL | MNT_MULTILABEL | MNT_ACLS |
+        MNT_NFS4ACLS | MNT_AUTOMOUNTED | MNT_VERIFIED |
+        MNT_UNTRUSTED | MNT_NAMEDATTR
+      )
+
+      MNT_UPDATE    = 0x0000000000010000
+      MNT_DELEXPORT = 0x0000000000020000
+      MNT_RELOAD    = 0x0000000000040000
+      MNT_FORCE     = 0x0000000000080000
+      MNT_SNAPSHOT  = 0x0000000001000000
+      MNT_NONBUSY   = 0x0000000004000000
+      MNT_BYFSID    = 0x0000000008000000
+      MNT_NOCOVER   = 0x0000001000000000
+      MNT_EMPTYDIR  = 0x0000002000000000
+      MNT_RECURSE   = 0x0000100000000000
+      MNT_DEFERRED  = 0x0000200000000000
+
+      MOUNT_OPTION_NAMES = {
+        MNT_RDONLY => 'read-only',
+        MNT_SYNCHRONOUS => 'synchronous',
+        MNT_NOEXEC => 'noexec',
+        MNT_NOSUID => 'nosuid',
+        MNT_NFS4ACLS => 'nfsv4acls',
+        MNT_UNION => 'union',
+        MNT_ASYNC => 'asynchronous',
+        MNT_EXRDONLY => 'exported-read-only',
+        MNT_EXPORTED => 'exported',
+        MNT_DEFEXPORTED => 'defexported',
+        MNT_EXPORTANON => 'exportanon',
+        MNT_EXKERB => 'exkerb',
+        MNT_LOCAL => 'local',
+        MNT_USER => 'user',
+        MNT_QUOTA => 'quotas',
+        MNT_ROOTFS => 'rootfs',
+        MNT_NOATIME => 'noatime',
+        MNT_NOCLUSTERR => 'noclusterr',
+        MNT_NOCLUSTERW => 'noclusterw',
+        MNT_SUIDDIR => 'suiddir',
+        MNT_SOFTDEP => 'soft-updates',
+        MNT_IGNORE => 'ignore',
+        MNT_EXPUBLIC => 'public',
+        MNT_NOSYMFOLLOW => 'nosymfollow',
+        MNT_GJOURNAL => 'gjournal',
+        MNT_MULTILABEL => 'multilabel',
+        MNT_ACLS => 'acls',
+        MNT_AUTOMOUNTED => 'automounted',
+        MNT_VERIFIED => 'verified',
+        MNT_UNTRUSTED => 'untrusted',
+        MNT_NAMEDATTR => 'namedattr'
+      }.freeze
+    end
+  end
+end

data/lib/sys/unix/sys/filesystem/constants/generic.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Sys
+  class Filesystem
+    module Constants
+      MNT_RDONLY = 0x00000001
+      MNT_NOSUID = 0x00000002
+
+      MNT_VISFLAGMASK = MNT_RDONLY | MNT_NOSUID
+
+      MNT_FORCE = 1
+
+      MOUNT_OPTION_NAMES = {
+        MNT_RDONLY => 'read-only',
+        MNT_NOSUID => 'nosuid'
+      }.freeze
+    end
+  end
+end

data/lib/sys/unix/sys/filesystem/constants/linux.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Sys
+  class Filesystem
+    module Constants
+      MS_RDONLY = 1
+      MS_NOSUID = 2
+      MS_NODEV = 4
+      MS_NOEXEC = 8
+      MS_SYNCHRONOUS = 16
+      MS_REMOUNT = 32
+      MS_MANDLOCK = 64
+      MS_DIRSYNC = 128
+      MS_NOATIME = 1024
+      MS_NODIRATIME = 2048
+      MS_BIND = 4096
+      MS_MOVE = 8192
+      MS_REC = 16_384
+      MS_SILENT = 32_768
+      MS_POSIXACL = 1 << 16
+      MS_UNBINDABLE = 1 << 17
+      MS_PRIVATE = 1 << 18
+      MS_SLAVE = 1 << 19
+      MS_SHARED = 1 << 20
+      MS_RELATIME = 1 << 21
+      MS_KERNMOUNT = 1 << 22
+      MS_I_VERSION = 1 << 23
+      MS_STRICTATIME = 1 << 24
+      MS_ACTIVE = 1 << 30
+      MS_NOUSER = 1 << 31
+
+      MNT_RDONLY = MS_RDONLY
+      MNT_NOSUID = MS_NOSUID
+      MNT_NODEV = MS_NODEV
+      MNT_NOEXEC = MS_NOEXEC
+
+      MNT_FORCE = 1
+      MNT_DETACH = 2
+      MNT_EXPIRE = 4
+      UMOUNT_NOFOLLOW = 8
+    end
+  end
+end

data/lib/sys/unix/sys/filesystem/constants.rb

@@ -1,74 +1,16 @@
 # frozen_string_literal: true
 
-module Sys
-  class Filesystem
-    module Constants
-      MNT_RDONLY      = 0x00000001 # read only filesystem
-      MNT_SYNCHRONOUS = 0x00000002 # file system written synchronously
-      MNT_NOEXEC      = 0x00000004 # can't exec from filesystem
-      MNT_NOSUID      = 0x00000008 # don't honor setuid bits on fs
-      MNT_NODEV       = 0x00000010 # don't interpret special files
-      MNT_UNION       = 0x00000020 # union with underlying filesystem
-      MNT_ASYNC       = 0x00000040 # file system written asynchronously
-      MNT_CPROTECT    = 0x00000080 # file system supports content protection
-      MNT_EXPORTED    = 0x00000100 # file system is exported
-      MNT_QUARANTINE  = 0x00000400 # file system is quarantined
-      MNT_LOCAL       = 0x00001000 # filesystem is stored locally
-      MNT_QUOTA       = 0x00002000 # quotas are enabled on filesystem
-      MNT_ROOTFS      = 0x00004000 # identifies the root filesystem
-      MNT_DOVOLFS     = 0x00008000 # FS supports volfs (deprecated)
-      MNT_DONTBROWSE  = 0x00100000 # FS is not appropriate path to user data
-      MNT_IGNORE_OWNERSHIP = 0x00200000 # VFS will ignore ownership info on FS objects
-      MNT_AUTOMOUNTED = 0x00400000 # filesystem was mounted by automounter
-      MNT_JOURNALED   = 0x00800000 # filesystem is journaled
-      MNT_NOUSERXATTR = 0x01000000 # Don't allow user extended attributes
-      MNT_DEFWRITE    = 0x02000000 # filesystem should defer writes
-      MNT_MULTILABEL  = 0x04000000 # MAC support for individual labels
-      MNT_NOATIME     = 0x10000000 # disable update of file access time
-      MNT_NOCLUSTERR  = 0x40000000 # disable cluster read
-      MNT_NOCLUSTERW  = 0x80000000 # disable cluster write
+require 'rbconfig'
 
-      MNT_VISFLAGMASK = (
-        MNT_RDONLY | MNT_SYNCHRONOUS | MNT_NOEXEC |
-        MNT_NOSUID | MNT_NODEV | MNT_UNION |
-        MNT_ASYNC  | MNT_EXPORTED | MNT_QUARANTINE |
-        MNT_LOCAL  | MNT_QUOTA |
-        MNT_ROOTFS | MNT_DOVOLFS | MNT_DONTBROWSE |
-        MNT_IGNORE_OWNERSHIP | MNT_AUTOMOUNTED | MNT_JOURNALED |
-        MNT_NOUSERXATTR | MNT_DEFWRITE | MNT_MULTILABEL |
-        MNT_NOATIME | MNT_CPROTECT
-      )
-
-      MS_RDONLY = 1
-      MS_NOSUID = 2
-      MS_NODEV = 4
-      MS_NOEXEC = 8
-      MS_SYNCHRONOUS = 16
-      MS_REMOUNT = 32
-      MS_MANDLOCK = 64
-      MS_DIRSYNC = 128
-      MS_NOATIME = 1024
-      MS_NODIRATIME = 2048
-      MS_BIND = 4096
-      MS_MOVE = 8192
-      MS_REC = 16384
-      MS_SILENT = 32768
-      MS_POSIXACL = 1 << 16
-      MS_UNBINDABLE = 1 << 17
-      MS_PRIVATE = 1 << 18
-      MS_SLAVE = 1 << 19
-      MS_SHARED = 1 << 20
-      MS_RELATIME = 1 << 21
-      MS_KERNMOUNT = 1 << 22
-      MS_I_VERSION = 1 << 23
-      MS_STRICTATIME = 1 << 24
-      MS_ACTIVE = 1 << 30
-      MS_NOUSER = 1 << 31
-
-      MNT_FORCE = 1
-      MNT_DETACH = 2
-      MNT_EXPIRE = 4
-      UMOUNT_NOFOLLOW = 8
-    end
-  end
+case RbConfig::CONFIG['host_os']
+  when /linux/i
+    require_relative 'constants/linux'
+  when /freebsd/i
+    require_relative 'constants/freebsd'
+  when /darwin|osx|mach/i
+    require_relative 'constants/darwin'
+  when /dragonfly/i
+    require_relative 'constants/dragonfly'
+  else
+    require_relative 'constants/generic'
 end

data/lib/sys/unix/sys/filesystem/functions.rb

@@ -20,7 +20,12 @@ module Sys
         end
       end
 
+      def self.zfs_supported?
+        !!(RbConfig::CONFIG['host_os'] =~ /freebsd|linux/i)
+      end
+
       private_class_method :linux64?
+      private_class_method :zfs_supported?
 
       if linux64?
         begin
@@ -32,8 +37,40 @@ module Sys
         attach_function(:statvfs, %i[string pointer], :int)
       end
 
+      if RbConfig::CONFIG['host_os'] =~ /darwin|osx|mach|bsd|dragonfly/i
+        attach_function(:statfs, %i[string pointer], :int)
+      end
+
       attach_function(:strerror, [:int], :string)
-      attach_function(:mount_c, :mount, %i[string string string ulong string], :int)
+
+      if RbConfig::CONFIG['host_os'] =~ /linux/i
+        attach_function(:mount_c, :mount, %i[string string string ulong string], :int)
+      else
+        attach_function(:mount_c, :mount, %i[string string int pointer], :int)
+      end
+
+      if RbConfig::CONFIG['host_os'] =~ /freebsd/i
+        attach_function(:nmount_c, :nmount, %i[pointer uint int], :int)
+      end
+
+      if zfs_supported?
+        begin
+          ffi_lib FFI::Library::LIBC, 'zfs'
+
+          attach_function(:libzfs_init, [], :pointer)
+          attach_function(:libzfs_fini, [:pointer], :void)
+          attach_function(:zfs_open, %i[pointer string int], :pointer)
+          attach_function(:zfs_close, [:pointer], :void)
+          attach_function(:zfs_name_to_prop, [:string], :int)
+          attach_function(
+            :zfs_prop_get,
+            %i[pointer int pointer size_t pointer pointer size_t int],
+            :int
+          )
+        rescue FFI::NotFoundError, LoadError
+          # libzfs is optional. ZFS-specific helpers fall back when unavailable.
+        end
+      end
 
       if RbConfig::CONFIG['host_os'] =~ /darwin|osx|mach|bsd|dragonfly/i
         attach_function(:umount_c, :unmount, %i[string int], :int)
@@ -42,6 +79,18 @@ module Sys
       end
 
       private_class_method :statvfs, :strerror, :mount_c, :umount_c
+      private_class_method :statfs if method_defined?(:statfs)
+      private_class_method :nmount_c if method_defined?(:nmount_c)
+      if method_defined?(:libzfs_init)
+        private_class_method(
+          :libzfs_init,
+          :libzfs_fini,
+          :zfs_open,
+          :zfs_close,
+          :zfs_name_to_prop,
+          :zfs_prop_get
+        )
+      end
 
       begin
         attach_function(:getmntent, [:pointer], :pointer)

data/lib/sys/unix/sys/filesystem/structs.rb

@@ -256,6 +256,14 @@ module Sys
           :mnt_passno, :int
         )
       end
+
+      # The Iovec struct is used by FreeBSD's nmount(2).
+      class Iovec < FFI::Struct
+        layout(
+          :iov_base, :pointer,
+          :iov_len, :size_t
+        )
+      end
     end
   end
 end