llvm-ar-3.8 - En ligne dans le Cloud

PROGRAMME:

Nom

llvm-ar - archiveur LLVM

SYNOPSIS

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

DESCRIPTION

La llvm-ar La commande est similaire à l'utilitaire Unix commun, ar. Il archive plusieurs fichiers
ensemble dans un seul fichier. L'intention est de produire des bibliothèques d'archives par LLVM
bitcode pouvant être lié à un programme LLVM. Cependant, l'archive peut contenir n'importe quel type
de fichier. Par défaut, llvm-ar génère une table de symboles qui rend la liaison plus rapide car
seule la table des symboles doit être consultée, pas chaque membre du fichier individuel du
archiver.

La llvm-ar la commande peut être utilisée pour lire Fichiers d'archives de style SVR4, GNU et BSD. Cependant,
pour le moment, il ne peut écrire qu'au format GNU. Si une archive de style SVR4 ou BSD est utilisée
les r (remplacer) ou q (mise à jour rapide), l'archive sera reconstruite dans
format GNU.

Voici où llvm-ar s'écarte du précédent ar implémentations :

Symbole lampe de table
Depuis que llvm-ar prend en charge les fichiers bitcode. La table des symboles qu'il crée est au format GNU et
comprend à la fois des fichiers natifs et bitcode.

Location Chemins
Lecture llvm-ar peut lire les noms de fichiers longs GNU et BSD, mais n'écrit que des archives avec
le format GNU.

OPTIONS

Les possibilités de llvm-ar sont compatibles avec d'autres ar implémentations. Cependant, il existe un
quelques modificateurs (R) qui ne se trouvent pas dans d'autres ar implémentations. Les possibilités de llvm-ar
spécifier une seule opération de base à effectuer sur l'archive, une variété de modificateurs pour
cette opération, le nom du fichier d'archive et une liste facultative de noms de fichiers. Ces
les options sont utilisées pour déterminer comment llvm-ar doit traiter le fichier d'archive.

Les opérations et les modificateurs sont expliqués dans les sections ci-dessous. L'ensemble minimal de
options est au moins un opérateur et le nom de l'archive. Généralement, les fichiers d'archive se terminent
avec une .a suffixe, mais ce n'est pas obligatoire. Suivant le nom_archive vient une liste de
fichiers qui indiquent les membres spécifiques de l'archive sur lesquels opérer. Si la fichiers option
n'est pas spécifié, cela signifie généralement "aucun" ou "tous" les membres, selon le
fonctionnement.

Opérations
d
Supprimez les fichiers de l'archive. Aucun modificateur n'est applicable à cette opération. Les
fichiers Les options spécifient quels membres doivent être supprimés de l'archive. Ce n'est pas un
erreur si un fichier spécifié n'apparaît pas dans l'archive. Sinon fichiers sont spécifiés,
l'archive n'est pas modifiée.

m[abi]
Déplacez les fichiers d'un emplacement de l'archive vers un autre. Les a, bet i des modificateurs s'appliquent
à cette opération. Les fichiers seront tous déplacés vers l'emplacement donné par les modificateurs.
Si aucun modificateur n'est utilisé, les fichiers seront déplacés à la fin de l'archive. Sinon
fichiers sont spécifiés, l'archive n'est pas modifiée.

p
Imprimez les fichiers sur la sortie standard. Cette opération imprime simplement le fichiers indiqué à
la sortie standard. Sinon fichiers sont spécifiés, l'archive entière est imprimée.
L'impression de fichiers bitcode est déconseillée car elle peut perturber les paramètres de votre terminal. Les
p L'opération ne modifie jamais l'archive.

q
Ajoutez rapidement des fichiers à la fin de l'archive. Cette opération ajoute rapidement la fichiers
dans l'archive sans rechercher les doublons qui doivent d'abord être supprimés. Sinon
fichiers sont spécifiés, l'archive n'est pas modifiée. À cause de la façon dont llvm-ar
construit le fichier d'archive, il est douteux que le q l'opération est plus rapide que la
r fonctionnement.

r[abou]
Remplacez ou insérez des membres de fichier. Les a, bet u des modificateurs s'appliquent à cette opération.
Cette opération remplacera l'existant fichiers ou les insérer à la fin de l'archive si
Ils n'existent pas. Sinon fichiers sont spécifiés, l'archive n'est pas modifiée.

