# Skript-Referenz

Ein Skript ist eine einfache Textdatei mit einer Abfolge von Befehlen, die das Programm steuern, automatisch Dateioperationen durchführen und Berichte erstellen können. Siehe auch Skripte und Beispielskripte.
Notation | Bedeutung
| | trennt die Wahlmöglichkeiten voneinander
() | umgibt einen erforderlichen Ausdruck
[] | umgibt einen optionalen Ausdruck
<> | umgibt die Beschreibung von erforderlichen Benutzerangaben
[...] | folgt einem Ausdruck, der wiederholt auftreten kann
Sie können lt statt left (links) bzw. rt statt right (rechts) in jedem der Befehle verwenden. Im Folgenden sind die Skript-Befehle alphabetisch aufgeführt: ATTRIB BEEP COLLAPSE COMPARE COPY COPYTO CRITERIA DELETE EXPAND FILE-REPORT FILTER FOLDER-REPORT HEX-REPORT LOAD LOG MEDIA-REPORT MOVE MOVETO OPTION PICTURE-REPORT REGISTRY-REPORT RENAME SELECT SNAPSHOT SYNC TABLE-REPORT TEXT-REPORT TOUCH VERSION-REPORT ATTRIB Verwendung: attrib (+|-)<Attributliste 1> [(+|-)<Attributliste 2> [...]] <Attributliste> kann folgende Werte enthalten: [a][s][h][r] Die macOS- und Linux-Versionen unterstützen kein attrib. Setzt (+) oder entfernt (-) die entsprechenden DOS-Dateiattribute der aktuellen Auswahl. Verwenden Sie a für Archiv, s für System, h für Versteckt/Hidden und r für Schreibgeschützt/Read-only. Beispiele: attrib +h attrib +sh -a BEEP Verwendung: beep Akustisches Signal aus dem PC-Lautsprecher. Das Signal wird trotz des Befehlszeilenschalters /silent ertönen. COLLAPSE Verwendung: collapse all collapse <Pfad 1> [<Pfad 2> [...]] Klappt alle Ordner oder Ordner mit angegebenen Pfaden zu. Die Pfade sind relativ zum Basisordner und dürfen keine Wildcards (Jokerzeichen) enthalten. Beispiel: collapse "Mein Ordner 1" "Mein Ordner 2" COMPARE Verwendung: compare [CRC|binary|rules-based] Vergleicht den Inhalt der aktuellen Auswahl unter Verwendung der angegebenen Vergleichsart (CRC, binär, regelbasiert). Standardmäßig wird die zuletzt benutzte Vergleichsart angewandt. Dieser Befehl vergleicht Dateien nur einmal. Verwenden Sie CRITERIA, um zu ändern, wie Dateien nach Modifikation verglichen werden sollen. COPY Verwendung: copy (left->right|right->left) Kopiert die ausgewählten Dateien/Ordner in die angegebene Richtung: left->right (von links nach rechts) oder right->left (von rechts nach links). COPYTO Verwendung: copyto [left|right|all] [path:(relative|base|none)] <Pfad> Kopiert die ausgewählten Dateien/Ordner der angegebenen Seite in den mit der Option path spezifizierten Pfad. •base (Basis) behält die gesamte Ordnerstruktur relativ zu den Basisordnern aller ausgewählten Objekte bei. •relative (Relativ) behält die minimale relative Ordnerstruktur aller ausgewählten Objekte bei. •Die Standardeinstellungen sind all (alle) und path:none (Pfad:keiner). CRITERIA Verwendung: criteria [attrib:<Attributliste>] [version] [timestamp[:[<Sekundenzahl>sec][;IgnoreDST]]] [size|CRC|binary|rules-based] [timezone:(ignore|(left|right)(+|-)<0..12>)] [follow-symlinks] [ignore-unimportant] <Attributliste> kann folgende Werte enthalten: [a][s][h][r] Die macOS- und Linux-Versionen unterstützen kein attrib. Setzt alle Einstellungen für Vergleichskriterien. •attrib schaltet den Vergleich der spezifizierten DOS-Dateiattribute ein. Verwenden Sie a für Archiv, s für System, h für Versteckt/Hidden und r für Schreibgeschützt/Read-only. •version schaltet den Vergleich von Versionsinformationen ein; üblicherweise in EXE- und DLL-Dateien vorhanden. •timestamp schaltet den Vergleich von Zeit-/Datumsstempeln ein. o<sekundenanzahl>sec sieht Abweichungen innerhalb einer bestimmten Sekundentoleranz als identisch an. o IgnoreDST (Sommerzeit ignorieren) sieht Abweichungen von genau einer Stunde als identisch an. •size (Größe), CRC, binary (Binär) and rules-based (regelbasiert) sind Möglichkeiten Inhalte zu vergleichen. •timezone (Zeitzone) ignoriert Zeitzonenunterschiede oder fügt einer bestimmten Seite einen Zeitzonenversatz hinzu. •follow-symlinks (symbolischen Verknüpfungen folgen) behandelt symbolische Verknüpfungen und NTFS-Abzweigungspunkte als Zieldatei oder -ordner, statt als die Verknüpfung selbst. •ignore-unimportant (Unwichtiges ignorieren) behandelt unwichtige Unterschiede als identisch. Beispiel: criteria attrib:sh timestamp:2sec;IgnoreDST rules-based timezone:left+6 DELETE Verwendung: delete [recyclebin=(yes|no)] (left|right|all) Löscht die aktuell ausgewählten Dateien/Ordner auf den angegebenen Seiten. Das Argument recyclebin (Papierkorb) hat nur Auswirkungen, wenn es vom Betriebssystem unterstützt wird. Netzwerklaufwerke, entfernte Dienste und Archivdateien unterstützen es nicht. EXPAND Verwendung: expand all expand <Pfad 1> [<Pfad 2> [...]] Klappt die angegebenen Unterordner oder alle Unterordner auf. Die Pfade sind relativ zum Basisordner und dürfen keine Wildcards (Jokerzeichen) enthalten. Unterordner müssen aufgeklappt werden, um ihren Inhalt mit weiteren Befehlen zu bearbeiten, wie z.B. SELECT (Auswählen). expand all wird keine Unterordner aufklappen, die aufgrund von Dateifiltereinstellungen vom Vergleich ausgeschlossen wurden. FILE-REPORT Verwendung: file-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Bericht der aktuell ausgewählten Dateien basierend auf dem Typ der zu verarbeitenden Dateien. Zum Beispiel: es wird ein TABLE-REPORT (Tabellenbericht) für Dateitypen, die mit einem Tabellenvergleich-Dateiformat verknüpft sind, erstellt. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander) oder summary (Zusammenfassung) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text als identisch und ist in allen Layouts verfügbar. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. o line-numbers gibt Zeilennummern im side-by-side-Layout aus. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. Beispiel: file-report layout:side-by-side options:display-mismatches & output-to:printer output-options:print-color,wrap-word FILTER Verwendung: filter <Dateimasken> filter cutoff:([<|>](<Zeitstempel>|<Tagesanzahl>[days])|none) filter attrib:((+|-)<Attributliste>|none) filter size:([<|>]<Zahl>[KB|MB|GB|TB]|none) filter exclude-protected filter include-protected <Attributliste> kann folgende Werte enthalten: [a][s][h][r] Die macOS- und Linux-Versionen unterstützen kein attrib, exclude-protected oder include-protected. Steuert welche Ordner und Dateitypen verglichen werden, unter Verwendung von Namenfilterung (Dateimasken), Datumsfilterung (cutoff =Datumsschwellenwert) oder anderen Filterungen (attrib (Attribute), size (Größe), exclude-protected (Geschützte ausschließen) oder include-protected (Geschützte einbeziehen)). •Namenfilter schließen Dateien und Ordner basierend auf ihren Namen und Pfaden ein oder aus. Mehrere Masken können mit einem Semikolon getrennt werden. Um anzuzeigen, dass es sich bei einer Maske um eine Ausschlussmaske handelt, verwenden Sie ein führendes Minuszeichen (-). Um anzuzeigen, dass sich eine Maske auf Ordner auswirkt, verwenden Sie einen angehängten, umgekehrten Schrägstrich bzw. Backslash (\). •cutoff schließt alle Dateien aus, die älter (<) oder neuer (>) als der Zeitstempel sind, oder als eine Anzahl von Tagen vom aktuellen Systemdatum aus (<Tagesanzahl>days). Standardmäßig wird cutoff:< verwendet. none kann zum Ausschalten der Datumsfilterung verwendet werden. Die Datumsanalyse ist einigermaßen nachsichtig. Wenn Sie jedoch sicher sein wollen, dass das Datum korrekt erkannt wird, dann verwenden Sie jenes Format, welches in den Regionaleinstellungen Ihres Betriebssystems festgelegt ist. (Siehe Systemsteuerung > Datums-, Zeit-, Sprach- und Regionaleinstellungen.) Die Uhrzeitangabe ist optional, sollte aber hinter der Datumsangabe folgen (cutoff:"31.12.2012 13:00"). Vergessen Sie bitte nicht, Anführungszeichen (" ") zu verwenden, wenn ein Ausdruck Leerzeichen enthält. •attrib beschränkt den Vergleich auf Dateien mit bestimmten, einbezogenen DOS-Dateiattributen (+), und Dateien, die kein ausgeschlossenes Attribut haben (-). Verwenden Sie a für Archiv, s für System, h für Versteckt/Hidden und r für Schreibgeschützt/Read-only. none kann zum Ausschalten der Attributfilterung verwendet werden. •size schließt alle Dateien aus, die kleiner (<) oder größer (>) als die angegebene Größe sind. Standardmäßig wird die Größe in Bytes angegeben. Sie können jedoch KB, MB, GB oder TB am Ende anfügen, um Werte in Kilo-, Mega-, Giga- bzw. Terabytes darzustellen. none kann zum Ausschalten der Größenfilterung verwendet werden. •exclude-protected schließt Dateien und Ordner aus, bei denen sowohl das System- als auch das Versteckt/Hidden-Attribut gesetzt ist. •include-protected bezieht Dateien und Ordner ein, bei denen sowohl das System- als auch das Versteckt/Hidden-Attribut gesetzt ist. Beispiele: filter "*.pas;*.dpr;*.dfm" filter cutoff:<7days filter cutoff:>"Dec 31, 2012" filter cutoff:"12/31/2012 12:00pm" filter attrib:-sh filter "*.txt;-Mein Ordner\" attrib:+r FOLDER-REPORT Verwendung: folder-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] Generiert einen Ordnervergleichsbericht der aktuell geladenen Basisordner. Ordner werden in ihrem aktuellen Zustand gezeigt. Um Unterordner einzubeziehen fügen Sie zuvor den Befehl expand all (alle Ordner aufklappen) ein. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander), summary (Zusammenfassung) oder interleaved (überlappend) sein. •options (Optionen) ist optional. oAnzeigefilter-Flags steuern, welche Dateien in den Bericht einbezogen werden. Die möglichen Werte sind display-all (alle anzeigen), display-mismatches (Unterschiede anzeigen), display-no-orphans (keine Singles anzeigen), display-mismatches-no-orphans (Unterschiede aber keine Singles anzeigen), display-orphans (Singles anzeigen), display-left-newer (linksseitig neuere anzeigen), display-right-newer (rechtsseitig neuere anzeigen), display-left-newer-orphans (Linksseitig neuere und Singles anzeigen), display-right-newer-orphans (Rechtsseitig neuere und Singles anzeigen), display-left-orphans (linksseitige Singles anzeigen), display-right-orphans (rechtsseitige Singles anzeigen) und display-matches (Identische anzeigen). Standardmäßig wird display-all (alle anzeigen) verwendet. oOptionale Spalten können kommasepariert in den Bericht einbezogen werden. Die möglichen Werte sind: column-version (Version), column-size (Größe), column-crc (CRC-Wert), column-timestamp (Änderungsdatum), column-attributes (Attribute), column-group (Gruppe), column-owner (Besitzer) und column-vcs (Versionskontrolle). Standardmäßig sind column-size (Größe) und column-timestamp (Änderungsdatum) einbezogen. column-none kann verwendet werden, um die Standardspalten zu entfernen. oVerwenden Sie das Flag include-file-links (Dateiverknüpfungen einbeziehen), um Dateiberichte zu generieren und im Ordnerbericht Verknüpfungen auf diese einzubeziehen. Nur ein Ordnerbericht, der sowohl Nebeneinander-Darstellung hat als auch HTML ist, kann dieses Kennzeichen benutzen. •Die Argumente title (Titel), output-to (Ausgabeort) und output-options (Ausgabeoptionen) sind unter Allgemeine Parameter für Berichte dokumentiert. Beispiele: folder-report layout:side-by-side & options:column-size,column-version,column-timestamp & output-to:clipboard output-options:html-color folder-report layout:xml output-to:"C:\Mein Bericht.xml" HEX-REPORT Verwendung: hex-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Hex-Vergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander), summary (Zusammenfassung) oder interleaved (überlappend) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. o line-numbers (Zeilennummern) beziehen die Byte-Adressen in das side-by-side-Layout mit ein. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. LOAD Verwendung: load <Sitzung> load [create:(all|left|right)] <linker Pfad> [<rechter Pfad>] load <default> Lädt die angegebene Ordnervergleichssitzung, die angegebenen Basisordner oder eine neue Ordnervergleichssitzung mit Standardeinstellungen (load <default>). Auftretende Fehler beim Laden eines Basisordners führen zum Abbruch des Skripts. •Das Laden einer Sitzung führt dazu, dass alle ihre Einstellungen verwendet werden, außer den Anzeigefiltern (alle zeigen, nur Unterschiede, nur Identische usw.). •Beim Laden von Basisordnern werden die aktuell aktiven Einstellungen verwendet. Standardmäßig werden die Programmstandards verwendet. •Der optionale Parameter create (erstellen) legt einen neuen Basisordner an, sofern er noch nicht existiert. Beispiele: load "Meine Sitzung" load "C:\Mein Ordner" "X:\Dein Ordner" load <default> LOG Verwendung: log [none|normal|verbose] [[append:]<Dateiname>] Steuert den Detaillierungsgrad der Log-Meldungen und ihren Ablageort. •none (keine), normal und verbose (ausführlich) bestimmen den Detaillierungsgrad der Log-Meldungen. Zu Beginn ist die Log-Funktionalität ausgeschaltet, und beginnt erst, wenn der Modus von none gewechselt wird. •append: (anhängen) führt dazu, dass die Log-Meldungen an eine bestehende Datei angefügt werden, statt sie zu ersetzen. Standardmäßig werden die Log-Meldungen in die Log.txt in den aktuellen Ordner geschrieben (z.B. der Windows "Ausführen in"-Ordner in den Verknüpfungseigenschaften). MEDIA-REPORT Verwendung: media-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Medienvergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander) oder summary (Zusammenfassung) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text als identisch und ist in allen Layouts verfügbar. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. MOVE Verwendung: move (left->right|right->left) Verschiebt die ausgewählten Dateien/Ordner in die angegebene Richtung. MOVETO Verwendung: moveto [left|right|all] [path:(relative|base|none)] <Pfad> Verschiebt die ausgewählten Dateien/Ordner der angegebenen Seite in den mit der Option path spezifizierten Pfad. •base (Basis) behält die gesamte Ordnerstruktur relativ zu den Basisordnern aller ausgewählten Objekte bei. •relative (Relativ) behält die minimale relative Ordnerstruktur aller ausgewählten Objekte bei. •Die Standardeinstellungen sind all (alle) und path:none (Pfad:keiner). OPTION Verwendung: option stop-on-error option confirm:(prompt|yes-to-all|no-to-all) Stellt Optionen für die Skriptverarbeitung ein. •stop-on-error (bei Fehler anhalten) lässt das Skript auf verschiedene Fehlersituationen achten, inklusive Fehler bei Dateioperationen, und informiert den Anwender bei Fehlerauftritt bevor das Skript weiter ausgeführt wird. •confirm (bestätigen) kann prompt (nachfragen), yes-to-all (stets Ja antworten) oder no-to-all (stets Nein antworten) verwenden, um Bestätigungsdialoge abzuarbeiten, die bei Dateioperationen auftreten könnten. Standardmäßig wird prompt (nachfragen) verwendet. PICTURE-REPORT Verwendung: picture-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Bildvergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander) oder summary (Zusammenfassung) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text im summary-Layout als identisch. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. REGISTRY-REPORT Verwendung: registry-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Registry-Vergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander) oder summary (Zusammenfassung) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. RENAME Verwendung: rename [regexpr <Alte Maske>] <Neue Maske> Führt, unter Verwendung der angegebenen neuen Maske, eine Mehr-Dateien-Umbenennung auf der aktuellen Auswahl durch. regexpr (regulärer Ausdruck) verwendet eine alte Maske, um eine Umbenennung mit regulären Ausdrücken durchzuführen. Standardmäßig wird eine Umbenennung in DOS-Weise durchgeführt. Beispiele: rename *.bak rename regexpr (...)(...)\.txt $2$1.txt SELECT Verwendung: select <Auswahlmaske 1> [<Auswahlmaske 2> [...]] <Auswahlmaske> kann eine der folgenden sein: all [(left|right|all).][(exact|diff|newer|older|orphan|all).][(files|folders|all)] empty.folders Steuert, auf welchen Dateien und Ordnern Operationen ausgeführt werden können. Lediglich Dateien und Ordner, die mindestens einer der Auswahlmasken entsprechen, werden Teil der Auswahl. •left (links), right (rechts) oder all (alle) beschränkt die Auswahl auf die angegebene Seite. Standardmäßig wird all (alle) verwendet. •exact (identisch), diff (ungleich), newer (neuer), older (älter), orphan (Single) oder all (alle) beschränkt die Auswahl basierend auf dem Vergleichsergebnis. diff bezieht sich auf Unterschiede aufgrund von Kriterien statt des Zeitstempels. Um Zeitstempel zu vergleichen, verwenden Sie stattdessen newer (neuer) oder older (älter). Ordner müssen den angegebenen Ergebnistyp enthalten, um betroffen zu sein. Standardmäßig wird all (alle) verwendet. •files (Dateien), folders (Ordner) oder all (alle) beschränkt die Auswahl auf Dateien, Ordner oder beides. Standardmäßig wird all (alle) verwendet. •Bei empty.folders (leere Ordner) handelt es sich um eine spezielle Auswahlmaske, die leere Ordner auswählt. Beispiele: select all select left select exact select files select right.diff select left.folders select newer.files right.older.files SNAPSHOT Verwendung: snapshot [save-crc] [save-version] [expand-archives] [follow-symlinks] [include-empty] [no-filters] left|right|path:<Pfad> [output:<Ziel>] Speichert einen Schnappschuss (nur lesbar) des angegebenen Ordners. •save-crc (CRC speichern) berechnet CRC-Werte für alle Dateien und speichert sie als Teil des Schnappschusses. •save-version (Version speichern) speichert Versionsinformationen ausführbarer Dateien. •expand-archives (Archive erweitern) speichert den Inhalt von Archivdateien in erweitertem Format. •follow-symlinks (symbolischen Verknüpfungen folgen) speichert jene Dateien und Ordner, auf die symbolische Verknüpfungen zeigen. •include-empty (leere Ordner einbeziehen) speichert Ordner, die leer sind oder nur ausgeschlossene Dateien enthalten. •no-filters (keine Filter) speichert alle Dateien ohne Rücksicht auf aktive Dateinamenfilter. •left (links), right (rechts) und path (Pfad) geben den zu speichernden Ordner an. left (links) oder right (rechts) speichern einen Schnappschuss einer der geladenen Basisordner, und path (Pfad) speichert einen Schnappschuss des angegebenen Pfades. •output (Ausgabe) ist optional und bestimmt, wo der Schnappschuss gespeichert werden soll. Standardmäßig wird er im aktuellen Ordner gespeichert. oWenn das Ziel ein vollständiger Dateiname ist, wird dieser der Name des Schnappschusses. Wenn für das Ziel keine Dateierweiterung angegeben ist, wird .bcss verwendet. oWenn kein Ziel angegeben wird oder sich auf einen Ordner bezieht, wird ein Dateiname generiert; basierend auf dem Namen des Quellordners und dem aktuellen Systemdatum, z.B. ordner_2012-12-31.bcss. Wenn nötig, wird eine Zahl an den generierten Namen angehängt, damit bereits existierende Schnappschüsse nicht überschrieben werden. Beispiele: snapshot save-crc save-version no-filters path:C:\ output:D:\ snapshot left output:"Mein Schnappschuss.bcss" SYNC Verwendung: sync [visible] [create-empty] (update|mirror):(left->right|right->left|all) Synchronisiert Ordner durch Kopieren und Löschen von Dateien. Dieser Befehl verwendet nicht die aktuelle Auswahl. •visible (sichtbar) aktiviert das Verhalten "Auswirkung nur auf sichtbare Dateien". Hat nur Auswirkungen auf Dateien in aufgeklappten Ordnern. •create-empty (leere Ordner erstellen) aktiviert das Verhalten "Leere Ordner erstellen". •update (aktualisieren) kopiert neuere Dateien und Datei-Singles in die angegebene Richtung, wobei Datei-Singles und neuere Dateien auf der gegenüberliegenden Seite unverändert bleiben. Die Verwendung von all (alle) als Richtung bedeutet, dass eine bidirektionale Synchronisation ausgeführt wird, so dass neuere Dateien und Datei-Singles in beide Richtungen kopiert werden. •mirror (spiegeln) macht den Zielordner zum identischen Abbild des Quellordners. Neuere, ältere und ungleiche Dateien sowie Datei-Singles werden zum Ziel kopiert. Datei-Singles im Ziel werden gelöscht. Die Richtung all (alle) ist hierbei nicht möglich, und wird nicht funktionieren. Beispiel: sync create-empty mirror:left->right TABLE-REPORT Verwendung: data-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Tabellenvergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander), summary (Zusammenfassung) oder interleaved (überlappend) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text als identisch und ist in allen Layouts verfügbar. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. o line-numbers gibt Zeilennummern im side-by-side-Layout aus. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. TEXT-REPORT Verwendung: text-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Textvergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichtes, und kann side-by-side (nebeneinander), summary (Zusammenfassung), interleaved (überlappend), patch, statistics (Statistiken) oder xml sein. Die veralteten Layouts over-under und composite wurden durch interleaved (überlappend) ersetzt. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text als identisch und ist in allen Layouts verfügbar. o display-all (alle anzeigen), display-mismatches (Ungleiche anzeigen), display-context (Ungleiche mit Kontext anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary, patch und statistics einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. o line-numbers gibt Zeilennummern im side-by-side-Layout aus. o strikeout-left-diffs (linksseitige Unterschiede durchstreichen) streicht im interleaved (überlappend) Layout nur die linksseitigen Zeilen durch, die unterschiedlich sind. o strikeout-right-diffs (rechtsseitige Unterschiede durchstreichen) streicht im interleaved (überlappend) Layout nur die rechtsseitigen Zeilen durch, die unterschiedlich sind. oDie Formate patch-normal, patch-context oder patch-unified sind im patch-Layout verfügbar. Standardmäßig wird patch-normal verwendet. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. Die veraltete Option stats-descriptive generiert stattdessen einen zusammenfassenden Bericht, und eine Warnung wird als Log-Meldung ausgegeben. Die veraltete Option stats-tabular wird im statistics-Layout ignoriert: Das statistics-Layout ist jetzt immer tabellenartig (CSV = kommaseparierte Werte). Beispiele: text-report layout:interleaved options:display-context & output-to:printer output-options:print-color,wrap-word text-report layout:patch options:patch-unified & output-to:"Mein Bericht.txt" TOUCH Verwendung: touch (left->right|right->left) touch (left|right|all):(now|<Zeitstempel>) Kopiert die Datei-Zeitstempel von einer Seite auf die andere, oder setzt den Zeitstempel aller Dateien einer bestimmten Seite auf die aktuelle Systemzeit (now (jetzt)) oder auf einen angegebenen Zeitstempel. Bevor Sie Zeitstempel anpassen können, müssen Sie Dateien auswählen. VERSION-REPORT Verwendung: version-report layout:<Layout> [options:<Optionen>] [title:<Berichtstitel>] output-to:(printer|clipboard|<Dateiname>) [output-options:<Optionen>] [<Vergleich>] Generiert einen Versionsvergleichsbericht der aktuell ausgewählten Dateien. •layout steuert das Erscheinungsbild des Berichts. Dieses kann side-by-side (nebeneinander) oder summary (Zusammenfassung) sein. •options ist optional, und ist für jedes Layout unterschiedlich. o ignore-unimportant (Unwichtiges ignorieren) behandelt Unterschiede in unwichtigem Text als identisch und ist in allen Layouts verfügbar. o display-all (alles anzeigen), display-mismatches (Unterschiede anzeigen) oder display-matches (Identische anzeigen) können verwendet werden, um zu steuern, welche Zeilen des Vergleichs in allen Layouts außer summary (Zusammenfassung) einbezogen werden sollen. Standardmäßig wird display-all (alle anzeigen) verwendet. •Die Argumente title (Titel), output-to (Ausgabeort), output-options (Ausgabeoptionen) und <vergleich> sind unter Allgemeine Parameter für Berichte dokumentiert. Allgemeine Parameter für Berichte Die Berichtsbefehle (data-report, file-report, folder-report, hex-report, media-report, picture-report, registry-report, text-report und version-report) müssen Informationen darüber enthalten, wohin der Bericht gesendet werden soll und können zusätzliche Informationen über das Ausgabeformat enthalten. •title (Titel) ist der Titel, der über dem Bericht erscheint. •output-to (Ausgabeziel) steuert das Ausgabeziel. Dieses kann printer (Drucker), clipboard (Zwischenablage) oder ein Dateiname sein. •output-options (Ausgabeoptionen) ist optional und wird für jedes Ausgabeziel jeweils unterschiedlich verwendet. oDie Farbschemata print-color (farbig) oder print-mono (schwarz/weiß) stehen der Ausgabe printer (Drucker) zur Verfügung. Standardmäßig wird print-mono (schwarz/weiß) verwendet. oDie Druckausrichtungen print-portrait (hochkant) oder print-landscape (waagerecht) stehen der Ausgabe printer (Drucker) zur Verfügung. Standardmäßig wird print-portrait (hochkant) verwendet. o wrap-none (nichts umbrechen), wrap-character (Zeichen umbrechen) oder wrap-word (Wort umbrechen) steuern das Umbrechen langer Zeilen. Die printer-Ausgabe kann alle drei Optionen verwenden. Die HTML-Ausgabe kann wrap-none (ohne Umbruch) und wrap-word (Zeilenumbruch) verwenden. Standardmäßig wird wrap-none (ohne Umbruch) verwendet. o html-color (farbig), html-mono (schwarz/weiß) oder html-custom (eigenes) werden für die Ausgabe als HTML statt der Ausgabe als reinen Text benötigt. Diese Optionen stehen für die Ausgaben clipboard (Zwischenablage) und file (Datei) zur Verfügung. html-custom benötigt den Dateinamen oder die URL eines externen Stylesheets. •<vergleich> kann entweder ein Sitzungsname oder ein Dateinamenpaar sein. Der Dateibericht wird den spezifizierten Vergleich verwenden, statt jener Dateien, die innerhalb des Skriptes ausgewählt wurden. Wenn Sie eine gespeicherte Sitzung verwenden, muss der Vergleichstyp zum Berichtstyp passen (z.B. muss eine Tabellenvergleichssitzung einen data-report oder file-report verwenden). Beispiele: data-report layout:interleaved output-to:printer & output-options:print-color,print-landscape file-report layout:summary output-to:clipboard & output-options:wrap-word,html-color text-report layout:patch options:patch-unified & output-to:"Mein Bericht.txt"