fwts – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

fwts – eine Firmware-Testsuite zur Identifizierung von Firmware-Fehlern.

ZUSAMMENFASSUNG

fwts [Optionen] [Test(e)]

BESCHREIBUNG

Diese Handbuchseite dokumentiert kurz die fwts Firmware-Testsuite. Das Werkzeug fwts is
Es besteht aus über fünfzig Tests, mit denen verschiedene Aspekte untersucht und getestet werden sollen
PC-Firmware. Viele dieser Tests benötigen Superuser-Zugriff, um Tabellen zu extrahieren und zu interagieren
mit der Firmware und ACPI, also läuft fwts Die Verwendung von Sudo ist erforderlich.
Laufen fwts Ohne Optionen werden alle Batch-Tests ausgeführt, für die kein Benutzer erforderlich ist
Interaktion. Bei Bedarf kann man jedoch auch nur bestimmte Tests zur Ausführung auswählen.

Standardmäßig fwts gibt die Testergebnisse in die Protokolldatei aus results.log jedoch ein anderes
Der Name der Protokolldatei kann angegeben und bei Bedarf auf stderr oder stdout ausgegeben werden
ausgewählt.

Beachten Sie, dass es eine Vielzahl von Tests gibt, einschließlich Tests, die möglicherweise dazu führen können, dass eine Maschine hängen bleibt
(z. B. Suspend/Ruhezustand/Fortsetzung).

OPTIONAL

Die FWT-Optionen lauten wie folgt:

- Ergebnisse auf stdout ausgeben.

--acpica
Aktivieren Sie die Optionen für den ACPICA-Ausführungsmodus. Diese können durch Kommas getrennt angegeben werden
Liste mit einer oder mehreren Optionen. Verfügbare Optionen sind: serialisiert (serialisiert
Ausführung von AML), Slack (im weniger umständlichen Modus ausführen), Ignore-Fehler (ACPICA ignorieren
Ausnahmefehler), Disable-Auto-Repair (ACPICA wird von der automatischen Reparatur ausgeschlossen
defekte ACPICA-Steuerungen). Beachten Sie, dass der Slack-Modus implizite Rückgaben von aktiviert
Null auf Kontrollmethoden, um zu versuchen, fehlerhaftes AML auf Nicht-Windows-Betriebssystemen funktionieren zu lassen
Systemen.

--acpica-debug
Aktivieren Sie ACPICA-Debug-Warnungen und Fehlermeldungen beim Aufrufen des ACPICA-Subsystems.
Dies ist hauptsächlich für FWT-Entwickler gedacht, um bei der Suche nach Problemen mit der ACPICA-Schnittstelle zu helfen
mit fwts.

--acpicompliance
Führen Sie nur Tests durch, die speziell die Einhaltung des ACPI prüfen
Spezifikationen. Dies kann eine Teilmenge der ACPI-Tests sein.

-a, --alle
Führen Sie alle Tests durch.

--arch=Name
Geben Sie die Zielarchitektur an, deren Firmware getestet wird. Dies ermöglicht FWTs
auf einer Architektur (dem Host) laufen, aber Tests für eine andere durchführen
Architektur (das Ziel). Bekannte Architekturzeichenfolgen sind: x86, x86_32 oder x86_64
für Intel; ia64 für Itanium; arm64 oder aarch64 für ARMv8. Es sei denn, diese Option ist
angegeben, wird davon ausgegangen, dass das Ziel mit dem Host identisch ist.

-B, --Charge
Führen Sie die nicht interaktiven Batch-Tests aus. Batch-Tests erfordern keine Benutzerinteraktion.

--batch-experimental
Führen Sie nur Batch-Versuchstests durch.

--disassemble-aml
Zerlegen Sie den AML-Bytecode (ACPI-Maschinensprache). Dadurch wird versucht, AML zu zerlegen
in DSDT- und SSDT-Tabellen und generiert DSDT.dsl- und SSDTx.dsl-Quellen.

