fbtab man page

2 files changed, 61 insertions, 1 deletions

diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile
index dbe98968187..55cdbda6f49 100644
--- a/share/man/man5/Makefile
+++ b/share/man/man5/Makefile
@@ -3,7 +3,8 @@
 
 # missing: dump.5 plot.5 
 
-MAN=	a.out.5 acct.5 core.5 dir.5 disktab.5 ethers.5 fs.5 fstab.5 group.5 \
+MAN=	a.out.5 acct.5 core.5 dir.5 disktab.5 ethers.5 fbtab.5 fs.5 \
+	fstab.5 group.5 \
 	hosts.5 link.5 motd.5 netgroup.5 networks.5 passwd.5 phones.5 \
 	printcap.5 protocols.5 remote.5 resolv.conf.5 rpc.5 services.5 \
 	shells.5 stab.5 types.5 utmp.5
diff --git a/share/man/man5/fbtab.5 b/share/man/man5/fbtab.5
new file mode 100644
index 00000000000..2e3ac438dfb
--- /dev/null
+++ b/share/man/man5/fbtab.5
@@ -0,0 +1,59 @@
+.\" this is comment
+.Dd August 22, 1994
+.Dt FBTAB 5
+.Os
+.Sh NAME
+.Nm fbtab
+.Nd change device protection upon login
+.Sh DESCRIPTION
+The
+.Nm fbtab
+file contains lines which specify how the permissions and
+ownership of various system files should be changed based on
+the user's login device name.
+.Pp
+Comments start with a # and extend to the end of the line.
+Blank lines or lines with only a comment are ignored.
+.Pp
+All other lines consist of three fields delimited by
+whitespace.
+.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
+.It Login Device
+The device you have logged in on, ie. /dev/ttyv0.
+.It File Permission 
+An octal permission number (0600), as used by
+.Xr chmod 2 .
+.It Other devices
+The final field is a ":"-delimited list of devices, ie.
+/dev/console:/dev/fd0a.
+All device names are absolute paths.
+A path that ends in "/*" refers to all
+directory entries except "." and "..".
+.El
+.Pp
+The
+.Nm fbtab
+file is used by
+.Xr login 1
+to
+.Xr chown 2
+the specified files to the user who has performed a login.  As well,
+.Xr chmod 2
+is used to set the devices to the specified permission.
+When a user logs out,
+.Xr init 8
+is responsible for performing the inverse operation, this results in
+the files once again belonging to root.
+.Sh FILES
+.Bl -tag -width /etc/fbtab -compact
+.It Pa /etc/fbtab
+The
+.Nm fbtab
+file resides in
+.Pa /etc .
+.El
+.Sh SEE ALSO
+.Xr login 1 ,
+.Xr init 8
+.Sh AUTHOR
+Guido van Rooij