la télé]
Imprimer la table des matières. Sans aucun modificateur, cette opération imprime simplement le
les noms des membres sur la sortie standard. Avec le v modificateur, llvm-ar imprime aussi
le type de fichier (B=bitcode, S=table de symboles, blanc=fichier normal), le mode d'autorisation,
le propriétaire et le groupe, la taille et la date. Si seulement fichiers sont spécifiés, la liste est
uniquement pour ces fichiers. Sinon fichiers sont spécifiés, la table des matières pour l'ensemble
l'archive est imprimée.

x[oP]
Extrayez les membres de l'archive dans des fichiers. Les o modificateur s'applique à cette opération. Cette
l'opération récupère le fichiers de l'archive et les réécrit dans le
système de fichiers du système d'exploitation. Sinon fichiers sont spécifiés, l'archive entière est
extrait.

Modificateurs (opération spécifique)
Les modificateurs ci-dessous sont spécifiques à certaines opérations. Voir la section Opérations (ci-dessus)
pour déterminer quels modificateurs sont applicables à quelles opérations.

[A]
Lors de l'insertion ou du déplacement de fichiers membres, cette option spécifie la destination du nouveau
fichiers comme étant après le repos membre. Si repos n'est pas trouvé, les fichiers sont placés à
la fin des archives.

[B]
Lors de l'insertion ou du déplacement de fichiers membres, cette option spécifie la destination du nouveau
fichiers comme étant avant le repos membre. Si repos n'est pas trouvé, les fichiers sont placés
à la fin de l'archive. Ce modificateur est identique au i modificateur.

[I]
Un synonyme de la b option.

[ou]
Lors de l'extraction de fichiers, cette option provoquera llvm-ar pour conserver l'original
les heures de modification des fichiers qu'il écrit.

[u]
Lors du remplacement de fichiers existants dans l'archive, ne remplacez que les fichiers qui ont un temps
que l'horodatage du membre dans l'archive.

Modificateurs (générique)
Les modificateurs ci-dessous peuvent être appliqués à n'importe quelle opération.

[C]
Pour toutes les opérations, llvm-ar créera toujours l'archive si elle n'existe pas.
Normalement, llvm-ar imprimera un message d'avertissement indiquant que l'archive est en cours
créé. L'utilisation de ce modificateur désactive cet avertissement.

[s]
Ce modificateur demande qu'un index d'archive (ou une table de symboles) soit ajouté à l'archive.
C'est le mode de fonctionnement par défaut. La table des symboles contiendra tous les
fonctions visibles et variables globales définies par tous les fichiers bitcode de l'archive.

[Oui]
Ce modificateur est l'opposé du s modificateur. Il instruit llvm-ar de ne pas construire le
table des symboles. Si les deux s ainsi que S sont utilisés, le dernier modificateur à apparaître dans les options sera
prévaloir.

[V]
Ce modificateur indique llvm-ar être prolixe sur ce qu'il fait. Chaque édition
l'opération effectuée sur l'archive produira une ligne de sortie indiquant ce qui est en train d'être
terminé.

NORMES

La llvm-ar L'utilitaire est destiné à fournir un sur-ensemble de la norme IEEE Std 1003.2 (POSIX.2)
fonctionnalité pour ar. llvm-ar peut lire les archives SVR4 et BSD4.4 (ou Mac OS X). Si la
f le modificateur est donné au x or r opérations puis llvm-ar écrira compatible SVR4
les archives. Sans ce modificateur, llvm-ar écrira des archives compatibles BSD4.4 qui ont
noms longs immédiatement après l'en-tête et indiqués en utilisant la notation "#1/ddd" pour le
nom dans l'en-tête.

DOSSIER Format

Le format de fichier pour les fichiers d'archive LLVM est similaire à celui de l'archive BSD 4.4 ou Mac OSX
des dossiers. En effet, à l'exception de la table des symboles, le ar commandes sur ces systèmes d'exploitation
devrait être capable de lire les fichiers d'archive LLVM. Les détails du format de fichier suivent.

Chaque archive commence par le numéro magique de l'archive qui correspond aux huit caractères imprimables
"! n" où n représente le caractère de nouvelle ligne (0x0A). Après le nombre magique,
le fichier est composé de membres de longueur paire qui commencent par un en-tête d'archive et se terminent par
un caractère de remplissage si nécessaire (pour rendre la longueur égale). Chaque membre du fichier est composé
d'un en-tête (défini ci-dessous), un "nom de fichier long" facultatif terminé par une nouvelle ligne et le
contenu du fichier.