-D, --entsorgen
extrahiert Firmware-Daten und speichert sie in Protokolldateien. Dadurch entsteht:
acpidump.log – enthält einen Hex-Dump der ACPI-Tabellen (der mit gelesen werden kann).
acpixtract).
dmesg.log – enthält die aktuellen Kernel-Protokollmeldungen.
dmidecode.log – enthält die Ausgabe von dmidecode.
lspci.log – enthält die Ausgabe von lspci -vv -nn
cpuinfo.log – enthält die Ausgabe von cat / proc / cpuinfo
README.txt – enthält einen Zeitstempel und Informationen zur Kernel-Version.

--dumpfile=acpidump.log
Laden Sie ACPI-Tabellen aus der Ausgabe, die von acpidump oder von sudo fwts --dump generiert wurde. Der
Letzteres wird bevorzugt, da fwts --dump mehr Tabellen sichern kann als acpidump. Das
ermöglicht es, Tabellen von einem Computer zu sichern und sie mit FWTs auf einem anderen zu verarbeiten
Maschine.

--uefi-get-var-multiple
Gibt an, wie oft eine Variable in der uefirtvariable-Get-Variable abgerufen werden soll
Stresstest.

--uefi-set-var-multiple
Gibt an, wie oft eine Variable in der Set-Variable uefirtvariable festgelegt werden soll
Stresstest.

--uefi-query-var-multiple
Gibt an, wie oft eine Variable in der uefirtvariable-Abfrage abgefragt werden soll
Variabler Stresstest.

--filter-error-discard
gibt die Fehler an, die man stillschweigend ignorieren möchte. Man liefert ein Komma
Getrennte Liste von Fwts-Fehlermeldungsbezeichnungen, als die Fwts nicht melden soll
Fehler. fwts führt den Test aus, wenn jedoch ein Testfehler auftritt und die Bezeichnung übereinstimmt
Das in dieser Liste angegebene fwts wird diesen Fehler dann einfach ignorieren. Das kann nicht sein
Wird mit --filter-error-keep verwendet.

--filter-error-keep
gibt die Fehler an, die man behalten möchte, alle anderen Fehler werden stillschweigend ignoriert.
Man liefert eine durch Kommas getrennte Liste von Fwts-Fehlermeldungsbezeichnungen, die man fwts haben möchte
als Fehler melden, andere Testfehler werden nicht gemeldet und stillschweigend ignoriert.
Dies kann nicht mit --filter-error-discard verwendet werden.

-F, --force-clean
erstellt eine neue Ergebnisprotokolldatei, anstatt sie einfach an eine vorhandene anzuhängen
(Standard).

-H, --help
gibt die interne Hilfeseite aus.

-ich, --interaktiv
Führen Sie die interaktiven Tests durch. Diese Tests erfordern eine Benutzerinteraktion.

--interactive-experimental
Führen Sie nur interaktive experimentelle Tests durch.

-J, --json-data-path
Gibt den Pfad zu den fwts-JSON-Datendateien an. Diese Dateien sind JSON-formatiert
Konfigurationstabellen, zum Beispiel Klog-Scanmuster.

-k, --klog=Datei
Lesen Sie das Kernel-Protokoll aus der angegebenen Datei und nicht aus dem Kernel-Protokollring
Puffer. Dies ermöglicht es, die Kernel-Protokoll-Scan-Tests wie klog dagegen auszuführen
Vorab erfasste Protokolldaten.

--log-fields
Zeigt die verfügbaren Protokollfilterfelder an. Angabe dieser Felder mit --log-filter
um auszuwählen, welche Felder protokolliert werden sollen.

--log-filter
Geben Sie an, welche Arten von Protokolldaten in die Protokolldatei ausgegeben werden sollen. Jede
Je nach Protokolltyp wird eine Zeile mit Protokolldaten mit einer speziellen Markierung versehen
Informationen werden ausgegeben. Die verfügbaren Typen können mithilfe von --log-fields angezeigt werden.
Geben Sie die gewünschten Protokolltypen mit einer durch Kommas getrennten Liste an. Um ein Feld zu deaktivieren, geben Sie ein Präfix an
der Name mit ~, zum Beispiel:
--log-filter=RES,SUM protokolliert nur die Ergebnisse und Zusammenfassungszeilen.
--log-filter=ALL,~INF protokolliert alle Zeilen außer den Informationszeilen.

