llvm-ar-3.7 - Online in de cloud

PROGRAMMA:

NAAM

llvm-ar - LLVM-archiver

KORTE INHOUD

llvm-ar [-]{dmpqrtx}[Rabfikou] [relpos] [count] [bestanden...]

PRODUCTBESCHRIJVING

De llvm-ar opdracht is vergelijkbaar met het gewone Unix-hulpprogramma, ar. Het archiveert verschillende bestanden
samen in één bestand. De bedoeling hiervan is om archiefbibliotheken te produceren door LLVM
bitcode die kan worden gekoppeld aan een LLVM-programma. Het archief kan echter elk soort bevatten
van bestand. Standaard, llvm-ar genereert een symbolentabel die het koppelen sneller maakt omdat
alleen de symbolentabel hoeft te worden geraadpleegd, niet elk afzonderlijk bestandslid van het
archief.

De llvm-ar commando kan worden gebruikt dit artikel lezen Archiefbestanden in SVR4-, GNU- en BSD-stijl. Echter,
op dit moment kan het alleen schrijven in het GNU-formaat. Als een archief in SVR4- of BSD-stijl wordt gebruikt
met de r (vervangen) of q (snelle update) bewerkingen, wordt het archief gereconstrueerd
GNU-indeling.

Hier is waar llvm-ar wijkt af van het vorige ar implementaties:

Symbool tafel
Sinds llvm-ar ondersteunt bitcodebestanden. De symbooltabel die wordt gemaakt, is in GNU-indeling en
bevat zowel native- als bitcodebestanden.

lang Paden
Op dit moment llvm-ar kan GNU en BSD lange bestandsnamen lezen, maar schrijft alleen archieven met
het GNU-formaat.

OPTIES

De opties om llvm-ar zijn compatibel met andere ar implementaties. Er zijn echter een
enkele modificaties (R) die niet in andere voorkomen ar implementaties. De opties om llvm-ar
specificeer een enkele basisbewerking om uit te voeren op het archief, een verscheidenheid aan modifiers voor
die bewerking, de naam van het archiefbestand en een optionele lijst met bestandsnamen. Deze
opties worden gebruikt om te bepalen hoe llvm-ar moet het archiefbestand verwerken.

De bewerkingen en aanpassingen worden in de onderstaande gedeelten uitgelegd. De minimale set van
opties is minimaal één operator en de naam van het archief. Meestal eindigen archiefbestanden
met een .a achtervoegsel, maar dit is niet vereist. Volgens de archiefnaam komt een lijst van
bestanden die de specifieke leden van het archief aangeven waarop moet worden geopereerd. Als de bestanden optie
niet is gespecificeerd, betekent het over het algemeen "geen" of "alle" leden, afhankelijk van de
operatie.

Operations
d
Verwijder bestanden uit het archief. Er zijn geen modificaties van toepassing op deze bewerking. De
bestanden opties specificeren welke leden uit het archief moeten worden verwijderd. Het is geen
fout als een opgegeven bestand niet in het archief verschijnt. Als Nee bestanden zijn gespecificeerd,
het archief wordt niet gewijzigd.

m[abi]
Verplaats bestanden van de ene locatie in het archief naar de andere. De a, b en i modificaties zijn van toepassing
aan deze operatie. De bestanden zullen allemaal worden verplaatst naar de locatie die door de modifiers is opgegeven.
Als er geen modifiers worden gebruikt, worden de bestanden verplaatst naar het einde van het archief. Als Nee
bestanden zijn opgegeven, wordt het archief niet gewijzigd.

p
Druk bestanden af ​​naar de standaarduitvoer. Deze bewerking drukt eenvoudigweg het bestanden aangegeven om
de standaard uitvoer. Als Nee bestanden zijn opgegeven, wordt het hele archief afgedrukt.
Het afdrukken van bitcodebestanden is onverstandig omdat ze uw terminalinstellingen kunnen verwarren. De
p operatie wijzigt nooit het archief.

q
Voeg snel bestanden toe aan het einde van het archief. Deze bewerking voegt snel de bestanden
naar het archief zonder te controleren op duplicaten die eerst moeten worden verwijderd. Als Nee
bestanden zijn opgegeven, wordt het archief niet gewijzigd. Vanwege de manier waarop llvm-ar
het archiefbestand samenstelt, is het twijfelachtig of de q operatie is sneller dan de
r operatie.

r[abu]
Bestandsleden vervangen of invoegen. De a, b en u modifiers zijn van toepassing op deze bewerking.
Deze operatie zal bestaande vervangen bestanden of plaats ze aan het einde van het archief als
ze bestaan ​​niet. Als Nee bestanden zijn opgegeven, wordt het archief niet gewijzigd.

