Scroll to navigation

HMCDRVFS(1) General Commands Manual HMCDRVFS(1)

NAME

hmcdrvfs - mount a FUSE file system for remote access to a DVD in a HMC DVD drive

SYNOPSIS

mounting:

hmcdrvfs MOUNTPOINT [OPTIONS]


unmounting:




fusermount -u MOUNTPOINT












DESCRIPTION


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.








OPTIONS




General mount options



  

  
FUSE or mount command options; for the FUSE
      options see below, for mount options see mount(8)

  

  
print usage information, then exit (see also DIAGNOSTICS)

  

  
print version information, then exit
    

  








Specific FUSE.HMCDRVFS options



  

  
specify the language setting on the HMC; for valid values,
      see locale(1); for more information, see DIAGNOSTICS and
    EXAMPLES

  

  
specify the time zone setting on the HMC; for valid values,
      see tzset(3); for more information, see DIAGNOSTICS and EXAMPLES
    

  








Applicable FUSE options (version 2.6)



  

  
enable debug output (implies -f)

  

  
foreground operation

  

  
disable multi-threaded operation

  

  
allow access by other users

  

  
allow access by root

  

  
allow mounts over non-empty file/dir

  

  
enable permission checking by kernel

  

  
set file system name

  

  
set file system type

  

  
set maximum size of read requests

  

  
use direct I/O

  

  
cache files in kernel

  

  
enable caching based on modification times

  

  
set file permissions (octal)

  

  
set file owner

  

  
set file group

  

  
cache timeout for names (default: 1.0 second)

  

  
cache timeout for attributes (default: 1.0 second)

  

  
auto cache timeout for attributes (default: attr_timeout)

  

  
set maximum readahead

  

  
perform reads asynchronously (default)

  

  
perform reads synchronously

  

  
disable remote file locking

  

  
allow requests to be interrupted

  

  
signal to send on interrupt
    

    

  










EXAMPLES


To mount the HMC drive DVD at
    /mnt/hmc without any special options use:






$ hmcdrvfs /mnt/hmc






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:






$ fusermount -u /mnt/hmc






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:






# mount /mnt/hmc












FILES


Some general options about mount policy can be set in the
    /etc/fuse.conf file. These options are:



  

  
Set the maximum number of FUSE mounts allowed to non-root
      users. The default is 1000.

  

  
Allow non-root users to specify the allow_other or
      allow_root mount options.
    

  








DIAGNOSTICS



  
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:







  

  
mount the file system read/write

  

  
update inode access times on this file system









  
6.

  
The following FUSE mount options from mount.fuse(8)
      are ignored:







  

  
immediate removal

  

  
cache timeout for deleted names

  

  
set maximum size of write requests

  

  
enable atomic open+truncate support

  

  
enable larger than 4kB writes

  

  
prepend this directory to all paths

  

  
let file system set inode numbers

  

  
try to fill in d_ino in readdir












SEE ALSO


tzset(3), locale(1), fusermount(1),
    fstab(5), mount(8), mount.fuse(8) lshmc(8), and
    Linux on System z: Device Drivers, Features and Commands







  

    Mar 2015
    s390-tools