arposix - En ligne dans le Cloud

PROGRAMME:

Nom

ar — créer et maintenir les archives de la bibliothèque

SYNOPSIS

ar-d [-v] archives filet...

ar-m [-v] archives filet...
ar −m −a [-v] nom pos archives filet...
ar −m −b [-v] nom pos archives filet...
ar −m −je [-v] nom pos archives filet...

ar-p [-v] [-s] archives [filet...]

ar-q [−cv] archives filet...

ar -r [−cuv] archives filet...

ar −r −a [−cuv] nom pos archives filet...
ar −r −b [−cuv] nom pos archives filet...
ar −r −je [−cuv] nom pos archives filet...

ar-t [-v] [-s] archives [filet...]

ar −x [-v] [−sCT] archives [filet...]

DESCRIPTION

Le manuel de formation ar fait partie de l'option Utilitaires de développement logiciel.

Le manuel de formation ar peut être utilisé pour créer et maintenir des groupes de fichiers combinés dans un
archiver. Une fois qu'une archive a été créée, de nouveaux fichiers peuvent être ajoutés et les fichiers existants dans
une archive peut être extraite, supprimée ou remplacée. Lorsqu'une archive se compose entièrement de
fichiers objets valides, la mise en œuvre doit formater l'archive de manière à ce qu'elle soit utilisable comme
bibliothèque pour l'édition de liens (voir c99 et fort77). Lorsque certains des fichiers archivés ne sont pas
fichiers objets valides, l'aptitude de l'archive à être utilisée par la bibliothèque n'est pas définie. Si un
archive se compose entièrement de fichiers imprimables, l'intégralité de l'archive doit être imprimable.

Quand ar crée une archive, il crée des informations administratives indiquant si un
table des mnémoniques est présente dans l'archive. Lorsqu'il existe au moins un fichier objet qui ar
reconnaît comme tel dans l'archive, une table des symboles d'archive doit être créée dans l'archive
et entretenu par ar; il est utilisé par l'éditeur de liens pour rechercher dans l'archive. Chaque fois que le ar
utilitaire est utilisé pour créer ou mettre à jour le contenu d'une telle archive, la table des symboles
doit être reconstruit. le -s L'option forcera la reconstruction de la table des symboles.

Tous filet les opérandes peuvent être des chemins d'accès. Cependant, les fichiers au sein des archives doivent être nommés par un
filename, qui est le dernier composant du chemin d'accès utilisé lors de la saisie du fichier
les archives. La comparaison de filet les opérandes aux noms de fichiers dans les archives doivent être
effectué en comparant le dernier composant de l'opérande au nom du fichier dans le
archiver.

Il n'est pas précisé si plusieurs fichiers de l'archive peuvent porter le même nom. Dans le
cas de tels fichiers, cependant, chaque filet et nom pos l'opérande ne doit correspondre qu'au premier fichier
dans l'archive ayant un nom qui est le même que le dernier composant de l'opérande.

OPTIONS

Le manuel de formation ar l'utilitaire doit être conforme au volume Base Definitions de POSIX.1‐2008, Blog 12.2,
Services Publics Syntaxe Conseils et recommandations, à l'exception de la ligne directrice 9.

Les options suivantes doivent être prises en charge :

-a Positionnez les nouveaux fichiers dans l'archive après le fichier nommé par le nom pos opérande.

-b Positionnez les nouveaux fichiers dans l'archive avant le fichier nommé par le nom pos opérande.

-c Supprimer le message de diagnostic qui est écrit dans l'erreur standard par défaut
quand les archives archives est créé.

-C Empêchez les fichiers extraits de remplacer les fichiers du même nom dans le système de fichiers. Cette
l'option est utile lorsque -T est également utilisé, pour empêcher les noms de fichiers tronqués de
remplacer les fichiers avec le même préfixe.

-d Supprimer un ou plusieurs filets de archives.

-i Positionnez les nouveaux fichiers dans l'archive avant le fichier dans l'archive nommé par le
nom pos opérande (équivalent à -b).

