Sat May 8 20:23:34 2021 UTC

"mybld" command setup

Important

All the commands are enter via your account. It means no need to use the root account.

Once the GIT project is recovered, all manipulations MUST be done from the folder containing your GIT project.

Setup

Tools (packages to install)

It is assumed that your NuTyX is free from any development package. So we start by installing the utilities:

get rsync git

Get the GIT project

We start by cloning the GIT project containing all the NuTyX recipes:

git clone -b <branch> git://github.com/NuTyX/packages-x86_64.git <branch>
The variable <branch> can take testing or rolling as value.

Once the GIT project in place, we move to the root of it, indeed the command mybld uses information from the GIT (VERSION, USERNAME, EMAIL, etc).

Go to the root of the projet

The GIT project is cloned. We need to go to the root of it.
cd <branch>
From now on all the followings commands are launched from the actual folder.

Setup my name and email

This step is necessary if you want to share your new packages, indeed, the mybld -n command uses this information when creating your new package.
git config --global user.name "James Bond"
git config --global user.email "james@nutyx.org"

Implementation of working directories

The mybld command uses a set of folders for its operation, they must therefore be created using the command:

mybld -I

You can adjust the operating folders locations in the configuration file ~/.mybld via the variables ROOT, ROOTMOUNT and VERSION.

Available Collections

Choose the collection you want to work on. Depending on the collection chosen, you will need to retrieve the collections specified in the right column.

Collections list.
base base
cli base cli
gui base cli gui
cli-extra base cli cli-extra
gui-extra base cli gui gui-extra

Retrieving binaries collections

Depending the choose collection, launch the command:

mybld -s name_of_collection
to retrieve the collection(s) needed.

For example, to use the gui collection, run the command:

for i in base cli gui; do mybld -s $i;done

If you want to recover the entire collection, run the same command but without arguments:

mybld -s

You can specify a custom address and version in the ~/.mybld configuration file via the URL and VERSION variables.

Using the command

(Re)Compile a package

mybld name_of_package
Compilation begins immediately.

Increment the version and recompile a package

mybld -i name_of_the_package
After confirmation, the compilation start immediatly.

Advanced mode

Let's say we have a critical package that doen't want to build properly. In that case, the best way is then to use the -p option for pause.

To illustrate the purpose of --pause option, I will try to compile nftables

Entering into the chroot

mybld -p nftables
You are now in chroot.
Type exit when finish.

 Good luck !!!
 

A new command is born

Depending of the collection the package you want to build, you get a new command named <collection_name>.

In this example nftables package belong to cli-extra collection so we can now type:

cli-extra -h
usage: cli-extra [option]
options:
   -a,   --all                 will build all the ports of the 'cli-extra' collection in the right order
   -l,   --list                will list all the ports of the 'cli-extra' collection in the right order
  -ru,   --remove-url          remove the URL part in /etc/cards.conf file for the 'cli-extra' collection
  -cp,   --check-ports         check if new ports are available
  -cb,   --check-binaries      check if binaries are uptodate
   -d,   --dry                 check if binaries are different then the ports but dont build anything
   -s,   --sync                synchronise binaries from rsync server location
   -c,   --config              printout the configuration
   -h,   --help                print help and exit
   -v,   --version             print version and exit
   -u,   --usage               print the recommended way of using the 'cli-extra' script

Where is what

That's now the big question.
Location of:
DEPOT /DEPOT
cli-extra collection DEPOT /DEPOT/cli-extra
nftables Pkgfile /DEPOT/cli-extra/nftables/Pkgfile
Sources files /sources
Compilation logs /LOGS
working directory /tmp/work/src and /tmp/work/pkg

Go on with compilation

So let's give a try to compile nftables now. Just type:
cli-extra nftables
Compilation with start just like normal.

If an error occur now, it will just return to the prompt:

checking for LIBMNL... yes
checking for LIBNFTNL... no
configure: error: Package requirements (libnftnl >= 1.1.8) were not met:

No package 'libnftnl' found

Consider adjusting the PKG_CONFIG_PATH environment variable if you
installed software in a non-standard prefix.

Alternatively, you may set the environment variables LIBNFTNL_CFLAGS
and LIBNFTNL_LIBS to avoid the need to call pkg-config.
See the pkg-config man page for more details.
=======> ERROR: Building '/DEPOT/cli-extra/nftables/nftables1608914972x86_64.cards.tar.xz' failed.
cards 2.4.124 create: could not parse Pkgfile: While running 'build()'

Fix the issue

We can now fix the issue by adjusting the deps:
cards install libnftnl libnftnl.devel
We go to the working directory and we give another try :
cd /tmp/work/src/nftables-0.9.7
 ./configure --prefix=/usr \
        --sysconfdir=/etc/nftables \
        --mandir=/usr/share/man \
        --with-json
Looks beter.
nft configuration:
  cli support:			readline
  enable debugging symbols:	yes
  use mini-gmp:			no
  enable man page:              yes
  libxtables support:		no
  json output support:          yes
  enable Python:		yes (with /usr/bin/python)
We can now continue the rest of the pkgfile commands:
make
the last command in Pkgfile is:
make DESTDIR=$PKG install
PKG variable need to be assign to /tmp/work/pkg:
PKG=/tmp/work/pkg
time to finish:
make DESTDIR=$PKG install
install -Dm644 ../nftables.conf "$PKG/etc/nftables/nftables.conf"

Packing up

when Pkgfile is complete, we can go back to the Pkgfile directory and use the command pkgmk -po to finish the job:
cd /DEPOT/cli-extra/nftables/
pkgmk -po

Help

The mybld command allows all kinds of options.

mybld -h

Remember to consult mybld's man page to obtain more information about other possible options:

man mybld