LIB

Syntaxe 1

Syntaxe 2

Paramètres

Syntaxe 3

Paramètres

Description

Cette commande permet de lancer le gestionnaire de bibliothèque MS-LIB.

Remarque

• Cette page suppose que l'utilisateur est familiarisé avec la programmation en langage assembleur et avec le fonctionnement des registres et des instructions 8086 et 8088. L'utilisateur doit également connaître la définition des termes du micro-ordinateur tels que : bit, octet, drapeau et registre.

Objectif

Le LIB est un utilitaire MS-DOS vous permettant de supprimer des modules d'un fichier de bibliothèque, de transformer des modules de bibliothèque en fichiers objets et d'ajouter des fichiers objets à un fichier de bibliothèque.

Concepts préliminaires

Le LIB crée et modifie les fichiers de bibliothèque utilisés avec l'utilitaire LINK de Microsoft. LIB peut ajouter des fichiers objets à une bibliothèque, supprimer des modules d'une bibliothèque ou extraire des modules d'une bibliothèque et placer les modules extraits dans des fichiers objets distincts.

LIB fournit un moyen de créer des bibliothèques générales ou spéciales pour une variété de programmes ou pour des programmes spécifiques uniquement. Avec LIB, vous pouvez créer une bibliothèque pour un compilateur, ou vous pouvez créer une bibliothèque pour un seul programme - ce qui permettrait une liaison très rapide.

Vous pouvez modifier des modules individuels au sein d'une bibliothèque en extrayant les modules, en apportant des modifications, puis en ajoutant à nouveau les modules à la bibliothèque. Vous pouvez également remplacer un module existant par un module différent ou par une nouvelle version d'un module existant.

Le balayage de commandes dans LIB est le même que celui utilisé dans Microsoft LINK, Microsoft PASCAL, Microsoft FORTRAN et d'autres produits Microsoft 16 bits. Si vous avez utilisé l'un de ces produits, l'utilisation de LIB vous sera familière. Les formulaires de saisie LIB sont simples et LIB vous demande toutes les spécifications dont il a besoin et que vous n'avez pas fournies.

Présentation du fonctionnement de LIB

LIB effectue trois actions de base : il supprime les modules d'un fichier de bibliothèque, il transforme les fichiers d'objet en modules et les ajoute à un fichier de bibliothèque, et il extrait les modules pour créer un fichier d'objet. Ces trois actions sont à la base de cinq fonctions de gestion de bibliothèque :

• Supprimer un module.
• Extrayez un module et placez-le dans un fichier objet séparé.
• Ajouter un fichier objet en tant que module d'une bibliothèque.
• Remplacer un module dans le fichier de bibliothèque par un nouveau module.
• Créer un fichier bibliothèque.

Au cours de chaque session de bibliothèque, LIB supprime ou extrait d'abord des modules, puis en ajoute de nouveaux. En une seule opération, LIB lit chaque module en mémoire, en vérifie la cohérence et le réécrit dans le fichier :

Dans cette figure, et les quatre figures suivantes, les lettres majuscules représentent les modules. Si vous supprimez un module, LIB lit ce module mais ne le réécrit pas dans le fichier :

Lorsque LIB réécrit le module suivant à retenir, elle place le module à la fin du dernier module écrit. Cette procédure "ferme" efficacement l'espace disque pour empêcher le fichier de bibliothèque de devenir plus volumineux que nécessaire :

Lorsque LIB a parcouru tout le fichier de bibliothèque, il ajoute tout nouveau module à la fin du fichier. LIB peut alors copier ce module dans un fichier objet :

Enfin, LIB crée l'index, que la commande LINK utilise pour rechercher des modules et des symboles dans le fichier de bibliothèque, et génère une liste de références croisées des symboles PUBLIC dans la bibliothèque, si vous demandez une telle liste :

(La construction de l'index de la bibliothèque peut prendre un peu plus de temps, jusqu'à 20 secondes dans certains cas).

Par exemple, lorsque vous tapez :

le module de bibliothèque HEAP est supprimé du fichier de bibliothèque et le fichier HEAP.OBJ est ajouté en tant que dernier module de la bibliothèque. Cet ordre d'exécution évite toute confusion dans LIB lorsqu'une nouvelle version d'un module remplace une version dans le fichier de bibliothèque. Notez que la fonction de remplacement est simplement les fonctions de suppression et d'ajout successives. Notez également que vous pouvez spécifier des fonctions de suppression, d'ajout ou d'extraction dans n'importe quel ordre ; l'ordre est insignifiant pour le balayage de commande LIB.

