Befehl "lspath"

Zweck

Zeigt Informationen zu Pfaden zu einer MPIO-Einheit (Multipath I/O) an.

Syntax

Lspath [ -F Format | -t. ] [ -H ] [ -l Name ] [ -p Übergeordnet ] [ -s Status ] [ -w Verbindung ] [ -i PathID ]

Lspath -A -l Name -p Übergeordnet [ -w Verbindung ] [ -i PathID ] {-D [ -O ] | -E [ -O ] | -F Format [ -Z Zeichen ] } [ -a Attribut ] ...[ -f Datei ] [ -H ]

Lspath -A -l Name -p Übergeordnet [ -w Verbindung ] [ -i PathID ]-R -a Attribut [ -f Datei ] [ -H ]

lspath -h

Beschreibung

Der Befehl lspath zeigt einen von zwei Typen von Informationen zu den Pfaden zu einer MPIO-fähigen Einheit an. Er zeigt entweder den Betriebsstatus für einen oder mehrere Pfade zu einer einzelnen Einheit oder ein oder mehrere Attribute für einen einzelnen Pfad zu einer einzelnen MPIO-fähigen Einheit an. Mit der ersten oben gezeigten Syntax wird der Betriebsstatus für einen oder mehrere Pfade zu einem bestimmten MPIO-fähigen Gerät angezeigt. In diesem Fall gleicht der Befehl lspath dem Befehl lsdev. Mit der zweiten Syntax (erkennbar an dem Vorhandensein des Flags -A) werden Attribute für einen einzelnen Pfad zu einem bestimmten MPIO-fähigen Gerät angezeigt. In diesem Fall ähnelt der Befehl "lspath" dem Befehl lsattr . Insofern werden alle Flags des Befehls lsattr für die Anzeige von Pfadattributen auch im Befehl lspath unterstützt.

Pfadstatus mit dem Befehl "lspath" anzeigen

Beim Anzeigen des Pfadstatus wird die Gruppe der anzuzeigenden Pfade ermittelt, indem die Einheitendatenbank nach Pfaden durchsucht wird, die den folgenden Kriterien entsprechen:

Der Name der Zieleinheit stimmt mit der Einheit überein, die mit dem Flag -l angegeben wird. Wenn das Flag -l nicht angegeben ist, wird die Zieleinheit nicht in als Kriterium verwendet.
Der Name der übergeordneten Einheit stimmt mit der Einheit überein, die mit dem Flag -p angegeben wird. Wenn das Flag -p nicht angegeben ist, wird die übergeordnete Einheit nicht als Kriterium verwendet.
Die Verbindung stimmt mit der Verbindung überein, die mit dem Flag -w angegeben wird. Wenn das Flag -w nicht angegeben ist, wird die Verbindung nicht als Kriterium verwendet.
Der Pfadstatus stimmt mit dem Status überein, der mit dem Flag -s angegeben wird. Wenn das Flag -s nicht angegeben ist, wird der Pfadstatus nicht als Kriterium verwendet.

Wenn keines der Flags -l, -p, -w oder -s angegeben ist, werden alle Pfade angezeigt, die dem System bekannt sind.

Standardmäßig zeigt dieser Befehl die Informationen im Spaltenformat an. Wenn keine Flags angegeben sind, die die anzuzeigenden Pfade qualifizieren, hat die Ausgabe das folgende Format:

status device  parent

Das Standardanzeigeformat kann mit dem Flag -F Format überschrieben werden. Das Flag -F Format zeigt die Ausgabe in einem benutzerdefinierten Format an, wobei der Parameter Format eine in Anführungszeichen eingeschlossene Liste von Feldnamen ist, die durch nicht alphanumerische Zeichen oder Leerzeichen voneinander trennt sind und möglicherweise beendet werden. Bei den Feldnamen handelt es sich um die Felder, die in der Klasse CuPath oder einer der zuvor definierten Spaltenüberschriften definiert sind.

Hinweis: Die obigen Spaltennamen werden nicht in andere Sprachen übersetzt (entweder bei der Ausgabe als Spaltenüberschriften oder bei der Eingabe als Teil des Formats des Flags -F ).

Die folgenden Werte können für die Statusspalten angezeigt werden:

enabled: Zeigt an, dass der Pfad konfiguriert und betriebsbereit ist. Dieser Wert wird bei der Auswahl von Pfaden für E/A berücksichtigt.
Hinweis: AIX® MPIO lässt den letzten Pfad nicht fehlschlagen. Selbst wenn alle Pfade zum Speicher verloren gehen, wird für den letzten Pfad der Status enabled angezeigt. In einem solchen Fall wird der Verlust des letzten Pfads zur Platte durch einen E/A-Fehler angezeigt.
inaktiviert: Zeigt an, dass der Pfad zwar konfiguriert, aber derzeit nicht betriebsbereit ist. Der Pfad wurde manuell inaktiviert und wird bei der Auswahl der Pfade für E/A nicht berücksichtigt.
fehlgeschlagen: Zeigt an, dass der Pfad zwar konfiguriert ist, aber E/A-Fehler aufgetreten sind, die den Pfad unbrauchbar gemacht haben. Es wird bei der Auswahl der Pfade für E/A nicht berücksichtigt.
definiert: Zeigt an, dass der Pfad nicht im Einheitentreiber konfiguriert wurde.
missing: Zeigt an, dass der Pfad bei einem früheren Bootvorgang definiert wurde, aber beim letzten Booten des Systems nicht erkannt wurde.
detected: Gibt an, dass der Pfad beim letzten Booten des Systems erkannt wurde, aber aus irgendeinem Grund nicht konfiguriert ist. Ein Pfad sollte diesen Status nur während des Bootvorgangs haben und daher sollte dieser Status nie im Ergebnis des Befehls lspath erscheinen.

Pfadattribute mit dem Befehl "lspath" anzeigen

Wenn Attribute für einen Pfad angezeigt werden, muss der Pfad vollständig qualifiziert werden. Es können mehrere Attribute für einen Pfad angezeigt werden, aber Attribute, die zu mehreren Pfaden gehören, können nicht in einem einzigen Aufruf des Befehls lspath angezeigt werden. Deshalb muss zusätzlich zum Flag -A das Flag -l, -p oder -w angegeben werden, um einen einzelnen Pfad eindeutig zu identifizieren. Beispiel:

Wenn nur ein Pfad zu einer Einheit vorhanden ist, muss das Flag -l angegeben werden.
Wenn nur ein Pfad zwischen einer Einheit und einer bestimmten übergeordneten Einheit vorhanden ist, müssen die Flags -l und -p angegeben werden.
Wenn mehrere Pfade zwischen einer Einheit und einer bestimmten übergeordneten Einheit vorhanden sind, müssen die Flags -l, -p und -w angegeben werden.

Außerdem ist das Flag -s nicht zulässig.

Die Regeln, die der Befehl lsattr zum Anzeigen von Einheitenattributen verwendet, gelten gleichermaßen die Anzeige von Pfadattributen mit dem Befehl lspath.

Standardmäßig zeigt dieser Befehl die Informationen im Spaltenformat an. Die Ausgabe hat dasselbe Format wie die des Befehls lsattr:

attribute   value    description         user_settable

Standardmäßig werden alle Felder angezeigt. Das Standardanzeigeformat kann mit dem Flag -F Format überschrieben werden. Das Flag -F Format zeigt die Ausgabe in einem benutzerdefinierten Format an, wobei der Parameter Format eine in Anführungszeichen eingeschlossene Liste von Spaltennamen ist, die durch nicht alphanumerische Zeichen oder Leerzeichen voneinander trennt sind und möglicherweise beendet werden. Bei den zulässigen Spaltennamen handelt es sich um die Feldnamen aus den Objektklassen CuPathAt, PdPathAt und PdAtXtd und die zuvor aufgelisteten Spaltennamen.

Hinweis: Die obigen Spaltennamen werden nicht in andere Sprachen übersetzt (entweder bei der Ausgabe als Spaltenüberschriften oder bei der Eingabe als Teil des Formats des Flags -F ).

Flags

