Index: usr.bin/fstat/fstat.1
===================================================================
--- usr.bin/fstat/fstat.1
+++ usr.bin/fstat/fstat.1
@@ -51,7 +51,7 @@
 active executable text, or kernel trace file for that process.
 If no options are specified,
 .Nm
-reports on all open files in the system.
+reports on all open files in the system for processes the user has access to.
 .Pp
 The following options are available:
 .Bl -tag -width "-N system"
@@ -235,6 +235,99 @@
 .Pq Ql <-> .
 For UNIX/local sockets either the local or remote address is shown, depending
 on which one is available.
+.Sh EXAMPLES
+Show all open files except those opened by
+.Nm
+itself:
+.Bd -literal -offset indent
+$ fstat | grep -v fstat
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W
+fernape  grep         533 text /usr       4579 -r-xr-xr-x   99904  r
+fernape  grep         533 ctty /dev        346 crw--w----  pts/81 rw
+fernape  grep         533   wd /home    16970191 drwxr-xr-x      11  r
+fernape  grep         533 root /             4 drwxr-xr-x      36  r
+fernape  grep         533 jail /             4 drwxr-xr-x      36  r
+fernape  grep         533    0* pipe fffff80539b442f8 <-> fffff80539b44460      0 rw
+fernape  grep         533    1 /dev        346 crw--w----  pts/81 rw
+fernape  grep         533    2 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469 text /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 ctty /dev        346 crw--w----  pts/81 rw
+fernape  bash         469   wd /home    16970191 drwxr-xr-x      11  r
+fernape  bash         469 root /             4 drwxr-xr-x      36  r
+fernape  bash         469 jail /             4 drwxr-xr-x      36  r
+fernape  bash         469    0 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    1 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    2 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469  255 /dev        346 crw--w----  pts/81 rw
+.Ed
+.Pp
+Show open files in the same file system as
+.Pa /dev :
+.Bd -literal -offset indent
+$ fstat -f /dev
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W
+fernape  fstat       3017 ctty /dev        346 crw--w----  pts/81 rw
+fernape  fstat       3017    0 /dev        346 crw--w----  pts/81 rw
+fernape  fstat       3017    1 /dev        346 crw--w----  pts/81 rw
+fernape  fstat       3017    2 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469 ctty /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    0 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    1 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    2 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469  255 /dev        346 crw--w----  pts/81 rw
+.Ed
+.Pp
+Report all open files by the current shell including memory-mapped files:
+.Bd -literal -offset indent
+$ fstat -m -p $$
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W
+fernape  bash         469 text /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 ctty /dev        346 crw--w----  pts/81 rw
+fernape  bash         469   wd /home    16970191 drwxr-xr-x      11  r
+fernape  bash         469 root /             4 drwxr-xr-x      36  r
+fernape  bash         469 jail /             4 drwxr-xr-x      36  r
+fernape  bash         469    0 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    1 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469    2 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469  255 /dev        346 crw--w----  pts/81 rw
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+.Ed
+.Pp
+Same as above but only for the directory
+.Pa /usr/local :
+.Bd -literal -offset indent
+$ fstat -m -p $$ -f /usr/local
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W
+fernape  bash         469 text /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local 143355 -rwxr-xr-x  1166448  r
+fernape  bash         469 mmap /usr/local  95732 -rw-r--r--   56776  r
+fernape  bash         469 mmap /usr/local  95732 -rw-r--r--   56776  r
+fernape  bash         469 mmap /usr/local  95732 -rw-r--r--   56776  r
+fernape  bash         469 mmap /usr/local  95732 -rw-r--r--   56776  r
+.Ed
+.Pp
+Requesting information about a file that is not opened results in just a
+header line:
+.Bd -literal -offset indent
+$ fstat /etc/rc.conf
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W NAME
+.Ed
+.Pp
+All parameters after
+.Fl f
+will be interpreted as files, so the following will not work as expected:
+.Bd -literal -offset indent
+$ fstat -f /usr/local -m -p $$
+fstat: -m: No such file or directory
+fstat: -p: No such file or directory
+fstat: 469: No such file or directory
+USER     CMD          PID   FD MOUNT      INUM MODE         SZ|DV R/W
+fernape  bash         469 text /usr/local 143355 -rwxr-xr-x  1166448  r
+.Ed
 .Sh SEE ALSO
 .Xr fuser 1 ,
 .Xr netstat 1 ,