TV]
Druk de inhoudsopgave af. Zonder enige modifiers drukt deze bewerking alleen het
namen van de leden naar de standaarduitvoer. Met de v Bewerken, llvm-ar ook afdrukken
het bestandstype (B=bitcode, S=symbolentabel, blanco=normaal bestand), de toestemmingsmodus,
de eigenaar en groep, de grootte en de datum. Indien van toepassing bestanden zijn opgegeven, de aanbieding is
alleen voor die bestanden. Als Nee bestanden zijn gespecificeerd, de inhoudsopgave voor het geheel
archief wordt afgedrukt.

x[op]
Extraheer archiefleden terug naar bestanden. De o modifier is van toepassing op deze bewerking. Dit
bewerking haalt het aangegeven op bestanden uit het archief en schrijft ze terug naar de
het bestandssysteem van het besturingssysteem. Als Nee bestanden zijn opgegeven, is het hele archief
extract.

modifiers (operatie specifiek)
De onderstaande modificaties zijn specifiek voor bepaalde bewerkingen. Zie het gedeelte Bewerkingen (hierboven)
om te bepalen welke modifiers van toepassing zijn op welke bewerkingen.

[A]
Bij het invoegen of verplaatsen van lidbestanden, specificeert deze optie de bestemming van de nieuwe
bestanden als zijnde na de relpo's lid. Als relpo's niet wordt gevonden, worden de bestanden geplaatst op
het einde van het archief.

[B]
Bij het invoegen of verplaatsen van lidbestanden, specificeert deze optie de bestemming van de nieuwe
bestanden als vóór de relpo's lid. Als relpo's niet wordt gevonden, worden de bestanden geplaatst
aan het einde van het archief. Deze modifier is identiek aan de i modifier.

[I]
Een synoniem voor de b optie.

[of]
Bij het uitpakken van bestanden veroorzaakt deze optie llvm-ar om het origineel te behouden
wijzigingstijden van de bestanden die het schrijft.

[U]
Vervang bij het vervangen van bestaande bestanden in het archief alleen die bestanden die een tijd hebben
stempel dan de tijdstempel van het lid in het archief.

modifiers (algemeen)
De onderstaande modificaties kunnen op elke bewerking worden toegepast.

[C]
Voor alle operaties, llvm-ar zal altijd het archief aanmaken als het niet bestaat.
Normaal llvm-ar zal een waarschuwingsbericht afdrukken dat aangeeft dat het archief bezig is
gemaakt. Het gebruik van deze modifier schakelt die waarschuwing uit.

[S]
Deze modifier vraagt ​​om een ​​archiefindex (of symbooltabel) aan het archief toe te voegen.
Dit is de standaard werkingsmodus. De symbolentabel bevat alle externe
zichtbare functies en globale variabelen gedefinieerd door alle bitcodebestanden in het archief.

[S]
Deze modifier is het tegenovergestelde van de s modificator. Het instrueert llvm-ar om niet te bouwen
symbool tafel. Als beide s en S worden gebruikt, zal de laatste modifier die in de opties voorkomt
zegevieren.

[V]
Deze modifier instrueert llvm-ar breedsprakig zijn over wat het doet. Elke bewerking
operatie tegen het archief zal een uitvoerregel produceren die zegt wat er aan de hand is
gedaan.

NORMEN

De llvm-ar hulpprogramma is bedoeld om een ​​superset te bieden van de IEEE Std 1003.2 (POSIX.2)
functionaliteit voor ar. llvm-ar kan zowel SVR4- als BSD4.4-archieven (of Mac OS X) lezen. Als de
f modifier wordt gegeven aan de x or r operaties dan llvm-ar zal SVR4-compatibel schrijven
archieven. Zonder deze modifier, llvm-ar zal BSD4.4-compatibele archieven schrijven die hebben
lange namen direct na de koptekst en aangegeven met de "#1/ddd"-notatie voor de
naam in de kop.

FILE FORMAT

De bestandsindeling voor LLVM-archiefbestanden is vergelijkbaar met die van BSD 4.4 of Mac OSX-archief
bestanden. In feite, met uitzondering van de symbolentabel, de ar opdrachten op die besturingssystemen
zou LLVM-archiefbestanden moeten kunnen lezen. De details van het bestandsformaat volgen.

Elk archief begint met het magische getal van het archief, dat zijn de acht afdrukbare tekens
"! n" waarbij n staat voor het teken voor een nieuwe regel (0x0A). Volgend op het magische getal,
het bestand is samengesteld uit leden van even lengte die beginnen met een archiefkop en eindigen met
eventueel een opvulteken (om de lengte gelijk te maken). Elk bestandslid is samengesteld
van een koptekst (hieronder gedefinieerd), een optionele "lange bestandsnaam" die eindigt op een nieuwe regel en de
inhoud van het bestand.

