ROBSD-CROSS(8) System Manager's Manual ROBSD-CROSS(8)

robsd-cross — cross compile OpenBSD

robsd-cross [-d] [-c comment] [-s step] [-t tag] target

robsd-cross [-d] -r path

The robsd-cross utility builds a cross compiler tool chain for target. The tool chain once built is accessible using robsd-crossenv(8). The process is divided into the steps as follows:

env
Dump the current environment. This is a no operation only used to collect data useful while debugging.
dirs
Create crossdir and populate it with the rudimentary directory layout.
tools
Build the compiler tool chain.
distrib
Build remaining parts of the target distribution.
dmesg
Take a copy of dmesg(8).
end
Auxillary step used to generate report.

Each invocation is identified by a directory created by robsd-cross rooted in robsddir and is named after the current date. The directory contains the entries as follows. In addition, each executed step has a corresponding log file in the same directory.

comment
File used to annotate the invocation which is included in report. By default, it contains a list of all applied patches.
dmesg
Copy of dmesg(8).
report
A summary delivered as a mail to root while running in the background once robsd-cross exits.
robsd.log
Standard output and error from robsd-cross while running in the background.
stat.csv
Collected statistics, see robsd-stat(8).
step.csv
Internal representation of the executed steps, see robsd-step(8).
tags
Tags included in report.
target
The target argument.

robsd-cross is configured using robsd-cross.conf(5) and must run as root. Some steps can however operate on behalf of another user. By default, robsd-cross runs in the background and must be killed using robsd-kill(8) to ensure a clean exit.

The options are as follows:

Do not detach robsd-cross into the background.
comment
Path to comment included in report.
path
Resume an invocation located at path. If the last executed step failed or aborted, it will be executed again. Otherwise, the next step will be executed.
step
Skip step, see enumerated steps above. May be given multiple times.
tag
Arbitrary tag used to annotate the invocation which is included in report. May be given multiple times.
target
The architecture to cross compile.

/etc/robsd-cross.conf
The default configuration file.

The robsd-cross utility exits 0 on success, and >0 if an error occurs.

robsd-cross.conf(5), robsd-crossenv(8), robsd-stat(8)

Anton Lindqvist <anton@basename.se>

February 10, 2022 OpenBSD 7.6