−m Déplacez les fichiers nommés dans l'archive. Les -a, -b, ou -i options avec le nom pos
l'opérande indique la position ; sinon, déplacez les fichiers de noms dans l'archive vers
la fin des archives.

−p Ecrire le contenu du filets dans l'archive nommée par filet opérandes de
archives à la sortie standard. Sinon filet les opérandes sont spécifiés, le contenu
de tous les fichiers de l'archive doit être écrit dans l'ordre de l'archive.

−q Ajoutez les fichiers nommés à la fin de l'archive. Dans ce cas ar ne vérifie pas
si les fichiers ajoutés sont déjà dans l'archive. Ceci est utile pour contourner
la recherche effectuée autrement lors de la création d'une grande archive pièce par pièce.

-r Remplacer ou ajouter filets à archives. Si l'archive nommée par archives ne collecte
exister, une nouvelle archive doit être créée et un message de diagnostic doit être écrit
à l'erreur standard (à moins que le -c option est spécifiée). Sinon filets sont spécifiés
et la archives existe, les résultats ne sont pas définis. Fichiers qui remplacent l'existant
les fichiers de l'archive ne doivent pas changer l'ordre de l'archive. Des fichiers qui font
ne remplace pas les fichiers existants dans l'archive doit être ajouté à l'archive
à moins qu'un -a, -b, ou -i option spécifie une autre position.

-s Forcer la régénération de la table des mnémoniques d'archive même si ar n'est pas invoqué
avec une option qui modifie le contenu de l'archive. Cette option est utile pour
restaurer la table des symboles d'archive après sa suppression ; voir bande.

-t Ecrire une table des matières de archives à la sortie standard. Seuls les fichiers
spécifié par le filet les opérandes doivent être inclus dans la liste écrite. Sinon filet
les opérandes sont spécifiés, tous les fichiers dans archives doit être inclus dans l'ordre de
les archives.

-T Autoriser la troncature des noms de fichiers extraits dont les noms d'archives sont plus longs que
le système de fichiers peut prendre en charge. Par défaut, l'extraction d'un fichier avec un nom qui est
trop long sera une erreur; un message de diagnostic doit être écrit et le fichier
ne doit pas être extrait.

-u Mettez à jour les anciens fichiers dans l'archive. Lorsqu'il est utilisé avec le -r option, fichiers dans le
l'archive n'est remplacée que si l'archive correspondante filet a un temps de modification
c'est au moins aussi nouveau que l'heure de modification du fichier dans l'archive.

-v Donne une sortie verbeuse. Lorsqu'il est utilisé avec les caractères d'option -d, -r, ou -x, écrire un
description détaillée fichier par fichier de la création et de la maintenance de l'archive
activité, comme décrit dans la section STDOUT.

Lorsqu'il est utilisé avec −p, écrivez le nom du fichier dans l'archive au standard
sortie avant d'écrire le fichier dans l'archive elle-même sur la sortie standard, comme
décrit dans la section STDOUT.

Lorsqu'il est utilisé avec -t, incluez une longue liste d'informations sur les fichiers dans le
archive, comme décrit dans la section STDOUT.

-x Extrayez les fichiers dans l'archive nommée par le filet opérandes de archivesL’
le contenu de l'archive ne doit pas être modifié. Sinon filet les opérandes sont donnés, tous
les fichiers de l'archive doivent être extraits. L'heure de modification de chaque fichier
extrait doit être défini au moment où le fichier est extrait de l'archive.

OPÉRANDES

Les opérandes suivants doivent être pris en charge :

archives Un chemin d'accès de l'archive.

filet Un chemin d'accès. Seul le dernier composant doit être utilisé lors de la comparaison avec le
noms de fichiers dans l'archive. Si deux ou plus filet les opérandes ont le même dernier
composant pathname (basename), les résultats ne sont pas spécifiés. La mise en œuvre
le format d'archive ne doit pas tronquer les noms de fichiers valides des fichiers ajoutés ou remplacés
dans les archives.

nom pos Le nom d'un fichier dans l'archive, utilisé pour le positionnement relatif ; voir les options −m
et -r.

