Overview
For the most part it's like building software from source the old-school way, roughly:
configure --prefix=/usr/local make make DESTDIR=/tmp/package install-strip # or is it DESTDIR=/tmp/package make install-strip # jiggle things around so the files are clean and sane: chmod as needed to remove setgid bit make separate dirs as needed, if your software should be split into multiple components (eg. executable + library/headers) mksquashfs /tmp/package package.tcz -all-root -noappend
Some software is more tedious because they're made for other build systems. So you need to install that first before you can build.
Tooling
Assuming you're building on a TCL system then you'll need to load a few extensions first.
- file
- binutils
- the compiler
- squashfs-tools
- bash is probably nice to have
# DEP file, binutils (for stripping) for i in file binutils squashfs-tools ; do tce-load -i $i ; done
Worked example with Jose
I'm not sure why I have two install phases shown in my old notes...
tc@primer:~/jose/build$ sudo meson install --no-rebuild Installing lib/libjose.so.0.0.0 to /usr/local/lib Installing cmd/jose to /usr/local/bin Installing /home/tc/jose/build/jose/jose.h to /usr/local/include/jose Installing /home/tc/jose/jose/cfg.h to /usr/local/include/jose Installing /home/tc/jose/jose/io.h to /usr/local/include/jose Installing /home/tc/jose/jose/b64.h to /usr/local/include/jose Installing /home/tc/jose/jose/jwk.h to /usr/local/include/jose Installing /home/tc/jose/jose/jws.h to /usr/local/include/jose Installing /home/tc/jose/jose/jwe.h to /usr/local/include/jose Installing /home/tc/jose/jose/openssl.h to /usr/local/include/jose Installing /home/tc/jose/doc/ronn/jose.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-alg.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-fmt.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-b64-dec.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-b64-enc.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwe-dec.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwe-enc.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwe-fmt.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwk-exc.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwk-gen.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwk-pub.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwk-thp.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jwk-use.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jws-fmt.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jws-sig.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/ronn/jose-jws-ver.1 to /usr/local/share/man/man1 Installing /home/tc/jose/doc/doxygen/man/man3/jose_b64.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_jwk.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_jws.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_cfg.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_jwe.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_io_t.3 to /usr/local/share/man/man3 Installing /home/tc/jose/doc/doxygen/man/man3/jose_io.3 to /usr/local/share/man/man3 Installing /home/tc/jose/build/meson-private/jose.pc to /usr/local/lib/pkgconfig DESTDIR=/home/tc/BUILDROOT/jose ninja install
Now some sanitisation of the outputs:
# current working directory is probably ~/BUILDROOT/jose/ rm -rf usr/local/share/ chmod -R g-s ~/BUILDROOT/jose/ find . | xargs file | grep "executable" | grep ELF | grep "not stripped" | cut -f1 -d':' | xargs strip --strip-unneeded find . | xargs file | grep "shared object" | grep ELF | grep "not stripped" | cut -f1 -d':' | xargs strip -g # Now check that usr/local/lib/pkgconfig/jose.pc looks vanilla and sane.
Make the archive and checksum:
mksquashfs jose jose.tcz md5sum jose.tcz > jose.tcz.md5.txt
Generate the file listing, you might need to select the subtree manually like in this case where I only captured usr/:
cd jose/ find usr -not -type d > jose.tcz.list
libjansson is a dependency for jose that we built earlier, so make note of that
echo jansson.tcz > jose.tcz.dep
Write a .info file that describes the package, crib from existing files where possible.
Wrangle the deps some more so that it can get jose => jansson => libcrypto from jansson-dev.
Another example with more scripting for http-parser
Ideally we'd like to set a couple variables and then run a fixed set of commands that don't require much thinking. This is pretty close to that.
NAME=http-parser
mkdir -p /home/tc/BUILDROOT/$NAME
DESTDIR=/home/tc/BUILDROOT/$NAME make install-strip
cd ~/BUILDROOT/
chmod -R g-s $NAME
find $NAME/usr/local/include -type f -execdir chmod -x {} \;
mksquashfs $NAME $NAME.tcz
md5sum $NAME.tcz > $NAME.tcz.md5.txtThen the other steps as mentioned above.
Building tangd
This is what I wanted all along, but tang has a few dependencies. Thankfully not a very deep chain.
Random notes, unordered. I think part of it was that I wanted it to generate new keys if it's a fresh install and you don't have any yet. In the end I think I made it part of the startup process, not the package post-install.
mkdir -p -m 0700 /usr/local/var/db/tang
mkdir -p -m 0700 /usr/local/var/cache/tang
/usr/local/libexec/tangd-update /usr/local/var/db/tang /usr/local/var/cache/tang
/usr/local/libexec/tangd-keygen /usr/local/var/db/tang
/usr/local/libexec/tangd /usr/local/var/cache/tang
/home/tc/BUILDROOT/tang/usr/local/libexec/tangd-update
DEP: bash
sudo /home/tc/BUILDROOT/tang/usr/local/libexec/tangd-keygen /usr/local/var/db/tang
sudo ./libexec/tangd /usr/local/var/cache/tang 2>/dev/nullPackaging steps:
NAME=tang
cd ~/BUILDROOT/
# strip binaries
find $NAME | xargs file | grep "executable" | grep ELF | grep "not stripped" | cut -f1 -d':' | xargs strip --strip-unneeded
find $NAME | xargs file | grep "shared object" | grep ELF | grep "not stripped" | cut -f1 -d':' | xargs strip -g
rm -fv "$NAME.tcz"
mksquashfs $NAME $NAME.tcz -all-root
md5sum $NAME.tcz > $NAME.tcz.md5.txt
cd "$NAME"
find usr -not -type d > "../${NAME}.tcz.list"
cd ..
echo http-parser.tcz >> tang.tcz.dep
echo jose.tcz >> tang.tcz.dep
echo inetutils-servers.tcz >> tang.tcz.dep
write a .info fileSaving it for loading on boot:
# cp it all to /mnt/mmcBLAH sudo cp -v $NAME.tcz* /mnt/mmcblk0p2/tce/optional/ # Define a named TCP port on the system echo -e "tangd\t\t8264/tcp" >> /etc/services # This goes in the inetd config tangd stream tcp4 nowait root /usr/local/libexec/tangd-wrapper tangd /usr/local/var/cache/tang # Load the extension tce-load -i tang bash sudo killall inetd sudo tangd-firstrun # add keys to your backups in /opt/.filetool.lst /usr/local/var/db/tang /usr/local/var/cache/tang # run a backup sudo filetool.sh -b # test it, make sure it comes up after reboot sudo reboot