arposix - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

ar — Erstellen und Verwalten von Bibliotheksarchiven

ZUSAMMENFASSUNG

ar-d [−v] Archiv Datei...

ar-m [−v] Archiv Datei...
ar-m-a [−v] Posname Archiv Datei...
ar-m-b [−v] Posname Archiv Datei...
ar-m-i [−v] Posname Archiv Datei...

ar-p [−v] [−s] Archiv [Datei...]

ar − q [−lebenslauf] Archiv Datei...

ar-r [−cuv] Archiv Datei...

ar-r-a [−cuv] Posname Archiv Datei...
ar-r-b [−cuv] Posname Archiv Datei...
ar-r-i [−cuv] Posname Archiv Datei...

ar-t [−v] [−s] Archiv [Datei...]

ar-x [−v] [−sCT] Archiv [Datei...]

BESCHREIBUNG

Die ar Utility ist Teil der Option Software Development Utilities.

Die ar Dienstprogramm kann verwendet werden, um Gruppen von Dateien zu erstellen und zu verwalten, die zu einem
Archiv. Nachdem ein Archiv erstellt wurde, können neue Dateien hinzugefügt und vorhandene Dateien in
ein Archiv kann extrahiert, gelöscht oder ersetzt werden. Wenn ein Archiv ausschließlich aus
gültige Objektdateien, muss die Implementierung das Archiv so formatieren, dass es als
Bibliothek zur Linkbearbeitung (siehe c99 und Fort77). Wenn einige der archivierten Dateien nicht
gültige Objektdateien ist die Eignung des Archivs für die Bibliotheksnutzung undefiniert. Wenn ein
Archiv ausschließlich aus druckbaren Dateien besteht, soll das gesamte Archiv druckbar sein.

Wann ar erstellt ein Archiv, es erstellt Verwaltungsinformationen, die angeben, ob a
Symboltabelle ist im Archiv vorhanden. Wenn es mindestens eine Objektdatei gibt, die ar
im Archiv als solche erkennt, soll eine Archivsymboltabelle im Archiv erstellt werden
und gepflegt von ar; es wird vom Link-Editor verwendet, um das Archiv zu durchsuchen. Immer wenn die ar
Dienstprogramm wird verwendet, um den Inhalt eines solchen Archivs zu erstellen oder zu aktualisieren, die Symboltabelle
soll wieder aufgebaut werden. Die −s Option erzwingt, dass die Symboltabelle neu erstellt wird.

Alle Datei Operanden können Pfadnamen sein. Dateien innerhalb von Archiven müssen jedoch mit a . benannt werden
Dateiname, die letzte Komponente des Pfadnamens, der verwendet wurde, als die Datei eingegeben wurde
das Archiv. Der Vergleich von Datei Operanden für die Namen von Dateien in Archiven sind
durchgeführt, indem die letzte Komponente des Operanden mit dem Namen der Datei im
Archiv.

Es ist nicht angegeben, ob mehrere Dateien im Archiv den gleichen Namen haben dürfen. In dem
bei solchen Dateien jedoch jeweils Datei und Posname Operand soll nur mit der ersten Datei übereinstimmen
im Archiv mit dem gleichen Namen wie die letzte Komponente des Operanden.

OPTIONAL

Die ar Dienstprogramm muss dem Band der Basisdefinitionen von POSIX.1‐2008 entsprechen, Abschnitt 12.2,
Dienstprogramm Syntax Leitlinien, mit Ausnahme von Richtlinie 9.

Folgende Optionen sollen unterstützt werden:

-a Positionieren Sie neue Dateien im Archiv nach der Datei mit dem Namen Posname Operand.

-b Positionieren Sie neue Dateien im Archiv vor der Datei, die durch das Posname Operand.

-c Unterdrücken Sie die Diagnosemeldung, die standardmäßig in den Standardfehler geschrieben wird
wenn das archiv Archiv geschaffen.

