document the key structure, minor cleanups
[unix-history] / usr / src / usr.sbin / dev_mkdb / dev_mkdb.8
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" %sccs.include.redist.roff%
.\"
.\" @(#)dev_mkdb.8 5.5 (Berkeley) %G%
.\"
.Dd
.Os
.Dt DEV_MKDB 8
.Sh NAME
.Nm dev_mkdb
.Nd create
.Pa /dev
database
.Sh SYNOPSIS
.Nm dev_mkdb
.Sh DESCRIPTION
The
.Nm dev_mkdb
command creates a
.Xr db 3
hash access method database in
.Dq Pa /var/run/dev.db
which contains the names of all of the character and block special
files in the
.Dq Pa /dev
directory, using the file type and the
.Fa st_rdev
field as the key.
.Pp
Keys are a structure containing a mode_t followed by a dev_t,
with any padding zero'd out.
The former is the type of the file (st_mode & S_IFMT),
the latter is the st_rdev field.
.Sh FILES
.Bl -tag -width /var/run/dev.db -compact
.It Pa /dev
Device directory.
.It Pa /var/run/dev.db
Database file.
.El
.Sh SEE ALSO
.Xr ps 1 ,
.Xr stat 2 ,
.Xr db 3 ,
.Xr devname 3 ,
.Xr kvm_nlist 3 ,
.Xr ttyname 3 ,
.Xr kvm_mkdb 8
.Sh HISTORY
The
.Nm dev_mkdb
command appeared in
.Bx 4.4 .