Sortix volatile manual
This manual documents Sortix volatile, a development build that has not been officially released. You can instead view this document in the latest official manual.
NAME
tix-create — create and manage a tix collection installationSYNOPSIS
tix-create | [-q] [-C collection] [-u url] [--build-id=build-id] [--force-mirror[=bool]] [--generation=level] [--import=collection] [--mirror=url] [--platform=platform] [--prefix=prefix] [--release-key=path] [--release-url=url] |
DESCRIPTION
tix-create creates and manages a tix collection of installed packages. A tix collection contains a top-level /tix directory with the collection.conf(5) configuration file, along with package metadata in the tixinfo and manifest directories.- --build-id=build-id
- Set the BUILD_ID variable in collection.conf(5) to build-id, signifying which build is currently installed as per tix-release(8).
- -C, --collection=collection
- Specifies which collection to act on.
- --force-mirror[=bool]
- Set the FORCE_MIRROR variable in collection.conf(5) to the optional value bool, or true if bool is not specified. If set to true, then the mirror is used, even if it is not officially supported.
- --generation=level
- Select tix metadata generation level (Default: 3)
- --import=collection
- Import the collection.conf(5) configuration and release.pub public key from this other collection.
- --mirror=url
- Set the MIRROR variable in collection.conf(5) to url, causing downloads to happen from the selected mirror if it is officially supported.
- --platform=platform
- Set the PLATFORM variable in collection.conf(5) to this platform triplet. Packages installed in the collection must be built for the same platform, or be platform independent. The platform defaults to the triplet of the local system.
- --prefix=prefix
- Set the PREFIX variable in collection.conf(5) to this prefix. Packages installed in the collection must be built with the same prefix, or be location independent. The prefix defaults to the collection, where the empty prefix designates the root directory.
- -q, --quiet
- Be quiet.
- --release-key=path
- Import the public key from the given path and store it as $collection/tix/release.pub. A trusted public key is required to download packages.
- -u, --release-url=url
-
Set the RELEASE_URL variable in collection.conf(5) to url, containing a tix-release(8) channel or release. Packages and upgrades are downloaded from this location and verified with the trusted public key from the --release-key option.
FILES
- /tix/
- The tix collection metadata directory.
- /tix/collection.conf
- collection.conf(5) configuration.
- /tix/manifest/
- Sorted file lists for every installed package.
- /tix/tixinfo/
- Metadata for every installed package.
EXIT STATUS
tix-create will exit 0 on success and non-zero otherwise.EXAMPLES
Create a tix collection in /local, pointed to an upstream tix release (as made with tix-release(8) ), downloading the public key via HTTPS, and installing the foo package:tix-create -C /local -u https://example.com/local/channel/stable/1.0 tix-install -C /local foo
tix-create -C /tmp/chroot --import=/ tix-install -C /tmp/chroot system libfoo bar
tix-create -C /tmp/sysroot --import=/ --platform=i686-sortix tix-install -C /tmp/sysroot system
tix-create -C /local tix-port -C /local /my/local/ports/libfoo