Propellor.Property.Mount

Properties in this module ensure that things are currently mounted, but without making the mount persistent. Use Fstab to configure persistent mounts.

Documentation

type FsType = String

type of filesystem to mount ("auto" to autodetect)

type Source = String

A device or other thing to be mounted.

type MountPoint = FilePath

A mount point for a filesystem.

newtype MountOpts

Filesystem mount options. Eg, MountOpts ["errors=remount-ro"]

For default mount options, use mempty.

Constructors

MountOpts [String]

Instances

Monoid MountOpts

Defined in Propellor.Property.Mount

Methods

mempty :: MountOpts

mappend :: MountOpts -> MountOpts -> MountOpts

mconcat :: [MountOpts] -> MountOpts

Semigroup MountOpts

Defined in Propellor.Property.Mount

Methods

(<>) :: MountOpts -> MountOpts -> MountOpts

sconcat :: NonEmpty MountOpts -> MountOpts

stimes :: Integral b => b -> MountOpts -> MountOpts

ToMountOpts MountOpts

Defined in Propellor.Property.Mount

Methods

toMountOpts :: MountOpts -> MountOpts

class ToMountOpts a where

Methods

toMountOpts :: a -> MountOpts

Instances

ToMountOpts MountOpts

Defined in Propellor.Property.Mount

Methods

toMountOpts :: MountOpts -> MountOpts

ToMountOpts String

Defined in Propellor.Property.Mount

Methods

toMountOpts :: String -> MountOpts

formatMountOpts :: MountOpts -> String

mounted :: FsType -> Source -> MountPoint -> MountOpts -> Property UnixLike

Mounts a device, without listing it in /etc/fstab.

Note that this property will fail if the device is already mounted at the MountPoint.

bindMount :: FilePath -> FilePath -> Property Linux

Bind mounts the first directory so its contents also appear in the second directory.

swapOn :: Source -> RevertableProperty Linux Linux

Enables swapping to a device, which must be formatted already as a swap partition.

mount :: FsType -> Source -> MountPoint -> MountOpts -> IO Bool

mountPoints :: IO [MountPoint]

Lists all mount points of the system.

isMounted :: MountPoint -> IO Bool

Checks if anything is mounted at the MountPoint.

mountPointsBelow :: FilePath -> IO [MountPoint]

Finds all filesystems mounted inside the specified directory.

partialBindMountsOf :: FilePath -> IO [MountPoint]

Get mountpoints which are bind mounts of subdirectories of mounted filesystems

E.g. as created by mount --bind etcfoo etcbar where etcfoo is not itself a mount point, but just a subdirectory. These are sometimes known as "partial bind mounts"

getFsType :: MountPoint -> IO (Maybe FsType)

Filesystem type mounted at a given location.

getFsMountOpts :: MountPoint -> IO MountOpts

Mount options for the filesystem mounted at a given location.

type UUID = String

getMountUUID :: MountPoint -> IO (Maybe UUID)

UUID of filesystem mounted at a given location.

getSourceUUID :: Source -> IO (Maybe UUID)

UUID of a device

type Label = String

getMountLabel :: MountPoint -> IO (Maybe Label)

Label of filesystem mounted at a given location.

getSourceLabel :: Source -> IO (Maybe UUID)

Label of a device

getMountSource :: MountPoint -> IO (Maybe Source)

Device mounted at a given location.

getMountContaining :: FilePath -> IO (Maybe Source)

Device that a given path is located within.

findmntField :: String -> [String] -> IO (Maybe String)

blkidTag :: String -> Source -> IO (Maybe String)

umountLazy :: FilePath -> IO ()

Unmounts a device or mountpoint, lazily so any running processes don't block it.

Note that this will fail if it's not mounted.

unmountBelow :: FilePath -> IO ()

Unmounts anything mounted inside the specified directory, not including the directory itself.