Note that devfs(5) and fdescfs(5) both create /dev/fd file descriptors.

PR:		144534
Submitted by:	Matthew Seaman <m.seaman at infracaninophile co uk>
Patch by:	Matthew Seaman, keramida
Approved by:	keramida (mentor)
MFC after:	1 week

2 files changed, 34 insertions, 2 deletions

diff --git a/share/man/man5/devfs.5 b/share/man/man5/devfs.5
index e27ff748fb61..366196f91760 100644
--- a/share/man/man5/devfs.5
+++ b/share/man/man5/devfs.5
@@ -38,7 +38,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 30, 2010
+.Dd September 18, 2010
 .Dt DEVFS 5
 .Os
 .Sh NAME
@@ -69,6 +69,27 @@ The
 .Xr mknod 8
 tool can be used to recover deleted device entries under
 .Nm .
+.Pp
+The
+.Xr fdescfs 5
+filesystem is an alternate means for populating
+.Pa /dev/fd .
+The character devices that both
+.Nm
+and
+.Xr fdescfs 5
+present in
+.Pa /dev/fd
+correspond to the open file descriptors of the process
+accessing the directory.
+.Nm
+only creates files for the standard file descriptors
+.Pa 0 ,
+.Pa 1
+and
+.Pa 2 .
+.Xr fdescfs 5
+creates files for all open descriptors.
 .Sh FILES
 .Bl -tag -width /dev/XXXX -compact
 .It Pa /dev
@@ -85,6 +106,7 @@ volume located on
 .Dl "mount -t devfs devfs /mychroot/dev"
 .Sh SEE ALSO
 .Xr devfs 8 ,
+.Xr fdescfs 5 ,
 .Xr mount 8
 .Sh HISTORY
 The
diff --git a/share/man/man5/fdescfs.5 b/share/man/man5/fdescfs.5
index b8444516e64f..b87d1604554e 100644
--- a/share/man/man5/fdescfs.5
+++ b/share/man/man5/fdescfs.5
@@ -38,7 +38,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd December 14, 1996
+.Dd September 18, 2010
 .Dt FDESCFS 5
 .Os
 .Sh NAME
@@ -87,6 +87,15 @@ call other than
 and
 .Dv O_RDWR
 are ignored.
+.Pp
+.Em "Note:"
+.Pa /dev/fd/0 ,
+.Pa /dev/fd/1
+and
+.Pa /dev/fd/2
+files are created by default when devfs alone is mounted.
+.Nm
+creates entries for all file descriptors opened by the process.
 .Sh FILES
 .Bl -tag -width /dev/stderr -compact
 .It Pa /dev/fd/#
@@ -99,6 +108,7 @@ volume located on
 .Pp
 .Dl "mount -t fdescfs null /dev/fd"
 .Sh SEE ALSO
+.Xr devfs 5 ,
 .Xr mount 8
 .Sh HISTORY
 The