Arch Build System (Dansk)

From ArchWiki
Revision as of 14:20, 16 December 2007 by Jan-portugal (Talk | contribs) (Byggefunktionen - ABS-måden)

Jump to: navigation, search

C ategory:Dansk Ca tegory:Package management (Dansk)

Summary help replacing me
Forklarer om byggesystemet i Arch Linux
Tilgængelig på følgende sprog

Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry Template:I18n entry

Relaterede artikler (Engelsk)
AUR_Trusted_User_Guidelines
AUR
AUR Q & A
Aurbuild
Andre artikler på dansk
Main_Page_(Dansk)

THE ARTICLE IS BEING TRANSLATET by jan-portugal

Hvad er ABS?

ABS er en forkortelse af Arch Build System - eller på dansk Archs byggesystem. Det er et 'ports'-lignende system til at bygge software fra kilden.

Hvad er et 'ports'-lignende system?

'Ports' er et system, anvendt af FreeBSD, der lader kilde-pakker blive downloadet, udpakket, tilrettet, kompileret og installeret. En 'port' er blot en lille mappe på brugerens computer med et navn, der svarer til det software der installeres. Denne mappe indeholder nogle få filer med instruktioner for download og installation af en pakke fra en kilde, typisk ved at navigere til mappen - eller porten - og udføre kommandoerne make og make install. Systemet vil så downloade, kompilere og installere det ønskede software. En typisk bruger af BSD-porte vil downloade hele port-hierarkiet, der blot er et mappetræ med mange undermapper - eller porte, der hver svarer til det respektive i9nstallerbare software.

ABS er et lignende koncept.

ABS laves ud fra et mappetræ, (ABS-træet), der findes under /var/abs, som indeholder mange undermapper. Hver mappe i sin kategori og alle navngivet af deres respective byggebare pakke.
Du kan kalde enhver undermappe - med navn efter pakken - for et ABS. Det samme som man vilde kalde en 'port'. Disse ABS-er - eller undermapper indeholder hverken software-pakken eller kilden, men nærmere en PKGBUILD-fil (og somme tider andre filer). En PKGBUILD er en simpel tekstfil, der indeholder instruktioner til kompilering og pakning, så vel som en URL til det tar-arkiv, som skal downloades. Den vigtigste komponent i ABS er PKGBUILD.

Hurtig gennemgang

Kør kommandoen abs som 'root' for at oprette ABS-træet. Hvis du f.eks. vil bygge editoren Nano fra kilden, skal du kopiere filen /var/abs/core/base/nano til en byggemappe. Gå ind i byggemappen og kør en makepkg. Så enkelt er det.
'Makepkg' vil forsøge at læse og eksekvere de instruktioner, der findes i PKGBUILD-filen. Tar-arkivet fra kilden downloades, udpakkes, kompileres og klemmes ind i en pakke med fil-endelsen .pkg.tar.gz, som det instrueres i filen PKGBUILD.
Installation er så nemt, som at køre en pacman -U nano.pkg.tar.gz, eller lav pakken og installér den rent med Pacman. Alt med kun én kommando.
Fjernelse af pakken håndteres også af Pacman.

Filen PKGBUILD og andre filerkan selvfølgelig tilpasses som du ønsker, og du kan vælge at benytte 'makepkg'-funktionen i ABS til at lave egne brugertilpassede pakker fra kilder udenfor selve ABS-træet.(Se en prototype på en PKGBUILD og installationsfile under /var/abs/core/)


Med ABS-træet på plads har en Arch Linux-bruger, der vil kompilere fra kilde, alle tilgængelige pakker ved hånden. ABS-værktøjerne kan også bruges til at bygge fra kilde til dit system, og/eller dele det med fællesskabet i samspil med Arch linux-brugernes software-kilder AUR.

Som altid kan du se man makepkg for mere specifik information.

TODO: kort forklaring om 'makeworld'

