Befehl "dumpctrl"

Online bearbeiten

Zweck

Verwaltet Systemspeicherauszüge und Livespeicherauszüge.

Syntax

dumpctrl -k

dumpctrl -R [ l | s ] [-P]

dumpctrl -s [-c | -C comp-path-list] [-l | -L comp-alias-list] [-t | -T type_subtype] [-r] [-u

dumpctrl -qc [-c komp-pfad-liste] [-l komp-aliasliste] [-t typuntertyp] [-r] [-u] [-p | -P]

dumpctrl -ql [-p | -P]

dumpctrl -q [-p | -P

dumpctrl [-P] [globales_Attribut]

dumpctrl [-c comp-pfadliste] [l comp-aliasliste] [-t type_subtype] [-r] [-u] [-n | -p | -P | -x] [komponenten_attribut]

Beschreibung

Es gibt zwei Typen von Speicherauszugskomponenten:
Komponente
Bezieht sich auf eine Komponente, die mit der RAS-Infrastruktur angegeben wurde (eine mit dem ras_register() -Kernel-Service erstellte Komponente).
Traditionelle Komponente
Bezieht sich auf eine Speicherauszugskomponente, die mit dem dmp_add() oder dem dmp_ctl() -Kernel-Service angegeben wurde.

Der Befehl dumpctrl wird verwendet, um Informationen zu den für Livespeicherauszüge oder Systemspeicherauszüge registrierten Komponenten anzufordern und um Speicherauszugsmerkmale abzufragen und zu ändern.

Komponenten werden mit dem vollständigen Pfadnamen, dem logischen Alias, Typ oder Subtyp der Einheit angegeben. Sie können mehrere Flags verwenden, um mehrere Komponenten oder Komponentenlisten anzugeben.

Flags

Es muss mindestens ein Flag angegeben werden.

Element Beschreibung
-c komp-pfad-liste Gibt Komponenten anhand des Pfadnamens an. Platzhalter sind zulässig. Verwenden Sie den Befehl -c all, um alle Komponenten anzugeben.
-k Aktualisiert die Liste der Speicherauszüge des Kernels. Dieses Flag wird standardmäßig alle 5 Minuten ausgeführt. Dieser Zeitraum kann geändert werden, indem der Befehl crontab für den Rootbenutzer bearbeitet und der Eintrag für /usr/sbin/dumpctrl -kgeändert wird. Weitere Informationen finden Sie in der Beschreibung des Befehls crontab. Nach dem manuellen Hinzufügen oder Entfernen von Speicherauszügen müssen Sie den Befehl dumpctrl -k ausführen.

Wenn das System Speicherauszüge im Heapspeicher hält, die zuvor nicht in das Dateisystem geschrieben werden konnten, versucht das System, diese Speicherauszüge jetzt zu schreiben und den Speicherplatz freizugeben.
-l Komponentenaliasliste Gibt Komponenten anhand des Alias an. Platzhalter sind zulässig.
-r Erstellt einen Speicherauszug aller Unterkomponenten der angegebenen Komponenten.
-q Befehl Fragt die Attribute für den Livespeicherauszug oder Systemspeicherauszug ab.
  • Das Flag -qc zeigt komponentenspezifische Livespeicherauszugsttribute und Systemspeicherauszugsattribute an. Das Flag -qc kann zusammen mit dem Flag -p oder -P verwendet werden, um persistente Attribute pro Komponente abzufragen. Das Flag -qc zeigt die Attribute für alle Komponenten an, wenn keines der folgenden Flags angegeben wird: -c, -l, -t. Mit anderen Worten: -c all ist der Standardwert.
    Im Folgenden sehen Sie eine Beispielausgabe für diesen Befehl:
    dumpctrl -qc -r -l vmm -l proc

--------------------------------------------------------------------------
     Component name                       | Have | Live Dump | System Dump
                                          |Alias |  /level   |  /level
--------------------------------------------------------------------------
vmm                                       | no   |  on/3     |  on/3
     .pft                                 | no   |  on/3     |  on/3
	 ...
proc                                      | no   |  on/4     |  on/3
     ...
  • Das Flag -ql listet globale Livespeicherauszugseinstellungen auf. Das Flag -ql kann zusammen mit dem Flag -p oder -P verwendet werden, um die persistenten globalen Livespeicherauszugseinstellungen abzufragen.
  • Das Flag -qs Typ zeigt globale Systemspeicherauszugsattribute an. Das Flag -qs kann zusammen mit dem Flag -p oder -P verwendet werden, um globale Systemspeicherauszugsattribute abzufragen.
-r Schließt Komponenten unterhalb der angegebenen Komponenten in der Komponentenhierarchie ein.
-Rx Setzt Speicherauszugseinstellungen auf ihre Standardwerte zurück. Die gültigen Werte für x sind l für Livespeicherauszugseinstellungen und s für Sytemspeicherauszugseinstellungen. Es werden nur die globalen Speicherauszugseinstellungen zurückgesetzt. Einzelne Komponenten können nicht angegeben werden. Das Flag -P und ein neues Boot-Image sind erforderlich, um sicherzustellen, dass alle diese Einstellungen über einen Neustart hinweg wirksam bleiben.
-t Typ_Subtyp Gibt eine Komponente anhand der Typ_Subtyp-Namen an.
-s Listet die Pfadnamen und Titel aller Livespeicherauszüge im Speicherauszugsverzeichnis auf. Wenn Komponenten mit dem Flag -c, -l oder -t angegeben werden, enthält die angezeigte Speicherauszugsliste nur Speicherauszüge für die angegebenen Komponenten. Wenn Komponenten mit dem Flag -C, -L oder -T angegeben werden, enthält die angezeigte Speicherauszugsliste nur Speicherauszüge für die angegebenen fehlerhaften Komponenten.
-C komp-pfad-liste Gibt Komponenten anhand des Pfadnamens an. Platzhalter sind zulässig. Der reservierte Name all, der für alle Komponenten steht, kann ebenfalls angegeben werden. Das Flag -C kann nur zusammen mit dem Flag -s angegeben werden.
-L Komponentenaliasliste Gibt Komponenten anhand des Alias an. Platzhalter sind zulässig. Das Flag -L kann nur zusammen mit dem Flag -s angegeben werden.
-T type_subtyp Gibt eine Komponente anhand der Typ_Subtyp-Namen an. Das Flag -T kann nur zusammen mit dem Flag -s angegeben werden.
-u Schließt Komponenten oberhalb der angegebenen Komponenten in der Komponentenhierarchie ein.
Persistenzflags
Element Beschreibung
-p Änderungen gelten nur für neu erstellte Komponenten, bei denen es sich um RAS-Infrastrukturkomponenten handelt, die nach der Ausführung des Befehls dumpctrl erstellt werden.
-P Macht die angegebenen Änderungen permanent. Alle vorgenommenen Änderungen bleiben über einen Neustart hinweg wirksam. Wenn ein neues Boot-Image erforderlich ist, wird eine Nachricht generiert, um Sie darüber zu benachrichtigen. Das Flag -P gilt für Komponentenattribute, die globale Aktivierung und Inaktivierung von Livespeicherauszügen, die globale Livespeicherauszugsebene, die Aktivierung und Inaktivierung traditioneller Komponenten und die Spezifikation von Systemspeicherauszugseinheiten.
-n Änderungen gelten für vorhandene Komponenten. Das Flag -n wird standardmäßig verwendet, wenn weder das Flag -p noch das Flag -P angegeben wird. Verwenden Sie die Flags -n und -p , um Änderungen auf aktuelle und neu erstellte Komponenten anzuwenden.
-x Löscht diese Persistenzspezifikation. Das Flag -x löscht eine permanente (-P) Persistenzspezifikation. Die Spezifikation muss auf dieselbe Weise angegeben werden, in der sie ursprünglich mit dem Flag -P angegeben wurde.

Eine (mit dem Flag -r angegebene) rekursive Anpassung hat Vorrang vor allen anderen Anpassungen, unabhängig von der Reihenfolge, in der sie relativ zu anderen nicht rekursiven Anpassungen angegeben sind.

Wenn Sie die vorgenommene Anpassung nicht kennen, aber die Standardsystemeinstellung wiederherstellen möchten, können Sie eine der folgenden Aktionen ausführen:
  • Löschen Sie in der Datei " /var/adm/ras/raspertune die für die Anpassung relevanten Zeilen und führen Sie den Befehl " bosboot aus, um AIX® neu zu starten.
  • Lesen Sie die Datei /var/adm/ras/raspertune, um die entsprechenden Flags und Parameter zu ermitteln, die angegeben werden. Verwenden Sie anschließend das Flag -x, um die Anpassung zu löschen. Führen Sie den Befehl bosboot aus und starten Sie AIXerneut.

Weitere Informationen zur Interaktion der verschiedenen Speicherauszugsattribute mit Persistenz finden Sie in den Attributtabellen für Livespeicherauszüge und Systemspeicherauszüge unter Attribute.

Attribute

Die Speicherauszugsattribute können das Format attribute=valuehaben. Beispiel:
dumpctrl dir=/usr/dumps freespc=20
In diesem Beispiel wird das Speicherauszugsverzeichnis auf /usr/dumpsund der Schwellenwert für freien Speicherplatz auf 20 % gesetzt.

Es werden verschiedene Direktaufrufe wie das Attribut ldmpon bereitgestellt, das ldmpenable=yes entspricht.

Wenn Komponenten angegeben werden, werden nicht erkannte Attribute mit RASCD_DMP_PASS_THROUGH an Callbacks dieser Komponenten übergeben.

In der folgenden Tabelle sind die Livespeicherauszugsattribute aufgelistet.

Tabelle 1 Livespeicherauszugsattribute und Standardwerte
Attribut Spezifikation Standardwert
ldmpenable Gibt an, ob Livespeicherauszüge aktiviert sind.

Die gültigen Werte sind "yes" und "no".

Sie können das Attribut ldmpon anstelle von ldmpenable=yes und das Attribut ldmpoff anstelle von ldmpenable=no verwenden.

 ja

Weitere Informationen finden Sie im folgenden Hinweis 1.
dir Gibt den Namen eines Livespeicherauszugsverzeichnisses an. /var/adm/ras/livedump
freespc Gibt den Schwellenwert für den freien Speicherplatz für Livespeicherauszüge als Dezimalwert zwischen 0 und 99 an. 25 (bedeutet 25 %)
ldmplevel Gibt die Livespeicherauszugsebene als Dezimalwert zwischen 0 und 9 an.

Sie können das Attribut ldmpminimal, ldmpnormaloder ldmpdetail anstelle von ldmplevel=1, 3, 7 angeben

 3 (normal)

Weitere Informationen finden Sie im folgenden Hinweis 1.
heapsz Gibt die Größe des Heapspeichers für Livespeicherauszüge als Dezimalwert in MB an. 0

Weitere Informationen finden Sie in der folgenden Anmerkung 2.
duptype Gibt den Typ für die Unterdrückung doppelter Speicherauszüge an. Die gültigen Werte sind im Folgenden aufgelistet:
  • Alle
  • pre
  • post
  • keine
 Alle
maxfreeze Gibt das empfohlene maximale Systemblockierungsintervall als Dezimalzahl in Millisekunden an. 100 ms

In der folgenden Tabelle sind die Systemspeicherauszugsattribute aufgelistet.

Tabelle 2. Systemspeicherauszugsattribute und Standardwerte
Attribut Spezifikation Standardwert
sdmpenable Gibt an, ob Systemspeicherauszüge aktiviert sind.

Die gültigen Werte sind "yes" und "no".

Sie können auch sdmpon oder sdmpoff anstelle von sdmpenable=yes oder sdmpenable=no angeben.

 ja

Weitere Informationen finden Sie in der folgenden Anmerkung 3.
legacyenable Gibt an, ob traditionelle Speicherauszugskomponenten aktiviert sind.

Die gültigen Werte sind "yes" und "no".

Sie können auch legacyon oder legacyoff anstelle von legacyenable=yes oder legacyenable=no angeben.

 ja
sdmplevel Gibt die Systemspeicherauszugsebene als Dezimalwert zwischen 0 und 9 an.

Sie können das Attribut sdmpminimal, sdmpnormaloder sdmpdetail anstelle von sdmplevel=1, 3, 7 angeben

 3 (normal)

Weitere Informationen finden Sie in der folgenden Anmerkung 4.
copydir Gibt den Pfadnamen für die Verzeichniskopie an. /var/adm/ras
forcecopy Gibt an, ob das Attribut forcecopy aktiviert ist.

Die gültigen Werte sind "yes" und "no".

Wenn zur Bootzeit ein Speicherauszug aus dem Paging-Bereich kopiert werden muss und nicht genügend Speicherplatz im Verzeichnis für die Kopie vorhanden ist, werden Sie aufgefordert, den Speicherauszug auf einen austauschbaren Datenträger zu kopieren, wenn forcecopy den Wert "yes" hat. Wenn das Attribut den Wert "no" hat, wird der Speicherauszug nicht kopiert und das System normal gebootet, obwohl in diesem Fall der Speicherauszug verloren geht.

 ja
keyseq Gibt an, ob die Tastenkombinationen immer die Erstellung eines Speicherauszugs verursachen.

Die gültigen Werte sind "yes" und "no".

 nein
primary Gibt den Pfadnamen der primären Speicherauszugseinheit an. /dev/hd6 oder /dev/lg_dumplv
secondary Gibt den Pfadnamen der sekundären Speicherauszugseinheit an. /dev/sysdumpnull
Hinweise:
  1. Die Attribute ldmpenable und ldmplevel können mit oder ohne Komponenten angegeben werden. Wenn die Attribute ohne Komponenten angegeben werden, gelten die Attribute für die entsprechenden globalen Attribute.
  2. Das Attribut heapsz (Größe des Heapspeichers) kann auf 0 gesetzt werden, d. h., dass das System zum Zeitpunkt der Speicherauszugsinitialisierung die Größe des Heapspeichers für den Livespeicherauszug berechnet, die auf der Größe des physischen Arbeitsspeichers (mindestens 64 MB) basiert und damit mindestens 1/64 der Größe des physischen Arbeitsspeichers beträgt.
  3. Es müssen einzelne Komponenten angegeben werden, wenn das Attribut sdmpenable angegeben wird. Wenn keine Komponenten angegeben werden, kann das Attribut sdmpenable nicht angegeben werden, da der Systemspeicherauszug nicht inaktiviert werden kann.
  4. Das Attribut sdmplevel kann mit oder ohne Komponenten angegeben werden. Wenn das Attribut ohne Komponenten angegeben wird, gilt es für die Systemstandardebene. Die mit sdmplevel angegebenen Komponenten, die größer sind als der globale sdmplevel-Wert, werden nicht in einen Systemspeicherauszug eingeschlossen.

In der folgenden Tabelle sind die Livespeicherauszugsattribute und deren Persistenz aufgelistet.

Tabelle 3. Livespeicherauszugsattribute und Persistenz
Attribut Beschreibung Persistenz
ldmpenable Livespeicherauszug aktiviert Wird von Persistenzflags gesteuert, mit dem Flag -P muss ein neues Boot-Image angegeben werden.
dir Verzeichnis für Livespeicherauszug Wird sofort und nach einem Systemwiederanlauf wirksam.
freespc Speicherplatzschwellenwert für Livespeicherauszug Wird sofort und nach einem Systemwiederanlauf wirksam.
ldmplevel Livespeicherauszugsebene Wird von Persistenzflags gesteuert, mit dem Flag -P muss ein neues Boot-Image angegeben werden.
heapsz Größe des Heapspeichers für Livespeicherauszug Wird sofort und nach einem Systemwiederanlauf wirksam.
duptype Typ für die Unterdrückung doppelter Speicherauszüge Wird sofort und nach einem Systemwiederanlauf wirksam.
maxfreeze Empfohlenes maximales Systemblockierungsintervall Wird sofort und nach einem Systemwiederanlauf wirksam.
Anmerkung: Die Persistenz wirkt sich nur dann auf die Attribute aus, wenn sie für RAS-Infrastrukturkomponenten gelten. Die Persistenz steuert auch die globale Livespeicherauszugsebene und den globalen Aktivierungs- oder Inaktivierungsstatus.

In der folgenden Tabelle sind die Systemspeicherauszugsattribute und deren Persistenz aufgelistet.

Tabelle 4. Systemspeicherauszugsattribute und Persistenz
Attribut Beschreibung Persistenz
sdmpenable Systemspeicherauszug aktiviert Wird von Persistenzflags gesteuert, mit dem Flag -P muss ein neues Boot-Image angegeben werden.
legacyenable Traditionelle Speicherauszugskomponenten Wird sofort und nach einem Systemwiederanlauf wirksam, wenn das Flag -P angegeben ist. Es muss kein neues Boot-Image mit dem Flag -P angegeben werden.
sdmplevel Systemspeicherauszugsebene Wird von Persistenzflags gesteuert, mit dem Flag -P muss ein neues Boot-Image angegeben werden.
copydir Verzeichnis für Kopie Wird sofort und nach einem Systemwiederanlauf wirksam.
forcecopy Öffnet das Bootzeitmenü, wenn die Kopieroperation nicht möglich ist. Wird sofort und nach einem Systemwiederanlauf wirksam.
keyseq Tastenkombinationen verursachen immer die Erstellung eines Speicherauszugs. Wird sofort und nach einem Systemwiederanlauf wirksam.
primary Primäre Speicherauszugseinheit Wird sofort und nach einem Systemwiederanlauf wirksam, wenn das Flag -P angegeben ist. Es muss kein neues Boot-Image mit dem Flag -P angegeben werden.
secondary Sekundäre Speicherauszugseinheit Wird sofort und nach einem Systemwiederanlauf wirksam, wenn das Flag -P angegeben ist. Es muss kein neues Boot-Image mit dem Flag -P angegeben werden.
Hinweis: Die Persistenz wirkt sich auf die Attribute aus, wenn sie für Komponenten gelten.

Die Attribute copydir, forcecopy, keyseq, primaryund secondary verhalten sich wie ihre Entsprechungen des Befehls sysdumpdev , die mit den Flags -d, -D, -k, -K, -pund -s angegeben werden.

Exitstatus

Dieser Befehl gibt die folgenden Exitwerte zurück:

Element Beschreibung
0 Erfolgreiche Ausführung.
ungleich 0 Es ist ein Fehler aufgetreten. Dieser Befehl schlägt unter den folgenden Bedingungen fehl:
  • Mindestens ein Parameter ist ungültig.
  • Mindestens ein Attribut ist ungültig.
  • Es kann keine Komponente angegeben werden.
  • Es muss mindestens eine Komponente angegeben werden.
  • Die persistente Spezifikation wurde nicht gefunden. (Sie kann mit dem Flag -x angegeben werden.)

Sicherheit

Dieser Befehl kann nur vom Rootbenutzer verwendet werden.