mount_cachefs(1M)														 mount_cachefs(1M)

NAME

       mount_cachefs: mount, umount - mount and unmount CacheFS file systems

SYNOPSIS


	      [specific_options] resource mount_point

       mount_point

DESCRIPTION

       The  utility  attaches  a  named  resource to the file system hierarchy at the pathname location mount_point, which must already exist.	If
       mount_point has any contents prior to the operation, the contents remain hidden until the resource is once again unmounted.   The  CacheFS-
       specific  version  of the command mounts a cached file system; if necessary, it NFS-mounts its back file system.  It also provides a number
       of options that are CacheFS-specific for controlling the caching process.

       CacheFS can be used only with NFSv2 or NFSv3.  It cannot be used with NFSv4.  If NFSv4 is enabled by default CacheFS  mount  fails,  unless
       the user specifies that vers is 2 or 3.	See mount_nfs(1M) for the description of vers.

       The utility unmounts mounted file systems.

       Only a superuser can mount and unmount file systems.

       See mount_nfs(1M) for the description of resource.

   Options (mount)
       See mount(1M) for the description of the options.

       Set file system specific options according to a comma-separated
	    list with no intervening spaces.  Notice that the backfstype argument must be specified.
	    Specifies  that cached attributes are held for no more than n seconds after directory update.  After n seconds, all directory informa-
	    tion is purged from the cache.  The default value is seconds.

	    Specifies that cached attributes are held
		   for at least n seconds after directory update.  After n seconds, CacheFS checks to see if the directory  modification  time	on
		   the	back  file  system  has  changed.  If it has, all information about the directory is purged from the cache and new data is
		   retrieved from the back file system.  The default value is seconds.

	    Specifies that cached attributes are held for no more than
		   n seconds after file modification.  After n seconds, all file information is purged from the cache.	The default value is  sec-
		   onds.

	    Specifies that cached attributes are held for at least
		   n  seconds after file modification.	After n seconds, CacheFS checks to see if the file modification time on the back file sys-
		   tem has changed.  If it has, all information about the file is purged from the cache and new data is retrieved  from  the  back
		   file system.  The default value is seconds.

	    Sets   and to n.

	    The file system type of the back file system (for
		   example,

	    Specifies where the back file system is already mounted.
		   If this argument is not supplied, CacheFS determines a mount point for the back file system.

	    The name of the cache directory.

	    ID	   is a string specifying a particular instance of a cache.  If you do not specify a cache ID, CacheFS will construct one.

	    Verifies cache consistency only when explicitly
		   requested,  rather than periodic checking that is done by default.  A consistency check is requested by using the option of the
		   command.  This option is useful for back file systems that change infrequently, for example, The and are mutually exclusive.

	    Causes the front file system to interpret the mode bits
		   used for access checking instead of having the back file system verify access permissions.	Do  not  use  this  argument  with
		   secure NFS .

	    Disables cache consistency checking.
		   By  default,  periodic consistency checking is enabled.  Specify only when you know that the back file system will not be modi-
		   fied.  Trying to perform cache consistency check using will result in error.  The and are mutually exclusive.

	    Disable ACL functionality.
		   If you try to change ACL entries for a file on a CacheFS file system mounted with the option an error is returned.  However, if
		   you	try  to  get  the  ACL	entries for a file, CacheFS will return fabricated ACL entries by using UNIX file permissions.	By
		   default, the CacheFS file system supports ACL functionality.  See aclv(5) for a description of ACL entries.

	    Purge any cached information for the specified file
		   system.

	    Remounts a read-only file system as read-write (using
		   the rw option).

	    If specified when mounting a CacheFS file system, a
		   binary will be read and populated in the cache the first time it is loaded.	Subsequent access to the binary will be  satisfied
		   from the cache.

	    Read-write (default) or read-only.

	    Allow (default) or disallow set-uid execution.

	    Verifies the cache consistency with the NFS client's
		   copy  of  file  attributes, and coordinates with bakfs (NFS) for delayed flushing of modified pages to the server.  The delayed
		   flushing of pages improves CacheFS response times.  The must not be used when multiple clients are  modifying  the  same  file.
		   The and options are mutually exclusive.

	    Write modes for CacheFS.
		   The	mode (the default) handles writes the same as NFS does; that is, writes are made to the back file system, and the affected
		   file is purged from the cache.  You can use the mode when you are sure that no one else will be writing to the cached file sys-
		   tem.  In this mode, all writes are made to both the front and the back file system, and the file remains in the cache.

       Overlay mount.
	    Allow  the	file  system  to  be  mounted over an existing mount point, making the underlying file system inaccessible.  If a mount is
	    attempted on a pre-existing mount point without setting this flag, the mount will fail, producing the error "device busy".

       When processing an unknown
	    specific_option, the utility prints a warning message and processes the next one.  This option prevents printing the warning message.

EXAMPLES

       CacheFS-mount the file system which is already NFS-mounted on as

       Lines similar to the following appear in the file after the command is executed:

       Mount a CacheFS filesystem over NFS Version 2.

AUTHOR

       was developed by Sun Microsystems, Inc.

SEE ALSO

       cfsadmin(1M), fsck_cachefs(1M), mount(1M).

																 mount_cachefs(1M)