xref: /original-bsd/old/mount_lofs/mount_lofs.8 (revision 07303858)
1.\"
2.\" Copyright (c) 1992 The Regents of the University of California
3.\" Copyright (c) 1990, 1992 Jan-Simon Pendry
4.\" All rights reserved.
5.\"
6.\" This code is derived from software donated to Berkeley by
7.\" Jan-Simon Pendry.
8.\"
9.\" %sccs.include.redist.roff%
10.\"
11.\"	@(#)mount_lofs.8	5.2 (Berkeley) 07/05/92
12.\"
13.\"
14.Dd
15.Dt MOUNT_LOFS 8
16.Os BSD 4.4
17.Sh NAME
18.Nm mount_lofs
19.Nd mount a virtual copy of an existing filesystem sub-tree
20.Sh SYNOPSIS
21.Nm mount_lofs
22.Op Fl F Ar fsoptions
23.Ar target mount-point
24.Sh DESCRIPTION
25The
26.Nm mount_lofs
27command makes a sub-tree of an existing filesystem visible
28in another part of the global filesystem namespace.
29This allows existing files and directories to be accessed
30using a different pathname.
31.Pp
32The primary differences between a virtual copy of the filesystem
33and a symbolic link are that
34.Xr getcwd 3
35functions correctly in the virtual copy, and that other filesystems
36may be mounted on the virtual copy without affecting the original.
37A different device number for the virtual copy is returned by
38.Xr stat 2 ,
39but in other respects it is indistinguishable from the original.
40.Sh HISTORY
41The
42loopback filesystem
43is
44.Ud
45