SCCS-Befehl "prs"
Zweck
Zeigt eine SCCS-Datei (Source Code Control System) an.
Syntax
prs [ -a ] [ -d String ] [ -r [ SID ] | [ -c Cutoff ] ] [ -e | -l ] Datei...
Beschreibung
Der Befehl prs liest zuerst die angegebenen Dateien und schreibt anschließend einen Teil oder den gesamten Inhalt der SCCS-Datei in die Standardausgabe. Wenn Sie ein Verzeichnis für den File-Parameter angeben, führt der prs-Befehl die angeforderten Aktionen für alle SCCS-Dateien aus (diejenigen mit dem s. Präfix). Wenn Sie für den Parameter File ein - (Minus) angeben, liest der Befehl prs die Standardeingabe und interpretiert jede Zeile als den Namen einer SCCS-Datei. Der Befehl prs liest die Eingabe, bis er ein Dateiendezeichen findet.
Daten Schlüsselwörter
Datenschlüsselwörter geben die Teile einer SCCS-Datei an, die abgerufen und in die Standardausgabe geschrieben werden sollen. Allen Teilen einer SCCS-Datei ist ein Datenschlüsselwort zugeordnet. Wie oft ein Datenschlüsselwort in einer bestimmten Datei verwendet werden kann, ist nicht begrenzt.
Die Informationen, die der Befehl prs anzeigt, bestehen aus dem vom Benutzer eingegebenen Text und den entsprechenden (aus der SCCS-Datei extrahierten) Werten, die die erkannten Datenschlüsselwörter in der Reihenfolge ersetzen, in der sie in der angegebenen Datei angezeigt werden. Das Format eines Datenschlüsselwortwerts ist entweder einfach, d. h., die Schlüsselwortsubstitution erfolgt direkt, oder mehrzeilig, d. h., der Schlüsselwortsubstitution folgt ein Rücklauf. Text besteht aus allen Zeichen mit Ausnahme der erkannten Datenschlüsselwörter. Geben Sie ein Tabulatorzeichen mit \t (Backslash, Buchstabe t) und ein Zeilenvorschubzeichen mit \n (Backslash, Buchstabe n) an. Sie müssen \t und \n mit einem zusätzlichen Backslash (\) angeben, um zu verhindern, dass die Shell den Backslash (\) interpretiert und nur den Buchstaben t bzw. n als Text an den Befehl prs übergibt.
In der folgenden Tabelle sind die Schlüsselwörter aufgelistet, die den Informationen in der Deltatabelle der SCCS-Datei zugeordnet sind. Alle Schlüsselwörter haben das einfache Format, sofern nicht anders angegeben.
| Schlüsselwort | Dargestellte Daten | Wert |
|---|---|---|
| :R: | Releasenummer | Nummer |
| :L: | Ebenennummer | Nummer |
| :B: | Zweignummer | Nummer |
| :S: | Folgenummer | Nummer |
| :I: | SCCS-ID-Zeichenfolge (SID) | :R::L::B::S: |
| :Dy: | Jahr, in dem das Delta erstellt wurde | YY |
| :Dm: | Monat, in dem das Delta erstellt wurde | MM |
| :Dd: | Tag, an dem das Delta erstellt wurde | DD |
| :D: | Datum, an dem das Delta erstellt wurde | JJ/MM/TT |
| :th: | Stunde, in der das Delta erstellt wurde | HH |
| :Tm: | Minute, in der das Delta erstellt wurde | MM |
| :Ts: | Sekunde, in der das Delta erstellt wurde | SS |
| :T: | Zeit, zu der das Delta erstellt wurde | HH/MM/SS |
| :DT: | Deltatyp | D oder R |
| Element | Beschreibung | Wert |
|---|---|---|
| :P: | Benutzer, der das Delta erstellt hat | Anmeldename |
| :DS: | Folgenummer des Deltas | Nummer |
| :DP: | Folgenummer des vorherigen Deltas | Nummer |
| :Dt: | Deltainformationen | :DT::I::D::T::P::DS::DP: |
| :Dn: | Folgenummern der eingeschlossenen Deltas | :DS: . . . |
| :Dx: | Folgenummern der ausgeschlossenen Deltas | :DS: . . . |
| :Dg: | Folgenummern der ignorierten Deltas | :DS: . . . |
| :DI: | Folgenummern der eingeschlossenen, ausgeschlossenen und ignorierten Deltas | :Dn:/:Dx:/:Dg: |
| :Li: | Durch das Delta eingefügte Zeilen | Nummer |
| :Ld: | Durch das Delta gelöschte Zeilen | Nummer |
| :Lu: | Durch das Delta nicht geänderte Zeilen | Nummer |
| :DL: | Zeilenstatistiken für das Delta | :Li:/:Ld:/:Lu: |
| :MR: (Mehrzeilenformat) | MR-Nummern für das Delta | Text |
| :C: (Mehrzeilenformat) | Kommentare zum Delta | Text |
In der folgenden Tabelle sind die Schlüsselwörter aufgelistet, die den Header-Flags in der SCCS-Datei zugeordnet sind. Alle Schlüsselwörter haben das einfache Format, sofern nicht anders angegeben.
| Schlüsselwort | Dargestellte Daten | Wert |
|---|---|---|
| :Y: | Modultyp | Text |
| :MF: | MR-Validierungsflag gesetzt | yes oder no |
| :MP: | Name des MR-Validierungsprogramms | Text |
| :KF: | Flag für Schlüsselwort/Fehlerwarnung gesetzt | yes oder no |
| :BF: | Flag für Zweig gesetzt | yes oder no |
| :J: | Flag für verknüpfte Verarbeitung gesetzt | yes oder no |
| :LK: | Gesperrte Releases | :R: . . . |
| :Q: | Benutzerdefiniertes Schlüsselwort | Text |
| :M: | Modulname | Text |
| :FB: | Unterer Grenzwert | :R: |
| :CB: | Oberer Grenzwert | :R: |
| :Ds: | Standard-SID | :I: |
| :ND: | Flag für Nulldelta gesetzt | yes oder no |
| :FL: (Mehrzeilenformat) | Liste der Header-Flags | Text |
In der folgenden Tabelle sind die Schlüsselwörter aufgeführt, die anderen Teilen der SCCS-Datei zugeordnet sind. Alle Schlüsselwörter haben das einfache Format, sofern nicht anders angegeben.
| Schlüsselwort | Dargestellte Daten | Wert |
|---|---|---|
| :UN: (Mehrzeilenformat) | Benutzernamen | Text |
| :FD: (Mehrzeilenformat) | Beschreibung | Text |
| :BD: (Mehrzeilenformat) | Hauptteil des Textes | Text |
| :GB: (Mehrzeilenformat) | Text in einer g-Datei | Text |
| :W: | what-Zeichenfolge | :Z::M: \tab :I: |
| :A: | what-Zeichenfolge | :Z::Y::M::I::Z: |
| :Z: | Begrenzer für what-Zeichenfolgen | @(#) |
| :F: | SCCS-Dateiname | Text |
| :PN: | SCCS-Dateipfadname | Text |
Flags
Jedes Flag oder jede Gruppe von Flags wird unabhängig auf jede benannte Datei angewendet.
| Element | Beschreibung |
|---|---|
| -A | Schreibt Informationen für die angegebenen Deltas, unabhängig davon, ob sie entfernt wurden oder nicht (siehe den Befehl rmdel). Wenn Sie das Flag -a nicht angeben, stellt der Befehl prs nur Informationen zu den angegebenen Deltas, die nicht entfernt wurden, bereit. |
| -c Cutoff | Gibt ein Cutoff-Datum und eine Cutoff-Zeit für die Flags -e und -l an. Geben Sie den Cutoff-Wert im folgenden Format an:Für alle nicht angegebenen Elemente werden standardmäßig die Maximalwerte verwendet. Somit ist die Angabe von -c8402 mit der Angabe von -c840229235959 identisch. Sie können die Felder durch jedes beliebige nicht numerische Zeichen trennen. Sie können zum Beispiel angeben-c84/2/20,9:22:25oder-c"84/2/20 9:22:25"oder"-c84/2/20 9:22:25". Das Flag -c kann nicht zusammen mit dem Flag -r angegeben werden. |
| -d Zeichenfolge | Gibt die Datenelemente an, die angezeigt werden sollen. Die Zeichenfolge besteht aus optionalem Text und Schlüsselwörtern für SCCS-Dateidaten. Die Zeichenfolge kann MBCS-Zeichen (Mehrbytezeichensatz) enthalten. Wenn die Zeichenfolge Leerzeichen enthält, müssen Sie die Zeichenfolge in Anführungszeichen einschließen. |
| -E | Fordert Informationen zu allen erstellten Deltas vor dem und einschließlich des mit dem Flag -r angegebenen Deltas an. |
| -l | Fordert Informationen zu allen erstellten Deltas nach dem und einschließlich des mit dem Flag -r angegebenen Deltas an. |
| -r[SID] | Gibt die SCCS-ID-Zeichenfolge (SID) des Deltas an, für das der Befehl prs Informationen abruft. Geben Sie kein Leerzeichen zwischen dem Flag -r und dem optionalen SID-Parameter ein. Wenn keine SID angegeben ist, ruft der Befehl die Informationen für die SID des Deltas mit der höchsten Nummer ab. Das Flag -r kann nicht zusammen mit dem Flag -c angegeben werden. |
Exitstatus
Dieser Befehl gibt die folgenden Exitwerte zurück:
| Element | Beschreibung |
|---|---|
| 0 | Erfolgreiche Ausführung. |
| >0 | Es ist ein Fehler aufgetreten. |
Beispiele
- Um Informationen über alle Deltas anzuzeigen, die für den SCCS-Dateinamen s.test.c erzeugt wurden (einschließlich aller Deltas, die mit dem Befehl rmdel entfernt wurden), geben Sie ein:
prs -a s.test.c - Anzeige des Login-Namens des Benutzers, der Anzahl der durch Delta eingefügten Zeilen und der Anzahl der durch Delta gelöschten Zeilen für SID1.2vons.test.c, Typ:
prs -r1.2 -d":P:\n:Li:\n:Ld:" s.test.c
Dateien
| Element | Beschreibung |
|---|---|
| /usr/bin/prs | Enthält den Befehl prs. |