STDIN

Non utilisé.

CONTRIBUTION DES DOSSIERS

L'archive nommée par archives doit être un fichier au format créé par ar -r.

ENVIRONNEMENT VARIABLES

Les variables d'environnement suivantes doivent affecter l'exécution de ar:

LANGUE Fournissez une valeur par défaut pour les variables d'internationalisation qui ne sont pas définies ou
nul. (Voir le volume Définitions de base de POSIX.1‐2008, Blog 8.2,
Internationalisation Variables pour la priorité de l'internationalisation
variables utilisées pour déterminer les valeurs des catégories de paramètres régionaux.)

LC_TOUS S'il est défini sur une valeur de chaîne non vide, remplace les valeurs de tous les autres
variables d'internationalisation.

LC_CTYPE Déterminer la localisation pour l'interprétation des séquences d'octets de données de texte
sous forme de caractères (par exemple, des caractères à un octet par opposition aux caractères à plusieurs octets dans
arguments et fichiers d'entrée).

LC_MESSAGES
Déterminez les paramètres régionaux qui doivent être utilisés pour affecter le format et le contenu de
messages de diagnostic écrits dans l'erreur standard.

LC_TIME Déterminer le format et le contenu des chaînes de date et d'heure écrites par ar −télé.

NLSPATH Déterminer l'emplacement des catalogues de messages pour le traitement des LC_MESSAGES.

TMPDIR Déterminez le chemin d'accès qui remplace le répertoire par défaut des fichiers temporaires,
si seulement.

TZ Déterminer le fuseau horaire utilisé pour calculer les chaînes de date et d'heure écrites par ar
−télé. Si TZ est non défini ou nul, un fuseau horaire par défaut non spécifié doit être utilisé.

ASYNCHRONE ÉVÈNEMENTS

Par défaut.

SORTIE STD

Si la -d l'option est utilisée avec le -v option, le format de sortie standard doit être :

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

où filet est l'opérande spécifié sur la ligne de commande.

Si la −p l'option est utilisée avec le -v option, ar doit précéder le contenu de chaque fichier
avec:

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

où filet est l'opérande spécifié sur la ligne de commande, si filet les opérandes ont été spécifiés,
et le nom du fichier dans l'archive s'ils ne l'étaient pas.

Si la -r l'option est utilisée avec le -v option:

* Si filet est déjà dans l'archive, le format de sortie standard doit être :

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

oùfilet> est l'opérande spécifié sur la ligne de commande.

* Si filet n'est pas déjà dans l'archive, le format de sortie standard doit être :

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

oùfilet> est l'opérande spécifié sur la ligne de commande.

Si la -t l'option est utilisée, ar doit écrire les noms des fichiers de l'archive dans le
sortie standard au format :

"%s\n", <filet>

où filet est l'opérande spécifié sur la ligne de commande, si filet les opérandes ont été spécifiés,
ou le nom du fichier dans l'archive s'ils ne l'étaient pas.

Si la -t l'option est utilisée avec le -v option, le format de sortie standard doit être :

"%s %u/%u %u %s %d %d :%d %d %s\n", <membre mode>,utilisateur ID>,
<groupe ID>,nombre of octets in membre>,
<abrégé mois>,jour du mois>,heure>,
<minute>,une année>,filet>

où:

<filet> Doit être l'opérande spécifié sur la ligne de commande, si filet les opérandes étaient
spécifiés, ou le nom du fichier dans l'archive s'ils ne l'étaient pas.

<membre mode>
Doit être formaté de la même manière que lefilet mode> chaîne définie dans le STDOUT
l'article de ls, sauf que le premier caractère, leentrée type>, n'est pas utilisé ;
la chaîne représente le mode de fichier du fichier dans l'archive au moment où il
a été ajouté ou remplacé dans l'archive.

Ce qui suit représente l'heure de la dernière modification d'un fichier lorsqu'il a été le plus récemment
ajouté ou remplacé dans l'archive :

<abrégé mois>
Équivalent au format du %b format de spécification de conversion dans données.

<jour du mois>
Équivalent au format du %e format de spécification de conversion dans données.

<heure> Équivalent au format du %H format de spécification de conversion dans données.

<minute> Équivalent au format du %M format de spécification de conversion dans données.

<une année> Équivalent au format du %Y format de spécification de conversion dans données.

Quand LC_TIME ne spécifie pas la locale POSIX, un format et un ordre différents de
la présentation de ces champs les uns par rapport aux autres peut être utilisée dans un format approprié en
les paramètres régionaux spécifiés.

Si la -x l'option est utilisée avec le -v option, le format de sortie standard doit être :

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

où filet est l'opérande spécifié sur la ligne de commande, si filet les opérandes ont été spécifiés,
ou le nom du fichier dans l'archive s'ils ne l'étaient pas.

STDERR

L'erreur standard ne doit être utilisée que pour les messages de diagnostic. Le message diagnostique
à propos de la création d'une nouvelle archive lorsque -c n'est pas spécifié ne doit pas modifier l'état de sortie.

SORTIE DES DOSSIERS

Les archives sont des fichiers aux formats non spécifiés.

ÉLARGI DESCRIPTION

Aucun.

EXIT STATUT

Les valeurs de sortie suivantes doivent être renvoyées :

0 Achèvement réussi.

>0 Une erreur s'est produite.

CONSÉQUENCES OF LES ERREURS

Par défaut.

Le manuel de formation Abonnement les sections sommes-nous informatif.

INSCRIPTION UTILISATION

Aucun.

EXEMPLES

Aucun.

RAISONNEMENT

Le format d'archive n'est pas décrit. Il est reconnu qu'il existe plusieurs ar
formats qui ne sont pas compatibles. Les ar l'utilitaire est inclus, cependant, pour permettre la création
d'archives destinées à être utilisées sur une seule machine. L'archive est spécifiée comme un
fichier, et il peut être déplacé en tant que fichier. Cela permet de déplacer une archive d'un
machine à une autre machine qui utilise la même implémentation de ar.

Des utilitaires tels que pax (et ses ancêtres goudron et cpio) fournissent également des ``archives'' portables.
Il ne s'agit pas d'une duplication ; les ar l'utilitaire est inclus pour fournir une interface principalement
pour a prendre une et les compilateurs, sur la base d'un modèle historique.

Dans les implémentations historiques, le −q option (disponible sur les systèmes conformes XSI) est
connu pour s'exécuter rapidement car ar ne vérifie pas si les membres ajoutés sont
déjà dans les archives. Ceci est utile pour contourner la recherche effectuée autrement lorsque
créer une grande archive pièce par pièce. Ces remarques peuvent, mais pas nécessairement, rester vraies pour un
toute nouvelle implémentation de cet utilitaire ; par conséquent, ces remarques ont été déplacées dans le
RAISONNEMENT.

Les implémentations BSD nécessitaient historiquement des applications pour fournir les -s option à chaque fois
l'archive était censée contenir une table des symboles. Comme dans ce volume de POSIX.1‐2008,
System V crée ou met à jour historiquement une table de symboles d'archive chaque fois qu'un fichier objet
est supprimé, ajouté ou mis à jour dans l'archive.

La section OPÉRANDES requiert ce qui peut sembler être vrai sans le spécifier : le
l'archive ne peut pas tronquer les noms de fichiers ci-dessous {NAME_MAX}. Quelques implémentations historiques
le faire, cependant, provoquant des résultats inattendus pour l'application. Par conséquent, ce volume de
POSIX.1‐2008 rend l'exigence explicite pour éviter les malentendus.

Selon la documentation System V, les options −dmpqrtx ne sont pas obligés de commencer
avec un ('−'). Ce volume de POSIX.1‐2008 requiert qu'une application conforme
utiliser le leader .

Le format d'archive utilisé par l'implémentation BSD 4.4 est documenté dans cette JUSTIFICATION comme
un exemple:

Un fichier créé par ar commence par la chaîne ``magique'' "! \n". Le reste de la
l'archive est constituée d'objets dont chacun est composé d'un en-tête de fichier, d'un
nom de fichier possible et le contenu du fichier. L'en-tête est portable entre la machine
architectures, et, si le contenu du fichier est imprimable, l'archive est elle-même
imprimable.

L'en-tête est composé de six champs ASCII, suivis d'une bande de fin à deux caractères. Les
les champs sont le nom de l'objet (16 caractères), l'heure de la dernière modification du fichier (12
caractères), les identifiants d'utilisateur et de groupe (chacun 6 caractères), le mode de fichier (8
caractères) et la taille du fichier (10 caractères). Tous les champs numériques sont en décimal,
sauf pour le mode fichier, qui est en octal.

