home *** CD-ROM | disk | FTP | other *** search
/ back2roots/padua / padua.7z / padua / uucp / auucp+-1.02 / fuucp_plus_src.lzh / uucplib / AmigaUUCPplus_Lib.doc next >
Encoding:
Text File  |  1991-03-20  |  4.7 KB  |  141 lines
  1. ------------------------------------------------------------------------------
  2.   Dokumentation zur  AmigaUUCPplus.Library von Ingo Feulner
  3. ------------------------------------------------------------------------------
  4.  
  5.   Copyright:         ⌐1991 Matthias Zepf & Ingo Feulner
  6.  
  7.   Letzte ─nderung:   19. MΣrz 1991
  8.  
  9.   Version:           0.1
  10.  
  11.   Hinweis:           Diese Dokumentation darf unentgeldlich verbreitet werden.
  12.                      Fehlerbeschreibungen und VorschlΣge bitte an:
  13.  
  14.                      Ingo Feulner
  15.                      Wolfacher Weg xx
  16.                      D-7030 B÷blingen
  17.                      Deutschland
  18.  
  19.   Telefon:           (+49) 7031 272691
  20.  
  21.   E-Mail:            bugs@xenon.stgt.sub.org
  22.  
  23. ------------------------------------------------------------------------------
  24.  
  25. INHALT
  26.  
  27. amigauucpplus.library/CompressFile
  28. amigauucpplus.library/DeCompressFile
  29. amigauucpplus.library/DeLhArcFile
  30. amigauucpplus.library/GetConfigLine
  31. amigauucpplus.library/GetNickName
  32. amigauucpplus.library/GetPath
  33. amigauucpplus.library/GetRealName
  34. amigauucpplus.library/LhArcFile
  35. amigauucpplus.library/PostNews
  36. amigauucpplus.library/SendMail
  37. amigauucpplus.library/UUdecodeFile
  38. amigauucpplis.library/UUencodeFile
  39.  
  40. ------------------------------------------------------------------------------
  41.  
  42. amigauucpplus.library/CompressFile          amigauucpplus.library/CompressFile
  43.  
  44.    NAME
  45.         CompressFile -- Verkleinert die angegebene Datei mit dem UNIX-
  46.                         "compress"-Verfahren.
  47.  
  48.    ANWENDUNG
  49.         error = CompressFile(file, maxbits);
  50.         D0                   A0    D0
  51.  
  52.         UWORD CompressFile( struct FileHandle *file, UWORD maxbits );
  53.  
  54.    FUNKTION
  55.         CompressFile verkleinert die angegebene Datei unter Verwendung des
  56.         von UNIX her bekannten "compress"-Verfahrens. Dabei k÷nnen eine
  57.         Anzahl von "Bits" angegeben werden. Je mehr "Bits", desto besser
  58.         die Verkleinerung der Datei, aber auch desto gr÷▀er der Speicher-
  59.         bedarf. Maximal kann 16 angefordert werden. Dazu wird aber mindestens
  60.         500 kByte freier, zusammenhΣngender Speicher ben÷tigt!
  61.  
  62.         Nach Durchfⁿhrung der Verkleinerung liegt die Datei unter dem selben
  63.         Name vor (!!).
  64.  
  65.    ▄BERGABEN
  66.         file   - BCPL-Zeiger auf den FileHandle.
  67.         maxbit - maximale Anzahl an "Bits".
  68.  
  69.    R▄CKGABEN
  70.  
  71.         error  - AUUCP_ERROR_OK, es ist kein Fehler aufgetreten.
  72.                  AUUCP_ERROR_COMPRESSED, Datei ist bereits "compressed".
  73.                  AUUCP_ERROR_OUTOFMEM, nicht ausreichend Arbeitsspeicher.
  74.                  AUUCP_ERROR_DISKFULL, Diskette/Festplatte voll.
  75.  
  76.    HINWEISE
  77.         Es k÷nnen ASCII- und BinΣr-Dateien verkleinert werden, die ent-
  78.         stehende Datei ist immer binΣr. Je nach Rechnergeschwindigkeit
  79.         kann die Verkleinerung einige Zeit in Anspruch nehmen. (Der Benutzer
  80.         sollte einen "Warte"-Hinweis bekommen, wenn diese Funktion wΣhrend
  81.         dem interaktiven Betrieb aufgerufen wird.)
  82.  
  83.    BEISPIEL
  84.  
  85.    AUSNAHMEN
  86.  
  87.    FEHLER
  88.  
  89.    SIEHE AUCH
  90.         DeCompressFile, LhArcFile, DeLhArcFile
  91.  
  92. ------------------------------------------------------------------------------
  93.  
  94. amigauucpplus.library/DeCompressFile      amigauucpplus.library/DeCompressFile
  95.  
  96.    NAME
  97.         DeCompressFile -- Bringt eine Datei, die mit "compress" verkleinert
  98.                           wurde wieder in den Originalzustand.
  99.  
  100.    ANWENDUNG
  101.         error = DeCompressFile(file);
  102.         D0                     A0
  103.  
  104.         UWORD DeCompressFile( struct FileHandle *file );
  105.  
  106.    FUNKTION
  107.         Dateien, die mit dem von UNIX bekannten "compress"-Verfahren ver-
  108.         kleinert wurden, werden mit DeCompressFile wieder in ihren ursprⁿng-
  109.         lichen Zustand gebracht. Zur Durchfⁿhrung wird ausordentlich viel
  110.         Arbeitsspeicher ben÷tigt (ohne weiteres 300 bis 400 kByte).
  111.  
  112.         Nach der Ausfⁿhrung dieser Funktion liegt die Datei unter dem selben
  113.         Name vor (!!).
  114.  
  115.    ▄BERGABEN
  116.         file   - BCPL-Zeiger auf den FileHandle.
  117.  
  118.    R▄CKGABEN
  119.  
  120.         error  - AUUCP_ERROR_OK, es ist kein Fehler aufgetreten.
  121.                  AUUCP_ERROR_NOTCOMPRESSED, Datei ist nicht "compressed".
  122.                  AUUCP_ERROR_OUTOFMEM, nicht ausreichend Arbeitsspeicher.
  123.                  AUUCP_ERROR_DISKFULL, Diskette/Festplatte voll.
  124.  
  125.    HINWEISE
  126.         Die entstehende Datei kann binΣr oder im ASCII-Format sein. Je nach
  127.         Rechnergeschwindigkeit kann die Durchfⁿhrung einige Zeit in Anspruch
  128.         nehmen. (Der Benutzer sollte einen "Warte"-Hinweis bekommen, wenn
  129.         diese Funktion wΣhrend dem interaktiven Betrieb aufgerufen wird.)
  130.  
  131.    BEISPIEL
  132.  
  133.    AUSNAHMEN
  134.  
  135.    FEHLER
  136.  
  137.    SIEHE AUCH
  138.         CompressFile, LhArcFile, DeLhArcFile
  139.  
  140. ------------------------------------------------------------------------------
  141.