--log-format
Geben Sie die Informationen in jeder Protokollzeile an. Folgende Spezifizierer stehen zur Verfügung:
%Datum datum
%Zeit Zeit
%field – Protokollfilterfelder
%owner – Name der Testroutine
%level – Testfehlerstufe
%line – Protokollzeile
zB --log-format="%date %time [%field] (%owner): "

-Log-Ebene [kritisch|hoch|mittel|niedrig|info|alle]
Geben Sie die zu protokollierende Testfehlerstufe an. Testfehlerniveaus gleich und höher als
Die angegebenen Fehler werden protokolliert und als Fehler aufgezeichnet. Der Standardwert ist „all“ (d. h
identisch mit „info“). Mit der Protokollstufe „Mittel“ wird beispielsweise nur der Test protokolliert
Ausfälle der Stufen „mittel“, „hoch“ und „kritisch“, wobei als Protokollstufe „
„critical“ protokolliert nur Fehler der Stufe „critical“.

--log-type
Geben Sie den Protokolltyp an. Derzeit sind Klartext-, JSON- und XML-Protokolltypen verfügbar
Der Standardwert ist Klartext.

--lspci=Pfad
Geben Sie den vollständigen Pfad und Dateinamen der lspci-Binärdatei an.

-P, --power-states
Führen Sie S3- und S4-Stromzustandstests aus (S3-, S4-Tests).

--results-no-separators
Kein hübsches Drucken von horizontalen Trennzeichen in der Ergebnisprotokolldatei.

-R, --results-output=Dateiname
Geben Sie die Ausgabeprotokolldatei für die Ergebnisse an. Man kann auch stdout und stderr angeben
auf diese Ausgabeströme umleiten.

-R, --rsdp=physaddr
Geben Sie die physische Adresse von ACPI RSDP an. Dies ist auf einigen Systemen nützlich, auf denen dies der Fall ist
nicht automatisch erkannt werden.

--pm-method=Methode
Geben Sie die Energiemethode an, die zum Aufrufen von S3 oder S4 verwendet werden soll (oder die automatische Erkennung wird verwendet).
Folgende Spezifizierer stehen zur Verfügung:
logind – die Standardmethode, sofern verfügbar (erfordert dbus und logind).
pm-utils – die bisherige Standardmethode, jetzt veraltet.
sysfs – der Fallback, der verwendet wird, wenn logind nicht verfügbar ist.
zB --pm-method=sysfs

--s3-delay-delta=N
Zeit, die zur Verzögerung zwischen jeder S3-Iteration hinzugefügt werden muss.

--s3-Geräteprüfung
Überprüfen Sie Unterschiede zwischen Gerätekonfigurationen über einen S3-Zyklus. Beachten Sie, dass dies 15 hinzufügt
Sekunden Verzögerung nach jeder S3-Wiederaufnahme, um eine erneute WLAN-Verbindung zu ermöglichen.

--s3-device-check-delay
Geben Sie die Zeit an, die gewartet werden soll, während Geräte neu konfiguriert werden (z. B. WLAN für die erneute Verbindung,
Ethernet zum Herstellen einer Verbindung...), bevor eine Gerätekonfigurationsprüfung durchgeführt wird. Die Standardeinstellung ist
15 Sekunden. Wenn diese Option verwendet wird, wird davon ausgegangen, dass die Geräteprüfung erfolgt, sodass dies nicht der Fall ist
Außerdem muss das Flag --s3-device-check verwendet werden.

--s3-hybrid
Ermöglicht FWTs die Ausführung von Hybrid Sleep.

--s3-min-delay=N
Mindestzeit zwischen S3-Iterationen.

