diff options
Diffstat (limited to 'share')
| -rw-r--r-- | share/man/man4/Makefile | 14 | ||||
| -rw-r--r-- | share/man/man4/ffs_softupdates.4 | 148 |
2 files changed, 154 insertions, 8 deletions
diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index c8903fc52a0..88447ee6db8 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -1,13 +1,11 @@ -# $OpenBSD: Makefile,v 1.29 1998/03/07 22:42:24 millert Exp $ +# $OpenBSD: Makefile,v 1.30 1998/03/15 22:10:14 millert Exp $ # $NetBSD: Makefile,v 1.22.4.2 1996/07/18 00:51:10 jtc Exp $ MAN= atalk.4 audio.4 acd.4 ahc.4 bpf.4 ccd.4 cd.4 ch.4 clnp.4 cltp.4 ddb.4 \ - de.4 drum.4 \ - esis.4 fd.4 fpa.4 fxp.4 icmp.4 idp.4 imp.4 inet.4 ip.4 \ - ipl.4 ipsec.4 iso.4 \ - lkm.4 lo.4 ncr.4 netintro.4 ns.4 nsip.4 null.4 pnp.4 pty.4 random.4 \ - route.4 scsi.4 sd.4 sl.4 spp.4 st.4 tb.4 tcp.4 termios.4 tty.4 tp.4 \ - tun.4 udp.4 uk.4 unix.4 vnd.4 + de.4 drum.4 esis.4 fd.4 ffs_softupdates.4 fpa.4 fxp.4 icmp.4 idp.4 \ + imp.4 inet.4 ip.4 ipl.4 ipsec.4 iso.4 lkm.4 lo.4 ncr.4 netintro.4 ns.4 \ + nsip.4 null.4 pnp.4 pty.4 random.4 route.4 scsi.4 sd.4 sl.4 spp.4 st.4 \ + tb.4 tcp.4 termios.4 tty.4 tp.4 tun.4 udp.4 uk.4 unix.4 vnd.4 MLINKS+=fd.4 stderr.4 fd.4 stdin.4 fd.4 stdout.4 MLINKS+=netintro.4 networking.4 MLINKS+=random.4 srandom.4 random.4 urandom.4 random.4 prandom.4 @@ -16,6 +14,6 @@ MLINKS+=scsi.4 scsibus.4 MLINKS+=tty.4 cua.4 MLINKS+=vnd.4 svnd.4 SUBDIR= man4.alpha man4.amiga man4.arm32 man4.atari man4.hp300 man4.i386 \ - man4.mac68k man4.pc532 man4.sparc man4.sun3 man4.vax + man4.mac68k man4.pc532 man4.pmax man4.sparc man4.sun3 man4.vax .include <bsd.prog.mk> diff --git a/share/man/man4/ffs_softupdates.4 b/share/man/man4/ffs_softupdates.4 new file mode 100644 index 00000000000..ad1a1208928 --- /dev/null +++ b/share/man/man4/ffs_softupdates.4 @@ -0,0 +1,148 @@ +.\" $OpenBSD: ffs_softupdates.4,v 1.1 1998/03/15 22:10:15 millert Exp $ +.\" +.\" Copyright (c) 1998 Todd C. Miller <Todd.Miller@courtesan.com> +.\" All rights reserved. +.\" +.\" 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. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Todd C. Miller. +.\" 4. 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 ``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 AUTHOR 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. +.\" +.Dd March 15, 1998 +.Dt FFS_SOFTUPDATES 4 +.Os +.Sh NAME +.Nm ffs_softupdates +.Sh DESCRIPTION +The +.Nm FFS_SOFTUPDATES +kernel config option enables a scheme that uses partial ordering of +buffer cache operations to allow metadata updates in the fast filesystem +to happen asynchronously, increasing write performance significantly. +Normally, the +.Em ffs +filesystem writes metadata updates synchronously which exacts +a performance penalty in favor of filesystem integrity. +With +.Em soft updates , +you gain the performance of asynchronous writes while retaining the safety +of synchronous metadata updates. +.Pp +.Em Soft Updates +must be enabled on a per-filesystem basis. To do this, boot into +single user mode and run +.Dq tunefs -s enable special +on each character special disk device you want to enable +.Em soft updates +on, then run +.Dq reboot -n . +.Sh CAVEATS +Soft updates should be considered experimental at this time. +.br +There should be a +.Xr mount 2 +option to enable +.Em soft updates . +.br +The current license for +.Nm +is more restrictive than the rest of the +.Ox +kernel; this will be changed at a future date. +.Sh AUTHOR +Marshall Kirk McKusick +.Sh LICENSE +The following are the copyrights and redistribution conditions that +apply to this copy of the soft update software. For a license +to use, redistribute or sell the soft update software under +conditions other than those described here, please contact the +author at one of the following addresses: +.Bd -literal -offset indent +Marshall Kirk McKusick mckusick@mckusick.com +1614 Oxford Street +1-510-843-9542 +Berkeley, CA 94709-1608 +USA +.Ed +.Pp +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +.Bl -tag -width XXX +.It 1. +Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. +.It 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. +.It 3. +None of the names of McKusick, Ganger, Patt, or the University of +Michigan may be used to endorse or promote products derived from +this software without specific prior written permission. +.It 4. +Redistributions in any form must be accompanied by information on +how to obtain complete source code for any accompanying software +that uses this software. This source code must either be included +in the distribution or be available for no more than the cost of +distribution plus a nominal fee, and must be freely redistributable +under reasonable conditions. For an executable file, complete +source code means the source code for all modules it contains. +It does not mean source code for modules or files that typically +accompany the operating system on which the executable file runs, +e.g., standard library modules or system header files. +.El +.Pp +THIS SOFTWARE IS PROVIDED BY MARSHALL KIRK MCKUSICK ``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 MARSHALL KIRK MCKUSICK 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. +.Sh SEE ALSO +.Xr fs 5 , +.Xr config 8 , +.Xr sysctl 8 , +.Xr tunefs 8 . +.Rs +.%T "A Fast Filesystem for UNIX" +.%A Marshall Kirk McKusick +.%A William N. Joy +.%A Samuel J. Leffler +.%A Robert S. Fabry +.%C Computer Science Research Group +.Re +.Pp +.Rs +.%T "Soft Updates: A Solution to the Metadata Update Problem in File Systems" +.%A Gregory R. Ganger +.%A Yale N. Patt +.%R CSE-TR-254-95 +.%C "University of Michigan, Ann Arbor" +.Re +.br +.Li http://www.ece.cmu.edu/~ganger/papers/CSE-TR-254-95/ |