ROBSD-CROSS(8)

NAME
robsd-cross - cross compile OpenBSD

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

DESCRIPTION
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:

-d  Do not detach robsd-cross into the background.

-c comment
    Path to comment included in report.

-r 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.

-s step
    Skip step, see enumerated steps above. May be given multiple times.

-t tag
    Arbitrary tag used to annotate the invocation which is included in report. May be given multiple times.

target
    The architecture to cross compile.

FILES

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

DIAGNOSTICS

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

AUTHORS
Anton Lindqvist <anton@basename.se>