makeworld har ingen 'man'-side, så benyt makeworld --help.

Hvorfor skulle jeg bruge ABS?

Arch ByggeSystem (ABS) anvendes til:

  • At lave nye pakker fra kilde af software, der endnu ikke er tilgængelig. (Se hvordan du laver pakker til Arch Linux)
  • Tilpas eksisterende pakker, så de passer til dit behov (aktivere eller deaktivere valgmuligheder)
  • Genopbyg hele dit system med dine kompileringsflag (a la FreeBSD)
  • Få kernemoduler til at virke med din brugertilpassede kerne.

ABS er ikke nødvendig for at bruge Arch Linux - men det er nyttigt.

Denne vejledning forsøger at give dig et overblik over ABS og Arch Linux-pakker. Det er ikke en komplet reference-guide!
Hvis du vil vide mere, skulle du prøve at kigge på man-siderne.

Installér pakker

For at benytte ABS skal du først installere cvsup og wget. Dette gøres med

pacman -Sy cvsup wget

Som et alternativ til cvsup kan du benytte csup - en hurtigere version skrevet i C:

pacman -Sy csup

/etc/abs/abs.conf

Redigér /etc/abs/abs.conf til at inkludere dine software-kilder:

nano /etc/abs/abs.conf

Fjern udråbstegnet '!' foran de passende software-kilder som f.eks.:

SUPFILES=(core extra !unstable community !testing)

Opret ABS-træet

Som 'root' køres:

abs

Dit ABS-træ er nu oprettet under /var/abs. Bemærk de passende grene på ABS-træet nu eksisterer og svarer til dem du specificerede i /etc/abs/abs.conf.

Kommandoen abs bør også benyttes til regelmæssigt at synkronisere og opdatere dit ABS-træ.

ABS-træet

Når du kører abs for første gang, synkroniseres ABS-træet med Ardh-serveren ved hjælp af 'cvs'-systemet. Hvad er så ABS-træet helt specifikt? Det findes under /var/abs, og ser såledesud:

|-
| -- core/
|-
|     ||-- autoconf/
|-
|     ||-- automake/
|-
|     ||-- ...
|-
| -- devel/
|-
| -- ...
|-
| -- extra/
|-
|      || -- daemons/
|-
|      ||      || -- acpid/
|-
|      ||      ||      || -- PKGBUILD
...    ...    ...    ...

ABS-træet har altså nøjagtigt den samme struktur som pakkedatabasen:

  • Første mappebane repræsenterer kategorier.
  • Anden mappebane repræsenterer selve ABS-erne, hvis navne svarer til de pakker du vil bygge.
  • PKGBUILD-filerne indeholder alt nødvendig information omkring pakken.
  • Endvidere kan en ABS-mappe indeholde rettelser og/eller andre filer, der er nødvendige for at bygge pakken.

Det er vigtigt at forstå, at selve pakkens kildekode ikke findes i ABS-mappen. I stedet for indeholder PKGBUILD-filen en URL fra hvilken ABS automatisk vil downloade.

/var/abs/local/

Inde i ABS-træet er der en speciel mappe - local. Det er din mappe. I denne mappe kan du gøre alt, og du bør aldrig ændre noget i resten af ABS-træet. Kopiér en ABS fra træet (var/abs/branch/category/pakkenavn) til byggemappen (/var/abs/local/).

Opret din byggemappe /var/abs/local/:

mkdir /var/abs/local

BEMÆRK: Den første download af ABS-træet er den største. Derefter er det kun nødvendigt med mindre opdateringer, så vær ikke bange, hvis du kun har en 56k-tilslutning. Der er kun tale om tekstfiler, som er komprimerede under overførslen.

Nu hvor vi ved, hvad et ABS-træ er - hvordan kan vi så bruge det?

Byggefunktionen - traditionel metode