L'heure de modification est le fichier st_mtime domaine. Les identifiants d'utilisateur et de groupe sont les
filet St_uid et st_gid des champs. Le mode fichier est le fichier st_mode champ. Le fichier
la taille est le fichier st_taille champ. La bande-annonce de deux octets est la chaîne "` ".

Seul le champ de nom a une disposition pour le débordement. Si un nom de fichier est supérieur à 16
caractères ou contient un espace incorporé, la chaîne "#1/" suivie par
la longueur ASCII du nom est écrite dans le champ du nom. La taille du fichier (stocké
dans l'en-tête de l'archive) est incrémenté de la longueur du nom. Le nom est alors
écrit immédiatement après l'en-tête de l'archive.

Tous les caractères inutilisés dans l'un de ces champs sont écrits comme personnages. Si
tous les champs sont leur nombre maximum particulier de caractères de longueur, il n'y a pas
séparation entre les champs.

Les objets de l'archive ont toujours un nombre pair d'octets ; des fichiers qui sont un
nombre impair d'octets de long sont complétés par un , bien que la taille dans le
l'en-tête ne reflète pas cela.

Le manuel de formation ar la description de l'utilitaire requiert que (lorsque tous ses membres sont des fichiers objets valides) ar
produire une bibliothèque de code objet, que l'éditeur de liens peut utiliser pour extraire l'objet
modules. Si l'éditeur de liens a besoin d'une table de symboles pour permettre un accès aléatoire au
archiver, ar doit le fournir; cependant, ar ne nécessite pas de table de symboles.

