WIP

Sports is a package manager for 9front intended to exist side by side with the existing ports tree. Sports is primarily inspired by the Crux Linux distribution ports system and the Slackware Linux Slackbuilds system.

The name sports is an adjustment of ports while the 9front ports tree continues to exist: https://code.9front.org/hg/ports

• unionfs(4) -- Written by kvik and available at: git://code.a-b.link/unionfs. This provides a recursive union for port root dirs.

The recommended directory for installation is /sys/ports.

Clone:

% git clone https://github.com/henesy/sports

Sports will install ports to $ports/root. As such, you should bind this directory over root in some form. The sports management scripts are contained in $ports/bin.

For a user-specific installation, you could add the following to your $home/profile:

# Ports tree additions
ports=$home/repos/sports
bind -a $ports/bin /bin
port/shim

Union the ports root namespace into the current processes' namespace:

% port/shim

Union a single port's root namespace into the current process' namespace:

% port/shim games/breakout

Update the ports tree:

% port/pull

List all available ports in the tree:

% port/list -a

List all installed ports:

% port/list

Install a port from somewhere outside the ports tree:

% port/inst games/breakout

Install a port from a port's directory:

% cd $ports/games/breakout
% port/inst

Delete a port from somewhere outside the ports tree:

% port/del games/breakout

Delete a port from a port's directory:

% cd $ports/games/breakout
% port/del

Get info about a port:

% port/info games/breakout

Explicitly build a port from outside the ports tree:

% port/mk games/breakout

Explicitly build a port from the port's directory:

% cd $ports/games/breakout
% port/mk

Search for text in a port:

% port/grep breakout

Each port lives in a directory under the $ports root directory as per $ports/category-subcategory/portname.

Every port directory has a port file which is ingested by the ports/* scripts.

Additionally, each port has its own root/ directory in which the port is installed.

A port may also contain a patches/ directory which may be ingested by a patch function in the port file as described later.

Functions are called from the $workroot directory of the port.

Description -- One-line description of the port.

Home -- The homepage, or equivalent, for a port - 9p server directories should be dialstring^path such as tcp!9pio/foo/bar.

Maintainer -- The port maintainer, if you are submitting a new port, this is you.

name -- The name of the port to install. This may not contain colons as ':' is used as a separator in ports.db.

version -- For archive or 9p type ports, this is should be the release version. For git or hg type ports, this should be the commit hash of the target version to checkout upon cloning time.

source -- The URL or dialstring^/$path for the port's source code. An example 9p source is: tcp!9p.io/foo/bar.

type -- Type of port source, valid options are: archive, git, hg, 9p. This may be removed in the future.

workroot -- The directory, relative to the port's work/ directory, in which the build, etc. functions should be called.

sha512sum -- A checksum of your source archive, if present. Source archives are recommended rather than cloning.

depends -- Should contain a valid rc(1) list of all ports which must be installed for this port to be installed.

notice -- An optional message to provide to the user after install() is called.

build -- Should fully build the port from source. Note that you'll be cd(1)'d into $workroot before this is called.

install -- Should install the port to $ports/root in a form consistent with the Plan 9 filesystem layout. Note that you'll be cd(1)'d into $workroot before this is called.

uninstall -- Should completely uninstall the port from $ports/root in a manner which affects only the port currently being uninstalled, so no wildcards, etc. Note that you will not be cd(1)'d into $workroot as the directory may not exist.

clean -- This function is called after install() and should clean unnecessary files out of the work directory.

patch -- This function is called before build() and should be used if a patches/ directory exists.

You can do a full install of the ports tree to evaluate if the builds are working with:

% port/inst *

Please do.