forked from mirrored-repos/manjaro-tools
402 lines
10 KiB
Markdown
402 lines
10 KiB
Markdown
manjaro-tools
|
|
=============
|
|
|
|
Manjaro-tools-0.9.9
|
|
|
|
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 or buildiso cache packages
|
|
# 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
|
|
|
|
# host_tree_abs=https://projects.archlinux.org/git/svntogit
|
|
|
|
################ buildpkg ################
|
|
|
|
# default pkg buildset; name without .set extension
|
|
# buildset_pkg=default
|
|
|
|
# Next settings are only useful if you compile packages against eudev
|
|
|
|
# default packages to trigger blacklist
|
|
# blacklist_trigger=('eudev' 'upower-pm-utils' 'eudev-systemdcompat')
|
|
|
|
# default blacklisted packages to remove from chroot
|
|
# blacklist=('libsystemd')
|
|
|
|
################ 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, specify a date here of have it automatically set
|
|
# dist_version="$(date +%Y.%m)"
|
|
|
|
# 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
|
|
~~~
|
|
|
|
####Config files in iso profiles
|
|
|
|
Each iso profile must have these files or symlinks to shared:
|
|
|
|
|
|
######* profile.conf
|
|
|
|
~~~
|
|
##########################################
|
|
###### use this file in the profile ######
|
|
##########################################
|
|
|
|
# possible values: openrc,systemd
|
|
# initsys="systemd"
|
|
|
|
# displaymanager="lightdm"
|
|
|
|
################ install ################
|
|
|
|
# unset defaults to given value
|
|
# kernel="linux319"
|
|
|
|
# unset defaults to given value
|
|
# efi_boot_loader="grub"
|
|
|
|
# set uefi partition size
|
|
# efi_part_size=42M
|
|
|
|
# unset defaults to given value
|
|
# plymouth_theme=manjaro-elegant
|
|
|
|
# unset defaults to given values
|
|
# names must match systemd service names
|
|
# start_systemd=('bluetooth' 'cronie' 'ModemManager' 'NetworkManager' 'org.cups.cupsd' 'tlp' 'tlp-sleep')
|
|
|
|
# unset defaults to given values,
|
|
# names must match openrc service names
|
|
# start_openrc=('acpid' 'bluetooth' 'consolekit' 'cronie' 'cupsd' 'dbus' 'syslog-ng' 'NetworkManager')
|
|
|
|
################# livecd #################
|
|
|
|
# unset defaults to given value
|
|
# hostname="manjaro"
|
|
|
|
# unset defaults to given value
|
|
# username="manjaro"
|
|
|
|
# unset defaults to given value
|
|
# password="manjaro"
|
|
|
|
# unset defaults to given values
|
|
# addgroups="video,audio,power,disk,storage,optical,network,lp,scanner,wheel"
|
|
|
|
# unset defaults to given values
|
|
# names must match systemd service names
|
|
# services in start_systemd array don't need to be listed here
|
|
# start_systemd_live=('livecd' 'mhwd-live' 'pacman-init' 'pacman-boot')
|
|
|
|
# unset defaults to given values,
|
|
# names must match openrc service names
|
|
# services in start_openrc array don't need to be listed here
|
|
# start_openrc_live=('livecd' 'mhwd-live' 'pacman-init' 'pacman-boot')
|
|
~~~
|
|
|
|
######* Packages
|
|
Contains root image packages
|
|
ideally no xorg
|
|
|
|
######* Packages-Custom/desktop
|
|
Contains the custom image packages
|
|
desktop environment packages go here
|
|
|
|
######* Packages-Xorg
|
|
Contains the Xorg package repo
|
|
|
|
######* Packages-Lng
|
|
Contains the language packages repo
|
|
|
|
######* Packages-Livecd
|
|
Contains packages you only want on livecd but not installed on the target system with installer
|
|
default files are in shared folder and can be symlinked or defined in a real file
|
|
|
|
###### optional custom pacman.conf in profile
|
|
|
|
* for i686
|
|
|
|
~~~
|
|
pacman-default.conf
|
|
~~~
|
|
|
|
* for x86_64
|
|
|
|
~~~
|
|
pacman-multilib.conf
|
|
~~~
|
|
|
|
If you need a custom livecd-overlay, create overlay-livecd folder in profile, and symlink from shared/overlay-livecd/your_selection to the overlay-livecd folder.
|
|
|
|
###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
|
|
-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
|
|
|
|
###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
|
|
-x Clean xorg cache
|
|
-l Clean lng cache
|
|
-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.
|
|
######* -x
|
|
By default, xorg package cache is not cleaned on every build. Enabling the xorg cache cleaning will result in dowloading the xorg drivers.
|
|
######* -l
|
|
By default, lng package cache is not cleaned on every build. Enabling the lng cache cleaning will result in dowloading the lng packages.
|
|
|
|
###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
|
|
~~~
|