PKGBUILD(5)                     Manualul Pacman                    PKGBUILD(5)

NUME
       PKGBUILD - fi<?>ier de descriere a construc<?>iei pachetului

SINOPSIS
       PKGBUILD

DESCRIERE
       Aceasta pagina de manual descrie regulile generale despre PKGBUILD.
       Odata ce un PKGBUILD este scris, pachetul real este construit utilizand
       makepkg <?>i instalat cu pacman.

           Nota

           Un exemplu de PKGBUILD, util pentru referin<?>a, este localizat in
           /usr/share/pacman impreuna cu alte fi<?>iere de exemplu, cum ar fi
           un script de instalare. Pute<?>i copia<?>i fi<?>ierul
           PKGBUILD.proto furnizat intr-un nou director de creare a pachetului
           <?>i sa face<?>i personalizari in func<?>ie de nevoile dvs.

OP<?>IUNI <?>I DIRECTIVE
       Urmatoarea este o lista de op<?>iuni <?>i directive standard
       disponibile pentru a fi utilizate intr-un PKGBUILD. Toate acestea sunt
       in<?>elese <?>i interpretate de makepkg, iar cele mai multe dintre ele
       vor fi transferate direct in pachetul construit. Campurile obligatorii
       pentru un PKGBUILD minim func<?>ional sunt pkgname, pkgver, pkgrel <?>i
       arch.

       Daca trebuie sa crea<?>i variabile personalizate pentru a le utiliza in
       procesul de construire, se recomanda este recomandat sa prefixa<?>i
       numele acestora cu un caracter _ (liniu<?>a de subliniere). Acest lucru
       va preveni orice posibile ciocniri de nume cu variabilele interne
       makepkg. De exemplu, pentru a stoca versiunea nucleului de baza intr-o
       variabila, utiliza<?>i ceva similar cu $_basekernver.

       pkgname (lista)
           Fie numele pachetului, fie o serie de nume pentru pachete divizate.
           Caracterele valide pentru membrii acestei serii sunt alfanumerice
           <?>i oricare dintre urmatoarele caractere: ,,@ . _ + -". In plus,
           numele nu sunt trebuie sa inceapa cu liniu<?>e de unire sau puncte.

       pkgver
           Versiunea software-ului eliberata de autor (de ex, 2.7.1).
           Variabila nu are voie sa con<?>ina doua puncte (:), bare oblice
           (/), liniu<?>e de unire (-) sau spa<?>ii albe.

           Variabila pkgver poate fi actualizata automat prin furnizarea unei
           func<?>ii pkgver() in PKGBUILD care produce noua versiune a
           pachetului. Aceasta este rulata dupa descarcarea <?>i extragerea
           surselor <?>i dupa rularea func<?>iei prepare() (daca este
           prezenta), astfel incat sa poata utiliza aceste fi<?>iere pentru a
           determina noua valoare a pkgver. Aceasta este foarte utila atunci
           cand este utilizata cu surse din sisteme de control al versiunilor
           (a se vedea mai jos).

       pkgrel
           Valoarea acestei variabile este numarul de versiune specific
           distribu<?>iei. Aceasta permite de<?>inatorilor de pachete sa faca
           actualizari ale fanioanelor de configurare ale pachetului, de
           exemplu. Aceasta este de obicei definita la 1 pentru fiecare noua
           versiune de software din amonte <?>i incrementata pentru
           actualizarile PKGBUILD intermediare. Variabila este un numar intreg
           pozitiv, cu un nivel subversiune op<?>ional specificat prin
           adaugarea unui alt numar intreg pozitiv separat de un punct (adica
           sub forma x.y).

       epoch
           Utilizata pentru a for<?>a pachetul sa fie vazut ca fiind mai nou
           decat orice versiune anterioara cu o epoca mai mica, chiar daca
           numarul versiunii nu ar declan<?>a in mod normal o astfel de
           actualizare. Aceasta valoare trebuie sa fie un numar intreg
           pozitiv; valoarea implicita daca nu este specificata este 0. Acest
           lucru este util atunci cand schema de numerotare a versiunilor unui
           pachet se schimba (sau este alfanumerica), rupand logica normala de
           comparare a versiunilor. Consulta<?>i pacman(8) pentru mai multe
           informa<?>ii despre compararea versiunilor.

       pkgdesc
           Aceasta ar trebui sa fie o scurta descriere a pachetului <?>i a
           func<?>ionalita<?>ii sale. Incerca<?>i sa limita<?>i descrierea la
           un singur rand de text <?>i sa nu folosi<?>i numele pachetului.

       url
           Acest camp con<?>ine o adresa URL care este asociata cu software-ul
           care este impachetat. Aceasta este de obicei adresa sitului web al
           proiectului.

       license (camp)
           Acest camp specifica licen<?>a(ele) care se aplica pachetului. Daca
           se aplica mai multe licen<?>e, lista<?>i-le pe toate:
           license=('GPL' 'FDL').

       install
           Specifica un script special de instalare care urmeaza sa fie inclus
           in pachet. Acest fi<?>ier trebuie sa se afle in acela<?>i director
           ca PKGBUILD <?>i va fi copiat in pachet de catre makepkg. Nu este
           necesar sa fie inclus in lista sursa (de exemplu,
           install=$pkgname.install).

       changelog
           Specifica un fi<?>ier changelog care urmeaza sa fie inclus in
           pachet. Fi<?>ierul changelog trebuie sa se incheie cu o singura
           linie noua. Acest fi<?>ier trebuie sa se afle in acela<?>i director
           ca PKGBUILD <?>i va fi copiat in pachet de catre makepkg. Nu este
           necesar sa fie inclus in lista sursa (de exemplu,
           changelog=$pkgname.changelog).

       source (lista)
           O serie de fi<?>iere sursa necesare pentru construirea pachetului.
           Fi<?>ierele sursa trebuie fie sa se afle in acela<?>i director ca
           PKGBUILD, fie sa fie o adresa URL complet calificata pe care
           makepkg o poate utiliza pentru a descarca fi<?>ierul. Pentru a
           simplifica intre<?>inerea PKGBUILD-urilor, utiliza<?>i variabilele
           $pkgname <?>i $pkgver atunci cand specifica<?>i loca<?>ia de
           descarcare, daca este posibil. Fi<?>ierele comprimate vor fi
           extrase automat daca nu sunt gasite in lista noextract descrisa mai
           jos.

           Surse suplimentare specifice arhitecturii pot fi adaugate prin
           adaugarea unui caracter de subliniere <?>i a numelui arhitecturii,
           de exemplu, source_x86_64=(). Trebuie sa existe o matrice de
           integritate corespunzatoare cu sume de control, de exemplu
           cksums_x86_64=().

           De asemenea, este posibil sa se schimbe numele fi<?>ierului
           descarcat, ceea ce este util in cazul adreselor URL ciudate <?>i
           pentru gestionarea mai multor fi<?>iere sursa cu acela<?>i nume.
           Sintaxa este: source=('filename::url').

           makepkg suporta, de asemenea, construirea versiunilor de dezvoltare
           ale pachetelor folosind surse descarcate din sisteme de control al
           versiunilor (VCS). Pentru mai multe informa<?>ii, consulta<?>i
           sec<?>iunea <<Utilizarea surselor VCS>>, de mai jos.

           Fi<?>ierele din lista de surse cu extensiile .sig, .sign sau .asc
           sunt recunoscute de makepkg ca semnaturi PGP <?>i vor fi utilizate
           automat pentru a verifica integritatea fi<?>ierului sursa
           corespunzator.

       validpgpkeys (lista)
           O lista de amprente digitale PGP. Daca aceasta lista nu este goala,
           makepkg va accepta numai semnaturi de la cheile enumerate aici <?>i
           va ignora valorile de incredere din breloc. Daca fi<?>ierul sursa a
           fost semnat cu o subcheie, makepkg va utiliza in continuare cheia
           principala pentru compara<?>ie.

           Sunt acceptate numai amprentele digitale complete. Acestea trebuie
           sa fie scrise cu majuscule <?>i nu trebuie sa con<?>ina caractere
           de spa<?>iu alb.

       noextract (lista)
           Un <?>ir de nume de fi<?>iere corespunzatoare celor din <?>irul
           sursa. Fi<?>ierele enumerate aici nu vor fi extrase impreuna cu
           restul fi<?>ierelor sursa. Acest lucru este util pentru pachetele
           care utilizeaza direct date comprimate.

       cksums (camp)
           Aceasta linie con<?>ine sumele de control CRC (cksums) pentru
           fiecare fi<?>ier sursa specificat in linia sursa (in aceea<?>i
           ordine). makepkg va utiliza aceasta linie pentru a verifica
           integritatea fi<?>ierelor sursa in timpul compilarilor ulterioare.
           Daca SKIP este pus in aceasta linie in locul unei sume de control,
           verificarea integrita<?>ii pentru fi<?>ierul sursa respectiv va fi
           omisa. Pentru a genera u<?>or sume de control (cksums), executa<?>i
           <<makepkg -g >> PKGBUILD>>. Daca dori<?>i, muta<?>i linia sumelor
           de control intr-o loca<?>ie corespunzatoare. Re<?>ine<?>i ca sumele
           de control generate de <<makepkg -g>> trebuie verificate folosind
           valorile sumelor de control furnizate de dezvoltatorul de software.

       md5sums, sha1sums, sha224sums, sha256sums, sha384sums, sha512sums,
       b2sums (camp)
           Verificari alternative de integritate acceptate de makepkg; toate
           acestea se comporta similar cu op<?>iunea cksums descrisa mai sus.
           Pentru a permite utilizarea <?>i generarea acestor sume de control,
           asigura<?>i-va ca configura<?>i op<?>iunea INTEGRITY_CHECK in
           makepkg.conf(5).

       groups (lista)
           O lista de nume simbolice care reprezinta grupuri de pachete,
           permi<?>andu-va sa instala<?>i mai multe pachete prin solicitarea
           unui singur obiectiv. De exemplu, se pot instala toate pachetele
           KDE prin instalarea grupului kde.

       arch (lista)
           Define<?>te pe ce arhitecturi este disponibil pachetul dat (de
           exemplu, arch=('i686' 'x86_64')). Pachetele care nu con<?>in
           fi<?>iere specifice arhitecturii trebuie sa utilizeze arch=('any').
           Caracterele valide pentru membrii acestei serii sunt alfanumerice
           <?>i ,,_".

       backup (lista)
           O lista de nume de fi<?>iere, fara bare oblice la inceputul
           acestora, care ar trebui sa fie salvate daca pachetul este eliminat
           sau actualizat. Acest lucru este frecvent utilizat pentru pachetele
           care plaseaza fi<?>iere de configurare in /etc. Consulta<?>i
           GESTIONAREA FI<?>IERELOR DE CONFIGURARE in pacman(8) pentru mai
           multe informa<?>ii.

       depends (lista)
           O lista de pachete de care depinde acest pachet pentru a rula.
           Intrarile in aceasta lista trebuie sa fie incadrate cu ghilimele
           simple <?>i sa con<?>ina cel pu<?>in numele pachetului. De
           asemenea, intrarile pot include o cerin<?>a de versiune de forma
           nume<>versiune, unde <> este una dintre cele cinci compara<?>ii: >=
           (mai mare sau egal cu), <= (mai mic sau egal cu), = (egal cu), >
           (mai mare decat) sau < (mai mic decat).

           Daca numele dependen<?>ei pare a fi o biblioteca (se termina cu
           .so), makepkg va incerca sa gaseasca un binar care depinde de
           biblioteca in pachetul construit <?>i va adauga versiunea necesara
           pentru binar. Adaugarea versiunii de catre dvs. in<?>iva,
           dezactiveaza detectarea automata.

           Pot fi adaugate dependen<?>e suplimentare specifice arhitecturii
           prin adaugarea unui semn de subliniere <?>i a numelui arhitecturii,
           de exemplu, depends_x86_64=().

       makedepends (lista)
           O lista de pachete de care depinde acest pachet pentru a fi
           construit, dar care nu sunt necesare la momentul rularii. Pachetele
           din aceasta lista urmeaza acela<?>i format ca <?>i pachetele
           dependente.

           Se pot adauga dependen<?>e de construire (makedepends) suplimentare
           specifice arhitecturii prin adaugarea unei liniu<?>e de subliniere
           <?>i a numelui arhitecturii, de exemplu, makedepends_x86_64=().

       checkdepends (lista)
           O lista de pachete de care depinde acest pachet pentru a rula suita
           sa de teste, dar care nu sunt necesare in timpul rularii. Pachetele
           din aceasta lista urmeaza acela<?>i format ca <?>i ,,depends".
           Aceste dependen<?>e sunt luate in considerare numai atunci cand
           func<?>ia check() este prezenta <?>i trebuie sa fie executata de
           makepkg.

           Se pot adauga dependen<?>e de verificare ,,checkdepends"
           suplimentare specifice arhitecturii prin adaugarea unui semn de
           subliniere <?>i a numelui arhitecturii, de exemplu,
           checkdepends_x86_64=().

       optdepends (camp)
           O serie de pachete (<?>i explica<?>iile aferente) care nu sunt
           esen<?>iale pentru func<?>ionalitatea de baza, dar pot fi necesare
           pentru a utiliza pe deplin con<?>inutul acestui pachet.
           Dependen<?>ele op<?>ionale ,,optdepends" sunt in prezent doar in
           scopuri informative <?>i nu sunt utilizate de pacman in timpul
           rezolvarii dependen<?>elor. Pachetele din aceasta lista respecta
           acela<?>i format ca <?>i pachetele dependente ,,depends", cu o
           descriere op<?>ionala adaugata. Formatul pentru specificarea
           descrierilor optdepends este:

               optdepends=('python: for library bindings')

           Alte dependen<?>e op<?>ionale ,,optdepends" specifice arhitecturii
           pot fi adaugate prin adaugarea unui semn de subliniere <?>i a
           numelui arhitecturii, de exemplu, optdepends_x86_64=().

       conflicts (camp)
           O serie de pachete care vor intra in conflict cu acest pachet
           (adica nu pot fi instalate toate in acela<?>i timp). Aceasta
           directiva urmeaza acela<?>i format ca <?>i ,,depends". Conflictele
           in func<?>ie de versiune sunt acceptate utilizand operatorii
           descri<?>i in ,,depends".

           Alte conflicte ,,conflicts" specifice arhitecturii pot fi adaugate
           prin adaugarea unei liniu<?>e de subliniere <?>i a numelui
           arhitecturii, de exemplu, conflicts_x86_64=().

       provides (camp)
           O serie de ,,dispozi<?>ii virtuale" pe care le ofera acest pachet.
           Acest lucru permite unui pachet sa furnizeze dependen<?>e altele
           decat propriul nume de pachet. De exemplu, pachetul dcron poate
           furniza cron, ceea ce permite pachetelor sa depinda de cron mai
           degraba decat de dcron OR fcron.

           De asemenea, sunt posibile dispozi<?>ii in versiune, in formatul
           nume=versiune. De exemplu, dcron poate furniza cron=2.0 pentru a
           satisface dependen<?>a cron>=2.0 a altor pachete. Dispozi<?>iile
           care implica operatorii > <?>i < nu sunt valabile, deoarece pot fi
           furnizate numai versiuni specifice ale unui pachet.

           Daca numele dispozi<?>iei pare a fi o biblioteca (se termina cu
           .so), makepkg va incerca sa gaseasca biblioteca in pachetul
           construit <?>i va adauga versiunea corecta. Adaugand versiunea dvs.
           in<?>iva, dezactiva<?>i detectarea automata.

           Se pot adauga furnizari ,,provides"  suplimentare specifice
           arhitecturii prin adaugarea unei liniu<?>e de subliniere <?>i a
           numelui arhitecturii, de exemplu, provides_x86_64=().

       replaces (lista)
           O lista de pachete pe care acest pachet ar trebui sa le
           inlocuiasca. Aceasta poate fi utilizata pentru a gestiona pachetele
           redenumite/combinate. De exemplu, daca pachetul j2re este redenumit
           in jre, aceasta directiva permite actualizarilor viitoare sa
           continue conform a<?>teptarilor, chiar daca pachetul a fost mutat.
           Inlocuirile pe versiuni sunt acceptate utilizand operatorii
           descri<?>i in ,,depends".

           Sysupgrade este in prezent singura opera<?>ie pacman care
           utilizeaza acest camp. O sincronizare sau o actualizare normala nu
           va utiliza valoarea acestuia.

           Se pot adauga inlocuiri ,,replaces"  suplimentare specifice
           arhitecturii prin adaugarea unei liniu<?>e de subliniere <?>i a
           numelui arhitecturii, de exemplu, replaces_x86_64=().

       options (serie de op<?>iuni)
           Aceasta lista va permite sa suprascrie<?>i unele dintre
           comportamentele implicite ale makepkg atunci cand construi<?>i
           pachete. Pentru a defini o op<?>iune, trebuie doar sa include<?>i
           numele op<?>iunii in lista de op<?>iuni. Pentru a inversa
           comportamentul implicit, plasa<?>i un ,,!" in fa<?>a op<?>iunii.
           Specifica<?>i numai op<?>iunile pe care dori<?>i in mod specific sa
           le inlocui<?>i, restul vor fi preluate din makepkg.conf(5). NOTA:
           force este o op<?>iune eliminata acum in favoarea variabilei de
           nivel superior epoch.

           strip
               Indeparteaza simbolurile din binare <?>i biblioteci. Daca
               folosi<?>i frecvent un depanator pentru programe sau
               biblioteci, poate fi util sa dezactiva<?>i aceasta op<?>iune.

           docs
               Salva<?>i directoarele doc. Daca dori<?>i sa <?>terge<?>i
               directoarele doc, specifica<?>i !docs in lista.

           libtool
               Lasa fi<?>ierele libtool (.la) in pachete. Specifica<?>i
               !libtool pentru a le elimina.

           staticlibs
               Lasa fi<?>ierele de biblioteca statica (.a) in pachete.
               Specifica<?>i !staticlibs pentru a le elimina (daca au o
               contraparte partajata).

           emptydirs
               Lasa directoare goale in pachete.

           zipman
               Comprima paginile man <?>i info cu gzip.

           ccache
               Permite utilizarea ccache in timpul build(). Mai utila in forma
               sa negativa !ccache cu pachete selectate care au probleme de
               compilare cu ccache.

           distcc
               Permite utilizarea distcc in timpul build() Mai utila in forma
               sa negativa !distcc cu pachete selectate care au probleme de
               compilare cu distcc.

           buildflags
               Permite utilizarea de fanioane de  compilare ,,buildflags"
               specificate de utilizator (CPPFLAGS, CFLAGS, CXXFLAGS, LDFLAGS)
               in timpul build(), dupa cum se specifica in makepkg.conf(5).
               Mai utila in forma sa negativa !buildflags cu pachete selectate
               care au probleme de compilare cu ,,buildflags" personalizate.

           makeflags
               Permite utilizarea de fanioane de construc<?>ie ,,makeflags"
               specificate de utilizatori in timpul build(), dupa cum se
               specifica in makepkg.conf(5). Mai utila in forma sa negativa
               !makeflags cu pachete selectate care au probleme de compilare
               cu ,,makeflags" personalizate, cum ar fi -j2 (sau superior).

           debug
               Adauga fanioanele de depanare specificate de utilizator
               (DEBUG_CFLAGS, DEBUG_CXXFLAGS) la contrapartida lor
               ,,buildflags", dupa cum se specifica in makepkg.conf(5). Atunci
               cand este utilizata in combina<?>ie cu op<?>iunea ,,strip",
               este creat un pachet separat care con<?>ine simbolurile de
               depanare.

           lto
               Activeaza construirea de pachete folosind optimizarea timpului
               de legatura. Adauga -flto la CFLAGS <?>i CXXFLAGS.