-C Verhindern Sie, dass extrahierte Dateien gleichnamige Dateien im Dateisystem ersetzen. Dies
Option ist nützlich, wenn -T wird auch verwendet, um zu verhindern, dass abgeschnittene Dateinamen
Ersetzen von Dateien mit dem gleichen Präfix.

-d Löschen Sie eine oder mehrere Dateis aus Archiv.

- ich Positionieren Sie neue Dateien im Archiv vor der Datei im Archiv, die mit dem Namen benannt ist
Posname Operand (entspricht -b).

-m Verschieben Sie die benannten Dateien in das Archiv. Die -a, -b oder - ich Optionen mit der Posname
Operand gibt die Position an; Verschieben Sie andernfalls die Namensdateien im Archiv nach
das Ende des Archivs.

−S Schreiben Sie den Inhalt der Dateis im Archiv namens von Datei Operanden von
Archiv zur Standardausgabe. Wenn nein Datei Operanden werden angegeben, der Inhalt
aller Dateien im Archiv werden in der Reihenfolge des Archivs geschrieben.

−q Hängen Sie die benannten Dateien an das Ende des Archivs an. In diesem Fall ar prüft nicht
ob sich die hinzugefügten Dateien bereits im Archiv befinden. Dies ist nützlich, um zu umgehen
die sonst bei der Erstellung eines großen Archivs stückweise durchgeführte Suche.

−r Ersetzen oder hinzufügen Dateis Archiv. Wenn das Archiv mit dem Namen Archiv nicht
vorhanden ist, soll ein neues Archiv erstellt und eine Diagnosemeldung geschrieben werden
auf Standardfehler (es sei denn, die -c Option angegeben). Wenn nein Dateis sind angegeben
und den Archiv existiert, die Ergebnisse sind undefiniert. Dateien, die vorhandene ersetzen
Dateien im Archiv dürfen die Reihenfolge des Archivs nicht ändern. Dateien, die
vorhandene Dateien im Archiv nicht ersetzen werden an das Archiv angehängt
es sei denn a -a, -b oder - ich Option gibt eine andere Position an.

−s Erzwingen Sie die Neugenerierung der Archivsymboltabelle, auch wenn ar wird nicht aufgerufen
mit einer Option, die den Archivinhalt ändert. Diese Option ist nützlich, um
Wiederherstellen der Archivsymboltabelle, nachdem sie entfernt wurde; sehen abstreifen.

−t Schreiben Sie ein Inhaltsverzeichnis von Archiv zur Standardausgabe. Nur die Dateien
angegeben durch die Datei Operanden sind in die schriftliche Liste aufzunehmen. Wenn nein Datei
Operanden sind angegeben, alle Dateien in Archiv wird in der Reihenfolge
das Archiv.

-T Abschneiden des Dateinamens von extrahierten Dateien zulassen, deren Archivnamen länger sind als
das Dateisystem unterstützen kann. Standardmäßig wird eine Datei mit einem Namen extrahiert, der
zu lang soll ein Fehler sein; eine Diagnosemeldung geschrieben und die Datei
nicht herausgezogen werden.

-u Aktualisieren Sie ältere Dateien im Archiv. Bei Verwendung mit dem −r Option, Dateien im
Archiv wird nur ersetzt, wenn die entsprechenden Datei hat eine Änderungszeit
das ist mindestens so neu wie der Änderungszeitpunkt der Datei im Archiv.

−v Geben Sie eine ausführliche Ausgabe. Bei Verwendung mit den Optionszeichen -d, −r oder −x, Schreib ein
detaillierte dateiweise Beschreibung der Archiverstellung und -pflege
Aktivität, wie im Abschnitt STDOUT beschrieben.

Bei Verwendung mit −S, schreibe den Namen der Datei im Archiv in den Standard
Ausgabe bevor Sie die Datei im Archiv selbst auf die Standardausgabe schreiben, da
im Abschnitt STDOUT beschrieben.

