any-howto – examples of commands to work with any system.

Description

All examples are demonstrated with amd64 dataset, the name hello-world-1.0 is taken for a single package.

Working directory

The creation of working directory:

        tar xzf any-<version>.tgz
        mv any-<version> my_dir
        cd my_dir
        tar xzf <archive-one>
        tar xzf <archive-two>
        ...

The creation of working directory, when commands have been installed:

        anyinit my_dir
        cd my_dir

To employ the working stuff of the project:

        any/bin/deploy.sh --help
and follow the format of deploy.sh.

Build

List all available packages:

        lspkg amd64

List the contents of somelist.src:

        lspkg amd64 somelist.src

Build the single package:

        any do amd64 hello-world-1.0

Build the single package inside chroot:

        anch do amd64 hello-world-1.0

Build the list of packages somelist.src:

        any do amd64 somelist.src

View default available lists:

        cat ports/list/all.src

Host isolation

Enter the isolated environment manually:

        sudo chroot `pwd` /bin/sh -l

The second way:

        sudo chroot `pwd`
        . /etc/profile

Work with entire project

The example of the build of entire project:

-
deploy binary packages, whose sources are not shipped with the distro. They are listed in ports/list/deploy.src. The path to binary packages is given in the option any_pkg.
            any deploy amd64 deploy.src any_pkg=packs/amd64/
-
launch distro building. The distro set is listed in ports/list/build.src.
            any do amd64 build.src

Dependencies

If any_pkg is not set, its default value is build/pack/amd64/.

Install the dependencies of hello-world-1.0 from /path/to/pkg and build hello-world-1.0 itself:

        any tree amd64 hello-world-1.0 any_pkg=/path/to/pkg

Install the dependencies for a package hello-world-1.0, which is absent in all.src:

        any tree amd64 hello-world-1.0 any_pkg=/path/to/pkg \
            any_list_all=all.src,hello-world-1.0

Install the dependencies, listed in needed-packs.src.

        any deploy amd64 needed-packs.src any_pkg=/path/to/pkg

Calculate full tree of dependencies for hello-world-1.0 and build everything:

        any buildtree amd64 hello-world-1.0

Configuration

Add any_parameter to the build:

        any do amd64 hello-world-1.0 any_parameter=value

Store any_parameter permanently:

        echo '
[default]
any_parameter = value' >> $(rootrdd)/rdd.def

Store any_parameter for amd64 only:

        echo '
[amd64]
any_parameter = value' >> $(rootrdd)/rdd.def

Build extensions

See all output on terminal, no logs are created:

        any do amd64,output hello-world-1.0

Turn off individual build context, use shared one:

        any do amd64,staticdeproot hello-world-1.0

Add packages to shared context:

        any deploy amd64,staticdeproot needed-packs.src any_pkg=/path/to/pkg

Check the sanity of binary files from build/image/amd64/hello-world-1.0/:

        any do amd64,sane hello-world-1.0

Paths

build/image/amd64/hello-world-1.0/
binary files of hello-world-1.0, installed after successfull build.

build/pack/amd64/
directory with installable binary packages.

ports/srcstatic/
directory for static archives with package sources.
By default the build of hello-world-1.0 will search for the archive ports/srcstatic/hello-world-1.0.tgz.

build/work/amd64/hello-world-1.0/
directory where build is performed.

ports/packages/hello-world-1.0/
directory with anybuild and other dev resources.

ports/list/
lists with available packages and sets for current distro project.

ports/patch/hello-world-1.0/
directory for patches of hello-world-1.0 package.
These patches are applied on top of sources from ports/srcstatic/.

New package new-1.2.3

Brief explanation on adding of the new package new-1.2.3 to a project.

Create anybuild ports/packages/new-1.2.3/new.build
Store main sources new-1.2.3.tar.gz in ports/srcstatic/
Store patches (if there are some) in ports/patch/new-1.2.3/
Add new-1.2.3 name to all.src

See also

any-workdir(7), any-do(1), any-map(7), anymods(7), rdd(1), anyinit(1), any-deploy(1), any-tree(1), any-buildtree(1)