FUNC<?>II DE IMPACHETARE
       In plus fa<?>a de directivele de mai sus, PKGBUILD-urile necesita un
       set de func<?>ii care ofera instruc<?>iuni pentru construirea <?>i
       instalarea pachetului. PKGBUILD trebuie sa con<?>ina cel pu<?>in o
       func<?>ie package() care instaleaza toate fi<?>ierele pachetului in
       directorul de impachetare, func<?>iile op<?>ionale prepare(), build()
       <?>i check() fiind utilizate pentru a crea aceste fi<?>iere din sursa.

       Aceasta este direct furnizata <?>i executata de makepkg, astfel incat
       tot ceea ce Bash sau sistemul are disponibil este disponibil pentru
       utilizare aici. Asigura<?>i-va ca orice comenzi exotice utilizate sunt
       acoperite de lista ,,makedepends".

       Daca crea<?>i variabile proprii in oricare dintre aceste func<?>ii, se
       recomanda utilizarea cuvantului-cheie local Bash pentru a defini
       variabila in interiorul func<?>iei.

       Func<?>ia package()
           Func<?>ia package() este utilizata pentru a instala fi<?>iere in
           directorul care va deveni directorul radacina al pachetului
           construit <?>i este executata dupa toate func<?>iile op<?>ionale
           enumerate mai jos. Etapa de impachetare este executata utilizand
           fakeroot pentru a asigura permisiunile corecte ale fi<?>ierelor in
           pachetul rezultat. Toate celelalte func<?>ii vor fi executate ca
           utilizator care apeleaza makepkg. Aceasta func<?>ie este executata
           in interiorul $srcdir.

       Func<?>ia verify()
           O func<?>ie op<?>ionala verify() poate fi specificata pentru a
           implementa o autentificare arbitrara a sursei. Func<?>ia trebuie sa
           returneze un cod de ie<?>ire diferit de zero atunci cand
           verificarea e<?>ueaza. Aceasta func<?>ie este executata inainte de
           extragerea surselor. Aceasta func<?>ie este executata in interiorul
           $startdir.

       Func<?>ia prepare()
           Se poate specifica o func<?>ie op<?>ionala prepare() in care se
           efectueaza opera<?>iuni de pregatire a surselor pentru compilare,
           cum ar fi aplicarea de plasturi (corec<?>ii). Aceasta func<?>ie
           este executata dupa extragerea sursei <?>i inainte de func<?>ia
           build(). Func<?>ia prepare() este omisa atunci cand extragerea
           sursei este omisa. Aceasta func<?>ie este executata in interiorul
           $srcdir.

       Func<?>ia build()
           Func<?>ia op<?>ionala build() este utilizata pentru a compila
           <?>i/sau ajusta fi<?>ierele sursa in vederea instalarii de catre
           func<?>ia package(). Aceasta func<?>ie este executata in interiorul
           $srcdir.

       Func<?>ia check()
           Se poate specifica o func<?>ie op<?>ionala check() in care poate fi
           rulata suita de teste a unui pachet. Aceasta func<?>ie este
           executata intre func<?>iile build() <?>i package(). Asigura<?>i-va
           ca orice comenzi ,,exotice" utilizate sunt acoperite de lista
           ,,checkdepends". Aceasta func<?>ie este executata in interiorul
           $srcdir.

       Toate variabilele de mai sus, cum ar fi $pkgname <?>i $pkgver, sunt
       disponibile pentru utilizare in func<?>iile de impachetare. In plus,
       makepkg define<?>te urmatoarele variabile:

       srcdir
           Aceasta con<?>ine directorul in care makepkg extrage sau copiaza
           toate fi<?>ierele sursa.

       pkgdir
           Aceasta con<?>ine directorul in care makepkg impacheteaza pachetul
           instalat. Acest director va deveni directorul radacina al
           pachetului construit. Aceasta variabila trebuie utilizata numai in
           func<?>ia package().

       startdir
           Aceasta con<?>ine ruta absoluta catre directorul in care se afla
           PKGBUILD, care este de obicei rezultatul $(pwd) atunci cand makepkg
           este ini<?>iat. Utilizarea acestei variabile este depreciata <?>i
           puternic descurajata.

