fstinfo(1M)                                                     fstinfo(1M)

NAME
     fstinfo - report information about installed file system types

SYNOPSIS
     fstinfo [-p] -t [attributes]

     fstinfo [-p] -F FSType

DESCRIPTION
     The system is configured with a number of file system types (FSTypes).
     Some of these are used for data storage (local or remote), others are
     used to access kernel data structures and a few are used internally by
     the system. In the future, other file system types may become avail-
     able that provide a different service.

     Due to this proliferation of different FSTypes, it becomes convenient
     to group FSTypes by certain attributes. One can then obtain specific
     information given an attribute or an FSType. fstinfo provides an
     interface to do just that. It prints the attributes of the installed
     file system types (FSTypes).

     Currently, attributes are divided into two categories: "allocation"
     attributes and "accessibility" attributes.

     The allocation attributes will be either disk-based or kernel-based. A
     disk-based file system type means there are physical blocks in the
     file system. A kernel-based file system type has no (user-visible)
     physical storage. (Note that a memory disk qualifies as physical
     storage as far as file systems are concerned.)

     The accessibility attributes are dependent upon the allocation attri-
     butes as follows:

     disk-based        The attributes will be either local or remote.

     kernel-based      The attributes will be either internal or applica-
                       tion.

     disk-based file system types hold user data on a physical disk some-
     where. The disk space can either be local or remote. Examples of these
     FSTypes are: ufs and nfs.

     kernel-based file system types are not oriented around manipulating
     physical storage. Rather, they provide a file-system-like interface to
     other objects. They are currently categorized by whether they have a
     user interface or not:

     -  kernel-based application file system types are those that have a
        user-level interface and/or utilities. These file systems need to
        be mounted via the mount(1M) utility. Examples of these FSTypes
        are: proc and fdfs.




Page 1                       Reliant UNIX 5.44                Printed 11/98

fstinfo(1M)                                                     fstinfo(1M)

     -  kernel-based internal file system types are those that are of
        interest only to the kernel and do not have user level interfaces
        or utilities. They are automatically "mounted". Examples of these
        FSTypes are: specfs and fifofs.

OPTIONS
     -p   Prints the output in a format that is easily parsed (the default
          is a more human-readable format).

     -t   Lists all installed FSTypes that have the given attributes. If no
          attributes are given, show all FSTypes and their attributes. The
          exit status is the number of FSTypes that match the given attri-
          butes.

     -F   Displays the attributes of the given FSType (FSType names are
          obtainable via the -t option).

EXAMPLES
     fstinfo -t

     fdfs:            kernel-based application filesystem.
     fifofs:          kernel-based internal    filesystem.
     namefs:          kernel-based application filesystem.
     nfs:             disk-based   remote      filesystem.
     proc:            kernel-based application filesystem.
     sockfs:          kernel-based internal    filesystem.
     specfs:          kernel-based internal    filesystem.
     ttyfs:           kernel-based internal    filesystem.
     ufs:             disk-based   local       filesystem.
     vxfs:            disk-based   local       filesystem.

     fstinfo -t disk-based local remote

     nfs:             disk-based   remote      filesystem.
     ufs:             disk-based   local       filesystem.
     vxfs:            disk-based   local       filesystem.

     fstinfo -t kernel-based

     fdfs:            kernel-based application filesystem.
     fifofs:          kernel-based internal    filesystem.
     namefs:          kernel-based application filesystem.
     proc:            kernel-based application filesystem.
     sockfs:          kernel-based internal    filesystem.
     specfs:          kernel-based internal    filesystem.
     ttyfs:           kernel-based internal    filesystem.

     fstinfo -F vxfs

     vxfs:            disk-based   local       filesystem.




Page 2                       Reliant UNIX 5.44                Printed 11/98

fstinfo(1M)                                                     fstinfo(1M)

     fstinfo -F proc

     proc:            kernel-based application filesystem.

DIAGNOSTICS
     Other than stated above, the exit status is 0 unless there was an
     error, in which case it will be 255.

NOTES
     The internal kernel-based file system types should really be kept hid-
     den from users (they are completely internal to the system and are of
     no interest to users). However, since other utilities and system calls
     refer to them, they are included here.

SEE ALSO
     df(1), fsminfo(1M), mount(1M), sysfs(2), vfstab(4).






































Page 3                       Reliant UNIX 5.44                Printed 11/98