Fri Jul 21 07:08:08 2023 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> https://github.com/NuTyX/packages-x86_64.git <branch>

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 project

cd <branch>

Setup my name and email

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.

Retrieving binaries collections

Depending the choose collection, launch the command:

mybld -s name_of_collection

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

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

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

Configuration of cards

In the configuration below, personal packages will be stored in folders: /home/tnut/www/x86_64/<branch_name>/<collection_name>

Official collections remain on the remote server.

The contents of /etc/cards.conf file after modifications:

# No global url should be defined
# We need to specify an url only for remote repositories collection
#
# Default global server URL 
# url http://downloads.nutyx.org
#
# My own repository (this repository) without specified url 
/home/tnut/www/x86_64/<branch_name>/<collection_name>
#
## For all the graphical applications and desktops
dir /var/lib/pkg/depot/gui-extra|http://downloads.nutyx.org
#
## For a minimal graphical interface
dir /var/lib/pkg/depot/gui|http://downloads.nutyx.org
#
## For all the console applications
dir /var/lib/pkg/depot/cli-extra|http://downloads.nutyx.org
#
## For a minimal console interface
dir /var/lib/pkg/depot/cli|http://downloads.nutyx.org
#
## Chroot system without reboot possibilities for a chroot
dir /var/lib/pkg/depot/base|http://downloads.nutyx.org
#
## Normaly you want to keep base and
base /var/lib/pkg/depot/base
#
#
## If you want to keep more collections remove comments below
# Adjust to your needs
#
# base /var/lib/pkg/depot/cli
# base /var/lib/pkg/depot/cli-extra
# base /var/lib/pkg/depot//gui
# base /var/lib/pkg/depot/gui-extra
# base /var/lib/pkg/depot/...

Using the command

(Re)Compile a package

mybld name_of_package

Increment the version and recompile a package

mybld -i name_of_the_package

Advanced mode

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

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

Go on with compilation

cli-extra nftables

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

cards install libnftnl libnftnl.devel

cd /tmp/work/src/nftables-0.9.7
 ./configure --prefix=/usr \
        --sysconfdir=/etc/nftables \
        --mandir=/usr/share/man \
        --with-json

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)

make

make DESTDIR=$PKG install

PKG=/tmp/work/pkg

make DESTDIR=$PKG install
install -Dm644 ../nftables.conf "$PKG/etc/nftables/nftables.conf"

Packing up

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