SCINDAREA PACHETULUI
       makepkg permite construirea mai multor pachete dintr-un singur
       PKGBUILD. Acest lucru se realizeaza prin atribuirea unei liste de nume
       de pachete directivei pkgname. Fiecare pachet scindat utilizeaza o
       func<?>ie de impachetare corespunzatoare cu numele package_foo(), unde
       foo este numele pachetului scindat.

       Toate op<?>iunile <?>i directivele pentru pachetele scindate au
       implicit valorile globale indicate in PKGBUILD. Cu toate acestea,
       urmatoarele pot fi suprascrise in cadrul func<?>iei de ambalare a
       fiecarui pachet scindat: pkgdesc, arch, url, license, groups, depends,
       optdepends, provides, conflicts, replaces, backup, options, install
       <?>i changelog.

       Re<?>ine<?>i ca makepkg nu ia in considerare dependen<?>ele pachetelor
       scindate atunci cand verifica daca dependen<?>ele sunt instalate
       inainte de construirea pachetului <?>i cu ,,--syncdeps". Toate
       pachetele necesare pentru realizarea pachetului trebuie sa fie
       specificate in listele globale depends <?>i makedepends.

       O directiva globala op<?>ionala este disponibila la construirea unui
       pachet scindat:

       pkgbase
           Numele utilizat pentru a face referire la grupul de pachete in
           rezultatul makepkg <?>i in denumirea arhivelor-tar numai din
           codurile-sursa. Daca nu este specificat, se utilizeaza primul
           element din lista variabilei ,,pkgname". Caracterele valide pentru
           aceasta variabila sunt alfanumerice <?>i oricare dintre urmatoarele
           caractere: ,,@ . _ + -". In plus, nu este permis ca variabila sa
           inceapa cu cratime sau puncte.

