summaryrefslogtreecommitdiff
path: root/usr/src/man/man7fs/lofs.7fs
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man7fs/lofs.7fs')
-rw-r--r--usr/src/man/man7fs/lofs.7fs137
1 files changed, 0 insertions, 137 deletions
diff --git a/usr/src/man/man7fs/lofs.7fs b/usr/src/man/man7fs/lofs.7fs
deleted file mode 100644
index 7288fa82dd..0000000000
--- a/usr/src/man/man7fs/lofs.7fs
+++ /dev/null
@@ -1,137 +0,0 @@
-.\"
-.\" Copyright 2014 Nexenta Systems, Inc. All Rights Reserved.
-.\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
-.\" Copyright 2021 Oxide Computer Company
-.\"
-.\" The contents of this file are subject to the terms of the
-.\" Common Development and Distribution License (the "License").
-.\" You may not use this file except in compliance with the License.
-.\"
-.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
-.\" or http://www.opensolaris.org/os/licensing.
-.\" See the License for the specific language governing permissions
-.\" and limitations under the License.
-.\"
-.\" When distributing Covered Code, include this CDDL HEADER in each
-.\" file and include the License file at usr/src/OPENSOLARIS.LICENSE.
-.\" If applicable, add the following below this CDDL HEADER, with the
-.\" fields enclosed by brackets "[]" replaced with your own identifying
-.\" information: Portions Copyright [yyyy] [name of copyright owner]
-.\"
-.Dd November 24, 2014
-.Dt LOFS 7FS
-.Os
-.Sh NAME
-.Nm lofs
-.Nd loopback virtual file system
-.Sh SYNOPSIS
-.In sys/param.h
-.In sys/mount.h
-.Ft int
-.Fo mount
-.Fa "const char *dir"
-.Fa "const char *virtual"
-.Fa "int mflag"
-.Fa \(dqlofs\(dq ,
-.Fa NULL ,
-.Fa 0
-.Fc
-.Sh DESCRIPTION
-The loopback file system device allows new, virtual file systems to be created,
-which provide access to existing files using alternate pathnames.
-Once the virtual file system is created, other file systems can be mounted
-within it, without affecting the original file system.
-However, file systems which are subsequently mounted onto the original file
-system
-.Em are
-visible to the virtual file system, unless or until the corresponding mount
-point in the virtual file system is covered by a file system mounted there.
-.Pp
-.Fa virtual
-is the mount point for the virtual file system.
-.Fa dir
-is the pathname of the existing file system.
-.Fa mflag
-specifies the mount options; the
-.Dv MS_DATA
-bit in
-.Fa mflag
-must be set.
-If the
-.Dv MS_RDONLY
-bit in
-.Fa mflag
-is not set, accesses to the loop back file system are the same as for the
-underlying file system.
-Otherwise, all accesses in the loopback file system will be read-only.
-All other
-.Xr mount 2
-options are inherited from the underlying file systems.
-.Pp
-A loopback mount of
-.Pa /
-onto
-.Pa /tmp/newroot
-allows the entire file system hierarchy to appear as if it were duplicated under
-.Pa /tmp/newroot ,
-including any file systems mounted from remote NFS servers.
-All files would then be accessible either from a pathname relative to
-.Pa /
-or from a pathname relative to
-.Pa /tmp/newroot
-until such time as a file system is mounted in
-.Pa /tmp/newroot
-or any of its subdirectories.
-.Pp
-Loopback mounts of
-.Pa /
-can be performed in conjunction with the
-.Xr chroot 2
-system call, to provide a complete virtual file system to a process or family of
-processes.
-.Pp
-Recursive traversal of loopback mount points is not allowed.
-After the loopback mount of
-.Pa /tmp/newroot ,
-the file
-.Pa /tmp/newroot/tmp/newroot
-does not contain yet another file system hierarchy; rather, it appears just as
-.Pa /tmp/newroot
-did before the loopback mount was performed
-.Pq for example, as an empty directory .
-.Sh EXAMPLES
-.Nm
-file systems are mounted using:
-.Bd -literal -offset indent
-mount -F lofs /tmp /mnt
-.Ed
-.Sh SEE ALSO
-.Xr lofiadm 1M ,
-.Xr mount 1M ,
-.Xr chroot 2 ,
-.Xr mount 2 ,
-.Xr sysfs 2 ,
-.Xr vfstab 4 ,
-.Xr lofi 7D
-.Sh NOTES
-All access to entries in
-.Nm
-mounted file systems map to their underlying file system.
-If a mount point is made available in multiple locations via
-.Nm
-and is busy in any of those locations, an attempt to mount a file system at that
-mount point fails unless the overlay flag is specified.
-See
-.Xr mount 1M .
-Examples of a mount point being busy within a
-.Nm
-mount include having a file system mounted on it or it being a processes'
-current working directory.
-.Sh WARNINGS
-Because of the potential for confusing users and applications, you should use
-loopback mounts with care.
-A loopback mount entry in
-.Pa /etc/vfstab
-must be placed after the mount points of both directories it depends on.
-This is most easily accomplished by making the loopback mount entry the last in
-.Pa /etc/vfstab .