Exécution de LIB

L'exécution de LIB nécessite deux types d'entrées : la commande pour appeler LIB et les réponses aux prompts de commande LIB. Habituellement, vous saisirez toutes les réponses aux prompts LIB sur le clavier du terminal. Les réponses peuvent également être contenues dans un fichier de réponses. Un fichier de réponses est un fichier contenant des réponses aux prompts de commande LIB. LIB reconnaît six caractères de commande («+», «-», «*», «;», «&» et CTRL+BREAK). Certains sont utilisés comme partie requise des commandes LIB, et les autres vous aident à saisir les commandes LIB.

Appel de LIB

Le LIB peut être appelé par trois méthodes. Par la première méthode, la méthode de prompt de commande, vous entrez des réponses aux prompts individuelles. Par la deuxième méthode, la méthode de ligne de commande, vous entrez toutes les réponses sur la ligne utilisée pour appeler LIB. Par la troisième méthode, la méthode du fichier de réponses, vous spécifiez un fichier de réponses contenant toutes les réponses nécessaires. Ce fichier de réponses doit exister avant que vous n'entriez la commande LIB.

Méthode de prompt de commande

Pour commencer avec la méthode de prompt de commande, tapez la commande suivante au prompt système :

et appuyez sur la touche RETURN. LIB se charge en mémoire. Ensuite, LIB renvoie une série de trois prompts textuelles apparaissant une par une. Vous répondez aux prompts pour effectuer des tâches spécifiques.

Les résumés des prompts de commande LIB et des caractères de commande suivent. Pour une description complète, reportez-vous aux sections de prompt de commande et de caractère de commande plus loin dans cette page.

Résumé des prompts de commande LIB :

Résumé des caractères de commande :

Méthode de la ligne de commande

La méthode de la ligne de commande vous permet d'entrer toutes les spécifications d'une opération LIB dans une seule ligne de commande.

Pour commencer avec la méthode de la ligne de commande, tapez la ligne de commande suivante au prompt système :

Les entrées suivant LIB sont des réponses aux prompts de commande. Les champs de bibliothèque et d'opérations et toutes les entrées d'opérations doivent être séparés par l'un des caractères de commande - plus, moins et astérisque (+, -, *). Si une liste de références croisées est souhaitée, le nom du fichier doit être séparé de la dernière entrée d'opérations par une virgule.

library représente le nom d'un fichier de bibliothèque. LIB suppose que l'extension du nom de fichier est .LIB, que vous pouvez remplacer en spécifiant une extension différente. Vous pouvez également spécifier un nom de l'unité de disque et/ou un nom de chemin. Si le nom de fichier donné pour le champ bibliothèque n'existe pas, LIB vous demandera :

Entrez soit Yes (pour créer un nouveau fichier de bibliothèque) soit No (pour abandonner la session de bibliothèque) et appuyez sur RETURN. En fait, LIB vérifie la réponse pour la lettre Y comme premier caractère. Si N est la première lettre, LIB se termine et retourne au système d'exploitation.

operations incluent la suppression d'un module, l'ajout d'un fichier objet en tant que module ou l'extraction d'un module en tant que fichier objet à partir du fichier de bibliothèque. Utilisez les trois caractères de commande plus (+), moins (-) et astérisque (*) pour indiquer à LIB quelle action entreprendre avec chaque module ou fichier objet. Vous pouvez spécifier un nom de l'unité de disque et/ou un nom de chemin avec chaque module ou fichier objet.

listing représente le nom du fichier pour lequel vous souhaitez recevoir la liste de références croisées des symboles PUBLIC dans les modules de la bibliothèque. La liste est compilée après que toutes les manipulations de modules ont eu lieu.

Pour sélectionner la valeur par défaut pour les champs restants, vous pouvez entrer le caractère de commande point-virgule (;).

Si vous entrez un nom de fichier de bibliothèque suivi immédiatement d'un point-virgule, LIB lira le fichier de bibliothèque et effectuera un contrôle de cohérence. Aurcune modification ne sera apportée aux modules dans le fichier de bibliothèque.

Si vous entrez un nom de fichier de bibliothèque suivi immédiatement d'une virgule et d'un nom de fichier de liste, LIB effectuera sa vérification de cohérence du fichier de bibliothèque, puis produira le fichier de liste de références croisées.

