NAME

tix-build — build a port

SYNOPSIS

DESCRIPTION

tix-build builds a source code directory containing a port(5) of software for this operating system. tix-build is usually invoked through the higher level tix-port(8).

The mandatory port argument is the directory containing the source code. The port(5) file containing the build instruction is found by adding .port to this path, or if it does not exist then tix.port inside the directory.

The options are as follows:

--build=triplet

The platform triplet for the machine the port is built on. (Default: Automatically detected.)

--destination=directory

The binary package is placed inside this directory.

--end=step

Stop the build after this step:

start

The start step before anything has happened.

clean, pre-clean

Clean the source directory before the build.

configure

Configure the port.

build

Build the port.

install

Install the port into the DESTDIR.

post-install

Run the post-installation script.

post-clean

Clean the source code after the port.

package

Create the binary package.

end

The end step after everything has happened. (Default)

--exec-prefix=prefix

The prefix where architecture dependent files are installed. (Default: --prefix)

--generation=generation

Create a binary package in the format of this tix generation level. (Default: 3)

--host=triplet

The platform triplet for the machine the port will run on. (Default: --build)

--make=path

Which make(1) to use. (Default: MAKE if set and otherwise make(1))

--makeflags=makeflags

Override the MAKEFLAGS variable inherited by make.

--prefix=prefix

Build the port into this prefix. (Default: The empty prefix designating the root directory)

--print-build

Output the effective --build triplet and exit.

--print-host

Output the effective --host triplet and exit.

--print-target

Output the effective --target triplet and exit.

--source-package=source-port

Deprecated alias for --source-port that will be removed after the next release.

--source-port=source-port

The source code for the SOURCE_PORT per port(5) is found in the source-port directory. (Default: $SOURCE_PORT)

--start=step

Start the build at this step (see --end). (Default: start)

--sysroot=directory

The system root to use while building and installing the port. The toolchain is wrapped to transparently use this sysroot during the build.

--tar=path

Which tar(1) to use during the build. (Default: tar(1))

--target=triplet

The port's outputs targets this platform triplet. (Default: --host)

--tmp=directory

Place temporary files in this directory. (Default: TMPDIR if set otherwise /tmp)

EXIT STATUS

tix-build will exit 0 on success and non-zero otherwise.

SEE ALSO

port(5), development(7), porting(7), tix(8), tix-create(8), tix-install(8), tix-port(8), tix-uninstall(8)

HISTORY

tix-build originally appeared in Sortix 0.8.