Resource Type: mount

NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700

mount

Description

Manages mounted filesystems, including putting mount information into the mount table. The actual behavior depends on the value of the ‘ensure’ parameter.

Refresh: mount resources can respond to refresh events (via notify, subscribe, or the ~> arrow). If a mount receives an event from another resource and its ensure attribute is set to mounted, Puppet will try to unmount then remount that filesystem.

Autorequires: If Puppet is managing any parents of a mount resource — that is, other mount points higher up in the filesystem — the child mount will autorequire them.

Autobefores: If Puppet is managing any child file paths of a mount point, the mount resource will autobefore them.

Attributes

mount { 'resource title':
  name        => # (namevar) The mount path for the...
  ensure      => # Control what to do with this mount. Set this...
  atboot      => # Whether to mount the mount at boot.  Not all...
  blockdevice => # The device to fsck.  This is property is only...
  device      => # The device providing the mount.  This can be...
  dump        => # Whether to dump the mount.  Not all platform...
  fstype      => # The mount type.  Valid values depend on the...
  options     => # A single string containing options for the...
  pass        => # The pass in which the mount is...
  provider    => # The specific backend to use for this `mount...
  remounts    => # Whether the mount can be remounted  `mount -o...
  target      => # The file in which to store the mount table....
  # ...plus any applicable metaparameters.
}

To learn more about the applicable metaparameters, see the Metaparameters reference.

name

(Namevar: If omitted, this attribute’s value defaults to the resource’s title.)

The mount path for the mount.

(↑ Back to mount attributes)

ensure

(Property: This attribute represents concrete state on the target system.)

Control what to do with this mount. Set this attribute to unmounted to make sure the filesystem is in the filesystem table but not mounted (if the filesystem is currently mounted, it will be unmounted). Set it to absent to unmount (if necessary) and remove the filesystem from the fstab. Set to mounted to add it to the fstab and mount it. Set to present to add to fstab but not change mount/unmount status.

Allowed values:

  • defined
  • present
  • unmounted
  • absent
  • mounted

(↑ Back to mount attributes)

atboot

(Property: This attribute represents concrete state on the target system.)

Whether to mount the mount at boot. Not all platforms support this.

(↑ Back to mount attributes)

blockdevice

(Property: This attribute represents concrete state on the target system.)

The device to fsck. This is property is only valid on Solaris, and in most cases will default to the correct value.

(↑ Back to mount attributes)

device

(Property: This attribute represents concrete state on the target system.)

The device providing the mount. This can be whatever device is supporting by the mount, including network devices or devices specified by UUID rather than device path, depending on the operating system.

(↑ Back to mount attributes)

dump

(Property: This attribute represents concrete state on the target system.)

Whether to dump the mount. Not all platforms support this.

Default: 0.

Allowed values:

  • 1
  • 0
  • 2 on FreeBSD

(↑ Back to mount attributes)

fstype

(Property: This attribute represents concrete state on the target system.)

The mount type. Valid values depend on the operating system. This is a required option.

(↑ Back to mount attributes)

options

(Property: This attribute represents concrete state on the target system.)

A single string containing options for the mount, as they would appear in fstab on Linux. For many platforms this is a comma-delimited string. Consult the fstab(5) man page for system-specific details. AIX options other than dev, nodename, or vfs can be defined here. If specified, AIX options of account, boot, check, free, mount, size, type, vol, log, and quota must be ordered alphabetically at the end of the list.

(↑ Back to mount attributes)

pass

(Property: This attribute represents concrete state on the target system.)

The pass in which the mount is checked.

(↑ Back to mount attributes)

provider

The specific backend to use for this mount resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

Available providers are:

(↑ Back to mount attributes)

remounts

Whether the mount can be remounted mount -o remount. If this is false, then the filesystem will be unmounted and remounted manually, which is prone to failure.

Allowed values:

  • true
  • false

(↑ Back to mount attributes)

target

(Property: This attribute represents concrete state on the target system.)

The file in which to store the mount table. Only used by those providers that write to disk.

(↑ Back to mount attributes)

Providers

parsed

  • Required binaries: mount, umount
  • Supported features: refreshable

Provider Features

Available features:

  • refreshable — The provider can remount the filesystem.

Provider support:

Provider refreshable
parsed

NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700