---
name: "btxld"
section: "8"
platform: "freebsd"
package: "base"
version: "16.0-CURRENT-20261027-61c70dc16a79"
release: "FreeBSD 16.0-CURRENT (2026-10-27)"
platforms: ["freebsd"]
url: "https://new.carta.tech/btxld"
---

# btxld(8)

link editor for BTX clients

## NAME

**btxld** – link editor for BTX clients

## SYNOPSIS

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

## DESCRIPTION

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.

## SEE ALSO

[ld(1)](/ld/1.md), [boot(8)](/boot/8.md)

## AUTHORS

Robert Nordier ⟨*rnordier@FreeBSD.org*⟩