Accéder au répertoire DOS

Il existe deux groupes de fonctions DOS pour travailler avec des répertoires. Le premier groupe est utilisé pour manipuler les sous-répertoires et le second pour rechercher des fichiers sur les périphériques d'entreposage de masse.

Avec DOS version 2.0 est venu l'introduction de sous-répertoires. Un périphérique d'entreposage de masse pourrait être logiquement divisé en sous-répertoires plus petits pouvant à leur tour être subdivisés davantage. En effet, cette organisation a créé une arborescence de répertoires.

Dans cette arborescence de répertoires, les noms et numéros des sous-répertoires ne sont pas statiques. Par conséquent, il doit y avoir un moyen d'ajouter, de modifier et de supprimer des entrées dans l'arborescence. D'autres fonctions doivent être disponibles pour définir le répertoire courant afin qu'un chemin d'accès complet ne soit pas requis pour tous les accès aux fichiers.

Au niveau utilisateur, les commandes MD, RD et CD peuvent être utilisées pour créer un répertoire, supprimer un répertoire et modifier un répertoire courant. En interne, ces commandes sont exécutées avec les fonctions 39h, 3Ah et 3Bh de l'interruption 21h du DOS.

Les trois fonctions utilisent des conventions d'appel identiques.

Le numéro de fonction est passé dans le registre AH. L'adresse du chemin est transmise dans la paire de registres DS:DX. Le chemin est une chaîne de caractères et peut être une désignation de chemin complète comprenant une lettre de l'unité de disque précédente suivie de deux-points (un nom de périphérique) et terminée par le code ASCII 0. Si le nom du périphérique est omis, le périphérique actuel est le périphérique par défaut.

Après exécution, le drapeau de retenue indique le code retour. Si le drapeau de retenue est réinitialisé (0), l'exécution a réussi. Si le drapeau de retenue est défini, une erreur s'est produite et le code d'erreur est renvoyé dans le registre AX.

La fonction 39h crée ou crée un nouveau répertoire (Make Directory). Le nom du nouveau répertoire est spécifié comme dernier élément du chemin. Une erreur sera renvoyée par les fonctions si un ou plusieurs des répertoires spécifiés dans le chemin n'existent pas, si le nouveau nom de répertoire existe déjà ou si le nombre maximum de fichiers dans le répertoire racine est dépassé.

La fonction 3Ah supprime ou supprime un répertoire (Remove Directory). Une erreur sera retournée par la fonction si le répertoire cible n'est pas vide ou si le répertoire spécifié n'existe pas dans le chemin courant.

La fonction 3Bh change le répertoire courant (Change Directory). Une erreur est renvoyée si les répertoires nommés dans le chemin n'existent pas réellement.

La fonction 0Eh définit l'unité de disque par défaut. Outre le numéro de fonction dans le registre AH, seul le code de périphérique du nouveau périphérique actuel doit être transmis dans le registre DL. Le code 0 correspond au périphérique A, 1 à B, 2 à C,...

Spécification de répertoire

Avant de spécifier le répertoire courant à l'aide de la fonction 3Bh, il est parfois nécessaire de trouver le répertoire courant. Le DOS met la fonction 47h à la disposition du programmeur à cet effet. Puisqu'il peut renvoyer le chemin du répertoire courant pour n'importe quel périphérique, le numéro de périphérique doit être passé à la fonction. S'il s'agit de l'équipement courant, la valeur 0 doit être passée dans le registre DL. Pour tous les autres périphériques, il faut passer la valeur 1 pour l'unité de disque A, 2 pour B, 3 pour C,...

Outre le code de périphérique, la fonction doit également avoir l'adresse d'un tampon de 64 octets dans le programme utilisateur. Le registre DS contient le segment et le registre SI contient l'adresse de décalage de ce tampon. Après l'appel de la fonction, ce tampon contient la désignation du chemin du répertoire courant, terminée par le caractère de fin (code ASCII 0). La désignation du chemin ne peut pas être précédée du nom du périphérique ou du caractère «\». Si le répertoire courant est le répertoire racine, le tampon ne contient que le caractère de fin. Si un code de périphérique inconnu du DOS a été transmis lors de l'appel de la fonction, le drapeau de retenue est défini et le registre AX contient le code d'erreur 0Fh.

Considérons les fonctions de recherche d'un ou plusieurs fichiers dans le répertoire courant sur le périphérique courant. Là encore, le parallèle entre les fonctions de descripteur de fichier et FCB apparaît. Deux groupes de fonctions existent pour rechercher des fichiers. Le groupe de fonctions FCB a l'inconvénient de limiter la recherche aux fichiers dans le répertoire courant d'un certain périphérique, tandis que les fonctions de gestion permettent de rechercher des fichiers dans n'importe quel répertoire de n'importe quel périphérique. Le terme "fonctions de descripteur de fichier" ne correspond pas vraiment à ces fonctions puisqu'elles ne sont pas adressées avec un descripteur de fichier. Cette désignation est née avec l'introduction de sous-répertoires (et donc les fonctions de descripteur de fichier) dans DOS version 2.0. La version 1.0 n'offrait que les fonctions FCB.

Recherche de fichiers à l'aide des fonctions FCB

