major(3)

major3

Device number conversion

Part of makedev(3).

Usage

#include <sys/types.h>

dev_t

makedev(int major, int minor);

int

major(dev_t dev);

int

minor(dev_t dev);

Overview

The makedev() macro returns a device number created from the provided major and minor number. The major() and minor() macros return the original numbers from the device number dev. In other words, for a value dev of the type dev_t, and values ma, mi of the type int, the assertions

dev == makedev(major(dev), minor(dev))
ma == major(makedev(ma, mi))
mi == minor(makedev(ma, mi))

are valid.

In previous implementations of FreeBSD all block and character devices were uniquely identified by a pair of stable major and minor numbers. The major number referred to a certain device class (e.g. disks, TTYs) while the minor number identified an instance within the device class. Later versions of FreeBSD automatically generate a unique device number for each character device visible in /dev/. These numbers are not divided in device classes and are not guaranteed to be stable upon reboot or driver reload.

On FreeBSD these macros are only used by utilities that need to exchange numbers with other operating systems that may use different encodings for dev_t, but also applications that present these numbers to the user in a more conventional way.

Return values

The major() and minor() macros return numbers whose value can span the complete range of an int.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 26 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3–14.5
  27. 15.0–16.0

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.