Libc-763.11.tar.gz

[apple/libc.git] / gen / devname.3

diff --git a/gen/devname.3 b/gen/devname.3
index 1a08e34ab6786b6b9054a86c49ef49135e0484b9..057e82f8a5e95f678836e29868ef4f46d8836022 100644 (file)
--- a/gen/devname.3
+++ b/gen/devname.3
@@ -32,11 +32,12 @@
 .\"     @(#)devname.3  8.2 (Berkeley) 4/29/95
 .\" $FreeBSD: src/lib/libc/gen/devname.3,v 1.11 2001/10/01 16:08:50 ru Exp $
 .\"
-.Dd April 29, 1995
+.Dd October 25, 2004
 .Dt DEVNAME 3
 .Os
 .Sh NAME
-.Nm devname
+.Nm devname ,
+.Nm devname_r
 .Nd get device name
 .Sh LIBRARY
 .Lb libc
@@ -44,7 +45,17 @@
 .In sys/stat.h
 .In stdlib.h
 .Ft char *
-.Fn devname "dev_t dev" "mode_t type"
+.Fo devname
+.Fa "dev_t dev"
+.Fa "mode_t type"
+.Fc
+.Ft char *
+.Fo devname_r
+.Fa "dev_t dev"
+.Fa "mode_t type"
+.Fa "char *buf"
+.Fa "int len"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn devname
@@ -55,10 +66,21 @@ with a device number of
 .Fa dev ,
 and a file type matching the one encoded in
 .Fa type
-which must be one of S_IFBLK or S_IFCHR.
+which must be one of
+.Dv S_IFBLK
+or
+.Dv S_IFCHR .
 If no device matches the specified values, or no information is
 available, NULL is returned.
 .Pp
+The
+.Fn devname
+function uses a static buffer, which will be overwritten
+on subsequent calls.
+The
+.Fn devname_r
+functions takes a buffer and length as arguments to avoid this problem.
+.Pp
 The traditional display for applications when no device is
 found is the string
 .Dq ?? .