--s3-max-delay=N
maximale Zeit zwischen S3-Iterationen.

--s3-multiple=N
Gibt die Anzahl der auszuführenden S3-Suspendierungs-/Fortsetzungstests an. Der Standardwert ist 2
Tests.

--s3-quirks=--quirk[,--quirk]
Geben Sie eine durch Kommas getrennte Liste von Quirk-Argumenten an, die an pm-suspend übergeben werden sollen, z
Beispiel: --s3-quirks=--quirk-s3-bios,--quirk-save-pci

--s3-sleep-delay=N
Sleep N Sekunden vom Beginn des Suspend bis zur Weckzeit. Beachten Sie, dass dies
Die Zeit MUSS länger sein als die Zeit, die zum Anhalten der Maschine benötigt wird, andernfalls
Der Weck-Timer wird während des Suspend-Zustands ausgelöst. Der Standardwert beträgt 30 Sekunden.

--s3-suspend-time=N
Geben Sie die maximal zulässige Suspend-Zeit in Sekunden an. Wenn die Unterbrechung länger dauert als
Dies führt dazu, dass ein Fehler protokolliert wird.

--s3-resume-time=N
Geben Sie die maximal zulässige Wiederaufnahmezeit in Sekunden an. Wenn der Lebenslauf länger dauert als
Dies führt dazu, dass ein Fehler protokolliert wird.

--s3power-sleep-delay=N
Geben Sie die Suspend-Dauer in Sekunden an. Je höher der Wert, desto genauer
das s3power-Testergebnis. Dauern unter 10 Minuten werden nicht empfohlen.

--s4-delay-delta=N
Zeit, die zur Verzögerung zwischen jeder S4-Iteration hinzugefügt werden muss.

--s4-Geräteprüfung
Überprüfen Sie Unterschiede zwischen Gerätekonfigurationen über einen S4-Zyklus. Beachten Sie, dass dies 15 hinzufügt
Sekunden Verzögerung nach jeder S3-Wiederaufnahme, um eine erneute WLAN-Verbindung zu ermöglichen.

--s4-device-check-delay
Geben Sie die Zeit an, die gewartet werden soll, während Geräte neu konfiguriert werden (z. B. WLAN für die erneute Verbindung,
Ethernet zum Herstellen einer Verbindung...), bevor eine Gerätekonfigurationsprüfung durchgeführt wird. Die Standardeinstellung ist
15 Sekunden. Wenn diese Option verwendet wird, wird davon ausgegangen, dass die Geräteprüfung erfolgt, sodass dies nicht der Fall ist
Außerdem muss das Flag --s4-device-check verwendet werden.

--s4-min-delay=N
Mindestzeit zwischen S4-Iterationen.

--s4-max-delay=N
maximale Zeit zwischen S4-Iterationen.

--s4-multiple=N
Gibt die Anzahl der auszuführenden S4-Ruhezustands-/Wiederaufnahmetests an. Der Standardwert ist 2
Tests.

--s4-quirks=--quirk[,--quirk]
Geben Sie eine durch Kommas getrennte Liste von Quirk-Argumenten an, die an pm-hibernate übergeben werden sollen, z
Beispiel: --s4-quirks=--quirk-save-pci

--s4-sleep-delay=N
Sleep N Sekunden vom Beginn des Ruhezustands bis zur Weckzeit. Beachten Sie, dass dies
Die Zeit MUSS länger sein als die Zeit, die zum Ruhezustand der Maschine benötigt wird, andernfalls
Der Weck-Timer wird während des Ruhezustands ausgelöst. Der Standardwert ist derzeit 90
Sekunden.

-P, --Fortschritt anzeigen
Zeigt den Fortschritt der durchgeführten Tests an. Jeder Test wird so identifiziert, wie er ist
laufen. Bei langen Tests wird ein Prozentsatz der Fertigstellungszeit angezeigt. Ab FWT
0.19.06 ist dies standardmäßig aktiviert und kann mit --quiet (oder -q) deaktiviert werden.