Hvis du ikke kender til at kompilere fra kilde, skal du vide, at de fleste pakker (dog ikke alle) kan bygges fra kilde på denne traditionelle måde:

  • Download kildens tar-arkiv fra en ekstern server med en web-browser, ftp, wget eller andre metoder.
  • Pak kildefilen ud som eks.:
 tar -xzf foo-0.99.tar.gz
 tar -xjf foo-0.99.tar.bz2
  • Gå ind i mappen:
cd foo-0.99
  • konfigurér pakken. Generelt er der et lille script ved navn configure i kildemappen, der benyttes til at konfigurere pakken (tilføje eller fjerne understøttelse for noget, vælge destination for installation osv.). Scriptet tjekker også, om din computer har det nødvendige software for pakken. Det kan køres med:
./configure <valgmulighed>

Du skulle først prøve valgmuligheden 'help', for bedre at forstå, hvordan det virker:

./configure --help

Hvis ikke valgmuligheden --prefix sættes i scriptet, vil de fleste scripts benytte /usr/local som sti til installationen, mens andre benytter /usr. For en bedre konsistens tilrådes generelt at sætte valgmuligheden --prefix=/usr/local. Det er god praksis at installere personlige programmer i /usr/local, og at have dem, der vedligeholdes af distributionen, anbragt i /usr. Dette tilsikrer, at personlige programmer kan sameksistere med dem, der håndteres af ditributionens pakkehåndtering - i Arch Linux' tilfælde er det Pacman.

./configure --prefix=/usr/local
  • Kompiler kilderne:
make
  • Installér
make install
  • Afinstallering udføres ved at gå ind i kildemappen og køre:
make uninstall

Dog burde du altid læse filen INSTALL, for at se, hvordan pakken skal bygges og installeres! Ikke alle pakker anvender systemet configure; make; make install!

Byggefunktionen - ABS-måden

ABS er et elegant værktøj, der yder en stærk assistance og tilpasningsmuligheder til byggeprocessen, samt opretter en pakkefil til installation. ABS-metoden involverer kopiering af en ABS fra træet til en byggemappe og køre en 'makepkg'. I vores eksempel vil vi bygge pakken slim display-håndtering.

  • 1. Kopiér slim ABS fra træet til en byggemappe:
cp -r /var/abs/extra/x11/slim /var/abs/local
  • 2. Navigér til byggemappen:
cd /var/abs/local/slim
  • 3. Kør kommandoen makepkg, der automatisk downloader tar-arkivet fra kilden, pakker ud, kompilerer og opretter filen slim.pkg.tar.gz Valgmuligheden -i kalder Pacman til automatisk at installere den resulterende pakkefil slim.pkg.tar.gz:
makepkg -i

Det var det! Du har lige bygget slim fra kilde og installeret det rent på dit system med Pacman. At fjerne pakken håndteres også af Pacman:

pacman -R slim

Alternativt kan du køre 'makepkg' uden valgmuligheden '-i' og installere pakken manuelt med Pacman:

pacman -U slim.pkg.tar.gz

Nyttige valgmuligheder

Nogle nyttige valgmuligheder for 'makepkg options' fra man-siden (Forklaringer er oversat til dansk):

-c, --clean
             Fjerner efterladte arbejdsfiler og mapper efter successfuld opbygning
-f, --force
             makepkg  bygger ikke en pakke, hvis en bygget pakke allerede findes i mappen PKGDEST (sat i /etc/makepkg.conf), 
             der som standard viser til den aktuelle mappe. Dette tillader, at en bygget pakke overskrives.
-i, --install
             Installér eller opgradér pakken efter successfuld bygning med Pacman.
-s, --syncdeps
             Installér manglende afhængigheder med Pacman. Når der mangler byggetids- eller kørselstids-afhængigheder
             prøver Pacman at løse dem. Hvis det lykkes, downloades og installeres de manglende pakker.

Således vil kommandoen makepkg -csi hente alle afhængigheder (hvis der er nogen), installere (med Pacman) og fjerne alle overskydende arbejdsfiler fra byggemappen.

