From 640c5d948afa27a8e71eb6c03f1e0d55f81773c5 Mon Sep 17 00:00:00 2001 From: Matt Zimmerman Date: Sat, 13 Nov 2004 18:27:46 +0000 Subject: Merge from CVS Patches applied: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * apt@arch.ubuntu.com/apt--MAIN--0--patch-1304 Basque correction. * apt@arch.ubuntu.com/apt--MAIN--0--patch-1305 Updated Brazilian Portuguese and Greek (256396 and 2567... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1306 New Korean translation from Changwoo Ryu . * apt@arch.ubuntu.com/apt--MAIN--0--patch-1326 Updated Greek from George Papamichelakis (Closes: #265004) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1327 Updated Simplified Chinese from Tchaikov (Closes: #265190) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1328 Updated French by Christian Perrier (Closes: #265816) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1329 Updated Japanese by Kenshi Muto (Closes: #265630) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1330 Updated French by Christian Perrier (Closes: #265816) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1331 - Updated Catalan from Jordi Mallach * apt@arch.ubuntu.com/apt--MAIN--0--patch-1332 Updated Dutch from Bart Cornelis (Closes: #268258) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1333 Updated Portuguese from Miguel Figueiredo (Closes: #268265) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1334 Updated Dutch from Bart Cornelis (Closes: #268258) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1335 APT::Get::APT::Get::No-List-Cleanup -> APT::Get::List-C... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1336 Updated Polish from Robert Luberda ... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1337 Updated Danish from Claus Hindsgaul (Closes: #269417) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1338 Updated Norwegian Nynorsk from H��vard Korsvoll (Closes:... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1340 Updated Italian from Samuele Giovanni Tonon (Closes: #2... * apt@arch.ubuntu.com/apt--MAIN--0--patch-1341 Updated Dutch from Bart Cornelis (Closes: #278697) * apt@arch.ubuntu.com/apt--MAIN--0--patch-1342 Updated Slovak from Peter Mann (Closes: #279481) --- doc/apt.conf.5.xml | 4 +- doc/examples/configure-index | 35 ++++-- doc/makefile | 7 +- doc/pl/makefile | 10 ++ doc/pl/offline.pl.sgml | 250 +++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 291 insertions(+), 15 deletions(-) create mode 100644 doc/pl/makefile create mode 100644 doc/pl/offline.pl.sgml (limited to 'doc') diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index eed5b8d52..b5d223372 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -377,8 +377,8 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; Examples - &configureindex; contains a - sample configuration file showing the default values for all possible + &configureindex; is a + configuration file showing example values for all possible options. diff --git a/doc/examples/configure-index b/doc/examples/configure-index index 2f9d09873..7cb29f082 100644 --- a/doc/examples/configure-index +++ b/doc/examples/configure-index @@ -1,9 +1,9 @@ -// $Id: configure-index,v 1.9 2004/04/29 17:30:22 mdz Exp $ +// $Id: configure-index,v 1.10 2004/07/17 19:37:16 mdz Exp $ /* This file is an index of all APT configuration directives. It should - NOT actually be used as a real config file, though it is a completely - valid file. Most of the options have sane default values, unless - you have specific needs you should NOT include arbitary items in a custom - configuration. + NOT actually be used as a real config file, though it is (except for the + last line) a completely valid file. Most of the options have sane default + values, unless you have specific needs you should NOT include arbitary + items in a custom configuration. In some instances involving filenames it is possible to set the default directory when the path is evaluated. This means you can use relative @@ -17,6 +17,8 @@ if an option is specified on the command line with -o. */ +quiet "0"; + // Options for APT in general APT { @@ -34,6 +36,7 @@ APT Fix-Broken "false"; Fix-Missing "false"; Show-Upgraded "false"; + Show-Versions "false"; Upgrade "true"; Print-URIs "false"; Compile "false"; @@ -43,6 +46,9 @@ APT ReInstall "false"; Trivial-Only "false"; Remove "true"; + Only-Source ""; + Diff-Only "false"; + Tar-Only "false"; }; Cache @@ -51,6 +57,11 @@ APT AllVersions "false"; GivenOnly "false"; RecurseDepends "false"; + ShowFull "false"; + Generate "true"; + NamesOnly "false"; + AllNames "false"; + Installed "false"; }; CDROM @@ -117,7 +128,7 @@ Acquire cdrom { - Mount "/cdrom"; + mount "/cdrom"; // You need the trailing slash! "/cdrom/" @@ -134,7 +145,7 @@ Dir "/" // Location of the state dir State "var/lib/apt/" { - lists "lists/"; + Lists "lists/"; xstatus "xstatus"; userstatus "status.user"; status "/var/lib/dpkg/status"; @@ -143,16 +154,17 @@ Dir "/" // Location of the cache dir Cache "var/cache/apt/" { - archives "archives/"; + Archives "archives/"; srcpkgcache "srcpkgcache.bin"; pkgcache "pkgcache.bin"; }; // Config files Etc "etc/apt/" { - sourcelist "sources.list"; - main "apt.conf"; - preferences "preferences"; + SourceList "sources.list"; + Main "apt.conf"; + Preferences "preferences"; + Parts "apt.conf.d/"; }; // Locations of binaries @@ -218,6 +230,7 @@ Debug Acquire::Ftp "false"; // Show ftp command traffic Acquire::Http "false"; // Show http command traffic aptcdrom "false"; // Show found package files + IdentCdrom "false"; } /* Whatever you do, do not use this configuration file!! Take out ONLY diff --git a/doc/makefile b/doc/makefile index 1287cfc5f..ace9010df 100644 --- a/doc/makefile +++ b/doc/makefile @@ -1,7 +1,7 @@ # -*- make -*- BASE=.. SUBDIR=doc -SUBDIRS= fr ja pt_BR es +SUBDIRS= fr ja pl pt_BR es # Bring in the default rules include ../buildlib/defaults.mak @@ -25,7 +25,7 @@ TARGET = binary include $(COPY_H) #.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr -doc: doc.fr doc.ja doc.pt_BR doc.es +doc: doc.fr doc.ja doc.pl doc.pt_BR doc.es doc.fr: %.fr: $(MAKE) -C fr $* @@ -38,3 +38,6 @@ doc.es: %.es: doc.ja: %.ja: $(MAKE) -C ja $* + +doc.pl: %.pl: + $(MAKE) -C pl $* diff --git a/doc/pl/makefile b/doc/pl/makefile new file mode 100644 index 000000000..72a505422 --- /dev/null +++ b/doc/pl/makefile @@ -0,0 +1,10 @@ +# -*- make -*- +BASE=../.. +SUBDIR=doc/pl + +# Bring in the default rules +include ../../buildlib/defaults.mak + +# Debian Doc SGML Documents +SOURCE = offline.pl.sgml +include $(DEBIANDOC_H) diff --git a/doc/pl/offline.pl.sgml b/doc/pl/offline.pl.sgml new file mode 100644 index 000000000..48f84e3b1 --- /dev/null +++ b/doc/pl/offline.pl.sgml @@ -0,0 +1,250 @@ + + + +U¿ywanie APT w trybie offline + +Jason Gunthorpe jgg@debian.org +Polskie t³umaczenie Krzysztof Fiertek akfedux@megapolis.pl +$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $ + + +Dokument ten opisuje jak u¿ywaæ programu APT w ¶rodowiskach niesieciowych, +a w szczególno¶ci metodê pozwalaj±c± na robienie aktualizacji systemu. + + + +Copyright © Jason Gunthorpe, 1999. +

+Copyright © polskiego t³umaczenia Krzysztof Fiertek, 2004. +

+"APT" i ten dokument s± oprogramowaniem wolnodostêpnym; mo¿esz +rozpowszechniaæ je i/lub zmieniaæ w zgodzie z postanowieniami +"Ogólnej Licencji Publicznej GNU" (GNU General Public License) +takiej, jak zosta³a opublikowana przez "Fundacje Wolnego +Oprogramowania (Free Software Foundation); albo w wersji 2 tej¿e +licencji, albo (twój wybór) w dowolnej pó¼niejszej. + +

+Wiêcej szczegó³ów mo¿esz uzyskaæ przegl±daj±c plik zawieraj±cy pe³ny tekst +licencji (w systemach Debian jest to plik /usr/doc/copyright/GPL). + + +Wstêp + + +Wprowadzenie + +

+Normalnie APT wymaga bezpo¶redniego dostêpu do archiwów Debiana poprzez +sieæ lokaln± albo przez sieæ internetow±. Kolejn± niedogodno¶ci± mo¿e byæ +fakt, ¿e nasz komputer, który pracuje na wolnym ³±czu takim jak modem, +jest znacznie oddalony od innnego komputera z szybkim ³±czem. + +

+Rozwi±zaniem tego problemu jest u¿ycie pojemnych przeno¶nych no¶ników +takich jak dyskietka Zip lub dysk SuperDisk. No¶niki te nie s± +wystarczaj±co pojemne, by zgromadziæ kompletne archiwum Debiana, ale mo¿na +¶mia³o dopasowaæ podzbiór du¿ego archiwum wystarczaj±cy dla wiêkszo¶ci +u¿ytkowników. Pomys³ polega na tym, by u¿yæ programu APT do wygenerowania +listy pakietów, które s± wymagane, nastêpnie pobraniu ich na dysk u¿ywaj±c +innego komputera z w³a¶ciw± zwarto¶ci±. Jest nawet mo¿liwe, by u¿yæ innego +komputera z Debianem z zainstalowanym programem APT lub zupe³nie innym +systemem operacyjnym i programem narzêdziowym do pobierania plików takim +jak wget. + +

+Osi±gniête jest to przez twórcze manipulowanie plikiem konfiguracyjnym +programu APT. Rzecz± niezbêdn± jest poinformowanie programu APT, aby wskazywa³ +na dysk z plikami archiwum. Nale¿y zauwa¿yæ, ¿e dysk powinien byæ +sformatowany do obs³ugi systemu plików takiego jak ext2, fat32 albo vfat +pozwalaj±cych pos³ugiwaæ siê d³ugimi nazwami pliku. + + + + +U¿ywanie programu APT na obu komputerach + + +Wprowadzenie + +

+APT bêd±cy do dyspozycji na obu komputerach daje najprostsz± kombinacjê. +Zasadniczym pomys³em tej metody jest umie¶ciæ kopie pliku status na dysku +i u¿yæ odleg³ego komputera, aby uzyskaæ najnowsze pliki pakietów +i zdecydowaæ, które pakiety chcemy pobraæ. Struktura katalogów na dysku +powinna wygl±daæ nastêpuj±co: + + + /disc/ + archives/ + partial/ + lists/ + partial/ + status + sources.list + apt.conf + + + + + + +Plik konfiguracyjny + +

+Plik konfiguracyjny powinien informowaæ program APT, aby przechowywaæ jego +pliki na dysku, a tak¿e u¿ywaæ plików konfiguracyjnych z dysku. Plik +sources.list powinien zawieraæ prawid³owe odno¶niki, których oczekujesz +u¿yæ od zdalnego komputera, a plik status powinien byæ kopi± +/var/lib/dpkg/status. Zauwa¿, ¿e je¶li u¿ywasz lokalnego archiwum +musisz u¿yæ tych samych odno¶ników o identycznej sk³adni. + +

+apt.conf musi zawieraæ niezbêdne wpisy, by APT korzysta³ z dysku: + + + APT + { + /* Ten wpis nie jest wymagany je¶li oba komputery s± tej samej + architektury, mówi on APTowi na komputerze pobieraj±cym pakiety + jakiej architektury jest nasz komputer */ + Architecture "i386"; + + Get::Download-Only "true"; + }; + + Dir + { + /* U¿yj katalogu disc na informacje stanu i skieruj plik status + z /var/lib/dpkg default */ + State "/disc/"; + State::status "status"; + + // Katalog lokalnie przechowywanych pakietów binarnych + Cache::archives "/disc/archives/"; + Cache "/tmp/"; + + // Lokalizacja pliku sources.list. + Etc "/disc + }; + + +Wiêcej szczegó³ów mo¿na zobaczyæ w manualu apt.conf i w przyk³adowym pliku +konfiguracyjnym /usr/doc/apt/examples/apt.conf. + +

+Pierwsz± rzecz± jaka nale¿y zrobiæ na oddalonym komputerze z Debianem to +zamontowaæ dysk i przekopiowaæ na niego plik /var/lib/dpkg/status. +Potrzeba tak¿e utworzyæ stukturê katalogów przedstawion± we Wprowadzeniu, +archives/partial/ i lists/partial/. Nastêpnie niesiemy +dysk do oddalonego komputera z szybkim ³±czem i konfigurujemy plik +sources.list. Na oddalonym komputerze wykonujemy kolejno: + + + # export APT_CONFIG="/disc/apt.conf" + # apt-get update + [ APT aktualizuje ustawienia ] + # apt-get dist-upgrade + [ APT pobiera wszystkie potrzebne pakiety do aktualizacji twojego systemu ] + + + +Polecenie dist-upgrade mo¿na zast±piæ ka¿dym innym podstawowym poleceniem +APT, w szczególno¶ci dselect-upgrade. Mo¿esz nawet u¿yæ APT jako metodê +dostêpu dla dselect. Jednak stworzy to problem w przeniesieniu +twoich operacji wyborów z powrotem na lokalny komputer. + +

+W tej chwili katalog disc zawiera wszystkie pliki indeksowe oraz archiwa +niezbêdne do aktualizacji maszyny z Debianem. Bierzemy dysk z powrotem do +siebie i wpisujemy: + + + # export APT_CONFIG="/disc/apt.conf" + # apt-get check + [ APT tworzy lokaln± kopiê plików cache ] + # apt-get --no-d -o dir::etc::status=/var/lib/dpkg/status dist-upgrade + [ Mo¿e te¿ byæ inne polecenie programu APT ] + + +

+Koniecznym jest do prawid³owego dzia³ania podmieniæ plik status na lokalnej +maszynie. To jest bardzo wa¿ne! + +

+Je¶li u¿ywasz dselect mo¿esz wykonaæ bardzo ryzykown± operacjê skopiowania +disc/status do /var/lib/dpkg/status tak, ¿e wszystkie zmiany które +dokona³e¶ na odleg³ym komputerze s± uaktualnione. Mocno zalecam aby +dokonywaæ doboru pakietów tylko na lokalnym komputerze, ale nie zawsze +jest to mo¿liwe. NIE podmieniaj pliku status je¶li dpkg lub APT by³y +uruchamiane w miêdzyczasie!! + + + + +U¿ywanie programów APT i wget + + +Wprowadzenie + +

+wget jest popularnym i przeno¶nym programem narzêdziowym +pobierania plików, który dzia³a na prawie ka¿dym komputerze. +W przeciwieñstwie do metody opisanej powy¿ej ta wymaga komputera z Debianem, +który ju¿ posiada listê dostêpnych pakietów. + +

+Nale¿y stworzyæ katalog disc tylko na pakiety do pobrania z innego +komputera. U¿yta zostanie do tego opcja --print-uris programu apt-get, +a nastêpnie przygotujemy skrypt dla programu wget, który pobierze w³a¶ciwe +pakiety. + + + + + +Kolejne kroki + +

+W odró¿nieniu od poprzedniej metody dzia³ania ta nie wymaga specjalnych +plików konfiguracyjnych. U¿ywamy jedynie podstawowych poleceñ APT, by +wygenerowaæ listê plików. + + + # apt-get dist-upgrade + [ Wybierz no po znaku zachêty, upewnij siê czy to w³a¶ciwy wybór ] + # apt-get -qq --print-uris dist-upgrade > uris + # awk '{print "wget -O " $2 " " $1}' < uris > /disc/wget-script + + +Tak¿e inne opcje ni¿ dist-upgrade mog± tu byæ u¿yte, w³±czaj±c +dselect-upgrade. + +

+Plik skryptu /disc/wget-script bêdzie teraz zawieraæ listê poleceñ dla +programu wget, który uruchomi w porz±dku pobieranie potrzebnych archiwów. +Skrypt ten nale¿y uruchomiæ w bie¿±cym katalogu o punkcie montowania disc +tak aby tu zapisywa³ dane na dysku. + +

+Na oddalonym komputerze nale¿y wykonaæ co¶ takiego + + + # cd /disc + # sh -x ./wget-script + [ czekaj.. ] + + +Gdy archiwa zosta³y pobrane i dysk wróci³ do komputera z Debianem, +instalowanie mo¿na prowadziæ dalej poleceniem, + + + # apt-get -o dir::cache::archives="/disc/" dist-upgrade + + +Które u¿yje pobrane uprzednio archiwa z dysku. + + + -- cgit v1.2.3