SCRIPT DE INSTALARE/ACTUALIZARE/ELIMINARE
       Pacman are capacitatea de a stoca <?>i executa un script specific
       pachetului atunci cand instaleaza, elimina sau actualizeaza un pachet.
       Acest lucru permite unui pachet sa se configureze singur dupa instalare
       <?>i sa efectueze o ac<?>iune opusa la eliminare.

       Momentul exact in care scriptul este rulat variaza in func<?>ie de
       fiecare opera<?>ie <?>i ar trebui sa fie auto-explicativ. Re<?>ine<?>i
       ca, in timpul unei opera<?>ii de actualizare, nu va fi apelata niciuna
       dintre func<?>iile de instalare sau eliminare.

       Scripturilor le sunt transmise unul sau doua ,,<?>iruri de versiuni
       complete", unde un <?>ir de versiune completa este fie pkgver-pkgrel,
       fie epoch:pkgver-pkgrel, daca ,,epoch" este diferita de zero.

       pre_install
           Se executa chiar inainte de extragerea fi<?>ierelor. I se paseaza
           un argument: <?>irul versiunii complete a noului pachet.

       post_install
           Se executa imediat dupa extragerea fi<?>ierelor. I se paseaza un
           argument: <?>irul versiunii complete a noului pachet.

       pre_upgrade
           Se executa chiar inainte de extragerea fi<?>ierelor. Ii sunt pasate
           doua argumente in aceasta ordine: <?>irul versiunii complete a
           pachetului nou, <?>irul versiunii complete a pachetului vechi.

       post_upgrade
           Se executa dupa ce fi<?>ierele sunt extrase. Sunt pasate doua
           argumente in aceasta ordine: <?>irul versiunii complete a
           pachetului nou, <?>irul versiunii complete a pachetului vechi.

       pre_remove
           Se executa chiar inainte de eliminarea fi<?>ierelor. I se paseaza
           un argument: <?>irul versiunii complete a vechiului pachet.

       post_remove
           Se executa imediat dupa eliminarea fi<?>ierelor. I se trece un
           argument: <?>irul versiunii complete a pachetului vechi.

       Pentru a utiliza aceasta caracteristica, crea<?>i un fi<?>ier precum
       pkgname.install <?>i pune<?>i-l in acela<?>i director cu scriptul
       PKGBUILD. Apoi utiliza<?>i directiva <<install>>:

           install=nume-pachet.install

       Scriptul de instalare nu trebuie sa fie specificat in lista de surse.
       Un fi<?>ier de instalare <?>ablon este disponibil in /usr/share/pacman
       ca proto.install pentru referin<?>a cu toate func<?>iile disponibile
       definite.

