xref: /openbsd-src/share/man/man5/fbtab.5 (revision 0b0f544937b693740cfaed49f4dfd1e65e7ba54a)
1*0b0f5449Sjmc.\"	$OpenBSD: fbtab.5,v 1.16 2022/04/21 05:27:53 jmc Exp $
26182a3a5Sderaadt.\"
36182a3a5Sderaadt.\" Copyright (c) 1996 Theo de Raadt
46182a3a5Sderaadt.\" All rights reserved.
56182a3a5Sderaadt.\"
66182a3a5Sderaadt.\" Redistribution and use in source and binary forms, with or without
76182a3a5Sderaadt.\" modification, are permitted provided that the following conditions
86182a3a5Sderaadt.\" are met:
96182a3a5Sderaadt.\" 1. Redistributions of source code must retain the above copyright
106182a3a5Sderaadt.\"    notice, this list of conditions and the following disclaimer.
116182a3a5Sderaadt.\" 2. Redistributions in binary form must reproduce the above copyright
126182a3a5Sderaadt.\"    notice, this list of conditions and the following disclaimer in the
136182a3a5Sderaadt.\"    documentation and/or other materials provided with the distribution.
146182a3a5Sderaadt.\"
156182a3a5Sderaadt.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
166182a3a5Sderaadt.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
176182a3a5Sderaadt.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
186182a3a5Sderaadt.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
196182a3a5Sderaadt.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
206182a3a5Sderaadt.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
216182a3a5Sderaadt.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
226182a3a5Sderaadt.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
236182a3a5Sderaadt.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
246182a3a5Sderaadt.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25ae8c025fSaaron.\"
26*0b0f5449Sjmc.Dd $Mdocdate: April 21 2022 $
2782c0378dSderaadt.Dt FBTAB 5
2882c0378dSderaadt.Os
2982c0378dSderaadt.Sh NAME
3082c0378dSderaadt.Nm fbtab
3182c0378dSderaadt.Nd change device protection upon login
3282c0378dSderaadt.Sh DESCRIPTION
3382c0378dSderaadtThe
34e43c222cSpjanzen.Nm
35431305c8Saaronfile contains lines which specify how the permissions and ownership of
36431305c8Saaronvarious system files should be changed based on the user's login device name.
3782c0378dSderaadt.Pp
38ae8c025fSaaronComments start with a
39431305c8Saaron.Ql #
40ae8c025fSaaronand extend to the end of the line.
4182c0378dSderaadtBlank lines or lines with only a comment are ignored.
4282c0378dSderaadt.Pp
43431305c8SaaronAll other lines consist of three fields delimited by whitespace.
4482c0378dSderaadt.Bl -tag -width xxxxxxxxxxxxxxxxxxxx
4582c0378dSderaadt.It Login Device
46ae8c025fSaaronThe device you have logged in on (e.g.,
47ae8c025fSaaron.Dq /dev/ttyv0 ) .
4882c0378dSderaadt.It File Permission
4982c0378dSderaadtAn octal permission number (0600), as used by
5082c0378dSderaadt.Xr chmod 2 .
5182c0378dSderaadt.It Other devices
52ae8c025fSaaronThe final field is a colon
53431305c8Saaron.Pq Ql \&:
5415dba4e4Sjcsdelimited list of device paths (e.g.,
5515dba4e4Sjcs.Dq /dev/console:/dev/fd0a:/dev/wskbd* ) .
5615dba4e4SjcsDevice paths may include shell-style globbing patterns (see
5715dba4e4Sjcs.Xr glob 7 ) ,
5815dba4e4Sjcspotentially matching multiple devices.
5982c0378dSderaadt.El
6082c0378dSderaadt.Pp
6182c0378dSderaadtThe
62e43c222cSpjanzen.Nm
6382c0378dSderaadtfile is used by
6482c0378dSderaadt.Xr login 1
6582c0378dSderaadtto
6682c0378dSderaadt.Xr chown 2
671f53fde1Saaronthe specified files to the user who has performed a login.
688637447dSderaadtAdditionally,
6982c0378dSderaadt.Xr chmod 2
7082c0378dSderaadtis used to set the devices to the specified permission.
7182c0378dSderaadtWhen a user logs out,
7282c0378dSderaadt.Xr init 8
73e43c222cSpjanzenis responsible for performing the inverse operation, which results in
7482c0378dSderaadtthe files once again belonging to root.
7582c0378dSderaadt.Sh FILES
7682c0378dSderaadt.Bl -tag -width /etc/fbtab -compact
7782c0378dSderaadt.It Pa /etc/fbtab
7882c0378dSderaadt.El
7982c0378dSderaadt.Sh SEE ALSO
8082c0378dSderaadt.Xr login 1 ,
8190b3bb9fSaaron.Xr login_fbtab 3 ,
82*0b0f5449Sjmc.Xr glob 7 ,
8390b3bb9fSaaron.Xr init 8
84d97e605aStodd.Sh AUTHORS
8527e95970Sschwarze.An Guido van Rooij
86