Bei Verwendung mit −t, eine lange Liste mit Informationen zu den Dateien im
archivieren, wie im Abschnitt STDOUT beschrieben.

−x Extrahieren Sie die Dateien im Archiv mit dem Namen Datei Operanden von Archivdem „Vermischten Geschmack“. Seine
Der Inhalt des Archivs darf nicht verändert werden. Wenn nein Datei Operanden sind gegeben, alle
Dateien im Archiv sollen extrahiert werden. Die Änderungszeit jeder Datei
Extracted wird auf den Zeitpunkt gesetzt, zu dem die Datei aus dem Archiv extrahiert wird.

OPERANDEN

Folgende Operanden sollen unterstützt werden:

Archiv Ein Pfadname des Archivs.

Datei Ein Pfadname. Beim Vergleich mit dem darf nur die letzte Komponente verwendet werden
Namen von Dateien im Archiv. Wenn zwei oder mehr Datei Operanden haben den gleichen letzten
Pfadname-Komponente (Basisname), die Ergebnisse sind nicht angegeben. Die Implementierung
Das Archivformat darf gültige Dateinamen von Dateien, die hinzugefügt oder ersetzt wurden, nicht abschneiden
im Archiv.

Posname Der Name einer Datei im Archiv, der für die relative Positionierung verwendet wird; siehe Optionen -m
und −r.

STDIN

Nicht benutzt.

SPEISUNG DATEIEN

Das Archiv namens von Archiv ist eine Datei im Format erstellt von ar −r.

VARIABLEN

Die folgenden Umgebungsvariablen sollen die Ausführung von ar:

SPRACHE Geben Sie einen Standardwert für die Internationalisierungsvariablen an, die nicht festgelegt sind oder
Null. (Siehe den Band Basisdefinitionen von POSIX.1‐2008, Abschnitt 8.2,
Internationalisierung Variablen für den Vorrang der Internationalisierung
Variablen, die verwendet werden, um die Werte von Gebietsschemakategorien zu bestimmen.)

LC_ALL Wenn auf einen nicht leeren Zeichenfolgenwert gesetzt, überschreiben Sie die Werte aller anderen
Internationalisierungsvariablen.

LC_CTYPE Bestimmen Sie das Gebietsschema für die Interpretation von Sequenzen von Bytes von Textdaten
als Zeichen (z. B. Einzelbyte- im Gegensatz zu Mehrbyte-Zeichen in
Argumente und Eingabedateien).

LC_MESSAGES
Bestimmen Sie das Gebietsschema, das verwendet werden soll, um das Format und den Inhalt von . zu beeinflussen
Diagnosemeldungen in Standardfehler geschrieben.

LC_TIME Bestimmen Sie das Format und den Inhalt für Datums- und Zeitzeichenfolgen, die von geschrieben wurden ar − fernseher.

NLSPATH Bestimmen Sie den Speicherort von Nachrichtenkatalogen für die Verarbeitung von LC_MESSAGES.

TMPDIR Bestimmen Sie den Pfadnamen, der das Standardverzeichnis für temporäre Dateien überschreibt,
wenn überhaupt.

TZ Bestimmen Sie die Zeitzone, die verwendet wird, um Datums- und Zeitzeichenfolgen zu berechnen, die von geschrieben wurden ar
− fernseher. Wenn TZ nicht gesetzt oder null ist, wird eine nicht spezifizierte Standardzeitzone verwendet.

ASYNCHRON EVENTS

Standard.

STDOUT

Besitzt das -d Option wird mit verwendet −v Option ist das Standardausgabeformat:

"d - %s\n", <Datei>

woher Datei ist der in der Befehlszeile angegebene Operand.

Besitzt das −S Option wird mit verwendet −v Option, ar soll dem Inhalt jeder Datei vorangehen
mit:

"\n<%s>\n\n", <Datei>

