diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 00:45:20 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 00:45:20 +0000 |
commit | 9a08cbfcc1ef900a04580f35afe2a4592d7d6030 (patch) | |
tree | 004cc7027bca2f2c0bcb5806527c8e0c48df2d6e /man/sv/dpkg-maintscript-helper.man | |
parent | Initial commit. (diff) | |
download | dpkg-upstream.tar.xz dpkg-upstream.zip |
Adding upstream version 1.19.8.upstream/1.19.8upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man/sv/dpkg-maintscript-helper.man')
-rw-r--r-- | man/sv/dpkg-maintscript-helper.man | 267 |
1 files changed, 267 insertions, 0 deletions
diff --git a/man/sv/dpkg-maintscript-helper.man b/man/sv/dpkg-maintscript-helper.man new file mode 100644 index 0000000..7264cb3 --- /dev/null +++ b/man/sv/dpkg-maintscript-helper.man @@ -0,0 +1,267 @@ +.\" dpkg manual page - dpkg-maintscript-helper(1) +.\" +.\" Copyright © 2010-2012 Raphaël Hertzog <hertzog@debian.org> +.\" Copyright © 2011-2015 Guillem Jover <guillem@debian.org> +.\" +.\" This is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.\" This is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see <https://www.gnu.org/licenses/>. +. +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.TH dpkg\-maintscript\-helper 1 %RELEASE_DATE% %VERSION% Dpkg\-sviten +.nh +.SH NAMN +dpkg\-maintscript\-helper \- går runt kända dpkg\-begränsningar i paketskript +. +.SH SYNOPS +\fBdpkg\-maintscript\-helper\fP \fIkommando\fP [\fIflagga\fP...] \fB\-\-\fP +\fImaint\-script\-flagga\fP... +. +.SH "KOMMANDON OCH PARAMETRAR" +.P +\fBsupports\fP \fIkommando\fP +.P +\fBrm_conffile\fP \fIkonffil\fP [\fItidigare\-version\fP [\fIpaket\fP]] +.P +\fBmv_conffile\fP \fIgammalkonffil\fP \fInykonffil\fP [\fItidigare\-version\fP +[\fIpaket\fP]] +.P +\fBsymlink_to_dir\fP \fIsökväg\fP \fIgammalt\-mål\fP [\fItidigare\-version\fP [\fIpaket\fP]] +.P +\fBdir_to_symlink\fP \fIsökväg\fP \fInytt\-mål\fP [\fItidigare\-version\fP [\fIpaket\fP]] +. +.SH BESKRIVNING +.P +Programmet skrevs för att köras i paketskript för att utföra en del åtgärder +som \fBdpkg\fP (ännu) inte själv kan hantera, antingen på grund av designval +eller på grund av nuvarande begränsningar. +.P +Många av dessa åtgärder kräver samordnade åtgärder från flera paketskript +(\fBpreint\fP, \fBpostinst\fP, \fBprerm\fP, \fBpostrm\fP). För att undvika misstag +räcker det att lägga in ett och samma anrop i alla skript, varpå programmet +anpassar sitt beteende beroende på miljövariabeln \fBDPKG_MAINTSCRIPT_NAME\fP +och på paketskriptets parametrar, vilka du måste vidaresända efter dubbla +bindestreck. +. +.SH "DELADE PARAMETRAR" +.TP +\fItidigare\-version\fP +Anger den senaste version av paketet vars uppgradering skall orsaka +händelsen. Det är viktigt att beräkna \fItidigare\-version\fP korrekt så att +operationerna utförs korrekt även om användaren byggt om paketet med en +lokal version. Om \fItidigare\-version\fP är tom eller utelämnas försöks +operationen vid varje uppgradering (notera: det är säkrare att ange +versionen och endast försöka utföra operationen en gång). + +Om konffilen inte har sänts med i flera versioner och du nu uppdaterar +utvecklarskripten till att städa bort den gamla filen bör +\fItidigare\-version\fP baseras på den version av paketet du nu förbereder, inte +den första version av paketet som saknade konffilen. Detta gäller på samma +sätt för alla andra åtgärder. + +Som ett exempel, för en konffil som togs bort i version \fB2.0\-1\fP av ett +paket bör \fItidigareversion\fP sättas till \fB2.0\-1~\fP. Detta får konffilen att +tas bort även om användaren bygger om den tidigare versionen \fB1.0\-1\fP som +\fB1.0\-1local1\fP. Eller ett paket som bytt en sökväg från att vara en +symbolisk länk (skeppad i version \fB1.0\-1\fP) till en katalog (skeppad i +version \fB2.0\-1\fP), men bara utfört själva ändringen i utvecklarskripten i +version \fB3.0\-1\fP, bör sätta \fItidigareversion\fP till \fB3.0\-1~\fP. +.TP +\fIpaket\fP +The package name owning the pathname(s). When the package is “Multi\-Arch: +same” this parameter must include the architecture qualifier, otherwise it +should \fBnot\fP usually include the architecture qualifier (as it would +disallow cross\-grades, or switching from being architecture specific to +architecture \fBall\fP or vice versa). If the parameter is empty or omitted, +the \fBDPKG_MAINTSCRIPT_PACKAGE\fP and \fBDPKG_MAINTSCRIPT_ARCH\fP environment +variables (as set by \fBdpkg\fP when running the maintainer scripts) will be +used to generate an arch\-qualified package name. +.TP +\fB\-\-\fP +Alla parametrar till utvecklarskripten måste vidaresändas till programmen +efter \fB\-\-\fP. +.SH "KONFFIL\-RELATERADE ÅTGÄRDER" +.P +När ett paket uppgraderas kommer \fBdpkg\fP inte att automatiskt ta bort en +konffil (en konfigurationsfil för vilken \fBdpkg\fP skall behålla användarens +ändringar) om den inte finns i den nya versionen. Det finns två +grundläggande skäl till detta; den första är att konffilen kan ha tappats av +misstag och nästa version kan komma att återställa den, varpå användaren +inte vill tappa sina ändringar. Den andra är att för att göra det möjligt +för paket att gå över från en dpkg\-hanterad konffil till en fil som hanteras +av paketets skript, vanligtvis genom ett verktyg som debconf eller ucf. +.P +Det innebär att, om paketet menar att byta namn eller ta bort en +konfigurationsfil, så måste det göra så explicit, och då kan +\fBdpkg\-maintscript\-helper\fP användas för att implementera en elegant +borttagning och flyttning av konffiler i paketscripten. +. +.SS "Ta bort en konffil" +.P +Om en konffil helt tas bort bör den tas bort från disk, såvida inte +användaren har modifierat den. Om det finns lokala ändringar bör de +bibehållas. Om paketuppgraderingen avbryts bör inte konffilen som just blev +föråldras försvinna. +.P +Allt detta implementeras genom att lägga in följande skalkod i paketskripten +\fBpreinst\fP, \fBpostinst\fP och \fBpostrm\fP: +.P + dpkg\-maintscript\-helper rm_conffile \e + \fIkonffil\fP \fItidigare\-version\fP \fIpaket\fP \-\- "$@" +.P +\fIkonffil\fP är namnet på konffilen som skall tas bort. +.P +Aktuell implementation: i \fBpreinst\fP kontrolleras om konffilen ändrades och +i så fall byts namnet på den till antingen \fIkonffil\fP\fB.dpkg\-remove\fP (om +inte modifierad) eller till \fIkonffil\fP\fB.dpkg\-backup\fP (om modifierad). I +\fBpostinst\fP byts namnet på den sistnämnda filen till \fIkonffil\fP\fB.dpkg\-bak\fP +och behålls som referens om den innehåller ändringar av användaren, medan +den tidigare kommer att tas bort. Om paketuppgraderingen avbryts kommer +\fBpostrm\fP att ominstallera den ursprungliga konffilen. Vid borttagning +kommer \fBpostrm\fP även att ta bort \fB.dpkg\-bak\fP\-filen som behållits fram till +dess. +. +.SS "Byta namn på en konffil" +.P +Om en konffil flyttas från en plats till en annan måste du se till att du +flyttar med eventuella ändringar gjorda av användaren. Detta kan först verka +vara en enkel ändring av \fBpreinst\fP\-skriptet, men det kommer leda till att +användaren ombeds att godkänna ändringar i konffilen för \fBdpkg\fP, även om +denne inte är ansvarig för dem. +.P +En elegant namnändring kan implementeras genom att lägga in följande skalkod +i paketskripten \fBpreinst\fP, \fBpostinst\fP och \fBpostrm\fP: +.P + dpkg\-maintscript\-helper mv_conffile \e + \fIgammalkonffil\fP \fInykonffil\fP \fItidigare\-version\fP \fIpaket\fP \-\- "$@" +.P +\fIgammalkonffil\fP och \fInykonffil\fP är de gamla och nya namnen på konffilen +vars namn skall bytas. +.P +Aktuell implementation: I \fBpreinst\fP kontrolleras om konffilen har ändrats, +om ja lämnas den kvar på plats, annars byts namnet på den till +\fIgammalkonffil\fP\fB.dpkg\-remove\fP. Vid konfigurering tar \fBpostinst\fP bort +\fIgammalkonffil\fP\fB.dpkg\-remove\fP och byter namn på \fIgammalkonffil\fP till +\fInykonffil\fP om \fIgammalkonffil\fP fortfarande finns. Vid avbruten +uppgradering eller installation byter \fBpostrm\fP tillbaka namnet från +\fIgammalkonffil\fP\fB.dpkg\-remove\fP till \fIgammalkonffil\fP om så behövs. +. +.SH "VÄXLING MELLAN SYMLÄNKAR OCH KATALOGER" +. +Vid uppgradering av ett paket kommer \fBdpkg\fP inte att automatiskt byta ut en +symbolisk länk mot en katalog, eller omvänt. Nedgraderingar stöds inte och +sökvägen kommer lämnas som den var. +. +.SS "Byta en symbolisk länk mot en katalog" +. +Om en symbolisk länk byts mot en riktig katalog måste du se till att den +symboliska länken tas bort innan uppackningen. Detta kan först verka vara en +enkel ändring av \fBpreinst\fP\-skriptet, men det kommer leda till vissa problem +om den lokale administratören har justerat den symboliska länken, eller om +paketet skall nedgraderas. +.P +En elegant namnändring kan implementeras genom att lägga in följande skalkod +i paketskripten \fBpreinst\fP, \fBpostinst\fP och \fBpostrm\fP: +.P + dpkg\-maintscript\-helper symlink_to_dir \e + \fIsökväg\fP \fIgammalt\-mål\fP \fItidigare\-version\fP \fIpaket\fP \-\- "$@" +.P +\fIsökväg\fP är den absoluta sökvägen för den gamla symboliska länken (sökvägen +kommer vara en katalog när installationen är färdig) och \fIgammalt\-mål\fP är +målet på den tidigare symboliska länken i \fIsökväg\fP. Den kan antingen vara +absolut eller relativ till katalogen som innehåller \fIsökväg\fP. +.P +Aktuell implementation: I \fBpreinst\fP kontrolleras om den symboliska länken +finns och pekar på \fIgammalt\-mål\fP, om inte lämnas den kvar, i annat fall +byts namnet ut mot \fIsökväg\fP\fB.dpkg\-backup\fP. Vid konfigurering tar +\fBpostinst\fP bort \fIsökväg\fP\fB.dpkg\-bakcup\fP om \fIsökväg\fP\fB.dpkg\-backup\fP +fortfarande är en symbolisk länk. Vid avbruten uppgradering eller +installation byter \fBpostrm\fP tillbaka namnet från \fIsökväg\fP\fB.dpkg\-bakcup\fP +till \fIsökväg\fP om så behövs. +. +.SS "Byta en symbolisk länk mot en katalog" +. +Om en riktig katalog byts mot en symbolisk länk måste du se till att +katalogen tas bort innan uppackningen. Detta kan först verka vara en enkel +ändring av \fBpreinst\fP\-skriptet, men det kommer leda till vissa problem om +katalogen innehåller konffiler, sökvägar som ägs av andra paket, lokalt +skapade sökvägar, eller om paketet skall nedgraderas. +.P +Ett elegant byte kan implementeras genom att lägga in följande skalkod i +paketskripten \fBpreinst\fP, \fBpostinst\fP och \fBpostrm\fP: +.P + dpkg\-maintscript\-helper dir_to_symlink \e + \fIsökväg\fP \fInytt\-mål\fP \fItidigare\-version\fP \fIpaket\fP \-\- "$@" +.P +\fIsökväg\fP är det absoluta namnet på den gamla katalogen (sökvägen kommer +vara en symbolisk länk när installationen är färdig) och \fInytt\-mål\fP är +målet på den nya symboliska länken i \fIsökväg\fP. Den kan antingen vara +absolut eller relativ till katalogen som innehåller \fIsökväg\fP. +.P +Aktuell implementation: I \fBpreinst\fP kontrolleras om katalogen finns, inte +innehåller konffiler, sökvägar som ägs av andra paket, eller lokalt skapade +sökvägar, om inte så kommer den lämnas kvar, annars byts namnet ut mot +\fIsökväg\fP\fB.dpkg\-backup\fP och en tom samlingsplatskatalog skapas i \fIsökväg\fP, +markerad med en fil så att dpkg kan hålla ordning på den. Vid konfigurering +slutför \fBpostinst\fP växlingen om \fIsökväg\fP\fB.dpkg\-backup\fP fortfarande är en +katalog och \fIsökväg\fP är samlingsplatskatalogen; den tar bort +märkningsfilen, flyttar nyligen skapade filer inuti samlingskatalogen till +målet för den symboliska länken \fInytt\-mål\fP/, ersätter den nu tomma +samlingskatalogen \fIsökväg\fP med en symbolisk länk till \fInytt\-mål\fP och tar +bort \fIsökväg\fP\fB.dpkg\-backup\fP. Vid avbruten uppgradering eller installation +byter \fBpostrm\fP tillbaka namnet från \fIsökväg\fP\fB.dpkg\-backup\fP till \fIsökväg\fP +om så behövs. +. +.SH "INTEGRERA I PAKET" +.P +När ett paketeringshjälpprogram används, kontrollera att det har direkt +integrering med \fBdpkg\-maintscript\-helper\fP, något som kan göra ditt liv +enklare. Se till exempel \fBdh_installdeb\fP(1). +.P +Givet att \fBdpkg\-maintscript\-helper\fP används i \fBpreinst\fP så innebär detta +villkorslöst att ett förhandsberoende ("pre\-dependency") krävs för att +försäkra att den nödvändiga versionen av \fBdpkg\fP redan har packats upp. Den +version som krävs beror på vilket kommando som används, för \fBrm_conffile\fP +och \fBmv_conffile\fP är det 1.15.7.2, för \fBsymlink_to_dir\fP och +\fBdir_to_symlnk\fP är det 1.17.14: +.P + \fBPre\-Depends:\fP dpkg (>= 1.17.14) +.P +Men i många fall är operationen som utförs av programmet inte kritiskt för +paketet, och istället för att använda ett förhandsberoende kan vi anropa +programmet endast om vi vet att det nödvändiga kommandot stöds av den nu +installerade \fBdpkg\fP: +.P + if dpkg\-maintscript\-helper supports \fIkommando\fP; then + dpkg\-maintscript\-helper \fIkommando\fP ... + fi +.P +Kommandot \fBsupports\fP returnerar 0 vid framgång, annars 1. Kommandot +\fBsupports\fP kontrollerar om miljövariablerna som sätts av dpkg och som krävs +av skriptet är närvarande, och kommer anse det som ett fel om +miljövariablerna inte är tillräckliga. +. +.SH MILJÖVARIABLER +.TP +\fBDPKG_COLORS\fP +Sets the color mode (since dpkg 1.19.1). The currently accepted values are: +\fBauto\fP (default), \fBalways\fP and \fBnever\fP. +. +.SH "SE ÄVEN" +.ad l +\fBdh_installdeb\fP(1). +.SH ÖVERSÄTTNING +Peter Krefting och Daniel Nylander. |