xref: /original-bsd/old/mount_lofs/mount_lofs.8 (revision e58c8952)
1.\"
2.\" Copyright (c) 1992, 1993, 1994
3.\"	The Regents of the University of California.  All rights reserved.
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	8.2 (Berkeley) 03/27/94
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 o Ar options
23.Ar target
24.Ar mount-point
25.Sh DESCRIPTION
26The
27.Nm mount_lofs
28command makes a sub-tree of an existing filesystem visible
29in another part of the global filesystem namespace.
30This allows existing files and directories to be accessed
31using a different pathname.
32.Pp
33The primary differences between a virtual copy of the filesystem
34and a symbolic link are that
35.Xr getcwd 3
36functions correctly in the virtual copy, and that other filesystems
37may be mounted on the virtual copy without affecting the original.
38A different device number for the virtual copy is returned by
39.Xr stat 2 ,
40but in other respects it is indistinguishable from the original.
41.Pp
42The options are as follows:
43.Bl -tag -width indent
44.It Fl o
45Options are specified with a
46.Fl o
47flag followed by a comma separated string of options.
48See the
49.Xr mount 8
50man page for possible options and their meanings.
51.Sh SEE ALSO
52.Xr mount 8
53.Sh HISTORY
54The
55.Nm mount_lofs
56utility first appeared in 4.4BSD.
57