Le BSD -o option a été omise. C'est une application conforme rare qui utilise ar extraire
code objet d'une bibliothèque en se souciant de son heure de modification, car cela ne peut être que
d'importance pour a prendre une. Par conséquent, étant donné que cette fonctionnalité n'est pas considérée comme importante pour
portabilité des applications, l'heure de modification des fichiers extraits est fixée au
heure actuelle.

Il existe au moins une implémentation connue (pour un petit ordinateur) qui peut accueillir
uniquement des fichiers objets pour ce système, interdisant les objets mixtes et d'autres fichiers. La capacité
gérer tout type de fichier n'est pas seulement une pratique historique pour la plupart des implémentations, mais
est également une attente raisonnable.

Il a été envisagé de modifier le format de sortie de ar −télé au même format que le
sortie de ls −l. Cela aurait rendu l'analyse de la sortie de ar le même que celui de ls.
Cela a été rejeté en partie parce que l'actuel ar format est couramment utilisé et les changements
casser l'usage historique. Seconde, ar donne l'ID utilisateur et l'ID de groupe au format numérique
séparés par un . Changer cela pour être le nom d'utilisateur et le nom de groupe ne serait pas
correct si l'archive a été déplacée vers une machine qui contenait une base de données utilisateur différente.
Depuis que ar ne peut pas savoir si l'archive a été générée sur la même machine, il ne peut pas dire
quoi signaler.

Le texte sur le −ur la combinaison d'options est une pratique historique, puisqu'un nom de fichier peut
représenter facilement deux fichiers différents (par exemple, /a/foo et /b/foo), il est raisonnable de
remplacer le fichier dans l'archive même lorsque l'heure de modification dans l'archive est
identique à celui du système de fichiers.

FUTUR DIRECTIONS

Aucun.

Utilisez arposix en ligne en utilisant les services onworks.net