Igen - se man makepkg for mere information.

TODO: Forklare funktionen makeworld til at genopbygge hele systemet osv.

Hvad er en pakkefil?

Husk at ABS downloader automatisk kildekoden for netop det software, du kompilerer. Derefter pakker det ud, kompilerer kilderne og klemmer det hele ind i en installerbar pakke. Typisk er resultatet en pakkefil ved navn foo.pkg.tar.gz.

Faktisk er det blot en g-zippet tar-arkiv eller 'tarball', der indeholder:

  • De filer der skal installeres.
  • Filen .PKGINFO: indeholder alle metadata, der er nødvendige, for at Pacman kan håndtere pakker, afhængigheder osv.
  • Filen .FILELIST: viser en liste over alle filer i arkivet. Det benyttes i forbindelse med afinstallation , eller for at tjekke for filkonflikter.
  • Filen .INSTALL: bruges til at eksekvere kommandoer efter installér-/opgradér-/fjern-trinet (Denne fil findes kun, hvis den er specificeret i PKGBUILD.)

Eftersom Pacman håndterer 'tar.gz'-pakker, kan 'foo.pkg.tar.gz' nu let installeres/fjernes.

Hvad er en PKGBUILD? Og hvad indeholder det?

Som forklaret før indeholder filen PKGBUILD metadata om en pakke. Det er en simpel tekstfil.
Her er et eksempel:

