mkcfsmnt Command

Commands Reference, Volume 3

mkcfsmnt Command

Purpose

Mounts a CacheFS directory..

Syntax

mkcfsmnt -d PathName -t { nfs | cdrom} ] [-h RemoteHost ] [ -p { RemoteDirectory | LocalDeviceName } ] [ -c CacheDirectory ] [ -o MountOptions ] [ -b BackingFileSystem ] [ -I | -B | -N ]

Description

The mkcfsmnt command constructs an entry that will be appended to the /etc/filesystems file, thus making a file system available for use as a cache file system. If the mount is to be permanent, this entry will remain. If the mount is temporary, the flags will be used directly for the mount command. CacheFS file systems are used to cache accesses to backing file systems. Backing file systems are generally NFS mounts.

Flags

-d PathName

Specifies the mount point for the cache directory.

-t

Selects file systems to be cached.

nfs	Specifies that the CacheFS file system is backed by an NFS mount.
cdrom	Specifies that the CacheFS file system is backed by a CDROM file system. (Currently not supported.)

-h RemoteHost

Specifies the NFS server that is exporting the directory.

-p RemoteDirectory

Specifies the directory that is mounted on the path name specified. This is commonly a remote file system that will be mounted via NFS or a local device name in the case of CDROM (Currently not supported.)

-c CacheDirectory

Specifies the location of the CacheFS file system. This must have been previously created by execution of the cfsadmin command.

-d RemoteDirectory

Specifies the directory that is mounted on the path name specified.

-o MountOptions

Specifies a comma-separated string of mount options that are dependent on the backing file system type. For instance, if it is NFS, the options would be those typically specified by the -o Options string to mount. See the mount command documentation for the acceptable values.

-b BackingFileSystem

Specifies a backing file system if it is already mounted. If this is not specified, then the command will do the mount itself on a temporary mount point. If this is not specified, then RemoteHost and RemoteDirectory must be specified.

-I

Causes an entry to be added to the /etc/filesystems file. The directory is not mounted.

-B

Adds an entry to the /etc/filesystems file and attempts to mount the file system. This flag is the default.

-N

Mounts the directory with the options specified, but does not modify the /etc/filesystems file.

Example

To specify a CacheFS mount, enter:

/usr/sbin/mkcfsmnt -t nfs -d /usr/share/man -p /usr/share/man -h host1 -c /cache/cache1 -o ro, intr -N

In this example, the mkcfsmnt command caches the remote directory /usr/share/man that resides on host1 on the local /usr/share/man directory. The cache is kept in /cache/cache1, which was created with the cfsadmin command. CacheFS takes care of doing the NFS backing mount, since the -b flag has not been specified.

/usr/sbin/mkcfsmnt -t nfs -d /usr/share/man -p /usr/share/man -h host1 -c /cache/cache1 -b /backs/man -o ro, intr -N

In this example, the mkcfsmnt command caches the remote directory /usr/share/man residing on host1 on the local /usr/share/man directory. The cache is kept in /cache/cache1, which was created with the cfsadmin command. The backing file system has already been mounted on /backs/man.

Files

/etc/filesystems

Lists the remote file systems to be mounted during the system restart.