Kanrisuru

mount

Mount a filesystem on a remote server in ruby
linux manual

Basic Usage

require 'kanrisuru'
host = Kanrisuru::Remote::Host.new(host: '127.0.1.1', username: 'ubuntu', keys: ['~/.ssh/id_rsa'])

host.su('root')
result = host.mount(
  label: 'backup-disk',
  uuid: '5fbaea960d09e2ad',
  type: 'ext4',
  fs_opts: { 
    async: true, 
    auto: true, 
    group: true, 
    relatime: true, 
    owner: true 
  },
  device: '/dev/vda2',
  directory: '/mnt/backup'
)

result.success?
true

Parameters

Field Type Description
label string
 		Human readable filesystem identifier.
uuid string
 		Filesystem universally unique identifier. The format of the UUID is usually a series of hex digits separated by hyphens.
fake string
 		Causes everything to be done except for the actual system call; if it’s not obvious, this "fakes" mounting the filesystem.
internal_only string
 		Don’t call the /sbin/mount.filesystem helper even if it exists.
sloppy string
 		Tolerate sloppy mount options rather than failing. This will ignore mount options not supported by a filesystem type. Not all filesystems support this option.
no_mtab string
 		Mount without writing in /etc/mtab. This is necessary for example when /etc is on a read-only filesystem.
no_canonicalize boolean
 		Don’t canonicalize paths. The mount command canonicalizes all paths (from the command line or fstab) by default. It is strongly recommended to not use this command-line option for normal mount operations.
type string
 		The filysystem type. See Fs Mount Opts for a list of all file system types.
fs_opts string
 		Combination of the common options, and file system specific options. See Fs Mount Opts for a list of all options.
all boolean
 		Mount all filesystems (of the given types) mentioned in fstab (except for those whose line contains the noauto keyword).
device string
 		Which device should be mounted.
directory string
 		The directory to mount a device.

Result

No explicit data struct returned, only option is success?, failure?, and status to see if the program exited properly.

Exit Status

Code Description
0 Success
1 Incorrect invocation or permissions
2 System error (out of memory, cannot fork, no more loop devices)
4 Internal mount bug
8 User interrupt
16 Problems writing or locking /etc/mtab
32 Mount failure
64 Some mount failed, some succeeded

Tested On

  • Ubuntu, Debian, Centos, Fedora, Redhat, OpenSuse, SLES
On this page