Si vous avez de nombreuses opérations à effectuer au cours d'une session de bibliothèque, utilisez le caractère de commande esperluette (&) pour étendre la ligne afin de pouvoir entrer des noms de fichiers d'objets et des noms de modules supplémentaires. Veillez à toujours inclure l'un des caractères de commande pour les opérations (+, -, *) avant le nom de chaque module ou nom de fichier objet.

Exemples

Pour supprimer le module HEAP du fichier bibliothèque PASCAL.LIB et ajouter le fichier objet HEAP.OBJ, vous devez saisir :

et appuyez sur RETURN. LIB supprime le module HEAP du fichier bibliothèque PASCAL.LIB et ajoute le fichier objet HEAP.OBJ comme dernier module de PASCAL.LIB (le module sera nommé HEAP). Le point-virgule indique que LIB doit utiliser la réponse par défaut pour les prompts restantes.

Pour effectuer un contrôle de cohérence du fichier bibliothèque PASCAL.LIB, vous saisirez :

et appuyez sur RETURN. LIB effectue un contrôle de cohérence. Aucune autre action n'est effectuée.

Pour effectuer un contrôle de cohérence et générer une liste de références croisées, vous pouvez saisir :

LIB effectue une vérification de cohérence de PASCAL.LIB et génère un fichier de liste de références croisées nommé PASCROSS.PUB.

Méthode du fichier de réponse

La méthode du fichier de réponse permet de saisir toutes les spécifications d'une opération LIB dans un seul fichier.

Pour commencer avec la méthode du fichier de réponses, saisissez la ligne de commande suivante au prompt système :

@ est un pointeur indiquant à LIB que toutes les réponses aux prompts sont contenues dans le fichier dont le nom suit.

filespec représente le nom d'un fichier de réponses avec un nom de l'unité de disque et un nom de chemin facultatifs. Un fichier de réponses contient des réponses aux prompts LIB (résumées sous Méthode de prompt de commande et décrites en détail dans la section de prompt de commande). La méthode du fichier de réponses vous permet de mener la session LIB sans réponses interactives (directes) de l'utilisateur aux prompts LIB.

Remarque : Avant d'utiliser la méthode du fichier de réponse pour démarrer LIB, vous devez d'abord créer le fichier de réponse. Vous pouvez créer un fichier de réponses à l'aide d'EDLIN, de l'éditeur MS-DOS, de la commande COPY ou d'un éditeur de texte.

Un fichier de réponses se compose de fichiers texte, un pour chaque prompt. Les réponses doivent apparaître dans le même ordre que les prompts de commande.

Les caractères de commande sont utilisés dans un fichier de réponse de la même manière qu'ils sont utilisés pour répondre aux prompts sur le clavier du terminal.

Lorsque la session de bibliothèque démarre, chaque prompt s'affiche à son tour avec les réponses du fichier de réponses. Si le fichier de réponses ne contient pas de réponses pour toutes les prompts, LIB utilisera les réponses par défaut. (Réponses par défaut - aucune modification des modules actuellement dans le fichier de bibliothèque pour le prompt «Operations:», et aucun fichier de liste de références croisées créé pour le prompt List file:.)

Si vous entrez un nom de fichier de bibliothèque suivi immédiatement d'un point-virgule, LIB lira le fichier de bibliothèque et effectuera un contrôle de cohérence. Aucune modification ne sera apportée aux modules dans le fichier de bibliothèque.

Si vous saisissez un nom de fichier de bibliothèque et appuyez sur RETURN, puis une virgule et appuyez sur RETURN, et enfin, un nom de fichier de liste et appuyez sur RETURN :

LIB effectue sa vérification de cohérence du fichier de bibliothèque et produit le fichier de liste de références croisées.

Pour créer un fichier de réponse supprimant un module, extrait un module et le place dans un fichier objet, puis ajoute ce fichier objet, vous pouvez saisir :

et appuyez sur RETURN à la fin de chaque ligne. Ce fichier de réponses force LIB à supprimer le module HEAP du fichier de bibliothèque PASCAL.LIB. LIB extrait le module FOIBLES et le place dans un fichier objet nommé FOIBLES.OBJ. LIB ajoute ensuite les fichiers objets CURSOR.OBJ et HEAP.OBJ comme les deux derniers modules de la bibliothèque. Ensuite, LIB créera un fichier de références croisées nommé CROSSLST.