woher Datei ist der in der Befehlszeile angegebene Operand, wenn Datei Operanden wurden angegeben,
und den Namen der Datei im Archiv, falls nicht.

Besitzt das −r Option wird mit verwendet −v Option:

* Ob Datei sich bereits im Archiv befindet, ist das Standardausgabeformat:

"r - %s\n", <Datei>

woDatei> ist der in der Befehlszeile angegebene Operand.

* Ob Datei nicht bereits im Archiv vorhanden ist, ist das Standardausgabeformat:

"a - %s\n", <Datei>

woDatei> ist der in der Befehlszeile angegebene Operand.

Besitzt das −t Option verwendet wird, ar schreibt die Namen der Dateien im Archiv an die
Standardausgabe im Format:

"%s\n", <Datei>

woher Datei ist der in der Befehlszeile angegebene Operand, wenn Datei Operanden wurden angegeben,
oder der Name der Datei im Archiv, wenn dies nicht der Fall ist.

Besitzt das −t Option wird mit verwendet −v Option ist das Standardausgabeformat:

"%S %u/%u %u %s %d %d:%d %d %s\n", <Mitglied Modus>,Benutzer ID>,
<Gruppe ID>,Anzahl of Bytes in Mitglied>,
<abgekürzt Monat>,Monatstag>,Stunde>,
<Minute>,Jahr>,Datei>

wo:

<Datei> Soll der in der Befehlszeile angegebene Operand sein, wenn Datei Operanden waren
angegeben, oder der Name der Datei im Archiv, falls dies nicht der Fall war.

<Mitglied Modus>
Soll genauso formatiert sein wie dieDatei Modus> String definiert im STDOUT
Abschnitt ls, außer dass das erste Zeichen, dasEintrag tippe>, wird nicht verwendet;
Die Zeichenfolge stellt den Dateimodus der Datei im Archiv zum Zeitpunkt der Erstellung dar
wurde dem Archiv hinzugefügt oder ersetzt.

Die folgenden Angaben stellen den Zeitpunkt der letzten Änderung einer Datei dar, als sie zuletzt war
zum Archiv hinzugefügt oder ersetzt:

<abgekürzt Monat>
Entspricht dem Format der %b Konvertierungsspezifikationsformat in Datum.

<Monatstag>
Entspricht dem Format der %e Konvertierungsspezifikationsformat in Datum.

<Stunde> Entspricht dem Format der %H Konvertierungsspezifikationsformat in Datum.

<Minute> Entspricht dem Format der %M Konvertierungsspezifikationsformat in Datum.

<Jahr> Entspricht dem Format der %Y Konvertierungsspezifikationsformat in Datum.

Wann LC_TIME gibt nicht das POSIX-Gebietsschema an, ein anderes Format und eine andere Reihenfolge von
die Darstellung dieser Felder relativ zueinander kann in einem geeigneten Format verwendet werden
das angegebene Gebietsschema.

Besitzt das −x Option wird mit verwendet −v Option ist das Standardausgabeformat:

"x - %s\n", <Datei>

woher Datei ist der in der Befehlszeile angegebene Operand, wenn Datei Operanden wurden angegeben,
oder der Name der Datei im Archiv, wenn dies nicht der Fall ist.

STDERR

Der Standardfehler darf nur für Diagnosemeldungen verwendet werden. Die Diagnosemeldung
über das Erstellen eines neuen Archivs, wenn -c nicht angegeben ist, darf den Exit-Status nicht ändern.

AUSGABE DATEIEN

Archive sind Dateien mit nicht spezifizierten Formaten.

VERLÄNGERT BESCHREIBUNG

Keine zusätzlichen Tools.

EXIT STATUS

Die folgenden Exit-Werte sollen zurückgegeben werden:

0 Erfolgreicher Abschluss.

>0 Es ist ein Fehler aufgetreten.

FOLGEN OF FEHLER

Standard.

Die Folgende Abschnitte sind informativ.

