mnttab(4)




NAME

     mnttab - mounted file system table


DESCRIPTION

     The file /etc/mnttab is really a file system  that  provides
     read-only  access  to  the table of mounted file systems for
     the current host. /etc/mnttab is read by programs using  the
     routines  described in getmntent(3C). Mounting a file system
     adds an entry to this table.  Unmounting  removes  an  entry
     from  this table. Remounting a file system causes the infor-
     mation in the mounted file system table  to  be  updated  to
     reflect any changes caused by the remount. The list is main-
     tained by the kernel in order of mount time.  That  is,  the
     first  mounted file system is first in the list and the most
     recently mounted file system is  last.  When  mounted  on  a
     mount  point  the file system appears as a regular file con-
     taining the current mnttab information.

     Each entry is a line of fields separated by  <TAB>s  in  the
     form:

     special   mount_point   fstype   options   time

     where:

     special
           The name of the resource that has been mounted.

     mount_point
           The pathname of the directory on which the  filesystem
           is mounted.

     fstype
           The file system type of the mounted file system.

     options
           The mount options. See respective  mount  file  system
           man page in the SEE ALSO section below.

     time  The time at which the file system was mounted.

     Examples of entries for the special field include the  path-
     name  of  a  block-special device, the name of a remote file
     system in the form of host:pathname, or the name of  a  swap
     file, for example, a file made with mkfile(1M).


IOCTLS

     The following ioctl(2) calls are supported:

     MNTIOC_NMNTS
           Returns the count of mounted resources in the  current
           snapshot in the uint32_t pointed to by arg.

     MNTIOC_GETDEVLIST
           Returns an array of uint32_t's that is twice  as  long
           as  the  length returned by MNTIOC_NMNTS. Each pair of
           numbers  is the major and minor device number for  the
           file system at the corresponding
            line in the current /etc/mnttab snapshot. arg  points
           to  the  memory  buffer  to  receive the device number
           information.

     MNTIOC_SETTAG
           Sets a tag word into the options list  for  a  mounted
           file  system.  A tag is a notation that will appear in
           the options string of a mounted file system but it  is
           not recognized or interpreted by the file system code.
           arg points to a filled  in  mnttagdesc  structure,  as
           shown in the following example:

     uint_t  mtd_major; /* major number for mounted fs */
     uint_t  mtd_minor; /* minor number for mounted fs */
     char    *mtd_mntpt; /* mount point of file system */
     char    *mtd_tag;  /* tag to set/clear */

          If the tag already exists then it is marked as set  but
          not re-added. Tags can be at most MAX_MNTOPT_TAG long.

     MNTIOC_CLRTAG
           Marks a tag in the options list  for  a  mounted  file
           system as not set. arg points to the same structure as
           MNTIOC_SETTAG, which identifies the  file  system  and
           tag to be cleared.


ERRORS

     EFAULT
           The arg pointer in an MNTIOC_ ioctl call pointed to an
           inaccessible memory location or a character pointer in
           a mnttagdesc  structure  pointed  to  an  inaccessible
           memory location.

     EINVAL
           The tag specified  in  a  MNTIOC_SETTAG  call  already
           exists  as  a file system option, or the tag specified
           in a MNTIOC_CLRTAG call does not exist.

     ENAMETOOLONG
           The tag specified in a MNTIOC_SETTAG call is too  long
           or  the  tag would make the total length of the option
           string for the mounted file system too long.


FILES

     /etc/mnttab
           Usual mount point for mnttab file system

     /usr/include/sys/mntio.h
           Header file that contains IOCTL definitions


SEE ALSO

     mkfile(1M),        mount_cachefs(1M),        mount_hsfs(1M),
     mount_nfs(1M),   mount_pcfs(1M),  mount_ufs(1M),  mount(1M),
     ioctl(2), read(2), poll(2), stat(2), getmntent(3C)


WARNINGS

     The mnttab file system provides the previously  undocumented
     dev=xxx  option  in  the option string for each mounted file
     system. This is provided for legacy applications that  might
     have been using the dev=information option.

     Using dev=option in applications  is  strongly  discouraged.
     The  device  number string represents a  32-bit quantity and
     might not contain correct  information  in  64-bit  environ-
     ments.

     Applications requiring device number information for mounted
     file  systems  should  use  the  getextmntent(3C) interface,
     which functions properly in either 32-  or  64-bit  environ-
     ments.


NOTES

     The snapshot of the mnttab information is taken any  time  a
     read(2)  is  performed  at  offset  0 (the beginning) of the
     mnttab file. The file modification time returned by  stat(2)
     for  the  mnttab  file  is  the  time  of the last change to
     mounted file  system  information.  A  poll(2)  system  call
     requesting  a POLLRDBAND event can be used to block and wait
     for the system's mounted file system information to be  dif-
     ferent  from  the most recent snapshot since the mnttab file
     was opened.


Man(1) output converted with man2html