sethostid(3)

sethostid3

Get/set unique identifier of current host

Part of gethostid(3).

Usage

#include <unistd.h>

long

gethostid(void);

void

sethostid(long hostid);

Library

Standard C Library (libc, -lc)

Overview

The sethostid() function establishes a 32-bit identifier for the current processor that is intended to be unique among all UNIX systems in existence. This is normally a DARPA Internet address for the local machine. This call is allowed only to the super-user and is normally performed at boot time.

The gethostid() function returns the 32-bit identifier for the current processor.

This function has been deprecated. The hostid should be set or retrieved by use of sysctl(3).

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 46 times.

  1. 2.0.5
  2. 2.1.5–2.2.5
  3. 2.2.6–3.4
  4. 3.5–3.5.1
  5. 4.0
  6. 4.1–4.2
  7. 4.3
  8. 4.4
  9. 4.5–4.7
  10. 4.8–4.11
  11. 5.0
  12. 5.1–5.2.1
  13. 5.3–5.5
  14. 6.0–6.3
  15. 6.4
  16. 7.0
  17. 7.1
  18. 7.2
  19. 7.3
  20. 7.4
  21. 8.0
  22. 8.1
  23. 8.2
  24. 8.3
  25. 8.4
  26. 9.0
  27. 9.1
  28. 9.2
  29. 9.3
  30. 10.0
  31. 10.1
  32. 10.2
  33. 10.3
  34. 10.4
  35. 11.0
  36. 11.1
  37. 11.2
  38. 11.3
  39. 11.4
  40. 12.0
  41. 12.1
  42. 12.2
  43. 12.3
  44. 12.4
  45. 13.0–13.2
  46. 13.3–14.5
  47. 15.0–16.0

History

The gethostid() and sethostid() syscalls appeared in 4.2BSD and were dropped in 4.4BSD.

Bugs

32 bits for the identifier is too small.

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