ANWENDUNGEN ANWENDUNG

Keine zusätzlichen Tools.

Beispiele:

Keine zusätzlichen Tools.

RATIONALE

Das Archivformat wird nicht beschrieben. Es ist bekannt, dass mehrere bekannt sind ar
Formate, die nicht kompatibel sind. Die ar Dienstprogramm ist jedoch enthalten, um die Erstellung zu ermöglichen
von Archiven, die nur für die Verwendung auf einer Maschine bestimmt sind. Das Archiv wird als a . angegeben
Datei und kann als Datei verschoben werden. Dadurch kann ein Archiv aus einem verschoben werden
Maschine zu einer anderen Maschine, die dieselbe Implementierung von verwendet ar.

Dienstprogramme wie pax (und seine Vorfahren Teer und CPIO) stellen auch portable ``Archive'' bereit.
Dies ist keine Vervielfältigung; das ar Dienstprogramm ist enthalten, um in erster Linie eine Schnittstelle bereitzustellen
für um und die Compiler, basierend auf einem historischen Modell.

In historischen Implementierungen ist die −q Option (verfügbar auf XSI-konformen Systemen) ist
bekannt für schnelle Ausführung, weil ar überprüft nicht, ob die hinzugefügten Mitglieder
schon im Archiv. Dies ist nützlich, um die sonst durchgeführte Suche zu umgehen, wenn
Stück für Stück ein großes Archiv erstellen. Diese Bemerkungen können, müssen aber nicht für a . gelten
brandneue Implementierung dieses Dienstprogramms; daher wurden diese Bemerkungen in die
BEGRÜNDUNG.

BSD-Implementierungen erforderten in der Vergangenheit Anwendungen, um die −s Option wann immer
das Archiv sollte eine Symboltabelle enthalten. Wie in diesem Band von POSIX.1‐2008,
System V erstellt oder aktualisiert in der Vergangenheit eine Archivsymboltabelle, wenn eine Objektdatei
aus dem Archiv entfernt, hinzugefügt oder aktualisiert wird.

Der Abschnitt OPERANDEN verlangt, was wahr zu sein scheint, ohne es zu spezifizieren: die
Das Archiv kann die Dateinamen unter {NAME_MAX} nicht abschneiden. Einige historische Implementierungen
Dies führt jedoch zu unerwarteten Ergebnissen für die Anwendung. Daher ist dieses Volumen von
POSIX.1‐2008 macht die Forderung explizit, um Missverständnisse zu vermeiden.

Gemäß der System V-Dokumentation sind die Optionen −dmpqrtx sind nicht erforderlich, um zu beginnen
mit einem ('-'). Dieser Band von POSIX.1‐2008 erfordert, dass eine konforme Anwendung
benutze die führende .

Das von der 4.4 BSD-Implementierung verwendete Archivformat ist in dieser RATIONALE dokumentiert als
ein Beispiel:

Eine Datei erstellt von ar beginnt mit der Zeichenfolge ``magic'' "! \n". Der Rest des
Archiv besteht aus Objekten, von denen jedes aus einem Header für eine Datei besteht, a
möglichen Dateinamen und den Dateiinhalt. Der Header ist zwischen Maschine tragbar
Architekturen, und wenn der Dateiinhalt druckbar ist, ist das Archiv selbst
druckbar.

Der Header besteht aus sechs ASCII-Feldern, gefolgt von einem zweistelligen Trailer. Die
Felder sind der Objektname (16 Zeichen), die letzte Änderungszeit der Datei (12
Zeichen), die Benutzer- und Gruppen-IDs (je 6 Zeichen), den Dateimodus (8
Zeichen) und die Dateigröße (10 Zeichen). Alle numerischen Felder sind dezimal,
mit Ausnahme des Dateimodus, der oktal ist.

