diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:40:31 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 09:40:31 +0000 |
commit | b86570f63e533abcbcb97c2572e0e5732a96307b (patch) | |
tree | cabc83be691530ae685c45a8bc7620ccc0e1ebdf /man/it/dpkg-maintscript-helper.pod | |
parent | Initial commit. (diff) | |
download | dpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.tar.xz dpkg-b86570f63e533abcbcb97c2572e0e5732a96307b.zip |
Adding upstream version 1.20.13.upstream/1.20.13upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/it/dpkg-maintscript-helper.pod')
-rw-r--r-- | man/it/dpkg-maintscript-helper.pod | 333 |
1 files changed, 333 insertions, 0 deletions
diff --git a/man/it/dpkg-maintscript-helper.pod b/man/it/dpkg-maintscript-helper.pod new file mode 100644 index 0000000..0c4854f --- /dev/null +++ b/man/it/dpkg-maintscript-helper.pod @@ -0,0 +1,333 @@ + + ***************************************************** + * GENERATED FILE, DO NOT EDIT * + * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION * + ***************************************************** + +This file was generated by po4a(7). Do not store it (in VCS, for example), +but store the PO file used as source file by po4a-translate. + +In fact, consider this as a binary, and the PO file as a regular .c file: +If the PO get lost, keeping this translation up-to-date will be harder. + +=encoding UTF-8 + +=head1 NOME + +dpkg-maintscript-helper - aggira limiti noti di dpkg negli script del +manutentore + +=head1 SINTASSI + +B<dpkg-maintscript-helper> I<comando> [I<parametro>...] B<--> +I<parametro-script-manut>... + +=head1 COMANDI E PARAMETRI + +=over + +=item B<supports> I<comando> + +=item B<rm_conffile> I<fileconf> [I<versione-prec> [I<pacchetto>]] + +=item B<mv_conffile> I<vecchio-fileconf> I<nuovo-fileconf> [I<versione-prec> +[I<pacchetto>]] + +=item B<symlink_to_dir> I<percorso> I<vecchia-destinaz> [I<versione-prec> +[I<pacchetto>]] + +=item B<dir_to_symlink> I<percorso> I<nuova-destinaz> [I<versione-prec> +[I<pacchetto>]] + +=back + +=head1 DESCRIZIONE + +Questo programma è progettato per essere eseguito dall'interno di script dei +manutentori per effettuare alcuni compiti che B<dpkg> non può (ancora) +gestire in modo nativo a causa di decisioni progettuali oppure per +limitazioni attuali. + +Molti di questi compiti richiedono azioni coordinate da parte di diversi +script dei manutentori (B<preinst>, B<postinst>, B<prerm>, B<postrm>). Per +evitare sbagli basta mettere la stessa chiamata in tutti gli script e il +programma adatterà automaticamente il suo comportamento sulla base della +variabile d'ambiente B<DPKG_MAINTSCRIPT_NAME> e sugli argomenti per gli +script dei manutentori che devono essere passati dopo un doppio trattino. + +=head1 PARAMETRI COMUNI + +=over + +=item I<versione-prec> + +Definisce la più recente versione del pacchetto il cui aggiornamento +dovrebbe attivare l'operazione. È importante calcolare correttamente il +valore di I<versione-prec> in modo che le operazioni siano effettuate in +modo corretto anche se l'utente ha ricompilato il pacchetto con una versione +locale. Se I<versione-prec> è vuota o viene omessa, allora l'operazione +viene tentata ad ogni aggiornamento (notare: è più sicuro fornire la +versione e far sì che l'operazione venga tentata una sola volta). + +Se il file di configurazione non è stato fornito per diverse versioni, e si +sta ora cercando di modificare gli script del manutentore per ripulire il +file obsoleto, I<versione-prec> dovrebbe essere basata sulla versione del +pacchetto che si sta preparando ora, non sulla prima versione del pacchetto +a cui mancava il file di configurazione. Ciò è vero similmente per tutte le +altre azioni. + +Per esempio, per un file di configurazione rimosso nella versione B<2.0-1> +di un pacchetto, I<versione-prec> dovrebbe essere impostata a B<2.0-1~>. Ciò +farà sì che il file di configurazione sia rimosso anche se l'utente ha +ricompilato la versione precedente B<1.0-1> come B<1.0-1local1>. Oppure un +pacchetto che passa un percorso da un collegamento simbolico (fornito nella +versione B<1.0-1>) ad una directory (fornita nella versione B<2.0-1>), ma +che effettua l'effettivo cambiamento nello script del manutentore nella +versione B<3.0-1>, dovrebbe impostare I<versione-prec> a B<3.0-1~>. + +=item B<pacchetto> + +The package name owning the pathname(s). When the package is “Multi-Arch: +same” this parameter must include the architecture qualifier, otherwise it +should B<not> usually include the architecture qualifier (as it would +disallow cross-grades, or switching from being architecture specific to +architecture B<all> or vice versa). If the parameter is empty or omitted, +the B<DPKG_MAINTSCRIPT_PACKAGE> and B<DPKG_MAINTSCRIPT_ARCH> environment +variables (as set by B<dpkg> when running the maintainer scripts) will be +used to generate an arch-qualified package name. + +=item B<--> + +Tutti i parametri degli script dei manutentori devono essere passati al +programma dopo B<-->. + +=back + +=head1 COMPITI RELATIVI AI FILE DI CONFIGURAZIONE + +Quando aggiorna un pacchetto, B<dpkg> non rimuoverà automaticamente un file +di configurazione (un file di configurazione per il quale B<dpkg> dovrebbe +preservare i cambiamenti dell'utente) se non è presente nella versione più +nuova. Ci sono due ragioni principali per questo comportamento. La prima è +che il file di configurazione potrebbe essere stato tolto per sbaglio e la +successiva versione potrebbe ripristinarlo e gli utenti non vorrebbero +vedere le proprie modifiche buttate al vento. La seconda è di permettere ai +pacchetti di transitare file da un file di configurazione mantenuto da dpkg +a un file mantenuto dagli script del manutentore del pacchetto, solitamente +con uno strumento come debconf o ucf. + +Ciò significa che se un pacchetto deve rinominare o rimuovere un file di +configurazione, deve farlo esplicitamente e B<dpkg-maintscript-helper> può +essere usato per implementare in modo pulito la cancellazione e lo +spostamento di file di configurazione all'interno di script dei manutentori. + +=head2 Rimozione di un file di configurazione + +Note: This can be replaced in most cases by the C<remove-on-upgrade> flag in +F<DEBIAN/conffiles> (since dpkg 1.20.6), see L<deb-conffiles(5)>. + +Se un file di configurazione viene completamente rimosso, dovrebbe essere +rimosso dal disco a meno che l'utente non l'abbia modificato. Se ci sono +modifiche locali, queste dovrebbero essere preservate. Se l'aggiornamento +del pacchetto fallisce, il file di configurazione appena reso obsoleto non +dovrebbe sparire. + +Tutto ciò è implementato mettendo il seguente frammento shell negli script +del manutentore B<preinst>, B<postinst> e B<postrm>. + +=over + +Z<> + dpkg-maintscript-helper rm_conffile \ + I<conffile> I<prior-version> I<package> -- "$@" + +=back + +I<fileconf> è il nome del file di configurazione da rimuovere. + +Attuale implementazione: in B<preinst>, controlla se il file di +configurazione è stato modificato e lo rinomina in +I<fileconf>B<.dpkg-remove> (se non modificato) o I<fileconf>B<.dpkg-backup> +(se modificato). In B<postinst>, quest'ultimo file viene rinominato in +I<fileconf>B<.dpkg-bak> e mantenuto per riferimento dato che contiene le +modifiche dell'utente ma il primo viene rimosso. Se l'aggiornamento del +pacchetto fallisce, B<postrm> reinstalla il file di configurazione +originale. Durante l'eliminazione completa, B<postrm> elimina anche il file +B<.dpkg-bak> fino ad allora preservato. + +=head2 Rinominare un file di configurazione + +Se un file di configurazione viene spostato da una posizione ad un'altra, è +necessario assicurarsi di spostare qualsiasi modifica fatta +dall'utente. Questo può sembrare a prima vista un semplice cambiamento dello +script B<preinst>, tuttavia ciò avrebbe come risultato che B<dpkg> +chiederebbe all'utente di approvare le modifiche al file di configurazione +anche se egli non ne è responsabile. + +Un cambio di nome pulito può essere implementato mettendo il seguente +frammento shell negli script del manutentore B<preinst>, B<postinst> e +B<postrm>. + +=over + +Z<> + dpkg-maintscript-helper mv_conffile \ + I<old-conffile> I<new-conffile> I<prior-version> I<package> -- "$@" + +=back + +I<vecchio-fileconf> e I<nuovo-fileconf> sono il nome vecchio e quello nuovo +del file di configurazione da rinominare. + +Attuale implementazione: B<preinst> controlla se il file di configurazione è +stato modificato; se lo è stato viene lasciato al suo posto altrimenti viene +rinominato in I<vecchio-fileconf>B<.dpkg-remove>. Durante la configurazione, +B<postinst> rimuove I<vecchio-fileconf>B<.dpkg-remove> e rinomina +I<vecchio-fileconf> in I<nuovo-fileconf> se I<vecchio-fileconf> è ancora +disponibile. In caso di aggiornamento o installazione falliti, B<postrm> +rinomina I<vecchio-fileconf>B<.dpkg-remove> nuovamente in +I<vecchio-fileconf>, se necessario. + +=head1 CAMBIAMENTI A COLLEGAMENTI SIMBOLICI E DIRECTORY + +Quando si aggiorna un pacchetto, B<dpkg> non modifica automaticamente un +collegamento simbolico in una directory o viceversa. Le retrocessioni di +versione non sono supportate e il percorso verrà lasciato come è. + +=head2 Passare da un collegamento simbolico ad una directory + +Se si passa da un collegamento simbolico ad una directory reale, è +necessario assicurarsi prima dello spacchettamento che il collegamento +simbolico venga rimosso. Ciò può sembrare a prima vista una semplice +modifica allo script B<preinst>, tuttavia ciò risulterebbe in alcuni +problemi nel caso di personalizzazioni locali dell'amministratore sul +collegamento simbolico o in caso di retrocessione del pacchetto. + +Un cambio di nome pulito può essere implementato mettendo il seguente +frammento shell negli script del manutentore B<preinst>, B<postinst> e +B<postrm>. + +=over + +Z<> + dpkg-maintscript-helper symlink_to_dir \ + I<pathname> I<old-target> I<prior-version> I<package> -- "$@" + +=back + +I<percorso> è il nome assoluto del vecchio collegamento simbolico (il +percorso sarà una directory al termine dell'installazione) e +I<vecchia-destinaz> è il nome della destinazione del vecchio collegamento +simbolico I<percorso>. Può essere sia assoluto sia relativo alla directory +che contiene I<percorso>. + +Attuale implementazione: B<preinst> controlla se il collegamento simbolico +esiste e punta a I<vecchia-destinaz>, se non è così allora viene lasciato al +suo posto, altrimenti viene rinominato in +I<percorso>B<.dpkg-backup>. Durante la configurazione B<postinst> rimuove +I<percorso>B<.dpkg-backup> se questo è ancora un collegamento simbolico. In +caso di aggiornamento o installazione falliti, B<postrm> rinomina +I<percorso>B<.dpkg-backup> nuovamente in I<percorso> se necessario. + +=head2 Passare da una directory a un collegamento simbolico + +Se si passa da una directory reale a un collegamento simbolico, è necessario +assicurarsi prima dello spacchettamento che la directory venga rimossa. Ciò +può sembrare a prima vista una semplice modifica allo script B<preinst>, +tuttavia ciò risulterebbe in alcuni problemi nel caso in cui la directory +contenga file di configurazione, nomi di percorso di proprietà di altri +pacchetti, nomi di percorso creati localmente, oppure in caso di +retrocessione del pacchetto. + +Un passaggio pulito può essere implementato mettendo il seguente frammento +shell negli script del manutentore B<preinst>, B<postinst> e B<postrm>. + +=over + +Z<> + dpkg-maintscript-helper dir_to_symlink \ + I<pathname> I<new-target> I<prior-version> I<package> -- "$@" + +=back + +I<percorso> è il nome assoluto della vecchia directory (il percorso sarà un +collegamento simbolico al termine dell'installazione) e I<nuova-destinaz> è +il nome del nuovo collegamento simbolico I<percorso>. Può essere sia +assoluto sia relativo alla directory che contiene I<percorso>. + +Attuale implementazione: B<preinst> controlla se la directory esiste, non +contiene file di configurazione, percorsi di proprietà di altri pacchetti o +percorsi creati localmente; se non è così è lasciata al suo posto, +altrimenti viene rinominata in I<percorso>B<.dpkg-backup> e viene creata una +nuova directory vuota chiamata I<percorso> marcata con un file in modo che +dpkg possa tenerne traccia. Durante la configurazione B<postinst> finisce il +passaggio se I<percorso>B<.dpkg-backup> è ancora una directory e I<percorso> +è la directory contrassegnata; rimuove il file che contrassegna la +directory, muove i file appena creati all'interno della directory +contrassegnata nella destinazione del collegamento simbolico +I<nuova-destinaz>/, sostituisce la directory contrassegnata I<percorso> ora +vuota con un collegamento simbolico a I<nuova-destinaz> e rimuove +I<percorso>B<.dpkg-backup>. in caso di aggiornamento o installazione +falliti, B<postrm> rinomina I<percorso>B<.dpkg-backup> nuovamente in +I<percorso> se necessario. + +=head1 INTEGRAZIONE NEI PACCHETTI + +Quando si usa uno strumento di aiuto alla pacchettizzazione, controllare se +ha l'integrazione nativa con B<dpkg-maintscript-helper>, che può rendere la +vita più semplice. Vedere ad esempio B<dh_installdeb>(1). + +Dato che B<dpkg-maintscript-helper> viene usato in B<preinst>, il suo uso +incondizionato richiede una pre-dipendenza per assicurare che sia stata già +spacchettata la versione richiesta di B<dpkg>. La versione richiesta dipende +dal comando usato: per B<rm_conffile> e B<mv_conffile> è 1.15.7.2, per +B<symlink_to_dir> e B<dir_to_symlink> è 1.17.14: + +=over + + Pre-Depends: dpkg (>= 1.17.14) + +=back + +In molti casi però l'operazione effettuata dal programma non è critica per +il pacchetto e invece di usare una pre-dipendenza si può chiamare il +programma solo se si sa che il comando richiesto è supportato dalla versione +di B<dpkg> attualmente installata: + +=over + +Z<> + if dpkg-maintscript-helper supports I<command>; then + dpkg-maintscript-helper I<command> ... + fi + +=back + +Il comando B<supports> restituisce 0 in caso di successo e 1 altrimenti. Il +comando B<supports> controlla se le variabili d'ambiente impostate da dpkg e +richiesta dallo script sono presenti e considera un fallimento se l'ambiente +non è sufficiente. + +=head1 AMBIENTE + +=over + +=item B<DPKG_ROOT> + +If set, it will be used as the filesystem root directory. + +=item B<DPKG_ADMINDIR> + +If set, it will be used as the B<dpkg> data directory. + +=item B<DPKG_COLORS> + +Sets the color mode (since dpkg 1.19.1). The currently accepted values are: +B<auto> (default), B<always> and B<never>. + +=back + +=head1 VEDERE ANCHE + +B<dh_installdeb>(1). + |