btxld(8)

btxld8

Link editor for btx clients

Usage

btxld [-qv] [-b file] [-E address] [-e address] [-f format] [-l file] [-o filename] [-P page] [-W page] file

Overview

The btxld utility binds the specified client executable together with a BTX loader program and the BTX kernel, and creates a composite object file suitable for loading during the boot process.

The options are:

-q

Quiet: inhibit warnings.

-v

Verbose: display information about the files processed.

-b file

Specify the BTX kernel to be bound with the client.

-E address

Set the client entry point.

-e address

Set the BTX loader entry point.

-f format

Specify the output format, where format is one of ‘bin’, ‘aout’, or ‘elf’.

-l file

Specify the BTX loader to be bound with the client.

-o filename

Name the output file. The default is “a.out”.

-P page

Specify the first page of the client's segment to be marked ‘present’, where page may be 0 or 1.

-W page

Specify the first page of the client's segment to be marked ‘writable’, where page may be 0, and should not exceed the number of pages occupied by the combined .text and .data segments of the client image.

Exit status

The btxld utility exits 0 on success, and >0 if an error occurs.

Releases

77 releases since FreeBSD 3.0-RELEASE; the text changed 39 times.

  1. 3.0–3.2
  2. 3.3–3.5.1
  3. 4.0–4.2
  4. 4.3
  5. 4.4–4.11
  6. 5.0–5.2.1
  7. 5.3–5.5
  8. 6.0–6.3
  9. 6.4
  10. 7.0
  11. 7.1
  12. 7.2
  13. 7.3
  14. 7.4
  15. 8.0
  16. 8.1
  17. 8.2
  18. 8.3
  19. 8.4
  20. 9.0
  21. 9.1
  22. 9.2
  23. 9.3
  24. 10.0
  25. 10.1
  26. 10.2
  27. 10.3
  28. 10.4
  29. 11.0
  30. 11.1
  31. 11.2
  32. 11.3
  33. 11.4
  34. 12.0
  35. 12.1
  36. 12.2
  37. 12.3
  38. 12.4
  39. 13.0–13.2
  40. 13.3–16.0

Authors

Robert Nordier ⟨[email protected]⟩

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