forked from mirrored-repos/manjaro-tools
328 lines
8 KiB
Markdown
328 lines
8 KiB
Markdown
manjaro-tools
|
|
=============
|
|
|
|
Manjaro-tools-0.9.14
|
|
|
|
User manual
|
|
|
|
###1. manjaro-tools.conf
|
|
|
|
manjaro-tools.conf is the central configuration file for manjaro-tools.
|
|
By default, the config is installed in
|
|
|
|
~~~
|
|
/etc/manjaro-tools/manjaro-tools.conf
|
|
~~~
|
|
|
|
A user manjaro-tools.conf can be placed in
|
|
|
|
~~~
|
|
$HOME/.config/manjaro-tools.conf
|
|
~~~
|
|
|
|
If the userconfig is present, manjaro-tools will load the userconfig values, however, if variables have been set in the systemwide
|
|
|
|
~~~
|
|
/etc/manjaro-tools/manjaro-tools.conf
|
|
~~~
|
|
|
|
these values take precedence over the userconfig.
|
|
Best practise is to leave systemwide file untouched.
|
|
By default it is commented and shows just initialization values done in code.
|
|
|
|
Tools configuration is done in manjaro-tools.conf or by args.
|
|
Specifying args will override manjaro-tools.conf settings.
|
|
|
|
~~~
|
|
######################################################
|
|
################ manjaro-tools.conf ##################
|
|
######################################################
|
|
|
|
# default branch
|
|
# branch=stable
|
|
|
|
# default arch: auto detect
|
|
# arch=$(uname -m)
|
|
|
|
# cache dir where buildpkg, buildtree cache packages/pkgbuild, builiso iso files
|
|
# cache_dir=/var/cache/manjaro-tools
|
|
|
|
# build dir where buildpkg or buildiso chroots are created
|
|
# chroots_dir=/var/lib/manjaro-tools
|
|
|
|
# default path to sets
|
|
# sets_dir=/etc/manjaro-tools/sets
|
|
|
|
# custom build mirror server
|
|
# build_mirror=http://mirror.netzspielplatz.de/manjaro/packages
|
|
|
|
################ buildtree ###############
|
|
|
|
# manjaro package tree
|
|
# repo_tree=('core' 'extra' 'community' 'multilib' 'openrc')
|
|
|
|
# host_tree=https://github.com/manjaro
|
|
|
|
# default https seems slow; try this
|
|
# host_tree_abs=git://projects.archlinux.org/svntogit
|
|
|
|
################ buildpkg ################
|
|
|
|
# default pkg buildset; name without .set extension
|
|
# buildset_pkg=default
|
|
|
|
################ buildiso ################
|
|
|
|
# default iso buildset; name without .set extension
|
|
# buildset_iso=default
|
|
|
|
# unset defaults to given value
|
|
# dist_name="Manjaro"
|
|
|
|
# unset defaults to given value
|
|
# dist_release=0.9.0
|
|
|
|
# unset defaults to value sourced from /etc/lsb-release
|
|
# dist_codename="Bellatrix"
|
|
|
|
# unset defaults to given value
|
|
# dist_branding="MJRO"
|
|
|
|
# unset defaults to given value
|
|
# iso_name=manjaro
|
|
|
|
# iso publisher
|
|
# iso_publisher="Manjaro Linux <http://www.manjaro.org>"
|
|
|
|
# iso app id
|
|
# iso_app_id="Manjaro Linux Live/Rescue CD"
|
|
|
|
# default compression
|
|
# iso_compression=xz
|
|
|
|
# valid: md5, sha1, sha256, sha384, sha512
|
|
# iso_checksum=md5
|
|
|
|
# experimental; use overlayfs instead of aufs
|
|
# requires minimum 4.0 kernel on the build host and on iso in profile.conf
|
|
# use_overlayfs="false"
|
|
~~~
|
|
|
|
###2. buildpkg
|
|
|
|
buildpkg is the chroot build script of manjaro-tools.
|
|
It it run in a abs/pkgbuilds directory which contains directories with PKGBUILD.
|
|
|
|
######manjaro-tools.conf supports the makepkg.conf variables
|
|
|
|
####Arguments
|
|
|
|
~~~
|
|
$ buildpkg -h
|
|
Usage: buildpkg [options] [--] [makepkg args]
|
|
-p <pkg> Buildset or pkg [default: default]
|
|
-a <arch> Arch [default: auto]
|
|
-b <branch> Branch [default: stable]
|
|
-r <dir> Chroots directory
|
|
[default: /var/lib/manjaro-tools/buildpkg]
|
|
-i <pkg> Install a package into the working copy of the chroot
|
|
-c Recreate chroot
|
|
-w Clean up cache and sources
|
|
-n Install and run namcap check
|
|
-s Sign packages
|
|
-u udev base-devel group (no systemd)
|
|
-q Query settings and pretend build
|
|
-h This help
|
|
~~~
|
|
|
|
######* build sysvinit package for both arches and branch testing:
|
|
|
|
* i686(buildsystem is x86_64)
|
|
|
|
~~~
|
|
buildpkg -p sysvinit -a i686 -b testing -cwsn
|
|
~~~
|
|
|
|
* for x86_64
|
|
|
|
~~~
|
|
buildpkg -p sysvinit -b testing -cswn
|
|
~~~
|
|
|
|
You can drop the branch arg if you set the branch in manjaro-tools.conf
|
|
The arch can also be set in manjaro-tools.conf, but under normal conditions, it is better to specify the non native arch by -a parameter.
|
|
|
|
######* -c
|
|
* Removes the chroot dir
|
|
* If the -c parameter is not used, buildpkg will update the existing chroot or create a new one if none is present.
|
|
|
|
######* -w
|
|
* Cleans pkgcache, and logfiles
|
|
|
|
######* -s
|
|
* Signs the package when built
|
|
|
|
######* -n
|
|
* Installs the built package in the chroot and runs a namcap check
|
|
|
|
######* -u
|
|
* Create udev build root (for eudev builds)
|
|
|
|
###3. buildiso
|
|
|
|
buildiso is used to build manjaro-iso-profiles. It is run insde the profiles folder.
|
|
|
|
#####Packages for livecd only:
|
|
|
|
* manjaro-livecd-cli-installer
|
|
* manjaro-livecd-openrc
|
|
* manjaro-livecd-systemd
|
|
|
|
####Arguments
|
|
|
|
~~~
|
|
$ buildiso -h
|
|
Usage: buildiso [options]
|
|
-p <profile> Buildset or profile [default: default]
|
|
-a <arch> Arch [default: auto]
|
|
-b <branch> Branch [default: stable]
|
|
-r <dir> Chroots directory
|
|
[default: /var/lib/manjaro-tools/buildiso]
|
|
-t <dir> Target directory
|
|
[default: /var/cache/manjaro-tools/iso]
|
|
-c Disable clean work dir
|
|
-i Build images only
|
|
-s Generate iso only
|
|
Requires pre built images (-i)
|
|
-v Verbose output, show profies detail (-q)
|
|
-q Query settings and pretend build
|
|
-h This help
|
|
~~~
|
|
|
|
######* build xfce iso profile for both arches and branch testing on x86_64 build system
|
|
|
|
* i686 (buildsystem is x86_64)
|
|
|
|
~~~
|
|
buildiso -p xfce -a i686 -b testing
|
|
~~~
|
|
|
|
* for x86_64
|
|
|
|
~~~
|
|
buildiso -p xfce -b testing
|
|
~~~
|
|
|
|
The branch can be defined also in manjaro-tools.conf, but a manual parameter will always override conf settings.
|
|
|
|
####Special parameters
|
|
|
|
######* -i
|
|
* Build images only
|
|
* will stop after all packages have been installed. No iso sqfs compression will be executed
|
|
|
|
######* -s
|
|
* Use this to sqfs compress the chroots if you previously used -i.
|
|
|
|
###4. buildset
|
|
|
|
buildpkg and buildiso support building from buildsets
|
|
|
|
Default location of sets is:
|
|
|
|
~~~
|
|
/etc/manjaro-tools/manjaro-tools/sets/pkg
|
|
/etc/manjaro-tools/manjaro-tools/sets/iso
|
|
~~~
|
|
|
|
but it can be configured in the manjaro-tools.conf.
|
|
|
|
buildset is a little helper tool to easily create buildsets.
|
|
It is run inside the abs/pkgbuilds or iso profiles directory.
|
|
|
|
####Arguments
|
|
|
|
~~~
|
|
$ buildset -h
|
|
Usage: buildset [options]
|
|
-c <name> Create set
|
|
-r <name> Remove set
|
|
-s <name> Show set
|
|
-i Iso mode
|
|
-q Query sets
|
|
-h This help
|
|
~~~
|
|
|
|
######* create a pkg buildset for lxqt
|
|
|
|
~~~
|
|
buildset -c lxqt-0.8
|
|
~~~
|
|
|
|
######* create a iso buildset
|
|
|
|
~~~
|
|
buildset -ic manjaro-0.9.0
|
|
~~~
|
|
|
|
The buildset name should not be a name of a package or profile!
|
|
Else buildpkg/buildiso won't recognize the build list and will only build the package/profile specified. The -p arg handles set and package/profile name.
|
|
|
|
If you create a buildset manually, the buildset must have a .set extension.
|
|
|
|
* Examples:
|
|
|
|
~~~
|
|
/etc/manjaro-tools/sets/pkg/lxqt-0.8.set
|
|
/etc/manjaro-tools/sets/iso/manjaro-0.9.0.set
|
|
~~~
|
|
|
|
###5. buildtree
|
|
|
|
buildtree is a little tools to sync arch abs and manjaro PKGBUILD git repos.
|
|
|
|
####Arguments
|
|
|
|
~~~
|
|
$ buildtree -h
|
|
Usage: buildtree [options]
|
|
-s Sync manjaro tree
|
|
-a Sync arch abs
|
|
-c Clean package tree
|
|
-q Query settings
|
|
-h This help
|
|
~~~
|
|
|
|
######* sync arch and manjaro trees
|
|
|
|
~~~
|
|
buildtree -as
|
|
~~~
|
|
|
|
###6. manjaro-chroot
|
|
|
|
manjaro-chroot is a little tool to quickly chroot into a second system installed on the host.
|
|
If the automount option is enabled, manjaro-chroot will detect installed systems with os-prober, and pops up a list with linux systems to select from.
|
|
If there is only 1 system installed besides the host system, no list will pop up and it will automatically mount the second system.
|
|
|
|
~~~
|
|
$ manjaro-chroot -h
|
|
usage: ${0##*/} chroot-dir [command]
|
|
-a Automount detected linux system
|
|
-q Query settings and pretend
|
|
-h Print this help message
|
|
|
|
If 'command' is unspecified, manjaro-chroot will launch /bin/sh.
|
|
~~~
|
|
|
|
######* automount
|
|
|
|
~~~
|
|
manjaro-chroot -a
|
|
~~~
|
|
|
|
######* mount manually
|
|
|
|
~~~
|
|
manjaro-chroot /mnt /bin/bash
|
|
~~~
|