new Creates a new Sys::Filesystem object. "new" accepts following optional key value pairs to help or
force where mount information is gathered from. These values are not otherwise defaulted by the main
Sys::Filesystem object, but left to the platform specific helper modules to determine as an exercise
of common sense.
canondev
Specify whether device path's shall be resolved when they're a symbolic link.
$Sys::Filesystem::CANONDEV is used when no key "canondev" is passed.
fstab
Specify the full path and filename of the filesystem table (or fstab for short). Not all
platforms have such a file and so this option may be ignored on some systems.
$Sys::Filesystem::FSTAB is used when no key "fstab" is passed.
mtab
Specify the full path and filename of the mounted filesystem table (or mtab for short). Not all
platforms have such a file and so this option may be ignored on some systems.
$Sys::Filesystem::MTAB is used when no key "mtab" is passed.
xtab
DEPRECIATED Specify the full path and filename of the mounted NFS filesystem table (or xtab for
short). This is usually only pertinent to Unix bases systems. Not all helper modules will query
NFS mounts as a separate exercise, and therefore this option may be ignored on some systems.
None of the OS plugins use that tunable (anymore?), so now a warning is raised when it's used.
The entire support will be removed not before 2015. Once that happened, using "xtab" will raise
an exception.
aliases
Overrides internal aliasing table used to match queries against OS plugin. This should be used
only when dealing with closed source platform helper module(s).
supported
Returns true if the operating system is supported by Sys::Filesystem. Unsupported operating systems
may get less information, e.g. the mount state couldn't determined or which file system type is
special isn't known.
ListingFilesystemsfilesystems()
Returns a list of all filesystem. May accept an optional list of key pair values in order to
filter/restrict the results which are returned. The restrictions are evaluated to match as much as
possible, so asking for regular and special file system (or mounted and special file systems), you'll
get all.
For better understanding, please imagine the parameters like:
@fslist = $fs->filesystems( mounted => 1, special => 1 );
# results similar as
SELECT mountpoint FROM filesystems WHERE mounted = 1 OR special = 1
If you need other selection choices, please take a look at DBD::Sys.
Valid values are as follows:
device => "string"
Returns only filesystems that are mounted using the device of "string". For example:
my $fdd_filesytem = Sys::Filesystem->filesystems(device => "/dev/fd0");
mounted => 1
Returns only filesystems which can be confirmed as actively mounted. (Filesystems which are
mounted).
The mounted_filesystems() method is an alias for this syntax.
unmounted => 1
Returns only filesystems which cannot be confirmed as actively mounted. (Filesystems which are
not mounted).
The unmounted_filesystems() method is an alias for this syntax.
special => 1
Returns only filesystems which are regarded as special in some way. A filesystem is marked as
special by the operating specific helper module. For example, a tmpfs type filesystem on one
operating system might be regarded as a special filesystem, but not on others. Consult the
documentation of the operating system specific helper module for further information about your
system. (Sys::Filesystem::Linux for Linux or Sys::Filesystem::Solaris for Solaris etc).
This parameter is mutually exclusive to "regular".
The special_filesystems() method is an alias for this syntax.
regular => 1
Returns only fileystems which are not regarded as special. (Normal filesystems).
This parameter is mutually exclusive to "special".
The regular_filesystems() method is an alias for this syntax.
mounted_filesystems()
Returns a list of all filesystems which can be verified as currently being mounted.
unmounted_filesystems()
Returns a list of all filesystems which cannot be verified as currently being mounted.
special_filesystems()
Returns a list of all fileystems which are considered special. This will usually contain meta and
swap partitions like /proc and /dev/shm on Linux.
regular_filesystems()
Returns a list of all filesystems which are not considered to be special.
FilesystemProperties
Available filesystem properties and their names vary wildly between platforms. Common aliases have been
provided wherever possible. You should check the documentation of the specific platform helper module to
list all of the properties which are available for that platform. For example, read the
Sys::Filesystem::Linux documentation for a list of all filesystem properties available to query under
Linux.
mount_point() or filesystem()
Returns the friendly name of the filesystem. This will usually be the same name as appears in the
list returned by the filesystems() method.
mounted()
Returns boolean true if the filesystem is mounted.
label()
Returns the fileystem label.
This functionality may need to be retrofitted to some original OS specific helper modules as of
Sys::Filesystem 1.12.
volume()
Returns the volume that the filesystem belongs to or is mounted on.
This functionality may need to be retrofitted to some original OS specific helper modules as of
Sys::Filesystem 1.12.
device()
Returns the physical device that the filesystem is connected to.
special()
Returns boolean true if the filesystem type is considered "special".
type() or format()
Returns the type of filesystem format. fat32, ntfs, ufs, hpfs, ext3, xfs etc.
options()
Returns the options that the filesystem was mounted with. This may commonly contain information such
as read-write, user and group settings and permissions.
mount_order()
Returns the order in which this filesystem should be mounted on boot.
check_order()
Returns the order in which this filesystem should be consistency checked on boot.
check_frequency()
Returns how often this filesystem is checked for consistency.
Install Now
SVG Icons
PNG Icons