De velden van de koptekst worden beschreven in de onderstaande items. Alle velden van de koptekst
bevatten alleen ASCII-tekens, zijn links uitgelijnd en rechts opgevuld met spatie
tekens.

naam - karakter[16]
Dit veld van de kop bevat de naam van het archieflid. Als de naam langer is
dan 15 tekens of bevat een schuine streep (/), dan bevat dit veld #1/nnn
WAAR nnn geeft de lengte van de naam en de #1/ is letterlijk. In dit geval de
de werkelijke naam van het bestand wordt gegeven in het nnn bytes direct na de header.
Als de naam 15 tekens of minder is, staat deze direct in dit veld en
afgesloten met een schuine streep (/).

datum - karakter[12]
Dit veld geeft de wijzigingsdatum van het bestand weer in de vorm van een decimaal
gecodeerd getal dat het aantal seconden sinds het tijdperk aangeeft (sinds 00:00:00 jan.
1, 1970) volgens Posix-specificaties.

uid - char[6]
Dit veld bevat het gebruikers-ID van het bestand, gecodeerd als een decimale ASCII-tekenreeks. Dit
veld misschien niet veel zin op niet-Unix-systemen. Op Unix is ​​het dezelfde waarde als
het st_uid-veld van de stat-structuur geretourneerd door de staat(2) besturingssysteemoproep.

gid - char[6]
Dit veld geeft de groeps-ID van het bestand gecodeerd als een decimale ASCII-tekenreeks. Dit
veld misschien niet veel zin op niet-Unix-systemen. Op Unix is ​​het dezelfde waarde als
het veld st_gid van de stat-structuur geretourneerd door de staat(2) besturingssysteemoproep.

modus - char[8]
Dit veld bevat de toegangsmodus van het bestand dat is gecodeerd als een octale ASCII-tekenreeks. Dit
veld misschien niet veel zin op niet-Unix-systemen. Op Unix is ​​het dezelfde waarde als
het veld st_mode van de stat-structuur geretourneerd door de staat(2) besturingssysteemoproep.

grootte - karakter[10]
Dit veld geeft de grootte van het bestand weer, in bytes, gecodeerd als een decimale ASCII-tekenreeks.

fmag - teken[2]
Dit veld is het magische nummer van het archiefbestandslid. De inhoud is altijd de twee
karakters terugtikken (0x60) en nieuwe regel (0x0A). Dit levert enige mate van nut op
het identificeren van archiefbestanden die beschadigd zijn.

offset - vbr gecodeerd 32-bits geheel getal
Het offset-item levert de offset in het archiefbestand waar het bitcodelid zich bevindt
opgeslagen dat aan het symbool is gekoppeld. De offsetwaarde is 0 gebaseerd op het begin van
het eerste "normale" bestandslid. Om de werkelijke bestandsoffset van het lid af te leiden, moet u
moet het aantal bytes optellen dat wordt ingenomen door de bestandshandtekening (8 bytes) en het symbool
tafels. De waarde van dit item is gecodeerd met behulp van codering met variabele bitsnelheid om te verminderen
de grootte van de symbolentabel. Codering met variabele bitsnelheid gebruikt de hoge bit (0x80) van
elke byte om aan te geven of er nog meer bytes volgen. De resterende 7 bits in elk
byte draagt ​​bits over van de waarde. De laatste byte heeft niet de hoge bit ingesteld.

lengte - vbr gecodeerd 32-bits geheel getal
Het lengte-item geeft de lengte van het volgende symbool. Soortgelijk compenseren item,
de lengte is gecodeerd met variabele bitsnelheid.

symbool - tekenarray
Het symboolitem bevat de tekst van het symbool dat is gekoppeld aan het compenseren. De
symbool wordt door geen enkel teken beëindigd. De lengte wordt bepaald door de lengte veld.
Merk op dat het is toegestaan ​​(maar onverstandig) om niet-afdrukbare tekens (zelfs 0x00) te gebruiken in het
symbool. Dit maakt meerdere coderingen van symboolnamen mogelijk.

EXIT STATUS

If llvm-ar slaagt, wordt afgesloten met 0. Een gebruiksfout resulteert in een afsluitcode van 1. A
harde (typisch bestandssysteem) fout resulteert in een afsluitcode van 2. Diversen of onbekend
fouten resulteren in een afsluitcode van 3.

Gebruik llvm-ar-3.7 online met behulp van onworks.net-services