hmcdrvfs - mount a FUSE file system for remote
access to a DVD in a HMC DVD drive
mounting:
hmcdrvfs MOUNTPOINT [OPTIONS]
unmounting:
Use the hmcdrvfs command for read-only access to files on a
DVD in the DVD drive of an HMC.
On the HMC, the DVD must be assigned to the
LPAR within which your Linux instance runs. For
z/VM guests, the DVD must be assigned to the
LPAR where the z/VM hypervisor runs. With the
DVD assigned to your Linux instance, this command creates a
FUSE.HMCDRVFS file system with the content of the
DVD at the specified mountpoint.
- -o
hmclang=LANG
- specify the language setting on the HMC; for valid values,
see locale(1); for more information, see DIAGNOSTICS and
EXAMPLES
- -o
hmctz=TZ
- specify the time zone setting on the HMC; for valid values,
see tzset(3); for more information, see DIAGNOSTICS and EXAMPLES
To mount the HMC drive DVD at
/mnt/hmc without any special options use:
In case the kernel module hmcdrv was not loaded in advance
use:
# modprobe hmcdrv
# hmcdrvfs /mnt/hmc
To translate the UID and GID of files on the HMC
drive DVD to your system users and groups along with
overriding the permissions use for example:
$ hmcdrvfs /mnt/hmc -o uid=500 -o gid=1000 -o umask=0337
To speed up transfer rates to frequently accessed directories use
the cache timeout option:
$ hmcdrvfs /mnt/hmc -o entry_timeout=60
If the HMC is in a different timezone and is configured for a
different language use, for example:
$ hmcdrvfs /mnt/hmc -o hmclang=de_DE -o hmctz=Europe/Berlin
or disregarding any daylight saving time, specifying hours west of
Prime Meridian (UTC):
$ hmcdrvfs /mnt/hmc -o hmclang=de_DE -o hmctz="GMT-1"
To unmount the HMC drive DVD mounted
on /mnt/hmc use:
It is also possible to mount by using fstab(5). Specify the
mount point and associated mount options in /etc/fstab, for
example:
hmcdrvfs /mnt/hmc fuse ro,noatime,allow_other,uid=500,gid=1000
You can then mount the file system with this command:
Some general options about mount policy can be set in the
/etc/fuse.conf file. These options are:
- mount_max=NNN
- Set the maximum number of FUSE mounts allowed to non-root
users. The default is 1000.
- user_allow_other
- Allow non-root users to specify the allow_other or
allow_root mount options.
- 1.
- The FUSE.HMCDRVFS file system needs access to device node
/dev/hmcdrv. This node is created automatically when the
hmcdrv kernel module is loaded (see Linux kernel configuration
option CONFIG_HMC_DRV). The user process that runs the
hmcdrvfs command must have sufficient privileges to read from and
write to node /dev/hmcdrv. Use the commands chown(1),
chgrp(1) and/or chmod(1) on node /dev/hmcdrv to
ensure this condition.
- 2.
- In addition to the required permissions, there are some environmental
requirements:
- -
- In a z/VM environment, the z/VM guest
virtual machine must have at least privilege class B.
- -
- For Linux in LPAR mode, the LPAR activation
profile must allow issuing SCLP requests.
- -
- On the HMC, the DVD must be assigned to the
associated system image (use menu Access Removable
Media).
- 3.
- The FUSE.HMCDRVFS file system maintains a file attributes
cache, with an aging timeout. This timeout is related to the
entry_timeout and attr_timeout FUSE options.
Its value exceeds the greater of the two, entry_timeout and
attr_timeout, by 30 - 60 seconds. This timeout affects the
performance of the FUSE.HMCDRVFS file system.
- 4.
- Different language and time zone settings on the HMC and
your Linux instance can result in incorrect file modification
information.
- -
- Use the hmclang specific FUSE.HMCDRVFS option if the
language settings of the HMC and your Linux instance do not
match. Correctly setting this option prevents incorrect file modification
dates in the file details. Omitting the hmclang option can result
in incorrect dates of the form 01-01-YYYY, with misleading values for the
day and month.
- -
- Use the hmctz specific FUSE.HMCDRVFS option if the
time zone settings of the HMC and your Linux instance do
not match. Correctly setting this option prevents incorrect file
modification times in the file details. Omitting hmctz, an
incorrect specification, or a missing time zone description file can
result in modification times that differ up to 25 hours from the correct
times. Specifications that cannot be interpreted result in GMT/UTC being
set. If the HMC is set to GMT/UTC, specify
hmctz="".
- 5.
- The following generic mount options from mount(8) are ignored:
- 6.
- The following FUSE mount options from mount.fuse(8)
are ignored: