loop(4)

loop4

Software loopback network interface

Part of lo(4).

Usage

device loop

Overview

The loop interface is a software loopback mechanism which may be used for performance analysis, software testing, and/or local communication. As with other network interfaces, the loopback interface must have network addresses assigned for each address family with which it is to be used. These addresses may be set with the appropriate ioctl(2) commands for corresponding address families. The loopback interface should be the last interface configured, as protocols may use the order of configuration as an indication of priority. The loopback should never be configured first unless no hardware interfaces exist.

If the transmit checksum offload capability is enabled on a loopback interface, checksums will not be generated by IP, UDP, TCP, or SCTP for packets sent on the interface. By default, this capability is enabled to avoid the overhead of checksumming for local communication where data corruption is unlikely.

If the receive checksum offload capability is disabled on a loopback interface, the flags that indicate a valid checksum will be unset if set previously. By default, this capability is enabled to avoid another checksum validation if it has already been validated.

Diagnostics

lo%d: can't handle af%d.

The interface was handed a message with addresses formatted in an unsuitable address family; the packet was dropped.

Releases

63 releases since FreeBSD 4.6-RELEASE; the text changed 38 times.

  1. 4.6–4.11
  2. 5.0–6.3
  3. 6.4
  4. 7.0
  5. 7.1
  6. 7.2
  7. 7.3
  8. 7.4
  9. 8.0
  10. 8.1
  11. 8.2
  12. 8.3
  13. 8.4
  14. 9.0
  15. 9.1
  16. 9.2
  17. 9.3
  18. 10.0
  19. 10.1
  20. 10.2
  21. 10.3
  22. 10.4
  23. 11.0
  24. 11.1
  25. 11.2
  26. 11.3
  27. 11.4
  28. 12.0
  29. 12.1
  30. 12.2
  31. 12.3
  32. 12.4
  33. 13.0–13.2
  34. 13.3
  35. 13.4–13.5
  36. 14.0–14.1
  37. 14.2–14.5
  38. 15.0–15.1
  39. 16.0

History

The lo device appeared in 4.2BSD. The current checksum generation and validation avoidance policy appeared in FreeBSD 8.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.