Document the devtoname(9) kernel interface.

2 files changed, 60 insertions, 2 deletions

diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index a05efb6..d369dc7 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -13,8 +13,8 @@ MAN9=	MD5.9 \
 	VOP_STRATEGY.9 \
 	at_exit.9 at_fork.9 at_shutdown.9 bios.9 boot.9 buf.9 cd.9 copy.9 \
 	devfs_add_devswf.9 devfs_link.9 devfs_remove_dev.9 devstat.9 \
-	fetch.9 ifnet.9 inittodr.9 intro.9 kernacc.9 malloc.9 microseq.9 \
-	mi_switch.9 namei.9 panic.9 physio.9 posix4.9 psignal.9 \
+	devtoname.9 fetch.9 ifnet.9 inittodr.9 intro.9 kernacc.9 malloc.9 \
+	microseq.9 mi_switch.9 namei.9 panic.9 physio.9 posix4.9 psignal.9 \
 	resettodr.9 rtalloc.9 rtentry.9 sleep.9 spl.9 \
 	store.9 style.9 suser.9 time.9 timeout.9 uio.9 \
 	vget.9 vnode.9 vput.9 vref.9 vrele.9 vslock.9
diff --git a/share/man/man9/devtoname.9 b/share/man/man9/devtoname.9
new file mode 100644
index 0000000..82ca731
--- /dev/null
+++ b/share/man/man9/devtoname.9
@@ -0,0 +1,58 @@
+.\" Copyright (c) 1999 Chris Costello
+.\" All rights reserved.
+.\" 
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\" 
+.\" $FreeBSD$
+.\" 
+.Dd September 25, 1999
+.Os
+.Dt DEVTONAME 9
+.Sh NAME
+.Nm devtoname
+.Nd "Converts dev_t data into a string indicating the device name"
+.Sh SYNOPSIS
+.Fd #include <sys/types.h>
+.Fd #include <sys/conf.h>
+.Ft const char *
+.Fn devtoname "dev_t dev"
+.Sh DESCRIPTION
+The
+.Fn devtoname
+function returns a pointer to the name of the device passed to it.  The name
+is whatever was set to it in
+.Fn make_dev .
+If no
+name is associated with
+.Va dev ,
+a pointer to a string consisting of a
+.Dq #
+followed by
+.Dq Va major Ns / Ns Va minor
+as applies to
+.Va dev
+is returned.
+.Sh HISTORY
+The
+.Fn devtoname
+interface first appeared in
+.Fx 4.0