Date: Sat, 1 Sep 2001 16:29:30 +0200 (CEST) From: Maxime Henrion <mux@qualys.com> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/30253: [PATCH] mount_unionfs(8) and mount_nullfs(8) manpages outdated Message-ID: <200109011429.f81ETUT02504@cybercable.fr>
next in thread | raw e-mail | index | archive | help
>Number: 30253 >Category: docs >Synopsis: [PATCH] mount_unionfs(8) and mount_nullfs(8) manpages outdated >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Sep 01 07:30:01 PDT 2001 >Closed-Date: >Last-Modified: >Originator: Maxime Henrion >Release: FreeBSD 5.0-CURRENT i386 >Organization: None. >Environment: System: FreeBSD nebula.cybercable.fr 5.0-CURRENT FreeBSD 5.0-CURRENT #94: Sat Sep 1 14:27:09 CEST 2001 root@nebula.cybercable.fr:/usr/src/sys/i386/compile/NEBULA i386 >Description: If I remember correctly, unionfs and nullfs file systems have been fixed by Boris Popov, and the fixs have been MFC'ed. However, the manpages still discourage the use of these fs. It would be nice to not scare users of the new release if they can use nullfs and unionfs without risk :-) Here is a little patch for this. >How-To-Repeat: >Fix: --- pr begins here --- --- /usr/src/sbin/mount_unionfs/mount_unionfs.8 Sun Jul 15 12:59:34 2001 +++ mount_unionfs.8 Sat Sep 1 15:29:29 2001 @@ -182,33 +182,10 @@ .Xr fstab 5 , .Xr mount 8 , .Xr mount_nullfs 8 -.Sh BUGS -THIS FILESYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK) -AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM. USE AT YOUR -OWN RISK. BEWARE OF DOG. SLIPPERY WHEN WET. -.Pp -This code also needs an owner in order to be less dangerous - serious -hackers can apply by sending mail to -.Aq hackers@FreeBSD.org -and announcing -their intent to take it over. -.Pp -Without whiteout support from the filesystem backing the upper layer, -there is no way that delete and rename operations on lower layer -objects can be done. -.Er EROFS -is returned for this kind of operations along with any others -which would make modifications to the lower layer, such as -.Xr chmod 1 . -.Pp -Running -.Xr find 1 -over a union tree has the side-effect of creating -a tree of shadow directories in the upper layer. .Sh HISTORY The .Nm command first appeared in .Bx 4.4 . It first worked in -.Fx Ns -(fill this in) . +.Fx 4.4 . --- mount_nullfs.8 Wed Aug 15 00:38:58 2001 +++ mount_nullfs.8 Sat Sep 1 15:22:37 2001 @@ -228,16 +228,6 @@ .Pp UCLA Technical Report CSD-910056, .Em "Stackable Layers: an Architecture for File System Development" . -.Sh BUGS -THIS FILESYSTEM TYPE IS NOT YET FULLY SUPPORTED (READ: IT DOESN'T WORK) -AND USING IT MAY, IN FACT, DESTROY DATA ON YOUR SYSTEM. USE AT YOUR -OWN RISK. BEWARE OF DOG. SLIPPERY WHEN WET. -.Pp -This code also needs an owner in order to be less dangerous - serious -hackers can apply by sending mail to -.Aq hackers@FreeBSD.org -and announcing -their intent to take it over. .Sh HISTORY The .Nm --- pr ends here --- >Release-Note: >Audit-Trail: >Unformatted: SEND-PR: -*- send-pr -*- SEND-PR: Lines starting with `SEND-PR' will be removed automatically, as SEND-PR: will all comments (text enclosed in `<' and `>'). SEND-PR: SEND-PR: Please consult the send-pr man page `send-pr(1)' or the Texinfo SEND-PR: manual if you are not sure how to fill out a problem report. SEND-PR: Note that the Synopsis field is mandatory. SEND-PR: SEND-PR: Choose from the following categories: SEND-PR: SEND-PR: advocacy alpha bin conf docs gnu SEND-PR: i386 kern misc ports sparc SEND-PR: To: FreeBSD-gnats-submit@freebsd.org From: mux Cc: X-send-pr-version: 3.113 X-GNATS-Notify: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200109011429.f81ETUT02504>