UTILIZAREA SURSELOR VCS
       Construirea unei versiuni de dezvoltare a unui pachet folosind surse
       dintr-un sistem de control al versiunilor (VCS) este activata prin
       specificarea sursei de forma:

           source=('director::url#fragment?interogare')

       In prezent, makepkg accepta sistemele de control al versiunilor Bazaar,
       Git, Subversion, Fossil <?>i Mercurial. Pentru alte sisteme de control
       al versiunilor, clonarea manuala a depozitelor din amonte trebuie
       efectuata in func<?>ia prepare().

       Unele surse VCS, cum ar fi Git, accepta fixarea ,,checkout-ului"
       printr-o suma de control a con<?>inutului sau, utilizand
       func<?>ionalita<?>i de export deterministe, cum ar fi ,,git archive".

       Adresa URL a sursei este impar<?>ita in patru componente:

       director
           (op<?>ional) Specifica un nume de director alternativ in care
           makepkg sa descarce sursa VCS.

       url
           Adresa URL a depozitului VCS. Aceasta trebuie sa includa VCS in
           protocolul URL pentru ca makepkg sa o recunoasca ca sursa VCS. Daca
           protocolul nu include numele VCS, acesta poate fi adaugat prin
           prefixarea adresei URL cu vcs+. De exemplu, utilizarea unui depozit
           Git prin HTTPS ar avea o adresa URL a sursei sub forma:
           git+https://....

       fragment
           (op<?>ional) Permite specificarea unui numar de revizuire sau a
           unei ramuri pentru ca makepkg sa faca ,,checkout" din VCS. Un
           fragment are forma tip=valoare; de exemplu, pentru a extrage o
           anumita revizuire, linia sursa ar fi source=(url#revision=123).
           Tipurile disponibile depind de VCS-ul utilizat:

           bzr
               revision (a se vedea <<bzr help revisionspec>> pentru detalii)

           fossil
               branch, commit, tag

           git
               branch, commit, tag

           hg
               branch, revision, tag

           svn
               revision

       query
           (op<?>ional) Permite specificarea daca o verificare VCS ar trebui
           sa fie verificata pentru revizuirile semnate PGP. Linia sursa
           trebuie sa aiba formatul source=(url#fragment?signed) sau
           source=(url?signed#fragment). In prezent este acceptata doar de
           catre Git.

EXEMPLU
       Ceea ce urmeaza, este un exemplu de PKGBUILD pentru pachetul patch.
       Pentru mai multe exemple, consulta<?>i fi<?>ierele de construire ale
       pachetelor din distribu<?>ia dumneavoastra.

           # Maintainer: Joe User <joe.user@example.com>

           pkgname=patch
           pkgver=2.7.1
           pkgrel=1
           pkgdesc="A utility to apply patch files to original sources"
           arch=('i686' 'x86_64')
           url="https://www.gnu.org/software/patch/patch.html"
           license=('GPL')
           groups=('base-devel')
           depends=('glibc')
           makedepends=('ed')
           optdepends=('ed: for "patch -e" functionality')
           source=("ftp://ftp.gnu.org/gnu/$pkgname/$pkgname-$pkgver.tar.xz"{,.sig})
           sha256sums=('9124ba46db0abd873d0995c2ca880e81252676bb6c03e0a37dfc5f608a9b0ceb'
                       'SKIP')

           build() {
                   cd "$srcdir/$pkgname-$pkgver"
                   ./configure --prefix=/usr
                   make
           }

           package() {
                   cd "$srcdir/$pkgname-$pkgver"
                   make DESTDIR="$pkgdir/" install
           }

CONSULTA<?>I <?>I
       makepkg(8), pacman(8), makepkg.conf(5)

       Consulta<?>i situl web pacman la https://archlinux.org/pacman/ pentru
       informa<?>ii actuale despre <<pacman>> <?>i instrumentele sale conexe.

ERORI
       Hibe? Probabil ca glumi<?>i; nu exista nicio hiba in acest software&.
       Dar daca se intampla sa fie ceva gre<?>it, depune<?>i o cerere de
       rezolvare a problemei cu cat mai multe detalii posibile la:
       https://gitlab.archlinux.org/pacman/pacman/-/issues.

AUTORI
       Responsabilii actuali:

       o   Allan McRae <allan@archlinux.org>

       o   Andrew Gregory <andrew.gregory.8@gmail.com>

       o   Morgan Adamiec <morganamilo@archlinux.org>

       Contribuitori importan<?>i din trecut:

       o   Judd Vinet <jvinet@zeroflux.org>

       o   Aurelien Foret <aurelien@archlinux.org>

       o   Aaron Griffin <aaron@archlinux.org>

       o   Dan McGee <dan@archlinux.org>

       o   Xavier Chantry <shiningxc@gmail.com>

       o   Nagy Gabor <ngaba@bibl.u-szeged.hu>

       o   Dave Reisner <dreisner@archlinux.org>

       o   Eli Schwartz <eschwartz@archlinux.org>

       Pentru contribuitori suplimentari, folosi<?>i <<git shortlog -s>> in
       depozitul .git pacman.

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pacman 7.0.0                   27 noiembrie 2024                   PKGBUILD(5)