Slacky.eu - Pagine più recenti [it]

Dual Boot UEFI: Slackware 14.0 e Windows 7

Eberoth — Tue, 04 Dec 2012 21:45:20 GMT

Eberoth: Creata pagina con '==Introduzione== Lo scopo di questa guida è quello di descrivere una procedura che permetta di installare Slackware 14.0 su un computer con OS Windows 7 installato su partiz...'

==Introduzione==

Lo scopo di questa guida è quello di descrivere una procedura che permetta di installare Slackware 14.0 su un computer con OS Windows 7 installato su partizioni GPT e UEFI Boot.

In rete si trovano altre guide di questo tipo, ma la maggior parte richiede di ricreare l'immagine di boot del kernerl di installazione usando una versione diversa dalla 3.2.29 di default; cosa che presume l'accesso ad un'altro computer con GNU/Linux. Qui invece vedremo come ovviare alle mancanze del kernerl di default ed ottenere comunque un sistema avviabile.

===Disclaimer===

Questo articolo è basato sulla mia esperienza personale e non è detto che funzioni in tutti i casi; se non sapete cosa vogliano dire le parole MBR, UEFI, Bootloader e/o non conoscete la procedura per compilare un kernel personalizzato, vi invito a leggere le relative documentazioni prima di seguire questa guida.

: Inoltre, vi consiglio di fare un backup dei dati personali (e di creare i DVD di ripristino di Windows7) prima di fare una qualunque delle operazioni qui riportate: la perdita di tali dati non è da escludere.

:: Questa guida coprirà solo la procedura per Slackware64, in quanto tutti i sistemi UEFI sono ormai equipaggiati con processori con architettura a 64bit.

==Preparare gli strumenti==

===Cosa serve:===

