RCVT ~~~~ Narz©dzie do konwersji archiw˘w wersja 1.02 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Podr©cznik uľytkownika ~~~~~~~~~~~~~~~~~~~~~~ RCVT (konwerter archiw˘w) umoľliwia konwersj© archiw˘w r˘ľnych typ˘w na jeden typ, typ g˘wny. RCVT wypakowuje pliki ze «r˘dowego archiwum i dodaje je do nowego archiwum, usuwajĄc «r˘dowe archiwum jeli konwersja przebiegnie pomylnie. Plik konfiguracyjny RCVT.CFG zawiera definicje typ˘w i opcji archiw˘w. Typy archiw˘w zawierajĄ okrelenia wywoaä odpowiednich archiwizator˘w w celu rozpakowania, archiwizacji i testowania odpowiednich archiw˘w. Narz©dzie to suľy do konwersji archiw˘w innych format˘w na format RAR. Moľna jednak tak skonfigurowa† RCVT, aby konwertowa na inny format niľ RAR - robi si© to przez umieszczenie w pliku definicji danego typu archiwum przed definicjami innych typ˘w. 1. Plik konfiguracyjny - RCVT.CFG Plik konfiguracyjny (RCVT.CFG) jest zwykym plikiem tekstowym zawierajĄcym opcje i definicje typ˘w archiw˘w. RCVT.CFG musi si© znajdowa† w tym samym katalogu co RCVT.EXE. Linie rozpoczynajĄce si© od rednika (';') sĄ komentarzami i sĄ ignorowane przez RCVT.EXE. 1.1. Opcje: OnError NextArchive | Abort Warto† tej opcji definiuje zachowanie RCVT w przypadku wystĄpienia b©du podczas konwersji archiwum. 'NextArchive' oznacza przejcie do nast©pnego archiwum. 'Abort' powoduje przerwanie konwersji. RepackRatio <procent> Okrela najniľszy akceptowalny stopieä kompresji po konwersji. Add <nazwa pliku> Okrela nazw© pliku, kt˘ry b©dzie dodany do kaľdego konwertowanego archiwum. Konieczne jest podanie penej cieľki dost©pu. Dopuszczalne jest wielokrotne wystĄpienie opcji "Add". Del <nazwa pliku> Okrela pliki, kt˘re nie powinny si© znale«† w konwertowanym archiwum. Dopuszcza si© uľycie symboli wieloznacznych. Jeli zostanie podana pena cieľka, jako katalog zostanie przyj©ty g˘wny katalog archiwum. Dopuszczalne jest wielokrotne wystĄpienie opcji "Del". Scan <program do uruchomienia> Moľna wskaza† program uruchamiany w celu przetworzenia plik˘w wypakowanych z archiwum przed ich ponownĄ kompresjĄ. Na przykad moľna uruchomi† program antywirusowy. Jeli uruchomiony program zwr˘ci warto† niezerowĄ, pliki nie zostanĄ ponownie zarchiwizowane i odpowiedni komunikat zostanie umieszczony w pliku rejestru wydarzeä - RCVT.LOG. Dopuszczalne jest wielokrotne wystĄpienie opcji "Scan". Filelist <nazwa pliku> Okrela plik z listĄ archiw˘w do konwersji. Nazwa archiwum po udanej konwersji zmieniana jest na nowĄ. Jeli nie zostanie podana pena cieľka, zostanie przeszukany plik znajdujĄcy si© w tym samym katalogu co konwertowane archiwum. Dopuszczalne jest wielokrotne wystĄpienie opcji "Filelist". 1.2. Definicje archiwizator˘w Kaľda z definicji skada si© z 4 linii. Pierwsza linia definiuje typ archiwum - rozszerzenie pliku i opcjonalnĄ sygnatur© archiwum - ciĄg zawierajĄcy maksymalnie 32 bajty (w formacie szesnastkowym) znajdujĄce si© na poczĄtku archiwum, na przykad: ; Konwersja ze starego formatu RAR'a (sprzed wersji 1.50) .RAR 52457E5E Sygnatura archiwum jest opcjonalna, wi©c archiwa mogĄ by† rozpoznawane tylko wedug rozszerzenia, na przykad: ; Konwersja z formatu ZIP .ZIP Pozostae linie definiujĄ wywoania program˘w w celu wykonania odpowiednich operacji na archiwach: PACK <linia polecenia> do archiwizacji plik˘w (tworzenia archiwum) EXTR <linia polecenia> do wypakowania plik˘w z archiwum TEST <linia polecenia> do testowania plik˘w w archiwum Nast©pujĄcy przykad jest kompletnĄ definicjĄ archiwum RAR'a: ; Definicja g˘wnego archiwum: konwersja na format RAR .RAR PACK RAR a -s -std -c- -r -z$CMT$ EXTR RAR x -std -c- -y -av- TEST RAR t -std -c- (Podr©cznik uľytkownika RAR'a zawiera peny opis skadni linii poleceä). Podczas przetwarzania archiw˘w .RAR, .ARJ i .ZIP, komentarz z archiwum zostanie zachowany w pliku tymczasowym, z kt˘rego p˘«niej zostanie dodany do docelowego archiwum. Nazwa '$CMT$' w linii poleceä oznacza plik komentarza archiwum. RCVT zamienia jĄ na waciwĄ nazw© podczas kompresji. UWAGA: Polecenia PACK i EXTR naleľy zdefiniowa† tak, aby miay moľliwo† przeszukiwania podkatalog˘w. Polecenie TEST jest opcjonalne. Uľywane jest do weryfikacji nowo utworzonego archiwum (w celu sprawdzenia, czy archiwum moľe by† poprawnie rozpakowane). Jeli program po wyknaniu polecenia TEST zwr˘ci kod (w zmiennej ERRORLEVEL) r˘ľny od zera, nowo utworzone archiwum zostanie usuni©te a «r˘dowe archiwum pozostanie nienaruszone, a ponadto w pliku RCVT.LOG zostanie umieszczony odpowiedni komunikat. Jeli polecenie TEST nie zostanie zdefiniowane, RCVT zakada, ľe nowo utworzone archiwa sĄ tworzone poprawnie i nie sĄ sprawdzane. Zaleca si© jednak uľycie polecenia TEST jeli jest to moľliwe. UWAGA: Archiwizatory (lub inne programy) uľyte w definicjach poleceä w pliku RCVT.CFG muszĄ si© znajdowa† w cieľce przeszukiwaä (zdefiniowanej w zmiennej rodowiskowej PATH). 2. Uľycie Skadnia RCVT: RCVT [-opcja[-]] <archiwum> Wystarczy poda† nazw© archiwum (moľna uľy† symboli wieloznacznych). Opcje: -r[-]: konwertuj archiwa w podkatalogach -n[+]: konwertuj zagnieľdľone archiwa -k[+]: zachowaj czas archiwum Przykady: Konwertuj wszystkie archiwa znajdujĄce si© na bieľĄcym dysku: RCVT -r *.* Konwertuj archiwum book.lzh: RCVT book.lzh Pliki sĄ wypakowywane do katalogu tymczasowego tworzonego w bieľĄcym katalogu. Jeli opcja SCAN jest zdefiniowana, pliki sĄ poddawane operacji SCAN. Pliki zdefiniowane opcjĄ DEL nie sĄ dodawane do nowego archiwum. Pliki zdefiniowane opcjĄ ADD sĄ dodawane do nowego archiwum. Po udanym utworzeniu nowego archiwum (i sprawdzeniu poleceniem TEST) «r˘dowe archiwum jest usuwane. Jeli archiwum zawiera zagnieľdľone archiwa (archiwa wewnĄtrz archiw˘w), sĄ one r˘wnieľ konwertowane, chyba ľe zostanie uľyta opcja '-n-'. Komentarze archiw˘w sĄ wstawiane do nowego archiwum jeli definicja g˘wnego archiwum posiada opcj© dodawania komentarza archiwum "$CMT$". Etykiety dysk˘w i inne specyficzne informacje sĄ ignorowane i nie sĄ umieszczane w nowym archiwum. Jeli archiwizator zgasza bĄd i opcja OnError jest ustawiona na warto† 'Abort', RCVT koäczy dziaanie. Wszystkie komunikaty o b©dach sĄ umieszczane w pliku RCVT.LOG, kt˘ry znajduje si© w tym samym katalogu co RCVT.EXE.
Janusz40