Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	.de Sh " Subsection heading [b][/b] .if t .Sp .ne 5 [b][/b]$1 [size=18] [b]Nom[/b] [/size] ar - Créer, modifier et extraire des archives. [size=18] [b]Résumé[/b] [/size] .IX Header "SYNOPSIS" ar [[b][/b]-X32_64] [[b]-[/b]][i]p[/i][[i]mod[/i] [[i]posrel[/i]] [[i]numéro[/i]]] [i]archive[/i] [[i]membre[/i]...] [size=18] [b]Description[/b] [/size] .IX Header "DESCRIPTION" Le programme s-1GNUs0 [b]ar[/b] crée, modifie et extrait des fichiers à partir d'archives. Une [i]archive[/i] est un fichier unique contenant une collection d'autres fichiers dans une structure qui permet de retrouver les fichiers originaux individuels (appelés [i]membres[/i] de l'archive). Le contenu, le mode (permissions), l'horodate, le propriétaire et le groupe des fichiers originaux sont préservés dans l'archive, et peuvent être reconstitués lors de l'extraction. &s-1GNUs0 [b]ar[/b] peut gérer des archives dont les membres ont des noms de n'importe quelle longueur ; néanmoins, en fonction de la configuration de [b]ar[/b] sur votre système, une limite sur la longueur des noms des membres peut être imposée pour assurer la compatibilité avec les formats d'archive maintenus par d'autres outils. Si elle existe, la limite est souvent de 15 caractères (typique des formats liés au a.out), ou de 16 caractères (typique des formats liés à coff). &[b]ar[/b] est considéré être un utilitaire binaire car les archives de ce type sont le plus souvent comme [i]bibliothèques[/i] contenant des sous-routines fréquemment utilisées. &[b]ar[/b] crée un index des symboles définis dans les modules objets relogeables de l'archive quand vous spécifiez le modificateur [b]s[/b]. Une fois créé, cet index est mis à jour dans l'archive à chaque fois que [b]ar[/b] modifie son contenu (sauf dans le cas de l'opération de mise à jour [b]q[/b]). Une archive disposant d'un tel index accélère l'édition des liens avec la bibliothèque, et permet aux routines de cette dernière de s'appeler mutuellement quels que soient leurs emplacements respectifs dans l'archive. Vous pouvez utiliser [b]nm[/b] -s ou [b]nm[/b] --print-armap pour lister cette table d'index. Si l'archive n'en possède pas, une autre forme de [b]ar[/b] appelée [b]ranlib[/b] peut être utilisée pour n'ajouter que la table. &s-1GNUs0 [b]ar[/b] est conçu pour être compatible avec deux mécanismes différents. Vous pouvez contrôler son activité en utilisant des options de ligne de commandes, comme les différentes variantes de [b]ar[/b] sur les systèmes Unix ; si vous spécifiez [b][/b]-M comme unique option sur la ligne de commandes, vous pouvez le contrôler grâce à un script fourni via l'entrée standard, à la manière du programme s-1MRIs0 « librarian ». [size=18] [b]Options[/b] [/size] .IX Header "OPTIONS" &s-1GNUs0 [b]ar[/b] vous permet de mélanger le code d'opération [i]p[/i] et les drapeaux modificateurs [i]mod[/i] dans n'importe quel ordre, à l'intérieur du premier argument de la ligne de commandes. Si vous le souhaitez, vous pouvez faire débuter le premier argument de la ligne de commandes par un tiret. La lettre [i]p[/i] spécifie l'opération à exécuter ; elle peut être n'importe laquelle des lettres suivantes, mais vous ne pouvez en spécifier qu'une seule : "[b]d[/b]" 4 [table][row][col]    [/col][col].IX Item "d" &[i]Supprimer[/i] (delete) des modules de l'archive. Spécifiez le nom des modules à effacer en tant que [i]membre[/i]... ; l'archive n'est pas modifiée si vous n'indiquez aucun fichier à effacer. .Sp Si vous spécifiez le modificateur [b]v[/b], [b]ar[/b] listera chaque module lors de sa suppression.[/col][/row][/table] "[b]m[/b]" 4 [table][row][col]    [/col][col].IX Item "m" Utilisez cette opération pour [i]déplacer[/i] (move) des membres dans une archive. .Sp L'ordre des membres dans une archive peut influencer la façon dont les programmes sont liés en utilisant la bibliothèque, si un symbole est défini dans plus d'un membre. .Sp Si aucun modificateur n'est utilisé avec « m », tous les membres nommés dans les arguments [i]membre[/i] sont déplacés à la [i]fin[/i] de l'archive ; vous pouvez utiliser les modificateurs [b]a[/b], [b]b[/b] ou [b]i[/b] pour les déplacer à un autre endroit (que vous spécifiez).[/col][/row][/table] "[b]p[/b]" 4 [table][row][col]    [/col][col].IX Item "p" &[i]Afficher[/i] (print) les membres spécifiés de l'archive sur la sortie standard. Si le modificateur [b]v[/b] est utilisé, afficher le nom du membre avant de copier son contenu sur la sortie standard. .Sp Si vous ne spécifiez aucun argument [i]membre[/i], tous les fichiers de l'archive seront affichés.[/col][/row][/table] "[b]q[/b]" 4 [table][row][col]    [/col][col].IX Item "q" &[i]Concaténation[/i] rapide (quick append) ; historiquement, ajouter les fichiers [i]membre[/i]... à la fin de l'[i]archive[/i], sans se soucier des remplacements. .Sp Les modificateurs [b]a[/b], [b]b[/b] et [b]i[/b] n'affectent [i]pas[/i] cette opération ; les nouveaux membres sont toujours placés à la fin de l'archive. .Sp Le modificateur [b]v[/b] fait lister par [b]ar[/b] chaque fichier pendant son ajout. .Sp Puisque le but de cette opération est la vitesse, l'index de la table des symboles de l'archive n'est pas mis à jour, même s'il existait déjà ; vous pouvez utiliser explicitement [b]ar[/b] s ou [b]ranlib[/b] pour mettre à jour l'index de la table des symboles. .Sp Néanmoins, de trop nombreux systèmes différents supposent que la concaténation rapide reconstruit l'index, et s-1GNUs0 ar implémente donc « q » comme un synonyme de « r ».[/col][/row][/table] "[b]r[/b]" 4 [table][row][col]    [/col][col].IX Item "r" Insérer les fichiers [i]membre[/i]... dans l'[i]archive[/i] (avec [i]remplacement[/i]). Cette opération diffère de [b]q[/b] dans le sens où tous les membres existants au préalable sont supprimés si leur nom correspond à l'un de ceux que l'on ajoute. .Sp Si l'un des fichiers nommés dans [i]membre[/i]... n'existe pas, [b]ar[/b] affiche un message d'erreur, et laisse inchangé tout membre existant de l'archive qui porte ce nom. .Sp Par défaut, les nouveaux membres sont ajoutés à la fin du fichier, mais vous pouvez utiliser un des modificateurs [b]a[/b], [b]b[/b] ou [b]i[/b] pour demander le placement relatif à un membre existant. .Sp Le modificateur [b]v[/b] utilisé avec cette opération affiche une ligne de sortie pour chaque fichier inséré, ainsi que l'une des lettres [b]a[/b] ou [b]r[/b] pour indiquer si le fichier a été concaténé (aucun ancien membre effacé) ou remplacé.[/col][/row][/table] "[b]t[/b]" 4 [table][row][col]    [/col][col].IX Item "t" Afficher une [i]table[/i] listant le contenu de l'[i]archive[/i], ou celui des fichiers présents à la fois dans [i]membre[/i]... et dans l'archive. Normalement, seul le nom du membre est montré ; si vous voulez également voir le mode (permissions), l'horodate, le propriétaire, le groupe et la taille, vous pouvez le requérir en spécifiant également le modificateur [b]v[/b]. .Sp Si vous ne précisez pas de [i]membre[/i], tous les fichiers de l'archive seront listés. .Sp S'il y a plus d'un fichier de même nom (disons [b]fie[/b]) dans une archive (disons [b]b.a[/b]), [b]ar[/b] t b.a fie listera uniquement la première instance ; pour les voir toutes, vous devez demander un listing complet -- dans notre exemple, [b]ar[/b] t b.a.[/col][/row][/table] "[b]x[/b]" 4 [table][row][col]    [/col][col].IX Item "x" &[i]Extraire[/i] des membres (nommés [i]membre[/i]...) de l'archive. Vous pouvez utiliser le modificateur [b]v[/b] avec cette opération, pour demander à [b]ar[/b] de lister chaque nom durant son extraction. .Sp Si vous ne mentionnez aucun [i]membre[/i], tous les fichiers de l'archive seront extraits.[/col][/row][/table] Quelques modificateurs ([i]mod[/i]) peuvent suivre immédiatement la lettre [i]p[/i] pour modifier le comportement d'une opération : "[b]a[/b]" 4 [table][row][col]    [/col][col].IX Item "a" Ajouter les nouveaux fichiers [i]après[/i] un membre existant dans l'archive. Si vous utilisez le modificateur [b]a[/b], le nom d'un membre existant dans l'archive doit être présent comme argument [i]posrel[/i] (position relative) avant la spécification de l'[i]archive[/i].[/col][/row][/table] "[b]b[/b]" 4 [table][row][col]    [/col][col].IX Item "b" Ajouter les nouveaux fichiers [i]avant[/i] un membre existant dans l'archive. Si vous utilisez le modificateur [b]b[/b], le nom d'un membre existant dans l'archive doit être présent comme argument [i]posrel[/i] avant la spécification de l'[i]archive[/i] (comme pour [b]i[/b]).[/col][/row][/table] "[b]c[/b]" 4 [table][row][col]    [/col][col].IX Item "c" &[i]Créer[/i] l'archive. L'[i]archive[/i] spécifiée est toujours créée si elle n'existait pas, quand vous demandez une mise à jour. Mais un avertissement est émis à moins que vous ne spécifiiez à l'avance que vous voulez la créer, en utilisant ce modificateur.[/col][/row][/table] "[b]f[/b]" 4 [table][row][col]    [/col][col].IX Item "f" Tronquer les noms dans l'archive. s-1GNUs0 [b]ar[/b] autorise normalement des noms de fichiers de longueur quelconque, ce qui crée des archives qui ne sont pas compatibles avec le programme [b]ar[/b] natif sur certains systèmes. Si cela pose un problème, le modificateur [b]f[/b] peut être utilisé pour tronquer les noms de fichiers lors de leur insertion dans l'archive.[/col][/row][/table] "[b]i[/b]" 4 [table][row][col]    [/col][col].IX Item "i" Insérer les nouveaux fichiers [i]avant[/i] tout membre existant dans l'archive. Si vous utilisez le modificateur [b]i[/b], le nom d'un membre existant de l'archive doit être présent comme argument [i]posrel[/i] avant la spécification de l'[i]archive[/i] (comme pour [b]b[/b]).[/col][/row][/table] "[b]l[/b]" 4 [table][row][col]    [/col][col].IX Item "l" Ce modificateur est accepté mais n'est pas utilisé.[/col][/row][/table] "[b]N[/b]" 4 [table][row][col]    [/col][col].IX Item "N" Utiliser le paramètre [i]numéro[/i]. C'est utilisé s'il y a plusieurs entrées dans l'archive portant le même nom. Extrait ou supprime la [i]numéro[/i]-ième instance du nom donné dans l'archive.[/col][/row][/table] "[b]o[/b]" 4 [table][row][col]    [/col][col].IX Item "o" Préserver les dates [i]originales[/i] des membres lors de leur extraction. Si vous ne spécifiez pas ce modificateur, les fichiers extraits de l'archive seront horodatés avec l'heure de l'extraction.[/col][/row][/table] "[b]P[/b]" 4 [table][row][col]    [/col][col].IX Item "P" Utiliser le nom du chemin complet lors de la reconnaissance des noms de l'archive. s-1GNUs0 [b]ar[/b] ne peut pas créer d'archive ayant un nom de chemin complet (de telles archives ne suivent pas la norme s-1POSIXs0), mais d'autres créateurs d'archives le peuvent. Cette option dit à s-1GNUs0 [b]ar[/b] de reconnaître les noms de fichiers en utilisant un nom de chemin complet, ce qui peut être pratique lors de l'extraction d'un seul fichier d'une archive créée par un autre outil.[/col][/row][/table] "[b]s[/b]" 4 [table][row][col]    [/col][col].IX Item "s" Écrire un index des fichiers objets dans l'archive, ou en mettre à jour un existant, même si l'archive n'a subi aucune autre modification. Vous pouvez utiliser ce drapeau modificateur avec n'importe quelle opération, ou bien tout seul. Lancer [b]ar[/b] s sur une archive est équivalent à exécuter [b]ranlib[/b] dessus.[/col][/row][/table] "[b]S[/b]" 4 [table][row][col]    [/col][col].IX Item "S" Ne pas générer de table des symboles de l'archive. Cela peut fortement accélérer la construction d'une grande bibliothèque. L'archive résultante ne peut pas être utilisée par l'éditeur de liens. Pour construire une table des symboles, vous devez omettre le modificateur [b]S[/b] lors de la dernière exécution de [b]ar[/b], ou lancer [b]ranlib[/b] sur l'archive.[/col][/row][/table] "[b]u[/b]" 4 [table][row][col]    [/col][col].IX Item "u" Normalement, [b]ar[/b] r... insère tous les fichiers listés dans l'archive. Si vous ne voulez insérer [i]que[/i] les fichiers listés qui sont plus récents que les membres existants de même nom, utilisez ce modificateur. Le modificateur [b]u[/b] n'est autorisé que pour l'opération [b]r[/b] (remplacer). En particulier, la combinaison [b]qu[/b] n'est pas autorisée, puisque la vérification des horodates ferait perdre l'avantage de vitesse procuré par l'opération [b]q[/b].[/col][/row][/table] "[b]v[/b]" 4 [table][row][col]    [/col][col].IX Item "v" Ce modificateur requiert la version [i]verbeuse[/i] (bavarde) d'une opération. Beaucoup d'opérations affichent des informations additionnelles, comme le nom des fichiers traités, quand le modificateur [b]v[/b] est ajouté.[/col][/row][/table] "[b]V[/b]" 4 [table][row][col]    [/col][col].IX Item "V" Ce modificateur affiche le numéro de version de [b]ar[/b].[/col][/row][/table] &[b]ar[/b] ignore une option originelle orthographiée [b][/b]-X32_64, pour la compatibilité avec s-1AIXs0. Le comportement généré par cette option est celui utilisé par défaut par s-1GNUs0 [b]ar[/b]. [b]ar[/b] ne prend en charge aucune des autres options [b][/b]-X ; en particulier, il ne prend pas en charge l'option [b][/b]-X32 qui est utilisée par défaut par le [b]ar[/b] s-1AIXs0. [size=18] [b]Voir aussi[/b] [/size] .IX Header "SEE ALSO" &[i]nm[/i](1), [i]ranlib[/i](1), et les entrées Info pour [i]binutils[/i]. [size=18] [b]Copyright[/b] [/size] .IX Header "COPYRIGHT" Copyright (c) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001, 2002 Free Software Foundation, Inc. L'autorisation est donnée de copier, de distribuer et/ou de modifier ce document sous les termes de la s-1GNUs0 Free Documentation License version 1.1 ou toute autre version ultérieure publiée par la Free Software Foundation, sans section invariante ni texte de couverture ni texte de quatrième de couverture. Une copie de la licence est incluse dans la section intitulée « GNU Free Documentation License ». [size=18] [b]Traduction[/b] [/size] Frédéric Delanoy <[i]delanoy_f[/i] at yahoo.com>, 2002.
Fichier