* L'immagine .iso del DVD di installazione di Slackware 14.0 o una copia locale del relativo albero del repository;
* I sorgenti di una versione del Kernel Linux superiore alla 3.3;
* Un pendrive USB di dimensioni adeguate a contenere la directory Slackware64 del DVD di installazione ed un'ulteriore partizione di 200MB;
* [http://elilo.sourceforge.net/ eLILO];
* [http://sourceforge.net/projects/refind/ rEFInd];
* Un software capace di creare una tabella delle partizioni di tipo GPT sulla pendrive e di creare partizioni di tipo vfat (FAT32). (Io ho usato gparted da una live che avevo sottomano, ma va bene anche lo strumento "Gestione Disco" di Windows)

===Preparare il supporto per l'installazione===

Purtroppo, non è possibile installare Slackware direttamente dal DVD, perché finiremmo con l'ottenere un sistema non avviabile, ammesso che il nostro BIOS UEFI riconosca ed avvii l'immagine del kernerl d'installazione in legacy mode (MBR).

Cosa fare dunque?

Bisogna formattare una pendrive USB, usando un partition table di tipo GPT, creando due partizioni vfat: una di 200MB ed un'altra che occupa il restante spazio libero.

Nella prima partizione, che da qui in poi chiamerò sdb1 per comodità, creamo l'albero delle directory /EFI/BOOT/ che ci servirà per come "sede" per il nostro bootloader.

Una volta scaricato [http://downloads.sourceforge.net/project/elilo/elilo/elilo-3.14/elilo-3.14-all.tar.gz elilo-3.14-all.tar.gz] estraiamo il contenuto dell'archivio e copiamo in /EFI/BOOT/ il file elilo-3.14-x86_64.efi col nome di BOOTX64.EFI.

Nella stessa directory creeremo il file elilo.conf :
prompt
timeout=50
default=install

image=bzImage
label=install
initrd=initrd.img
append="load_ramdisk=1 prompt_ramdisk=0 rw printk.time=0 SLACK_KERNEL=huge.s"

Inoltre, apriamo l'immagine del DVD di installazione

#mount -o loop slackware64-14.0.iso /mnt/cdrom

E copiamo in /EFI/BOOT/ i file:
/mnt/cdrom/kernels/huge.s/bzImage
/mnt/cdrom/isolinux/initrd.img

Per comodità, scarichiamo anche [http://downloads.sourceforge.net/project/refind/0.4.7/refind-bin-0.4.7.zip?r=http%3A%2F%2Fsourceforge.net%2Fprojects%2Frefind%2F&ts=1354651556&use_mirror=netcologne refind-bin-0.4.7.zip] e copiamo il contenuto dell'archivio in /BOOT/.

Nella seconda partizione, sdb2, copiamo la directory

/mnt/cdrom/Slackware64

e l'archivio con i sorgenti del kernel.

==Installazione==

A questo punto abbiamo tutto quello che ci serve per installare Slackware, riavviamo quindi il computer con la pendrive inserita.

All'avvio dell'ambiente di installazione, facciamo il login come root e prepariamo le nostre partizioni usando gdisk o gfdisk.

Per i fini di questo esempio, supporremo che l'hdd sia così partizionato:

Number Size Type Name
1 200.0 MiB vfat EFI system partition
2 128.0 MiB ? Microsoft reserved part (Windows Bootloader)
3 120.0 GiB NTFS Basic data partition (Windows System)
4 2.0 GiB Linux/Swap swap
5 80.0 GiB Linux /
6 729.0 GiB Linux /home

Sono tutte partizioni principali: GPT permette di superare il limite di 4 partizioni imposto da MBR.

Procediamo quindi con l'installare il sistema normalmente in sda5, e montiamo, per motivi che saranno chiari più tardi, la partizione ESP sda1 in /boot/efi .

Saltiamo la configurazione di LILO in quanto non lo useremo e complicherebbe le cose.

Al termine della procedura di condigurazione, usciamo dal setup ma non riavviamo il computer: abbiamo ancora qualche passo per rendere avviabile la nostra installazione.

==Post Installazione==

Facciamo un chroot nel sistema appena installato

#chroot /mnt

e montiamo nuovamente la partizione della pendrive contenente elilo

#mount /dev/sdb1 /mnt/tmp

a questo punto, dobbiamo copiare il kernel appena installato in una sottodirectory della ESP assieme con il .efi di elilo ed un apposito file elilo .conf:

# mkdir /boot/efi.d/EFI/Linux/
# cp /boot/vmlinuz-huge-3.2.29 /boot/efi/EFI/Linux
# cp /mnt/tmp/EFI/BOOT/BOOTX64.EFI /boot/efi/EFI/Linux

Volendo, possiamo anche usare l'immagine generic e creando un apposito initrd.gz da copiare anch'esso nella directory precedente:

# cp /boot/vmlinuz-generic-3.2.29 /boot/efi/EFI/Linux
# cp /boot/initrd.gz /boot/efi/EFI/Linux

a questo punto non ci resta che creare un elilo.conf adeguato nella stessa directory. Le opzioni di configurazione di eLILO sono molto simili a quelle di LILO, quindi non dovrebbe essere difficile da gestire, in ogni caso, questo è un elilo.conf funzionante (il mio):

prompt
timeout=50
default=generic

image=vmlinuz-generic-3.2.29
label=generic
initrd=initrd.gz
read-only
root=/dev/sda5

image=vmlinug-huge-3.2.29
label=huge
read-only
root=/dev/sda5

A questo punto avremmo finito. Non occorre lanciare altri comandi: elilo non deve essere aggiornato come lilo ad ogni modifica, basta copiare immagine del kernel e initrd nella direcotry, editare il file elilo.conf e riavviare.

Facile no?

Invece no: alcuni BIOS UEFI (come il mio) hanno dei bootloader a dir poco scadenti che rendono l'aggiunta manuale di nuove opzioni a dir poco difficile (io ancora non so come fare, e ci ho provato per un intero pomeriggio).

Per risolvere questo problema, possiamo usare l'ottimo rEFInd, il cui script di installazione crea automaticamente una nuova voce UEFI nel BIOS.

Quindi, andiamo dentro la directory /mnt/tmp/refind/ ed eseguiamo lo script

# ./install.sh

A questo punto, riavviando il sistema, ci ritroveremo davanti ad un menu grafico contenente almeno due opzioni: Windows e Linux (con tanto di icone).

rEFInd, infatti, ad ogni avvio effettua una scansione della ESP alla ricerca di file terminanti con l'estensione .efi e le presenta come opzioni di boot.

Tuttavia, possiamo fare di più ed evitare di passare da eLILO: dalla versione 3.3 in poi, il kernel Linux possiede la capacità di "autoavviarsi" una volta invocato da un bootmanager come rEFInd.

Possiamo quindi compilare i sorgenti che abbiamo scaricato in precedenza, direttamente in ambiente chroot o dopo il primo avvio, con l'accortezza di attivare l'opzione efi_stub

Processor Type and Features -> EFI Runtime Service Support -> EFI Stub Support
CONFIG_EFI_STUB=yes
CONFIG_CMDLINE_BOOL=yes
CONFIG_CMDLINE=yes

Una volta compilato il kernel, create una sottodirectory apposita nell'ESP, ad esempio:

# mkdir /boot/efi/EFI/Slackware

e copiateci dentro l'immagine del kernel con eventuali initrd:

# cp arch/x86_64/boot/bzImage /boot/efi/EFI/Slackware/vmlinuz-$VERSION.efi
# cp /boot/initrd.gz /boot/efi/EFI/Slackware/initrd-$VERSION.gz

:: Importante da sapere è che, nel caso si voglia creare un initrd, occorre includervi il modulo vfat, o il bootloader del kernel non sarà in grado di leggere l'immaggine nell'ESP.

:: rEFInd scansiona la ESP alla ricerca di files che corrispondano al pattern *.efi e, se uno di questi files contiene anche "vmlinuz" allora cerca l'initrd con una parte $VERSION corrispondente. Tutto in automatico.

Ancora una volta, per aggiungere altre opzioni al boot, basta copiare immagini del kernel e initrd con i criteri sopra riportati nella stessa subdirectory dell'ESP o in una nuova: rEFInd la troverà automaticamente.

Se vogliamo passare dei parametri aggiuntivi al kernel (quelli che di solito mettevamo della riga append='' di lilo.conf), ci basterà creare un file linux.conf nella stessa directory in cui si trova la relativa immagine vmlinuz.efi e queste verranno rilevate dall'efi_stub in fase di avvio.

linux.conf deve essere composto da una sola riga con le varie opzioni separate da spazi.

Spero che questa guida vi sia stata utile.

==Fonti Esterne==

[http://www.rodsbooks.com/efi-bootloaders/elilo.html Rodsbooks eLILO]

[http://www.rodsbooks.com/refind/installing.html Rodsbooks rEFInd]

[http://docs.slackware.com/howtos:slackware_admin:installing_on_uefi_hardware?s SlackDocs: Installing on UEFI hardware]

Redmine e apache via fcgi

Targzeta — Sun, 25 Nov 2012 12:05:27 GMT

Targzeta: Creata pagina con ' Category: Ufficio_e_Web = Introduzione = In questo articolo vedremo come installare ...'

[[Category: Ufficio_e_Web]]
= Introduzione =
In questo articolo vedremo come installare Redmine sulla Slackware (testato su Slackware 14.0 e 13.37 con gli accorgimenti riportati in seguito) e come configurare il server apache (httpd) in modo da renderlo accessibile via fcgi.

Redmine salva i propri dati su di un database e può gestire diversi tipi di DBMS ma, dato che Slackware ha come DBMS di defaul MySQL, noi useremo quest'ultimo.

= Installare Redmine =
L'installazione avviene senza problemi seguendo la [http://www.redmine.org/projects/redmine/wiki/RedmineInstall#Installation-procedure guida ufficiale]. Di seguito, comunque, riporto un sunto di quello che va fatto per installarlo su Slackware.

== Step 0: installare fcgi e mod_fcgi ==
Per poter usare httpd via fcgi (Fast CGI) va installata nel sistema sia la libreria '''fcgi''' che il modulo '''mod_fcgid''' (per httpd stesso).

=== fcgi versione 2.4.1-SNAP-0910052249 ===
Il progetto è molto vecchio (2009), ma [http://www.fastcgi.com/ gli sviluppatori] dicono che le modifiche sono minime perché il protocollo è stabile. Il sorgente lo trovate [http://www.fastcgi.com/dist/ qui], ma noi creeremo il pacchetto per Slackware grazie ai comandi seguenti (l'ultimo va eseguito come root):
<pre>
cd /tmp
mkdir fcgi
cd fcgi
wget http://www.fastcgi.com/dist/fcgi-2.4.1-SNAP-0910052249.tar.gz
wget http://www.slacky.eu/wikislack/upload/1/13/Fcgi-SlackBuild.tar.bz2
tar -xf Fcgi-SlackBuild.tar.bz2
sh fcgi.SlackBuild
</pre>
Il pacchetto verrà creato nella directory corrente (''/tmp/fcgi'').

=== mod_fcgid versione 2.3.7 ===
Per controllare l'uscita di versioni più recenti si veda [https://httpd.apache.org/download.cgi#mod_fcgid questo link]. Di seguito, i comandi necessari alla costruzione del pacchetto per Slackware (al solito, l'ultimo va eseguito come root):
<pre>
cd /tmp
mkdir mod_fcgid
cd mod_fcgid
wget http://apache.panu.it//httpd/mod_fcgid/mod_fcgid-2.3.7.tar.bz2
wget http://www.slacky.eu/wikislack/upload/8/8a/Mod_fcgid-SlackBuild.tar.bz2
tar -xf Mod_fcgid-SlackBuild.tar.bz2
sh mod_fcgid.SlackBuild
</pre>
Il pacchetto verrà creato nella directory corrente (''/tmp/mod_fcgid'').

Una volta installato il pacchetto, va anche detto al server httpd di usarlo:
echo 'LoadModule fcgid_module lib64/httpd/modules/mod_fcgid.so' >> /etc/httpd/httpd.conf
{{Information
|Note
|Una volta lanciato il server apache, noterete nel suo log ''/var/log/httpd/error_log'', se il modulo è stato caricato correttamente, una riga simile a questa:
AH00489: Apache/2.4.3 (Unix) PHP/5.4.7 mod_fcgid/2.3.7 configured
Alternativamente, si può controllare tra i moduli caricati da apache con:
httpd -M | grep fcgid
dovrebbe comparire la riga:
fcgid_module (shared)
}}

== Step 1: scaricare Redmine ==
Scaricate redmine dal [http://www.redmine.org/projects/redmine/wiki/Download sito ufficiale] ed estraete l'archivio nella directory che preferite. Tenete conto che la sotto-directory ''public'' (contenuta nell'archivio) è quella che verrà gestita dal server web. Per questa wiki, l'archivio è stato scaricato nella directory ''/tmp'' ed è stato estratto sotto ''/var/www/htdocs/'' con i comandi (per Redmine 2.1.4):
<pre>
cd /tmp
wget http://rubyforge.org/frs/download.php/76578/redmine-2.1.4.tar.gz
cd /var/www/htdocs/
tar -xf /tmp/redmine-2.1.4.tar.gz
mv redmine-2.1.4 redmine
chown root.root -R redmine
chmod go-w -R redmine/
</pre>
{{Information
|Note
|Visto che abbiamo installato redmine sotto ''/var/www/htdocs/'', tutti i comandi vanno eseguiti con i diritti dell'utente root. In realtà, se si installa redmine in una directory accessibile all'utente non amministratore, i comandi possono anche essere eseguiti senza l'ausilio del superutente.
}}

== Step 2: installare i requisiti ==
Installate il pacchetto '''bundler''' per Ruby eseguendo, come root:
gem install bundler
{{Warning
|Slackware 13.37 o precedenti
|Il pacchetto '''bundler''' necessita di una versione recente di '''gem''' non installata nel pacchetto Slackware di Ruby. Si può comunque provare ad installare la versione di Ruby presente nella Slackware 14.0 usando direttamente lo SlackBuild di Pat. Prima di compilare ed installare Ruby, comunque, va compilata e installata anche la libreria '''libyaml''', sempre presenta nella Slackware 14.0. Ecco i link agli SlackBuild ufficiali:
* [http://slackware.org.uk/slackware/slackware-14.0/source/l/libyaml/ libyaml]
* [http://slackware.org.uk/slackware/slackware-14.0/source/d/ruby/ ruby]
}}

{{Information
|Note
|Dato che redmine necessita di tutta una serie di dipendenze per Ruby di cui è difficile trovare i pacchetti Slackware, qui useremo il package manager per Ruby di default, '''gem'''. Tutti i pacchetti installati, comunque, saranno inseriti da '''gem''' nella directory (su una slackware64-14.0) ''/usr/lib64/ruby/gems/1.9.1/gems''.
}}

Ora, assicuratevi di essere all'interno della directory di redmine:
cd /var/www/htdocs/redmine

Tramite '''bundler''' e il file '''Gemfile''' fornito con redmine, si possono installare tutte le dipendenze necessarie a quest'ultimo. Prima però bisogna eseguire il comando:
echo "gem 'fcgi'" > Gemfile.local
per dire a '''bundler''' che deve installare anche il pacchetto '''fcgi''' (per Ruby). Ora siamo pronti ad installare il tutto tramite il comando:
bundle install --without development test postgresql sqlite
le opzioni dicono a '''bundler''' di non installare i pacchetti necessari al ramo di sviluppo, a quello di test, e di ignorare anche i pacchetti necessari ai DBMS PostgreSQL e SQLite.

== Step 3: preparare il database MySQL ==
Ora dobbiamo creare sia un database che un utente per MySQL a cui garantire pieno accesso. Come suggerito nella [http://www.redmine.org/projects/redmine/wiki/RedmineInstall#MySQL guida ufficiale] creiamo il database '''redmine''' e l'utente '''redmine''' (con password '''redminepass''') via mysql:
mysql -u'root' -p'root_pass'
create database redmine character set utf8;
create user 'redmine'@'localhost' identified by 'redminepass';
grant all privileges on redmine.* to 'redmine'@'localhost';
exit

== Step 4: configurare redmine all'uso del database ==
Per dire a redmine di usare il database creato al passo precedente bisogna creare il file ''config/database.yml'' con all'interno le seguenti righe:
<pre>
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: redminepass
</pre>

Possiamo farlo eseguendo il comando seguente:
echo -e 'production:\n adapter: mysql2\n database: redmine\n host: localhost\n username: redmine\n password: redminepass' > config/database.yml

== Step 5: generare il secret token ==
Questo passo genera una chiave random usata da '''Rails''' (il framework Ruby usato da Redmine) per codificare i cookie di sessione:
rake generate_secret_token

== Step 6: creare le tabelle del database ==
Ora create le tabelle di redmine con il comando:
RAILS_ENV=production rake db:migrate
{{Information
|Note
|La variabile di ambiente RAILS_ENV serve a dire a '''Rails''' quale ramo deve usare, quello che abbiamo configurato noi (vedi file ''config/database.yml'') è quello di produzione (c'è anche quello di test e di sviluppo).
}}

== Step 7: popolare le tabelle con i dati di default ==
RAILS_ENV=production REDMINE_LANG=it rake redmine:load_default_data
{{Information
|Note
|REDMINE_LANG=it dice a redmine di installare la traduzione in lingua italiana.
}}

== Step 8: permessi a file e directory ==
Ora dobbiamo garantire l'accesso al server httpd ad alcuni file e directory:
mkdir -p tmp/pdf public/plugin_assets
chown -R apache.apache files log tmp public/plugin_assets

== Step 9: testare il tutto ==
Per controllare se redmine è stato installato correttamente, basta eseguire il comando:
ruby script/rails server webrick -e production
e poi andare all'indirizzo http://localhost:3000/

== Step 10: login ==
Nello step 7 redmine ha creato anche un utente amministratore di default con le seguenti credenziali:
* login: admin
* password: admin

= Usare fcgi =
Una volta installato redmine, possiamo "integrarlo" nel server web apache ('''httpd''') via '''fcgi'''. Prima assicuriamoci di aver seguito lo [[#Step_0:_installare_fcgi_e_mod_fcgi|Step 0]] del paragrafo precedente e di aver installato via '''gem''' il pacchetto '''fcgi''' anche per Ruby ([[#Step_2:_installare_i_requisiti|Step 2]] del paragrafo precedente).

Prima di eseguire i passi seguenti, assicuriamoci ancora una volta di stare nella directory in cui abbiamo decompresso redmine:
cd /var/www/htdocs/redmine

== Step 0: preparare redmine e apache ==
Redmine viene fornito di uno script FCGI che esegue il vero processo. Lo script si chiama ''public/dispatch.fcgi.example'', rinominiamolo (o copiamolo) eliminando l'estensione ''.example''.
mv public/dispatch.fcgi.example public/dispatch.fcgi

Ora che abbiamo il wrapper fcgi, abbiamo anche bisogno di istruire apache in modo che lo esegua. Anche per questo redmine ha un file htaccess di esempio, ''public/htaccess.fcgi.example''. Rinominiamo anche questo:
mv public/htaccess.fcgi.example public/.htaccess
{{Information
|Note
|Se date uno sguardo al file ''public/.htaccess'' appena spostato, noterete che ci sono una serie di '''IfModule'''. Questo perché redmine può essere eseguito via fcgi sia con il modulo per apache '''mod_fcgid''' (il nostro caso) sia con '''mod_fastcgi'''. Per l'ultimo caso si veda [http://www.redmine.org/projects/redmine/wiki/HowTo_configure_Apache_to_run_Redmine#mod_fastcgi la guida sul sito di redmine]. Per le nostre esigenze, il file ''public/.htaccess'' potrebbe essere anche riscritto nel modo seguente:
<pre>
# General Apache options
AddHandler fcgid-script .fcgi

Options +FollowSymLinks +ExecCGI

RewriteEngine On

RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^(.*)$ dispatch.fcgi [QSA,L]

ErrorDocument 500 "<h2>Application error</h2>Rails application failed to start properly"
</pre>
}}

{{Warning
|Attenzione
|La Slackware non ha, di default, il modulo apache '''mod_rewrite''' attivo, necessario per poter usare i file ''.htaccess''. Per attivarlo assicuriamoci che la relativa riga nel file ''/etc/httpd/httpd.conf'' sia decommentata (qui la riga per la Slackware64 14.0):
LoadModule rewrite_module lib64/httpd/modules/mod_rewrite.so
}}

Quello che resta da fare è dire a '''Rails''' di eseguire l'ambiente di produzione, altrimenti di default verrà eseguito l'ambiente di sviluppo. Per fare questo bisogna inserire all'inizio del file ''config/environment.rb'' le seguenti righe:
<pre>
# Force the rails environment to production
ENV['RAILS_ENV'] ||= 'production'
</pre>
Possiamo farlo direttamente eseguendo il seguente comando:
<pre>
sed -i '1i \
# Force the rails environment to production \
ENV["RAILS_ENV"] ||= "production" \
' config/environment.rb
</pre>

== Step 1: configurare il virtual host di apache ==
Ci sono due modi per rendere disponibile redmine via apache. Possiamo settargli un virtual host dedicato, oppure renderlo disponibile come sotto-directory di un virtual host già esistente.

=== Virtual host dedicato ===
Aggiungiamo al file che contiene le impostazioni sui virtual host, ''/etc/httpd/extra/httpd-vhosts.conf'', seguenti righe:
<pre>
# Redmine
<VirtualHost *:80>
DocumentRoot "/var/www/htdocs/redmine/public"
ServerName redmine
<Directory "/var/www/htdocs/redmine/public">
AllowOverride FileInfo Options
Require all granted
</Directory>
</VirtualHost>
</pre>
{{Information
|Note
|Le due direttive di '''AllowOverride''' servono rispettivamente, per abilitare l'uso del file ''.htaccess'' e per dare la possibilità a quest'ultimo di aggiungere le opzioni di cui necessita ('''+FollowSymLinks''' e '''+ExecCGI''').
}}
Dopo aver riavviato il server apache, basta collegarsi a http://redmine per vedere se il server è attivo (la prima volta ci vorrà un po' tempo affinché il framework '''Rails''' faccia il setup completo).
{{Warning
|Attenzione
|Affinché il link http://redmine funzioni, c'è bisogno che la richiesta venga rediretta al nostro server apache. Nel nostro caso, dato che stiamo provando tutto in locale, questo può essere fatto aggiungendo la riga seguente al file ''/etc/hosts'':
127.0.0.1 redmine
}}

=== Usare un virtual host esistente ===
Possiamo installare redmine sotto un virtual host esistente. Per fare questo, però, dato che la directory pubblica è una sotto-directory di redmine (la directory ''public/''), per non dover scrivere nel URL ''/redmine/public/'' è più conveniente settare un alias.

Supponiamo che ci sia già il seguente virtual host configurato nel file ''/etc/httpd/extra/httpd-vhosts.conf'' (notate il '''ServerName''' come '''localhost'''):
<pre>
<VirtualHost *:80>
DocumentRoot "/srv/httpd/htdocs"
ServerName localhost
</VirtualHost>
</pre>

Per settare l'alias per redmine bisogna modificare la precedente configurazione, con questa:
<pre>
<VirtualHost *:80>
DocumentRoot "/srv/httpd/htdocs"
ServerName localhost

# Redmine
Alias "/redmine" "/var/www/htdocs/redmine/public"
<Directory "/var/www/htdocs/redmine/public">
AllowOverride FileInfo Options
Require all granted
</Directory>
</VirtualHost>
</pre>

Ora però va modificato il file ''public/.htaccess'' settando la '''RewriteBase''' come ''/redmine'', altrimenti le richieste a http://localhost/redmine saranno riscritte in maniera errata (in particolare, non andranno verso ''public/dispatch.fcgi'' ma direttamente verso ''dispatch.fcgi''). Possiamo farlo con il comando seguente:
<pre>
sed -i '/^RewriteEngine/a \
RewriteBase /redmine' public/.htaccess
</pre>

Prima di testare il tutto, bisogna correggere [http://www.redmine.org/issues/12102 un piccolo bug] del framework '''Rails''' che gli impedisce di avviarsi in maniera corretta quando l'applicazione è un alias di un virtual host. Quindi modifichiamo il file ''config/environment.rb'' sostituendo le righe:
<pre>
# Initialize the rails application
RedmineApp::Application.initialize!
</pre>
in:
<pre>
# Initialize the rails application
RedmineApp::Application.routes.default_scope = { :path => '/redmine', :shallow_path => '/redmine' }
RedmineApp::Application.initialize!
Redmine::Utils::relative_url_root = '/redmine'
</pre>

Ora tutto dovrebbe essere pronto e redmine dovrebbe rispondere correttamente all'indirizzo http://localhost/redmine.

== Possibili problemi ==
Se redmine non dovesse funzionare a dovere, potete provare a guardare il file di log ''log/production.log''.

=== `require': no such file to load -- fcgi (LoadError) ===
Se trovate questo errore, provate a modificare il file ''public/dispatch.fcgi'' inserendovi all'inizio le seguenti righe:
<pre>
require 'rubygems'
require 'fcgi'
</pre>

Ovviamente dovete anche aver installato il pacchetto '''fcgi''' per Ruby, come visto nello [[#Step_2:_installare_i_requisiti|Step 2]] fatto durante l'installazione di redmine. Se non l'avete fatto, potete sempre farlo con:
gem install fcgi

= Rimuovere il tutto =
Durante l'installazione di redmine, abbiamo modificato qualche file di configurazione ed installato un bel po' di software. Vediamo come poter tornare indietro.

== Rimozione pacchetti installati ==
I pacchetti da rimuovere, con removepkg, sono:
* mod_fcgid
* fcgi
(eventualmente anche ruby e libyaml).
removepkg mod_fcgid fcgi

Vanno anche cancellati, il file:
/var/run/fcgid_shm
e la directory:
/var/run/fcgidsock/
con:
rm -r /var/run/fcgid_shm /var/run/fcgidsock/

== Pacchetti per Ruby ==
Via '''gem''' e '''bundler''' abbiamo installato i seguenti pacchetti sotto (per Slackware64-14.0) ''/usr/lib64/ruby/gems/1.9.1/gems/'':
* actionmailer-3.2.8
* actionpack-3.2.8
* activemodel-3.2.8
* activerecord-3.2.8
* activeresource-3.2.8
* activesupport-3.2.8
* arel-3.0.2
* builder-3.0.0
* bundler-1.2.2
* coderay-1.0.8
* erubis-2.7.0
* fcgi-0.8.8
* hike-1.2.1
* i18n-0.6.1
* journey-1.0.4
* jquery-rails-2.0.3
* json-1.7.5
* mail-2.4.4
* mime-types-1.19
* multi_json-1.3.7
* mysql2-0.3.11
* net-ldap-0.3.1
* polyglot-0.3.3
* rack-1.4.1
* rack-cache-1.2
* rack-openid-1.3.1
* rack-ssl-1.3.2
* rack-test-0.6.2
* rails-3.2.8
* railties-3.2.8
* rake-10.0.2
* rdoc-3.12
* rmagick-2.13.1
* ruby-openid-2.1.8
* sprockets-2.1.3
* thor-0.16.0
* tilt-1.3.3
* treetop-1.4.12
* tzinfo-0.3.35

Tutti questi pacchetti possono essere rimossi con il comando seguente (occhio che se qualche altro software per Ruby li usa ...):
<pre>
cd /usr/lib64/ruby/gems/1.9.1
rm -r */actionmailer-3.2.8* */actionpack-3.2.8* */activemodel-3.2.8* \
*/activerecord-3.2.8* */activeresource-3.2.8* */activesupport-3.2.8* \
*/arel-3.0.2* */builder-3.0.0* */bundler-1.2.2* */coderay-1.0.8* */erubis-2.7.0* \
*/fcgi-0.8.8* */hike-1.2.1* */i18n-0.6.1* */journey-1.0.4* */jquery-rails-2.0.3* \
*/json-1.7.5* */mail-2.4.4* */mime-types-1.19* */multi_json-1.3.7* \
*/mysql2-0.3.11* */net-ldap-0.3.1* */polyglot-0.3.3* */rack-1.4.1* \
*/rack-cache-1.2* */rack-openid-1.3.1* */rack-ssl-1.3.2* */rack-test-0.6.2* \
*/rails-3.2.8* */railties-3.2.8* */rake-10.0.2* */rdoc-3.12* */rmagick-2.13.1* \
*/ruby-openid-2.1.8* */sprockets-2.1.3* */thor-0.16.0* */tilt-1.3.3* \
*/treetop-1.4.12* */tzinfo-0.3.35*
</pre>

== Redmine ==
Ovviamente va anche eliminato redmine stesso:
<pre>
cd /var/www/htdocs/
rm -r redmine
</pre>

== Database ==
Il database e l'utente creati si possono eliminare con:
<pre>
mysql -u'root' -p'root_pass'
drop database redmine;
drop user redmine@localhost;
exit
</pre>

== File modificati ==
* ''/etc/httpd/httpd.conf'': eliminare la riga
LoadModule fcgid_module lib64/httpd/modules/mod_fcgid.so

* ''/etc/httpd/extra/httpd-vhosts.conf'': dipende se abbiamo settato [[#Virtual_host_dedicato|un virtual host dedicato]] o se abbiamo [[#Usare_un_virtual_host_esistente|usato un virtual host esistente]].

* ''/etc/hosts'': solo se l'abbiamo modificato inserendo la riga:
127.0.0.1 redmine

= Autore =
[[Utente:Targzeta|Targzeta]] ([[Discussioni utente:Targzeta|discussioni]]) 13:05, 25 nov 2012 (CET)

Slackware 14 e bluetooth

Joe — Thu, 15 Nov 2012 14:12:09 GMT

Joe:

==Premessa==

Il presente documento vuole descrive la procedura che ho adottato per impostare il bluetooth su slackware-14.0 al fine di far comunicare una comune pennetta bluetooth collegata al portatile via usb e il mio cellulare in modo da poterlo utilizzare come modem per collegarmi ad internet.

Ci sono varie modalità di comunicare via bluetooth dal computer al cellulare al fine di ottenere una connessione ad internet. Questo documento per il momento si limita a spiegare unicamente come associare al telefono un collegamento via porta COM. Questo si traduce in pratica nella creazione di un file speciale del tipo ''/dev/rfcomm0'' che potrà poi essere utilizzato come modem ed essere quindi selezionato nell'impostazione di una connessione dial-up.

Per ottenere lo scopo ci sono diversi metodi. Mi limiterò a trattare la configurazione senza l'utilizzo di applicazioni grafiche che tentano di automatizzare diversi passaggi.

==Sommario==

Le operazioni da eseguire si possono riassumere come segue:
* Avvio del servizio bluetooth
* Controllo funzionameto dell'adapter bluetooth locale
* Ricerca e identificazione del device bluetooth remoto
* Pairing tra i dispositivi
* Configurazione file ''/etc/bluetooth/rfcomm.conf''
* Test attivazione della porta ''COM'' (''/dev/rfcomm0'')
* Automatizzazione della configurazione all'avvio

==Operazioni==

:1. Avviamo il servizio bluetooth attraverso lo script presente in Slackware ''/etc/rc.d/rc.bluetooth''. Per farlo dobbiamo però renderlo eseguibile:

root@darkstar:~# chmod +x /etc/rc.d/rc.bluetooth
root@darkstar:~# /etc/rc.d/rc.bluetooth start

:2. Verifichiamo il riconoscimento dell'adapter locale ovvero, nel mio caso, della pennina bluetooth collegata al computer via usb.

root@darkstar:~# hciconfig
hci0: Type: BR/EDR Bus: USB
BD Address: 00:09:DD:50:2F:9C ACL MTU: 310:10 SCO MTU: 64:8
UP RUNNING PSCAN ISCAN
RX bytes:961 acl:0 sco:0 events:27 errors:0
TX bytes:361 acl:0 sco:0 commands:27 errors:0

:3. Ricerca del cellulare (assicurarsi di avere acceso il bluetooth sul cellulare e che non sia "nascosto"):

root@darkstar:~# hcitool scan
Scanning ...
00:21:AA:A4:F2:AD Nokia 5000d-2

:Questo ci riporta il "Bluetooth ID" del cellulare e ifo sul modello. Ai nostri fini basta annotare L'ID, che nel mio caso è ''00:21:AA:A4:F2:AD'' e servirà nella configurazione nel file ''rfcomm0.conf''.

:4. Pairing

:Al momento non ho ancora capito come eseguire l'operazione senza ricorrere a tool terzi non compresi nel pacchetto bluez.
:Su Slackware-14.0 ho utilizzato Blueman dall'ambiente grafico. Su Slackware-13.1 avevo installato uno script in python chiamato "simple-agent".
:Pertanto lascio in sospeso questo punto invitandovi anche a modificare la guida nel caso in cui riusciste ad effettuare il pairing senza ricorrere a software grafici o non inclusi di default in Slackware-14.0.

:I punti che seguono presuppongono che sia stato effettuato il pairing e che il cellulare sia stato configurato in modo da accettare automaticamente la connessione BT da parte del nostro sistema.

:5. Andiamo ora a modificare il file:
/etc/bluetooth/rfcomm.conf
:Ecco il mio:
rfcomm0 {
# Automatically bind the device at startup
bind yes;

# Bluetooth address of the device
device 00:21:AA:A4:F2:AD;

# RFCOMM channel for the connection
channel 1;

# Description of the connection
comment "Nokia 5000d-2";
}

:Riavviamo a questo punto il bluetooth in modo che le nostre modifiche alla configurazione siano applicate:

/etc/rc.d/rc.bluetooth restart

:6. Attivazione del device ''/dev/rfcomm0''.

: Per attivare al volo la porta ''COM'' ed ottenere il file ''/dev/rfcomm0'' da testare come modem possiamo semplicemente lanciare il seguente comando:

root@darkstar:~# rfcomm bind 0
root@darkstar:~# ls /dev/rfcomm*
/dev/rfcomm0

: A questopunto possiamo testare il modem, per esempio con un programma come minicom che permette di interrogarlo con comandi ''AT'', tipo ''ATZ''. Se riceviamo come risposta ''OK'' allora la comunicazione col modem è apposto e possiamo anche impostare la connessione ad internet selezionando ''/dev/rfcomm0'' come modem.

: Ok, però si vuole rendere questa operazione automatica all'avvio: cioè vogliamo che avviato il sistema sia già stato creato automaticamente il file speciale ''/dev/rfcomm0''.
:Pertanto aggiungiamo al file ''/etc/rc.d/rc.local'' la riga:

rfcomm bind 0

:Questo comando fà si che se il cellulare è nel raggio di azione del bluetooth del dongle usb e ha il bluetooth attivo, viene automaticamente visto e gli viene associato il file ''/dev/rfcomm0'' che viene creato al volo. Mettendo in questo file il comando ''rfcomm'', questo comportamento si ha automaticamente all'avvio del sistema.

:A questo punto una domanda è d'obbligo:
:abbiamo modificato il file ''/etc/bluetooth/rfcomm.conf'' impostando la voce ''bind'' a ''yes''. Come dice anche il commento nel file in questione, si dovrebbe creare automaticamente all'avvio il nostro file speciale associandolo al cellulare come stabilito dalla configurazione.

:Questo però non avviene. E ho letto in rete che dovrebbe essere colpa di un bug. Lascio a chi legge l'onere di ricercare eventuali informazioni in merito qualora fosse interessato.

:7. Riavviare il sistema.

:come riprova per vedere se tutto funziona automaticamente all'avvio ci può stare.

Wallpapers

Zerouno — Sat, 27 Oct 2012 19:35:15 GMT

Targzeta:

{{#sgallery:
|width=800
|height=600
|showarrows=true
|showcarousel=true
|showinfopane=false
|timed=true
|delay=6000
|imagelist=mayan-1024x768.jpg
Slackware_maja_kalendar.jpg
Maja_slack.jpg
Wallpaper_lampaaa.jpg
Wallpaper_slackgirl.jpg
Wallpaper_slackk.jpg
Wallpaper_slackware.jpg
Wallpaper_slackware-balon-1.jpg
Wallpaper_slackware-balon-2.jpg
Wallpaper_slackware-glass-break.jpg
Wallpaper_slackware-sace.jpg
Wallpaper_slackware-subgenius.jpg
Wallpaper_slackware_14.jpg
Higgs-slackware.jpg
My_black_slack_wallpaper.png
Onlyslackware.jpg
Slack14wall2.png
Slackwarecurrent2.png
Slackschoolwallpaper.png
Slackwallpaper.png
Slackware14_wallpaper1.png
Slackware_by_zealkane-d3bg6f9.jpg
}}
Per aggiungere un'immagine basta [[Speciale:Carica|caricarla]] e poi aggiungerla all'elenco. Tenete presente che il carousel ha uno sfondo nero, quindi non usate immagini trasparenti con scritte nere, piuttosto convertitele in JPEG.

Lo staff.

Propaganda

Slacky — Fri, 19 Oct 2012 16:48:25 GMT

Zerouno:

{{#sgallery:
|width=700
|height=600
|showarrows=true
|showcarousel=true
|showinfopane=false
|timed=true
|delay=4000
|imagelist=Mistowhite.jpg
slackywhite.png
Latowhite.png
palla.jpg
}}
Per aggiungere un'immagine basta [[Speciale:Carica|caricarla]] e poi aggiungerla all'elenco. Tenete presente che il carousel ha uno sfondo nero, quindi non usate immagini trasparenti con scritte nere, piuttosto convertitele in JPEG.

Lo staff.

SlackPack Package Manager

Kimotori — Thu, 11 Oct 2012 00:27:51 GMT

Kimotori:

[[Category:Packages]]
= Introduzione: =
Per chi è pigro e non ha voglia di smanettare per la creazione dei pachetti, ci sono in giro diversi tool in grado di sostituire il nostro lavoro, attraverso script e percorsi, eseguendo, allegramente quel che altrimenti avremmo dovuto far noi...

Slackpack è un tool simpatico, purtroppo l' ultimo suo aggiornamento è fermo alla versione 1.1.9:
https://slackpackpkgman.wordpress.com/download/

ma per la sua semplicità rimane un tool ancora funzionante dato che per le diverse opzioni e pachettizzazioni fa uso di applicazioni esterne, tra cui il makepkg per la creazione dei pachetti, mentre per la loro conversione, l' rpm2tgz (onnipresente in distro) e deb2tgz (opzionale, derivato da rpm2tgz, lo trovate [https://code.google.com/p/deb2tgz/downloads/list qui])

Il tool va fatto partire con i privilegi di root, di conseguenza i pacchetti creati li ritroveremo dentro la dir
/root/nomepacchetto.versione.arch.tgz

Slackware 14.0 release announcement

Slacky — Sat, 29 Sep 2012 06:41:19 GMT

Slacky:

Yes, it is that time again! After well over a year of planning,
development, and testing, the Slackware Linux Project is proud to
announce the latest stable release of the longest running distribution
of the Linux operating system, Slackware version 14.0!

We are sure you'll enjoy the many improvements. We've done our best to bring the latest technology to Slackware while still maintaining the stability and security that you have come to expect. Slackware is well known for its simplicity and the fact that we try to bring software to you in the condition that the authors intended.

Slackware 14.0 brings many updates and enhancements, among which you'll find two of the most advanced desktop environments available today: Xfce 4.10.0, a fast and lightweight but visually appealing and easy to use desktop environment, and KDE 4.8.5, a recent stable release of the 4.8.x series of the award-winning KDE desktop environment. These desktops utilize udev, udisks, and udisks2, and many of the
specifications from freedesktop.org which allow the system administrator
to grant use of various hardware devices according to users' group
membership so that they will be able to use items such as USB flash
sticks, USB cameras that appear like USB storage, portable hard drives,
CD and DVD media, MP3 players, and more, all without requiring sudo, the
mount or umount command. Just plug and play. Slackware's desktop
should be suitable for any level of Linux experience.

Slackware uses the 3.2.29 kernel bringing you advanced performance features such as journaling filesystems, SCSI and ATA RAID volume support, SATA support, Software RAID, LVM (the Logical Volume Manager), and encrypted filesystems. Kernel support for X DRI (the Direct Rendering Interface) brings high-speed hardware accelerated 3D graphics to Linux.

There are two kinds of kernels in Slackware. First there are the huge kernels, which contain support for just about every driver in the Linux kernel. These are primarily intended to be used for installation, but there's no real reason that you couldn't continue to run them after you have installed. The other type of kernel is the generic kernel, in which nearly every driver is built as a module. To use a generic kernel you'll need to build an initrd to load your filesystem module and possibly your drive controller or other drivers needed at boot time, configure LILO to load the initrd at boot, and reinstall LILO. See the docs in /boot after installing for more information. Slackware's Linux kernels come in both SMP and non-SMP types now. The SMP kernel supports multiple processors, multi-core CPUs, HyperThreading, and about every other optimization available. In our own testing this kernel has proven to be fast, stable, and reliable. We recommend using the SMP kernel even on single processor machines if it will run on them. Note that on
x86_64 (64-bit), all the kernels are SMP capable.

=== Here are some of the advanced features of Slackware 14.0: ===

Runs the 3.2.29 version of the Linux kernel from ftp.kernel.org.
The 3.2.x series is well-tested, offers good performance, and will be
getting long term support from kernel.org. For people interested in
trying out newer kernels, we've provided sample configuration files
for Linux 3.4.11, 3.5.4, and 3.6-rc4 under the /testing directory.

System binaries are linked with the GNU C Library, version 2.15.
This version of glibc also has excellent compatibility with
existing binaries.

X11 based on the X.Org Foundation's modular X Window System.
This is X11R7.7, a new release, with many improvements in terms of
performance and hardware support.

Installs gcc-4.7.1 as the default C, C++, Objective-C,
Fortran-77/95/2003/2008, and Ada 95/2005/2012 compiler.

Support for NetworkManager for simple configuration of wired and
wireless network connections, including mobile broadband, IPv6, VPN,
and more. Roam seamlessly between known networks, and quickly set
up new connections. We've retained full support for the traditional
Slackware networking scripts and for the wicd network manager,
offering choice and flexibility to all levels of users.

Support for fully encrypted network connections with OpenSSL,
OpenSSH, OpenVPN, and GnuPG.

Apache (httpd) 2.4.3 web server with Dynamic Shared Object
support, SSL, and PHP 5.4.7.

USB, IEEE 1394 (FireWire), and ACPI support, as well as legacy PCMCIA
and Cardbus support. This makes Slackware a great operating system
for your laptop.

The udev dynamic device management system for Linux 3.x.
This locates and configures most hardware automatically as it
is added (or removed) from the system, loading kernel modules
as needed. It works along with the kernel's devtmpfs filesystem
to create access nodes in the /dev directory.

New development tools, including Perl 5.16.1, Python 2.7.3,
Ruby 1.9.3-p194, Subversion 1.7.6, git-1.7.12.1, mercurial-2.2.2,
graphical tools like Qt designer and KDevelop, and much more.

Updated versions of the Slackware package management tools make it
easy to add, remove, upgrade, and make your own Slackware packages.
Package tracking makes it easy to upgrade from Slackware 13.37 to
Slackware 14.0 (see UPGRADE.TXT and CHANGES_AND_HINTS.TXT).
The slackpkg tool can also help update from an older version of
Slackware to a newer one, and keep your Slackware system up to date.
In addition, the slacktrack utility will help you build and maintain
your own packages.

Web browsers galore! Includes KDE's Konqueror 4.8.5, SeaMonkey 2.12.1
(this is the replacement for the Mozilla Suite), Mozilla Firefox 15.0.1,
as well as the Thunderbird 15.0.1 email and news client with advanced
junk mail filtering. A script is also available in /extra to repackage
Google Chrome as a native Slackware package.

The KDE Software Compilation 4.8.5, a complete desktop environment.
This includes the Calligra productivity suite (previously known as
KOffice), networking tools, GUI development with KDevelop, multimedia
tools (including the Amarok music player and K3B disc burning software),
the Konqueror web browser and file manager, dozens of games and utilities,
international language support, and more.

A collection of GTK+ based applications including pidgin-2.10.6,
gimp-2.8.2 (with many improvements including a single window mode),
gkrellm-2.3.5, xchat-2.8.8, xsane-0.998, and pan-0.139.

A repository of extra software packages compiled and ready to run
in the /extra directory.

Many more improved and upgraded packages than we can list here. For
a complete list of core packages in Slackware 14.0, see this file:
ftp://ftp.slackware.com/pub/slackware/slackware-14.0/PACKAGES.TXT

=== Downloading Slackware 14.0: ===

The full version of Slackware Linux 14.0 is available for download from the central Slackware FTP site hosted by our friends at osuosl.org:

ftp://ftp.slackware.com/pub/slackware/slackware-14.0/

If the sites are busy, see the list of official mirror sites here:

http://mirrors.slackware.com

We will be setting up BitTorrent downloads for the official ISO images. Stay tuned to http://slackware.com for the latest updates.

Instructions for burning the Slackware tree onto install discs may be found in the isolinux directory.

=== Purchasing Slackware on CD-ROM or DVD: ===

Or, please consider purchasing the Slackware Linux 14.0 six CD-ROM set or deluxe dual-sided DVD release directly from Slackware Linux, and you'll be helping to support the continued development of Slackware Linux!

The DVD release has the 32-bit x86 Slackware 14.0 release on one side, and the 64-bit x86_64 Slackware 14.0 release on the other. Both sides are bootable for easy installation, and includes everything from both releases of Slackware 14.0, including the complete source code trees.

The 6 CD-ROM release of Slackware 14.0 is the 32-bit x86 edition. It includes a bootable first CD-ROM for easy installation. The 6 CD-ROMs are labeled for easy reference.

The Slackware 14.0 x86 6 CD-ROM set is $49.95 plus shipping, or choose the Slackware 14.0 x86/x86_64 dual-sided DVD (also $49.95 plus shipping).

Slackware Linux is also available by subscription. When we release a new version of Slackware (which is normally once or twice a year) we ship it to you and bill your credit card for a reduced subscription price ($32.99 for the CD-ROM set, or $39.95 for the DVD) plus shipping.

For shipping options, see the Slackware store website. Before ordering express shipping, you may wish to check that we have the product in stock. We make releases to the net at the same time as disc production begins, so there is a lag between the online release and the shipping of media. But, even if you download now you can still buy the official media later. You'll feel good, be helping the project, and have a great decorative item perfect for any computer room shelf.

=== Ordering Information: ===

You can order online at the Slackware Linux store:

http://store.slackware.com

Other Slackware items like t-shirts, caps, pins, and stickers can also be found here. These will help you find and identify yourself to your fellow Slackware users. There are still some 1337 T-shirts left, and we'll also be unveiling a brand new T-shirt design soon for this new release.

Order inquiries (including questions about becoming a Slackware reseller) may be directed to this address: info@slackware.com

Have fun! :^) I hope you find Slackware to be useful, and thanks
very much for your support of this project over the years.

Patrick J. Volkerding <volkerdi@slackware.com>

Visit us on the web at: http://slackware.com

Installare MATE - The traditional desktop environment

Kimotori — Wed, 26 Sep 2012 12:58:09 GMT

Kimotori: /* Slackware 13.37 */

[[Category:Server_X]]
== Introduzione ==

[http://mate-desktop.org/ MATE] è un fork di GNOME 2.
Con l' arrivo del famoso GNOME 3, molti utenti si sono sentiti privati di qualcosa, così, gli "scontenti" hanno pensato di riprendere l' ultima versione "alla vecchia maniera" e proseguire da se.

Di recente l' utente miklos ha aggiunto ai repository di Slacky.eu della 13.37 (32 e 64) il desktop MATE 1.2.

(Grazie mille!)

Prima di questo, esistevano 2 strade, l' installazione, scaricando i pachetti manualmente (uno ad uno) dai repositori Salix... oppure attraverso la compilazione dei sorgenti, come descritto nella pagina ufficiale di [http://wiki.mate-desktop.org/download MATE-wiki]

E' possibile, ora, utilizzare slapt-get, swaret o slackyd. Del primo ne parlerò nello specifico perchè più familiare, mentre per gli altri due passo la palla a chi ne sa più di me.

== Procedura ==
Dato i repository, possiamo, a piacere, scegliere quale gestore pacchetti utilizzare, essi stessi si preoccuperanno di soddisfare le dipendenze necessarie, se presenti, altrimenti, provvederemo noi stessi.

=== Slapt-get ===
Per poter utilizzare i repository di slacky.eu bisogna aggiungerli a [http://software.jaos.org/ slapt-get] editando il file '''/etc/slapt-get/slapt-getrc''' ed aggiungendo all' ultima riga il link:

==== Slackware 13.37 ====
Per quelli che hanno slackware 13.37 e quindi MATE 1.2 aggiungeranno:
...
# Home made packages.
# SOURCE=file:///var/www/packages/:CUSTOM
SOURCE=''http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-13.37/:CUSTOM''
oppure SOURCE=''http://slack.isper.sk/pub/slackware-13.37/:CUSTOM

Repository per Slackware64 13.37
SOURCE=''http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-13.37/:CUSTOM''
oppure SOURCE=''http://slack.isper.sk/pub/slackware64-13.37/:CUSTOM

'''I pachetti MATE 1.2 contenuti nei repo di slackware-13.37 e slackware64-13.37 possono essere installati su slackware-14.0 e slackware64-14.0'''

==== Slackware 14.0 ====
Repository per Slackware 14.0
...
# Home made packages.
# SOURCE=file:///var/www/packages/:CUSTOM
SOURCE=''http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-14.0/:CUSTOM'' Attenzione non ancora dipsonibile MATE!
oppure SOURCE=''http://slack.isper.sk/pub/slackware-14.0/:CUSTOM
Repository per Slackware64 14.0
SOURCE=''http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-14.0/:CUSTOM'' Attenzione non ancora dipsonibile MATE!
oppure SOURCE=''http://slack.isper.sk/pub/slackware64-14.0/:CUSTOM

== Applicazione ==
Se i pachetti per la slackware-14.0 non sono ancora diponibili, optare per la versione 13.37.
Aggiornare il db con il comando:
slapt-get -u
Iniziamo l' installazione:
slapt-get -i --ignore-dep mate-desktop-environment
Listato dei file:
mate-desktop-environment
mate-desktop
mate-applets
mate-backgrounds
mate-calc
mate-dialogs mate-document-viewer
mate-file-archiver
mate-file-manager
mate-file-manager-sendto
mate-icon-theme
mate-menu-editor
mate-menus
mate-panel
mate-screensaver
mate-session-manager
mate-text-editor mate-themes
mate-utils
mate-window-manager
...

=== Swaret ===

==== Slackware 13.37 ====
Repository per Slackware 13.37
REPOS_ROOT=Slacky%http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-13.37/
Repository per Slackware64 13.37
REPOS_ROOT=Slacky%http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-13.37/

==== Slackware 14.0 ====
Repository per Slackware 14.0
REPOS_ROOT=Slacky%http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-14.0/
Repository per Slackware64 14.0
REPOS_ROOT=Slacky%http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-14.0/

=== Slackyd ===

==== Slackware 13.37 ====
Repository per Slackware 13.37
repository slacky = http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-13.37/
Repository per Slackware64 13.37
repository slacky = http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-13.37/

==== Slackware 14.0 ====
Repository per Slackware 14.0
repository slacky = http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-14.0/
Repository per Slackware64 14.0
repository slacky = http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware64-14.0/

== Conclusioni ==
Slapt-get, swaret ed slackyd, sono ottimi tool, ma non perfetti, '''Per gli aggiornamenti della distribuzione''', consiglio vivamente l' uso fidato di '''slackpkg''' tool ufficiale slackware. Suggerisco la disabilitazione dei repository ufficiali, in modo da lasciare al tool, il lavoro '''esclusivo dei repo custom'''; Posto il file di conf di slapt-get per maggior chiarezza:
# Working directory for local storage/cache.
WORKINGDIR=/var/slapt-get
# Exclude package names and expressions.
# To exclude pre and beta packages, add this to the exclude:
# [0-9\_\.\-]{1}pre[0-9\-\.\-]{1}
EXCLUDE=^aaa_elflibs,^devs,^glibc-.*,^kernel-.*,^udev,.*-[0-9]+dl$,x86_64
# Base url to directory with a PACKAGES.TXT.
# This can point to any release, ie: 9.0, 10.0, current, etc.
# SOURCE=ftp://ftp.slackware.com/pub/slackware/slackware-14.0/:OFFICIAL -------------> repo ufficiali disabilitati
# Sources for the testing, extra, and pasture areas - if you use them.
# SOURCE=ftp://ftp.slackware.com/pub/slackware/slackware-14.0/extra/:PREFERRED -------> repo ufficiali disabilitati
# SOURCE=ftp://ftp.slackware.com/pub/slackware/slackware-14.0/testing/ ---------------> repo ufficiali disabilitati
# SOURCE=ftp://ftp.slackware.com/pub/slackware/slackware-14.0/pasture/ ---------------> repo ufficiali disabilitati
# Source for slapt-get.
SOURCE=http://software.jaos.org/slackpacks/14.0/:OFFICIAL ------------> per aggiornare il tool
# Packages on a CD/DVD.
# SOURCE=file:///mnt/cdrom/:OFFICIAL
# Home made packages.
# SOURCE=file:///var/www/packages/:CUSTOM
SOURCE=http://darkstar.ist.utl.pt/slackware/addon/slacky/slackware-13.37/:CUSTOM -------> solo link repo custom
# oppure SOURCE=http://slack.isper.sk/pub/slackware-13.37/:CUSTOM

== Configurazioni opzionali ==
Dopo l' installazione, ad alcuni farà piacere attivare il Manager di composizione. Posizionarsi su ''Sistema''-->''Amministrazione''-->''Editor di configurazione''.Nella prima finestra da root aprire la 1° directory ''apps'' poi ''marco'' ed infine ''general'' sulla finestra laterale, cercare ''compositing_manager'', metterci una spunta sulla casellina vuota. Fatto, immediatamente sarà attivo.

== Collaborazioni ==

Chiunque, potrà abbozzare o ridefinire, modificare e cancellare, secondo i termini d'uso della licenza GNU Free Documentation License 1.2. Sono esonerati da qualunque responsabilità, l' autore, i collaboratori di questa pagina, il sito www.slacky.eu e tutti gli utenti del forum.

Grazie della collaborazione.

Ssmtp Mini Howto

Miklos — Mon, 17 Sep 2012 15:30:54 GMT

Miklos:

[[category:Networking]]
= Introduzione =
Questo mini howto mostra come installare e configurare [http://packages.debian.org/stable/ssmtp Ssmtp] su Slackware.

Ssmtp è un semplice tool che effettua il forward di una mail inviata in locale, verso un server smtp esterno (mailhub). Non è assolutamente da confondere con un server smtp tradizionale, in quanto non è in grado di ricevere email, non gestisce alcuna coda per l'invio di messaggi, etc etc etc.

La caratteristica che lo rende però interessante è '''la piena compatibilità con l'eseguibile sendmail dell'omonimo server di posta'''. Infatti sia le modalità di invocazione che il formato dei parametri accettato è in tutto e per tutto identico.

Questo apre la porta ad una serie di utilizzi interessanti, fra cui uno in particolare che vedremo in seguito.

= Installazione =
Prima di tutto installiamo il software. All'atto della stesura dell'howto i pacchetti sono presenti all'interno del repository slacky per entrambe le architetture. 
Perciò è possibile scegliere la modalità preferita fra l'installazione dei binari e la compilazione direttamente dal sorgente

== Da pacchetti precompilati ==

== Da sorgente ==
Per poter procedere alla compilazione dal sorgente scarichiamo dal [http://packages.debian.org/stable/ssmtp sito ufficiale] l'ultima versione disponibile. 
Una volta fatto procediamo all'estrazione del sorgente e alla compilazione con i seguenti comandi:
$ tar xvf ssmtp_2.64.orig.tar.bz2
$ cd ssmtp-2.64
$ ./configure --prefix=/usr --sysconfdir=/etc --mandir=/usr/man --enable-ssl --enable-inet6 --enable-md5auth
$ make
portata a termine la compilazione installiamolo da superutente con:
# make install
ci verrano richieste un paio di informazioni di configurazione (rispettivamente il nome host che verrà usato nell'intestazione delle mail forwardate e la porta di default del mailhub smtp) che però possono essere cambiate tramite file di configurazione, quindi si puo' tranquillamente rispondere con i valori proposti.

'''Importante''' 
Il makefile non supporta pienamente l'installazione in una directory differente tramite la variabile DESTDIR. Se si vuole ottenere lo stesso effetto è necessario lanciare il make install aggiungendo altri parametri: 
# make install prefix=path_di_installazione/usr etcdir=path_di_installazione/etc

= Configurazione =
Una volta installato il software procediamo alla sua configurazione aprendo il file principale '''/etc/ssmtp/ssmtp.conf''' che inizialmente dovrebbe apparire cosi':
#
# /etc/ssmtp.conf -- a config file for sSMTP sendmail.
#
# The person who gets all mail for userids < 1000
# Make this empty to disable rewriting.
root=postmaster
# The place where the mail goes. The actual machine name is required
# no MX records are consulted. Commonly mailhosts are named mail.domain.com
# The example will fit if you are in domain.com and you mailhub is so named.
mailhub=mailhub
# Where will the mail seem to come from?
#rewriteDomain=y
# The full hostname
hostname=
e andiamolo a modificare secondo le nostre esigenze. 
Come prima cosa modifichiamo il valore del parametro '''mailhub''' indicando l'host e la porta del nostro mailhub
mailhub = smtp.mioserversmtp.org
dopodichè indichiamo nel parametro '''root''' la mail che si vuole utilizzare nel caso in cui l'eseguibile venga lanciato con id utente < 1000
root = mioaccount@miodominio.org
si può infine modificare il parametro '''hostname''' indicando un nome host che rappresenta la macchina
hostname = miocomputer.miodominio.org
oppure lasciarlo vuoto e in questo caso verrà calcolato secondo le configurazioni del sistema. 
Se il server smtp richiede autenticazione è necessario aggiungere i seguenti parametri di configurazione
AuthUser = nomeutente
AuthPass = password

Una volta terminata la configurazione procediamo a testare il corretto funzionamento di ssmtp. 
Prima di tutto creiamo un file di testo semplice, chiamato per esempio '''mail.txt''', che contenga la nostra mail di prova
To: accountqualsiasi@dominioqualsiasi.org
From: mioaccount@miodominio.org
Subject: sSMTP test
Questa mail è un semplice test
a questo punto lanciamo ssmtp in questo modo
# ssmtp mioaccount@miodominio.org < mail.txt
e controlliamo che la mail sia stata spedita correttamente.

== Configurazione server smtp Gmail ==
L'utilizzo del server smtp di Gmail è molto semplice, in quanto oltre alle configurazioni base, bisogna aggiungere quelle relative all'autenticazione e alla connessione tramite protocollo cifrato
# host remoto gmail
mailhub=smtp.gmail.com:587
# parametri connessione cifrata
UseSTARTTLS=YES
UseTLS=YES
# parametri di autenticazione (account gmail)
AuthUser=youraccount
AuthPass=yourpassword

= Collegamenti esterni =
* [http://packages.debian.org/stable/ssmtp Sito ufficiale]

= Autori =
--[[Utente:Miklos|Miklos]]

Linee guida per pacchettizzatori Slackware 14.0

Slacky — Wed, 04 Jul 2012 06:56:25 GMT

Zerouno:

[[Category:Packages]]

= DOCUMENTO DA PERFEZIONARE =

Questa guida vuole definire delle linee da seguire per semplificare la creazione di pacchetti slacky
Una copia di questa guida in formato testuale si può trovare [[Media:Linee guida-pacchettizzatori.txt|quì]] (potrebbe non essere aggiornata all'ultima release. fate sempre riferimento a questo documento per gli ultimi update)

Si invita calorosamente a seguirla per uniformare il repository in modo che una seconda persona che voglia toccare uno SlackBuild sappia già dove mettere le mani senza doversi studiare il lavoro del suo predecessore.

== Prerequisiti ==
I pacchetti che si troveranno sul repository slacky devono essere compilati su l'ultima Slackware-stable, installata full (escludibile KDEI). Potete installare i vostri programmi preferiti, l'importante è che le librerie aggiuntive non influenzino il corretto sviluppo del precompilato.

Inoltre sul sistema deve essere installato [http://www.stabellini.net/requiredbuilder.html requiredbuilder] per la gestione delle dipendenze.

Chi vuole installarsi particolari programmi che possano invadere le librerie standard (in particolare, per chi usa Slackware64, le multilib di compatibilità a 32bit di AlienBob) o vuole installarsi la current, può optare per l'utilizzo di una macchina virtuale o di una installazione in chroot (consigliata).

La cosa importante è che tutte le dipendenze dei pacchetti vengano risolte all'interno di pacchetti slackware o di pacchetti slacky GIA' PRESENTI nel repository, e se non lo sono vanno preventivamente pacchettizzate.

== Compilazione multi-arch ==
A partire da Slackware 13.1, su slacky.eu è disponibile il repository a 64bit (separato da quello a 32bit).

Chi ha un pc a 32bit non ha problemi... compila solo pacchetti a 32bit.

Con un sistema a 64bit si compila a 64bit e basta. I pacchettizzatori che vogliono mettere a disposizione il pacchetto a 32bit e a 64bit deve installarsi anche una Slackware 32bit, possibilmente allineata - come patchlevel e software aggiuntivo - con quella a 64bit. E' possibile installare questa Slackware in una macchina virtuale o in chroot. Nonostante la distribuzione 'madre' sia a 64bit, garantisco che una Slackware 32bit in chroot funziona e compila perfettamente, eccezion fatta per la compilazione di moduli kernel e pacchetti particolari.

(Può essere utile lo [[Slackware Chroot AutoBuilder]] al proposito)
== Costituzione di un pacchetto ==
Per fare un pacchetto slacky abbiamo bisogno di:
* SlackBuild ([[Media:Template-linee guida pacchettizzatori.SlackBuild|scarica il template]])
* slack-desc ([[Media:Slack-desc-linee guida pacchettizzatori.template|scarica il template]])
* slack-required
* doinst.sh - opzionale. ([[Media:Doinst.sh-linee guida pacchettizzatori.template|scarica il template]])
* EULA.TXT - se richiesta.
Lo slack-required viene generato automaticamente da requiredbuilder.

Nota: i template scaricabili potrebbero non essere aggiornati all'ultimissima versione. Fare sempre riferimento a questo documento per gli ultimi update.

== La directory dei sorgenti ==
I path standard dei repository slacky sono così composti:

'''./categoriadelsoftware/nomedelpacchetto/versionedelpacchetto/<pacchetto.txz>'''

'''./categoriadelsoftware/nomedelpacchetto/versionedelpacchetto/src/<sorgenti>'''

quest'ultima directory conterrà lo SlackBuild, lo slack-desc, lo slack-required ed eventuali altri file da inserire nel pacchetto, se necessario, come il doinst.sh, gli initscript, qualche file di configurazione, eventuali patch e se necessario i sorgenti del software. Questi ultimi andrebbero messi solamente se non è possibile scaricarli semplicemente con una wget; per il resto andrebbe inserita una wget nello SlackBuild che scarichi i sorgenti dal sito ufficiale del produttore. Questo consente di risparmiare molto spazio sul server slacky e soprattutto molta banda. Là dove il software non è scaricabile con una wget ma solo interattivamente (riempimento di un capcha, accettazione di una licenza, login al sito, link con controlli di sessione, ecc...), allora si scaricano i sorgenti manualmente e si caricano sul server.
Se il pacchetto è non-gnu andrebbe caricata anche la licenza (solitamente presente all'interno del pacchetto) rinominandola in EULA.TXT e costringere l'utente ad accettarla PRIMA del download del pacchetto. Questo dovrebbe risolvere preventivamente problemi legali per i software commerciali.

== Notazioni ==
Riguardo al nome del pacchetto, capita a volte che il nome di un software sia tipicamente scritto con l'iniziale maiuscola o altre parti del nome maiuscole. Alcuni esempi: MySQL, TiMidity++, MPlayer, Judy, ... . E' opportuno che il pacchetto che venga generato sia comunque scritto tale e quale al nome originale, lo stesso vale per lo SlackBuild e lo slack-desc.

== I template ==
Per slack-desc, SlackBuild e doinst.sh sono stati elaborati dei template.

Vi preghiamo di utilizzare questi per i vostri pacchetti, perché così facendo sarà più semplice condividerlo con gli altri pacchettizzatori (soprattutto ora che Slacky mette a disposizione i repository per 32 e 64 bit).

In questa sezione vengono riportati i template per intero. Nella sezione successiva provvederemo a spiegarli punto per punto per semplificare l'adattamento del template al proprio software.
=== SlackBuild ===
* 27/08/12 -> aggiunta licenza 3rd parti, supporto a DOCS e SLKFILES. aggiunto JOBS. sistemazioni varie.
* 04/07/12 -> comincia l'adattamento per la 14.0, aggiunto il supporto a xz e inserito alla fine dell'intestazione la riga "Require" dove possiamo inserire dipendenze che non vengono intercettate da requiredbuilder, esempio i pacchetti Slackware che troviamo in /extra.
* 24/04/11 -> adattato per 13.37, rimosso cmake, modificati i commenti, aggiunto autodetect tar, directory, documentazione e doinst.sh
* 14/06/10 -> rimosso depfinder
* 26/05/10 -> rimosso MAKEFLAGS (v. [[#compilazione|compilazione]] più in basso)
* 26/05/10 -> aggiunto CHOST e MAKEFLAGS
* 26/05/10 -> separato TAG e BUILD
* 24/05/10 -> aggiunto cmake.

[[#intestazione|intestazione]]
<source lang="bash">
#!/bin/sh

# Heavily based on the Slackware 14.0 SlackBuild
# Written by <your name> ( your [at] email.address )
# Last build from <your name> ( your [at] email.address )

# Slackware build script for <appname>
# Official Site: http://......
</source>
se si copia uno slackbuild totalmente o in parte (parti speciali come post-make particolari ecc) inserire la licenza originale (comprensivo di autore) o linkare lo slackbuild originale. Per esempio
<source lang="bash">
# Heavily based on the Slackware 14.0 SlackBuild
# Copyright 2009, 2010, 2011, 2012 Eric Hameleers, Eindhoven, NL
# Copyright 2009, 2010, 2011, 2012 Patrick J. Volkerding, Sebeka, MN, USA
# All rights reserved.

# Written by Eric Hameleers < alien at slackware.com >
# Adapted to slacky's standard by <your name> ( your [at] email.address )

# Slackware build script for <appname>
# Official Site: http://......
# Patches from ...
</source>

licenza. Se è già presente una licenza lasciarla, altrimenti mettere la seguente.
<source lang="bash">
# Redistribution and use of this script, with or without modification, is
# permitted provided that the following conditions are met:
#
# 1. Redistributions of this script must retain the above copyright
# notice, this list of conditions and the following disclaimer.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# Require:
</source>
Modificare Require se necessario, vanno inserite solo le dipendenze extra, esempio quelle non rilevate da requiredbuilder e quelle che fanno parte degli extra di Slackware oppure le dipendenze necessare solamente per compilare. Queste non verranno inserite nel file required ma servono solo per agevolare i fruitori dello SlackBuild.

Per esempio
<source lang="bash">
# Require: apache-ant, jdk >= 6 | openjdk >= 6
</source>
<source lang="bash">
set -e
</source>
[[#parametri di base|parametri di base]] da modificare. (il tag dovrebbe rimanere ''sl'')
<source lang="bash">
PKGNAME=appname
VERSION=${VERSION:-1.4.1}
BUILD=${BUILD:-1}
TAG=${TAG:-sl}
ARCH=${ARCH:-i486}
SOURCE="http://downloads.sourceforge.net/project/......./${PKGNAME}-${VERSION}/${PKGNAME}-${VERSION}.tar.gz"
TAR= # empty = auto
DIR= # empty = auto
DOCS="AUTHORS COPYING INSTALL TODO TROUBLESHOOTING docs/ ..."
SLKFILES=""
</source>
DOCS indica tutti quei file presenti nei sorgenti da copiare in /usr/doc; in passato questa lista veniva modificata ogni volta nella sezione documentazione più in fondo.

SLKFILES indica tutti quei file che sono necessari allo slackbuild in quanto ora vengono copiati per intero nella /usr/doc; dalla lista vanno esclusi slack-desc doinst.sh slack-required e EULA.TXT che vengono copiati in automatico se presenti.
[[#EULA|EULA]].
Necessario per i pacchetti proprietari. Non modificare se non necessario.
<source lang="bash">
if [ -e EULA.TXT ];then
more EULA.TXT
echo "Do you accept terms? (yes/[no])":
read ACCEPT
if [ "$ACCEPT" != "yes" ];then
echo; echo "SlackBuild Aborted!!"
exit 1
fi
fi
</source>
[[#path di lavoro|path di lavoro]], [[#download|download]] e [[#architettura|architettura]].
Non modificare se non necessario. Queste impostazioni dovrebbero essere sufficienti per gran parte del software presente.
<source lang="bash">
JOBS=${JOBS:--j2}
CWD=$(pwd)
TMP=${TMP:-/tmp/buildpkgs/$PKGNAME}
PKG=$TMP/package-$PKGNAME
OUTPUT=${OUTPUT:-$CWD}
TAR=${TAR:-$(basename $SOURCE)}
DIR=${DIR:-$(echo "$TAR"|sed -r 's/(\.tar|)(.gz|.bz2|.xz|)$//')}

if [ ! -e "$CWD/$TAR" ];then
wget "$SOURCE" -O "$CWD/$TAR"
fi

CHOST="i486"
if [ "$ARCH" = "i486" ]; then
SLKCFLAGS="-O2 -march=i486 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "i586" ]; then
SLKCFLAGS="-O2 -march=i586 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "i686" ]; then
SLKCFLAGS="-O2 -march=i686 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "x86_64" ]; then
SLKCFLAGS="-O2 -fPIC"
LIBDIRSUFFIX="64"
CHOST="x86_64"
fi
</source>
anche JOBS, lasciarlo a -j2; se hai bisogno di più parallelismo puoi effettuare l'override da fuori.

[[#preparazione dei sorgenti|preparazione dei sorgenti]]. Solitamente da modificare solo se hai bisogno di patch o se il tuo sorgente è .zip o ha altre indicazioni speciali.
<source lang="bash">
rm -rf $TMP
mkdir -p $TMP $PKG $OUTPUT
cd $TMP
tar xvf $CWD/$TAR
cd $DIR

# patch -p1 < $CWD/some_patch.diff
# zcat $CWD/compressed_patch.diff.gz |patch -p1

chown -R root:root .
chmod -R u+w,go+r-w,a-s .
</source>
[[#compilazione|compilazione]]. Aggiungi i parametri di cui hai bisogno
<source lang="bash">
CFLAGS="$SLKCFLAGS" \
CXXFLAGS="$SLKCFLAGS" \
./configure \
--prefix=/usr \
--libdir=/usr/lib$LIBDIRSUFFIX \
--sysconfdir=/etc \
--localstatedir=/var \
--mandir=/usr/man \
--build=$CHOST-slackware-linux
make $JOBS
make install DESTDIR=$PKG
</source>
[[#personalizzazione|personalizzazione]]. (rimozione file, modifiche ecc)

Rinomina quì i file di configurazione e gli rc script e inserisci eventuali altri nuovi file
<source lang="bash">
# cat $CWD/rc.application.sh > $PKG/etc/rc.d/rc.application.new
# cat $PKG/etc/init.d/initscript >> $PKG/etc/rc.d/rc.program.new
# rm $PKG/etc/init.d/initscript
# mv $PKG/etc/appl.conf $PKG/etc/appl.conf.new
</source>
[[#documentazione|documentazione]].
copia qualche file di documentazione dai sorgenti. Se hai valorizzato la variabile DOCS e SLKFILES sopra non dovrebbero essere necessarie modifiche, a meno che i sorgenti non abbiano path speciali
<source lang="bash">
mkdir -p $PKG/usr/doc/$PKGNAME-$VERSION
cp -r $DOCS $PKG/usr/doc/$PKGNAME-$VERSION

mkdir -p $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild
cd $CWD
for SB in $PKGNAME.SlackBuild slack-desc doinst.sh doinst.sh.gz EULA.TXT $SLKFILES;do
[ -e $SB ]&&cp -r $SB $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild/$SB
done
</source>
compressione man pages
<source lang="bash">
if [ -d $PKG/usr/man ]; then
( cd $PKG/usr/man
find . -type f -exec gzip -9 {} \;
for i in $( find . -type l ) ; do ln -s $( readlink $i ).gz $i.gz ; rm $i ; done
)
fi
</source>
[[#strip|strip]]. Strip dei file binari
<source lang="bash">
( cd $PKG
find . | xargs file | grep "executable" | grep ELF | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
find . | xargs file | grep "shared object" | grep ELF | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
find . | xargs file | grep "current ar archive" | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
)
</source>
[[#slack-desc e doinst.sh|slack-desc e doinst.sh]]
<source lang="bash">
mkdir -p $PKG/install
cat $CWD/slack-desc > $PKG/install/slack-desc
[ -e $CWD/doinst.sh ] && cat $CWD/doinst.sh > $PKG/install/doinst.sh
[ -e $CWD/doinst.sh.gz ] && zcat $CWD/doinst.sh.gz > $PKG/install/doinst.sh
</source>
[[#slack-required|slack-required]] e [[#costruzione pacchetto|costruzione pacchetto]].
Lancia requiredbuilder per la gestione delle dipendenze. E' opportuno che questo sia installato nel sistema, ma comunque viene effettuato il controllo di esistenza.
<source lang="bash">
cd $PKG
chown -R root:root $PKG

if [ -x "$(which requiredbuilder 2>/dev/null)" ];then
requiredbuilder -y -v -s $CWD $PKG # add "-c -b" if you have binary files in /usr/share
[ -e install/slack-required ]&&cat install/slack-required > $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild/slack-required
fi

/sbin/makepkg -l y -c n $OUTPUT/$PKGNAME-$VERSION-$ARCH-$BUILD$TAG.${PKGTYPE:-txz}

if [ "$1" = "--cleanup" ]; then
rm -rf $TMP
fi
</source>
ovviamente eliminate tutte le parti che non interessano il vostro pacchetto. Questa è la base. Ogni pacchetto avrà le sue particolarità, ma la struttura dovrebbe comunque rimanere su questa linee. Più in basso trovate i dettagli dei significati delle singole sezione e cosa/come aggiungere o modificare allo script.

=== doinst.sh ===
<source lang="bash">
config() {
NEW="$1"
OLD="$(dirname $NEW)/$(basename $NEW .new)"
# If there's no config file by that name, mv it over:
if [ ! -r $OLD ]; then
mv $NEW $OLD
elif [ "$(cat $OLD | md5sum)" = "$(cat $NEW | md5sum)" ]; then
# toss the redundant copy
rm $NEW
fi
# Otherwise, we leave the .new copy for the admin to consider...
}
#if [ -e etc/rc.d/rc.script ]; then
# cp -a etc/rc.d/rc.script etc/rc.d/rc.script.new.incoming
# cat etc/rc.d/rc.script.new > etc/rc.d/rc.script.new.incoming
# mv etc/rc.d/rc.script.new.incoming etc/rc.d/rc.script.new
#fi
#config etc/rc.d/rc.script.new
#config etc/configfile.new

</source>
ovviamente '''eliminate''' tutte le parti che non interessano il vostro pacchetto. Se non avete file di configurazione eliminate anche tutta la prima parte. Più in basso trovate i dettagli dei significati delle singole sezione e cosa/come aggiungere o modificare allo script.

Si raccomanda di fare attenzione agli end-of-line all'ultima riga del file. Alcuni editor non lo inseriscono manualmente. Per verificare editate con '''vi''' e controllate se in fondo compare '''noeol'''. In tal caso è sufficiente risalvare il file con '''vi''' e il problema si risolve. Per essere comunque sicuri, lasciate sempre una riga vuota alla fine del file.

=== slack-desc ===
# HOW TO EDIT THIS FILE:
# The "handy ruler" below makes it easier to edit a package description. Line
# up the first '|' above the ':' following the base package name, and the '|' on
# the right side marks the last column you can put a character in. You must make
# exactly 11 lines for the formatting to be correct. It's also customary to
# leave one space after the ':'.

|-----handy-ruler------------------------------------------------------|
pkgname: pkgname - A title for package
pkgname:
pkgname: Long description
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
ricorda... esattamente 11 righe, e l'handy-ruler esattamente 72 caratteri. Dettagli più in basso.

Attenzione ai ^M. Se il file è stato editato in windows, è probabile che questi caratteri vengano inseriti a fine linea. Se usate '''vim''' notereste una dicitura '''dos''' in fondo. Altrimenti potete verificarlo con '''cat -A slack-desc'''. Per risistemare la situazione lanciare il comando "'''sed -i -e 's/^M//' slack-desc'''" in cui ^M non è il carattere ^ e M ma si ottiene premendo prima ctrl+V e poi ctrl+M
== Dettagli dei template ==
Poichè la compilazione dei software opensource nella maggior parte dei casi si compila con un sempilce "./configure&&make&&make install", nella grande maggioranza dei casi, sarà sufficiente effettuare piccole modifiche ai template di cui sopra (nome, versione, url e descrizione) per creare il pacchetto slacky.

Tuttavia quì presentiamo delle linee guida su come modificare i template per adattarlo ai pacchetti in cui non è sufficiente il template base.

Non potrò esaurire quì tutta la caseistica e la problematica che si può presentare, ma quanto descritto dovrebbe essere sufficiente per un buon numero di pacchetti.
=== SlackBuild ===
==== intestazione ====
* La shell da utilizzare è '''sempre''' ''/bin/sh''
* Specificare per quale versione di slackware è scritto lo SlackBuild
* L'autore dello SlackBuild. Potete mettere il nome o il nick, ma come contatto possibilmente mettete un indirizzo email (mio <at> indir.email). Se state ricompilando un pacchetto di terzi lasciate l'autore "così com'è" (in pratica, non "impossessatevi" dello slackbuild). Se lo slackbuild originale non è slacky, molto probabilmente il formato della intestazione sarà diverso; lasciatela così com'è ed inserite una nota di adattamento
* L'ultimo che l'ha modificato e compilato (ovvero tu)
* Il nome del pacchetto e il sito ufficiale
* Una licenza per la distribuzione dello slackbuild
* Eventuale inserimento delle dipendenze extra, esempio quelle non rilevate da requiredbuilder e quelle che fanno parte degli extra di Slackware. Queste non verranno inserite nel file required ma servono solo per agevolare i fruitori dello SlackBuild.
<source lang="bash">
#!/bin/sh

# Heavily based on the Slackware 14.0 SlackBuild

# Written by <your name> ( your [at] email.address )
# Last build from <your name> ( your [at] email.address )

# Slackware build script for <appname>
# Official Site: http://......

# Redistribution and use of this script, with or without modification, is
# permitted provided that the following conditions are met:
#
# 1. Redistributions of this script must retain the above copyright
# notice, this list of conditions and the following disclaimer.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

# Require: apache-ant, jdk >= 6 | openjdk >= 6
</source>
di terzi:
<source lang="bash">
#!/bin/sh

# Heavily based on the Slackware 14.0 SlackBuild
# Copyright 2009, 2010, 2011, 2012 Eric Hameleers, Eindhoven, NL
# Copyright 2009, 2010, 2011, 2012 Patrick J. Volkerding, Sebeka, MN, USA
# All rights reserved.

# Written by Eric Hameleers < alien at slackware.com >
# Adapted to slacky's standard by <your name> ( your [at] email.address )

# Slackware build script for <appname>
# Official Site: http://......
# Patches from ...

# Redistribution and use of this script, with or without modification, is
# permitted provided that the following conditions are met:
#
# 1. Redistributions of this script must retain the above copyright
# notice, this list of conditions and the following disclaimer.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ''AS IS'' AND ANY EXPRESS OR IMPLIED
# WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
# MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
# EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
# OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

# Require: apache-ant, jdk >= 6 | openjdk >= 6
</source>
==== parametri di base ====
La seguente sezione è quella che contiene i parametri base, cioè il nome del pacchetto, la versione, l'architettura, la build version, l'url diretto da dove scaricare i sorgenti, la documentazione da copiare in /usr/doc e i file presenti nella directory dello slackbuild. Per quanto riguarda il BUILD, la norma è che ad ogni modifica del pacchetto, ricompilazione ecc, il numero va incrementato, mentre all'upgrade (cambio di versione) questo numero ritorna ad 1. Per quanto riguarda il TAG (la sigla dopo il numero), a partire dal repository per Slackware 13.1 questo deve essere obbligatoriamente 'sl', inclusi per i pacchetti già presenti nel 13.0 che verranno semplicemente ricompilati senza modifiche per essere portati nel nuovo repository. Questo perchè ora la sigla non indica più l'autore ma il repository su cui si trova.

Per l'url utilizzate esclusivamente il sito ufficiale del prodotto. Occhio ai doppi apici in SOURCE= . Spesso funziona anche senza ma in qualche caso può succedere un casino. Fate anche attenzione a quegli url che come separatore non hanno un trattino bensì un underscore ('''_''') pechè in tal caso la sintassi $PKGNAME_$VERSION non funziona, visto che bash considera quell'underscore come parte del nome della variabile. In tal caso sostituite $PKGNAME con ${PKGNAME}: ${PKGNAME}_${VERSION}.

In DOC mettete la documentazione che verrà copiata nella /usr/doc, quella presente nella radice del sorgente, per capirci (README, INSTALL, ecc..); sono ammessi nomi di directory (per chiarezza mettiamoci una / finale, per esempio doc/, anche se in teoria non serve. Sono accettati i caratteri jolly supportati da cp (README* per esempio).

<source lang="bash">
set -e

PKGNAME=appname
VERSION=${VERSION:-1.4.1}
BUILD=${BUILD:-1}
TAG=${TAG:-sl}
ARCH=${ARCH:-i486}
</source>
Nel nuovo template il nome del tar file scaricato viene riconosciuto in automatico con un ''basename'' del sorgente, quindi non è necessario modificare wget e tar se si cambia formato di compressione o se il nome usa _ invece di - o altro. Il primo livello di directory del tar viene calcolato automaticamente essere 'nome tarfile' senza tar.gz . In questi casi lasciare DIR e TAR vuote.
<source lang="bash">
SOURCE="http://downloads.sourceforge.net/project/......./${PKGNAME}-${VERSION}/${PKGNAME}-${VERSION}.tar.gz"
TAR= # empty = auto
DIR= # empty = auto
</source>
In caso una di queste due asserzioni non è vera, non è necessario andare a modificare tutto il resto dello SB (if [ ! -e , wget, tar, cd, eventuale altre parti), ma è sufficente modificare le variabili TAR e DIR.
<source lang="bash">
SOURCE="http://downloads.sourceforge.net/project/......./${PKGNAME}/${PKGNAME}_${VERSION}.tar.bz2?download"
TAR=${PKGNAME}_${VERSION}.tar.bz2 # empty = auto
DIR=${PKGNAME}${VERSION} # empty = auto
</source>

In SLKFILES vanno messi tutti i file che si trovano nella directory dello slackbuild così questi verranno copiati automaticamente in /usr/doc/pacchetto-versione/Slackbuild. Tale variabile non deve contenere lo slackbuild stesso, slack-desc, slack-required, doinst.sh, doinst.sh.gz, EULA.TXT in quanto lo slackbuild del template è in grado di rilevarli e copiarli automaticamente. Eccettuate anche i sorgenti scaricati dalla wget. Inserite invece eventuali patch, file di configurazione custom ecc..; per capirci, tutto quello che viene caricato poi su slacky deve essere presente in quella variabile. In caso non hai file aggiuntivi potete lasciarla vuota.
<source lang="bash">
DOCS="AUTHORS COPYING INSTALL TODO TROUBLESHOOTING docs/"
SLKFILES="makefile.diff myfile.conf"
</source>

NON ponete la variabile JOBS in questa sezione; quella è inserita più avanti, tra i parametri fissi.

==== EULA ====
Nel caso si tratta di un software non OpenSource, o che per la sua distribuzione è necessario l'accettazione di una licenza, prendere il file di licenza dai sorgenti (solitamente LICENSE.TXT o simili) e metterla nella directory dello SlackBuild con nome EULA.TXT.
La seguente sezione provvederà, se presente, a mostrare la EULA a schermo e a chiedere all'utente di accettarla.
<source lang="bash">
if [ -e EULA.TXT ];then
more EULA.TXT
echo "Do you accept terms? (yes/[no])"
read ACCEPT
if [ "$ACCEPT" != "yes" ];then
echo; echo "SlackBuild Aborted!!"
exit 1
fi
fi
</source>
Questa sezione può essere lasciata anche in caso di software OpenSource. Se non è presente EULA.TXT verrà ignorata.
==== path di lavoro ====
Questa parte è fissa, cioè la determinazione dei path di lavoro. Molto difficilmente dovrete variare qualcosa. Se la directory dei sorgenti non è $PKGNAME-$VERSION utilizzate le variabili TAR e DIR precedenti.
<source lang="bash">
JOBS=${JOBS:--j2}
CWD=$(pwd)
TMP=${TMP:-/tmp/buildpkgs/$PKGNAME}
PKG=$TMP/package-$PKGNAME
OUTPUT=${OUTPUT:-$CWD}
TAR=${TAR:-$(basename $SOURCE)}
DIR=${DIR:-$(echo "$TAR"|sed -r 's/(\.tar|)(.gz|.bz2|.xz|)$//')}
</source>
JOBS è la variabile che determina il numero di processi paralleli per compilare (make -j2 per capirci). Non variamo questo valore. Se avete un processore potente e volete compilare veloce potete fare l'override locale quando lanciate lo slackbuild:
export JOBS=-j7
./package.SlackBuild
o
JOBS=-j7 ./package.SlackBuild
==== download ====
Quindi si fa il download del pacchetto. Modificare solamente se si necessitano cose particolari, per esempio altri tipi di download, download di più file o patch...
<source lang="bash">
if [ ! -e "$CWD/$TAR" ];then
wget "$SOURCE" -O "$CWD/$TAR"
fi
</source>
==== architettura ====
In base all'architettura definita in $ARCH, vengono definiti i parametri della compilazione. Da notare il LIBDIRSUFFIX che determina se le librerie andranno a finire in /usr/lib o /usr/lib64
<source lang="bash">
CHOST="i486"
if [ "$ARCH" = "i486" ]; then
SLKCFLAGS="-O2 -march=i486 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "i586" ]; then
SLKCFLAGS="-O2 -march=i586 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "i686" ]; then
SLKCFLAGS="-O2 -march=i686 -mtune=i686"
LIBDIRSUFFIX=""
elif [ "$ARCH" = "x86_64" ]; then
SLKCFLAGS="-O2 -fPIC"
LIBDIRSUFFIX="64"
CHOST="x86_64"
fi
</source>

==== preparazione dei sorgenti ====
Segue la:
* rimozione di una compilazione precedente
* scompattazione dei sorgenti
* applicazione di eventuali patch; queste devono essere presenti nella stessa directory dello SlackBuild e possono essere facoltativamente compresse.
* settaggio dei permessi. E' opportuno che i permessi dei sorgenti siano solamente 755 o 644 e che i file siano tutti di root.
<source lang="bash">
rm -rf $TMP
mkdir -p $TMP $PKG $OUTPUT

cd $TMP
tar xvf $CWD/$TAR
cd $DIR

# patch -p1 < $CWD/some_patch.diff
# zcat $CWD/compressed_patch.diff.gz |patch -p1

chown -R root:root .
chmod -R u+w,go+r-w,a-s .
</source>
==== compilazione ====
Comincia la compilazione. Nella maggior parte dei casi sarà sufficiente utilizzare lo standard ./configure&&make&&make install.

Per quanto ri guarda i parametri del '''configure''', questi variano ovviamente da pacchetto a pacchetto, ma alcuni standard vanno seguiti:
* Il pacchetto va installato in /usr
* La configurazione deve andare in /etc
* Le man pages vanno in /usr/man. Se l'installer le mette in /usr/share/man allora bisogna spostarle successivamente.
* I dati andrebbero messi in /var/nomepacchetto o /var/lib/nomepacchetto, a seconda del pacchetto. P.E. apache li mette in /var/www, mysql li mette in /var/lib/mysql
* Le ''librerie'' (questo è importante) vanno messe in /usr/lib per i pacchetti a 32bit e in /usr/lib64 per i pacchetti a 64bit. Questo viene fatto automaticamente se si mette correttamente ''--libdir=/usr/lib$LIBDIRSUFFIX'' e sopra viene definito LIBDIRSUFFIX a seconda dell'architettura. Se avete una macchina a 32bit e scrivete solamente pacchetti a 32bit, lasciate comunque questa accortezza per aiutare chi vorrà compilare il pacchetto a 64bit
* In aggiunta metterete tutte le altre opzioni specifiche del software.
* Per passare parametri a make (tipo "-j2" per ottimizzare la velocità, e altro), non mettetelo quì (scrivendo make -j2), ma utilizzate la variabile JOBS da fuori lo slackbuild come spiegato poco sopra.
<source lang="bash">
CFLAGS="$SLKCFLAGS" \
CXXFLAGS="$SLKCFLAGS" \
./configure \
--prefix=/usr \
--libdir=/usr/lib$LIBDIRSUFFIX \
--sysconfdir=/etc \
--localstatedir=/var \
--mandir=/usr/man \
--build=$CHOST-slackware-linux
make $JOBS
make install DESTDIR=$PKG
</source>
==== cmake ====
Alcuni pacchetti per essere compilati necessitano di ''cmake'' anzichè ''./configure''. In tal caso valgono comunque tutte le considerazioni fatte sopra, ma la sintassi è diversa:
<source lang="bash">
( mkdir -p build
cd build
cmake .. \
-DCMAKE_C_FLAGS:STRING="$SLKCFLAGS" \
-DCMAKE_CXX_FLAGS:STRING="$SLKCFLAGS" \
-DCMAKE_INSTALL_PREFIX=/usr \
-DMAN_INSTALL_DIR=/usr/man \
-DSYSCONF_INSTALL_DIR=/etc \
-DLIB_SUFFIX=${LIBDIRSUFFIX}
make
make install DESTDIR=$PKG)
</source>
==== personalizzazione ====
Le sezioni che seguono sono quelle che probabilmente più dovrete personalizzare. Quì si devono cancellare file inutili o che rischiano di sovrascrivere quelli di sistema, spostare alcuni file in altri path ecc.
<source lang="bash">
## Do special operations
</source>
Se avete compilato un modulo perl, probabilmete vi sarà stato creato un file che, se messo nel pacchetto, va a sostiturire quello già presente sul sistema. Ovviamente se non state compilando un modulo perl non inserirete questa sezione.
<source lang="bash">
( cd $PKG
# Remove 'special' files
find . -name perllocal.pod \
-o -name ".packlist" \
-o -name "*.bs" \
| xargs rm -f
)
</source>
Potrete anche copiare file di configurazione ed eventuali altri file dalla directory dello SlackBuild.

Ricordate poi che gli script di start e stop si dovrebbero mettere possibilmente sotto /etc/rc.d; ricordo anche che tutti i file di configurazione (script inclusi) vanno messi con l'estensione ''.new'' per essere poi rinominati a posteriori nel '''doinst.sh'''..
<source lang="bash">
cat $CWD/rc.application.sh > $PKG/etc/rc.d/rc.application.new
cat $PKG/etc/init.d/initscript >> $PKG/etc/rc.d/rc.program.new
rm $PKG/etc/init.d/initscript
mv $PKG/etc/appl.conf $PKG/etc/appl.conf.new
</source>
==== documentazione ====
Inoltre copiamo tutta la documentazione che riusciamo a trovare nei sorgenti del pacchetto (README, INSTALL, ChangeLog, ecc..) nella directory della documentazione. Tutti questi file li mettiamo nella variabile DOCS come spiegato sopra. Nella sottodirectory SlackBuild/ ci metteremo anche lo SlackBuild con cui è stato generato il pacchetto e gli altri file (vedi parametro SLKFILES).
Se valorizzate correttamente queste due variabili non dovrebbe essere necessario fare altre modifiche a questa sezione (a meno di situazioni particolari, come di documentazioni prese da sottodirectory o rianalizzate o altro)
<source lang="bash">
mkdir -p $PKG/usr/doc/$PKGNAME-$VERSION
cp -r $DOCS $PKG/usr/doc/$PKGNAME-$VERSION

mkdir -p $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild
cd $CWD
for SB in $PKGNAME.SlackBuild slack-desc doinst.sh doinst.sh.gz EULA.TXT $SLKFILES;do
[ -e $SB ]&&cp -r $SB $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild/$SB
done
</source>
Lo standard di slackware è che tutte le manpages siano compresse con gzip; di conseguenza cerchiamo versioni non compresse che installano i pacchetti e comprimiamole.
<source lang="bash">
if [ -d $PKG/usr/man ]; then
( cd $PKG/usr/man
find . -type f -exec gzip -9 {} \;
for i in $( find . -type l ) ; do ln -s $( readlink $i ).gz $i.gz ; rm $i ; done
)
fi
</source>
==== strip ====
Puliamo anche i file binari e le librerie eliminando tutti gli strascichi che lascia gcc al fine di debuggure e linkare tra di loro gli object generati.
<source lang="bash">
( cd $PKG
find . | xargs file | grep "executable" | grep ELF | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
find . | xargs file | grep "shared object" | grep ELF | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
find . | xargs file | grep "current ar archive" | cut -f 1 -d : | xargs -r strip --strip-unneeded 2> /dev/null || true
)
</source>
==== slack-desc e doinst.sh ====
Abbiamo quasi finito... Popoliamo la directory install/ del pacchetto. Quì ci andrà lo slack-desc e, se necessario, il doinst.sh. Con l'attuale template non è più necessario aggiungere manualmente la riga del doinst, perchè viene cercato e copiato solo se esiste. Quindi non eliminiamo tale linea. Facoltativamente potete mettere il doinst.sh gzippato.
<source lang="bash">
mkdir -p $PKG/install
cat $CWD/slack-desc > $PKG/install/slack-desc
[ -e $CWD/doinst.sh ] && cat $CWD/doinst.sh > $PKG/install/doinst.sh
[ -e $CWD/doinst.sh.gz ] && zcat $CWD/doinst.sh.gz > $PKG/install/doinst.sh
</source>
Possibilmente il doinst.sh non lo creiamo direttamente dentro lo SlackBuild, ma mettiamolo come file esterno per poi copiarlo nella directory install/. Se poi abbiamo bisogno di aggiungere operazioni di cui non sappiamo a priori le specifiche, ma le sappiamo solo dopo la compilazione, allora aggiungiamole da dentro lo SlackBuild con un >>. Un esempio di operazione necessaria è quella di avviare uno script di postinstallazione presente sotto la /usr/lib; ovviamente non sappiamo a priori se sarà in /usr/lib o /usr/lib64.
<source lang="bash">
[ -e $CWD/doinst.sh ] && cat $CWD/doinst.sh > $PKG/install/doinst.sh
echo "( cd usr/lib$LIBDIRSUFFIX/$PKGNAME ; ./postinstall.sh )" >> $PKG/install/doinst.sh
</source>
==== slack-required ====
Ora andiamo a costruire il file delle dipendenze ''slack-required''. Questo si genera con il tool '''requiredbuilder'''. Ricordiamoci di installare sempre l'ultima versione di questo tool prima di compilare.
Dovremo anche assicurarci che i file del pacchetto siano tutti di root, poi lanciamo il requiredbuilder per costruire le dipendenze e finalmente creiamo il pacchetto.
<source lang="bash">
cd $PKG
chown -R root:root $PKG

if [ -x "$(which requiredbuilder 2>/dev/null)" ];then
requiredbuilder -y -v -s $CWD $PKG # add "-c -b" if you have binary files in /usr/share
[ -e install/slack-required ]&&cat install/slack-required > $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild/slack-required
fi
</source>
Se il nostro pacchetto genera binari in /usr/share aggiungiamo anche il -c -b come parametri perchè per default non vengono cercate dipendenze su questo path. Se sappiamo che il nostro pacchetto necessita di qualche dipendenza che non può essere intercettata da requiredbuilder perchè non supportata, utilizziamo la variabile ADD:
<source lang="bash">
if [ -x "$(which requiredbuilder 2>/dev/null)" ];then
ADD="$(cd /var/log/packages;ls apache-ant-1*|sed -r 's/apache-ant-/apache-ant >= /')" \
requiredbuilder -y -v -s $CWD $PKG # add "-c -b" if you have binary files in /usr/share
[ -e install/slack-required ]&&cat install/slack-required > $PKG/usr/doc/$PKGNAME-$VERSION/SlackBuild/slack-required
fi
</source>
==== costruzione pacchetto ====
Finalmente abbiamo finito. Possiamo costruire il nostro pacchetto.
<source lang="bash">
/sbin/makepkg -l y -c n $OUTPUT/$PKGNAME-$VERSION-$ARCH-$BUILD$TAG.${PKGTYPE:-txz}
</source>
Se poi il pacchettizzatore è sicuro che andrà tutto a buon fine, si può decidere di lanciare lo slackbuild con il parametro --cleanup per rimuovere le directory di lavoro al termine del processo.
<source lang="bash">
if [ "$1" = "--cleanup" ]; then
rm -rf $TMP
fi
</source>
=== doinst.sh ===
Il doinst.sh viene utilizzato per effettuare tutte quelle operazioni che provvederanno ad integrare il pacchetto nel resto della distribuzione. Per esempi tipici di doinst.sh vedi la directory /var/log/scripts che è una raccolta dei doinst.sh di tutti i pacchetti installati sul sistema.

Ecco alcuni usi:
==== rinomina file di configurazione .new ====
Questo forse è l'uso maggiore per cui si crea un doinst.sh.

Quando nello SlackBuild abbiamo creato un file tipo ''etc/configfile.new'', il doinst deve provvedere a rinominarlo in ''etc/configfile'' a patto che quest'ultimo non esista già sul sistema. Nello script viene definita una funzione, config (da non toccare), che fa questo lavoro. Al pacchettizzatore è sufficente richiamala con ''config etc/configfile.new''. Utilizzate i path relativi!!
<source lang="bash">
config() {
NEW="$1"
OLD="$(dirname $NEW)/$(basename $NEW .new)"
# If there's no config file by that name, mv it over:
if [ ! -r $OLD ]; then
mv $NEW $OLD
elif [ "$(cat $OLD | md5sum)" = "$(cat $NEW | md5sum)" ]; then
# toss the redundant copy
rm $NEW
fi
# Otherwise, we leave the .new copy for the admin to consider...
}

config etc/configfile.new
config etc/program/my.conf.new
</source>
==== gli script di start ====
Per gli script in rc invece va fatta una aggiunta; infatti se un file rc con lo stesso nome già esiste, allora è necessario che abbiano gli stessi permessi. Questo si fa così:
<source lang="bash">
if [ -e etc/rc.d/rc.script ]; then
cp -a etc/rc.d/rc.script etc/rc.d/rc.script.new.incoming
cat etc/rc.d/rc.script.new > etc/rc.d/rc.script.new.incoming
mv etc/rc.d/rc.script.new.incoming etc/rc.d/rc.script.new
fi

config etc/rc.d/rc.script.new
</source>
==== i link ====
Se lo SlackBuild ha creato dei link, con ln o con make install, questi non verranno inseriti nel txz finale. Al posto loro verrà messa nel doinst.sh una riga per ogni link che provvederà a crearlo in fase di postinstallazione. A fare questa operazione ci penserà makepkg che per ogni link che trova metterà una cosa del genere nel doinst.sh:
<source lang="bash">
( cd usr/bin ; rm -rf view )
( cd usr/bin ; ln -sf vim view )
</source>
quindi di questo non dovremo preoccuparci
==== file icona, menu, .desktop ecc ====
Quando si installano pacchetti per kde e/o si aggiungono nuove icone e/o file .desktop ecc.., è necessario aggiornare il database di kde.
<source lang="bash">
if [ -x /usr/bin/update-desktop-database ]; then
usr/bin/update-desktop-database -q usr/share/applications >/dev/null 2>&1
fi
if [ -x /usr/bin/update-mime-database ]; then
usr/bin/update-mime-database usr/share/mime >/dev/null 2>&1
fi
if [ -e usr/share/icons/hicolor/icon-theme.cache ]; then
if [ -x /usr/bin/gtk-update-icon-cache ]; then
usr/bin/gtk-update-icon-cache usr/share/icons/hicolor >/dev/null 2>&1
fi
fi
</source>
==== post-installazione personalizzata ====
Potrebbe essere necessario avviare qualche script di postinstallazione al termine del doinst. Se lo script non si trova nel path, allora solitamente si fa un 'cd directory' e './script'. Cerchiamo di utilizzare sempre percorsi relativi e mai assoluti perchè se stiamo installando in un chroot allora si rischia di incasinare il sistema principale
<source lang="bash">
( cd usr/share/programma ; ./postinstall.sh )
</source>
se il postinstall si trova sotto usr/lib, allora dobbiamo inserire questa riga dallo SlackBuild per determinare perchè non sappiamo a priori se utilizziamo una slackware a 32 o 64bit e quindi se lo script è in usr/lib o usr/lib64.
<source lang="bash">
echo "( cd usr/lib$LIBDIRSUFFIX ; ./postinstall.sh )" >> $PKG/install/doinst.sh
</source>
In caso lo script al suo interno faccia riferimento a percorsi assoluti del sistema, allora dovremo lanciare tale comando in chroot:
<source lang="bash">
chroot . usr/share/programma/postinstall.sh
</source>
==== utenti ====
Prima del '''makepkg''' abbiamo settato tutti i proprietari dei file a root. Se abbiamo qualche pacchetto che richiede di essere avviato come altro utente (p.e. squid) dovremo provvedere a creare l'utente e, se serve, anche il gruppo. Prima dovremo controllare però che già non esista. Ovviamente dovremo utilizzare useradd e groupadd che vanno a modificare l'/etc/passwd e l'/etc/group; si rende quindi necessario il lancio in chroot per evitare che si creino le utenze sul sistema sbagliato
<source lang="bash">
if ! grep -q "^nomegruppo:" etc/group; then
chroot . groupadd mygroup &>/dev/null
fi
if ! grep -q "^nomeutente:" etc/passwd; then
chroot . useradd -d /var/lib/nomeprogramma -s /bin/false -c "Utente programma" -g nomegruppo nomeutente &>/dev/null
fi
</source>
e poi settare i permessi adeguati, permessi che abbiamo tolto dallo slackbuild con chown root.root
<source lang="bash">
chown -R nomeutente.nomegruppo var/lib/nomeprogramma
</source>
==== utenti e id ====
Talvolta si potrebbe volere un determinato uid e gid per utenti e gruppi; uno useradd secco genera un id solitamente alto, che potrebbe confondersi con le utenze classiche mentre i servizi hanno spesso e volentieri id bassi. Vedi il corrente /etc/passwd. Nel modo seguente è possibile 'tentare' di scegliere un determinato id e, se fallisce, allora ripiegare su un id normale.
<source lang="bash">
if ! grep -q "^apache:" etc/group; then
if ! grep -q ":80:" etc/group; then
chroot . groupadd -g 80 apache &>/dev/null
else
chroot . groupadd apache &>/dev/null
fi
fi

if ! grep -q "^apache:" etc/passwd; then
if ! grep -q ":80:" etc/passwd; then
chroot . useradd -u 80 -d /var/www -s /bin/false -c "Apache User" -g apache apache &>/dev/null
else
chroot . useradd -d /var/www -s /bin/false -c "Apache User" -g apache apache &>/dev/null
fi
fi
chown apache.apache var/www/htdocs
</source>
=== slack-desc ===
Questo è più semplice. Si tratta di mettere una descrizione del pacchetto di un massimo di 11 righe e un massimo di 72 caratteri per riga. Personalmente prendo qualche riga dal README o dal sito ufficiale e lo copio lì dentro. Come esempi di descrizione si possono prendere tutti quelli di slackware.

La struttura di questo file è molto rigida. Le prime 6 righe sono solo commenti (le istruzioni per costruire lo slack-desc, ma vanno lasciate. La riga successiva, la ''handy-ruler'', è un '''remember''' sul numero limite di caratteri per riga, questo confine è di 71 caratteri dopo i due punti. La descrizione è fatta di ''esattamente'' 11 righe (se ne vuoi di meno basta lasciarle vuote) composte di nomepacchetto, due punti, spazio, descrizione. La riga vuota non prevede lo spazio dopo i due punti. Il nome del pacchetto deve essere esattamente lo stesso indicato in $PKGNAME

Non deve essere inserito il nome del pacchettizzatore né l'url del programma.
# HOW TO EDIT THIS FILE:
# The "handy ruler" below makes it easier to edit a package description. Line
# up the first '|' above the ':' following the base package name, and the '|'
# on the right side marks the last column you can put a character in. You must
# make exactly 11 lines for the formatting to be correct. It's also
# customary to leave one space after the ':'.

|-----handy-ruler------------------------------------------------------|
pkgname: pkgname - A title for package
pkgname:
pkgname: Long description Long description Long description Long description
pkgname: Long description Long description Long description Long description
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:
pkgname:

== Conclusioni ==
Con tutti gli esempi presentati non pretendo di aver esaurito tutta la casistica, ma dovrebbe essere sufficiente per molti pacchetti.