home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Backup / diavolo_131_reg.lha / DiavoloStandard.filter < prev    next >
Encoding:
Text File  |  1995-02-23  |  5.8 KB  |  180 lines
  1. ; DiavoloStandard.filter
  2. ;
  3. ; Beispiel und Dokumentation für Filter in Diavolo Backup
  4. ;
  5. ; V1.28 17-10-94
  6. ;
  7. ;
  8. ; *************************************************************************
  9. ; *************************************************************************
  10. ;
  11. ; Zweck:
  12. ; ======
  13. ;   Damit Sicherungen automatisch ablaufen können, muß ein Weg vorhanden
  14. ;   sein, Dateien automatisch nach bestimmten Kriterien auszuwählen.
  15. ;   Filter bieten diese Möglichkeit.
  16. ;
  17. ; Anwendung:
  18. ; ==========
  19. ;   In der Geräteauswahl findet man das neues Gadget "Filter". Wird dieses
  20. ;   ausgewählt, so kann über den Dateidialog eine Textdatei als Filter
  21. ;   ausgewählt werden. Diavolo geht dann jede Zeile dieser Datei durch und
  22. ;   führt die darin angegebenen Anweisungen durch.
  23. ;   Später kann ein Filter auch durch externe Programme (ARexx, Scheduler)
  24. ;   aktiviert werden.
  25. ;
  26. ; Aufbau:
  27. ; =======
  28. ;   Eine Filter ist eine Textdatei, die mit jedem Editor erstellt und
  29. ;   bearbeitet werden kann. Der Aufbau ist einfach und entspricht weitest-
  30. ;   gehend der Bedienabfolge bei manueller Dateiauswahl.
  31. ;
  32. ;   Kommentarzeilen werden mit einem Strichpunkt (;) eingeleitet (Es können
  33. ;   keine Kommentare an eine Befehlszeile angehängt werden!).
  34. ;
  35. ;   Bevor Dateien und Verzeichnisse ausgewählt werden können, muß zunächst
  36. ;   eine Partition eingescannt werden. Das sieht z.B. so aus:
  37. ;
  38. ; SCAN Work:
  39. ;
  40. ;   Diese Zeile (ohne den Strichpunkt) würde die Partition Work vollständig
  41. ;   einscannen. Zunächst ist jedoch noch keine Datei dieser Partition aus-
  42. ;   gewählt. Der Vorgang entspricht einem Doppelklick auf eine Partition in
  43. ;   der Datenträgerliste.
  44. ;
  45. ;   Es können nicht nur Partitionen eingescannt werden, mehr dazu in der
  46. ;   detailierteren Beschreibung weiter unten.
  47. ;
  48. ;   Nachdem die Partition eingescannt wurden, können Dateien selektiert
  49. ;   werden. Die folgende Zeile würde alle Dateien dieser Partition aus-
  50. ;   wählen:
  51. ;
  52. ; INCLUDE #?
  53. ;
  54. ;   Um z.B. .bak Dateien wieder zu deselektieren kann die Zeile
  55. ;
  56. ; EXCLUDE #?.bak
  57. ;
  58. ;   angegeben werden.
  59. ;   Sollen Dateien aus einem bestimmten Verzeichnis eingeschlossen werden,
  60. ;   so kann der Pfad mit angegeben werden. So selektiert die folgende An-
  61. ;   weisung alle Dateien des Pfades Work:Diavolo:
  62. ;
  63. ; INCLUDE Diavolo/#?
  64. ;
  65. ;   Bitte beachten: Der Partitionsname darf nicht mehr angegeben werden.
  66. ;   Ausserdem muß jedes Verzeichnis mit einem / abgeschlossen werden, also
  67. ; INCLUDE Diavolo
  68. ;   würde NICHT funktionieren.
  69. ;
  70. ;   Es können noch eine Reihe von Optionen angegeben werden:
  71. ;
  72. ;   NOSUBDIRS:
  73. ;     Normalerweise werden auch Dateien in Unterverzeichnissen 
  74. ;     mitselektiert. Mit dieser Option wird das verhindert
  75. ;     Beispiel:
  76. ;       INCLUDE Sourcen/Test.c
  77. ;         Selektiert alle Dateien mit dem Namen "Test.c" im Verzeichnis
  78. ;         Sourcen und allen seinen Unterverzeichnissen.
  79. ;       INCLUDE Sourcen/Test.c NOSUBDIRS
  80. ;         Selektiert nur die Datei "Test.c" (so sie vorhanden ist). Das
  81. ;         ist die einzige Methode nur eine einzige Datei zu 
  82. ;         (de)selektieren!
  83. ;
  84. ;   NOEMPTYDIRS:
  85. ;     Leere Verzeichnisse werden ohne diese Option immer miteinbezogen.
  86. ;     Z.B. deselektiert die Zeile
  87. ;       EXCLUDE #?.bak
  88. ;     auch alle leeren Verzeichnisse. Um das zu vermeiden, muß die Zeile
  89. ;     wie folgt geschrieben werden:
  90. ;       EXCLUDE #?.bak NOEMPTYDIRS
  91. ;     Hard- und Softlink-Verzeichnisse werden ebenfalls als leer an-
  92. ;     gesehen!
  93. ;
  94. ;   ARCHSET:
  95. ;     Wird diese Option angegeben, so werden nur Dateien mit gesetztem
  96. ;     Archivbit berücksichtigt.
  97. ;
  98. ;   ARCHUNSET:
  99. ;     Das selbe, nur diesmal mit NICHT gesetztem Archivbit.
  100. ;
  101. ;   DATE:
  102. ;     Diese Option erlaubt eine Angabe eines Datums. Es werden dann nur
  103. ;     Dateien, die am angegebenen Tag oder später geschrieben wurden,
  104. ;     berücksichtigt.
  105. ;     Beispiel:
  106. ;       INCLUDE #?.c DATE 1.10.1994
  107. ;
  108. ;
  109. ;   Nun ein paar Detailinformationen für Insider:
  110. ;
  111. ;   Die Zeilen werden über ReadArgs() eingelesen. Der Template sieht wie
  112. ;   folgt aus:
  113. ;   SCAN=S/S,INCLUDE=+/S,EXCLUDE=-/S,PATH/A,ARCHSET/S,ARCHUNSET/S,
  114. ;     NOSUBDIRS/S,NOEMPTYDIRS/S,SINCE=DATE
  115. ;
  116. ;   SCAN kann also durch S abgekürzt werden, INCLUDE durch ein einfaches + 
  117. ;   und EXCLUDE durch - .
  118. ;
  119. ;   Mit SCAN können nicht nur Partitionen gescannt werden. Es sind auch 
  120. ;   Assigns, Multiassigns und beliebige Pfade möglich.
  121. ;
  122. ;   Bei Pfaden und Assigns können, wie oben beschrieben, Dateien aus Unter-
  123. ;   verzeichnissen selektiert werden. Beispiel:
  124. ;
  125. ;     SCAN Work:ProgrammEntwicklung/Sourcen
  126. ;     INCLUDE Diavolo/#?.(c|h)
  127. ;     INCLUDE MagicMenu/#?.(c|h)
  128. ;
  129. ;   Die angegebenen Unterverzeichnisse beziehen sich also immer auf den
  130. ;   eingescannten Pfad. Im obigen Beispiel darf der Pfad "Work:..."
  131. ;   nicht in den INCLUDE Zeilen mit angegeben werden!
  132. ;
  133. ;   Bei Multiassigns ist es nicht möglich, Unterverzeichnisse anzugeben.
  134. ;   Es können nur global Dateien nach bestimmten Eigenschaften (Pattern,
  135. ;   Archivbit etc.) selektiert werden.
  136. ;
  137. ;
  138. ; Beispiele:
  139. ; ==========
  140. ;
  141. ;   Einscannen der Work: Partition und alle Dateien selektieren:
  142.  
  143. SCAN Work:
  144. INCLUDE #?
  145.  
  146.  
  147. ;   (Ab jetzt wird die Kurzschreibweise, also S für SCAN, + für INCLUDE
  148. ;   und - für EXCLUDE, benutzt)
  149. ;
  150. ;   Einscannen der DH0: Partiton. Alle Dateien, die das Archivbit nicht
  151. ;   gesetzt haben (also seit der letzten Sicherung verändert wurden)
  152. ;   selektieren. Alle .bak Dateien deselektieren. Leere Verzeichnisse
  153. ;   nicht mitsichern:
  154.  
  155. S DH0:
  156. + #? ARCHUNSET NOEMPTYDIRS
  157. - #?.bak
  158.  
  159.  
  160. ;   Aus dem Fonts-Verzeichnis (Assigments) nur die Fonts "Helvetica",
  161. ;   "XHelvetica" und "XCourier" sichern:
  162. ;   (Falls Fonts: ein Multiassignment ist, muß stattdessen z.B.
  163. ;   sys:fonts geschrieben werden!)
  164.  
  165. S Fonts:
  166. + Helvetica/#?
  167. + XHelvetica/#?
  168. + XCourier/#?
  169. + (Helvetica|XHelvetica|XCourier).font
  170.  
  171.  
  172. ;   Alle Preferences-Programme sichern, nicht jedoch Env-Archive und andere
  173. ;   Unterverzeichnisse. Ausserdem soll NUR dieses Verzeichnis gescannt 
  174. ;   werden:
  175.  
  176. S Sys:Prefs
  177. + #? NOSUBDIRS
  178.  
  179.  
  180.