Cette méthode de recherche de fichiers utilise les fonctions 11h et 12h. En les utilisant, vous pouvez rechercher des fichiers avec un nom fixe ou des fichiers avec une extension de nom de fichier. La fonction 11h trouve le premier fichier dans le répertoire courant. La fonction 12h trouve tous les autres fichiers supplémentaires. Les FCB jouent un rôle important puisqu'ils assurent la médiation entre le programme appelant et les deux fonctions. Voyons comment rechercher des fichiers dans un répertoire :

Le programme doit d'abord réserver de l'espace pour deux les FCB. Cela se fait soit en réservant de la mémoire dans la zone de données du programme, soit en demandant de la mémoire au DOS à l'aide de la fonction 48h. Le programmeur peut utiliser des FCB normaux ou étendus. Les FCB étendus offrent l'avantage de pouvoir rechercher des fichiers avec des attributs spéciaux (système ou cachés), des noms de volume et des sous-répertoires. Le nom du fichier pour lequel la recherche sera effectuée est spécifié dans l'un des FCB. Le DOS place le nom du ou des fichiers qu'il trouve dans l'autre FCB. Pour différencier les deux FCB, ils sont désignés par les noms de recherche FCB et le FCB trouvé.

L'adresse du FCB trouvé doit être transmise au DOS à l'aide de la fonction 1Ah. Le FCB trouvé devient la nouvelle zone de transmission de données (DTA) lorsque cet appel de fonction se produit. Cette zone est importante pour ces deux fonctions ainsi que pour toutes les autres fonctions transférant des données entre l'ordinateur et les disques. Pour cette raison, la fonction 2Fh doit déterminer l'adresse du DTA actuel avant d'activer le nouveau DTA. Lorsque la recherche de fichiers est terminée, le DTA peut être restauré à son état d'origine à l'aide de la fonction 1Ah.

Une fois que le DTA est défini sur le FCB trouvé, l'étape suivante consiste à placer le nom du fichier que vous recherchez dans le FCB de recherche. Pour une recherche plus générale, les caractères génériques * et ? peut être utilisé. Vous pouvez transférer le nom du fichier directement ou le transférer à l'aide de la fonction 29h. Si vous souhaitez rechercher dans tous les messages, utilisez le nom de fichier *.*. Si un FCB étendu est utilisé, vous pouvez insérer une valeur supplémentaire dans le champ d'attribut du FCB de recherche pour limiter la recherche à mes seuls attributs.

Ceci conclut le travail préliminaire. La recherche de fichiers peut commencer par le répertoire courant. A cet effet, la fonction 11h est appelée avec le numéro de fonction dans le registre AH, l'adresse de segment de recherche FCB dans DS et l'adresse de décalage dans le registre DX. Si le système trouve un fichier avec le nom indiqué, le registre AL contient la valeur 0 après l'appel de la fonction. Si le nom de fichier n'a pas été trouvé, le registre AL contient une valeur de 255. Le nom de fichier trouvé et ses attributs (si des FCB étendus sont utilisés) peuvent être lus à partir du FCB trouvé. Pour des recherches supplémentaires, la fonction 12h (pas la fonction 11h) est appelée. Le contenu du registre de la fonction 12h pendant l'appel et le retour est similaire à la fonction 11h. S'il renvoie la valeur 255 dans le registre AL lors d'un des appels, la recherche est terminée.

Recherche de fichiers à l'aide des fonctions de descripteur de fichier

Travailler avec les fonctions de descripteur de fichiers est plus facile que de travailler avec les fonctions FCB. Il existe des fonctions pour rechercher le premier fichier (la fonction 4Eh) et les fichiers suivants (la fonction 4Fh). Les deux fonctions renvoient les informations au DTA. Pour cette raison, le DTA doit être déplacé dans une zone accessible au programme en cours avant d'appeler l'une ou l'autre de ces fonctions. Cette zone doit avoir au moins 43 octets disponibles. Comme mentionné dans le cadre des fonctions FCB, le DTA doit être restauré à son adresse d'origine une fois la recherche terminée.

Lors de l'appel de la fonction 4Eh, le numéro de fonction est passé dans le registre AH, l'attribut dans le registre CX et l'adresse du fichier à retrouver dans la paire de registre DS:DX. Le nom de fichier est une série de caractères ASCII, terminée par un caractère de fin (code ASCII 0). En plus d'un nom de périphérique, vous pouvez ajouter une désignation de chemin d'accès complète et les caractères génériques «*» et «?». Si aucun chemin n'est spécifié, DOS suppose que la recherche doit être effectuée dans le répertoire courant du périphérique indiqué. Si un périphérique n'est pas spécifié, la recherche se poursuit sur le périphérique actuel. Après l'appel de la fonction, le drapeau de retenue indique si un fichier a été trouvé. Si le fichier est introuvable, le drapeau de retenue est défini et le registre AX contient un code d'erreur. Un code d'erreur de 2h est renvoyé si le chemin indiqué n'existe pas. Si aucun fichier n'a pu être trouvé, un code d'erreur de 12h est renvoyé. Si le drapeau de retenue est réinitialisé, le DTA contient les informations sur le fichier trouvé. Il a la structure suivante :

La fonction 4Fh exécute d'éventuelles recherches supplémentaires. Le numéro de fonction est passé dans le registre AH et aucun autre paramètre n'est requis. Le drapeau de retenue indique s'il existe des fichiers supplémentaires dans le répertoire courant auxquels la recherche peut s'appliquer.