diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apt.conf.5.xml | 4 | ||||
| -rw-r--r-- | doc/examples/configure-index | 35 | ||||
| -rw-r--r-- | doc/makefile | 7 | ||||
| -rw-r--r-- | doc/pl/makefile | 10 | ||||
| -rw-r--r-- | doc/pl/offline.pl.sgml | 250 |
5 files changed, 291 insertions, 15 deletions
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";}; </refsect1> <refsect1><title>Examples</title> - <para>&configureindex; contains a - sample configuration file showing the default values for all possible + <para>&configureindex; is a + configuration file showing example values for all possible options.</para> </refsect1> 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 @@ +<!doctype debiandoc system> +<!-- -*- mode: sgml; mode: fold -*- --> +<book> +<title>Używanie APT w trybie offline</title> + +<author>Jason Gunthorpe <email>jgg@debian.org</email></author> +<author>Polskie tłumaczenie Krzysztof Fiertek <email>akfedux@megapolis.pl</email></author> +<version>$Id: offline.pl.sgml,v 1.1 2004/07/29 16:43:13 mdz Exp $</version> + +<abstract> +Dokument ten opisuje jak używać programu APT w środowiskach niesieciowych, +a w szczególności metodę pozwalającą na robienie aktualizacji systemu. +</abstract> + +<copyright> +Copyright © Jason Gunthorpe, 1999. +<p> +Copyright © polskiego tłumaczenia Krzysztof Fiertek, 2004. +<p> +"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. + +<p> +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). +</copyright + +<toc sect> + +<chapt>Wstęp +<!-- Overview {{{ --> +<!-- ===================================================================== --> +<sect>Wprowadzenie + +<p> +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. + +<p> +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. + +<p> +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. + +</sect> + <!-- }}} --> + +<chapt>Używanie programu APT na obu komputerach +<!-- Overview {{{ --> +<!-- ===================================================================== --> +<sect>Wprowadzenie + +<p> +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: + +<example> + /disc/ + archives/ + partial/ + lists/ + partial/ + status + sources.list + apt.conf +</example> + +</sect> + <!-- }}} --> +<!-- The configuartion file {{{ --> +<!-- ===================================================================== --> +<sect>Plik konfiguracyjny + +<p> +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ą +<em>/var/lib/dpkg/status</em>. Zauważ, że jeśli używasz lokalnego archiwum +musisz użyć tych samych odnośników o identycznej składni. + +<p> +<em>apt.conf</em> musi zawierać niezbędne wpisy, by APT korzystał z dysku: + +<example> + 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 + }; +</example> + +Więcej szczegółów można zobaczyć w manualu apt.conf i w przykładowym pliku +konfiguracyjnym <em>/usr/doc/apt/examples/apt.conf</em>. + +<p> +Pierwszą rzeczą jaka należy zrobić na oddalonym komputerze z Debianem to +zamontować dysk i przekopiować na niego plik <em>/var/lib/dpkg/status</em>. +Potrzeba także utworzyć stukturę katalogów przedstawioną we Wprowadzeniu, +<em>archives/partial/</em> i <em>lists/partial/</em>. Następnie niesiemy +dysk do oddalonego komputera z szybkim łączem i konfigurujemy plik +sources.list. Na oddalonym komputerze wykonujemy kolejno: + +<example> + # 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 ] + +</example> + +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 <em>dselect</em>. Jednak stworzy to problem w przeniesieniu +twoich operacji wyborów z powrotem na lokalny komputer. + +<p> +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: + +<example> + # 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 ] +</example> + +<p> +Koniecznym jest do prawidłowego działania podmienić plik status na lokalnej +maszynie. To jest bardzo ważne! + +<p> +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!! + +</sect> + <!-- }}} --> + +<chapt>Używanie programów APT i wget +<!-- Overview {{{ --> +<!-- ===================================================================== --> +<sect>Wprowadzenie + +<p> +<em>wget</em> 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. + +<p> +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. + +</sect> + <!-- }}} --> +<!-- Operation {{{ --> +<!-- ===================================================================== --> +<sect>Kolejne kroki + +<p> +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. + +<example> + # 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 +</example> + +Także inne opcje niż dist-upgrade mogą tu być użyte, włączając +dselect-upgrade. + +<p> +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. + +<p> +Na oddalonym komputerze należy wykonać coś takiego + +<example> + # cd /disc + # sh -x ./wget-script + [ czekaj.. ] +</example> + +Gdy archiwa zostały pobrane i dysk wrócił do komputera z Debianem, +instalowanie można prowadzić dalej poleceniem, + +<example> + # apt-get -o dir::cache::archives="/disc/" dist-upgrade +</example> + +Które użyje pobrane uprzednio archiwa z dysku. +</sect> + <!-- }}} --> +</book> |