Prompts de commande

LIB est activé en saisissant les réponses à trois prompts textuelles. Lorsque vous avez entré votre réponse au prompt actuelle, la suivante s'affiche. Lorsque le dernier prompt a été répondue, LIB exécute ses fonctions de gestion de bibliothèque. Lorsque la session de bibliothèque est terminée, LIB quitte le système d'exploitation. Lorsque le prompt du système d'exploitation s'affiche, LIB a terminé la session de bibliothèque avec succès. Si la session de bibliothèque échoue, LIB renvoie le message d'erreur approprié. (Les messages d'erreur sont expliqués à la fin de cette section.)

LIB demande le nom du fichier de bibliothèque, la ou les opérations que vous souhaitez effectuer et le nom que vous souhaitez donner à un fichier de liste de références croisées, le cas échéant.

LibraryFile:

Entrez le nom du fichier de bibliothèque (avec le nom de l'unité de disque et le nom de chemin facultatifs) que vous souhaitez manipuler. LIB suppose que l'extension du nom de fichier est «.LIB». Vous pouvez remplacer celui-ci en donnant une extension de nom de fichier lorsque vous entrez le nom du fichier de bibliothèque. Étant donné que LIB ne peut gérer qu'un seul fichier de bibliothèque à la fois, un seul nom de fichier est autorisé en réponse au prompt. Les réponses supplémentaires, à l'exception du caractère de commande point-virgule, sont ignorées.

Si vous entrez un nom de fichier de bibliothèque et que vous le faites suivre immédiatement d'un caractère de commande point-virgule, LIB effectuera uniquement une vérification de cohérence, puis reviendra au système d'exploitation. Toute erreur dans le fichier sera signalée.

Si le nom de fichier que vous saisissez n'existe pas, LIB renvoie le prompt :

Vous devez saisir Yes ou No et appuyer sur RETURN. En fait, LIB vérifie la réponse pour la lettre Y comme premier caractère. Si N est la première lettre, LIB se termine et retourne au système d'exploitation.

Operations:

Entrez l'un des trois caractères de commande pour manipuler les modules (+, -, *), suivi immédiatement (sans espace) du nom du module ou du nom du fichier objet (avec éventuellement le nom du l'unité de disque et le nom du chemin). Le signe plus ajoute un fichier objet en tant que dernier module dans le fichier de bibliothèque (pour plus de détails, reportez-vous à la description du signe plus dans la section des caractères de commande). Le signe moins supprime un module du fichier de bibliothèque. L'astérisque extrait un module de la bibliothèque et le place dans un fichier objet séparé avec le nom de fichier tiré du nom du module et de l'extension de nom de fichier .OBJ.

Lorsque vous avez un grand nombre de modules à manipuler (plus qu'il n'est possible de taper sur une seule ligne), entrez une esperluette (&) comme dernier caractère sur la ligne. LIB répétera le prompt Operations:, ce qui vous permet d'entrer des noms de modules et des noms de fichiers d'objets supplémentaires.

LIB vous permet d'entrer des opérations sur les modules et les fichiers objets dans l'ordre de votre choix.

Plus d'informations sur l'ordre d'exécution et ce que LIB souhaite pour chaque module sont données dans les descriptions de chaque caractère de commande.

List file:

