add man page for login_fbtab()

src/lib/libutil/Makefile

@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.18 1999/09/21 04:52:45 csapuntz Exp $
+#	$OpenBSD: Makefile,v 1.19 1999/11/11 06:30:40 ericj Exp $
 #	$NetBSD: Makefile,v 1.8 1996/05/16 07:03:28 thorpej Exp $
 
 LIB=	util
@@ -9,10 +9,9 @@ SRCS=	getmaxpartitions.c getrawpartition.c login.c login_tty.c logout.c \
 	logwtmp.c opendev.c passwd.c pty.c readlabel.c scsi.c login_fbtab.c \
 	uucplock.c fparseln.c opendisk.c
 
-# XXX need login_fbtab.3
 MAN=	getmaxpartitions.3 getrawpartition.3 login.3 opendev.3 openpty.3 \
 	pw_init.3 pw_lock.3 readlabelfs.3 scsi.3 pw_getconf.3 uucplock.3 \
-	fparseln.3 opendisk.3
+	fparseln.3 opendisk.3 login_fbtab.3
 
 MLINKS+=login.3 logout.3
 MLINKS+=login.3 logwtmp.3

src/lib/libutil/login_fbtab.3

@@ -0,0 +1,42 @@
+.Dd November 8, 1999
+.Dt login_fbtab 3
+.Os
+.Sh NAME
+.Nm login_fbtab
+.Nd implement device security based on
+.Pa /etc/fstab
+.Sh SYNOPSIS
+.Fd #include <util.h>
+.Ft void
+.Fn login_fbtab "char *tty" "uid_t uid" "gid_t gid"
+.Sh DESCRIPTION
+The
+.Fn login_fbtab
+function reads the 
+.Pa /etc/fbtab 
+file and implements device security as described in the
+.Xr fbtab 5
+manual page. 
+.Pp
+If errors occur a null string is returned.
+.Sh DIAGNOSTICS 
+Problems are reported via the 
+.Xr syslogd 8
+daemon with the severity of 
+.Dv LOG_ERR.
+.Sh FILES
+.Bl -tag -width /etc/fbtab -compact
+.It Pa /etc/fbtab
+.El
+.Sh SEE ALSO
+.Xr fbtab 5 
+.Sh BUGS
+This module uses 
+.Xr strtok 3 ,
+which may cause conflicts with other uses of that same routine.
+.Sh AUTHOR
+.Bd -unfilled -offset indent
+Wietse Venema (wietse@wzv.win.tue.nl)
+Eindhoven University of Technology
+The Netherlands
+.Ed