home *** CD-ROM | disk | FTP | other *** search
- vec FIP manuaali vec
-
- NIMI
- vec, vdc - Ville's encoder/decoder
-
- KUTSUKAAVA
- vec [<optiot>] [<tiedostot>]
- vdc [<optiot>] [<tiedostot>]
-
- SELOSTUS
- Vec on ohjelma, joka muuntaa binääritiedostot näkyviksi ASCII-mer-
- keiksi, jotta niiden siirto vain tekstitiedostoja läpäisevissä ver-
- koissa olisi mahdollista. Vdc palauttaa vecin muuntamat tiedostot en-
- nalleen. Vdc osaa myös purkaa uuencoden, btoan tai fipencoden koodaa-
- mia tiedostoja ja vec osaa tuottaa uudecode-yhteensopivaa koodia.
-
- Ohjelmat käsittelevät komentorivillä annettuja tiedostoja tai, jos
- mitään ei ole annettu, standard input virtaa. Jos useita tiedostoja
- annetaan kerralla parametreiksi, vec koodaa ne yhteen tiedostoon,
- jonka vdc osaa jälleen jakaa osiin. Jos muuta ei ole käsketty, vec
- kirjoittaa tuottamansa koodin standard output virtaan ja vdc sijoit-
- taa purkamansa tiedostot niiden alkuperäisten nimien alle.
-
- Jos annetuissa tiedostonimissä on jokerimerkkejä, vec ja vdc saatta-
- vat laventaa ne tai olla laventamatta systeemistä riippuen. Amiga
- versio tekee sen AmigaOS 2.04:n tai uudemman käyttöjärjestelmän alla.
-
- OPTIOT
- -0 Valitse koodausmenetelmä 0. Vain vec - vdc valitsee oikean mene-
- telmän syötteensä perusteella.
-
- -1 Valitse koodausmenetelmä 1. Vain vec.
-
- -2 Valitse koodausmenetelmä 2. Vain vec.
-
- -3 Valitse koodausmenetelmä 3. Vain vec.
-
- -4 Valitse koodausmenetelmä 4. Vain vec.
-
- -a Valitse ASCII-escape-koodausmenetelmä. Vain vec.
-
- -A <tiedostonimi>
- Liitä tuotettu koodi annetun tiedoston perään.
-
- -b <numero>
- Aseta I/O-puskurin koko tavuina. Muistia kuluu kaksinkertaisesti
- annettu määrä, koska puskureita on kaksi.
-
- -d Pura. Vec ja vdc ovat sama ohjelmabinääri ja normaalisti ne tut-
- kivat nimen, jolla niitä on kutsuttu, päätelläkseen, mitä niiden
- tulisi tehdä. Tällä optiolla ne voidaan pakottaa suorittamaan
- purkuoperaatio.
-
- -D Valitse uusi työhakemisto.
-
- -e Koodaa. Kuten edellä.
-
- -f Tulosta täysleveitä rivejä escape-koodausmenetelmillä. Vain vec.
-
- -i Valitse ISO 8859-1 escape-koodausmenetelmä. Vain vec.
-
- -l Tulosta ne rivit, joissa ei ole koodattua dataa standard output-
- tiin. Puretut tiedostot korvataan yksirivisellä tiedotteella,
- joka sisältää tiedoston nimen. Älä käytä tätä optiota yhtaikaa
- -p option kanssa! Vain vdc.
- vec FIP manuaali vec
-
- -L Sama, kuin edellä, mutta ilman tiedoterivejä.
-
- -N Älä talleta tai palauta tiedostojen suojausbittejä.
-
- -n <tiedostonimi>
- Talleta koodattuun tiedostoon annettu nimi tiedoston alkuperäisen
- nimen sijaan. Jos koodaat standard inputtia, etkä anna tätä opti-
- ota, vec tallettaa nimen `noname'. Vain vec.
-
- -o <tiedostonimi>
- Tulosta annettuun tiedostoon. Jos se oli ennestään olemassa, tu-
- hoa entinen. Jos tätä käytetään vdc:n yhteydessä, talletetut tie-
- dostonimet ja suojausbitit unohdetaan ja kaikki puretut tiedostot
- liitetään yhteen annettuun tiedostoon.
-
- -p Tulosta standard outputtiin. Katso edellistä. Vec tekee näin ole-
- tusarvoisesti.
-
- -q Nopea tila. Tarkistussummia ei lasketa eikä tarkisteta.
-
- -r Käytä CR+LF pareja rivisiirtoina. Normaalisti käytetään LF:ää yk-
- sin.
-
- -R Nollaa uuencodetaulukko jokaisen puretun tiedoston jälkeen. Käytä
- tätä optiota, jos purat tiedostoa, joka sisältää useita uuenkoo-
- dattuja tiedostoja eri lähteistä. Muuten yhden tiedoston taulukko
- saattaa pilata jäljessä tulevien taulukottomien tiedostojen pur-
- kamisen. Taulukko nollataan automaattisesti syöttötiedoston vaih-
- tuessa.
-
- -s Hiljainen tila. Tiedostonimiä ei tulosteta näkyviin.
-
- -t Tulosta TABit sellaisenaan escape-koodausmenetelmillä. Vain vec.
-
- -u Valitse uuencode-yhteensopiva koodausmenetelmä. Vain vec.
-
- -w <numero>
- Aseta koodirivien leveys merkkeinä. Ei vaikutusta uuencode-mene-
- telmään. Vain vec.
-
- -x Valitse heksadesimaalinen koodausmenetelmä.
-
- - Optiorajoitin. Kaikki parametrit tämän jälkeen tulkitaan tiedos-
- tonimiksi vaikka ne alkaisivat viivalla.
-
- KOODAUSMENETELMÄT
- Vec osaa käyttää kahdeksaa erilaista koodausmenetelmää binääridatan
- muuntamiseen ASCII-merkeiksi. Vdc osaa purkaa kaikkia näita ja lisäk-
- si kahta ylimääräistä.
-
- Vecmenetelmä 0
- Nopea, mutta harva. Tiedostot kasvavat 35% suuremmiksi ja tuloste
- sisältää vain 7-bittisiä ASCII-merkkejä: koodit 33 ja 36 - 99.
-
- Vecmenetelmä 1
- Hieman hitaampi, mutta tiviimpi. Tiedostot kasvavat 24,6% ja tu-
- loste sisältää edelleen vain 7-bittisiä ASCII-merkkejä: koodit 33
- ja 36 - 126.
-
- Vecmenetelmä 2
- Nopea. Vaatii 8-bittisen siirtotien. Tiedostot kasvavat 15,7% ja
- tuloste sisältää merkkejä, joiden ylin bitti on päällä. Merkit
- ovat näkyviä merkkejä ISO 8859-1- ja MS-DOS-merkkijoukoissa: koo-
- dit 33, 36 - 126 ja 161 - 197.
- vec FIP manuaali vec
-
- Vecmenetelmä 3
- Hitaampi, mutta erittäin tiivis. Vaatii 8-bittisen siirtotien.
- Tiedostot kasvavat vain 8% ja tuloste sisältää yläbitillisiä
- merkkejä. Merkit ovat näkyviä ISO 8859-1- ja MS-DOS-merkkijou-
- koissa: koodit 33, 36 - 126 ja 161 - 251.
-
- Vecmenetelmä a - ASCII-escape-menetelmä
- Tulostaa näkyvät merkit sellaisenaan ja korvaa muut escape-koo-
- deilla. Keskimääräinen nopeus. Erittäin tiivis tekstiteidostoil-
- la, mutta varsin harva binääritiedostoilla. Tuloste sisältää vain
- 7-bittisiä ASCII-merkkejä. Satunnaisdataa sisältävät binääritie-
- dostot kasvavat noin 66%, mutta tekstitiedostot eivät kasva juuri
- nimeksikään. Tekstitiedostot ovat koodattuinakin luettavia.
-
- Vecmenetelmä i - ISO 8859-1 escape-menetelmä
- Tulostaa näkyvät merkit sellaisenaan ja korvaa muut escape-koo-
- deilla. Keskimääräinen nopeus. Erittäin tiivis tekstiteidostoil-
- la, mutta varsin harva binääritiedostoilla. Tuloste sisältää vain
- yläbitillisiä merkkejä. Merkit ovat näkyviä ISO 8859-1- ja MS-
- DOS-merkkijoukoissa. Satunnaisdata kasvaa 15%, mutta tekstitie-
- dostot eivät juuri nimeksikään. Tekstitiedostot ovat koodattuina-
- kin luettavia.
-
- Vecmenetelmä x - heksadesimaalimenetelmä
- Erittäin hidas ja harva. Tiedostot kasvavat 102,5% ja tuloste si-
- sältää heksadesimaalinumeroita. Headeri sisältää samoja merkkejä,
- kuin menetelmä 0. Tämä menetelmä on alunperin toteutettu vain
- testaustarkoituksiin, mutta voi kuitenkin olla hyödyllinen jois-
- sakin tilanteissa.
-
- Uuencodemenetelmä
- Erittäin nopea ja erittäin harva. Tiedostot kasvavat 40% ja tu-
- loste sisältää vain 7-bittisiä ASCII-merkkejä: koodit 33 - 96.
- Täysin yhteensopiva uuencode- ja uudecode-ohjelmien kanssa.
-
- Btoamenetelmä
- Vain purku. Tiedostot kasvavat 25,8% ja koodi sisältää vain 7-
- bittisiä ASCII-merkkejä. Yhteensopiva btoa- ja atob-ohjelmien
- kanssa.
-
- Fipencodemenetelmä
- Vain purku. Tiedostot kasvavat 15,8% ja koodi sisältää 8-bittisiä
- merkkejä, jotka ovat näkyviä ISO 8859-1- ja MS-DOS-merkkijoukois-
- sa. Yhteensopiva fipencode- ja fipdecode-ohjelmien kanssa.
-
- Vecmenetelmät käyttävät CRC16 tarkistussummaa. Uuencodella on alkeel-
- liset rivisummat ja tavulukumäärä. Btoa:lla ja fipencode:lla on omat
- tarkistussummansa, mutta vdc ei tue niitä.
-
- Kasvuprosentit vecmenetelmille on laskettu käyttäen 80 merkin rivile-
- veyttä.
-
- VERSIO
- Tämä manuaali on kirjoitettu 4 joulukuuta 1993 vec versiolle 3.227.
- vec FIP manuaali vec
-
- TEKIJÄ
- Ville Saari
-
- Osoite: Tallbergin puistotie 7 B 21
- 00200 Helsinki
-
- Puhelin: (90) 682 2226
-
- Internet: vsaari@garfield.fipnet.fi
-
- Jos löydät pöpöjä vecistä, kerro niistä minullekin.
-
- Vec on vapaasti levitettävissä, mutta jos pidät siitä ja haluat eh-
- dottomasti maksaa minulle jotakin tai lahjoittaa purjeveneen tai Fer-
- rarin tai jotain, niin ihan vapaasti vain - en vastusta.
-