Element	Beschreibung
-a Attribut	Gibt das spezielle aufzulistende Attribut an. Der Parameter Attribut gibt den Namen eines pfadspezifischen Attributs an. Wenn dieses Flag angegeben ist, wird nur das angegebene Attribut angezeigt. Es können mehrere Instanzen dieses Flags zum Auflisten mehrerer Attribute verwendet werden. Wenn dieses Flag gar nicht angegeben ist, werden alle Attribute aufgelistet, die dem angegebenen Pfad zugeordnet sind.
-A	Gibt an, dass Attribute für einen bestimmten Pfad angezeigt werden sollen. Wenn das Flag -A angegeben ist, ist das Flag -s Status nicht zulässig.- Für die vollständige Qualifizierung des Pfads müssen jedoch die Flags -l Name, -p Übergeordnet und -w Verbindung angegeben werden.
-D	Zeigt die Attributnamen, Standardwerte, Beschreibungen und benutzerdefinierbaren Flagwerte für einen bestimmten Pfad an, wenn das Flag -O nicht verwendet wird. Das Flag -D zeigt nur den Attributnamen und den Standardwert im Doppelpunktformat an, wenn das Flag -O angegeben ist. Dieses Flag ist nur bei der Anzeige von Pfadattributen gültig und kann nicht zusammen mit den Flags -E, -F und -R verwendet werden.
-E	Zeigt die Attributnamen, aktuellen Werte, Beschreibungen und benutzerdefinierbaren Flagwerte für einen bestimmten Pfad an, wenn das Flag -O nicht verwendet wird. Das Flag -E zeigt nur den Attributnamen und den Standardwert im Doppelpunktformat an, wenn das Flag -O angegeben ist. Dieses Flag ist nur bei der Anzeige von Pfadattributen gültig und kann nicht zusammen mit den Flags -D, -F und -R verwendet werden.
-f Datei	Liest die erforderlichen Flags aus dem Parameter Datei.
-F Format	Zeigt die Ausgabe in einem benutzerdefinierten Format an, wobei der Parameter Format eine in Anführungszeichen eingeschlossene Liste von Spaltennamen ist, in der nicht alphanumerische Zeichen oder Leerzeichen als Trennzeichen verwendet und möglicherweise als Endezeichen verwendet werden. Wenn Leerzeichen als Trennzeichen verwendet werden, zeigt der Befehl "lspath" die Ausgabe in ausgerichteten Spalten an. Die gültigen Spaltennamen sind vom Typ der angeforderten Informationen abhängig. Für die Pfadanzeige können Spaltennamen aus der Objektklasse CuPath angegeben werden. Für die Anzeige von Pfadattributen (Flag -A ist angegeben) können Spaltennamen aus den Objektklassen PdPathAt und CuPathAt angegeben werden. Zusätzlich zu den Spaltennamen gibt es zwei spezielle Namen, die verwendet werden können. Der Name "description" kann verwendet werden, um die Anzeige von Attributbeschreibungen anzufordern, und der Name "user-settable" kann verwendet werden, um abzurufen, ob ein Attribut geändert werden kann oder nicht. Dieses Flag kann nicht zusammen mit den Flags -E, -D, -O und -R verwendet werden.
-H	Zeigt den Verwendungshinweis für den Befehl an.
-H	Zeigt Überschriften über den ausgegebenen Spalten an. Die Verwendung des Flags -H in Kombination mit dem Flag -O ist wirkungslos. Das Flag -O hat Vorrang. Die Verwendung des Flags -H in Kombination mit dem Flag -R ist wirkungslos. Das Flag -R hat Vorrang.
-i PathID	Gibt die Pfad-ID an, die dem anzuzeigenden Pfad zugeordnet ist.
-l Name	Gibt den logischen Einheitennamen der Zieleinheit an, deren Pfadinformationen angezeigt werden sollen. Dieses Flag ist für die Anzeige des Pfadstatus optional, aber für die Anzeige von Pfadattributen erforderlich.
-O	Zeigt alle Attribute durch Doppelpunkte getrennt und in der zweiten Zeile alle entsprechenden Attributwerte durch Doppelpunkte getrennt an. Bei den Attributwerten handelt es sich um aktuelle Werte, wenn das Flag -E ebenfalls angegeben ist, und um Standardwerte, wenn das -D angegeben ist. Dieses Flag ist nur bei der Anzeige von Pfadattributen gültig und kann nicht zusammen mit den Flags -F und -R verwendet werden.
-p Übergeordnetes Element	Gibt den logischen Einheitennamen der übergeordneten Einheit an, deren Pfade angezeigt werden sollen. Dieses Flag ist für die Anzeige des Pfadstatus optional, aber für die Anzeige von Pfadattributen erforderlich.
-R	Zeigt die zulässigen Werte für einen Attributnamen an. Das Flag -R kann nicht zusammen mit den Flags -D, -E, -F und -O verwendet werden. Das Flag -R zeigt die Listenattributwerte wie folgt in einer vertikalen Spalte an: `Value1 Value2 . . ValueN` Das Flag -R zeigt die Bereichsattributwerte als x ... n (+ i) an, wobei x der Anfang des Bereichs ist, n das Ende des Bereichs ist und i das Inkrement ist.
-s Status	Das Flag -s Status gibt den Status an, der für die Qualifizierung der anzuzeigenden Pfad werden soll. Für die Anzeige von Pfadinformationen sind die folgenden Werte für dieses Flag zulässig: enabled Zeigt Pfade an, die für die MPIO-Pfadauswahl aktiviert (enabled) sind. inaktiviert Zeigt Pfade an, die für die MPIO-Pfadauswahl inaktiviert (disabled) sind. fehlgeschlagen Zeigt die Pfad an, die aufgrund von E/A-Fehlern als ausgefallen (failed) markiert sind. verfügbar Zeigt Pfade an, deren Pfadstatus PATH_AVAILABLE ist (d. h. Pfade, die im System konfiguriert sind, umfassen enabled, disabled, und fehlgeschlagenen Pfaden). definiert Zeigt Pfade mit dem path_status-Wert PATH_DEFINED an. missing Zeigt Pfade mit dem path_status-Wert PATH_MISSING an. Sie können alternative Formen der Werte verwenden. Zeichenfolgen, die mit 0, d oder D beginnen, werden wie defined behandelt. Eine Ausnahme bilden Zeichenfolgen, die mit di, Di, dI oder DI beginnen. Diese werden wie disabled behandelt. Zeichenfolgen, die mit 1, a oder A beginnen, werden wie available behandelt. Zeichenfolgen, die mit 3, m oder M beginnen, werden wie missing behandelt. Zeichenfolgen, die mit e oder E beginnen, werden wie enabled behandelt. Zeichenfolgen, die mit f oder F beginnen, werden wie failed behandelt.
-T	Zeigt die Pfad-ID zusätzlich zur aktuellen Standardausgabe an. Das Flag -t kann nicht zusammen mit den Flags -F und -A verwendet werden.
-w Verbindung	Gibt die Verbindungsinformationen an, die zum Qualifizieren der anzuzeigenden Pfade verwendet werden sollen. Dieses Flag ist für die Anzeige des Pfadstatus optional, aber für die Anzeige von Pfadattributen erforderlich.
-Z Zeichen	Das Flag -Z Zeichen ist für Programme bestimmt, die mit ODM-Feldern arbeiten müssen, die möglicherweise eingebettete Zeilenvorschubzeichen enthalten. Das Flag -Z Zeichen wird verwendet, um das Datensatztrennzeichen für jeden Datensatz (Zeile) der generierten Ausgabe zu ändern. Das neue Datensatztrennzeichen ist das Argument Zeichen für dieses Flag. Das Flag -Z Zeichen ist nur relevant, wenn die Flags -A und -F Format angegeben sind. Das Flag -Z Zeichen kann nicht zusammen mit den Flags -D, -E, -O und -R verwendet werden.

