d/freebsd-nq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

As discussed with Bruce Evans and Kirk McKusick:

Browse Source 
o Combine ufs.7 and ffs.7 into a single ffs.7 man page.
o Remove all references to `ufs' as a file system.
o Proper (lack of) capitalization for `ffs'.

Obtained from:	TrustedBSD Project
Sposnored by:	DARPA, NAI Labs
This commit is contained in:
Chris Costello 2002-01-05 20:18:35 +00:00
parent 3ad920fe65
commit 7f0def37ec
3 changed files with 143 additions and 202 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
share/man/man7/Makefile
View File

@ -4,7 +4,7 @@
#MISSING: eqnchar.7 ms.7 term.7 #MISSING: eqnchar.7 ms.7 term.7
MAN= ascii.7 build.7 clocks.7 environ.7 ffs.7 hier.7 hostname.7 intro.7 \ MAN= ascii.7 build.7 clocks.7 environ.7 ffs.7 hier.7 hostname.7 intro.7 \
mailaddr.7 operator.7 ports.7 security.7 tuning.7 firewall.7 \ mailaddr.7 operator.7 ports.7 security.7 tuning.7 firewall.7 \
sec-doc.7 sprog.7 style.perl.7 ufs.7 sec-doc.7 sprog.7 style.perl.7
MLINKS= intro.7 miscellaneous.7 MLINKS= intro.7 miscellaneous.7
.include <bsd.prog.mk> .include <bsd.prog.mk>

155
share/man/man7/ffs.7
View File