Die Änderungszeit ist die Datei st_mtime Gebiet. Die Benutzer- und Gruppen-IDs sind die
Datei st_uid und st_gid Felder. Der Dateimodus ist die Datei st_mode Gebiet. Die Datei
Größe ist die Datei st_größe Gebiet. Der Zwei-Byte-Trailer ist der String "` ".

Lediglich im Namensfeld ist ein Überlauf vorgesehen. Wenn ein Dateiname größer als 16 . ist
Zeichen lang oder enthält ein eingebettetes Leerzeichen, die Zeichenfolge "#1/" gefolgt von
die ASCII-Länge des Namens wird in das Namensfeld geschrieben. Die Dateigröße (gespeichert
im Archivheader) wird um die Länge des Namens erhöht. Der Name ist dann
unmittelbar nach dem Archiv-Header geschrieben.

Alle nicht verwendeten Zeichen in einem dieser Felder werden geschrieben als Zeichen. Wenn
alle Felder sind ihre jeweilige maximale Anzahl von Zeichen in der Länge, es gibt kein
Trennung zwischen den Feldern.

Objekte im Archiv sind immer eine gerade Anzahl von Bytes lang; Dateien, die ein
ungerade Anzahl von Bytes lang werden mit a padded aufgefüllt , obwohl die Größe im
Kopfzeile spiegelt dies nicht wider.

Die ar Die Beschreibung des Dienstprogramms erfordert dies (wenn alle seine Mitglieder gültige Objektdateien sind) ar
Erstellen Sie eine Objektcodebibliothek, die der Verknüpfungseditor zum Extrahieren von Objekten verwenden kann
Module. Wenn der Verknüpfungseditor eine Symboltabelle benötigt, um einen wahlfreien Zugriff auf die
Archiv, ar muss es bereitstellen; jedoch, ar benötigt keine Symboltabelle.

Die BSD −o Option wurde weggelassen. Es ist eine seltene konforme Anwendung, die verwendet ar extrahieren
Objektcode aus einer Bibliothek mit Rücksicht auf seine Änderungszeit, da dies nur
von Bedeutung für um. Da diese Funktionalität für nicht wichtig erachtet wird,
Portabilität der Anwendungen, die Änderungszeit der extrahierten Dateien wird auf die
aktuelle Uhrzeit.

Es gibt mindestens eine bekannte Implementierung (für einen kleinen Computer), die
nur Objektdateien für dieses System, gemischte Objekt- und andere Dateien werden nicht zugelassen. Die Fähigkeit
Jede Art von Datei zu handhaben ist für die meisten Implementierungen nicht nur historische Praxis, sondern
ist auch eine berechtigte Erwartung.

Es wurde überlegt, das Ausgabeformat von . zu ändern ar − fernseher im gleichen Format wie die
Ausgabe von ls − l. Dies hätte das Parsen der Ausgabe von ar das gleiche wie das von ls.
Dies wurde teilweise abgelehnt, weil die aktuelle ar Format wird häufig verwendet und Änderungen würden
historischen Gebrauch brechen. Sekunde, ar gibt die Benutzer-ID und die Gruppen-ID im numerischen Format an
getrennt durch a . Dies in den Benutzernamen und den Gruppennamen zu ändern, wäre nicht
korrekt, wenn das Archiv auf einen Computer verschoben wurde, der eine andere Benutzerdatenbank enthielt.
Da ar kann nicht wissen, ob das Archiv auf demselben Computer erstellt wurde, es kann nicht sagen
was zu melden ist.

Der Text zum −ur Optionskombination ist historische Praxis – da ein Dateiname
problemlos zwei verschiedene Dateien darstellen (z. B. /a/foo und /b/foo), ist es vernünftig,
Ersetzen Sie die Datei im Archiv, auch wenn die Änderungszeit im Archiv beträgt
identisch mit dem im Dateisystem.

ZUKUNFT Anfahrt

Keine zusätzlichen Tools.

Verwenden Sie arposix online mit den onworks.net-Diensten