Mounts a CacheFS directory.
mkcfsmnt -d PathName -t { nfs | cdrom} ] [ -h RemoteHost ] [ -p { RemoteDirectory | LocalDeviceName } ] [ -c CacheDirectory ] [ -o MountOptions ] [ -b BackingFileSystem ] [ -I | -B | -N ]
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.
| Item | Description |
|---|---|
| -d PathName | Specifies the mount point for the cache directory. |
| -t | Selects file systems to be cached.
|
| -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. |
To specify a CacheFS mount, type:
/usr/sbin/mkcfsmnt -t nfs -d /usr/share/man -p /usr/share/man -h host1 -c
/cache/cache1 -o ro, intr -NIn 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, because 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 -NIn 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.
| Item | Description |
|---|---|
| /etc/filesystems | Lists the remote file systems to be mounted during the system restart. |