Sicherheit

Zugriffssteuerung:: Dieser Befehl kann von allen Benutzern ausgeführt werden.

Prüfereignisse: Keine

Beispiele

Beispiele für die Anzeige des Pfadstatus:

Geben Sie den folgenden Befehl ein, um den Status aller Pfade zu "hdisk1" mit Spaltenüberschriften anzuzeigen:
```
lspath -H -l hdisk1
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
status    device   parent
enabled   hdisk1   scsi0
disabled  hdisk1   scsi1
missing   hdisk1   scsi2
```
Geben Sie den folgenden Befehl ein, um die Gruppe von Pfaden mit dem Betriebsstatus "disabled" ohne Spaltenüberschriften anzuzeigen:
```
lspath -s disabled
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
disabled  hdisk1   scsi1
disabled  hdisk2   scsi1
disabled  hdisk23  scsi8
disabled  hdisk25  scsi8
```
Geben Sie den folgenden Befehl ein, um die Gruppe von Pfaden mit dem Betriebsstatus failed anzuzeigen:
```
lspath -s failed
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
failed  hdisk1   scsi1
failed  hdisk2   scsi1
failed  hdisk23  scsi8
failed  hdisk25  scsi8
```
Geben Sie den folgenden Befehl ein, um die Gruppe der Pfade zu hdisk1 mit dem Betriebsstatus "available" in einem benutzerdefinierten Format ohne Spaltenüberschriften anzuzeigen:
```
lspath -l hdisk1 -s available -F"connection:parent:path_status:status"
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
5,0:scsi0:available:enabled
6,0:scsi1:available:disabled
```
Beachten Sie, dass diese Ausgabe sowohl den Pfadstatus als auch den Betriebsstatus der Einheit enthält: Der Pfadstatus zeigt lediglich an, ob der Pfad konfiguriert ist oder nicht. Der Betriebsstatus zeigt an, wie der Pfad in Bezug auf die Pfadauswahl im Einheitentreiber verwendet wird. Nur Pfade mit dem Pfadstatus available haben auch einen Betriebsstatus. Wenn ein Pfad momentan nicht im Einheitentreiber konfiguriert ist, hat er keinen Betriebsstatus.

Beispiele für die Anzeige von Pfadattributen:

Geben Sie den folgenden Befehl ein, um alle Attribute für den Pfad zur übergeordneten Einheit "scsi0) in Verbindung 5,0 anzuzeigen, wenn es sich bei der Zieleinheit um eine SCSI-Platte handelt:
```
lspath -AHE -l hdisk10 -p scsi0 -w "5,0"
```
Das System zeigt eine Nachricht ähnlich der folgenden an:
```
attribute  value  description                       user_settable
weight     1      Order of path failover selection  true
```