Les champs de l'en-tête sont décrits dans les éléments ci-dessous. Tous les champs de l'en-tête
ne contiennent que des caractères ASCII, sont justifiés à gauche et sont remplis à droite avec un espace
caractères.

nom - caractère[16]
Ce champ de l'en-tête fournit le nom du membre de l'archive. Si le nom est plus long
plus de 15 caractères ou contient une barre oblique (/), alors ce champ contient #1/nnn
De nnn fournit la longueur du nom et le #1/ est littéral. Dans ce cas, le
le nom réel du fichier est fourni dans le nnn octets suivant immédiatement l'en-tête.
Si le nom est de 15 caractères ou moins, il est contenu directement dans ce champ et
terminé par une barre oblique (/).

date - caractère[12]
Ce champ fournit la date de modification du fichier sous forme de décimale
nombre encodé qui fournit le nombre de secondes depuis l'époque (depuis 00:00:00 Jan
1, 1970) selon les spécifications Posix.

uid - caractère[6]
Ce champ fournit l'ID utilisateur du fichier encodé sous forme de chaîne ASCII décimale. Cette
peut ne pas avoir beaucoup de sens sur les systèmes non Unix. Sous Unix, c'est la même valeur que
le champ st_uid de la structure stat renvoyé par le état(2) appel du système d'exploitation.

gid - char[6]
Ce champ fournit l'identifiant de groupe du fichier encodé sous forme de chaîne ASCII décimale. Cette
peut ne pas avoir beaucoup de sens sur les systèmes non Unix. Sous Unix, c'est la même valeur que
le champ st_gid de la structure stat renvoyé par le état(2) appel du système d'exploitation.

mode - caractère[8]
Ce champ fournit le mode d'accès du fichier encodé sous forme de chaîne ASCII octale. Cette
peut ne pas avoir beaucoup de sens sur les systèmes non Unix. Sous Unix, c'est la même valeur que
le champ st_mode de la structure stat renvoyé par le état(2) appel du système d'exploitation.

taille - caractère[10]
Ce champ fournit la taille du fichier, en octets, codée sous forme de chaîne ASCII décimale.

fmag - car[2]
Ce champ est le numéro magique du membre du fichier archive. Son contenu est toujours les deux
caractères back tick (0x60) et nouvelle ligne (0x0A). Cela fournit une certaine utilité de mesure dans
identifier les fichiers d'archives qui ont été corrompus.

offset - entier 32 bits codé en vbr
L'élément de décalage fournit le décalage dans le fichier d'archive où le membre bitcode est
stocké qui est associé au symbole. La valeur de décalage est 0 basée sur le début de
le premier membre du fichier "normal". Pour dériver le décalage de fichier réel du membre, vous
il faut additionner le nombre d'octets occupés par la signature du fichier (8 octets) et le symbole
les tables. La valeur de cet élément est codée à l'aide d'un codage à débit binaire variable pour réduire
la taille de la table des symboles. Le codage à débit binaire variable utilise le bit élevé (0x80) de
chaque octet pour indiquer s'il y a d'autres octets à suivre. Les 7 bits restants dans chaque
l'octet transporte les bits de la valeur. L'octet final n'a pas le bit de poids fort défini.

longueur - entier 32 bits codé en vbr
L'élément de longueur fournit la longueur du symbole qui suit. Comme ça compenser article,
la longueur est codée à débit binaire variable.

symbole - tableau de caractères
L'élément symbole fournit le texte du symbole associé au compenserL’
le symbole ne se termine par aucun caractère. Sa longueur est fournie par le longueur champ.
Notez qu'il est permis (mais imprudent) d'utiliser des caractères non imprimables (même 0x00) dans le
symbole. Cela permet plusieurs encodages de noms de symboles.

EXIT STATUT

If llvm-ar réussit, il se terminera avec 0. Une erreur d'utilisation entraîne un code de sortie de 1. A
une erreur matérielle (généralement du système de fichiers) entraîne un code de sortie de 2. Divers ou inconnu
les erreurs entraînent un code de sortie de 3.

Utilisez llvm-ar-3.8 en ligne en utilisant les services onworks.net