---
name: "Sys::Filesystem::Linux"
section: "3pm"
platform: "linux"
package: "libsys-filesystem-perl"
version: "1.408-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Sys::Filesystem::Linux"
---

# Sys::Filesystem::Linux(3pm)

Return Linux filesystem information to Sys::Filesystem

## NAME

Sys::Filesystem::Linux - Return Linux filesystem information to Sys::Filesystem

## SYNOPSIS

See Sys::Filesystem.

## INHERITANCE

```
  Sys::Filesystem::Linux
  ISA Sys::Filesystem::Unix
    ISA UNIVERSAL
```

## METHODS

- version ()

  Return the version of the (sub)module.

## ATTRIBUTES

The following is a list of filesystem properties which may be queried as methods through the parent Sys::Filesystem object.

- fs\_spec

  Describes the block special device or remote filesystem to be mounted.

  For  ordinary  mounts  it  will hold (a link to) a block special device node (as created by [**mknod**(8)](/mknod/8.md)) for  the  device  to  be  mounted, like '/dev/cdrom' or '/dev/sdb7'.  For NFS mounts one will  have \<host\>:\<dir\>, e.g., 'knuth.aeb.nl:/'.  For procfs, use 'proc'.

  Instead of giving the device explicitly, one may indicate the (ext2  or xfs)  filesystem that is to be mounted by its UUID or volume label (cf. [**e2label**(8)](/e2label/8.md) or  [**xfs\_admin**(8)](/xfs_admin/8.md)),  writing  LABEL=\<label\>  or  UUID=\<uuid\>, e.g., 'LABEL=Boot' or 'UUID=3e6be9de-8139-11d1-9106-a43f08d823a6'. This will make the system more robust: adding or removing a  SCSI  disk changes the disk device name but not the filesystem volume label.

- fs\_file

  Describes the mount point for the filesystem. For swap partitions, this field should be specified as 'none'. If the name of the mount point contains spaces these can be escaped as '\\040'.

- fs\_vfstype

  Dscribes the type  of  the  filesystem. Linux  supports  lots  of filesystem types, such as adfs, affs, autofs, coda, coherent, cramfs, devpts, efs, ext2, ext3,  hfs,  hpfs,  iso9660, jfs,  minix,  msdos,  ncpfs,  nfs,  ntfs,  proc, qnx4, reiserfs, romfs, smbfs, sysv, tmpfs, udf, ufs, umsdos, vfat, xenix,  xfs,  and  possibly others.  For more details, see [**mount**(8)](/mount/8.md).  For the filesystems currently supported by the running kernel, see /proc/filesystems.  An entry  swap denotes a file or partition to be used for swapping, cf. [**swapon**(8)](/swapon/8.md).  An entry ignore causes the line to be ignored.  This  is  useful  to  show disk partitions which are currently unused.

- fs\_mntops

  Describes the mount options associated with the filesystem.

  It is formatted as a comma separated list of options.  It  contains  at least  the type of mount plus any additional options appropriate to the filesystem type.  For documentation on the available options  for  non- nfs  file systems, see [**mount**(8)](/mount/8.md).  For documentation on all nfs-specific options have a look at [**nfs**(5)](/nfs/5.md).  Common for all types of file system are the options 'noauto' (do not mount when 'mount -a' is given, e.g., at boot time), 'user' (allow a user  to  mount),  and  'owner'  (allow device  owner to mount), and '\_netdev' (device requires network to be available).  The 'owner' and '\_netdev' options are  Linux-specific. For more details, see [**mount**(8)](/mount/8.md).

- fs\_freq

  Used  for  these filesystems by the [**dump**(8)](/dump/8.md) command to determine which filesystems need to be  dumped.   If the  fifth  field  is not present, a value of zero is returned and dump will assume that the filesystem does not need to be dumped.

- fs\_passno

  Used by the [**fsck**(8)](/fsck/8.md) program to  determine the order in which filesystem checks are done at reboot time.  The root filesystem should be specified with a fs\_passno of  1,  and  other filesystems  should  have a fs\_passno of 2.  Filesystems within a drive will be checked sequentially, but filesystems on different drives  will be  checked  at  the  same time to utilize parallelism available in the hardware.  If the sixth field is not present or zero, a value  of  zero is  returned  and fsck will assume that the filesystem does not need to be checked.

## SEE ALSO

Sys::Filesystem, Sys::Filesystem::Unix, [**fstab**(5)](/fstab/5.md)

## AUTHOR

Nicola Worthington \<nicolaw@cpan.org\> - \<http://perlgirl.org.uk\>

Jens Rehsack \<rehsack@cpan.org\> - \<http://www.rehsack.de/\>

## COPYRIGHT

Copyright 2004,2005,2006 Nicola Worthington.

Copyright 2009-2020 Jens Rehsack.

This software is licensed under The Apache Software License, Version 2.0.

\<http://www.apache.org/licenses/LICENSE-2.0\>