pmgetopt – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pmgetopt - Performance-Co-Pilot-Shell-Skript-Optionsparser

ZUSAMMENFASSUNG

$PCP_BINADM_DIR/pmgetopt [-c|--config Datei] [-p|--Programmname Name] [-u|--Verwendungszweck] [--]
[Parameter]

BESCHREIBUNG

pmgetopt wird verwendet, um das Parsen von Befehlszeilenoptionen für Shell-Skripte durchzuführen, die in verwendet werden
Performance Co-Pilot (PCP-Toolkit). Es wird auch verwendet, um Nutzungsmeldungen für diese zu generieren
Skripte.

Die an . gegebenen Parameter pmgetopt Nehmen Sie zwei Formen an: zunächst Optionen, die spezifisch sind für pmgetopt
selbst werden übergeben und mit dem -- Mechanismus beendet. Danach alle
Parameter, die an das Shell-Skript übergeben werden, sollten übergeben werden (normalerweise ist dies einfach das „$@“)
Variable).

Die spezifischen Optionen für pmgetopt sind wie folgt:

-c,--config
Eine Konfiguration Datei im unten beschriebenen Format wird an übergeben pmconfig mit diesem
Möglichkeit. Wenn diese Option weggelassen wird, dann pmconfig liest seine Konfiguration aus
der Standard-Eingabestream.

-p,--Programmname
Beim Parsen der Parameter des aufrufenden Shell-Skripts werden Fehler- und Nutzungsmeldungen angezeigt
das angegebene Programm enthalten Name anstatt sich darauf zu beziehen pmgetopt sich selbst als Quelle
des Fehlers.

-u,--Verwendungszweck
Eine Nutzungsmeldung, die für das aufrufende Shell-Skript geeignet ist und als eigene angezeigt werden kann
wird mit der Option generiert.

pmgetopt analysiert die angegebenen Parameter und erzeugt eine Ausgabe in einem Format, das für geeignet ist
Quellenangabe im aufrufenden Shell-Skript. Wenn es sowohl kurze als auch lange Formen eines Arguments gibt
die Spezifikation erlaubt, pmgetopt wird zur Vereinfachung immer die Kurzform angeben
Shell-Verarbeitung. Wenn Argumente präsentiert werden, die nicht zur Konfiguration passen, a
Es wird eine Anfrage nach einer Nutzungsnachricht (-?) generiert, auf die das aufrufende Skript antworten kann.
Alle Parameter, die keine Optionen sind, werden an das aufrufende Skript zurückgegeben, dem das vorangestellt ist
Trennzeichen mit doppeltem Bindestrich. Daher sollte ein Skript die Verarbeitung von Optionen beenden, wenn dieses Trennzeichen verwendet wird
erkannt wird, und beginnen Sie mit der Verarbeitung aller Nicht-Optionsargumente.

Anders als bei der eingebauten Shell getopt Befehl werden Variablen wie $OPTARG nicht gesetzt und die
Das aufrufende Skript verwendet normalerweise die integrierte Shell eval, kompensieren und positionell
verschieben Befehle, um sicherzustellen, dass die Optionsverarbeitung korrekt erfolgt.

CONFIGURATION

Das von verwendete Konfigurationsformat pmgetopt soll die Nutzungsbotschaft genau widerspiegeln
die bei Vorhandensein ungültiger Argumente generiert würde (oder -?,--help Möglichkeit).

Es gibt hauptsächlich zwei Arten von Konfigurationszeilen: Befehle und Optionen. Befehle
Ermöglichen Sie die Übergabe von Metadaten an den Optionsverarbeitungsprozess, und Optionen sind die
zulässige Befehlszeilenoptionen, die das Shell-Skript akzeptiert. Befehlszeilen sind
dem ein Rautezeichen vorangestellt ist, wohingegen Optionszeilen immer mit einem Bindestrich beginnen
(entweder einzeln oder doppelt). Jede andere Zeile in der Konfiguration, die möglicherweise die Verwendung enthält
B. Überschriften oder beschreibenden Text, hat keinen Einfluss auf das Parsen der Option und wird kopiert
unverändert in die Nutzungsmeldung übernommen.