# $Id: PKGBUILD,v 1.12 2003/11/06 08:26:13 dorphell Exp $
# Maintainer: judd <jvinet@zeroflux.org>
# Contributor: Judd Vinet <jvinet@zeroflux.org>
pkgname=foo
pkgver=0.99 # BEMÆRK: Hvis pakkeversionen havde været '0.99-10', så benyt en bundstreg som f.eks. '0.99_10'.
pkgrel=1
pkgdesc="en kort beskrivelse af 'foo'"
arch=(i686 x86_64)
url="http://www.foo.org"
license=('GPL')
groups=
provides=
depends=('qt' 'python')
makedepends=('guile')
conflicts=('yafoo')
replaces=('mffoo')
backup=('etc/foo/foo.conf')
install=('foo.install')
source=(http://www.foo.org/download/$pkgname-$pkgver.tar.gz)
md5sums=('2c0cca3ef6330a187c6ef4fe41ecaa4d35175bee593a7cc7d6205584a94d8625')

build() {
  cd $startdir/src/$pkgname-$pkgver
  ./configure --prefix=/usr
  make || return 1
  make prefix=$startdir/pkg/usr install
}

Så lad os forklare hvert felt:

  • # text : kommentarer
  • # $Id: PKGBUILD,v ...: Er cvs-flaget for denne pakke (oprettet fra systemet 'archlinux-cvs').
  • # Maintainer: Den ansvarlige vedligeholder for denne pakke i de officielle software-kilder.
  • # Contributor: Personen der skrev den første PKGBUILD for denne pakke.
  • pkgname: Pakkens navn.
  • pkgver: Pakkens version.
  • pkgrel: Arch-pakkens udgivelsesnummer. Dette er forskelligt fra pakkeversionen, og ændres når PKGBUILD ændres. Der kan være mange årsager til dette, f.eks hvis du aktiverer understøttelse af kompileringstid for noget.
  • pkgdesc: En kort beskrivelse af pakken. Dette er hvad du sernår du browser pakkedatabasen
  • arch: Viser på hvilke arkitekturer, det er kendt for at bygge og virke - se Arch64_FAQ for detaljer om portering.
  • url: Hjemmesiden for softwaren (som kommer frem, når du klikker på en pakke i pakkedatabasen).
  • license: Licensen under hvilken dette software distribueres.
  • groups: Dette anvendes til at gruppere pakker when you try to install kde, for example, it installs all packages that belong to the kde group
  • provides: this is used if the package provides another package, for example, kernel-scsi provides kernel
  • depends: this lists the run-time dependencies of the package (what it needs to work)
  • makedepends: dependencies needed to build the package but which are not needed once the package is built
  • conflicts: these packages cannot be installed at the same time. Here, foo conflicts with yafoo (yet another foo). They cannot be installed at the same time.
  • replaces: the new package replaces the old one. Here, mffoo (my first foo) is no longer supported and is being replaced with foo
  • backup: which files to back up (as file.pacsave) when the package is removed
  • install: specifies a special install script that is to be included in the package (it has to be in the same directory as PKGBUILD)
  • source: this specifies from where to download the package's source code. It can be a local package as well as a "http" of "ftp" one. It is named using pkgver in order to avoid changing the source each time the version changes.
  • md5sums: md5sums of the source to check their integrity

So now, let's explain the function:

  • build: all the actions needed to build the package (it will be explained in more detail later in this document)

Well, you see that the PKGBUILD file contains all the information that might be needed by the package manager. It is the heart of pacman and abs.

There are also install files. This PKGBUILD specifies 'foo.install' as the package's install file. Here is an example install file:

post_install() {
/bin/true
}

post_upgrade() {
/bin/true
}

pre_remove() {
/bin/true
}

op=$1
shift

$op "$@"

Here are the function explanations:

  • post_install: this script is run right after files are installed; it takes one argument:
    • the package version
  • post_upgrade: this script is run after all files have been upgraded; it takes two arguments:
    • the new package version
    • the old package version
  • pre_remove: this script is run right before files are removed (stop a daemon, for example) and takes one argument:
    • the package version

The three lines at the bottom are needed in every install file so that they run properly.

Build function explained

So let's take a look at an ABS build function as dictated by the PKGBUILD example from above. Note the build section:

build() {
  cd $startdir/src/$pkgname-$pkgver
  ./configure --prefix=/usr
  make || return 1
  make prefix=$startdir/pkg/usr install
}

What is happening:

  • enter the directory where sources were uncompressed:
cd $startdir/src/$pkgname-$pkgver
  • configure the package, and tell it to install in the /usr directory:
  ./configure --prefix=/usr
  • compile
  make || return 1
  • install the software not in /usr, but instead in $startdir/pkg/usr so that pacman has control of the files.
  make prefix=$startdir/pkg/usr install

What we want to do is to build the package, not to install it. So instead of installing to the standard place (/usr), we tell make to put all files in our special directory: $startdir/pkg/usr. Thus, makepkg can look and see which files the package installs, and then compress them into the Arch package.

NOTE: It is sometimes the case where prefix is not used in the Makefile; often DESTDIR is used instead. If the package is built with autoconf/automake, use DESTDIR; this is what is documented in the manuals. Check if the generated filelist is a lot shorter than it should be, and if so, try building with make DESTDIR=$startdir/pkg install. If that does not work, you'll have to look further into the install commands that are executed by "make <...> install=".

First use of ABS: customizing a package

This situation can arise more often than you might think: official packages are compiled having chosen a certain number of --enable or --disable options, and these are not necessarily the ones you would have chosen.

To illustrate it, I'll take an example: foo. The foo package is built with arts support disabled. Imagine that we want to enable arts. Here is how to do it:

  • find where the foo package located. You can do this by:
    • searching for foo at [1]
    • using the find command:
  find /var/abs -name "foo"
    • using the slocate command:
  slocate foo | grep ^/var/abs

In any case, you'll find that foo is part of extra and multimedia (for example)

  • copy the foo ABS to /var/abs/local/foo
  cp -r /var/abs/extra/multimedia/foo/ /var/abs/local
  cd /var/abs/local/foo
  • modify the PKGBUILD file; we'll add support for arts:
  build() {
    cd $startdir/src/$pkgname-$pkgver
    ./configure --prefix=/usr
    make || return 1
    make prefix=$startdir/pkg/usr install
  }

becomes:

  build() {
    cd $startdir/src/$pkgname-$pkgver
    ./configure --enable-arts --prefix=/usr
    make || return 1
    make prefix=$startdir/pkg/usr install
  }
  • launch makepkg:
  makepkg -c

(The -c option cleans up leftover files from the build.)

  • install the new package using one of the following commands (-A for install [deprecated method], -U to upgrade or install package):
  pacman -A foo-*.pkg.tar.gz
  pacman -U foo-*.pkg.tar.gz

Compiler Flags and Customizing makepkg

The configuration file for makepkg is /etc/makepkg.conf. Here you can set environment variables for gcc and make, as well as some for makepkg itself. The following is an example of /etc/makepkg.conf.

#
# /etc/makepkg.conf
#

#########################################################################
# SOURCE ACQUISITION
#########################################################################
#
#-- The FTP/HTTP download utility that makepkg should use to acquire sources
FTPAGENT="/usr/bin/wget --continue --passive-ftp --tries=3 --waitretry=3 --no-check-certificate"
#FTPAGENT="/usr/bin/snarf"
#FTPAGENT="/usr/bin/lftpget -c"

#########################################################################
# ARCHITECTURE, COMPILE FLAGS
#########################################################################
#
CARCH="i686"
CHOST="i686-pc-linux-gnu"

#-- Exclusive: will only run on i686
# -mtune builds exclusively for an architecture
# -mcpu optimizes for an architecture, but builds for the whole processor family
CFLAGS="-march=i686 -O2 -pipe"
CXXFLAGS="-march=i686 -O2 -pipe"
#-- Make Flags: change this for DistCC/SMP systems
MAKEFLAGS="-j2"

#########################################################################
# BUILD ENVIRONMENT
#########################################################################
#
# Defaults: BUILDENV=(!fakeroot !distcc color !ccache)
#
#-- fakeroot: Allow building packages as a non-root user
#-- distcc:   Use the Distributed C/C++/ObjC compiler
#-- color:    Colorize output messages
#-- ccache:   Use ccache to cache compilation
#
BUILDENV=(fakeroot !distcc color !ccache)
#
#-- If using DistCC, your MAKEFLAGS will also need modification. In addition,
#-- specify a space-delimited list of hosts running in the DistCC cluster.
#DISTCC_HOSTS=""

#########################################################################
# GLOBAL PACKAGE OPTIONS
#   These are default values for the options=() settings
#########################################################################
#
# Default: OPTIONS=(strip !docs !libtool emptydirs)
#
#-- strip:     Strip symbols from binaries/libraries
#-- docs:      Save doc and info directories
#-- libtool:   Leave libtool (.la) files in packages
#-- emptydirs: Leave empty directories in packages
#
OPTIONS=(strip !docs libtool emptydirs)

#-- File integrity checks to use. Valid: md5, sha1, sha256, sha384, sha512
INTEGRITY_CHECK=(md5)
#-- Info and doc directories to remove (if option set correctly above)
DOC_DIRS=(usr/{,share/}{info,doc,gtk-doc} opt/gnome/{,share/}{info,doc,gtk-doc})

#########################################################################
# PACKAGE OUTPUT
#########################################################################
#
# Default: put built package and cached source in build directory
#
#-- Destination: specify a fixed directory where all packages will be placed
PKGDEST=/home/packages
#-- Source cache: specify a fixed directory where source files will be cached
SRCDEST=/home/sources
#-- Packager: name/email of the person or organization building packages
PACKAGER="John Doe <john@doe.com>"

# vim: set ft=sh ts=2 sw=2 et:

A word of caution: Users should be sure of any changes they may make to the variables CFLAGS, CXXFLAGS, and MAKEFLAGS, as they can cause packages to be unstable or impossible to compile. Also, the average Arch Linux user will not need to change the values for CARCH, CHOST, and USE_FAKEROOT.

References for gcc and make flags

More ABS info