@ -38,29 +38,73 @@
.Nm ffs .Nm ffs
.Nd Berkeley fast file system .Nd Berkeley fast file system
.Sh SYNOPSIS .Sh SYNOPSIS
In the kernel configuration file:
.Cd options ENABLE_VFS_IOOPT
.Cd options FFS .Cd options FFS
.Cd options QUOTA
.Cd options SOFTUPDATES .Cd options SOFTUPDATES
.Cd options SUIDDIR
.Cd options UFS_ACL
.Cd options UFS_DIRHASH
.Cd options UFS_EXTATTR
.Cd options UFS_EXTATTR_AUTOSTART
.Pp
In
.Pa /etc/fstab :
.Cd /dev/disk0s1a /mnt ufs rw 1 1
.Sh DESCRIPTION .Sh DESCRIPTION
The Berkeley fast file system The Berkeley fast file system
provides facilities to store file system data onto a disk device. provides facilities to store file system data onto a disk device.
.Nm FFS .Nm ffs
has been optimized over the years has been optimized over the years
for speed and reliability for speed and reliability
and is the basis for the and is the default
.Xr ufs 4 .Fx
file system. file system.
.Pp .Pp
The .Ss VFS I/O optimization
.Dv SOFTUPDATES .Bl -tag -width 2n
option is used to enable soft updates. .It Cd options ENABLE_VFS_IOOPT
This option enables the IO optimization through the VM system,
using VM operations instead of copying operations when possible.
This option adds a sysctl MIB,
.Em vfs.ioopt .
The following are values and effects for
.Em vfs.ioopt :
.Pp
.Bl -tag -width "Value" -offset indent -compact
.It Em Value
.Em Effect
.It Li 0
No optimization
.It Li 1
VM operations if a request fits
.It Li 2
Aggresive optimization (VM used as much as possible)
.El
.El
.Ss Quotas
.Bl -tag -width 2n
.It Cd options QUOTA
This option allows system administrators
to set limits on disk usage
on a per-user basis.
Quotas can be used only on file systems
mounted with the
.Sq quota
option;
see
.Xr quota 1
and
.Xr edquota 8 .
.El
.Ss Soft Updates
.Bl -tag -width 2n
.It Cd options SOFTUPDATES
The soft updates feature tracks writes to the disk The soft updates feature tracks writes to the disk
and enforces metadata update dependancies and enforces metadata update dependancies
(e.g. updating free block maps) (e.g. updating free block maps)
to ensure that the file system remains consistent. to ensure that the file system remains consistent.
To enable this feature,
add the following to your kernel configuration file:
.Pp
.Dl Cd options SOFTUPDATES
.Pp .Pp
To enable soft updates on an To enable soft updates on an
.Em unmounted .Em unmounted
@ -76,11 +120,92 @@ can be either a mount point listed in
or a disk device or a disk device
(e.g. (e.g.
.Pa /dev/da0s1a ) . .Pa /dev/da0s1a ) .
.El
.Ss File Ownership Inheritance
.Bl -tag -width 2n
.It Cd options SUIDDIR
For use in file sharing environments
on networks including Microsoft Windows
and Apple Macintosh computers,
this option allows files on file systems
mounted with the
.Sq suiddir
option
to inherit the ownership of its directory,
i.e.
.Dq "If it's my directory, it must be my file."
.El
.Ss Access Control Lists
.Bl -tag -width 2n
.It Cd options UFS_ACL
Access control lists allow the association of
fine-grained descretionary access control information
with files and directories.
This option requires the presence of the
.Dv UFS_EXTATTR
option, and it is recommended that
.Dv UFS_EXTATTR_AUTOSTART
is included as well,
so that ACLs are enabled atomically upon mounting the file system.
.El
.Pp
In order to enable support for ACLs,
two extended attributes must be available in the
.Dv EXTATTR_NAMESPACE_SYSTEM
namespace:
.Dq Li posix1e.acl_access ,
which holds the access ACL,
and
.Dq Li posix1e.acl_default ,
which holds the default ACL for directories.
If you are using file system extended attributes,
the following commands may be used to
allocate space for and create the necessary EA backing files
for ACLs in the root of each file system.
In these examples, the root file system is used;
see
.Sx "Extended Attributes"
for more details.
.Pp
.Bd -literal -offset indent
mkdir -p /.attribute/system
cd /.attribute/system
extattrctl initattr -p / 388 posix1e.acl_access
extattrctl initattr -p / 388 posix1e.acl_default
.Ed
.Pp
On the next mount of the root file system,
the attributes will be automatically started
(if UFS_EXTATTR_AUTOSTART is included in the kernel configuration),
and ACLs will be enabled.
.Ss Directory Hashing
.Bl -tag -width 2n
.It Cd options UFS_DIRHASH
Implements a hash-based lookup scheme for directories
in order to speed up accesses to very large directories.
.El
.Ss Extended Attributes
.Bl -tag -width 2n
.It Cd options UFS_EXTATTR
Extended attributes allow the association of
additional arbitrary metadata with files and directories,
which can be assigned and retrieved from userland
as well as from within the kernel; see
.Xr extattrctl 8 .
.It Cd options UFS_EXTATTR_AUTOSTART
If this option is defined,
.Nm ffs
will search for a
.Dq Pa .attribute
subdirectory of the file system root during the mount operation.
If found, extended attribute support will be
automatically started for that file system.
.El
.Pp .Pp
The following The following
.Xr sysctl 8 .Xr sysctl 8
MIBs are defined for use with MIBs are defined for use with
.Nm FFS : .Nm ffs :
.Bl -hang -width "vfs.ffs.doreallocblk" .Bl -hang -width "vfs.ffs.doreallocblk"
.It Em vfs.ffs.doasyncfree .It Em vfs.ffs.doasyncfree
Asynchronously write out modified inode and indirect blocks Asynchronously write out modified inode and indirect blocks
@ -92,8 +217,12 @@ to be contiguous.
(Default: 1.) (Default: 1.)
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr ufs 4 , .Xr quota 1 ,
.Xr tunefs 8 .Xr acl 3 ,
.Xr extattr 3 ,
.Xr edquota 8 ,
.Xr extattrctl 8 ,
.Xr sysctl 8 ,
.Rs .Rs
.%A M. McKusick .%A M. McKusick
.%A W. Joy .%A W. Joy

188
share/man/man7/ufs.7
View File