Si vous voulez une liste de références croisées des symboles PUBLIC dans les modules du fichier de bibliothèque après vos manipulations, entrez un nom de fichier dans lequel vous voulez que LIB place la liste de références croisées (avec le nom de l'unité de disque et le nom du chemin facultatifs). Si vous n'entrez pas de nom de fichier, aucune liste de références croisées n'est générée (fichier NUL).

La réponse au prompt List file: est une spécification de fichier. Par conséquent, vous pouvez spécifier, avec le nom de fichier, un nom de l'unité de disque (ou de périphérique) et une extension de nom de fichier. Le fichier de liste ne reçoit pas d'extension de nom de fichier par défaut. Si vous souhaitez que le fichier ait une extension de nom de fichier, vous devez le spécifier lors de la saisie du nom de fichier.

Le fichier de liste de références croisées contient deux listes. La première liste est une liste alphabétique de tous les symboles PUBLIC. Chaque nom de symbole est suivi du nom de son module. La deuxième liste est une liste alphabétique des modules de la bibliothèque. Sous chaque nom de module se trouve une liste alphabétique des symboles PUBLIC de ce module.

Commande de caractères

LIB fournit six caractères de commande. Trois des caractères de commande sont requis en réponse au prompt Operations: ; les trois autres caractères de commande vous fournissent des commandes utiles à LIB.

Messages d'erreur

La plupart des erreurs entraînent l'abandon de la session LIB. Par conséquent, une fois la cause déterminée et corrigée, LIB doit être réexécuté.

Explication : Deux modules définissent le même symbole PUBLIC. Vous êtes invité à confirmer la suppression de la définition de l'ancien symbole. Une réponse No laisse la bibliothèque dans un état non terminé. Supprimez ou renommez la déclaration PUBLIC de l'un des modules source et recompilez ou réassemblez.

Explication : Cette erreur se produit car le disque ne dispose pas de suffisamment d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Il n'y a pas assez de place dans le répertoire du disque pour le fichier d'extraction. Utilisez un disque contenant moins de fichiers ou supprimez tous les fichiers inutiles du disque plein.

Explication : Le fichier de réponses que vous avez spécifié comme contenant toutes vos réponses appelle un autre fichier de réponses. Mettez toutes vos réponses dans un seul fichier et relancez LIB.

Explication : Il n'y a pas assez de place dans le répertoire du disque pour le fichier VM.TMP. Utilisez un disque contenant moins de fichiers ou supprimez tous les fichiers inutiles du disque plein.

Explication : Cette erreur se produit car le disque ne dispose pas de suffisamment d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Cette erreur se produit car le disque ne dispose pas de suffisamment d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Une erreur interne s'est produit. Contacter la consultation de logiciels chez Microsoft, Inc.

Explication : Un nom non valide a été utilisé pour le fichier de liste ou il n'y a pas assez de place dans le répertoire du disque pour le fichier de bibliothèque. Modifiez le nom du fichier de liste ou utilisez un disque contenant moins de fichiers ou supprimez tous les fichiers inutiles du disque plein.

Explication : Le nom du fichier objet a été mal saisi ou le module n'existe pas. Examinez le répertoire pour déterminer le nom de fichier correct et réexécutez LIB avec ce nom de fichier.

Explication : Le nom du fichier de réponses a été mal saisi ou le module n'existe pas. Examinez le répertoire pour déterminer le nom de fichier correct et réexécutez LIB avec ce nom de fichier.

Explication : Cette erreur se produit car soit le module d'objet ou la bibliothèque n'existe pas sous le nom saisi, soit il s'agit d'un module d'objet et/ou d'une bibliothèque incorrects. La cause habituelle est un disque défectueux. Assemblez les modules et relancez LIB.

Explication : Une tentative a été effectuée pour supprimer un module ne se trouvant pas actuellement dans la bibliothèque. Obtenez une liste du module de bibliothèque et réexécutez LIB en utilisant le nom de module correct.

Explication : L'erreur se produit car le disque ne dispose pas de suffisamment d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Cette erreur se produit en raison d'un module d'objet défectueux ou d'un disque défectueux. Remontez le module incriminé et relancez LIB.

Explication : Cette erreur se produit car il n'y a plus d'espace sur le disque. Essayez un autre disque qui contient plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Cette erreur se produit car le disque ne dispose pas de suffisamment d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.

Explication : Cette erreur se produit car aucune réponse n'a été donnée au prompt Library File:. Exécutez LIB et entrez un nom de fichier correct à ce prompt.

Explication : Le disque ne peut pas être lu. Essayez à nouveau cette opération et si vous recevez toujours ce message, vous avez peut-être un disque défectueux.

Il est également possible que vous ayez retiré le disque contenant le VM.TMP de l'unité de disque accédé.

Explication : Cette erreur se produit car il y a trop de symboles PUBLIC (environ 30 000 caractères dans les symboles). Supprimez tous les modules indésirables ou commencez à créer une autre bibliothèque à utiliser conjointement avec la bibliothèque existante.

Explication : Le nombre de modules d'objet dépasse la limite de 500. Supprimez les modules d'objets indésirables de la bibliothèque et réexécutez LIB.

Explication : Le nombre de symboles PUBLIC dépasse la limite de 1024. Supprimez les symboles PUBLIC indésirables de la bibliothèque et réexécutez LIB.

Explication : Cette erreur se produit parce que le disque n'a plus assez d'espace libre. Essayez un autre disque contenant plus d'espace ou libérez de l'espace sur le disque et relancez LIB.