]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/makedev.3
Removed trailing white space at end of lines
[thirdparty/man-pages.git] / man3 / makedev.3
index fb55f968e37e501b7b894d9c5c9f49b8abc604fa..3387c6b62e6c2f5a95f13c08961bff30d35d47b9 100644 (file)
 .\" the source, must acknowledge the copyright and authors of this work.
 .\" %%%LICENSE_END
 .\"
-.TH MAKEDEV 3 2014-05-28 "Linux" "Linux Programmer's Manual"
+.TH MAKEDEV 3 2018-04-30 "Linux" "Linux Programmer's Manual"
 .SH NAME
 makedev, major, minor \- manage a device number
 .SH SYNOPSIS
 .nf
-.BR "#define _BSD_SOURCE" "             /* See feature_test_macros(7) */"
-.B #include <sys/types.h>
-
+.B #include <sys/sysmacros.h>
+.PP
 .BI "dev_t makedev(unsigned int " maj ", unsigned int " min );
-
+.PP
 .BI "unsigned int major(dev_t " dev );
 .BI "unsigned int minor(dev_t " dev );
 .fi
@@ -42,14 +41,14 @@ a major ID, identifying the class of the device,
 and a minor ID, identifying a specific instance of a device in that class.
 A device ID is represented using the type
 .IR dev_t .
-
+.PP
 Given major and minor device IDs,
 .BR makedev ()
 combines these to produce a device ID, returned as the function result.
 This device ID can be given to
 .BR mknod (2),
 for example.
-
+.PP
 The
 .BR major ()
 and
@@ -81,7 +80,9 @@ and
 .BR minor ()
 functions are not specified in POSIX.1,
 but are present on many other systems.
-.\" The BSDs, HP-UX, Solaris, AIX, Irix
+.\" The BSDs, HP-UX, Solaris, AIX, Irix.
+.\" The header location is inconsistent:
+.\" Could be sys/mkdev.h, sys/sysmacros.h, or sys/types.h.
 .SH NOTES
 These interfaces are defined as macros.
 Since glibc 2.3.3,
@@ -91,6 +92,18 @@ they have been aliases for three GNU-specific functions:
 and
 .BR gnu_dev_minor ().
 The latter names are exported, but the traditional names are more portable.
+.PP
+The BSDs expose the definitions for these macros via
+.IR <sys/types.h> .
+Depending on the version,
+glibc also exposes definitions for these macros from that
+header file if suitable feature test macros are defined.
+However, this behavior was deprecated in glibc 2.25,
+.\" glibc commit dbab6577c6684c62bd2521c1c29dc25c3cac966f
+and since glibc 2.28,
+.\" glibc commit e16deca62e16f645213dffd4ecd1153c37765f17
+.IR <sys/types.h>
+no longer provides these definitions.
 .SH SEE ALSO
 .BR mknod (2),
 .BR stat (2)