-Q, --ruhig
Läuft ruhig und ohne Ausgabe an stdout.

-D, --show-progress-dialog
Geben Sie den Fortschritt der ausgeführten Tests in einer Form aus, die in den Dialog weitergeleitet werden kann
Tool mit der Option --gauge.

-S, --show-tests
Zeigt die Namen der verfügbaren Tests an. Standardmäßig werden alle Tests angezeigt. Verwenden Sie --batch,
--interactive, --batch-experimental, --interactive-experimental, --utils Optionen für
Zeigen Sie diese spezifischen Tests.

--show-tests-full
Zeigt alle verfügbaren Tests an, aufgelistet nach der Beschreibung des Nebentests. Standardmäßig wird angezeigt
alle Tests. Verwenden Sie die Befehle --batch, --interactive, --batch-experimental,
--interactive-experimental Optionen zum Anzeigen dieser spezifischen Tests.

--show-tests-categories
Zeigt alle verfügbaren Tests und die Kategorien an, zu denen sie gehören.

--skip-test=test[,test..]
Geben Sie Tests an, die übersprungen und nicht ausgeführt werden sollen. Die Liste muss durch Kommas getrennt sein.

--stdout-summary
Geben Sie am Ende der Tests ERFOLGREICH oder FEHLGESCHLAGEN auf stdout aus.

-T, --table-path=Pfad
Geben Sie den Pfad an, der ACPI-Tabellen enthält. Diese Tabellen müssen im benannt werden
Format: Tabellenname.dat, zum Beispiel DSDT.dat, zum Beispiel wie extrahiert mit
acpidump oder fwts --dump und dann acpixtract.

-du, --utils
Dienstprogramme ausführen. Entwickelt, um Systeminformationen wie kommentierte ACPI-Tabellen zu sichern.
CMOS-Speicher, Int 15 E820-Speicherzuordnung, Firmware-ROM-Daten.

-in, --Version
Ausgabeversionsnummer und Erstellungsdatum des fwts Werkzeug.

-w, --Breite=N
Geben Sie die Breite der Ausgabeprotokolldatei in Zeichen an. Der Standardwert ist 130.

Beispiele:

Führen Sie alle Batch-Tests aus und hängen Sie die Ergebnisse an das Standardprotokoll results.log an:
sudo fwts

Führen Sie alle interaktiven Tests aus und starten Sie ein sauberes Ergebnisprotokoll mit dem Namen „interactive.log“:
sudo fwts -i -f -r Interactive.log

Führen Sie alle Tests aus, interaktiv und stapelweise:
sudo fwts -i -b

Führen Sie nur die Batterie- und CPUfreq-Tests durch:
sudo fwts batterie cpufreq

Führen Sie alle Batch-Tests aus und definieren Sie ein neues Protokollformat, indem Sie nur das Datum und die Zeilennummer verwenden:
sudo fwts --log-format="%date %line: "

Führen Sie alle interaktiven Tests durch und protokollieren Sie nur die Ergebnisse, Informationen und Zusammenfassungsdaten:
sudo fwts -i --log-filter=RES,INF,SUM

Speichern Sie alle interessanten Firmware-Informationen zur späteren Analyse in Protokolldateien:
sudo fwts --dump

Sehen Sie sich die Kernel- und ACPI-Treiberversion sowie BIOS-Informationen an:
sudo fwts -w 80 -r stdout version bios_info --log-filter=INF --log-format=""

Zeigen Sie die Batch- und Batch-Versuchstests an:
fwts --show-tests --batch --batch-experimental

Führen Sie mehrere S3-Tests mit einer Verzögerung zwischen den einzelnen Tests von 1 Sekunde bis 10 Sekunden durch
mit einem Verzögerungsdelta pro Test von 0.2 Sekunden
Sudo fwts s3 --s3-multiple=100 --s3-min-delay=1 --s3-max-delay=10
--s3-delay-delta=0.2

Nutzen Sie fwts online über die Dienste von onworks.net