@ -1,188 +0,0 @@
.\" Copyright (c) 2001 Networks Associates Technologies, Inc.
.\" All rights reserved.
.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and NAI Labs, the Security
.\" Research Division of Network Associates, Inc. under DARPA/SPAWAR
.\" contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA CHATS
.\" research program.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. The name of the author may not be used to endorse or promote
.\" products derived from this software without specific prior written
.\" permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.Dd December 26, 2001
.Dt UFS 7
.Sh NAME
.Nm ufs
.Nd UNIX file system
.Sh SYNOPSIS
.Cd options ENABLE_VFS_IOOPT
.Cd options FFS
.Cd options QUOTA
.Cd options SUIDDIR
.Cd options UFS_ACL
.Cd options UFS_DIRHASH
.Cd options UFS_EXTATTR
.Cd options UFS_EXTATTR_AUTOSTART
.Sh DESCRIPTION
The UFS file system,
based on the Berkeley fast file system
(see
.Xr ffs 7 ) ,
is the default file system in the
.Fx
operating system.
UFS is an advanced file system
capable of managing large and numerous files,
and providing support for features which
provide added reliability as well as added features,
such as Soft Updates, and Extended Attributes, respectively.
The following is a more complete list of the
optional features offered by UFS,
and how to enable and use them.
.Ss VFS I/O optimization
.Bl -tag -width 2n
.It Cd options ENABLE_VFS_IOOPT
This option enables the IO optimization through the VM system,
using VM operations instead of copying operations when possible.
This option adds a sysctl MIB,
.Em vfs.ioopt .
The following are values and effects for
.Em vfs.ioopt :
.Pp
.Bl -tag -width "Value" -offset indent -compact
.It Em Value
.Em Effect
.It Li 0
No optimization
.It Li 1
VM operations if a request fits
.It Li 2
Aggresive optimization (VM used as much as possible)
.El
.El
.Ss Quotas
.Bl -tag -width 2n
.It Cd options QUOTA
This option allows system administrators
to set limits on disk usage
on a per-user basis.
Quotas can be used only on file systems
mounted with the
.Sq quota
option;
see
.Xr quota 1
and
.Xr edquota 8 .
.El
.Ss File Ownership Inheritance
.Bl -tag -width 2n
.It Cd options SUIDDIR
For use in file sharing environments
on networks including Microsoft Windows
and Apple Macintosh computers,
this option allows files on file systems
mounted with the
.Sq suiddir
option
to inherit the ownership of its directory,
i.e.
.Dq "If it's my directory, it must be my file."
.El
.Ss Access Control Lists
.Bl -tag -width 2n
.It Cd options UFS_ACL
Access control lists allow the association of
fine-grained descretionary access control information
with files and directories.
This option requires the presence of the
.Dv UFS_EXTATTR
option, and it is recommended that
.Dv UFS_EXTATTR_AUTOSTART
is included as well,
so that ACLs are enabled atomically upon mounting the file system.
.El
.Pp
In order to enable support for ACLs,
two extended attributes must be available in the
.Dv EXTATTR_NAMESPACE_SYSTEM
namespace:
.Dq Li posix1e.acl_access ,
which holds the access ACL,
and
.Dq Li posix1e.acl_default ,
which holds the default ACL for directories.
If you are using UFS extended attributes,
the following commands may be used to
allocate space for and create the necessary EA backing files
for ACLs in the root of each file system.
In these examples, the root file system is used;
see
.Sx "Extended Attributes"
for more details.
.Pp
.Bd -literal -offset indent
mkdir -p /.attribute/system
cd /.attribute/system
extattrctl initattr -p / 388 posix1e.acl_access
extattrctl initattr -p / 388 posix1e.acl_default
.Ed
.Pp
On the next mount of the root file system,
the attributes will be automatically started
(if UFS_EXTATTR_AUTOSTART is included in the kernel configuration),
and ACLs will be enabled.
.Ss Directory Hashing
.Bl -tag -width 2n
.It Cd options UFS_DIRHASH
Implements a hash-based lookup scheme for UFS directories
in order to speed up accesses to very large directories.
.El
.Ss Extended Attributes
.Bl -tag -width 2n
.It Cd options UFS_EXTATTR
Extended attributes allow the association of
additional arbitrary metadata with files and directories,
which can be assigned and retrieved from userland
as well as from within the kernel; see
.Xr extattrctl 8 .
.It Cd options UFS_EXTATTR_AUTOSTART
If this option is defined,
.Nm UFS
will search for a
.Dq Pa .attribute
subdirectory of the file system root during the mount operation.
If found, extended attribute support will be
automatically started for that file system.
.El
.Sh SEE ALSO
.Xr quota 1 ,
.Xr acl 3 ,
.Xr extattr 3 ,
.Xr ffs 7 ,
.Xr edquota 8 ,
.Xr extattrctl 8 ,
.Xr sysctl 8