Der Befehlssatz ist: getopt (geben Sie die Kurzargument-Optionsspezifikation manuell an, wenn
nicht vorhanden, wird dies aus den dargestellten Optionen generiert), Verwendung (geben Sie eine kurze Ein-
Zeilenzusammenfassung, die am Kopf der Nutzungsnachricht verwendet wird und der das Präfix vorangestellt wird Programmname
vor der Berichterstattung) und Ende was informiert pmgetopt um die Verarbeitung weiterer Befehle zu stoppen und
Optionen – jeder nachfolgend gefundene Text wird einfach an die Nutzungsmeldung angehängt.

Für jede der Standard-PCP-Optionen gibt es eine Kurzschreibweise, wie in beschrieben
PCPIntro(1). Wenn eine dieser Optionen (z --Gastgeber) erscheint als einzelnes Wort in jeder Zeile,
Es wird in die entsprechende Option für das Shell-Skript umgewandelt, einschließlich aller
Metadaten zu dieser Option (ob sie ein Argument akzeptiert, sowohl kurze als auch lange Optionen).
Formulare usw.).

Die Verwendung des Gleichheitszeichens („=") zeigt das Vorhandensein eines erforderlichen Arguments an
Option, sowohl für Kurz- als auch für Langformen. Jede nicht standardmäßige Option muss von einem begleitet werden
nicht leere Beschreibung dieses Arguments.

Beispiele:

Als Beispiel ist Folgendes eine gültige Konfiguration:

# Verwendung: [Optionen] Knoten...

Option:
--Archiv
-D, --verzögern Pause zwischen Aktuelles für Archiv Wiederholung
--Gastgeber
--Intervall
-i=INST, --insts=INST Komma getrennt Metriken Instanz Liste
-r Möglichkeiten für das Ausgangssignal: roh Zähler Nein Rate Wandlung)
--Breite=N kompensieren Breite of jeder Überblick of Möglichkeiten für das Ausgangssignal:
--Zeitzone
--help

Diese Konfiguration erzeugt die folgende Nutzungsmeldung, wenn sie wie gezeigt ausgeführt wird.

$ pmgetopt --Verwendungszweck --progname=clusterstat -- "$@"
Verwendung: Clusterstat [Optionen] Knoten...

Option:
-a DATEI, --archive=DATEI
Metriken Quelle is a CFP Log Archiv
-D, --verzögern Pause zwischen Aktuelles für Archiv Wiederholung
-h GASTGEBER, --host=HOST Metriken Quelle is PMCD on Gastgeber
-t DELTA, --interval=DELTA
Muster Intervall
-i INST, --insts=INST Komma getrennt Metriken Instanz Liste
-r Möglichkeiten für das Ausgangssignal: roh Zähler Nein Rate Wandlung)
--Breite=N kompensieren Breite of jeder Überblick of Möglichkeiten für das Ausgangssignal:
-Z TZ, --timezone=TZ kompensieren Berichterstattung Zeitzone
-?, --help erklären fehlen uns die Worte. Verwendung Nachricht und wunsch

Einige Beispiele von pmgetopt Die Verwendung ist Teil des PCP-Toolkits, insbesondere des pcp(1)
und pmlogmv(1) Skripte bieten gute Referenzbeispiele.

CFP

Umgebungsvariablen mit dem Präfix PCP_ werden verwendet, um die Datei und das Verzeichnis zu parametrieren
Namen, die von PCP verwendet werden. Bei jeder Installation wird die Datei /etc/pcp.conf enthält die lokalen Werte
für diese Variablen. Die $PCP_CONF Variable kann verwendet werden, um eine Alternative anzugeben
Konfigurationsdatei, wie in . beschrieben pcp.conf(5).

Verwenden Sie pmgetopt online über die Dienste von onworks.net