freebsd-skq/usr.bin/lsvfs/lsvfs.1

.\" $FreeBSD$
.\" Garrett A. Wollman, September 1994
.\" This file is in the public domain.
.\"
.Dd December 28, 2020
.Dt LSVFS 1
.Os
.Sh NAME
.Nm lsvfs
.Nd list installed virtual file systems
.Sh SYNOPSIS
.Nm
.Op Ar vfsname Ar ...
.Sh DESCRIPTION
The
.Nm
command lists information about the currently loaded virtual file system
modules.
When
.Ar vfsname
arguments are given,
.Nm
lists information about the specified VFS modules.
Otherwise,
.Nm
lists all currently loaded modules.
The information is as follows:
.Pp
.Bl -tag -compact -width Filesystem
.It Filesystem
the name of the file system, as would be used in the
.Ar type
parameter to
.Xr mount 2
and the
.Fl t
option to
.Xr mount 8
.It Num
the filesystem type number.
.It Refs
the number of references to this VFS; i.e., the number of currently
mounted file systems of this type
.It Flags
flag bits.
.El
.Sh EXAMPLES
Show information about the
.Ql ufs
and
.Xr devfs 5
filesystems and check the number of mounts for the former:
.Bd -literal -offset indent
$ lsvfs ufs devfs
Filesystem                              Num  Refs  Flags
-------------------------------- ---------- -----  ---------------
ufs                              0x00000035     2
devfs                            0x00000071     1  synthetic, jail

$ mount -t ufs | wc -l
       2
.Ed
.Sh SEE ALSO
.Xr mount 2 ,
.Xr getvfsbyname 3 ,
.Xr mount 8
.Sh HISTORY
A
.Nm
command appeared in
.Fx 2.0 .
$Id$ -> $FreeBSD$ 1999-08-28 01:08:13 +00:00			`.\" $FreeBSD$`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.\" Garrett A. Wollman, September 1994`
			`.\" This file is in the public domain.`
			`.\"`
lsvfs(1): Add EXAMPLES section Add one simple exapmle and contrast some of the information using mount(8) PR: Submitted by: Reported by: Reviewed by: gbe@, yuripv@ Approved by: manpages (bcr@) Obtained from: MFC after: MFH: Relnotes: Security: Sponsored by: Differential Revision: https://reviews.freebsd.org/D27544 2020-12-29 20:35:24 +00:00			`.Dd December 28, 2020`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Dt LSVFS 1`
			`.Os`
			`.Sh NAME`
			`.Nm lsvfs`
spell "file system" correctly Approved by: ru 2005-01-24 20:06:16 +00:00			`.Nd list installed virtual file systems`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 19:21:22 +00:00			`.Nm`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Op Ar vfsname Ar ...`
			`.Sh DESCRIPTION`
			`The`
.Nm changes 2000-03-26 14:41:07 +00:00			`.Nm`
Uniformly refer to a file system as "file system". Approved by: re 2002-12-12 17:26:04 +00:00			`command lists information about the currently loaded virtual file system`
Mechanically kill hard sentence breaks. 2004-07-02 22:22:35 +00:00			`modules.`
			`When`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Ar vfsname`
			`arguments are given,`
.Nm changes 2000-03-26 14:41:07 +00:00			`.Nm`
Mechanically kill hard sentence breaks. 2004-07-02 22:22:35 +00:00			`lists information about the specified VFS modules.`
			`Otherwise,`
.Nm changes 2000-03-26 14:41:07 +00:00			`.Nm`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`lists all currently loaded modules.`
			`The information is as follows:`
			`.Pp`
			`.Bl -tag -compact -width Filesystem`
			`.It Filesystem`
Uniformly refer to a file system as "file system". Approved by: re 2002-12-12 17:26:04 +00:00			`the name of the file system, as would be used in the`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Ar type`
			`parameter to`
			`.Xr mount 2`
Fixed anachronisms (nuked vfs type number; don't give a 1/6-baked list of vfs flags in the man page). 1998-08-29 13:53:22 +00:00			`and the`
			`.Fl t`
			`option to`
			`.Xr mount 8`
- Add file system type number (vfc_typenum) in the list. This is useful for debugging when changing vfs.typenumhash configuration. - Refactor fmt_flags(). MFC after: 1 week 2013-06-09 16:33:32 +00:00			`.It Num`
			`the filesystem type number.`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.It Refs`
			`the number of references to this VFS; i.e., the number of currently`
Uniformly refer to a file system as "file system". Approved by: re 2002-12-12 17:26:04 +00:00			`mounted file systems of this type`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.It Flags`
Fixed anachronisms (nuked vfs type number; don't give a 1/6-baked list of vfs flags in the man page). 1998-08-29 13:53:22 +00:00			`flag bits.`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.El`
lsvfs(1): Add EXAMPLES section Add one simple exapmle and contrast some of the information using mount(8) PR: Submitted by: Reported by: Reviewed by: gbe@, yuripv@ Approved by: manpages (bcr@) Obtained from: MFC after: MFH: Relnotes: Security: Sponsored by: Differential Revision: https://reviews.freebsd.org/D27544 2020-12-29 20:35:24 +00:00			`.Sh EXAMPLES`
			`Show information about the`
			`.Ql ufs`
			`and`
			`.Xr devfs 5`
			`filesystems and check the number of mounts for the former:`
			`.Bd -literal -offset indent`
			`$ lsvfs ufs devfs`
			`Filesystem Num Refs Flags`
			`-------------------------------- ---------- ----- ---------------`
			`ufs 0x00000035 2`
			`devfs 0x00000071 1 synthetic, jail`

			`$ mount -t ufs \| wc -l`
			`2`
			`.Ed`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Sh SEE ALSO`
			`.Xr mount 2 ,`
- Add file system type number (vfc_typenum) in the list. This is useful for debugging when changing vfs.typenumhash configuration. - Refactor fmt_flags(). MFC after: 1 week 2013-06-09 16:33:32 +00:00			`.Xr getvfsbyname 3 ,`
Added lsvfs command to show loaded VFS modules (including statically-linked ones). 1994-09-22 01:25:57 +00:00			`.Xr mount 8`
			`.Sh HISTORY`
			`A`
			`.Nm`
Fix a bunch of spelling errors in a bunch of man pages. 1996-01-30 13:52:50 +00:00			`command appeared in`
.Nm changes 2000-03-26 14:41:07 +00:00			`.Fx 2.0 .`