@DATABASE SnoopDos.guide @remark : @remark : $VER: SnoopDos.guide 3.0 (15.9.94) @remark : vi:ts=8 @remark : Si vous n'avez pas AmigaGuide, vous pouvez toujours lire ce fichier @remark : avec un éditeur de textes classique. Tout a été agencé dans un @remark : ordre logique, et la partie lourde et spécifique à AmigaGuide a @remark : été placée en fin de fichier. @remark : @remark : Je recommande l'utilisation de AG2TXT par Jason R. Hulance pour @remark : convertir ce fichier en ascii pur, pour impression sur imprimante. @remark : Vous pourrez le trouver sur Aminet : text/hyper/ag2txt.lzh. @remark : @remark :01234567890123456789012345678901234567890123456789012345678901234567 @remark : @INDEX Index @MASTER SnoopDos.Guide @NODE MAIN @TITLE "SnoopDos 3.0 Copyright © Eddy Carroll 1994" SnoopDos 3.0 -- Moniteur du système et des applications Copyright © Eddy Carroll 1994. Distribution gratuite. SnoopDos est un utilitaire qui vous permet de visualiser une sélection d'opérations système générées par les programmes sur votre Amiga. Ceci inclut les fichiers qu'un programme tente d'ouvrir, quelles polices, bibliothèques, devices et variables d'environnement il recherche, etc. Cliquez sur l'un des sujets suivants pour plus d'explications: @{" Mise en route rapide " link QuickStart } Pour ceux qui détestent lire les documentations @{" Introduction " link Introduction } Une vue d'ensemble de l'utilisation de SnoopDos @{" Nouveautés du 3.0 " link WhatsNew } Pour ceux qui utilisaient SnoopDos 1.7 @{" Fenêtre principale " link MainWindow } Guide de la fenêtre principale de SnoopDos @{" Les préférences " link SettingsWindow } Modifier les préférences de Snoopdos @{" Les fonctions " link FunctionWindow } Choisir les fonctions à visualiser @{" Editeur de formats " link FormatEditor } Editer le format de la visualisation @{" Menu des options " link Menu_Index } Un guide des options du menu de la fenêtre principale @{" Index des commandes " link CommandIndex } Un guide complet des commandes supportées @{" Démarrage par le Workbench " link Workbench } Comment démarrer SnoopDos depuis le Workbench @{" Démarrage par le CLI " link CLI } Comment démarrer SnoopDos depuis le CLI @{" Support Arexx " link ARexx } Comment contrôler SnoopDos par ARexx @{" Fichiers de préférences " link SettingsFiles } Comment utiliser au mieux les préférences @{" Distribution " link Distribution } Conditions de distribution de SnoopDos @{" Historique " link History } Les versions courantes & précédentes de SnoopDos @{" Remerciements " link Credits } Des fleurs à tous ceux qui m'ont aidé @{" L'auteur " link Author } Comment entrer en contact avec l'auteur Cliquez sur CONTENU en haut de la page pour revenir ici à tout moment. @ENDNODE @NODE QuickStart @TITLE "Comment rapidement se servir de SnoopDos" UN GUIDE RAPIDE DE L'UTILISATION DE SNOOPDOS Pour éxécuter SnoopDos, cliquez tout simplement sur l'icône de SnoopDos depuis le Workbench ou tapez "Run SnoopDos" depuis le CLI. Les options par défaut ont été choisies pour convenir à la plupart des configurations. Vous pouvez cliquer sur le bouton Fonctions pour choisir quelles fonctions seront surveillées, ou sur le bouton Préfs pour modifier la plupart des autres options. Vous pouvez également utiliser les menus associés à la fenêtre principale. Ce qu'il faut savoir : · Appuyer sur la touche HELP depuis SnoopDos affiche cette documentation · Les colonnes de la fenêtre principale peuvent être déplacées vers la gauche ou la droite avec la souris en cliquant sur leur titre. Appuyer simultanément sur la touche Shift les déplace vers la droite. · Un double-clic sur le titre d'une des colonnes appelle l'éditeur de format. Il permet de modifier la disposition de l'affichage, en choisissant un champ avec le bouton gauche de la souris et en le déplaçant vers une nouvelle position, puis en le relâchant. · Les changements effectués dans les fenêtres de Fonctions, Préférences et d'éditeur de format prennent effet immédiatement. Vous pouvez cliquer sur Annuler ou Abandon pour retrouver les préférences précédentes ou Utiliser pour valider les changements. Les trois fenêtres de configuration peuvent être ouvertes simultanément. · Lorsque vous cliquez sur Sauver Prefs, SnoopDos écrit la configuration dans le fichier ENVARC:SnoopDos.prefs (l'outil SETTINGS ou une option sous CLI permettent de choisir un autre nom). Vous pouvez consulter ce fichier pour voir une liste partielle des commandes Arexx supportées, des outils et des options sous CLI. Si vous placez ce fichier dans S:, SnoopDos le détectera et l'utilisera par la suite ( Ceci permet de ne pas perdre de mémoire dans ENV:). · Si vous voulez visualiser les opérations sur les fichiers effectués par des programmes compilés par le Gnu C (ixemul.library), assurez-vous que l'option Voir Paquets est sélectionnée. Il se peut toutefois que cela ralentisse votre système. · L'option "Buffer->Fenêtre Copie vers Clipboard" vous permet de copier rapidement les résultats de SnoopDos vers votre éditeur préféré. · Vous pouvez exclure les tâches que vous ne voulez pas visualiser en saisissant, dans la fenêtre de fonctions, un critère de style AmigaDos tel que "~(tache1|tache2|tache3)" dans le gadget Critère. · Le bouton Pause dans la fenêtre principale vous permet de voir ce qu'une application essaie de faire avant qu'elle le fasse réellement. Toute tâche essayant d'éxécuter une fonction à visualiser sera affichée avec un résultat ATTENTE. Cliquez sur le gadget flèche bas de l'ascenseur ou appuyer sur la barre d'espace éxécute la fonction et passe à la suivante. · Dans le cas du DOS device, l'option Voir Paquets dans la fenêtre de fonctions permet de visualiser tous les paquets envoyés vers un device. Vous pourrez aussi utiliser Voir Appels ROM pour visualiser les paquets envoyés par la dos.library. Vous pourrez également élargir les champs Action et Rés. pour être sûr de ne pas rater d'informations. · Si vous voulez que SnoopDos s'éxécute automatiquement au démarrage de votre machine, faites glisser l'icône dans votre répertoire WBstartup. Assurez-vous que l'icône contient l'outil CACHER=OUI si vous désirez que SnoopDos reste caché. Copiez le fichier SnoopDos.Guide vers votre répertoire dédié aux fichiers AmigaGuide ou vers le répertoire WBStartup si vous voulez accéder à l'aide en ligne depuis SnoopDos. Voir aussi : @{" Contenu " link Main} @{" Introduction " link Introduction} @{" Nouveautés du 3.0 " link WhatsNew} @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE Introduction @TITLE "Introduction à SnoopDos" INTRODUCTION A SNOOPDOS Combien de fois avez-vous essayé d'installer une grosse application, et vous êtes-vous aperçu qu'elle ne fonctionnait pas correctement ? Souvent, il se trouve qu'elle a besoin d'un fichier, une bibliothèque, une variable, ou une police que vous avez tout simplement oublié d'installer. La version 1 de SnoopDos permettait une approche simplifiée du scrutage de l'activité d'un programme. Depuis sa sortie, d'autres programmes sont apparus, effectuant un travail similaire, comme par exemple DosTrace de Peter Stuer, Snoopy de Gerson Kurz et WoodWard de Tomas Rokiki. Malgré le bien que je pense de ces programmes, j'ai trouvé qu'ils étaient sans raison trop compliqués pour que l'utilisateur puisse voir les informations l'intéressant. SnoopDos 3.0 a pour but de projeter le SnoopDos originel dans les années 90 en lui ajoutant une interface respecteuse du style 2.0 & 3.0, ainsi que de nouvelles et puissantes fonctions, tout en conservant l'esprit de simplicité de son ancêtre. Pour lancer SnoopDos, faites tout simplement un double-clic sur l'icône SnoopDos ou tapez "Run SnoopDos" dans une fenêtre CLI. La première chose que vous verrez sera la fenêtre principale de SnoopDos, comporte plusieurs boutons. A partir de ce moment, SnoopDos est actif, et rend déjà compte des opérations du système. Si vous lancez une autre application, vous devez voir des lignes s'afficher dans la fenêtre principale. Si trop d'informations s'affichent dans cette fenêtre, elles vont se déplacer vers le haut - vous pouvez alors utiliser l'ascenseur pour les ramener dans la fenêtre principale. Dans la plupart des cas, c'est tout ce dont vous aurez besoin pour identifier un problème. SnoopDos affichera tout fichier qui n'a pas pu être ouvert, toute police qui n'a pas été trouvée, etc., ainsi que toutes les opérations qui ont réussi. Ceci étant, vous pouvez adapter SnoopDos à votre environnement. En cliquant dans les gadgets Préfs, Fonctions de la fenêtre principale, vous pouvez ouvrir deux fenêtres supplémentaires. La fenêtre des Préférences vous permettra de changer divers paramètres tels que les polices à utiliser pour l'affichage, et la fenêtre des @{" Fonctions " link FunctionWindow} vous permettra de choisir quels évènements SnoopDos devra afficher dans la fenêtre principale. Si vous hésitez sur la signification de l'un de ces boutons, utilisez l'aide de la fenêtre des Fonctions pour plus de précisions. Un aspect important de SnoopDos est que vous pouvez décider exactement le degré d'information que vous souhaitez obtenir. Sélectionnez "Voir Format..." dans le menu de la fenêtre principale pour ouvrir l'éditeur de format. Il décrit le format des évènements qui contrôle la manière dont les informations sont affichées dans la fenêtre principale. Pour le modifier, choisissez tout simplement les champs avec le bouton gauche de la souris et déplacez-les vers une nouvelle position. Par exemple, si vous désirez visualiser l'heure d'occurence des évènements, déplacez simplement le Champs Heure depuis la boite "Champs dispos." dans la boite Format actuel". Dès que vous l'aurez déplacé et déposé, la fenêtre principale se réactualisera pour montrer l'heure de chaque évènement. SnoopDos récupère toujours toutes les informations possibles sur un évènement donné, même si elles ne sont pas toutes affichées. Vous pouvez aussi modifier le format directement dans la fenêtre principale en choisissant les titres des colonnes avec la souris et en les déplaçant vers une nouvelle position. Généralement, déplacer un titre le repositionne indépendamment de ceux de chaque côté; si vous appuyez sur shift pendant le déplacement, toutes les colonnes à droite seront également déplacées. Si vous modifiez la configuration par défaut de SnoopDos, vous voudrez sans doute sauver vos changements pour qu'ils soient encore effectifs la prochaine fois que vous éxécuterez SnoopDos. Cliquez tout simplement sur le bouton Sauver Prefs dans la fenêtre principale, et ils seront sauvés dans un fichier appellé ENVARC:SnoopDos.prefs. Vous pouvez visualiser ce fichier avec n'importe quel éditeur de textes. Maintenant, essayez SnoopDos. A tout moment, vous pouvez appuyer sur la touche HELP pour appeler l'aide en ligne (dépendante du contexte) qui se trouve dans ce document. Après cela, vous pourrez revenir à cette documentation et lire les pages d'aide concernant la fenêtre principale, de Fonctions et de Préférences. Voir aussi : @{" Contenu " link Main} @{" Mise en route rapide " link QuickStart} @{" Nouveautés du 3.0 " link WhatsNew} @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE WhatsNew @TITLE "Les nouveautés de SnoopDos 3.0" LES NOUVEAUTES DE SNOOPDOS 3.0 Si vous êtes l'un des nombreux utilisateurs de SnoopDos 1.7, vous serez heureux de constater que SnoopDos 3.0 offre une série de nouvelles fonctions faites pour le rendre encore plus utile. Malheureusement, on n'a rien sans rien dans ce bas-monde. SnoopDos a évolué, d'un utilitaire réservé au CLI vers une application conséquente et respecteuse des Workbench 2.0 & 3.0. Du fait que la plupart des utilisateurs sérieux ont maintenant des systèmes accélérés dotés de suffisammemt de mémoire et d'espace sur disque dur, cela semble une évolution raisonnable. Si votre Amiga a des capacités trop modestes, vous pourrez trouver l'un des autres utilitaires du même style que SnoopDos plus adapté à votre configuration. Voici sans plus attendre une liste des principales nouveautés apportées par cette version de SnoopDos. · Une interface utilisateur adaptée à toute police de caractères qui vous permet de contrôler toutes les options par le clavier ou la souris. Les gadgets de la fenêtre principale peuvent être occultés pour permettre à un maximum de lignes d'apparaître à l'écran. · Un buffer mémoire garde trace de tous les appels de fonctions, et peut être consulté grâce à un ascenseur. · Beaucoup de nouvelles fonctions peuvent être visualisées, dont les outils Workbench, les messages ARexx envoyés par un script ARexx, ainsi qu'une sélection de fonctions du DOS 2.04. · Les programmes compilés avce le GNU C, qui outrepasse la dos.library, en utilisant directement le dos.device grâce à des entrées/sorties par paquets, peuvent maintenant être surveillés. · Des informations supplémentaires sont disponibles pour chaque fonction surveillée, dont l'heure d'appel, depuis quel module a été fait l'appel (si SegTracker est actif), le numéro du processus et bien plus encore. · Vous pouvez maintenant choisir exactement quels programmes surveiller ou ignorer, en utilisant une chaine standard de critères au format AmigaDOS. · Pour les programmeurs du dos.device, un débugger de paquets vous permet de visualiser tous les paquets envoyés à tout device monté. · Un éditeur pratique utilisant la technique du glisser/lâcher vous permet de choisir exactement le degré d'information que vous désirez obtenir pour chaque évènement. Pour un contrôle encore plus poussé, vous pouvez ajuster la largeur de chaque colonne de la fenêtre principale avec la souris. · Toutes les sous-fenêtres pour contrôler les diverses préférences sont indépendantes. Vous pouvez les laisser ouvertes tout le temps si vous le désirez, et tout changement est immédiatement pris en compte. · SnoopDos peut maintenant être utilisé comme une commodité, en continuant à surveiller l'activité du système alors qu'il est caché en tâche de fond. · La nouvelle fonction Pause permet de geler toutes les tâches qui sont surveillées par SnoopDos, ou de les laisser s'éxécuter pas à pas au travers des appels qu'elles effectuent. · Un langage complet de plus de 100 commandes vous laisse contrôler SnoopDos depuis le CLI, le Workbench, ARexx ou des scripts. · SnoopDos peut lire un fichier externe afin de permettre la localisation pour tout pays. · Une aide AmigaGuide contextuelle est disponible depuis le programme. · La gestion du ClipBoard est gérée, ce qui vous permet de copier très rapidement les résultat de SnoopDos vers votre éditeur de textes favori ou un traitement de textes. · Les appels de fonctions peuvent être dirigés vers un fichier ET affichés dans la fenêtre principale de SnoopDos. Alors, qu'est-ce que vous attendez, essayez-le ! Voir aussi : @{" Contenu " link Main} @{" Mise en route rapide " link QuickStart} @{" Introduction " lin>k Introduction} @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE Workbench @TITLE "Démarrer SnoopDos depuis le Workbench" DEMARRER SNOOPDOS DEPUIS LE WORKBENCH SnoopDos peut être facilement lancé depuis le Workbench en faisant un double-clic sur son icône, ou sur l'icône de tout fichier de préférences sauvé précédemment. Vous pouvez stocker toute commande de SnoopDos comme icône-outil, et chaque commande sera éxécutée par SnoopDos à son chargement. Par exemple, cela donne la possibilité d'ouvrir automatiquement un fichier trace sur disque à chaque fois que vous lancez SnoopDos (en utilisant les commandes @{" OpenLog " link OpenLog} ou @{" AppendLog " link AppendLog}). Vous pouvez aussi automatiquement ouvrir la fenêtre de Fonctions en utilisant la commande @{" OpenFunction " link OpenFunction}, ou en arrangeant la fenêtre principale de façon à ce qu'elle s'affiche toujours au même endroit en utilisant la commande @{" MainWindowPos " link MainWindowPos}. SnoopDos effectue les choses suivantes lorsqu'il est lancé du Workbench : · Il vérifie l'icône outil pour le commandes @{" Language " link Language}, @{" PatchRamLib " link PatchRamLib} et @{" Settings " link Settings}. · Il charge le fichier de préférences, défini par la commande Préfs. Si aucun nom n'a encore été défini, il cherche dans les répertoires PROGDIR:, ENVARC: and S: un fichier appellé SnoopDos.prefs et le charge s'il existe. · Il lit tout fichier de préférences qui a été passé comme icône de projet lorsque SnoopDos a été lancé. Ces fichiers contiennent aussi les commandes SnoopDos, et pas uniquement les préférences. · Il recherche les outils de tous les icônes sélectionnés, en commençant par l'icône du programme, et éxécute toute commande reconnue. Après tout ceci, la fenêtre principale est automatiquement ouverte, à moins qu'une commande @{" Hide " link Hide} or @{" CX_Popup=No " link CX_Popup} soit rencontrée. Si SnoopDos était déjà actif lorsque l'icône a été cliqué, les commandes dans les fichiers de préférences et les outils seront éxécutées par la version déjà active de SnoopDos. Dans ce cas, les mots-clés Hide and CX_Popup seront ignorés et la fenêtre principale de SnoopDos sera automatiquement ré-ouverte si elle était cachée. Cela permet d'activer la fenêtre de SnoopDos en cliquant sur l'icône SnoopDos, même si cet icône contient une commande Hide dans ses outils. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Syntaxe des commandes " link CommandSyntax} @{" Fichier de préférences " link SettingsFiles} @{" Utilisation par le CLI " link CLI} @{" Support ARexx " link ARexx} @ENDNODE @NODE CLI @TITLE "Démarrer SnoopDos depuis le CLI" DEMARRER SNOOPDOS DEPUIS LE CLI Lorsque vous lancez SnoopDos depuis le CLI, il effectue les actions suivantes: · Vérifie la ligne de commande pour @{" Language " link Language}, @{" PatchRamLib " link PatchRamLib} et @{" Settings " link Settings} · Charge le fichier de préférences par défaut, comme défini par la commande Préférences. Si aucun nom n'a été spécifié, il recherche dans PROGDIR:, ENVARC: et S: pour un fichier appellé SnoopDos.prefs et le lit s'il existe. · Exécute toutes les autres commandes de SnoopDos de la ligne de commande. Si SnoopDos était déjà lancé, les commandes sont éxécutées par l'ancienne version. Par exemple, vous pouvez utiliser la commande SNOOPDOS OPENLOG "ram:SnoopDos.log" pour que la copie SnoopDos déjà lancée ouvre un nouveau fichier trace. Taper SNOOPDOS HELP affichera un récapitulatif de toutes les commandes reconnues par SnoopDos. Les commandes nécessitant un paramètre sont marquées avec une '*'. Si vous avez l'intention de contrôler SnoopDos depuis le CLI de cette façon, vous pourrez vous plonger dans ses possibilités @{" ARexx " link ARexx}. Utiliser la commande RX pour envoyer une commande a SnoopDos sera généralement plus rapide qu'attendre que l'éxécutable SnoopDos se charge une seconde fois. Un alias comme celui qui suit peut être utile: ALIAS SNOOPTELL "RX *"ADDRESS SNOOPDOS '[]'*"" Ceci vous permet d'envoyer des commandes SnoopDos en tapant simplement SnoopTell . Si vous utilisez cette méthode, vous devrez doubler tous les guillemets de la ligne de commande; SnoopTell OpenLog "ram:test file" deviendra SnoopTell OpenLog ""ram:test file"". Si vous oubliez accidentellement de taper "RUN SNOOPDOS" la première fois que vous lancez le programme, le CLI sera indisponible jusqu'à ce que SnoopDos se termine. Si cela arrivait, vous pouvez dire à SnoopDos de s'arrêter en tapant CTRL-C dans la fenêtre de CLI. Cette fonctions est particulièrement utile si vous utilisez SnoopDos à distance grâce à un modem ou par réseau. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Syntaxe des commandes " link CommandSyntax} @{" Fichiers préférences " link SettingsFiles} @{" Utilisation par le Workbench " link Workbench} @{" Support ARexx " link ARexx} @ENDNODE @NODE ARexx @TITLE "Support Arexx de SnoopDos" SUPPORT AREXX DE SNOOPDOS Lorsque SnoopDos est lancé, il crée un port ARexx appelé (bien évidemment !) SNOOPDOS. Ceci vous permet de contrôler presque tous les aspects de ce programme depuis des scripts ARexx. Voici un exemple d'script ARexx simple qui configure SnoopDos pour visualiser une fonction donnée, et qui capture tous les appels à cette fonction dans un fichier de rapport. /* Script ARexx simple pour tracer tous les appels à LoadSeg */ /* Vérifie si SnoopDos est déjà lancé, et le lance s'il faut */ if ~show('P', 'SNOOPDOS') then do address command "run >nil: SnoopDos" address command "waitforport SNOOPDOS" end address SNOOPDOS /* Commandes dirigées vers SD */ logformat "%t %15p %6a %37n %6o %r" /* Configure le format du buffer */ functions none /* Aucune fonction */ loadseg on /* Choisit la fonction LoadSeg */ appendlog "ram:SnoopDos.txt" /* Ouvre le fichier de rapport */ addlog "(Monitoring only LoadSeg)" /* Message vers le fichier rapport */ logformat none /* Ote le format du buffer */ (Même si on ôte le format du buffer à la fin du script, il restera actif jusqu'à ce que le fichier rapport soit fermé. Le prochain fichier de rapport qui sera ouvert utilisera le format de la fenêtre principale.) Si ce code est stocké dans un fichier appellé LoadSeg.ARexx, vous pourrez l'éxécuter en tapant RX LOADSEG. Vous pouvez savoir si une commande particulière de SnoopDos a réussi ou échoué en testant la variable RC. Les valeurs qu'elle peut prendre sont : RC = 0 La commande s'est effectuée avec succès. RC = 10 La commande requiert un paramètre. RC = 20 La commande n'a pu être éxécutée (le paramètre est peut-être erroné). RC = 30 La commande n'a pas été reconnue par SnoopDos. Vous pouvez utiliser la commande ARexx SIGNAL ON ERROR pour qu'ARexx s'arrête s'il rencontre une erreur de SnoopDos (normalement, les erreurs seront tout simplement ignorées). Si vous voulez personnaliser les commandes SnoopDos, vous pouvez utiliser la commande @{" LoadSettings " link LoadSettings} avec comme nom de fichier "CON:////SnoopDos/CLOSE" pour ouvrir une fenêtre de commande qui vous permette de saisir intéractivement vos commandes et voir leurs effets. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Syntaxe des commandes " link CommandSyntax} @{" Fichiers des préférences " link SettingsFiles} @{" Utilisation depuis le Workbench " link Workbench} @{" Utilisation depuis le CLI " link CLI} @ENDNODE @NODE SettingsFiles @TITLE "Fichiers des préférences de SnoopDos" FICHIERS DES PREFERENCES DE SNOOPDOS Un fichier de préférences SnoopDos est un fichier texte commençant par la ligne "" et contient des commandes SnoopDos. Bien que les fichiers de préférences soient automatiquement générés par la commande @{" SaveDefSettings " link SaveDefSettings}, ils peuvent aussi être créés avec un éditeur de textes classique. En fait, l'expression "Fichier de préférences" peut induire en erreur, puisque un tel fichier contient toute commande SnoopDos, pas seulement celles qui contrôlent les préférences. Par exemple, un fichier de préférences peut comporter des instructions comme ouvrir un nouveau fichier de rapport, ouvrir d'une certaine manière les fenêtres, ou configurer le format de sortie d'un fichier de rapport existant. Le format du fichier est relativement libre. Il doit y avoir une commande par ligne, et tout ce qui est précédé par un point-virgule est traité comme un commentaire. Voir le chapitre sur la @{" Syntaxe des commandes " link CommandSyntax} pour plus de détails. Lorsque vous lancez SnoopDos, il recherche un fichier de préférences par défaut, et éxécute toutes les commandes qu'il contient. Vous pouvez spécifier explicitement le nom de ce fichier en utilisant la commande @{" Préférences " link Settings}. Si vous ne spécifiez par un fichier par défaut, SnoopDos recherchera dans les répertoires PROGDIR:, ENVARC:, et S: un fichier appellé SnoopDos.prefs. S'il ne le trouve dans aucun de ces répertoires, il utilisera le nom ENVARC:SnoopDos.prefs et s'en servira lorsque vous demanderez à sauver les préférences. Notez que cela permet une certaine flexibilité quant au choix de l'endroit où sauver vos préférences. Si vous n'appréciez pas que le fichier de préférences vous gâche de la RAM en étant stocké dans ENVARC: (et donc ENV:), vous pouvez simplement déplacer le fichier vers S: ou le répertoire du programme, et SnoopDos utilisera toujours de lui-même le nouveau répertoire. Du fait que SnoopDos efface les anciens fichiers lorsque vous sauvez vos préférences, il n'est pas conseillé d'inclure des commandes autres que celles écrites par SnoopDos lui-même -- elles seraient remplacées lors de la sauvegarde suivante. Vous pouvez plutôt insérer de telles commandes comme tooltypes dans l'icône de SnoopDos. De toutes façons, il existe un moyen plus subtil d'éxécuter des commandes supplémentaires lors de l'initialisation de SnoopDos. Vous pouvez créer un fichier de préférences par défaut (par exemple ENVARC:SnoopDos.prefs) qui contient quelquechose de ce genre : ; Settings "S:SnoopDos.set" ; Fichier de préférences par défaut. LoadDefSettings ; Charger les préférences par défaut. ; ; Maintenant, les commandes supplémentaires ; OpenLog "ram:SnoopDos.log" ; Ouverture d'un nouveau fichier de rapport FormatWindowPos=400,300 ; Forcer la position de la fenêtre OpenFormat ; Ouvrir la fenêtre de format ; etc. Comme vous pouvez le voir, la première chose que fait ce fichier de commandes est de changer le nom du fichier de préférences par défaut. Si vous cliquez sur Sauver Préfs dans SnoopDos, le nouveau fichier sera réécrit, plutôt que le fichier de préférences par défaut. Ensuite, ces préférences sont chargées. (SnoopDos ne chargera pas automatiquement les préférences à moins que vous ne lui disiez.) Après cela, toute commande supplémentaire peut être utilisée. Par exemple, vous pouvez faire en sorte que SnoopDos démarre toujours en position Pause ou Arrêté. Si vous désirez que certaines préférences soient toujours fixées à une valeur particulière, c'est le bon endroit pour le déclarer. Notez que, bien qu'il soit possible pour un fichier de préférences d'en éxécuter un autre, en utilisant les commandes @{" LoadSettings " link LoadSettings} ou @{" LoadDefSettings " link LoadDefSettings}, cela n'est autorisé que sur trois niveaux d'appel. Ceci évite de boucler indéfiniment si vous essayez par erreur de charger un fichier depuis lui-même. Il y a une dernière astuce avec les fichiers de préférences. Si vous chargez un fichier de préférences avec un nom qui correspond à un nom de console comme par exemple "CON:////SnoopDos/CLOSE", SnoopDos vous permettra de taper des commandes intéractivement et voir leurs effets. Voir la commande @{" LoadSettings " link LoadSettings} pour plus de précisions. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Syntaxe des commandes " link CommandSyntax} @{" Support ARexx " link ARexx} @{" Utilisation depuis le Workbench " link Workbench} @{" Utilisation depuis le CLI " link CLI} @ENDNODE @NODE Distribution @TITLE "Distribution de SnoopDos" DISTRIBUTION DE SNOOPDOS Ma politique concernant la distribution de SnoopDos est simple : il peut être distribué librement pour des buts non-commerciaux, tant que tous les fichiers de l'archive originale sont présents et n'ont été modifiés d'aucune manière. Compresser les fichiers grâce à PowerPacker est toléré, mais fortement déconseillé. Aucun somme ne pourra être réclamée pour SnoopDos, autre que des frais raisonnables pour couvrir le support physique et le temps de copie. Si vous désirez inclure SnoopDos sur une disquette d'accompagnement de magazine, vous pouvez le faire dans la mesure ou vous m'envoyez une copie du numéro où il apparait, à mon adresse personnelle. L'intégralité des fichiers doit être incluse, et pas uniquement l'éxécutable. Veuillez s'il vous plait me contacter pour vous assurer que vous possédez la dernière version. Si vous voulez intégrer SnoopDos dans un produit commercial, veuillez s'il vous plait me contacter pour en parler -- je ne suis pas gourmand. Si vous désirez utiliser SnoopDos dans une compilation de Domaine Publique sur CDROM, vous pouvez le faire dans la mesure où le CD contient au moins 20 Mo d'autres programmes du Domaine Public. Sinon, contactez-moi d'abord. Une permission explicite est accordée pour distribuer SnoopDos sur tout CDROM produit par Fred Fish / Amiga Library Services, et sur toute compilation CDROM officielle d'Aminet. Je me réserve le droit de dénoncer publiquement quiconque ne respecte pas ces règles de distribution, et d'aller plus loin s'il le faut. Remarque : Le code source de SnoopDos est disponible dans une archive séparée. Vous pourrez la trouver sur Aminet dans le répertoire util/moni, avec l'archive principale de SnoopDos. Voir aussi : @{" Contenu " link Main} @{" Historique " link History} @{" Remerciements " link Credits} @{" L'auteur " link Author} @ENDNODE @NODE History @TITLE "Historique de SnoopDos" HISTORIQUE DE SNOOPDOS La toute première version de SnoopDos a été écrite en 1990, après suggestion d'un ami. Elle s'est révélée populaire, et est sortie officiellement sous la version 1.0 en septembre 1990. Au fil des années suivantes, SnoopDos a bénéficié d'un certain nombre d'améliorations, la dernière sortie étant la V1.7 en décembre 1992. Une version supplémentaire V1.7a est sortie en mai 1993, et n'a été que peu répandue. Une refonte complète de SnoopDos a été commencée à l'automne 1993. Un groupe d'utilisateurs a été créé dans une conférence fermée du BBS Cix en Angleterre, et un prototype initial de l'interface utilisateur a été construit grâce à l'utilitaire ToolMaker de Commodore. Il a été utilisé pour recueillir les commentaires de mes testeurs sur l'interface, et a servi de base à la vraie première version. En janvier 1994, j'ai été muté à St Paul, Minnesota pour mon travail. Après avoir acheté un A3000 d'occasion (merci à Scott !), j'ai pu me remettre à mon projet. Pendant ces trois mois, SnoopDos a acquis la plupart de ses fonctions, ainsi que quelques nouvelles comme l'éditeur de format par déplacement. Je suis retourné en Irlande à la fin du mois d'Avril, et le travail s'est poursuivi pendant l'été. Beaucoup de bugs ont été éliminés, le langage de commandes a été élaboré, des améliorations ont été faites, et la documentation a été écrite. En juillet, les carnet des charges était bouclé et le peaufinage a été effectué en août. Après presque un an, SnoopDos 3.0 était prêt à sortir. Sachant que la toute première version de SnoopDos a été écrite en moins d'une semaine, vous pouvez vous demander pourquoi cette version a mis si longtemps a être écrite. Soit je suis plus lent, ou c'est maintenant un programme bien plus sophistiqué -- vous verrez par vous-même. UNE REMARQUE AU SUJET DES VERSIONS PIRATES DE SNOOPDOS Vous avez peut-être noté le saut de la version 1.7 de SnoopDos à la version 3.0. Ceci est d'une part voulu pour que cela coïncide avec la version actuelle du Kickstart, et d'autre part pour éviter la confusion avec les copies pirates de SnoopDos. Pour des raisons qui leur sont propres, différents individus n'ont pas trouvé mieux que de prendre le code source de SnoopDos (toujours disponible), et de l'utiliser pour générer de nouvelles versions, non-autorisées qui ont été diffusées comme des versions officielles. L'une au moins de ces versions contient un virus. Deux versions modifiées assez répandues ont pour numéro de version 1.6 et 2.0; si vous possédez l'une ou l'autre de ces versions, effacez-la immédiatement. Une façon pour moi de réduire les chances pour que ceci se reproduise est d'arrêter la distribution du code source de SnoopDos. Je n'ai pas particulièrement envie de le faire; j'ai acquis beaucoup de mes talents de programmeur en étudiant les sources d'autres personnes, sur des disques Fish ou autre part, et c'est agréable pouvoir payer mon dû à la communauté des programmeurs. Donc je demanderai à quiconque s'apprétant à faire ce genre de chose d'utiliser leur talent à de meilleures fins en écrivant leurs propres programmes. Je vous recommande également d'essayer de vous assurer que vous avez acquis votre copie de SnoopDos par l'intermédiaire d'une source sûre telle que Aminet ou les CDROM officiels de Fred Fish. Si vous avez une BBS, n'hésitez pas à me contacter avant de placer une nouvelle version sur votre serveur si vous avez le moindre soupçon sur son authenticité. Toutes les versions de SnoopDos à partir de la 3.0 sont signées avec ma clé publique PGP (voir @{" L'auteur " link Author} pour savoir comment l'obtenir). Vous pouvez vous servir de cette signature numérique pour vous assurer que votre copie n'a pas été modifiée. Même si vous ne possédez pas le programme PGP, une signature manquante est une bonne raison de croire que quelquechose ne va pas. Voir aussi : @{" Contenu " link Main} @{" Distribution " link Distribution} @{" Remerciements " link Credits} @{" L'auteur " link Author} @ENDNODE @NODE Credits @TITLE "Remerciements" REMERCIEMENTS Un projet tel que SnoopDos n'aurait pas été possible sans l'apport de beaucoup de gens. Un grand merci à tous les utilisateurs de SnoopDos 1.x qui ont envoyé d'utiles suggestions -- ce fut une source d'inspiration pour SnoopDos. Ecrire cette version de SnoopDos a été une bonne raison pour moi d'apprendre les fonctionalités des nouveaux Kickstarts 2.0 et 3.0. J'ai rencontré beaucoup de problèmes pendant le développement, et j'aimerais remercier les programmeurs suivants pour leurs conseils et suggestions très utiles : Ralph Babel, Christopher Feck, Mike Froggett, Ed Mackey, Udo K Schuermann et Mike Sinz. Bien qu'un projet de cette taille ait peu de chances de ne plus comporter d'erreurs, il y aurait encore un grand nombre de bogues sans l'aide de mon armée de béta-testeurs. Non seulement ils ont dû subir tous les types de plantages, mais ils ont aussi apporté beaucoup de suggestions et d'améliorations : Dean Ashton Derek Holdon Charles O'Reilly Timothy Aston Leon Hurst Jolyon Ralph Dan Barrett Paul Kelly (Ireland) Geoffrey Reeves Fred Botton Paul Kelly (England) Tommy Rolfs Charlie Chuck David Malone Toby Simpson Rick Costas Barry McConnell Paul Wakeford Jonathan Evans Markus Moenig Richard Waspe Tommy Gibbons Ian Moran Ian Wellock Jim Hawkins Niall Murphy Michael Witbrock Merci du fond du coeur à tous. Voir aussi : @{" Contenu " link Main} @{" Historique " link History} @{" Distribution " link Distribution} @{" L'auteur " link Author} @ENDNODE @NODE Author @TITLE "L'auteur de SnoopDos" COMMENT CONTACTER L'AUTEUR Je peux être contacté sur Internet : ecarroll@maths.tcd.ie ecarroll@cix.compulink.co.uk Si vous avez des bogues à signaler, des suggestions ou simplement des commentaires à formuler au sujet de SnoopDos, je serais heureux d'avoir votre opinion. Vous pouvez obtenir ma clé publique PGP en m'envoyant un message à l'adresse ecarroll@maths.tcd.ie avec "PGPKEY" dans la ligne de sujet. Si vous avez un accompte sur Bix ou Cix, vous pourrez la trouver dans mon résumé (nom d'utilisateur ecarroll). Le courrier écrit peut aussi m'être adressé à cette adresse : Eddy Carroll The Old Rectory Delgany Co. Wicklow Ireland Je regrette que, du fait du volume de courrier reçu, je ne puisse pas toujours répondre à chaque lettre. Le fait que je voyage assez fréquemment ne facilite pas les choses. Utilisez dans la mesure du possible le courrier électronique. Voir aussi : @{" Contenu " link Main} @{" Historique " link History} @{" Distribution " link Distribution} @{" Remerciements " link Credits} @ENDNODE @remark -------------------------------------------------------------- @remark @remark Début des références à la fenêtre @remark @remark -------------------------------------------------------------- @NODE MainWindow @TITLE "Fenêtre principale de SnoopDos" La fenêtre principale a cet aspect. Cliquez sur n'importe quellle case pour en avoir une description détaillée +-+-------------------------------------------------------------+ |X| SnoopDos 3.0 © Eddy Carroll, Août 1994. @{" Hotkey= " link HotKey} | +-+-------------------------------------------------------------+ | @{" Titres " link EventHeadings} # |---------------------------------------------------------------# | # | @{" Affichage " link EventOutput} # | # |---------------------------------------------------------------# | @{" Etat " link StatusLine } [ Visualise activité système.................] # | @{" Pause " link Pause} @{" Arrêter " link Disable} @{" Ouvrir Trace... " link MainOpenLog } @{" Préférences " link SettingsWindow} A | @{" Cacher " link Hide } @{" Quitter " link Quit } @{" Sauver Préfs. " link SaveDefSettings} @{" Fonctions " link FunctionWindow} V +=============================================================<>+ Les gadgets ci-dessus ne sont pas nécessairement affichés dans la fenêtre -- vous pouvez les supprimer par le menu des fenêtres ou grâce aux commandes @{" HideGadgets " link HideGadgets} et @{" HideStatus " link HideStatus}. Même cachés, ces gadgets peuvent être utilisés grâce aux raccourcis clavier. Tous les gadgets ont aussi des équivalents dans les menus. En plus des caractères soulignés dans les noms des gadgets, une série d'autres raccourcis sont aussi reconnus. Voir le chapitre @{" Raccourcis clavier " link MainKeys} pour plus de détails. Voir aussi : @{" Fenêtre des fonctions " link FunctionWindow} @{" Fenêtre des préférences " link SettingsWindow} @{" Cacher " link Hide} @{" Editeur de format " link FormatEditor} @{" Menu des options " link Menu_Index} @{" Voir " link Show} @ENDNODE @NODE EventHeadings @TITLE "Titres des évènements" TITRES DES EVENEMENTS Cette ligne en haut de la fenêtre affiche les titres de chacun des champs actifs. Bien que l'@{" Editeur de format " link FormatEditor} et la commande @{" Format " link Format} vous permettent de changer les titres, vous pouvez utiliser la souris pour effectuer de petits changements directement dans la fenêtre principale. Ceci est utile si vous voulez agrandir un peu un champ donné, comme par exemple le champ @{" Nom cible " link Format_TargetName}. Si vous cliquez sur un titre, il sera sélectionné en inverse, et deux marqueurs verticaux indiqueront les limites courantes du champ. De plus, une courte ligne verticale indique la position la plus à droite dans le format actuel (Ceci est utile lorsque vous essayez d'ajuster la largeur totale pour qu'elle soit la plus adaptée à la fenêtre actuelle). En laissant le bouton de la souris enfoncé, vous pouvez déplacer le titre vers la gauche ou la droite pour ajuster la position et la largeur de la colonne. Les autres titres se réajusteront en temps réel. Lorsque vous relâcherez le bouton de la souris, le contenu de la fenêtre des évènements sera réactualisé pour montrer le nouveau format. Si vous cliquez sur la zone vide à la droite d'un titre, vous pouvez ajuster sa largeur, tout en laissant sa position inchangée. Si le titre remplit la totalité de la colonne, vous pouvez cliquer sur le caractère le plus à droite pour obtenir le même résultat. Généralement, lorsque vous ajustez une colonne, les titres à droite de la colonne sélectionnée restent dans la même position. Ceci permet à la largeur totale du format de rester la même, la méthode utilisée étant de diminuer ou d'agrandir la largeur des autres colonnes pour compenser les changements effectués dans la colonne sélectionnée. Il est parfois plus pratique de pouvoir augmenter la taille totale du format -- si par exemple vous venez d'augmenter la largeur de la fenêtre principale. Ceci est possible en appuyant sur la touche SHIFT pendant que vous déplacez un titre. Tous les autres titres à droite de celui sélectionné seront déplacés de la même manière et en même temps. A tout moment pendant que vous déplacez une colonne, vous pouvez appuyer sur la barre d'espacement pour réactualiser le texte des évènements pour qu'il soit conforme au nouveau format. Ceci est un peu plus rapide qu'en relâchant la colonne et en cliquant dessus à nouveau, dans la mesure ou cela vous autorise à faire des ajustements tout en laissant le bouton de la souris enfoncé. Si vous changez d'avis pendant que vous déplacez une colonne, vous pouvez retrouver l'état précédent en appuyant sur la touche ESC, ou en cliquant sur le bouton droit de la souris. Une fois que le bouton gauche de la souris est relâché, les changements deviennent permanents. (Vous pourrez trouver l'option @{" Dernières sauvées " link Menu_Last_Saved} du menu des préférences utile dans ce cas.) Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Affichage " link EventOutput} @{" Editeur de format " link FormatEditor} @{" Format " link Format} @ENDNODE @NODE EventOutput @TITLE "Affichage" AFFICHAGE Une grande partie de la fenêtre principale est destinée à l'affichage des évènements. C'est ici que les informations sur les fonctions à visualiser sont affichées. Les détails affichés pour chaque fonction dépendent du @{" Format " link Format} de l'évènement en cours, mais inclueront en général au moins le Nom Cible et le champ Résultat. Du fait de la structure de SnoopDos, il est possible pour plusieurs programmes de lancer simultanément des fonctions qui seront visualisées. Lorsque ceci arrive, vous pourrez voir plusieurs évènements affichés sans texte dans le champ de @{" Résultat " link Format_Result}. Ceci est tout à fait normal. Ce champ de résultat sera rempli lorsque l'appel sera terminé. Certaines fonctions, qui prendront longtemps à s'effectuer, affichent "----" dans le champ de résultat, pour indiquer qu'elles sont en train de s'éxécuter. Il s'agit en autres des fonctions @{" Execute " link Execute}, @{" RunCommand " link RunCommand} et @{" System " link System}. Vous pouvez utiliser les flèches du clavier pour vous déplacer dans l'affichage des évènements. La flèche vers le haut revient en arrière, et la flèche vers le bas vers l'avant, alors que les flèches droite et gauche permettent de faire défiler la fenêtre horizontalement. Vous ne pouvez faire défiler la fenêtre horizontalement que si le format actuel des évènements est trop large pour la fenêtre. Pour vous déplacer de plus d'un caractère à la fois, appuyez en même temps sur SHIFT ou ALT. Vous pouvez mettre en valeur une ligne dans la fenêtre du buffer en cliquant dessus avec la souris. La ligne restera en vidéo inverse jusqu'à ce que vous relâchiez le bouton de la souris. Ceci est un moyen pratique de voir la correspondance entre le texte dans les colonnes Options et Résultat avec le texte dans les colonnes Nom Processus et Nom Cible. Lorsqu'une ligne est mise en valeur, vous pouvez déplacer la souris vers le haut et le bas pour en choisir d'autres. Si vous essayez de dépasser le haut ou le base de la fenêtre, le buffer défilera dans la direction adéquate. Notez qu'aucun affichage ne s'effectuera tant que vous maintiendrez une ligne en vidéo inverse. Si vous laissez une ligne allumée trop longtemps, il se peut que l'évènement que vous aviez mis en valeur disparaisse du buffer, et que de nouveaux évènements doit affichés à sa place -- si cela arrivait, la fenêtre sera automatiquement rafraîchie lorsque vous relâcherez le bouton. Si vous utilisez un utilitaire qui vous permet de cliquer pour ramener une fenêtre vers l'avant, vous pourrez trouver que le flash bref d'une colonne en train d'être mise en valeur est gênant. Vous pouvez éviter cela en configurant SnoopDos pour qu'il n'autorise la mise en valeur que lorsqu'une touche telle que SIFT, ALT ou CTRL est utilisée. Voir la commande @{" RowQualifier " link RowQualifier} pour plus de détails. Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Titres des évènements " link EventHeadings} @{" Editeur de format " link FormatEditor} @{" Format " link Format} @{" RowQualifier " link RowQualifier} @{" Montrer les gadgets " link ShowGadgets} @{" Montrer l'état " link ShowStatus} @{" Espacement du texte " link TextSpacing} @ENDNODE @NODE StatusLine @TITLE " Ligne d'état de SnoopDos" FENETRE PRINCIPALE / LIGNE D'ETAT La ligne d'état de SnoopDos peut afficher plusieurs types de messages, selon ce que SnoopDos est en train de faire. Voici un récapitulatif des informations qui peuvent apparaître sur la ligne d'état : · lorsqu'il y a arrêt, l'heure à laquelle il a été demandé · lorsqu'il y a pause, l'heure à laquelle elle a été demandée · lorsqu'il envoie la trace sur un fichier disque, le nom de fichier · lorsqu'il envoie la trace vers un device, le nom de ce device · lorsqu'il charge un fichier de préférences, le nom de ce fichier · lorsqu'il sauve un fichier de préférences, le nom de ce fichier Si rien de tout ceci ne se passe, SnoopDos indiquera simplement qu'il est en train de scruter l'activité du système. Les information affichées dans la ligne d'état sont suffisantes pour vous permettre d'ôter les gadgets de la fenêtre principale si vous le désirez. Ceci vous laisse plus de place pour le texte des évènements. Voir aussi : @{" Cacher gadgets " link HideGadgets} @{" Cacher état " link HideStatus} @{" Fenêtre principale " link MainWindow} @{" Montrer gadgets " link ShowGadgets} @{" Montrer état " link SHowStatus} @ENDNODE @NODE MainOpenLog @TITLE "Gadget d'ouverture de la trace" FENETRE PRINCIPALE / OUVRIR LA TRACE Le gadget "Ouvrir Trace..." dans la fenêtre principale est utilisé pour créer un nouveau fichier trace. En fait, l'intitulé du gadget va dépendre de la préférence @{" Mode trace " link LogMode}. Vous pouvez la modifier dans la fenêtre des @{" Préférences " link SettingsWindow}. Les quatre modes disponibles sont : @{" Ouvrir Trace... " link OpenLog } Demande un nouveau nom de fichier par fenêtre de requête ASL. @{" Débuter Trace " link OpenLog } Ouvre un nouveau fichier trace défini par @{" Nom Trace " link LogName} @{" Ajouter Trace " link AppendLog } Ajoute au fichier défini par @{" Nom Trace " link LogName} @{" Trace Série " link OpenSerialLog} Dirige la sortie vers le port Série Lorsqu'un fichier trace est ouvert, l'intitulé du gadget devient @{" Fermer Trace " link CloseLog}. Vous pouvez toujours ouvrir un nouveau fichier trace par une requête ASL en choisissant l'option @{" Ouvrir Trace " link Menu_Open_log} dans le menu Projet, quelquesoit l'intitulé actuel du gadget. Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Ajouter Trace " link AppendLog} @{" Ouvrir Trace " link OpenLog} @{" Ouvrir Trace Série " link OpenSerialLog} @ENDNODE @NODE MainKeys @TITLE "Les commandes clavier" FENETRE PRINCIPALE / COMMANDES CLAVIER Les raccourcis clavier suivants sont reconnus dans la fenêtre principale : Flèche gauche Fait défiler vers la gauche, d'une ou plusieurs colonnes, le contenu de la fenêtre Flèche droite Fait défiler vers la gauche, d'une ou plusieurs colonnes, le contenu de la fenêtre Flèche haut Fait défiler vers le haut (en arrière), d'une ou plusieurs colonnes, le contenu de la fenêtre Flèche bas Fait défiler vers le bas (en avant), d'une ou plusieurs colonnes, le contenu de la fenêtre RETURN Fait défiler d'une ligne en avant le contenu de la fenêtre TABULATION Effectue une @{" Pause " link Pause} (si nécessaire) et un ordre @{" SingleStep " link SingleStep} BARRE D'ESPACE Envoie un ordre @{" SingleStep " link SingleStep} si SnoopDos est en pause SHIFT-TAB Annule l'ordre @{" Pause " link Pause} ou @{" Disable " link Disable} selon le cas M Ouvre l'@{" Editeur de Format " link FormatEditor} (comme le raccourci clavier) BARRE D'ESPACE Redessine le texte des évènements pendant l'ajustement des @{" Titres des évènements " link EventHeadings} ESC Annule tout déplacement de colonne en cours CTRL-C Sélectionne le gadget @{" Quitter " link Quit} CTRL-D Active le gadget @{" Arrêter " link Disable} CTRL-E Déactive le gadget @{" Arrêter " link Enable} CTRL-F Ramène la fenêtre principale devant les autres La plupart des gadgets ont également un raccourci clavier, indiqué par une lettre soulignée dans le nom du gadget. Si vous appuyez sur la touche raccourci clavier d'un gadget, le résultat ne sera effectif que lorsque vous aurez relâché la touche. Si vous changez d'avis après avoir appuyé sur une touche (cette touche étant toujours maintenue enfoncée), vous pouvez appuyer sur ESC pour tout annuler. Pour la plupart des gadgets, appuyer simultanément sur SHIFT pendant que vous appuyez sur la touche raccourci a un effet légèrement différent. Par exemple, appuyer sur SHIFT pendant que vous appuyez sur la touche raccourci pour le gadget Préférences dans la fenêtre principale fermera la fenêtre Préférences au lieu de l'ouvrir. Voir aussi : @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE SettingsWindow @TITLE "Fenêtre des préférences" La fenêtre des préférences vous permet de contrôler les préférences générales qui régissent la manière dont SnoopDos fonctionne. Cliquez sur n'importe quelle case pour une description détaillée. +-----------------------------------------------+ | Les préférences de SnoopDos ..................| +-----------------------------------------------+ | @{" Pour cacher " link HideMethod} @{" Hotkey " link HotKey } | | @{" Type d'écran " link ScreenType} @{" Nom écran " link ScreenName} | | @{" Mode Trace " link LogMode } @{" Fichier Trace " link LogName } | | @{" E/S " link FileIOType} @{" Police fenêtre " link WindowFont} | | @{" Buffer scroll " link BufferSize} @{" Police buffer " link BufferFont} | | | | @{" Format buffer " link Format } @{" Editer " link FormatEditor} | | @{" Format Trace " link LogFormat } @{" Copier " link SettingsCopy} | | | | @{" Utiliser " link SettingsButtons} @{" Défaire " link SettingsButtons} @{" Annuler " link SettingsButtons} | +-----------------------------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Fenêtre des fonctions " link FunctionWindow} @{" Editeur de format " link FormatEditor} @{" OpenSetup " link OpenSetup} @{" SetupWindowPos " link SetupWindowPos} @ENDNODE @NODE SettingsCopy @TITLE "Gadget de copie de la fenêtre de préférences" FENETRE DE PREFERENCES / GADGET DE COPIE Ce gadget copie la chaine @{" Format " link Format} courante dans le @{" Format Trace " link LogFormat}. Généralement, le format utilisé pour envoyer les évènements visualisés vers le fichier de trace est le même que celui utilisé pour afficher les informations à l'écran dans la fenêtre principale. Vous pouvez toutefois choisir un format différent si vous le désirez. Ceci vous permet de personaliser le format de votre fichier de trace en utilisant l'éditeur de format et la fenêtre principale. Lorsque vous êtes satisfait du format de vous avez choisi, vous pouvez le copier dans la zone Format fichier trace, puis retrouver le format originel en cliquant Défaire dans l'éditeur de format. Si vous appuyez sur la touche SHIFT en sélectionnant ce gadget, vous effacerez le format du fichier trace. Lorsque le format du fichier trace est vide, cela indique que le format du buffer actuel sera utilisé pour le fichier de trace. Voir aussi : @{" Fenêtre des préférences " link SettingsWindow} @{" Editeur de format " link FormatEditor} @{" Format " link Format} @{" LogFormat " link LogFormat} @{" WindowWidth " link WindowWidth} @ENDNODE @NODE SettingsButtons @TITLE "Gadgets de la fenêtre de préférences" FENETRE DE PREFERENCES / GADGETS Les gadgets Utiliser, Défaire et Annuler dans la fenêtre des @{" Préférences " link SettingsWindow} sont utilisés pour contrôler si les préférences doivent être rendues permanentes ou non. Lorsque vous modifiez un gadget dans la fenêtre de préférences, le changement est immédiat. Par exemple, si vous choisisez une nouvelle @{" HotKey " link HotKey}, vous verrez le titre de la fenêtre principale se modifier pour s'adapter au changement. Choisir Utiliser ferme la fenêtre de préférences et rend les changements permanents. Si vous voulez fermer cette fenêtre en conservant les modifications faites, utilisez ce gadget. Choisir Défaire va remettre toutes les options telles qu'elles étaient lorsque vous avez ouvert la fenêtre de préférences. Ceci vous permet d'annuler tout changement accidentel que vous auriez pu effectuer. Choisir Annuler va remettre les préférences originelles, et refermer la fenêtre de préférence. Tous les changements ayant été effectués depuis que la fenêtre a été ouverte seront abandonnés. Il y a deux exceptions au fait que tous les changements effectués dans la fenêtre de préférences sont en temps réel. Le premier est le gadget @{" Taille buffer " link BufferSize}, qui contrôle la taille du buffer des évènements. Du fait que changer la taille du buffer fait perdre le contenu du buffer, le changement ne prend effet qu'après avoir sélectionné le gadget Utiliser. Ceci vous permet de changer d'avis si vous pensez avoir fait une erreur. La deuxième exception est le gadget @{" Format trace " link LogFormat}. Si le fichier trace est ouvert pendant que vous le modifiez, le changement ne sera effectif que lorsque vous l'aurez fermé. Ceci évite de produire un fichier trace brouillon qui comporte plusieurs types de formats différents. Voir aussi : @{" Fenêtre de préférences " link SettingsWindow} @ENDNODE @NODE FunctionWindow @TITLE "Fenêtre des fonctions" La fenêtre des fonctions de SnoopDos vous permet de choisir quels évènements seront surveillés. Cliquez sur une case pour une description détaillée. +---------------------------------------------------------------------+ | Les fonctions de SnoopDos ..........................................| +---------------------------------------------------------------------+ | Fonctions système Fonctions DOS | | | | @{" Fonctions système " link SelectGadgets } @{" FindPort " link FindPort } @{" ChangeDir " link ChangeDir } | | @{" Fonctions AmigaDOS " link SelectGadgets } @{" FindResident " link FindResident } @{" Delete " link Delete } | | @{" FindSemaphore " link FindSemaphore} @{" Execute " link Execute } | | @{" Ne montrer que les échecs " link OnlyShowFails } @{" FindTask " link FindTask } @{" GetVar " link GetVar } | | @{" Montrer le n° du CLI " link ShowCLI } @{" LockScreen " link LockScreen } @{" LoadSeg " link LadSeg } | | @{" Montrer chemins en entier " link ShowFullPaths } @{" OpenDevice " link OpenDevice } @{" Lock " link Lock } | | @{" Utiliser noms devices " link UseDeviceNames } @{" OpenFont " link OpenFont } @{" MakeDir " link MakeDir } | | @{" Voir les paquets " link MonitorPackets } @{" OpenLibrary " link OpenLibrary } @{" MakeLink " link MakeLink } | | @{" Débogueur des paquets " link PacketDebugger } @{" OpenResource " link OpenResource } @{" Open " link Open } | | @{" Voir les appels ROM " link MonitorROMCalls} @{" ReadToolTypes " link ReadToolTypes} @{" Rename " link Rename } | | @{" Ignorer Workbench/Shell " link IgnoreShell } @{" SendRexx " link SendRexx } @{" RunCommand " link RunCommand} | | @{" SetVar " link SetVar } | | @{" Critère " link MatchName} [...............................] @{" System " link System } | | | | @{" Utiliser " link FunctionButtons} @{" Défaire " link FunctionButtons} @{" Annuler " link FunctionButtons} | +---------------------------------------------------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Fenêtre de préférences " link SettingsWindow} @{" Editeur de format " link FormatEditor} @{" OpenFunctions " link OpenFunction} @{" FunctionWindowPos " link FunctionWindowPos} @ENDNODE @NODE SelectGadgets @TITLE "Gadgets de sélection des fonctions de SnoopDos" FENETRE DES FONCTIONS / GADGETS SYSTEME ET DOS Ces gadgets vous permettent de sélectionner rapidement, ou de déselectionner toutes les fonctions affichées dans la colonne Système ou AmigaDos de la fenêtre de @{" Fonctions " link FunctionWindow}. Il y a trois états possibles. COCHES est le mode habituel, et indique qu'un certain nombre de fonctions déterminées sont choisies. TOUT et AUCUN indiquent respectivement que toutes ou aucune fonction dans les colonnes sont en train d'être surveillées. Les gadgets de choix pour chaque fonction seront modifiés si besoin est. Tant que vous ne cliquez dans aucune des cases, SnoopDos va se souvenir des dernières cases cochées, et vous pourrez ainsi retrouver cette configuration en cliquant jusqu'à ce que le gadget indique à nouveau COCHES. De toutes façons, si vous cliquez sur la case d'une fonction alors que l'état indique TOUT ou AUCUN, cet état sera automatiquement basculé sur COCHES, et SnoopDos ne sera plus en mesure de retrouver la configuration originelle. Il est plus difficile d'expliquer cela que de le comprendre. Essayez les différents gadgets et tout deviendra évident. Vous pouvez utiliser la commande @{" Functions " link Functions} pour gérer les fonctions depuis un script. Voir aussi : @{" Fenêtre des fonctions " link FunctionWindow} @{" Functions " link Functions} @ENDNODE @NODE FunctionButtons @TITLE "Gadgets de la fenêtre des fonctions" FENETRE DES FONCTIONS / GADGETS Les gadgets Utiliser, Défaire et Annuler de la fenêtre des @{" Fonctions " link FunctionWindow} sont utilisés pour contrôler si les changements doivent être rendus permanents. Lorsque vous changez un gadget de fonctions dans la fenêtre, le changement est immédiat. Sélectionner Utiliser fermera la fenêtre et rendra les changements permanents. Si vous voulez fermer la fenêtre tout en conservant les préférences des fonctions actuelles, choisissez cette option. Choisir Défaire remettra les préférences de toutes les fonctions dans l'état où elles étaient avant que vous ayez ouvert la fenêtre. Ceci vous permet de ne pas tenir compte des changements accidentels que vous auriez pu effectuer. Choisir Annuler remettra les préférences originelles, et fermera la fenêtre. Ceci fera en sorte qu'aucun des changements effectués ne soit pris en compte. Voir aussi : @{" Fenêtre des fonctions " link FunctionWindow} @ENDNODE @NODE FormatEditor @TITLE "Editeur de format" L'éditeur de format vos permet de choisir quels types d'informations seront affichés dans la fenêtre principale pour chaque évènement visualisé. Cliquez sur une case pour une description plus détaillée. +--------------------------------------------------+ | Editeur de format SnoopDos.......................| +--------------------------------------------------+ | Champs dispos. Format actuel | | +----------------------+ +---------------------+ | | | @{" AdrAppel %c " link Format_CallAddr } | | @{" Cpt %05u " link Format_Count } | | | | @{" Date %d " link Format_Date } | | @{" Nom Proc. %18p " link Format_ProcessName} | | | | @{" Hunk:Offset %h " link Format_HunkOffset } | | @{" Action %10a " link Format_Action } | | | | @{" N°Tâche %i " link Format_TaskID } | | @{" Nom Cible %27n " link Format_TargetName } | | | | @{" Nom Segment %s " link Format_SegmentName} | | @{" Options %07o " link Format_Options } | | | | @{" Heure %t " link Format_Time } | | @{" Rés. %04r " link Format_Result } | | | | | | | | | +----------------------+ +---------------------+ | | | | @{" Largeur champ " link Format_FieldWidth} [=====||=================] 10 | | | | @{" Utiliser " link FormatButtons} @{" Défaire " link FormatButtons} @{" Annuler " link FormatButtons} | +--------------------------------------------------+ Le format actuel est affiché dans la boîte la plus à droite, alors que les autres champs non-utilisés sont affichés dans la boîte de gauche. Vous pouvez utiliser la souris pour déplacer les champs depuis leur position vers une nouvelle position. Lorsque vous faites ceci, vous verrez la fenêtre principale reflèter immédiatement vos modifications. Vous pouvez aussi utiliser les touches curseurs du clavier pour éditer le format. Les flèches vers le haut et vers le bas sélectionnent un champ à éditer dans le format courant, et les flèches vers la gauche et la droite permettent d'ajuster la largeur du champ. Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Fenêtre des préférences " link SettingsWindow} @{" Fenêtre des fonctions " link FunctionWindow} @{" Format " link Format} @{" OpenFormat " link OpenFormat} @{" FormatWindowPos " link FormatWindowPos} @ENDNODE @NODE Format_FieldWidth "Gadget de largeur format" EDITEUR DE FORMAT / GADGET DE LARGEUR DE CHAMP Le gadget de largeur de format vous permet d'ajuster la largeur du champ sélectionné. Dès que vous relâchez le gadget, la fenêtre principale sera mise à jour pour refléter la nouvelle largeur de champ demandée. La largeur de chaque champ est affichée à la droite de nom du champ (entre le '%' et la lettre d'identification du format). Seuls les champs dans le format courant peuvent voir leur largeur ajustée. Si il n'y a aucun champ sélectionné, le gadget ne sera pas disponible. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale" link MainWindow} @{" Format " link Format} @ENDNODE @NODE FormatButtons @TITLE "Gadgets de l'éditeur de format" EDITEUR DE FORMAT / GADGETS Les gadgets Utiliser, Défaire et Annuler de l'éditeur sont utilisés pour contrôler si le format courant doit être déclaré permanent. Lorsque vous faites des changements dans l'éditeur de format, vous pouvez immédiatement voir les effets de ces changements. Choisir Utiliser fermera l'éditeur de format et rendra ces changements permanents. Si vous voulez fermer la fenêtre et garder les préférences actuelles, c'est cette option qu'il faut choisir. Choisir Défaire va reprendre le format qui était utilisé quand vous avez ouvert l'éditeur de format. Ceci vous permettra d'éviter tout changement accidentel que vous auriez pu faire. Choisir Annuler va restaurer le format originel, et fermer l'éditeur de format. Ceci annulera tous les changements qui ont été faits au format depuis que l'éditeur a été ouvert (y compris les changements faits dans la fenêtre principale). Voir aussi : @{" Editeur de format " link FormatEditor} @{" Format " link Format} @{" Titres des évènements " link EventHeadings} @ENDNODE @NODE Format_Action "Champ de l'action" %A -- ACTION Le champ de l'action est l'une des plus importantes parties de tout évènement. Il montre quelle action un programme essaie d'effectuer. Les actions possibles correspondent à peu près aux fonctions listées dans la fenêtre des @{" Fonctions " link FunctionWindow}, mais vous pourrez parfois voir d'autres actions listées. En particulier, si la commande @{" PacketDebugger " link PacketDebugger} est utilisée, vous verrez beaucoup d'actions de la forme #XXXXXX (comme #FINDOUTPUT et #COPY_DIR). Ce sont des paquets bruts AmigaDos, qui n'intéressent que les programmeurs. Toute action précédée par une astérisque correspond aux opérations effectuées par paquets d'E/S directs, plutôt que par des appels aux fonctions de la dos.library. Vous ne les verrez que si vous avez autorisé l'option @{" Voir paquets " link MonitorPackets}. Généralement, de tels appels ne sont générés que par des programmes compilés avec le GNU C. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_CallAddr "Champ d'adresse de l'appel" %C -- Adresse de l'appel Ce champ affiche l'adresse mémoire d'où une fonction surveillée à été appelée. Dans l'absolu, ceci est sans signification. Mais si vous êtes programmeur, vous pouvez utiliser cette information pour localiser la partie du programme qui a fait cet appel, et voir ce qu'elle essaiera de faire ensuite. Cette adresse est affichée sous forme d'un nombre hexadécimal à 7 digits, car même s'il en existe, très peu d'Amigas ont une mémoire au-dessus de $0FFFFFFF. Si votre Amiga est l'exception qui confirme la règle, faites en sorte que ce champ soit d'une largeur de 8 caractères pour pouvoir afficher des adresses plus hautes. Veuillez aussi remarquer que la valeur représente en fait l'adresse de la première instruction après l'appel de la fonction surveillée. Si vous voulez voir l'instruction qui a fait l'appel, il faut soustraire 6 à cette valeur. Si une autre programme a modifié une fonction après SnoopDos, SnoopDos sera généralement incapable de déterminer l'adresse correcte de retour -- l'adresse du code du second programme sera affichée à la place. Si cela posait un problème, il faudrait ne pas autoriser la surveillance de la fonction en question, jusqu'à ce que le second programme ait été lancé. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_Date "Champ date" %D -- DATE Ce champ affiche la date à laquelle un évènement survient, dans la forme standard de l'AmigaDos JJ-MMM-AA. Vous ne trouverez cette fonction utile que si vous désirez éxécuter SnoopDos plusieurs jours durant. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @{" Champ heure " link Format_Time} @ENDNODE @NODE Format_HunkOffset "Champ Hunk:Offset" %H -- HUNK:OFFSET Ce champ est seulement utile aux programmeurs, et uniquement lorsque @{" SegTracker " link SegTracker} est chargé. Il affiche le hunk et l'offset depuis lesquels la fonction a été appelée, dans le format HH:OOOOOO. (Le hunk et l'offset sont donnés sous forme hexadécimale). Vous pouvez utiliser cette information en conjonction avec le champ @{" Nom segment " link Format_SegmentName} et l'utilitaire @{" FindHit " link SegTracker} pour identifier quelle ligne dans le code source d'un programme est responsable de l'appel à cette fonction. Ceci pourra être d'une valeur inestimable pendant le déboguage de votre programme. Si SegTracker n'est pas chargé, ou s'il ne peut identifier depuis quel module la fonction est appelée, alors ce champ sera généralement laissé vide. Cependant, si la fonction a été appelée depuis la ROM, l'offset depuis la base de la ROM sera affiché à la place. Les même remarques formulées au sujet du champ @{" Adr Appel " link Format_CallAddr} en ce qui concerne les fonctions modifiées après que SnoopDos ait été lancé sont valables ici. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_TaskID "Champ Numéro de tâche" %I -- N°Tâche Ce champ affiche l'adresse de la tâche d'un programme qui a appelé la fonction surveillée. Cette adresse est affichée sous forme d'un nombre hexadécimal à 7 digits. Si votre Amiga avait de la mémoire au-delà de $0FFFFFFF, vous devriez élargir le champ pour que les 8 digits soient affichés. Ce champ peut être utile pour identifier le processus qui a appelé la fonction si plusieurs processus tournent en même temps sur votre système, avec le même nom. Vous pouvez utiliser un utilitaire tel que ARTM ou XOper pour en savoir plus sur un processus, identifié par son adresse. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_TargetName "Champ Nom cible" %N -- NOM CIBLE Ce champ affiche l'information la plus importante associée à la fonction surveillée. Cela variera d'une fonction à l'autre, mais sera en général le nom de la ressource système ou du fichier disque sollicité. Ce champ est inhabituel dans le sens où il peut être aligné à gauche ou à droite -- tous les autres champs sont toujours alignés à gauche. Voir les commandes @{" LeftAligned " link LeftAligned} et @{" RightAligned " link RightAligned} pour plus de détails. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_Options "Champ des options" %O -- OPTIONS Ce champ affiche toutes options supplémentaires associées avec ce qui est affiché dans le champ @{" Nom Cible " link Format_TargetName}. Cela variera d'une fonction à une autre. Par exemple, avec la fonction Open(), cela affichera si le fichier est ouvert en lecture ou écriture. Avec la fonction RunCommand(), il affichera la taille de la pile de la commande éxécutée. Si une fonction particulière n'a pas d'options secondaires, ce champ restera vide. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_ProcessName "Champ Nom de processus" %P -- NOM PROCESSUS Ce champ affiche le nom du processus qui appelle la fonction surveillée. Notez que, bien que ceci indique le programme qui est responsable de l'appel, le programme affiché peut ne pas avoir fait l'appel directement. Par exemple, il peut avoir appelé une fonction dans un bibliothèque externe, et il se peut que cette bibliothèque ait fait l'appel à la place du programme. Si cette distinction est importante, vous pouvez utiliser le champ @{" Segment Name " link Format_SegmentName} pour obtenir des informations plus précises. Parfois, vous pourrez vous apercevoir que vous avez plusieurs processus qui tournent en même temps sous le même nom. Dans ce cas, vous pouvez utiliser le champ @{" N°Tâche " link Format_TaskID} pour les distinguer. D'un autre côté, si ces processus ont tous été lancés depuis le CLI plutôt que du Workbench, vous pouvez utiliser la commande @{" ShowCLI " link ShowCLI} pour montrer le numéro de CLI de chaque processus en crochets au début de chaque nom. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_Result "Champ résultat" %R -- RESULTAT Ce champ affiche le résultat de chaque appel de fonction. Celui-ci sera généralement soit OK, soit Fail, selon le cas. Certaines fonctions se comportent légèrement différemment. Dans le cas des fonctions @{" Execute " link Execute}, @{" RunCommand " link RunCommand} et @{" System " link System}, ce champ affichera toujours Fail dans le cas d'une fonction ayant échoué, mais retournera le code numérique de retour si la fonction a réussi. Du fait que ces fonctions prennent généralement du temps à s'éxécuter, le résultat sera affiché sous la forme "----" pendant que la fonction s'éxécute. Si vous faites une @{" Pause " link Pause}, chaque tâche qui appelle une fonction surveillée sera mise en veille. Lorsque cela arrive, le champ de résultat affiche "WAIT" pour indiquer que la tâche n'est plus active. Ceci sera remplacé par le code de retour approprié lorsque l'éxécution aura repris. Si vous avez autorisé la commande @{" PacketDebugger " link PacketDebugger}, ce champ ne comportera pas que Ok ou Fail, mais aussi la ou les valeurs retournées par le device dos en train d'être surveillé. Pour voir ces informations supplémentaires, vous aurez besoin de rendre le champ plus large que les 4 caractères par défaut. Si vous vous utilisez le débogueur de paquets ou l'option @{" Voir paquets " link MonitorPackets}, vous pourrez parfois avoir un code de résultat "Missed". Ceci indique tout simplement que SnoopDos n'a pas pu déterminer le code résultat d'une opération sur un paquet donné, très certainement parce que vous avez arrêté la surveillance des paquets pendant que l'opération était encore en cours. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_SegmentName "Champ Nom segment" %S -- NOM SEGMENT Ce champ n'est utile que lorsque @{" SegTracker " link SegTracker} est chargé. Il affiche le nom du module qui a appelé la fonction courante. Il est généralement utilisé de pair avec le champ @{" Hunk:Offset " link Format_HunkOffset}. Le nom de segment sera souvent, mais pas tout le temps, le même que le nom du processus. Ils peuvent différer si le programme appelle un module extérieur comme une fonction ROM ou une fonction dans une bibliothèque externe. Si cette fonction appelle alors une des fonctions surveillées par SnoopDos, elle sera identifée indépendemment du processus originel. Ceci est utile si vous essayez de savoir quelle partie de votre système est responsable d'une opération donnée. Si SegTracker n'est pas chargé, SnoopDos pourra quand même identifier les appels faits depuis des modules ROM résidents. Dans ce cas, le nom du module en ROM sera affiché. Du fait qu'identifier le module appelant prend du temps, SnoopDos ne fera de recherche que lorsqu'il aura reçu l'ordre d'afficher le nom du segment à l'écran ou dans le fichier trace. Ceci veut dire que, si vous n'avez pas besoin de connaitre le nom du segment, SnoopDos ne sera pas ralenti inutilement. Toutefois, cela peut avoir un effet indésirable qui pourra surprendre qui ne s'y attend pas. Si le module qui a effectué l'appel de la fonction est déchargé de la mémoire avant que SnoopDos ait eu la chance d'en afficher les détails, le nom du module et le hunk:offset ne pourront être calculés; un message 'Module non trouvé" sera affiché dans ce cas. Cela a de grandes chances d'arriver si SnoopDos est caché (puisqu'il n'affichera rien jusqu'à ce que la fenêtre soit ré-ouverte), mais cela peut aussi arriver si un programme s'arrête brutalement alors qu'il est surveillé. Pour éviter cela, vous pouvez prendre quelques précautions simples. Assurez vous que vous avez ajouté le champ Nom segment à votre format de sortie avant que vous ne lanciez la surveillance. Augmentez la priorité de SnoopDos en utilisant l'option @{" Task priority " link Menu_Task_priority} dans les menus de façon à ce qu'elle soit plus haute que celle du processus que vous surveillez. Ceci permet à SnoopDos d'appeller SegTracker avant que le module ait la chance de s'auto-éffacer de la mémoire. Dernière précaution : si vous avez l'intention de laisser SnoopDos s'éxécuter en arrière-plan, laisser le fichier trace ouvert, même si c'est vers NIL:. Cela fera en sorte que SnoopDos recherche les noms des segments le plus tôt possible. Si la fenêtre principale est ouverte, ceci ne sera pas nécessaire. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_Time "Champ heure" %T -- HEURE Ce champ est un moyen simple de dater chaque fonction que SnoopDos surveille. C'est tout particulièrement utile si vous laissez SnoopDos tourner longtemps sans le consulter. L'heure est affichée au format HH:MM:SS. Si vous n'êtes intéressé que par les heures et les minutes, vous pouvez réduire la largeur du champ de 8 à 5 caractères. Si SnoopDos devait être utilisé pendant plusieurs jours de suite, vous pourriez utiliser aussi le champ @{" Date " link Format_Date}. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE Format_Count "Champ compteur" %U -- COMPTEUR Ce champ donne tout simplement un nombre séquentiel unique qui identifie la position d'un évènement dans le buffer. Les évènements commencent à 1 et chaque évènement incrémente le compteur. Si vous stockez les évènements dans un fichier, ce champ est tout particulièrement utile puisqu'il représente un moyen pratique de voir la correspondance entre des évènements partiellement terminés, dont le message de fin d'éxécution apparait plus loin dans le fichier. Voir la commande @{" OpenLog " link OpenLog} pour plus de détails. Voir aussi : @{" Editeur de format " link FormatEditor} @{" Fenêtre principale " link MainWindow} @{" Format " link Format} @ENDNODE @NODE SegTracker "SegTracker et FindHit" SEGTRACKER ET FINDHIT SegTracker et FindHit sont deux utilitaires très utiles écrits par Mike Sinz qui font partie du package Enforcer. SegTracker garde une trace de la mémoire occupée par tout module chargé depuis un disque, alors que FindHit autorise le suivi d'un module pour en retrouver le numéro de ligne dans un programme source. Pour de meilleurs résultats, SegTracker doit être lancé immédiatement après SetPatch dans votre startup-sequence. Ceci lui permet de tracer autant de programmes que possible. Lancer SegTracker après SnoopDos est possible, mais celui-ci ne sera pas capable d'identifier les programmes qui étaient déjà en train de tourner à ce moment. Vous pouvez généralement trouver la dernière version d'Enforcer sur Aminet dans le répertoire /pub/aminet/dev/debug Voir aussi : @{" Hunk:Offset " link Format_HunkOffset} @{" Nom segment " link Format_SegmentName} @ENDNODE @remark -------------------------------------------------------------- @remark @remark Début des références aux commandes @remark @remark -------------------------------------------------------------- @NODE CommandIndex @TITLE "Index des commandes de SnoopDos" SnoopDos supporte plus de 100 commandes qui sont accessibles en tant qu'arguments de la ligne de commande, tooltypes du Workbench, fichiers de préférences ou ARexx. Voir le chapitre @{" Syntaxe des commandes " link CommandSyntax} pour des informations plus générales, ou cliquez sur l'une des commandes de la liste ci-dessous pour plus de détails. @{" AddLog " link AddLog } @{" HideGadgets " link HideGadgets } @{" Pause " link Pause} @{" AppendLog " link AppendLog } @{" HideMethod " link HideMethod } @{" Quit " link Quit} @{" AutoOpen " link AutoOpen } @{" HideStatus " link HideStatus } @{" ReadToolTypes " link ReadToolTypes} @{" BufferFont " link BufferFont } @{" HotKey " link HotKey } @{" Rename " link Rename} @{" BufferSize " link BufferSize } @{" IconPos " link IconPos } @{" RightAligned " link RightAligned} @{" ChangeDir " link ChangeDir } @{" IgnoreShell " link IgnoreShell } @{" RowQualifier " link RowQualifier} @{" ClearBuffer " link ClearBuffer } @{" Language " link Language } @{" RunCommand " link RunCommand} @{" CloseFormat " link CloseFormat } @{" LeftAligned " link LeftAligned } @{" SaveBuffer " link SaveBuffer} @{" CloseFunction " link CloseFunction } @{" LoadDefSettings " link LoadDefSettings } @{" SaveDefSettings " link SaveDefSettings} @{" CloseLog " link CloseLog } @{" LoadSeg " link LoadSeg } @{" SaveSettings " link SaveSettings} @{" CloseSetup " link CloseSetup } @{" LoadSettings " link LoadSettings } @{" SaveWindow " link SaveWindow} @{" CopyBuffer " link CopyBuffer } @{" Lock " link Lock } @{" ScreenName " link ScreenName} @{" CopyWindow " link CopyWindow } @{" LockScreen " link LockScreen } @{" ScreenType " link ScreenType} @{" CreateIcons " link CreateIcons } @{" LogFormat " link LogFormat } @{" ScrollDown " link ScrollDown} @{" CX_PopKey " link HotKey } @{" LogMode " link LogMode } @{" ScrollUp " link ScrollUp} @{" CX_Popup " link CX_Popup } @{" LogName " link LogName } @{" SendRexx " link SendRexx} @{" CX_Priority " link CX_Priority } @{" MainWindowPos " link MainWindowPos } @{" Settings " link Settings} @{" Delete " link Delete } @{" MainWindowSize " link MainWindowSize } @{" SetupWindowPos " link SetupWindowPos} @{" Disable " link Disable } @{" MakeDir " link MakeDir } @{" SetVar " link SetVar} @{" DisableWhenHidden " link DisableWhenHidden } @{" MakeLink " link MakeLink } @{" Show " link Show} @{" Enable " link Enable } @{" MatchName " link MatchName } @{" ShowCLI " link ShowCLI} @{" Execute " link Execute } @{" MonitorPackets " link MonitorPackets } @{" ShowFullPaths " link ShowFullPaths} @{" FlushLog " link FlushLog } @{" MonitorROMCalls " link MonitorROMCalls } @{" ShowGadgets " link ShowGadgets} @{" FileIOType " link FileIOType } @{" OnlyShowFails " link OnlyShowFails } @{" ShowStatus " link ShowStatus} @{" FindPort " link FindPort } @{" Open " link Open } @{" SingleStep " link SingleStep} @{" FindResident " link FindResident } @{" OpenDevice " link OpenDevice } @{" SimpleRefresh " link SimpleRefresh} @{" FindSemaphore " link FindSemaphore } @{" OpenFont " link OpenFont } @{" SmartRefresh " link SmartRefresh} @{" FindTask " link FindTask } @{" OpenFormat " link OpenFormat } @{" StackLimit " link StackLimit} @{" Format " link Format } @{" OpenFunction " link OpenFunction } @{" System " link System} @{" FormatWindowPos " link FormatWindowPos } @{" OpenLibrary " link OpenLibrary } @{" TaskPri " link TaskPri} @{" Functions " link Functions } @{" OpenLog " link OpenLog } @{" TextSpacing " link TextSpacing} @{" FunctionWindowPos " link FunctionWindowPos } @{" OpenResource " link OpenResource } @{" Unpause " link Unpause} @{" GetVar " link GetVar } @{" OpenSerialLog " link OpenSerialLog } @{" UseDeviceNames " link UseDeviceNames} @{" GotoLine " link GotoLine } @{" OpenSetup " link OpenSetup } @{" WindowFont " link WindowFont} @{" Help " link Help } @{" PacketDebugger " link PacketDebugger } @{" WindowWidth " link WindowWidth} @{" Hide " link Hide } @{" PatchRamLib " link PatchRamLib } @ENDNODE @NODE CommandSyntax @TITLE "Syntax des commandes de SnoopDos" SYNTAXE DES COMMANDES DE SNOOPDOS SnoopDos comprend plus de 100 commandes. Ces commandes peuvent être éxécutées depuis le CLI, depuis le Workbench comme tooltypes, comme commandes ARexx ou dans les fichiers de préférences de SnoopDos; dans tous les cas, la syntaxe reste la même. Il y a deux catégories générales de commandes : celles qui acceptent un paramètre et celles qui n'en acceptent pas. Vous pouvez obtenir un sommaire rapide des commandes en tapant SNOOPDOS HELP dans une fenêtre CLI -- ceci va lister toutes les commandes supportées, et celles qui requièrent un paramètre seront marquées d'une "*". Si une commande supporte un paramètre, vous pouvez spécifier le paramètre des manières suivantes. Utilisons la commande HideMethod comme exemple (notez que toutes les commandes et leurs paramètres ne tienne pas compte du fait qu'elles soient en majuscules ou minuscules) : HideMethod=Iconify HideMethod="Iconify" HideMethod Iconify HideMethod "Iconify" Laquelle de ces quatre variantes vous utiliserez, dépendra de vos préférences personnelles, et du fait que vous éxécutez la commande depuis ARexx, le CLI ou un icône tooltype. Quoi qu'il en soit, si un paramètre de commande contient des espaces, il doit être entouré de guillemets. La plupart des commandes qui n'ont pas besoin d'un paramètre sont utilisées pour contrôler diverses préférences, comme les fonctions à surveiller. Il y a plusieurs façons de choisir la manière dont vous voulez contrôler chaque préférence. Par exemple, examinons la commande Lock, qui contrôle si oui ou non SnoopDos doit surveiller la fonction Lock() dans la dos.library. Tout ce qui suit va autoriser la surveillance de Lock : Lock Lock=Yes Lock=On Lock=1 Pour supprimer la surveillance, vous pouvez utiliser : NoLock Lock=No Lock=Off Lock=0 Le "=" est facultatif dans la plupart des cas, mais est nécessaire si vous éxécutez la commande depuis le CLI. Si vous éxécutez la commande depuis ARexx, il est conseillé de ne pas utiliser le "=" pour l'empêcher d'entrer en conflit avec l'interpréteur de commandes d'ARexx. En général, la plupart des commandes ont une version positive et négative. Par exemple, Disable=No, NoDisable et Enable sont tous équivalents. De la même manière, vous pouvez utiliser HideGadget=Yes ou ShowGadget=No -- ils ont tous les deux le même effet. Si SnoopDos ne comprend pas une commande donnée, il va généralement vous en informer -- la manière dont il le fera dépendra de la méthode utilisée pour l'appel de la commande. Les commandes éxécutées depuis le CLI produisent un message d'erreur dans la fenêtre de CLI, alors que celles éxécutées depuis ARexx retournent un code résultat (return code) dans la variable RC. Les commandes non reconnues dans les icônes tooltypes et les fichiers de préférences sont ignorées, en silence. Si vous voulez expérimenter les commandes SnoopDos, vous pouvez utiliser la commande @{" LoadSettings " link LoadSettings} avec pour nom de fichier "CON:////SnoopDos/CLOSE" pour créer une fenêtre où vous pourrez tapez vos commandes intéractivement. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Utilisation depuis le CLI " link CLI} @{" Utilisation depuis le Workbench " link Workbench} @{" Utilisation depuis ARexx " link ARexx} @ENDNODE @NODE AddLog @TITLE "Commande AddLog " Commande : ADDLOG "texte" Exemple : ADDLOG "Chargement de la BBS..." Cette commande vous permet d'envoyer un message personnalisé au fichier trace courant de SnoopDos. Cela peut être utile si SnoopDos est en train de visualiser un script DOS ou ARexx qui génère beaucoup de messages, et si vous voulez indiquer quand certaines parties du script ont été éxécutées en relation avec la sortie de SnoopDos. Voir aussi : @{" Index des commandes " link CommandIndex} @{" AppendLog " link AppendLog} @{" CloseLog " link CloseLog} @{" FlushLog " link FlushLog} @{" LogFormat " link LogFormat} @{" OpenLog " link OpenLog} @ENDNODE @NODE AppendLog @TITLE "Commande AppendLog " Commande : APPENDLOG "nomfichier" Exemple : APPENDLOG "ram:SnoopDos.log" Cette commande ouvre un fichier trace. Toute sortie affichée dans la fenêtre de SnoopDos sera aussi écrite dans ce fichier. Si le fichier existe déjà, SnoopDos ajoutera la sortie au contenu existant du fichier; sinon un nouveau fichier est créé. Les fichiers ouverts grâce à AppendLog ont un avantage sur ceux ouverts avec OpenLog, dans la mesure ou il est possible d'accéder au contenu du fichier depuis un autre programme pendant que SnoopDos est encore en train d'y écrire. Ceci est utile si vous voulez simplement revoir les évènements déjà visualisés -- vous pouvez tout simplement faire un TYPE du fichier dans une fenêtre CLI. Si vous procédez de cette manière, vous pouvez vous assurer que le contenu du fichier est bien à jour en sélectionnant puis en dé-sélectionnant le gadget de @{" Pause " link Pause}. Ceci va écrire toute information qui pourrait encore se trouver dans le buffer du fichier. Voir les explications sur @{" OpenLog " link OpenLog} pour plus d'informations sur la manière dont SnoopDos envoie les informations vers le fichier trace. Voir aussi : @{" Index des commandes " link CommandIndex} @{" AddLog " link AddLog} @{" CloseLog " link CloseLog} @{" LogFormat " link LogFormat} @{" OpenLog " link OpenLog} @{" OpenSerialLog " link OpenSerialLog} @{" FlushLog " link FlushLog} @ENDNODE @NODE AutoOpen @TITLE "Commande AutoOpen" Commande : AUTOOPEN NOAUTOOPEN Cette commande permet d'activer et de désactiver la préférence AutoOpen. Cette préférence peut aussi être contrôlée par une option dans le menu de la fenêtre. Lorsque AutoOpen est activé, SnoopDos va automatiquement ouvrir sa fenêtre dès qu'un évènement visualisé dans la fenêtre surviendra. Ceci est utile si vous avez configuré SnoopDos pour ne montrer qu'un ou deux types d'évènements, puisque cela vous permet de lancer SnoopDos en tâche de fond, et qu'il apparaisse dès qu'un de ces évènements survient. Cette commande est automatiquement écrite dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" MatchName " link MatchName} @ENDNODE @NODE BufferFont @TITLE "Commande BufferFont" Commande : BUFFERFONT "nompolice.taille" Exemple : BUFFERFONT "courier.13" Cette commande choisit la police de caractères utilisée par SnoopDos pour afficher les évènements dans la fenêtre principale. Vous pouvez aussi changer la police en utilisant la fenêtre de requêtes de polices, à laquelle vous pouvez accéder par la fenêtre des @{" Préférences " link SettingsWindow}. La police sélectionnée doit être non-proportionnelle, et vous devez spécifier une taille. Cette commande est automatiquement écrite dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" WindowFont " link WindowFont} @ENDNODE @NODE BufferSize @TITLE "Commande BufferSize" Commande : BUFFERSIZE Exemple : BUFFERSIZE 32 Cette commande change la taille du buffer que SnoopDos utilise pour enregistrer les informations sur les évènements. Vous pouvez aussi changer la taille du buffer en utilisant la gadget de taille de buffer dans la fenêtre des @{" Préférences " link SettingsWindow}. La taille du buffer est donnée en kilo-octets. Chaque évènement occupe (très) approximativement 100 octets de mémoire, donc vous pouvez stocker environ 10 évènements par kilo-octet. La taille réelle de chaque évènement varie selon la longueur du fichier, des noms des processus, et de plusieurs autres facteurs. Notez que changer cette préférence dans la fenêtre des @{" Préférences " link SettingsWindow} n'aura d'effet que lorsque vous aurez sélectionné Utiliser; ce qui diffère de la plupart des autres gadgets dont l'effet est immédiat. L'explication est que le buffer de SnoopDos est effacé lorsque vous changez sa taille, donc l'action n'est activée qu'au dernier moment. Si il n'y a pas assez de mémoire disponible pour la taille de buffer que vous demandez, SnoopDos allouera le buffer le plus grand possible en utilisant la mémoire disponible. Notez que SnoopDos requiert de la mémoire contigüe pour son buffer, donc si vous aviez lancé beaucoup d'applications avant SnoopDos, vous pourriez de pas avoir autant de mémoire que vous le pensiez. Cette commande est automatiquement écrite dans le fichier de préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" ClearBuffer " link ClearBuffer} @ENDNODE @NODE ChangeDir @TITLE "Commande ChangeDir" Commande : CHANGEDIR NOCHANGEDIR Cette commande active ou désactive la surveillance de la fonction CurrentDir() de la dos.library. Elle est aussi disponible dans la fenêtre des @{" Fonctions " link FunctionWindow}. Les programmes font appel à la fonction CurrentDir() lorsqu'ils veulent modifier leur répertoire de travail. Ceci donne souvent une indication de l'endroit où un programme essaie de trouver certains fichiers. Cette commande est automatiquement écrite dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE ClearBuffer @TITLE "Commande ClearBuffer" Commande : CLEARBUFFER Cette commande efface le contenu du buffer des évènements de SnoopDos. Tous les évènements qui surviennent après son utilisation sont numérotés depuis un à nouveau. Si vous êtes sur le point de commencer à surveiller un nouveau programme, ceci est un moyen pratique de vous assurer que vous ne mêlerez pas la visualisation des évènements du nouveau programme avec ceux des programmes précédents. Elle est également disponible comme option dans le menu du buffer. Voir aussi : @{" Index des commandes " link CommandIndex} @{" BufferSize " link BufferSize} @ENDNODE @NODE CloseFormat @TITLE "Commande CloseFormat" Commande : CLOSEFORMAT Cette commande ferme l'@{" Editeur de format " link FormatEditor} s'il était ouvert. La position actuelle de la fenêtre sur l'écran est mémorisée pour qu'elle soit réouverte au même endroit la prochaine fois. Vous pouvez aussi fermer la fenêtre de format en appuyant sur la touche shift pendant que vous sélectionnez l'option @{" Montrer format " link Menu_Show_Format} dans le menu de la fenêtre principale, ou pendant que vous double-cliquez sur la ligne des titres de la fenêtre principale. Une autre manière de fermer la fenêtre de format est d'appuyer sur la touche shift pendant que vous choisissez le gadget "Editer..." dans la fenêtre de @{" Préférences " link SettingsWindow}. Voir aussi : @{" Index des commandes " link CommandIndex} @{" OpenFormat " link OpenFormat} @{" FormatWindowPos " link FormatWindowPos} @ENDNODE @NODE CloseFunction @TITLE "Commande CloseFunction" Commande : CLOSEFUNCTION Cette commande ferme la @{" Fenêtre des fonctions " link FunctionWindow} si elle était ouverte. La position actuelle de la fenêtre sur l'écran sera mémorisée pour qu'elle puisse être ré-ouverte au même endroit la prochaine fois. Vous pouvez aussi fermer la fenêtre de fonctions en appuyant sur la touche shift pendant que vous sélectionnez l'option @{" Montrer fonctions" link Menu_Show_functions} dans le menu de la fenêtre principale, ou pendant que vous cliquez sur le gadget des fonctions dans la fenêtre principale. Voir aussi : @{" Index des commandes " link CommandIndex} @{" OpenFunction " link OpenFunction} @{" FunctionWindowPos " link FunctionWindowPos} @ENDNODE @NODE CloseLog @TITLE "Commande CloseLog" Commande : CLOSELOG Cette commande ferme tout fichier trace ouvert. Elle est disponible comme option dans le menu Projet, et également dans un gadget de la fenêtre principale (il remplace le bouton Ouvrir Trace lorsqu'un fichier trace est ouvert). Voir aussi : @{" Index des commandes " link CommandIndex} @{" AddLog " link AddLog} @{" AppendLog " link AppendLog} @{" FlushLog " link FlushLog} @{" LogFormat " link LogFormat} @{" OpenLog " link OpenLog} @ENDNODE @NODE CloseSetup @TITLE "Commande CloseSetup" Commande : CLOSESETUP Cette commande ferme la @{" Fenêtre des préférences " link SettingsWindow} si elle était ouverte. La position de la fenêtre sur l'écran est mémorisée pour qu'elle puisse être réouverte à la même position la prochaine fois. Vous pouvez aussi fermer la fenêtre de préférences en appuyant sur la touche shift pendant que vous sélectionnez l'option @{" Montrer Préfs. " link Menu_Show_setup} dans le menu de la fenêtre principale, ou lorsque vous cliquez sur le gadget des préférences dans la fenêtre principale. Voir aussi : @{" Index des commandes " link CommandIndex} @{" OpenSetup " link OpenSetup} @{" SetupWindowPos " link SetupWindowPos} @ENDNODE @NODE CopyBuffer @TITLE "Commande CopyBuffer" Commande : COPYBUFFER Cette commande copie la totalité du contenu buffer des évènements de SnoopDos vers le clipboard du système, en vous permettant de la copier facilement vers une autre application telle qu'un traitement de textes ou un éditeur de textes. Vous pouvez aussi y accéder depuis le menu du buffer. Les données seront au format décrit par le format actuel du buffer. Du fait que cela peut générer une assez grande quantité de données, vous pouvez plutôt préférer utiliser la commande CopyWindow, qui ne copie que les données affichées dans la fenêtre principale. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CopyWindow " link CopyWindow} @{" SaveBuffer " link SaveBuffer} @{" SaveWindow " link SaveWindow} @ENDNODE @NODE CopyWindow @TITLE "Commande CopyWindow" Commande : COPYWINDOW Cette commande copie le contenu de la fenêtre principale vers le clipboard du système, en vous permettant de le copier facilement vers une autre application telle qu'un éditeur de textes ou un traitement de textes. Elle est également disponible depuis le menu du buffer. Si le format actuel du buffer est trop large pour être affiché dans la fenêtre principale, seule la partie qui est affichée sera copiée. S'il manque trop d'informations, vous pouvez utiliser commande CopyBuffer et effacer les lignes dont vous n'avez pas besoin. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CopyBuffer " link CopyBuffer} @{" SaveBuffer " link SaveBuffer} @{" SaveWindow " link SaveWindow} @ENDNODE @NODE CreateIcons @TITLE "Commande CreateIcons" Commande : CREATEICONS NOCREATEICONS Cette commande contrôle si SnoopDos doit créer ou non un icône lorsqu'il sauve un fichier de préférences. Vous pouvez trouver l'option correspondante dans le menu des préférences. Notez qu'aucun icône n'est sauvé pour les préférences par défaut, seulement pour les fichiers de préférences qui sont sauvés par la commande @{" SaveSettings " link SaveSettings}. Si un icône est créé pour un fichier de préférences, les préférences dans ce fichier peuvent être activées à tout moment en double-cliquant sur l'icône. Lorsque SnoopDos crée les icônes, il essaie d'utiliser la même image que celle utilisée par l'icône de SnoopDos. S'il n'a pu trouver un icône de programme, il utilise l'icône qu'il possède par défaut. Cette commande est automatiquement écrite dans le fichier des préférences lorsque vous les sauvez. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SaveDefSettings " link SaveDefSettings} @{" SaveSettings " link SaveSettings} @ENDNODE @NODE CX_PopKey @TITLE "Commande CX_PopKey" Commande : CX_POPKEY "description de touches" Exemple : CX_POPKEY "ctrl alt d" Cette commande vous permet de sélectionner quelle séquence de touches sera utilisée pour ouvrir la fenêtre principale de SnoopDos lorsqu'il est caché. Ceci correspond au gadget HotKey de la fenêtre des @{" Préférences " link SettingsWindow}. C'est un synonyme de la commande @{" HotKey " link HotKey}. Toute séquence de touches peut être donnée. Vous pouvez à tout moment vérifier quelle séquence de touches est utilisée en regardant la barre de titres la fenêtre principale. Si vous avez entré une description incorrecte, la barre de titres affichera "". Lorque vous avez défini une HotKey, SnoopDos peut être appellé à tout moment en utilisant cette séquence de touches. Si la fenêtre principale était déjà ouverte, elle sera ramenée au premier plan et activée. Si elle était déjà ouverte, mais sur un écran différent, elle sera réouverte sur l'écran courant (comme par la commande @{" ScreenType " link ScreenType}). Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_Popup " link CX_Popup} @{" CX_Priority " link CX_Priority} @{" HotKey " link HotKey} @ENDNODE @NODE CX_Popup @TITLE "Commande CX_Popup" Commande : CX_POPUP=YES CX_POPUP=NO Cette commande contrôle si oui on non SnoopDos doit ouvrir sa fenêtre lorsque vous le lancez. Si vous utilisez cette commande alors que SnoopDos était déjà lancé, la fenêtre s'ouvrira ou se fermera, selon le cas. Il y a exception si vous lancez SnoopDos depuis un icône qui contient le tooltype CX_POPUP=NO. Dans ce cas, cette commande n'aura d'effet que la première fois où SnoopDos est lancé. Si vous l'utilisez encore pendant que SnoopDos est caché en tâche de fond, la fenêtre principale sera automatiquement ouverte, en prenant le dessus sur le tooltype. Cette commande est identique aux commandes @{" Show " link Show} et @{" Hide " link Hide}. Elle est incluse pour des raisons compatibilité avec d'autres commodités. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_PopKey " link CX_PopKey} @{" CX_Priority " link CX_Priority} @ENDNODE @NODE CX_Priority @TITLE "Commande CX_Priority" Commande : CX_PRIORITY=n Exemple : CX_PRIORITY=5 Cette commande est utilisée pour contrôler la priorité de la HotKey utilisée pour appeller la fenêtre de SnoopDos lorsque SnoopDos s'éxécute en tant que commodité. La plupart des gens n'auront jamais besoin de modifier la valeur par défaut qui est zéro. Cela dit, il se peut éventuellement qu'une autre application se serve de plusieurs touches, l'une d'entre elles pouvant être celle de SnoopDos. En augmentant la valeur de CX_Priority, vous pouvez vous assurer que SnoopDos aura la priorité. De la même façon, en assignant une valeur négative à CX_Priority, vous pourrez vous assurer qu'une autre application aura la priorité. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_PopKey " link CX_PopKey} @{" CX_Popup " link CX_Popup} @ENDNODE @NODE Delete @TITLE "Commande Delete" Commande : DELETE NODELETE Cette commande active ou désactive la surveillance de la fonction DeleteFile() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre @{" Fonctions " link FunctionWindow}. La commande DeleteFile() est utilisée pour effacer un fichier disque. Les programmes effacent souvent des fichiers temporaires lorsqu'ils n'en ont plus besoin. Si un fichier disparait régulièrement, et que vous vous demandez pourquoi et comment, surveiller la fonction DeleteFile() pourra peut-être vous montrer quel programme en est responsable. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE Disable @TITLE "Commande Disable" Commande : DISABLE Cette commande permet d'arrêter l'action de SnoopDos très simplement tout en le laissant prêt pour la suite. Elle correspond au gadget Arrêter dans la fenêtre principale et à l'option Arrêter dans le menu Projet. De plus, la combinaison de touches CTRL-D est reconnue comme raccourci clavier pour Arrêter, ceci pour rester compatible avec les SnoopDos 1.x. Ceci fonctionne même lorsque la sortie est dirigée vers un device de trace tel que CON: ou AUX:. Lorsque SnoopDos est arrêté, il ôte tous ses patches et entre dans une phase inactive, pendant laquelle il n'a aucun effet sur les performances du système. Si un fichier trace est ouvert, le buffer restant est écrit dans le fichier, accompagné d'un message indiquant à quuelle heure SnoopDos a été arrêté. (Si vous ne voulez que vider le fichier de sortie, la commande @{" FlushLog " link FlushLog} est la manière la plus simple pour le faire.) Voir aussi : @{" Index des commandes " link CommandIndex} @{" DisableWhenHidden " link DisableWhenHidden} @{" Enable " link Enable} @{" Pause " link Pause} @ENDNODE @NODE DisableWhenHidden @TITLE "Commande DisableWhenHidden" Commande : DISABLEWHENHIDDEN NODISABLEWHENHIDDEN Cette commande contrôle si oui ou non SnoopDos doit continuer à surveiller le système lorsqu'il tourne en tâche de fond comme commodité. Il existe une option dans le menu de la fenêtre principale. Si DisableWhenHidden est utilisé, SnoopDos désactive automatiquement la surveillance lorsqu'il est caché (en utilisant la commande @{" Hide " link Hide}). Lorsque la fenêtre de SnoopDos est réouverte, l'état précédent de la surveillance est remis en place, à moins que la surveillance ait été relancée avec la commande @{" Enable " link Enable} pendant que SnoopDos était caché, auquel cas aucun changement n'est fait. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Disable " link Disable} @{" Enable " link Enable} @{" Pause " link Pause} @ENDNODE @NODE Enable @TITLE "Commande Enable" Commande : ENABLE Cette commande est la contrepartie de la commande @{" Disable " link Disable}. Elle permet d'annuler l'effet d'une commande Disable utilisée plus tôt, et autorise SnoopDos à reprendre la surveillance des fonctions. Elle correspond au gadget Disable dans la fenêtre principale, et à l'option Disable dans le menu Projet. Pour assurer la compatibilité avec les SnoopDos 1.x, la combinaison de touches CTRL-D active également Enable. Ceci fonctionne même si elle est envoyée depuis un device trace tel que AUX: ou CON:. Un autre raccourci clavier est SHIFT-TAB, qui va de plus provoquer la commande inconditionnelle @{" Unpause " link Unpause}. Si le fichier trace est ouvert, l'heure à laquelle la surveillance est à nouveau autorisée est écrite dans ce fichier. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Disable " link Disable} @{" DisableWhenHidden " link DisableWhenHidden} @{" Pause " link Pause} @ENDNODE @NODE Execute @TITLE "Commande Execute" Commande : EXECUTE NOEXECUTE Cette commande active ou non la surveillance de la fonction Execute() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Les anciennes applications appellent Execute() pour lancer une commande externe depuis le programme principal. Par exemple, un programme peut vouloir essayer de lancer l'utilitaire de Commodore 'Colors' comme moyen simple d'éditer les couleurs pour ses écrans. Les logiciels plus récents appellent plutôt les fonctions RunCommand() ou System(). Le champ @{" Nom Cible" link Format_TargetName} montre la ligne de commande éxécutée par l'application. En général, une seule commande est éxécutée à la fois; dans ce cas, le champ @{" Options " link Format_Options} affichera Single. Si l'application lance d'autre commandes après la première, Batch sera alors affiché. Le mode Batch est généralement employé pour créer un nouveau CLI ou un nouveau Shell; les commandes supplémentaires sont alors lues depuis une fenêtre console plutôt qu'être directement issues depuis l'application. Le champ @{" Résultat " link Format_Result} montrera si oui ou non la commande a été bien chargée. Notez bien que cela ne veut pas dire que cette commande s'est bien effectuée, mais seulement que AmigaDos l'a bien localisée sur le disque et l'a chargée en mémoire. SnoopDos écrit automatiquement cette commande dans le fichier des préférences si vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" RunCommand " link RunCommand} @{" System " link System} @ENDNODE @NODE FileIOType @TITLE "Commande FileIOType" Commande : FILEIOTYPE=AUTOMATIC | IMMEDIATE | BUFFERED Exemple : FILEIOTYPE=IMMEDIATE Cette commande détermine quelle méthode SnoopDos va employer pour remplir son buffer lorsqu'il capture les informations vers un fichier trace. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. SnoopDos fait la différence entre envoyer les informations vers un fichier trace ou un device trace (comme PRT:, AUX:, CON:). Si vous choisissez AUTOMATIC, SnoopDos va automatiquement utiliser une sortie avec buffer lorsqu'il envoie les informations vers des fichiers et ne pas utiliser une sortie avec buffer lorsque les informations sont envoyées vers des devices. Si vous choisissez IMMEDIATE, SnoopDos n'utilisera jamais de sortie avec buffer. Ceci permet de s'assurer que les informations écrites vers le fichier trace (que ce soit sur disque ou vers un device physique tel qu'une imprimante) sont toujours vraiment à jour. Cela peut néanmoins ralentir un petit peu le système du fait qu'un accès à un fichier doit être effectué pour chaque évènement visualisé par SnoopDos. Si vous choisissez BUFFERED, SnoopDos va toujours utiliser une sortie avec buffer, même s'il envoie les informations vers un device. La technique de la sortie avec buffer est d'attendre jusqu'à ce que 8Ko d'informations sur les évènements soient collectés, puis d'envoyer toutes les données en une seule fois. Ceci est plus rapide que le mode IMMEDIATE, mais a le désavantage de ne pas offrir une trace constamment à jour. Dans le cas d'une imprimante, par exemple, vous ne verriez rien s'imprimer pendant un moment, puis environ 20 à 30 lignes s'afficher en une fois. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" FlushLog " link FlushLog} @ENDNODE @NODE FindPort @TITLE "Commande FindPort" Commande : FINDPORT NOFINDPORT Cette commande active ou désactive la surveillance de la fonction FindPort() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre @{" Fonctions " link FunctionWindow}. Les programmes appellent FindPort() pour communiquer avec d'autres applications du système. Elle est le plus souvent appelée pour localiser le port ARexx d'une autre application, mais peut aussi être utilisée pour permettre à plusieurs produits d'une même société de fonctionner ensemble. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsqu'il sauve les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SendRexx " link SendRexx} @ENDNODE @NODE FindResident @TITLE "Commande FindResident" Commande : FINDRESIDENT NOFINDRESIDENT Cette commande active ou désactive la surveillance de la fonction FindResident() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. La ROM Kickstart de tous les Amigas contient un certain nombre de modules résidents -- des bibliothèques, des devices, des ressources etc. La fonction FindResident() recherche un donné donné dans la liste de tous les modules de la ROM. La plupart des programmes n'ont aucun besoin d'appeler FindResident() directement, mais vous pourrez parfois voir des bibliothèques de la ROM l'appeler si votre chaine du format courant comporte le champ @{" Nom segment " link Format_SegmentName}. En utilisation normale, vous ne verrez aucun intérêt à surveiller cette fonction. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Remarque aux experts du système d'exploitation : le processus de fond ramlib appelle fréquemment FindResident lorsqu'il recherche des bibliothèques et des devices. SnoopDos ignore délibérément ces appels pour garder un volume d'informations à afficher à un niveau raisonnable. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE FindSemaphore @TITLE "Commande FindSemaphore" Commande : FINDSEMAPHORE NOFINDSEMAPHORE Cette commande active ou désactive la surveillance de la fonction FindSemaphore() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Elle est similaire à @{" FindPort " link FindPort}, mais pas aussi souvent utilisée. Elle permet d'arbitrer l'accès à une zone de données, pour qu'une seule tâche à la fois puisse y accéder. Elle est souvent utilisée pour permettre à plusieurs copies d'un même programme d'être lancées en même temps, toutes partageant l'accès à une même zone de données. La raison principale pour laquelle vous pourriez avoir besoin de la surveiller serait dans le cas où vous écririez vous-même un programme qui l'utilise. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE FindTask @TITLE "Commande FindTask" Commande : FINDTASK NOFINDTASK Cette commande active ou désactive la surveillance de la fonction FindTask() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. La fonction FindTask() permet à un programme de localiser une autre tâche sur le système par son nom. Lorsqu'il a localisé la tâche, le programme peut peut-être alors envoyer un signal à la tâche, ou communiquer avec elle d'une autre manière, ou même essayer de la détruire. Généralement, cette fonction est utilisée par les utilitaires plutôt que les applications pour localiser les tâches système. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorque vous sauvez les préférences. Voir aussi : @{" Index des commandes" link CommandIndex} @ENDNODE @NODE FlushLog @TITLE "Commande FlushLog" Commande : FLUSHLOG Lorsque SnoopDos envoie les informations vers un fichier trace, il remplit généralement un buffer en mémoire et n'écrit sur le disque que lorque le buffer est plein (environ toutes les 100 lignes). Cette méthode est bien plus efficace qu'écrire chaque ligne séparément vers le disque, mais a le désavantage, dans le cas d'un plantage du système, de perdre les lignes les plus récentes. Cette commande ordonne à SnoopDos de vider toute sortie en attente dans le buffer vers le fichier trace, en le mettant donc à jour. Elle n'a pas d'effet si aucun fichier de trace n'est ouvert. Un moyen rapide de faire cela intéractivement est faire @{" Pause " link Pause}, puis @{" Unpause " link Unpause} grâce au gadget de Pause. Notez que vous pouvez utiliser la commande @{" FileIOType " link FileIOType} pour contrôler si SnoopDos utilise une sortie avec buffer pour écrire dans le fichier trace. Voir aussi : @{" Index des commandes " link CommandIndex} @{" AddLog " link AddLog} @{" AppendLog " link AppendLog} @{" CloseLog " link CloseLog} @{" LogFormat " link LogFormat} @{" OpenLog " link OpenLog} @ENDNODE @NODE Format @TITLE "Commande Format" Commande : FORMAT "ChaineFormat" Exemple : FORMAT "%u %p %a %n %o %r" Cette commande définit comment SnoopDos doit afficher les informations sur chaque évènement qu'il surveille. Elle est aussi disponible comme gadget dans le fenêtre des @{" Préférences " link SettingsWindow}. Vous pouvez éditer la chaine de format en utilisant l'éditeur de @{" Format " link FormatEditor}, ou en manipulant les colonnes dans la fenêtre principale avec la souris. La chaine de format est similaire à celle utilisée par printf en langage C. Elle contient une liste de formats de champs, chaque champ correspondant à un type d'information sur un évènement visualisé. Les champs sont les suivants : @{" Action %a " link Format_Action } Le nom de la fonction appelée @{" CallAddr %c " link Format_CallAddr } L'adresse depuis laquelle la fonction a été appelée @{" Date %d " link Format_Date } La date à laquelle la fonction a été appelée @{" Hunk:Offset %h " link Format_HunkOffset } Le hunk et l'offset du module depuis lequel l'appel a été fait @{" Task ID %i " link Format_TaskID } L'adresse de la tâche ayant effectué l'appel @{" Target Name %n " link Format_TargetName } Le nom de l'entité à laquelle l'appel de fonction fait référence @{" Options %o " link Format_Options } Toute option supplémentaire requise par la fonction @{" Proc Name %p " link Format_ProcessName} Le nom du processus effectuant l'appel @{" Res. %r " link Format_Result } Le résultat retourné par la fonction @{" Segment Name %s " link Format_SegmentName} Le nom du module effectuant l'appel @{" Time %t " link Format_Time } L'heure à laquelle la fonction a été appelée @{" Count %u " link Format_Count } Le numéro de séquence de cet évènement Chaque champ ne peut apparaitre qu'une seule fois dans la chaine de format, mais peut ne pas y apparaitre du tout. Plusieurs champs ne sont utiles qu'aux programmeurs et peuvent être ignorés par la plupart des gens. Les caractères % sont utilisés dans la chaine de format pour représenter chaque champ. Un nombre peut apparaitre entre le % et l'identificateur du champ; il définit le nombre de caractères disponibles pour afficher ce champ. Si aucun nombre n'est spécifié, la valeur par défaut est utilisée. Voici quelques exemples de formats : "%21p %5a %39n %4o %r" -- Format classique de SnoopDos 1.7 "%16p %r %6a %6o %80n" -- Espace maximum pour le Nom Cible "%u %7i %p %h %s %7a %39n %o %r" -- Pour les programmeurs ayant des grands écrans Normalement, SnoopDos utilisera la chaine de format actuelle lorsqu'il enverra les informations vers le fichier trace. Vous pouvez néanmoins changer cela en spécifiant une nouvelle chaine @{" LogFormat " link LogFormat}. Si votre chaine de format inclut des champs non-reconnus ou en double, SnoopDos va les ôter sans rien dire et n'utiliser que ceux qui restent. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Format editor " link FormatEditor} @{" LogFormat " link LogFormat} @ENDNODE @NODE FormatWindowPos @TITLE "Commande FormatWindowPos" Commande : FORMATWINDOWPOS=, Exemple : FORMATWINDOWPOS=0,20 Cette commande est utilisée pour changer la position de la fenêtre de l'éditeur de format sur l'écran. Si la fenêtre de format est ouverte, elle est immédiatement déplacée, sinon elle s'ouvrira à la nouvelle position la prochaine fois. et sont les coordonnées du coin en haut à gauche de la fenêtre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Editeur de format " link FormatEditor} @ENDNODE @NODE Functions @TITLE "Commande Functions " Commande : FUNCTIONS=ALL | NONE | ALLDOS | NODOS | ALLSYSTEM | NOSYSTEM Exemple : FUNCTIONS=ALLDOS Cette commande est un moyen pratique pour un script ARexx de rapidement activer ou désactiver la surveillance d'un groupe de fonctions. Les options ALL et NONE concernent le groupe entier des fonctions que SnoopDos peut surveiller. ALLDOS et NODOS ne concernent que les fonctions décrites dans Fonctions DOS de la fenêtre des fonctions. ALLSYSTEM et NOSYSTEM ne concernent que les fonctions décrites dans Fonctions Système de la fenêtre des fonctions. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Fenêtre des fonctions " link FunctionWindow} @ENDNODE @NODE FunctionWindowPos @TITLE "Commande FunctionWindowPos" Commande : FUNCTIONWINDOWPOS= Exemple : FUNCTIONWINDOWPOS=0,20 Cette commande est utilisée pour changer la position de la fenêtre des fonctions de l'écran. Si la fenêtre des fonctions est ouverte, elle est immédiatement déplacée, sinon elle s'ouvrira à la nouvelle position la prochaine fois. et sont les coordonnées du coin en haut à gauche de la fenêtre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Fenêtre des fonctions " link FunctionWindow} @ENDNODE @NODE GetVar @TITLE "Commande GetVar" Commande : GETVAR NOGETVAR Cette commande active ou désactive la surveillance des fonctions GetVar() et FindVar() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. AmigaDOS a trois types de variables d'environnement : Locales, Globales et Alias. Ces fonctions permettent d'accéder aux trois types. Les variables Locales sont directement associées avec un CLI ou un Shell donné, et ne peuvent pas être utilisées par une autre partie du système. Les variables Globales résident dans le répertoire ENV: et peuvent être utilisées par tous les programmes. Les variables Alias sont manipulées grâce à la commande AmigaDOS Alias, et ne sont généralement pas utilisées par les applications. Le champ de sortie @{" Options " link Format_Options} affiche lequel des trois types de variables un programme demande. Si le type d'une variable est suivi par une '*' (par exemple "Local*"), cela indique quel programme requiert une variable binaire qui peut contenir des caractères non-affichables, et qui a probablement été créé par le programme lui-même, plutôt que par la commande AmigaDOS SetEnv. GetVar() et FindVar() sont très semblables. GetVar() est en général utilisé par les applications qui n'ont besoin que de la valeur actuelle d'une variable, alors que FindVar() est utilisé par les commandes de Commodore qui veulent modifier directement la valeur d'une variable. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SetVar " link SetVar} @ENDNODE @NODE GotoLine @TITLE "Commande GotoLine" Commande : GOTOLINE Exemple : GOTOLINE 100 Cette commande est utilisée pour repositionner l'affichage du buffer dans la fenêtre principale à une ligne donnée. Les numéros de ligne correspondent à ceux affichés dans le champ @{" Compteur " link Format_Count} Un moyen rapide pour accéder au haut ou au bas du buffer est d'utiliser les commandes GOTOLINE 0 ou GOTOLINE 99999. Voir aussi : @{" Index des commandes " link CommandIndex} @{" ScrollDown " link ScrollDown} @{" ScrollUp " link ScrollUp} @ENDNODE @NODE Help @TITLE "Commande Help" Commande : HELP Exemple : HELP MainWindow Vous pouvez appeller l'aide en ligne depuis SnoopDos via l'option Aide dans le menu Projet, en appuyant sur la touche Help lorsque n'importe quel option du menu est sélectionnée, ou en appuyant sur la touche Help depuis n'importe quelle fenêtre de SnoopDos. La commande HELP est principalement destinée à être utilisée depuis un CLI. Si vous ne lui donnez pas de paramêtres, elle affichera une liste de toutes les commandes reconnues par SnoopDos. Si vous spécifiez un sujet, l'aide sur ce sujet sera chargée dans AmigaGuide pour que vous puissiez la consulter. En cas de doute, la commande HELP MAIN vous affichera la page @{" Contenu " link Main}, depuis laquelle vous pourrez trouver les informations dont vous avez besoin. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE Hide @TITLE "Commande Hide" Commande : HIDE Cette commande ferme toutes le fenêtres de SnoopDos, mais laisse SnoopDos continuer à surveiller l'activité du système en tâche de fond. Elle est aussi disponible dans un gadget de la fenêtre @{" Principale " link MainWindow}, et comme option dans le menu Projet. Vous pouvez aussi cacher SnoopDos en cliquant sur le gadget Cacher de la fenêtre principale. Si l'option @{" Pour cacher " link HideMethod} est définie à Aucune, cette option n'est pas disponible. Lorque SnoopDos est caché, la fenêtre principale peut être réouverte en utilisant la @{" HotKey " link HotKey}. Selon la méthode pour cacher qui a été choisie, vous pourrez aussi ouvrir l'icône SnoopDOs ou sélectionner Ouvrir SnoopDos dans le menu de la barre d'outils. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_Popup " link CX_Popup} @{" Show " link Show} @ENDNODE @NODE HideGadgets @TITLE "Commande HideGadgets" Commande : HIDEGADGETS Cette commande désactive l'affichage du panneau de gadgets de la fenêtre @{" Principale " link MainWindow}. Elle est aussi disponible comme option de menu. Oter les gadgets permet d'avoir plus d'informations sur les évènements qui sont affichés dans la fenêtre de SnoopDos. Bien que les gadgets ne soient plus visibles, vous pouvez encore utiliser les raccourcis clavier qui leur correspondent pour activer les différentes fonctions. Pour que l'espace disponible pour l'affichage des évènements soit maximal, vous pouvez aussi faire un @{" HideStatus " link HideStatus}. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HideStatus " link HideStatus} @{" ShowGadgets " link ShowGadgets} @{" ShowStatus " link ShowStatus} @{" TextSpacing " link TextSpacing} @ENDNODE @NODE HideMethod @TITLE "Commande HideMethod" Commande : HIDEMETHOD=NONE | INVISIBLE | ICONIFY | TOOLSMENU Exemple : HIDEMETHOD=ICONIFY Cette commande contrôle le mécanisme utilisé par SnoopDos pour tourner en tâche de fond lorsque vous sélectionnez la commande @{" Hide " link Hide}. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. Choisir NONE comme méthode pour cacher SnoopDos l'empêche complètement de tourner en tâche de fond. Le gadget et l'option Cacher dans le menu sera grisée, donc indisponible, et lorsque vous cliquerez dans le gadget de fermeture de la fenêtre principale, SnoopDos s'arrêtera complètement, au lieu d'être caché. La méthode INVISIBLE ôte toute trace de SnoopDos de l'écran. La seule manière de le réactiver est d'utiliser la @{" HotKey " link HotKey}, d'utiliser l'option Montrer Interface dans l'échangeur de commodités, ou d'envoyer la commande @{" Show " link Show} à SnoopDos. (double-cliquer sur l'icône de programme de SnoopDos le fera). La méthode ICONIFY est similaire à INVISBLE, mais elle crée un Icône d'application dans le Workbench dès que SnoopDos est caché. SnoopDos peut alors être réactivé en double-cliquant sur cet icône. L'image utilisée pour l'icône sera la même que celle de l'icône de programme si c'est possible; si aucun icône n'a été trouvé, une image par défaut sera utilisée. La position de l'icône sera automatiquement sélectionnée par le Workbench; si vous préférez, vous pouvez choisir une position fixe en utilisant la commande @{" IconPos " link IconPos}. La méthode TOOLSMENU crée un nouvel élément dans le menu des outils du Workbench intitulé "Montrer SnoopDos". Choisir cet élément réouvrira automatiquement SnoopDos. Notez que la HotKey de SnoopDos peut être utilisée pour réactiver la fenêtre principale à tout moment, même si SnoopDos n'est pas caché à ce moment là. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Hide " link Hide} @{" HotKey " link HotKey} @{" Show " link Show} @ENDNODE @NODE HideStatus @TITLE "Commande HideStatus" Commande : HIDESTATUS Cette commande ordonne à SnoopDos d'arrêter d'afficher la ligne d'état dans la fenêtre @{" Principale " link MainWindow}. Elle est aussi disponible comme option du menu de la fenêtre principale. La ligne d'état n'est pas strictement nécessaire, mais elle permet une visualisation rapide qui permet de se rendre compte si un fichier trace est ouvert ou pas et si SnoopDos est en @{" Pause " link Pause} ou @{" Disabled " link Disable}. Certaines personnes préfèrent sacrifier la ligne d'état pour avoir plus de lignes dédiées à l'affichage des évènements dans la fenêtre principale. Si vous faites ceci, pous pouvez également supprimer les gadgets @{" Boutons " link HideGadgets}, ce qui vous permettra d'avoir un maximum de lignes de textes pouvant être affichées. SnoopDos écrit automatiquement cette commande dans le fichier des préférences si vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HideGadgets " link HideGadgets} @{" ShowGadgets " link ShowGadgets} @{" ShowStatus " link ShowStatus} @{" TextSpacing " link TextSpacing} @ENDNODE @NODE HOTKEY @TITLE "Commande HotKey" Commande : HOTKEY "description de la combinaison de touches" Exemple : HOTKEY "ctrl alt d" Cette commande vous permet de sélectionner quelle combinaison de touches est utilisée pour ouvrir la fenêtre principale de SnoopDos lorsqu'il est caché. Elle correspond au gadget HotKey dans la fenêtre des @{" Préférences " link SettingsWindow}. C'est un synonyme pour la commande @{" CX_PopKey " link CX_PopKey}. Toute séquence standard de touches peut être utilisée. Vous pouvez voir quelle séquence de touches est active et regardant dans la barre de titres de la fenêtre @{" Principale " link MainWindow}. Si vous entrez une description incorrecte, la barre de titres indiquera "". Lorsque vous avez défini une HotKey, SnoopDos peut être appelé à tout moment en tapant cette séquence au clavier. Si la fenêtre principale est déjà ouverte, elle sera ramenée au premier plan et activée. Si elle était ouverte, mais sur un autre écran, elle sera réouverte sur l'écran actuel (comme sélectionné par la commande @{" ScreenType " link ScreenType}.) SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_PopKey " link CX_PopKey} @{" CX_Popup " link CX_Popup} @{" CX_Priority " link CX_Priority} @ENDNODE @NODE IconPos @TITLE "Commande IconPos" Commande : ICONPOS=, Exemple : ICONPOS=500,300 Cette commande définit la position de l'icône d'application créé par SnoopDos lorsqu'il tourne en état icônifié. Cet icône sera généralement positionnée automatiquement à la même position la plus appropriée à l'écran, mais vous pourriez vouloir passer outre et déterminer vos propres coordonnées. Une position 0,0 laisse au Workbench le choix de la meilleure position. Notez qu'il n'y a aucun moyen de choisir cette option depuis SnoopDos; vous devez la changer en éditant le fichier des préférences de SnoopDos directement, ou en ajoutant un tooltype à l'icône de SnoopDos. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HideMethod " link HideMethod} @ENDNODE @NODE IgnoreShell @TITLE "Commande IgnoreShell" Commande : IGNORESHELL NOIGNORESHELL Cette commande active ou désactive la préférence Ignorer Workbench/Shell. Elle est aussi disponible dans un gadget dans la fenêtre des @{" Fonctions " link FunctionWindow}. Lorsqu'elle est activée, SnoopDos ignore tous les appels système faits par le Workbench, ou par les processus shell ou les CLI qui n'ont pas de commande en cours. Ceci peut considérablement réduire le volume de sortie. Si vous avez autorisé l'option @{" MonitorROMCalls " link MonitorROMCalls}, la plupart des évènements du Workbench et du shell seront automatiquement ignorés. Dans ce cas, vous pouvez préférer laisser cette option désactivée, puisqu'elle accélèrera un peu la sortie de SnoopDos. Remarque : Si vous activez la visualisation des appels ROM, et désactivez IgnoreShell, vous pouvez voir quels tooltypes le Workbench recherche par défaut lorsque vous lancez un programme depuis son icône. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" MatchName " link MatchName} @{" MonitorROMCalls " link MonitorROMCalls} @ENDNODE @NODE Language @TITLE "Commande Language" Commande : LANGUAGE "nomlangage" Exemple : LANGUAGE "français" Cette commande sert à définir le langage que SnoopDos va utiliser pour afficher tous les menus, les fenêtres et les fenêtres de requête. Par défaut, SnoopDos est en Anglais, mais il peut utiliser d'autres langages par l'utilisation de fichiers catalogues externes. En ce moment, SnoopDos ne supporte que l'Anglais et le Français. J'espère sortir des versions localisées durant les prochains mois. Si vous examinez le code source de SnoopDos qui se trouve sur Aminet, vous pourrez y trouver un fichier de description de catalogue qui vous permettra de créer un catalogue dans votre propre langue. A la différence des autres commandes, LANGUAGE n'a de sens que lorsqu'elle est spécifiée dans un icône ToolType ou dans une ligne commande CLI. La raison est que SnoopDos doit lire le fichier du langage tout au début de son initialisation, afin de l'autoriser à afficher les messages d'erreurs dans le bon langage. Normalement, vous n'aurez jamais à utiliser cette commande -- SnoopDos va automatiquement essayer d'utiliser l'un des langages définis dans les préférences Locales, et n'utiliser l'Anglais que si le fichier de catalogue adéquat n'a pas été trouvé. Mais si vous développez un nouveau fichier catalogue pour SnoopDos, cette commande peut être utile puisqu'elle ordonne à SnoopDos d'utiliser votre nouveau fichier de catalogue pendant la phase de test. SnoopDos va rechercher le langage que vous spécifiez dans deux répertoires différents. Le premier est PROGDIR:Catalogs//SnoopDos.catalog, et le second est LOCALE:Catalogs//SnoopDos.catalog. Vous pouvez passer outre ces répertoires par défaut en spécifiant le chemin complet du répertoire qui contient le fichier SnoopDos.catalog. Par exemple, LANGUAGE="ram:" va recherche le fichier de catalogue "ram:SnoopDos.catalog". Si vous faites ceci, vous aurez besoin de modifier temporairement le nom donné dans la ligne ##language de votre fichier de traduction (.CT) en "##language ram:", ou la locale.library ne sera pas capable de reconnaitre le catalogue généré comme valide. N'oubliez pas de taper la commande AVAIL FLUSH sous CLI, après avoir quitté SnoopDos, sans quoi la locale.library gardera une copie du premier fichier de préférences en mémoire et ignorera la nouvelle version sur disque. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE LeftAligned @TITLE "Commande LeftAligned" Commande : LEFTALIGNED Cette commande contrôle comment le champ @{" Nom Cible " link Format_TargetName} est affiché dans la fenêtre principale. Elle est aussi disponible comme sous-option de l'option Nom Cible du menu de la fenêtre principale. L'état normal du champ Nom Cible est aligné à gauche; dans ce mode, il se comporte comme toutes les autres colonnes. Voir les précisions sur @{" RightAligned " link RightAligned} pour plus de détails. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" RightAligned " link RightAligned} @{" ShowFullPaths " link ShowFullPaths} @ENDNODE @NODE LoadDefSettings @TITLE "Commande LoadDefSettings" Commande : LOADDEFSETTINGS Cette commande lit le fichier des préférences par défaut, comme défini dans la commande @{" Settings " link Settings}. Elle est aussi disponible comme option dans le menu des Préférences. Si aucun fichier n'a été défini explicitement, alors le fichier qui a été chargé pendant le lancement de SnoopDos sera rechargé. Si ce fichier ne peut être trouvé, le fichier EnvArc:SnoopDos.prefs sera chargé. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LoadSettings " link LoadSettings} @{" SaveDefSettings " link SaveDefSettings} @{" SaveSettings " link SaveSettings} @{" Settings " link Settings} @ENDNODE @NODE LoadSeg @TITLE "Commande LoadSeg" Commande : LOADSEG NOLOADSEG Cette commande active ou désactive la surveillance des fonctions LoadSeg() et NewLoadSeg() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Ces fonctions sont appelées pour charger un module éxécutable depuis le disque vers la mémoire, où il peut être éxécuté. Il y a de grandes chances que vous voyiez ces fonctions être appelées par le processus @{" ramlib " link PatchRamLib}, qui est responsable du chargement des bibliothèques et des devices depuis le disque. Vous pourrez aussi la voir être utilisée pour charger des polices de caractères ou des tables de caractères. Parfois, une application pourra appeler LoadSeg() directement pour charger un sous-programme qui n'avait pas été nécessaire jusque-là. Si vous voyez LoadSeg() être appelé sans raison apparente, cela indique que l'application est en train de charger une couche de données -- une partie d'une application qui est restée sur disque jusqu'à ce qu'elle soit nécessaire, pour sauver de la mémoire. Fonctionnellement, LoadSeg() et NewLoadSeg() sont identiques. La différence principale est que NewLoadSeg() n'a pas été introduit avant le Kickstart 2.04, et a plus de chances d'être utilisée dans de futures versions du système d'exploitation. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE LoadSettings @TITLE "Commande LoadSettings" Commande : LOADSETTINGS "fichierdepréférences" LOADSETTINGS "con:////Fenêtre de commande SnoopDos/CLOSE" Exemple : LOADSETTINGS "ram:SnoopDos.prefs" Cette commande lit un fichier de préférences de SnoopDos. Elle est aussi disponible comme option dans le menu des Préférences. Un fichier de préférences est un fichier ascii qui contient des commandes SnoopDos valides, une par ligne. Le fichier doit comprendre le texte qui suit sur la première ligne pour être reconnu comme fichier de préférences. Tous caractères entre un point virgule et la fin de la ligne sera considéré comme un commentaire, et ignoré. Les fichiers de préférences sont généralement utilisés pour stocker une combinaison de préférences qui définit quelles fonctions seront à surveiller etc. Cela dit, ils peuvent aussi contenir d'autres commandes, qui effectuent des actions comme ouvrir ou fermer des fenêtres ou des fichiers de trace. Si le nom de fichier que vous spécifiez est un fichier intéractif (comme par exemple une fenêtre CON:), LoadSettings se comporte légèrement différemment. Elle affiche un curseur dans la fenêtre, et vous permet de taper des commandes directement au clavier. Ceci vous permet d'essayer toute commande de SnoopDos intéractivement, et de voir l'effet qu'elle produit. Notez toutefois que, tant que la fenêtre de console est ouverte, les autres opérations de SnoopDos seront suspendues. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LoadDefSettings " link LoadDefSettings} @{" SaveDefSettings " link SaveDefSettings} @{" SaveSettings " link SaveSettings} @{" Settings " link Settings} @ENDNODE @NODE Lock @TITLE "Commande Lock" Commande : LOCK NOLOCK Cette commande active ou désactive la surveillance de la fonction Lock() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Un programme appelle généralement Lock() pour vérifier si un fichier existe ou pas. Il utilise aussi Lock() pour localiser un répertoire, pour pouvoir accéder aux fichiers de ce répertoire. Un fichier ou un répertoire peuvent être verrouillés pour un accès en lecture, auquel cas plusieurs programmes sont libres d'y accéder, ou pour un accès en écriture, auquel cas le programme doit avoir le contrôle exclusif sans interruptions. Le champ @{" Options " link Format_Options} affiche quel mode d'accès un programme a demandé. Vous pouvez parfois voir un mode d'accès noté "Read???" -- ceci indique qu'un programme bogué a oublié de spécifier quel mode d'accès était nécessaire. La plupart des devices disques de l'AmigaDos supposent qu'un mode d'accès en lecture était voulu, mais certains peuvent être en être perturbés, provoquant un fonctionnement incorrect. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" ChangeDir " link ChangeDir} @{" Open " link Open} @ENDNODE @NODE LockScreen @TITLE "Commande LockScreen" Commande : LOCKSCREEN NOLOCKSCREEN Cette commande active ou désactive la surveillance de la fonction LockPubScreen() de la intuition.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Beaucoup de programmes récents supportent les écran publiques d'Intuition -- des écrans similaires à l'écran du Workbench, mais avec la possibilité d'avoir une résolution et un nombre de couleurs différent. Surveiller cette fonction vous permet de voir si un programme recherche un écran public avec un nom donné. S'il trouve un tel écran, il peut choisir de s'ouvrir dessus plutôt que sur le Workbench. Vous pouvez utiliser l'un des nombreux utilitaires d'écrans publiques pour créer un écran avec un nom donné. En fait, SnoopDos a lui-même la possiblité de s'ouvrir sur un écran publique nommé -- pour plus de détails, reportez-vous à la commande @{" ScreenType " link ScreenType}. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE LogFormat @TITLE "Commande LogFormat" Commande : LOGFORMAT "chainedeformat" LOGFORMAT NONE Exemple : LOGFORMAT "%t %p %a %n %o %r" Cette commande est similaire à la commande @{" Format " link Format}, mais au lieu de contrôler le format des évènements affichés dans la fenêtre @{" Principale " link MainWindow}, elle contrôle le format des évènements écrits dans le fichier de trace. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. Vous n'aurez normalement pas à l'utiliser. Si aucun format de trace n'a été défini, SnoopDos va utiliser le format actuel de la fenêtre principale à la place. Cependant, vous pouvez préférer utiliser un format modifié par vos soins. Par exemple, vous pouvez avoir un grand écran Workbench capable d'afficher 130 colonnes de texte dans la fenêtre pricnipale, alors que vous voudriez que vos fichiers de trace soient affichables en 80 colonnes. La chaine de format spécifiée est identique à celle utilisée pour la commande Format. Généralement, la manière la plus rapide pour créer un nouveau format est de déterminer une largeur de 79 colonnes pour la fenêtre principale en utilisant l'option de menu @{" Changer largeur fenêtre " link Menu_Change_window_width} et ensuite d'utiliser l'@{" Editeur de Format " link FormatEditor} pour choisir ce que vous voulez afficher. Une fois que vous êtes satisfait avec le format de votre fenêtre principale vous pouvez le copier rapidement vers le format de trace en utilisant le gadget @{" Copier " link SettingsCopy} dans la fenêtre des Préférences. Le mot-clé NONE est utilisé pour ordonner à SnoopDos d'arrêter d'utiliser un format modifié pour la trace, et d'utiliser le format tel qu'il est dans la fenêtre principale, à la place. Notez que lorsque SnoopDos écrit vers un fichier de trace, il laisse automatiquement le premier caractère de chaque ligne blanc (voir @{" OpenLog " link OpenLog} pour plus de détails). Il en résulte que le format de trace de 79 caractères de large produit des lignes de 80 caractères dans le fichier trace. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Format " link Format} @{" Format editor " link FormatEditor} @{" OpenLog " link OpenLog} @ENDNODE @NODE LogMode @TITLE "Commande LogMode" Commande : LOGMODE=PROMPT | APPEND | OVERWRITE | SERIALPORT Exemple : LOGMODE=PROMPT Cette commande détermine l'action précise du gadget @{" Ouvrir trace " link MainOpenLog} dans la fenêtre principale. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. Lorsque le mode de trace est PROMPT (le choix le plus commun), le gadget de la fenêtre principale sera intitulé "Ouvrir Trace...", et le choisir appellera une fenêtre de requête de fichiers ASL afin qu'un fichier de trace soit choisi. Si le fichier choisi existe déjà, SnoopDos affichera une fenêtre de requête qui vous permettra de choisir entre remplacer ou ajouter. Lorsqu'une fenêtre de requête de fichiers est affichée, vous n'êtes pas limité à des fichiers -- vous pouvez aussi entrer des noms de devices, comme PRT:, AUX: on CON:////. Lorsque le mode de trace est APPEND, le gadget de la fenêtre principale sera intitulé "Ajouter Trace", et le sélectionner ouvrira automatiquement le fichier de trace défini par la commande @{" LogName " link LogName} en mode ajout. Ceci est pratique si vous désirez que toutes les informations dirigées vers la trace soient capturées dans un seul fichier, et que vous préférez ne pas avoir à utiliser la fenêtre de requête ASL. Le mode OVERWRITE est similaire à APPEND, mais le gadget de la fenêtre principale affiche maintenant "Débute Trace". Lorsque ce gadget est sélectionné, le nom de fichier défini par la commande @{" LogName " link LogName} est remplacé par les nouvelles informations dirigées vers la trace. C'est la méthode la plus appropriée si vous envoyez souvent des informations de trace vers un device, comme une imprimante (PRT:) ou encore une fenêtre console -- vous en spécifiez le nom et vous pouvez alors facilement démarrer ou arrêter la trace vers ce device d'un simple clic de souris. Si cous dirigez la trace vers une fenêtre console, notez bien que les touches de contrôle clavier des anciens SnoopDos 1.x sont toujours valables. CTRL-D et CTRL-E peuvent être utilisées pour activer et désactiver la trace, et CTRL-F ramènera la fenêtre principale de SnoopDos au premier plan. CTRL-C quittera SnoopDos pour de bon, soyez donc vigilant de ne pas l'utiliser par mégarde. Le mode de trace SERIAL PORT enverra la trace directement vers un terminal de débogage connecté par le port série interne. Ceci est principalement destiné aux programmeurs. C'est tout particulièrement utile si vous vous servez de l'utilitaire très pratique Sushi de Carolyn Scheppner pour rediriger la sortie de débogage vers une fenêtre ou un fichier, puisqu'il est possible de la mixer avec d'autres outils tels qu'Enforcer ou Mungwall. Lorsque cette option est choisie, le gadget de la fenêtre principale sera intitulé "Trace Série". Notez que même lorsque le mode de trace est APPEND, OVERWRITE ou SERIAL PORT, vous pouvez toujours ouvrir un fichier de trace grâce à la fenêtre de requête de fichiers ASL en choisissant l'option @{" Ouvrir Trace " link Menu_Open_log} dans le menu Projet. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index de commandes " link CommandIndex} @{" AppendLog " link AppendLog} @{" OpenLog " link OpenLog} @{" OpenSerialLog " link OpenSerialLog} @ENDNODE @NODE LogName @TITLE "Commande LogName" Commande : LOGNAME "fichiertrace" Exemple : LOGNAME "PRT:" Cette commande définit le nom du fichier de trace à utiliser lorsque le mode de trace @{" LogMode " link LogMode} est mis à APPEND ou OVERWRITE. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. Les modes de trace APPEND et OVERWRITE permettent d'éviter d'utiliser la fenêtre de requête de fichiers ASL à l'ouvrture d'un fichier de trace; ceci est pratique si vous envoyez souvent des informations de trace vers un seul fichier ou un device. Si vous utilisez PROMPT comme mode de trace, où la fenêtre de requête de fichiers ASL est affichée pour vous permettre de choisir un fichier de trace, le premier nom de fichier par défaut placé dans la fenêtre de requête ASL sera le LogName actuellement défini. Ceci est utile si vous envoyez généralement le résultat de la trace toujours vers le même fichier, mais que vous voulez quand même pouvoir le changer. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LogMode " link LogMode} @ENDNODE @NODE MainWindowPos @TITLE "Commande MainWindowPos" Commande : MAINWINDOWPOS=, Exemple : MAINWINDOWPOS=0,20 Cette commande est utilisée pour changer la position de la fenêtre principale sur l'écran actuel. Si la fenêtre de fonctions est ouverte, elle est déplacée immédiatement, sinon elle s'ouvrira à la nouvelle position la prochaine fois qu'elle sera ouverte. et sont les coordonnées du pixel dans le coin haut-gauche de la fenêtre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE MainWindowSize @TITLE "Commande MainWindowSize" Commande : MAINWINDOWSIZE=, Exemple : MAINWINDOWSIZE=640,150 Cette commande est utilisée pour changer la dimension courante de la fenêtre principale. Si la fenêtre principale est ouverte, elle est redimensionnée immédiatement, sinon elle aura la nouvelle dimension la prochaine fois qu'elle sera ouverte. et sont les nouvelles dimensions en pixels. En plus de cette commande, ou de redimensionner la fenêtre manuellement avec la souris, vous pouvez aussi utiliser la commande @{" WindowWidth " link WindowWidth} pour définir la largeur de la fenêtre en colonnes de texte, plutôt qu'en pixels. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Fenêtre principale " link MainWindow} @ENDNODE @NODE MakeDir @TITLE "Commande MakeDir" Commande : MAKEDIR NOMAKEDIR Cette commande active ou désactive la surveillance de la fonction CreateDir() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. (Le nom de la commande a été choisi pour correspondre à la commande CLI du même nom, qui est plus familière à la plupart des utilisateurs que CreateDir). Les programmes appellent cette fonction pour créer un nouveau répertoire sur disque. Ceci est fait le plus souvent lors de l'installation, quand une application crée un répertoire spécial qui contient des données ou des fichiers projets. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE MakeLink @TITLE "Commande MakeLink" Commande : MAKELINK NOMAKELINK Cette commande active ou désactive la surveillance de la fonction MakeLink() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Cette fonction est appelée pour créer un lien de fichier sur disque, qui donne un nouveau nom pour le fichier existant, tout en retenant le nom originel. A la différence de la fonction Copy, cette approche ne requiert pas l'existence d'une copie du fichier. Il y a deux types de Liens : Hard et Soft. Les Liens Hard ne peuvent résider que sur la même partition que le fichier maître. Une fois créés, les fichier liés ne sont plus distinctibles des fichiers maîtres; si le fichier originel est effacé, le Lien Hard prend automatiquement sa place. Les Liens Soft peuvent être créés sur n'importe quel disque ou partition, pas seulement celui ou celle qui coontient le fichier originel. Si le fichier originel est effacé, le Lien Soft devient caduque. Le champ @{" Nom Cible " link Format_TargetName} affichera les informations sur le Lien dans le format "Newlink --> fichier_originel". Le champ @{" Options " link Format_Options} affichera Soft ou Hard selon le cas. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE MatchName @TITLE "Commande MatchName" Commande : MATCHNAME "critère" Exemple : MATCHNAME "~(Yak|TurboText)" Cette commande vous permet de définir quels programmes SnoopDos doit ou ne doit pas surveiller. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Le critère que vous donnez est une chaine de caractère de type AmigaDOS, sans distinction des majuscules/minuscules. Elle sera comparée avec le nom des processus qui appellent l'une des fonctions actuellement en train d'être surveillées; seuls les processus dont les noms correspondent à la chaine de critère seront affichés. Généralement, vous utiliserez MatchName pour vous assurer que certains programmes seront automatiquement ignorés par SnoopDos. Par exemple, l'éditeur de textes TurboText a la propriété gênante d'appeler CurrentDir() à chaque fois que vous appuyez sur une touche. De la même manière, la commodité Yak appelle OpenDevice() à chaque fois que vous appuyez sur une touche, si l'option key-click est active. Vous pouvez utiliser le critère montré dans l'exemple plus haut pour éviter que le buffer des évènements soit rapidement rempli d'évènements sans intérêt. En général, vous pouvez faire en sorte que SnoopDos ignore plusieurs programmes différents en utilisant une chaine de critères de la forme "~(prog1|prog2|prog3|prog4|...)", en répétant autant de noms de programmes qu'il est nécessaire. Une autre utilisation plus rare pour MatchName est de surveiller seulement les évènements générés par un programme particulier. Par exemple, MatchName "Multiview" ignorerait toutes les fonctions appelées par les programmes autres que Multiview. MatchName "Multiview|AmigaGuide" ignorerait toutes les fonctions appelées par les programmes autres que Multiview et AmigaGuide. Si un programme que vous essayez de surveiller peut être lancé depuis le Shell plutôt que du Workbench, vous pouvez vouloir utiliser le préfixe "#?" avant son nom dans la chaine des critères, pour vous assurer que tout nom de chemin le précédant est ignoré. Par exemple : "#?Multiview|#?AmigaGuide". SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE MonitorPackets @TITLE "MonitorPackets command" Command : MONITORPACKETS NOMONITORPACKETS Cette commande active ou désactive la préférence Voir Paquets de SnoopDos. Cette préférence est aussi disponible depuis un gadget dans la fenêtre des @{" Fonctions " link FunctionWindow}. Certains programmes, tout particulièrement ceux écrits en GNU C et liés avec la ixemul.library, aiment outrepasser les commandes DOS normales et communiquer directement avec les devices du DOS en utilisant des paquets d'entrées/sorties. Normalement, SnoopDos ne peut pas détecter une telle activité. Mais, si vous avez activé cette option, SnoopDos va surveiller la fonction PutMsg() de la exec.library, qui permet de détecter ces paquets, et de les afficher dans la fenêtre de SnoopDos comme des appels de fonctions normaux. Lorsqu'un paquet est détecté, qui correspond à l'une des fonctions surveillées du DOS, le champ @{" Action " link Format_Action} affichera le type du paquet (par exemple : Open, Lock, MakeDir, etc.), mais il sera précédé d'une "*" pour indiquer que des entrées/sorties de paquet directes sont impliquées. Ainsi, dans les exemples donnés, vous pourrez voir *Open, *Lock, *MakeDir, etc. SnoopDos veut surveiller les versions des paquets des fonctions suivantes : @{" Delete " link Delete} @{" Lock " link Lock} @{" MakeDir " link MakeDir} @{" MakeLink " link MakeLink} @{" Open " link Open} @{" Rename " link Rename} Activer MonitorPackets a des chances de ralentir votre système, puisque PutMsg() est l'une des fonctions système les plus souvent appelées. Ainsi, vous ne devrez l'activer que si vous rencontrez un programme qui semble ouvrir des fichiers, mais dont vous ne trouvez aucune trace lors d'une surveillance normale. Les opérations de paquets effectuées par l'AmigaDOS sur commande d'une application ne seront pas montrées par SnoopDos -- ceci parce qu'il n'y a pas besoin de le faire; la fonction AmigaDOS correspondante sera montrée à la place. Mais si vous activez @{" MonitorROMCalls " link MonitorROMCalls} en même temps que Voir Paquets, vous pourrez voir plusieurs évènements affichés deux fois; une fois comme fonction DOS, et une autre comme opération de paquets. SnoopDos est parfois incapable de déterminer le résultat d'une opération de paquets. Ceci peut arriver si vous arrêtez la surveillance des paquets alors que l'opération n'est pas terminée, ou occasionnellement lorsqu'il y a une forte activité de paquets (SnoopDos peut grader la trace de 5 paquets en cours en même temps). Lorsque cela arrive, le champ des Résultats affichera "Missed" pour indiquer que SnoopDos a abandonné. Si vous avez besoin de plus d'informations que n'en donne MonitorPackets, vous pouvez utiliser l'option @{" PacketDebugger " link PacketDebugger}. Ceci vous permet de surveiller tout paquet envoyé par une application vers un device du DOS. Du fait que cela génère de grandes quantités de sorties brutes, ceci n'est vraiment destiné qu'aux programmeurs de drivers de devices. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" MonitorROMCalls " link MonitorROMCalls} @{" PacketDebugger " link PacketDebugger} @ENDNODE @NODE MonitorROMCalls @TITLE "Commande MonitorROMCalls" Commande : MONITORROMCALLS NOMONITORROMCALLS Cette commande active ou désactive la préférence de SnoopDos Voir Appels ROM. Cette préférence est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Lorsqu'un programme appelle une fonction système, cette fonction peut à son tour effectuer des appels internes à d'autres fonctions système. Par exemple, appeler OpenLibrary() peut également provoquer des appels à FindResident() et Open(). En général, ces appels supplémentaires ne font qu'encombrer et ne sont pas nécessaires, donc par défaut, SnoopDos n'affiche aucun appel effectué par le système d'exploitation. (par exemple depuis la ROM). Cependant, il est parfois utile de les visualiser, plus particulièrement si tout le reste a échoué. Activer cette option ordonne à SnoopDos d'afficher les appels de fonctions faits depuis la ROM, en plus des appels depuis les applications de l'utilisateur. Attention quand-même, ceci peut souvent doubler la somme des sorties produites. Si vous activez MonitorROMCalls, vous voudrez probablement que @{" IgnoreShell " link IgnoreShell} soit aussi activé, pour que SnoopDos ignore les sorties relatives au Shell et au Workbench. Une chose qu'il faut savoir est que SnoopDos ne peut vérifier si un appel de fonction a été fait depuis la ROM qu'en examinant l'adresse de retour sur la pile. Si un autre programme a modifié un appel de fonction après SnoopDos, SnoopDos considèrera tous les appels à cette fonction comme provenant depuis ce programme plutôt que depuis celui qui l'a réellement appelé, donc ne les ignorera pas. Un exemple de ceci est l'appel de la fonction OpenLibrary(), qui est modifié par le débogueur CodeProbe. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" MonitorPackets " link MonitorPackets} @{" PacketDebugger " link PacketDebugger} @ENDNODE @NODE OnlyShowFails @TITLE "Commande OnlyShowFails" Commande : ONLYSHOWFAILS NOONLYSHOWFAILS Cette commande active ou désactive la préférence Que les échecs de SnoopDos Cette commande peut aussi être controllée par un gadget dans la fenêtre des @{" Fonctions " link FunctionWindow}. Selon les fonctions que vous avez activées, SnoopDos peut produire une grande quantité de sorties. Activer OnlyShowFails est un moyen facile de réduire la quantité des sorties que vous voyez, tout en gardant les informations qui sont à priori intéressantes. Ceci est fait, comme le nom l'indique, en ne montrant que les fonctions ayant échoué -- tout appel de fonction fait avec succés ne sera pas affiché. Vous devrez faire un petit peu attention en utilisant cette option, du fait qu'il est possible d'être induit en erreur si vous ne faites pas attention. Souvent, un programme peut chercher des fichiers ou d'autres informations à plusieurs endroits. Si les deux premiers essais échouent, mais le troisième réussit, vous ne verrez que les informations sur les deux essais ayant échoué, et en déduire incorrectement que le programme a des problèmes. Ainsi, alors que l'option OnlyShowFails est utile pour identifier les problèmes potentiels assez tôt (en sauvant un espace non négligeable dans le buffer des évènements), il est mieux de la désactiver lorsque vous essayez de diagnostiquer une panne dans un programme. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE Open @TITLE "Commande Open" Commande : OPEN NOOPEN Cette commande active ou désactive la surveillance de la fonction Open() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre de la fenêtre des @{" Fonctions " link FunctionWindow}. Si vous choisissez de ne surveiller qu'une fonction, c'est la fonction Open qui vous donnera les informations les plus utiles, du fait qu'elle est utilisée pour ouvrir tout fichier requis pour une application. Notez toutefois qu'une application peut faire d'autres tests pour déterminer si un fichier existe, avant d'essayer de l'ouvrir. La méthode la plus répandue est d'utiliser la fonction @{" Lock " link Lock} pour essayer de trouver le fichier. Une autre alternative, que SnoopDos a du mal à surveiller facilement, est de parcourir un répertoire en regardant tous les fichiers. (Si vous pensez que c'est ce qui se passe, vous pouvez utiliser l'option @{" PacketDebugger " link PacketDebugger} pour surveiller cette méthode, mais soyez prêt à devoir filtrer beaucoup d'informations inutiles). Les fichiers peuvent être ouverts dans l'un des trois modes: Read, Write ou Modify. Read implique que le fichier sera seulement lu, et pas modifié. Write implique qu'un nouveau fichier sera créé, remplaçant tout fichier qui existerait déjà. Modify est utilisé pour écrire dans un fichier déjà existant (ou pour créer un nouveau fichier si aucun n'existait). Le champ @{" Options " link Format_Options} indique dans quel mode le fichier a été ouvert. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Lock " link Lock} @ENDNODE @NODE OpenDevice @TITLE "Commande OpenDevice" Commande : OPENDEVICE NOOPENDEVICE Cette commande active ou désactive la surveillance de la fonction OpenDevice() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Presque tous les programmes non-triviaux nécessitent l'utilisation de devices, et c'est la fonction appelée pour accéder à chaque device. La surveillance de OpenDevice() peut produire beaucoup de sorties, la plupart n'étant pas très utiles. Si vous n'êtes intéressé que par les devices qu'un programme peut vouloir ouvrir sans y arriver, ils apparaitront dans la sortie de @{" LoadSeg " link LoadSeg}, puisque l'Amiga essaie automatiquement de charger tout device qu'il ne trouve pas en mémoire depuis le répertoire DEVS:. Lorsque cette fonction est surveillée, le champ @{" Options " link Format_Options} montrera le numéro de l'unité du device que le programme est en train d'essayer d'ouvrir. Note aux experts du système d'exploitation : Tous les appels OpenDevice() effectués par des processus CON sont ignorés par SnoopDos. Ceci parce que CON (qui contrôle les fenêtres de texte CLI) ouvre fréquemment le timer.device, parfois plusieurs fois par seconde, et qu'afficher tous ces évènements remplirait rapidement le buffer des évènements avec des détails sans intérêt. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" OpenLibrary " link OpenLibrary} @ENDNODE @NODE OpenFont @TITLE "Commande OpenFont" Commande : OPENFONT NOOPENFONT Cette commande active ou désactive la surveillance de la fonction OpenFont() de la graphics.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. OpenFont() est appelé pour localiser une fonte particulière pour l'affichage à l'écran. Le champ @{" Options " link Format_Options} affiche la taille de la fonte qui est demandée. IL n'y a généralement pas besoin de surveiller cette fonction -- si un programme ne peut trouver une fonte en mémoire, l'AmigaDOS va automatiquement essayer de le charger depuis le répertoire FONTS: sur disque, et elle sera affichée dans @{" LoadSeg " link LoadSeg}. Si vous avez besoin de voir toutes les fontes en train d'être ouvertes par un programme, c'est de cette fonction dont vous aurez besoin. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE OpenFormat @TITLE "Commande OpenFormat" Commande : OPENFORMAT Cette commande ouvre la fenêtre de l'@{" Editeur de Format " link FormatEditor}. Vous pouvez également ouvrir l'éditeur de format en sélectionnant l'option @{" Montrer format " link Menu_Show_format} dans le menu de la fenêtre principale, ou en double-cliquant sur la ligne des titres dans la fenêtre @{" Principale " link MainWindow}. Un autre moyen d'ouvrir l'éditeur de format est d'utiliser le gadget "Editer..." dans la fenêtre des @{" Préférences " link SettingsWindow}. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CloseFormat " link CloseFormat} @{" FormatWindowPos " link FormatWindowPos} @ENDNODE @NODE OpenFunction @TITLE "Commande OpenFunction" Commande : OPENFUNCTION Cette commande ouvre la fenêtre des @{" Fonctions " link FunctionWindow}. Vous pouvez aussi ouvrir la fenêtre des fonctions en sélectionnant l'option @{" Montrer fonctions " link Menu_Show_functions} dans le menu de la fenêtre principale ou en sélectionnant le gadget "Fonctions..." dans la fenêtre principale. Si votre Amiga n'est équipé que d'un 68000, vous pourrez trouver que la fenêtre des fonctions prend longtemps à s'afficher la première fois que vous essayez d'y accéder. Ceci est dû au nombre de gadgets qu'elle contient. SnoopDos retient les gadgets pour que, la prochaine fois et les suivantes, il puisse ouvrir la fenêtre bien plus rapidement. Si vous avez un Amiga plus rapide, vous n'aurez aucun problème. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CloseFunction " link CloseFunction} @{" FunctionWindowPos " link FunctionWindowPos} @ENDNODE @NODE OpenLibrary @TITLE "Commande OpenLibrary" Commande : OPENLIBRARY NOOPENLIBRARY Cette commande active ou désactive la surveillance de la fonction OpenLibrary() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Il est impossible d'écrire un programme utile sur Amiga qui n'appelle pas OpenLibrary() au moins une fois. Cela donne accès à la multitude de bibliothèques partagées de l'Amiga. En général, un programme ne s'éxécutera pas s'il ne peut pas trouver une bibliothèque particulière. Toutefois, de tels essais infructueux seront montrés par les évènements @{" LoadSeg " link LoadSeg}, parce que, si AmigaDOS ne trouve pas une bibliothèque en mémoire, il essayera de la charger depuis le répertoire LIBS:. Un programme ne s'arrêtera pas forcément de tourner s'il ne peut pas trouver une bibliothèque donnée; il peut tout simplement occulter certaines de ses fonctions. Par exemple, SnoopDos lui-même peut être éxécuté sans les commodités, ou les bibliothèques ASL, mais si elles ne sont pas présentes, vous ne pourrez pas cacher la feneêtre principale ou appeler les fenêtres de requêtes des fichiers et des fontes. Le champ @{" Options " link Format_Options} donne le numéro de la version de la bibliothèque en train d'être ouverte. C'est une information utile, parce que, si le programme ne parvient pas à ouvrir une bibliothèque, il vous renseigne sur la version minimale de la bibliothèque que vous devez installer. Notez que SnoopDos ignore automatiquement tous les essais d'ouverture de la dos.library. Ceci est nécessaire pour éviter quelques problèmes subtiles qui pourraient survenir. Du fait que la dos.library doit exister, tout simplement pour éxécuter le programme, vous ne perdrez rien d'important à ne pas voir ces évènements. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" OpenDevice " link OpenDevice} @ENDNODE @NODE OpenLog @TITLE "Commande OpenLog" Commande : OPENLOG "nomfichier" Exemple : OPENLOG "ram:snoopdos.log" Cette commande ouvre un nouveau fichier trace. Toute nouvelle sortie affichée dans la fenêtre principale de SnoopDos sera écrite dans ce fichier. Si le fichier existe déjà, il sera réécrit. Vous pouvez aussi ouvrir un nouveau fichier trace depuis SnoopDos en choisissant l'option @{" Ouvrir Trace " link Menu_Open_log} dans le menu Projet, ou en utilisant le bouton @{" Ouvrir Trace " link MainOpenLog} dans la fenêtre @{" Principale " link MainWindow}. Lorsque SnoopDos affiche des évènements dans la fenêtre principale, il peut facilement gérer plusieurs évènements différents qui se déroulent simultanément. Par exemple, un programme peut appeler RunCommand() pour lancer l'éxécution d'une commande, et cette commande peut elle-même ouvrir plusieurs fichiers. SnoopDos peut afficher des informations sur cette action en cours même si l'appel RunCommand() précédemment lancé n'est pas encore terminé. Lorsque RunCommand() s'achève, SnoopDos revient en arrière et remplit le code du résultat en conséquence. Lorsqu'il envoie des évènements vers un fichier trace, il n'est pas pratique de revenir en arrière et de remplir le champ de résultat après que plusieurs autres évènements se soient passés. Par exemple, le fichier trace peut être une imprimante ou un autre device qui ne permette pas de revenir en arrière. Pour éviter ce problème, SnoopDos se comporte légèrement différemment lorsqu'il envoie les informations vers un fichier trace. Il va généralement attendre qu'un évènement soit entièrement terminé avant d'essayer de l'envoyer vers le fichier. Si toutefois un nouvel évènement survenait avant que l'évènement actuel soit terminé, SnoopDos affichera le maximum d'informations possibles sur l'évènement actuel. Pour montrer que l'évènement est incomplet, il affiche le caractère '/' dans la première colonne de la ligne. Plus tard, lorsque l'évènement se termine, SnoopDos va envoyer la ligne entière une deuxième fois, mais cette fois-ci avec le résultat rempli. Pour indiquer qu'il s'agit de la fin d'un évènement lancé plus tôt, la première colonne contient un '\\', qui correspond au '/' utilisé plus tôt. Si vous pensez que cela risque d'arriver souvent, c'est une bonne idée que d'inclure le champ @{" Compteur " link Format_Count} dans le format de trace. Il ajoutera un numéro de séquence sur chaque ligne, et vous pourrez facilement retrouver chaque évènement incomplet et sa version terminée du fait que les deux lignes auront le même numéro. Voir aussi : @{" Index des commandes " link CommandIndex} @{" AddLog " link AddLog} @{" AppendLog " link AppendLog} @{" FlushLog " link FlushLog} @{" LogFormat " link LogFormat} @{" OpenSerialLog " link OpenSerialLog} @{" CloseLog " link CloseLog} @ENDNODE @NODE OpenResource @TITLE "Commande OpenResource" Commande : OPENRESOURCE NOOPENRESOURCE Cette commande active ou désactive la surveillance de la fonction OpenResource() de la exec.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Les resources sont en général utilisées pour permettre un accès de très bas niveau au hardware standard de l'Amiga, comme le port joystick, les puces CIA, l'horloge sauvegardée, les lecteurs de disquettes, etc. Vous pouvez surveiller OpenResource() pour voir si un programme essaie d'accéder au hardware directement ou en respectant les règles du système. Bien sûr, les programmes qui enfreignent les règles et n'allouent pas le hardware correctement avant de l'utiliser ne seront pas visualisés (mais votre système aura déjà probablement planté depuis). SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE OpenSerialLog @TITLE "Commande OpenSerialLog" Commande : OPENSERIALLOG Cette commande ouvre un nouveau fichier trace. A la différence des fichiers trace normaux, la sortie sera redirigée vers un terminal de déboguage connecté au port série interne. Vous pouvez configurer le bouton "Ouvrir trace" dans la fenêtre @{" Principale " link MainWindow} pour éxécuter cette commande en configurant le @{" ModeTrace " link LogMode} à SERIAL PORT. Ceci est principalement destiné aux programmeurs. Cette commande est tout particulièrement utile si vous utilisez l'excellent utilitaire Sushi de Carolyn Scheppner pour rediriger la sortie vers une fenêtre ou un fichier, puisqu'il permet à la sortie de SnoopDos d'être mixée avec les sorties d'autres outils tels qu'@{" Enforcer " link SegTracker} et Mungwall. Voir la documentation sur @{" Ouvrir Trace " link OpenLog} pour plus de détails sur l'envoi de la sortie vers un fichier trace. Voir aussi : @{" Index des commandes " link CommandIndex} @{" AddLog " link AddLog} @{" AppendLog " link AppendLog} @{" CloseLog " link CloseLog} @{" FlushLog " link FlushLog} @{" LogFormat " link LogFormat} @{" OpenLog " link OpenLog} @ENDNODE @NODE OpenSetup @TITLE "Commande OpenSetup" Commande : OPENSETUP Cette commande ouvre la fenêtre des @{" Préférences " link SettingsWindow}. Vous pouvez aussi ouvrir cette fenêtre en sélectionnant l'option @{" Montrer préférences " link Menu_Show_setup} dans le menu de la fenêtre principale, ou en sélectionnant le gadget "Préférences" dans la fenêtre principale. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CloseSetup " link CloseSetup} @{" SetupWindowPos " link SetupWindowPos} @ENDNODE @NODE PacketDebugger @TITLE "Commande PacketDebugger" Commande : PACKETDEBUGGER NOPACKETDEBUGGER Cette commande active ou désactive le débogueur de paquet de SnoopDos. Elle peut aussi être contrôlée par un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Le débogueur de paquets offre un moyen de surveiller les paquets envoyés vers tout device de gestion de fichier monté. C'est principalement utile pour les devices gestionnaires d'écriture, mais peut parfois aussi être utile si vous voulez surveiller les opérations DOS qui ne sont pas directement supportées par SnoopDos, comme Examine()/ExNext(). Lorque le débogueur de paquets est activé, SnoopDos établit une liste des devices actuellement montés. Seuls les paquets envoyés à ces devices sont surveillés. Si un nouveau device est monté alors que le débogueur est en train de tourner, SnoopDos va généralement l'ajouter automatiquement à la liste. Cependant, si le device est monté en utilisant une commande Mount étrangère à AmigaDOS, vous pourrez avoir besoin de désactiver temporairement puis de réactiver le débogueur pour que SnoopDos puisse reconnaitre le nouveau device. La première fois que vous activez le débogueur de paquets, vous pourrez trouver qu'il n'a pas beaucoup d'effet. Ceci provient du fait que la plupart des devices du DOS sont générés par la dos.library qui est en ROM. Par défaut, SnoopDos ignore toute activité de paquets générée par des appels ROM. Activez @{" MonitorROMCalls " link MonitorROMCalls} pour changer ceci. SnoopDos peut identifer tous les paquets officiellement définis par Commodore, sous Kickstart 3.0, et peut aussi reconnaitre quelques autres types de paquets, répertoriés dans le livre excellent de Ralph Babel, "The Amiga Guru Guide". Pour chaque paquet, le nom du paquet est affiché dans le champ @{" Action " link Format_Action}. Chaque nom est montré en lettres capitales et est préfixé par un '#', pour aider à différencier la sortie des fonctions normalement surveillées. Si SnoopDos ne reconnait pas un paquet, ce paquet sera montré sous la forme "#(nnn)", ou nnn est le code du type de paquet en décimal. La plupart des paquets ont un ou plusieurs paramètres (dp_Arg1, dp_Arg2, etc.). Ces paramètres sont affichés dans le champ @{" Nom Cible " link Format_TargetName} comme nombre 32 bits hexadécimal. L'interprétation de chaque numéro dépend du paquet; voir le livre de Ralph pour une explication plus poussée. Le champ @{" Options " link Format_Options} donne le nom du device vers lequel le paquet est envoyé. Pour finir, le champ @{" Résultat " link Format_Result} montre la valeur de retour du paquet. La plupart des paquets retournent une valeur 32-bit en cas de succès, ou un code d'échec et un second code d'erreur en cas d'échec. SnoopDos affichera "OK" ou "Fail" pour chaque paquet, et affichera aussi la valeur effectivement retournée. Pour les paquets envoyés avec succès, cette valeur correspond à dp_Res1; pour des paquets ayant échoué, elle correspond à dp_Res2. (SnoopDos sait que certains paquets retournent -1 en cas d'échec, alors que d'autres retournent 0). Certains paquets retournent deux valeurs -- dans ce cas, SnoopDos affichera les deux valeurs. Du fait que la largeur par défaut du champ de Résultat n'est que de quatre caractères, vous pourrez avoir besoin de l'élargir pour voir ces informations supplémentaires. Ceci est facilement fait en déplaçant le bord droit du titre de l'évènement dans la fenêtre principale, ou en utilisant l'@{" Editeur de Format " link FormatEditor}. SnoopDos est parfois incapable de déterminer le code de résultat d'une opération de paquets. Ceci peut arriver si vous désactivez le débogueur de paquets alors qu'un paquet est toujours en attente, ou occasionellement s'il y a une lourde activité de paquets. (SnoopDos ne peut garder en mémoire que 5 paquets en cours à la fois). Lorsque cela arrive, le champ des Résultats affichera "Missed" pour indiquer que SnoopDos a abandonné l'attente du résultat. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" MonitorPackets " link MonitorPackets} @{" MonitorROMCalls " link MonitorROMCalls} @ENDNODE @NODE PatchRamLib @TITLE "Comande PatchRamLib" Commande : PATCHRAMLIB NOPATCHRAMLIB Cette commande contrôle si oui ou non SnoopDos doit modifier le processus en tâche de fond RamLib (qui est responsable du chargement des bibliothèques et des devices depuis le disque, dès qu'ils sont requis par un programme). Cette commande est légèrement inhabituelle du fait qu'elle doit être donnée dans une ligne de commande CLI, ou comme icône tooltype la première fois que SnoopDos est lancé, sinon elle n'aura aucun effet. Si elle n'est pas présente, l'action par défaut sera PATCHRAMLIB. Vous n'aurez normalement pas besoin de cette commande. Cependant, si vous voulez savoir exactement ce qui arrive à votre Amiga, vous aurez peut-être à l'utiliser. La raison de l'existence de cette commande est parce que le processus RamLib contient un bogue dans toutes les versions du Kickstart depuis le 2.0 jusqu'au 3.1. Ce bogue est invisible en utilisation normale, mais lorsque SnoopDos est lancé, il peut provoquer un plantage durant une activité système chargée. Pour ceux qui sont intéressés, ce bogue tient au fait que RamLib utilise SIGB_SINGLE comme bit de signal pour son port de message, ce qui implique que les appels système faits par RamLib ne peuvent pas utiliser en toute confiance ce signal pour n'importe quel but -- après tout, vous ne pouvez savoir quand un nouveau message peut arriver au port de messages de RamLib, en provoquant un signal SIGB_SINGLE. L'utilisation la plus critique de SIGB_SINGLE dans le système d'exploitation est pour synchroniser les opérations des sémaphores quand deux tâches essaient d'accéder à une même zone de données simultanément. La raison pour laquelle cela ne pose aucun problème en utilisation normale est parce que RamLib appelle très peu de fonctions système qui dépendent de SIBG_SINGLE, et celles qui le font (principalement LoadSeg, qui bloque la liste des devices) n'effectuent rien de particulièrement critique si elles devaient échouer. SnoopDos fait une utilisation intensive des sémaphores dans ses modifications. Ceci veut dire que tout appel qu'il surveille et qui est effectué par RamLib est potentiellement risqué. Les problèmes ne surviennent que lorsque plusieurs programmes demandent à RamLib de charger une bibliothèque ou un device en mémoire en même temps. De toutes façons, lorqu'un problème survient, il provoque un plantage instantané du fait que SnoopDos s'emmèle les pinceaux. Pour éviter ce problème, SnoopDos modifie le processus RamLib pour utiliser un bit de signal différent (en fait SIGBREAKB_CTRL_E). Cette modification est faite en toute sécurité, donc si un futur SetPatch devait corriger le bogue, aucun conflit n'apparaitra. Si vous avez le code source de SnoopDos qui est sur Aminet, vous pouvez voir le code de cette modification dans patches.c:InitRamLibPatch(). Malgré les efforts développés pour que la modification soit sûre et conpatible avec de futurs Amigas, il est possible que cela pose problème avec de futures versions du système d'exploitation. Il est aussi posible que vous n'appréciez pas l'idée d'un programme externe modifiant de la sorte la structure interne du système. Ainsi, NOPATCHRAMLIB offre un moyen à SnoopDos d'arrêter de faire ce changement. Un effet indésirable de l'utilisation de NOPATCHRAMLIB est que SnoopDos va automatiquement ignorer tous les appels faits par le processus RamLib. Ceci va occulter des informations utiles sur le nom des bibliothèques et des devices qui sont en train d'être chargés, mais pour la plupart, vous pouvez tout simplement activer la surveillance de @{" OpenLibrary " link OpenLibrary} et @{" OpenDevice " link OpenDevice} pour obtenir les mêmes informations. Notez que tout appel fait à la fonction @{" FindResident " link FindResident} par RamLib est automatiquement ignoré par SnoopDos; ceci permet de limiter la somme d'informations affichées dans la fenêtre à un niveau raisonnable. Voir aussi : @{" Index des commandes " link CommandIndex} @{" StackLimit " link StackLimit} @ENDNODE @NODE Pause @TITLE "Commande Pause" Commande : PAUSE Cette commande est utilisée pour stopper temporairement tout programme appelant des fonctions visualisées par SnoopDos, pour que vous ayez une chance de voir exactement ce que chaque programme essaie de faire. Elle est aussi disponible dans un gadget de la fenêtre @{" Principale " link MainWindow}. Vous pouvez utiliser la touche TAB pour sélectionner inconditionnellement la Pause (c'est parfois plus pratique que d'utiliser le raccourci clavier du gadget de Pause, du fait que cela active et désactive la Pause). Pause est particulièrement utile si vous avez un programme qui se plante lors de son chargement, puisqu'elle vous permet de suivre le déroulement des toutes premières actions du programme aussi rapidement ou doucement que vous le désirez. C'est aussi utile si un programme effectue beaucoup d'actions, trop vite pour que vous puissiez les lire -- vous pouvez stopper la sortie temporairement pour vous donner une chance de tout voir. Lorqu'un programme est stoppé, le champ de résultat affichera "WAIT". Lorsqu'une tâche est en état "WAIT", vous pouvez lui ordonner d'éxécuter la fonction courante, mais de se remettre en Pause dès qu'elle appellera à nouveau une fonction surveillée. Ceci vous permet de progresser pas-à- pas dans les appels de fonctions d'un programme. La manière la plus rapide de faire ceci est d'appuyer tout simplement sur la barre d'espace au clavier, ou de cliquer sur le gadget de scroll vers le bas avec la souris. Voir la commande @{" SingleStep " link SingleStep} pour plus de détails. Notez que SnoopDos stoppe les tâches, plutôt que le programme SnoopDos lui-même. Ainsi, si trois programmes essaient d'appeler une fonction surveillée, vous verrez les trois tâches listées dans la fenêtre principale, avec trois "WAIT" dans la colonne des résulats. Si vous choisissez le mode pas-à-pas, les trois programmes reçoivent l'autorisation d'éxécuter l'appel courant et d'avancer jusqu'au suivant. Si vous éxécutez certaines opérations sur des fichiers pendant que SnoopDos est en Pause, comme par exemple ouvrir un nouveau fichier trace ou sélectionner une nouvelle fonte depuis la fenêtre de requête des fontes, SnoopDos va temporairement débloquer la Pause pour la durée de l'opération. Toutes les tâches qui étaient en état "WAIT" lorsque l'action a débuté resteront dans l'état "WAIT", mais tout nouvel appel fait pendant l'activité fichier sera éxécuté normalement (ils apparaitront toujours dans le buffer des évènements, bien sûr). Ceci permet d'éviter des boucles infinies -- parfois l'accès à un fichier peut impliquer des opérations supplémentaires par un programme externe. Lorsque SnoopDos est stoppé, l'activité système peut quasiment être complètement arrêtée. Pour vous éviter une situation dans laquelle vous ne pourriez même plus désactiver la Pause, SnoopDos fait une Pause sur lui-même si vous sélectionnez la commande @{" Hide " link Hide}. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SingleStep " link SingleStep} @{"Unpause" link Unpause} @ENDNODE @NODE Quit @TITLE "Commande Quit" Commande : QUIT Cette commande ordonne à SnoopDos d'ôter toutes ses modifications et de s'effacer de la mémoire. Généralement, SnoopDos peut être quitté immédiatement -- même s'il modifie beaucoup de fonctions système, il utilise une technique qui permet à ces modifications d'être ôtées en toute sécurité. Cependant, parfois, lorsque vous demandez à quitter SnoopDos, un programme sera encore en train d'éxécuter l'une des fonctions modifiées par SnoopDos. Un exemple typique est lorsqu'un porgramme essaie d'ouvrir un fichier sur une disquette qui n'est pas présente dans le lecteur de disquettes, en provoquant l'affichage d'une fenêtre de requête du style "Insérez le volume...". Jusqu'à ce que la fenêtre de requête soit validée, SnoopDos ne sera pas capable de se désallouer de la mémoire. Dans une situation de ce type, SnoopDos vérifiera toutes les deux secondes s'il est possible de quitter; si ce n'est pas possible, il attendra encore. Après 10 secondes, il affichera une fenêtre de requête avec le nom de la fonction qui est en train d'être éxécutée -- ceci pourra vous donner un indice sur ce qui se passe. Il n'y a aucun problème pour relancer SnoopDos après l'avoir quitté, même si la première copie n'est pas totalement terminée. Cependant, vous pouvez rapidement saturer votre mémoire disponible si vous faites cela trop de fois de suite. Voir aussi: @{" Index des commandes " link CommandIndex} @{" Hide " link Hide} @ENDNODE @NODE ReadToolTypes @TITLE "Commande ReadToolTypes" Commande : READTOOLTYPES NOREADTOOLTYPES Cette commande permet d'activer ou désactiver la surveillance de deux fonctions différentes de l'icon.library: FindToolType() et MatchToolValue(). Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Ces deux fonctions sont utilisées par les programmes qui peuvent étre démarrés depuis un icône. FindToolType() est utilisé pour rechercher dans l'icône un tooltype donné, et MatchToolValue() est utilisé pour vérifier si un tooltype reconnu est mis à une valeur partiulière. Ceci peut être très utile pour identifier quels tooltypes un programme recherche dans un icône, et quelles valeurs ces tooltypes peuvent prendre, du fait que les programmeurs oublient souvent de bien les documenter. Tous les programmes n'utilisent pas ces fonctions, mais la plupart le font. Pour MatchToolValue(), le champ @{" Nom Cible " link Format_TargetName} montre les différentes valeurs pour le tooltype, chaque option étant séparée par un '|'. Le champ @{" Options " link Format_Options} montre le contenu actuel du tooltype en train d'être vérifié. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE Rename @TITLE "Commande Rename" Commande : RENAME NORENAME Cette commande active ou désactive la surveillance de la fonction Rename() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Rename() est appelée par une application pour changer le nom d'un fichier disque. L'ancien et le nouveau fichier doivent se trouver sur la même partition, mais n'ont pas besoin d'être dans le même répertoire. Rename est légèrement inhabituel dans le sens où il produit deux lignes de sortie dans la fenêtre de SnoopDos; la première montre le nom originel du fichier, alors que la deuxième montre le nouveau nom. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE RightAligned @TITLE "RightAligned command" Commande : RIGHTALIGNED Cette commande contrôle comment le champ @{" Nom Cible " link Format_TargetName} est affiché dans la fenêtre principale. Elle est aussi disponible comme sous-option du menu Nom Cible dans le menu de la fenêtre principale. Il y a généralement assez de place pour afficher le nom de la cible associée à chaque évènement, auquel cas cette commande n'est pas nécessaire. Cependant, si la colonne des noms des cibles est étroite, ou si vous avez activé @{" ShowFullPaths " link ShowFullPaths}, ce qui a pour effet de produire de longs noms de cibles, vous pourrez vous apercevoir que les noms des cibles sont trop longs pour rentrer en entier dans l'espace qui leur est alloué. Lorsque RightAligned est activé, la partie la plus à droite de chaque nom sera affichée, au lieu de la partie de gauche comme pour tous les autres champs. Ceci est souvent plus utile du fait que, s'il n'y a pas assez de place pour afficher le nom de fichier en entier, la partie la plus à droite incluera le nom de fichier qui serait autrement tronqué ou invisible. Lorsqu'un nom de cible est trop long pour rentrer complètement dans le champ, le symbole '«' apparaitra dans la première colonne de la sortie. Ceci indique qu'il y a encore des caractères sur la gauche des informations affichées. La majeure partie des gens trouvent utile de laisser l'affichage du nom cible à @{" LeftAligned " link LeftAligned} la plupart du temps, et n'utilisent l'alignement à droite que dans les cas particuliers où des noms trop longs sont affichés. Du fait que les deux modes ont leur raccourci clavier (Amiga-[ et Amiga-]), le changement peut être fait très rapidement depuis le clavier. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LeftAligned " link LeftAligned} @{" ShowFullPaths " link ShowFullPaths} @ENDNODE @NODE RowQualifier @TITLE "Commande RowQualifier" Commande : ROWQUALIFIER=IGNORE | NONE | SHIFT | ALT | CTRL | ALL Exemple : ROWQUALIFIER=ALL Cette commande sélectionne quelle touche (s'il y a lieu) doit être utilisée avant que SnoopDos ne vous autorise à mettre en valeur une ligne dans la fenêtre principale en cliquant dessus avec la souris. L'option de menu @{" Row selection key " link Menu_Row_selection_key} vous permet de changer ceci depuis le programme. SnoopDos vous autorise à mettre en valeur des lignes dans la fenêtre principale en cliquant dessus. Ceci est un moyen pratique d'identifier tout ce qui compose un ligne de sortie en proposant un guide horizontal visuel. Cependant, si vous utilisez une commodité "cliquer pour mettre au premier plan" comme celle distribuée avec le Workbench, vous pourrez noter que cliquer dans le fenêtre de SnoopDos pour la ramener au premier plan provoque un bref flash. Ceci peut être gênant. Modifier la touche d'autorisation de mise en valeur vous permet d'éviter ceci. Si votre système est configuré pour amener les fenêtres au premier plan lorsque vous faites un shift-double-clic, vous pouvez mettre la valeur de la touche à NONE -- ceci indique que les lignes ne seront mises en valeur que si aucune touche n'est utilisée. De même, si votre système est configuré pour ramener les fenêtres en premier plan lorsque vous faites un double-clic sans appuyer sur shift (ou toute autre touche), vous pouvez configurer la touche d'autorisation à SHIFT, ALT ou CTRL. Ceci indique que la touche indiquée doit être utilisée pour mettre en valeur une colonne -- cliquer sur la ligne sans appuyer sur une touche ne sera plus suffisant. L'option ALL permet de mettre en valeur les lignes, dès le moment où une des touches SHIFT, ALT ou CTRL est utilisée (quelle qu'elle soit). C'est généralement un moyen plus pratique que de choisir une touche précise. Enfin, la valeur par défaut est IGNORE. Lorsqu'elle est sélectionnée, SnoopDos ne tient pas compte du fait qu'une touche de contrôle soit appuyée ou non. Si vous n'utilisez pas d'utilitaire "cliquer pour ramener au premier plan", c'est probablement la meilleure option. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Event output " link EventOutput} @ENDNODE @NODE RunCommand @TITLE "Commande RunCommand" Commande : RUNCOMMAND NORUNCOMMAND Cette commande active ou désactive la surveillance de la fonction RunCommand() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Les applications appellent RunCommand() pour éxécuter une commande disque avec une liste de paramètres. La sortie des évènements produits pour cette fonction est assez inhabituelle, parce que le nom affiché dans le champ @{" Nom Processus " link Format_ProcessName} est généralement le nom de la commande en train d'être éxécutée, et pas le processus effectuant l'appel. Le champ @{" Nom Cible " link Format_TargetName} n'affiche que les paramètres de la ligne de commande pour cette commande, et pas le nom de la commande elle-même. Le champ @{" Options " link Format_Options} montre la taille de pile passée; si elle est trop petite, certaines commandes risquent de ne pas fonctionner correctement. Enfin, le champ @{" Résultat " link Format_Result} est affiché à "----" pendant que la commande s'éxécute, et est remplacé par le code de retour de la commande après éxécution complète (généralement 0 pour une éxécution qui a réussi). Un résultat indiquant "Fail" indique que la commande n'a pas pu être éxécutée du tout. Du fait que la commande éxécutée va probablement elle-même produire des sorties à afficher, vous pourrez avoir besoin de faire défiler le buffer de SnoopDos en arrière pour retrouver le code de retour de la ligne RunCommand si vous avez besoin de le trouver pour une raison ou une autre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Execute " link Execute} @{" Système " link System} @ENDNODE @NODE SaveBuffer @TITLE "Commande SaveBuffer" Commande : SAVEBUFFER "nomfichier" Exemple : SAVEBUFFER "ram:SnoopDos.txt" Cette commande sauve tout le contenu du buffer des évènements de SnoopDos vers le fichier indiqué. Ceci est utile si vous voulez préserver les informations de sortie pour les analyser plus tard, mais que vous avez oublié d'ouvrir un fichier trace. Cette fonction est disponible comme option du menu du Buffer. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CopyBuffer " link CopyBuffer} @{" CopyWindow " link CopyWindow} @{" SaveWindow " link SaveWindow} @ENDNODE @NODE SaveDefSettings @TITLE "Commande SaveDefSettings" Commande : SAVEDEFSETTINGS Cette commande sauve les préférences actuelles de SnoopDos vers le fichier par défaut des préférences, comme défini par la commande @{" Settings " link Settings}. Elle est aussi disponible dans un gadget de la fenêtre @{" Principale " link MainWindow}, et comme option du menu des Préférences. Si aucun fichier n'a été explicitement défini, les préférences seront écrites dans le fichier qui a été chargé pendant le lancement de SnoopDos. Si aucun fichier n'a pu être trouvé, les préférences seront écrites dans le fichier ENVARC:SnoopDos.prefs. La prochaine fois que vous lancerez SnoopDos, ces préférences seront automatiquement rappelées. Les préférences sauvées incluent les valeurs de tous les gadgets des fenêtres de Préférences et des Fonctions, et la valeur de la plupart des gadgets booléens, ainsi que la position et la taille de chaque fenêtre. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LoadDefSettings " link LoadDefSettings} @{" LoadSettings " link LoadSettings} @{" SaveSettings " link SaveSettings} @{" Préférences " link Settings} @ENDNODE @NODE SaveSettings @TITLE "Commande SaveSettings" Commande : SAVESETTINGS "fichierpreferences" Exemple : SAVESETTINGS "ram:SnoopDos.prefs" Cette commande écrit les valeurs actuelles de tous les gadgets et options des menus dans le fichier indiqué. Ce fichier peut alors être rechargé plus tard pour reconfigurer SnoopDos avec ces préférences. Le fichier des préférences est en texte pur, et peut être édité à la main si nécessaire. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LoadDefSettings " link LoadDefSettings} @{" LoadSettings " link LoadSettings} @{" SaveDefSettings " link SaveDefSettings} @{" Préférences " link Settings} @ENDNODE @NODE SaveWindow @TITLE "Commande SaveWindow" Commande : SAVEWINDOW "nomfichier" Exemple : SAVEWINDOW "ram:SnoopDos.txt" Cette commande sauve le contenu de la fenêtre principale dans le fichier indiqué. Elle est aussi disponible comme option de menu dans le menu du Buffer. Si le format courant du buffer est trop large pour rentrer complètement dans la fenêtre principale, seule la partie actuellement affichée sera sauvée. Si elle ne comporte pas assez d'informations, vous pouvez utiliser la commande @{" SaveBuffer " link SaveBuffer} à la place, et effacer les lignes en trop dont vous n'avez pas besoin. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CopyBuffer " link CopyBuffer} @{" CopyWindow " link CopyWindow} @{" SaveBuffer " link SaveBuffer} @ENDNODE @NODE ScreenName @TITLE "Commande ScreenName" Commande : SCREENNAME "Nom Ecran" Exemple : SCREENNAME "Workbench" Cette commande travaille conjointement avec l'option NAMED de la commande @{" ScreenType " link ScreenType} pour permettre à SnoopDos d'ouvrir ses fenêtres sur un écran public indiqué. Elle est aussi disponible dans un gadget de la fenêtre des @{" Préférences " link SettingsWindow}. Si nom de l'écran n'a pas été trouvé, SnoopDos utilisera l'écran par défaut. Si le type de l'écran est FRONT ou DEFAULT, le nom de l'écran défini ici sera ignoré. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HotKey " link HotKey} @{" ScreenType " link ScreenType} @ENDNODE @NODE ScreenType @TITLE "Commande ScreenType" Commande : SCREENTYPE=DEFAULT | FRONT | NAMED Exemple : SCREENTYPE=FRONT Cette commande détermine quel écran SnoopDos utilisera pour ses fenêtres. Elle est aussi disponible comme gadget dans la fenêtre des @{" Préférences " link SettingsWindow}. Si le type de l'écran est DEFAULT, SnoopDos s'ouvrira sur l'écran public par défaut. C'est généralement l'écran du Workbench. Si le type de l'écran est FRONT, SnoopDos va essayer d'ouvrir sur l'écran public le plus en avant. Beaucoup d'applications récentes ouvrent automatiquement leurs écrans publics, et vous pouvez utiliser des utilitaires pour créer d'autres écrans publics. Cette façon de faire est pratique parce qu'elle vous permet d'appeler SnoopDos sur l'écran avec lequel vous êtes en train de travailler à tout moment en appuyant sur la @{" Hotkey " link Hotkey} définie. Si le type de l'écran est NAMED, alors SnoopDos va essayer de s'ouvrir sur l'écran public dont le nom correspond à celui défini par la commande @{" ScreenName " link ScreenName}. Notez que SnoopDos ne créera pas un écran de ce nom par lui-même -- l'écran doit déjà exister. Si un tel écran ne peut être trouvé, SnoopDos s'ouvrira sur l'écran par défaut. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HotKey " link HotKey} @{" ScreenName " link ScreenName} @ENDNODE @NODE ScrollDown @TITLE "Commande ScrollDown" Commande : SCROLLDOWN Exemple : SCROLLDOWN 10 Cette commande déplace le buffer des évènements de SnoopDos de lignes vers le bas. Elle est équivalente à l'utilisation du gadget flèche vers le bas dans la fenêtre @{" Principale " link MainWindow}, ou à appuyer sur la touche curseur vers le bas du clavier. Voir aussi : @{" Index des commandes " link CommandIndex} @{" GotoLine " link GotoLine} @{" ScrollUp " link ScrollUp} @ENDNODE @NODE ScrollUp @TITLE "Commande ScrollUp" Commande : SCROLLUP Exemple : SCROLLUP 10 Cette commande déplace le buffer des évènements de lignes vers le haut. Elle est équivalente à l'utilisation du gadget flèche vers le haut dans la fenêtre @{" Principale " link MainWindow}, ou à appuyer sur la touche curseur vers le haut du clavier. Voir aussi : @{" Index des commandes " link CommandIndex} @{" GotoLine " link GotoLine} @{" ScrollUp " link ScrollUp} @ENDNODE @NODE SendRexx @TITLE "Commande SendRexx" Commande : SENDREXX NOSENDREXX Cette commande active ou désactive la surveillance des messages ARexx envoyés par des scripts ARexx ou des applications. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Ceci peut être utile si vous voulez suivre la magie d'un script qui se déroule, ou si vous essayez de comprendre pourquoi une application ne répond pas comme vous l'espériez. Le champ @{" Nom Cible " link Format_TargetName} montre la commande envoyée à l'application, et le champ @{" Options " link Format_Options} montre le nom du port de l'application. Lorsque cette fonction est activée, SnoopDos doit surveiller chaque message envoyé par le système, de façon à identifier lesquels sont des messages ARexx. Il se peut donc que votre système soit un peu ralenti. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" FindPort " link FindPort} @{" MonitorPackets " link MonitorPackets} @{" PacketDebugger " link PacketDebugger} @ENDNODE @NODE Settings @TITLE "Commande Settings" Commande : SETTINGS="nom" Exemple : SETTINGS="ENVARC:SnoopDos.prefs" Cette commande définit le nom du fichier par défaut des préférences que SnoopDos essayera de charger lors de son lancement. Normalement, c'est quelquechose que vous devriez inclure dans l'icône tooltype de SnoopDos, ou dans la ligne de commande CLI. Si vous ne définissez pas explicitement un fichier de préférences, SnoopDos regardera dans les répertoires PROGDIR:, ENVARC: et S: au démarrage pour un fichier appelé SnoopDos.prefs. S'il ne peut trouver ce fichier dans l'un des répertoires, il utilisera le nom ENVARC:SnoopDos.prefs pour les futures sauvegardes. Notez que cette commande n'effectue pas le chargement du fichier des préférences; elle indique seulement où le fichier des préférences peut être trouvé. Lorsque vous utilisez l'option Sauver Prefs. dans la fenêtre @{" principale " link MainWindow}, c'est ce nom de fichier qui sera utilisé. Vous pouvez aussi utiliser cette commande depuis un fichier de préférences. Supposons par exemple que vous vouliez effectuer un certain nombre d'actions à chaque fois que SnoopDos démarre -- ouvrir un nouveau fichier trace, ouvrir l'éditeur de format, etc. Normalement, si vous incluez ces commandes dans le fichier des préférences, elles seront écrasées et réécrites la première fois où vous sauverez les préférences. En utilisant la commande SETTINGS pour changer le nom du fichier des préférences depuis le fichier des préférences lui-même, vous pouvez éviter ceci. Par exemple : SETTINGS "EnvArc:SnoopDos.realprefs" LOADDEFSETTINGS OPENLOG "ram:SnoopDos.log" OPENFUNCTION Si ce fichier était sauvé sous ENVARC:SnoopDos.prefs, SnoopDos commencerait par charger les vraies préférences par défaut depuis "ENVARC:SnoopDos.realprefs", puis ouvrirait un fichier trace et finalement ouvrirait l'éditeur de format. Toute future sauvegarde des préférences par défaut serait redirigée vers ENVARC:SnoopDos.realprefs, et le fichier de commandes ne serait pas réécrit. Voir aussi : @{" Index des commandes " link CommandIndex} @{" LoadDefSettings " link LoadDefSettings} @{" LoadSettings " link LoadSettings} @{" SaveDefSettings " link SaveDefSettings} @{" SaveSettings " link SaveSettings} @ENDNODE @NODE SetupWindowPos @TITLE "Commande SetupWindowPos" Commande : SETUPWINDOWPOS=, Exemple : SETUPWINDOWPOS=0,20 Cette commande est utilisée pour changer la position de la fenêtre des préférences sur l'écran courant. Si la fenêtre des préférences est ouverte, elle est immédiatement déplacée, sinon elle apparaitra à la nouvelle position la prochaine fois qu'elle sera ouverte. et sont les coordonnées en pixels du coin haut-gauche de la fenêtre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Settings window " link SettingsWindow} @ENDNODE @NODE SetVar @TITLE "Commande SetVar" Commande : SETVAR NOSETVAR Cette commande active ou désactive la surveillance des fontions SetVar() et DeleteVar() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Function " link FunctionWindow}. SetVar() est la contrepartie logique de la fonction GetVar(); elle permet à un programme de créer ou de mettre à jour une variable d'environnement avec une nouvelle valeur. Comme avec GetVar(), les variables Global, Local et Alias sont reconnues, et une * derrière le type indique que le programme s'attend à ce que la variable contienne une information de type binaire, plutôt que du texte. Voir la commande @{" GetVar " link GetVar} pour plus d'informations. DeleteVar() est utilisé pour effacer complètement les variables d'environnement. Les trois mêmes types de variables décrits ci-dessus sont reconnus. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE Show @TITLE "Commande Show" Commande : SHOW Cette commande ouvre la fenêtre principale de SnoopDos sur l'écran actuel (comme défini par la commande @{" ScreenType " link ScreenType}). Si la fenêtre était déjà ouverte, elle est ramenée au premier plan. Si la fenêtre était ouverte mais sur un autre écran, elle est réouverte sur l'écran actuel. Cette commande est automatiquement éxécutée dès que vous appuyez sur la @{" HotKey " link HotKey} définie. Elle est aussi automatiquement éxécutée si vous lancez SnoopDos depuis le CLI sans options, ou si vous double-cliquez sur l'icône de SnoopDos alors qu'il était déjà en train de tourner. Voir aussi : @{" Index des commandes " link CommandIndex} @{" CX_Popup " link CX_Popup} @{" Hide " link Hide} @{" HotKey " link HotKey} @{" Main window " link MainWindow} @ENDNODE @NODE ShowCLI @TITLE "Commande ShowCLI" Commande : SHOWCLI NOSHOWCLI Cette commande active ou désactive la préférence ShowCLI de SnoopDos. Cette préférence peut aussi être contrôlée grâce à un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. Cette préférence détermine comment le champ @{" Nom Processus " link Format_ProcessName} affiche le nom de la commande CLI qui appelle la fonction surveillée. Lorsqu'elle est activée, le nom de la commande est affiché, préfixé par le numéro du CLI dans lequel elle tourne (exemple : "[4] Multiview"). Si elle est désactivée seul le nom de la commande sera affiché. Les processus en tâche de fond et les programmes démarrés depuis le Workbench ne seront pas affectés. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @ENDNODE @NODE ShowFullPaths @TITLE "Commande ShowFullPaths" Commande : SHOWFULLPATHS NOSHOWFULLPATHS Cette commande active ou désactive la préférence ShowFullPaths de SnoopDos. Cette préférence peut aussi être contrôlée grâce à un gadget dans la fenêtre des @{" Fonctions " link FunctionWindow}. Dès qu'un programme donne un nom de fichier à une fonction AmigaDos, le nom de fichier est interprété comme étant relatif au répertoire courant du programme, à moins qu'un chemin absolu soit spécifié avec le nom du fichier. Si le programme surveillé change souvent de répertoire, il peut devenir difficile de savoir quel répertoire il utilisait à un moment donné. Choisir cette option fait en sorte que SnoopDos préfixe toujours les noms de fichiers avec le chemin complet avant de les montrer dans la fenêtre. Ceci peut produire des noms de fichiers assez longs, qui occupent beaucoup de place dans la fenêtre de SnoopDos, vous ne devriez donc utiliser cette option que si vous en avez vraiment besoin, plutôt que de la laisser tout le temps. Si vous avez beaucoup de noms de fichiers longs, vous pouvez utiliser les raccourcis clavier pour @{" LeftAligned " link LeftAligned} et @{" RightAligned " link RightAligned}, Amiga-[ and Amiga-] pour voir rapidement le début et la fin du nom de fichier. Notez que si un programme essaie d'accéder à un fichier ou un volume qui n'est pas monté, SnoopDos sera incapable d'afficher le chemin de ce fichier en entier. Dans ce cas, seul le nom du volume sera indiqué, suivi de points, et le nom de fichier, pour indiquer que les informations sur ce répertoire ne sont pas disponibles. Par exemple : "Work:.../nomfichier". SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" UseDeviceNames " link UseDeviceNames} @ENDNODE @NODE ShowGadgets @TITLE "Commande ShowGadgets" Commande : SHOWGADGETS Cette commande autorise l'affichage du panneau des gadgets dans la fenêtre @{" Principale " link MainWindow}. Elle est aussi disponible comme option dans le menu de la fenêtre principale. Il est pratique d'avoir tous les gadgets disponibles facilement, mais certaines personnes préfèrent avoir une ou deux lignes supplémentaires à la place. Même lorsque les gadgets sont désactivés, les raccourcis clavier de chaque gadget fonctionnent toujours. Tous les gadgets ont leur équivalent dans les options du menu, qui peuvent être aussi être utilisées. Pour avoir le maximum de place pour l'affichage des évènements, vous pouvez aussi désactiver le gadget @{" Ligne d'état " link HideStatus}. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HideGadgets " link HideGadgets} @{" HideStatus " link HideStatus} @{" ShowStatus " link ShowStatus} @{" TextSpacing " link TextSpacing} @ENDNODE @NODE ShowStatus @TITLE "Commande ShowStatus" Commande : SHOWSTATUS Cette commande autorise l'affichage du gadget @{" Ligne d'état " link StatusLine} dans la fenêtre @{" Principale " link MainWindow}. Elle est aussi disponible comme option dans le menu de la fenêtre principale. La ligne d'état n'est pas strictement nécessaire, mais elle permet une visualisation "d'un coup d'oeil" pour savoir si un fichier trace est ouvert ou non, et pour savoir si SnoopDos est actuellement en @{" Pause " link Pause} ou @{" Arrêté " link Disable}. Certaines personnes préfèrent sacrifier la ligne d'état pour permettre à plus de lignes d'affichage des évènements d'être affichées dans la fenêtre principale. Si c'est votre cas, vous pouvez aussi vouloir désactiver les gadgets @{" Boutons " link HideGadgets}, ce qui vous permettra d'afficher un maximun de lignes de texte. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" HideGadgets " link HideGadgets} @{" HideStatus " link HideStatus} @{" ShowGadgets " link ShowGadgets} @{" TextSpacing " link TextSpacing} @ENDNODE @NODE SimpleRefresh @TITLE "Commande SimpleRefresh" Commande : SIMPLEREFRESH Cette commande choisit la méthode de rafraîchissement Simple pour toutes les fenêtres de SnoopDos. Elle est aussi disponible comme sous-option de l'option "Type fenêtre" dans le menu de la fenêtre principale. Le rafraîchissement Simple des fenêtres économise de la mémoire. Lorsqu'une fenêtre est partiellement occultée, la partie non-visible est oubliée, et n'est redessinée que lorsque la fenêtre sera à nouveau totalement visible. Redessiner la fenêtre peut prendre du temps sur les Amigas les plus lents, où la commande @{" Smart refresh " link SmartRefresh} est plus appropriée. Certaines cartes graphiques du commerce comme la carte Picasso donnent en fait de meilleurs résultats avec Simple Refresh qu'avec Smart Refresh. Le mieux est d'essayer tout simplement les deux méthodes et de choisir celle qui convient le mieux. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SmartRefresh " link SmartRefresh} @ENDNODE @NODE SingleStep @TITLE "Commande SingleStep" Commande : SINGLESTEP Cette commande est utilisée lorsque SnoopDos est en Pause. Elle permet à chaque tâche en attente d'éxécuter la fonction en cours et d'avancer jusqu'à la suivante. Voir la commande @{" Pause " link Pause} pour plus d'informations. La commande SingleStep est aussi disponible depuis une option du menu Projet. Vous pouvez aussi cliquer sur le gadget flèche vers le bas dans la fenêtre principale lorsque la barre de défilement est positionnée en bas. Vous pouvez aussi appuyer sur les touches Espace ou Return du clavier pour plus de facilité. Encore plus utile : la touche Tab qui éxécutera la commande SingleStep, mais aura en plus l'avantage de mettre SnoopDos en mode Pause s'il ne l'était pas déjà. Si votre @{" Fichier Trace " link OpenLog} est bufferisé, SnoopDos videra le buffer vers le disque à chaque fois que vous éxécuterez SingleStep. Ceci vous permettra de sauver les principales informations dans l'éventualité d'un plantage. Attention, cela peut aussi avoir pour effet d'introduire des erreurs sur votre disque si le plantage arrive pendant une écriture sur le disque. Ainsi, si vous craignez qu'un programme donné ne se plante, essayez de le lancer sans fichier trace d'abord, puis dirigez la trace vers un device sûr comme PRT: or RAD:. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Pause " link Pause} @{" Unpause " link Unpause} @ENDNODE @NODE SmartRefresh @TITLE "Commande SmartRefresh" Commande : SMARTREFRESH Cette commande choisit la méthode de rafraîchissement Smart Refresh pour toutes les fenêtres de SnoopDos. Elle est aussi disponible comme sous-option de l'option "Type fenêtre" du menu de la fenêtre principale. Les fenêtres Smart Refresh sont très utilisées, car elles permettent à une fenêtre partiellement occultée d'être instantanément redessinée lorsqu'elle est à nouveau visible, sans délai notable. Cependant, cette méthode consomme plus de mémoire que @{" Simple refresh " link SimpleRefresh}. Elle peut aussi être plus lente sur certaines cartes graphiques du commerce comme la carte Picasso, surtout en mode 256 couleurs. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" SimpleRefresh " link SimpleRefresh} @ENDNODE @NODE StackLimit @TITLE "Commande StackLimit" Commande : STACKLIMIT= Exemple : STACKLIMIT=1000 Cette commande définit combien d'espace libre de la pile une tâche doit avoir avant que SnoopDos ne surveille l'un de ses appels de fonctions. Ceci est nécessaire car certaines tâches installées par des devices ont des piles très petites; l'espace supplémentaire utilisé par SnoopDos provoquerait un plantage lors de la surveillance de cette fonction. (CrossDos en est un exemple.). est la taille d'espace libre de la pile nécessaire en octets. Notez que ceci ne correspond pas forcément à la taille totale de la pile pour la tâche, mais à la taille de la pile libre avant que l'appel à la fonction soit effectué. Par exemple, une tâche avec une pile de 20K peut utiliser 19,5K avant de rencontrer la modification faite par SnoopDos (et serait donc ignorée si la était de 500 ou plus) alors qu'une tâche avec une pile de 2K peut n'utiliser que 0,5K, laissant 1,5K libre pour SnoopDos. Pour déterminer la taille courante de la pile, SnoopDos utilise les valeurs tc_SPLower et tc_SPUpper dans la structure de la tâche. Si une tâche ou un processus a alloué sa propre tâche, elles peuvent ne pas être correctes -- si c'est la cas, SnoopDos surveillera quand même la fonction, estimant que l'application a alloué une pile assez grosse pour suffir aux besoins de SnoopDos. Notez qu'il n'y a pas moyen de définir cette option depuis SnoopDos; vous devez la changer en éditant le fichier des préférences directement, ou en l'ajoutant comme ToolType à l'icône de SnoopDos. SnoopDos écrit automatiquement cette commande dans le fichier des préférences de SnoopDos lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" PatchRamLib " link PatchRamLib} @ENDNODE @NODE System @TITLE "Commande System" Commande : SYSTEM NOSYSTEM Cette commande active ou désactive la surveillance de la fonction System() de la dos.library. Elle est aussi disponible dans un gadget de la fenêtre des @{" Fonctions " link FunctionWindow}. System() est l'une des plus puissantes fonctions d'AmigaDOS. Elle permet à une ligne de commande arbitraire d'être éxécutée, comme si elle avait été tapée dans un Shell. Comme avec @{" RunCommand " link RunCommand}, le champ @{" Options " link Format_Options} montre la taille de la pile allouée à la commande. Le champ @{" Résultat " link Format_Result} montre le code de retour de la commande (généralement 0), ou "Fail" si la commande n'a pu être éxécutée. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Execute " link Execute} @{" RunCommand " link RunCommand} @ENDNODE @NODE TaskPri @TITLE "Commande TaskPri" Commande : TASKPRI Exemple : TASKPRI 5 Cette commande est utilisée pour changer la priorité du processus principal SnoopDos. Une sélection de priorités souvent utilisées est disponible par une option dans le menu Projet. Normalement, SnoopDos a par défaut une priorité de 0. Mais vous pouvez préférer une valeur de priorité plus grande ou plus petite. Si SnoopDos a une priorité supérieure à 0, il sera toujours à jour dans la surveillance des évènements. Ceci est plus particulièrement vrai si vous utilisez @{" SegTracker " link Format_SegmentName} pour déterminer le module appelant pour chaque évènement, puisque, autrement, un module peut parfois se décharger lui-même avant que SnoopDos n'ait eu la chance de demander à SegTracker de le localiser. Cela dit, utiliser une priorité forte peut avoir pour effet de ralentir votre machine. Si SnoopDos a une priorité inférieure à 0, il aura peu d'influence sur les performances générales du système, même si sa fenêtre est ouverte. Cependant, la sortie ne sera rafraichie que lorsque aucun autre programme n'est en attente d'éxécution, elle peut donc arriver par paquets soudains, plutôt que régulièrement. Même avec une basse priorité, SnoopDos ne ratera aucun évènement. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Pause " link Pause} @ENDNODE @NODE TextSpacing @TITLE "Commande TextSpacing " Commande : TEXTSPACING Exemple : TEXTSPACING 1 Cette commande définit le nombre de pixels supplémentaires entre des lignes de sortie adjacentes dans la fenêtre @{" Principale " link MainWindow}. Vous pouvez aussi changer l'espacement du texte par une option du menu de la fenêtre principale. Si vous utilisez une petite fonte, augmenter l'espacement peut rendre l'affichage plus agréable à lire. Les valeurs valides pour sont 0, 1 ou 2. Lorsque l'espacement est changé, le contenu du buffer sera immédiatement rafraichi avec le nouvel espacement. Cependant, la position des gadgets de la fenêtre ne sera pas ajustée avant la prochaine modification de taille de la fenêtre. Ainsi, vous pourrez constater que si vous modifiez légèrement la fenêtre, vous pourrez avoir une ligne de texte supplémentaire du fait que les gadgets se repositionnent d'eux-mêmes pour reflèter le changeement. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" ShowGadgets " link ShowGadgets} @{" ShowStatus " link ShowStatus} @ENDNODE @NODE Unpause @TITLE "Commande Unpause" Commande : UNPAUSE Cette commande a l'effet inverse de la commande @{" Pause " link Pause}. Elle peut aussi être activée en désélectionnant l'option Pause dans le menu Projet, ou le gadget Pause dans la fenêtre principale. Vous pouvez aussi appuyer sur SHIFT-TAB pour annuler inconditionnellement toute Pause ou @{" Arrêt " link Disable} en cours. Désélectionner Pause permet à toute tâche qui était en état WAIT de reprendre son cours. Pour permettre à de telles tâches d'éxécuter un seul appel de fonction et de se retrouver à nouveau en mode WAIT, voir la commande @{" SingleStep " link SingleStep}. Voir aussi : @{" Index des commandes " link CommandIndex} @{" Pause " link Pause} @{" SingleStep " link SingleStep} @ENDNODE @NODE UseDeviceNames @TITLE "Commande UseDeviceNames" Commande : USEDEVICENAMES NOUSEDEVICENAMES Cette commande active ou désactive les préférences UseDevicesNames de SnoopDos. Elle peut aussi être contrôlée par un gadget dans la fenêtre des @{" Fonctions " link FunctionWindow}. UseDeviceNames travaille de pair avec la préférence @{" ShowFullPaths " link ShowFullPaths}. Si UseDeviceNames est activé, tout fichier étendu à son nom de chemin complet sera affiché en utilisant le nom du device disque. S'il est désactivé, le nom du volume du disque sera utilisé à la place. Par exemple, lorsque UseDeviceNames est activé, un nom étendu peut apparaitre sous la forme "HD0:Files/Data". Le même nom affiché avec UseDeviceNames désactivé serait de la forme "System3.0:Files/Data". L'utilisation du nom du device est souvent préférée, puisque les noms de devices sont typiquement constitués de trois caractères, et prennent de ce fait moins de place. Ils sont normalement également uniques, ce qui permet parfois d'éviter toute confusion. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" ShowFullPaths " link ShowFullPaths} @ENDNODE @NODE WindowFont @TITLE "Commande WindowFont" Commande : WINDOWFONT "nompolice.taille" Exemple : WINDOWFONT "helvetica.11" Cette commande sélectionne la police utilisée par SnoopDos pour tous les gadgets des fenêtres. Vous pouvez aussi changer la police grâce à une fenêtre de requêtes de polices dans la fenêtre des @{" Préférences " link SettingsWindow}. Toute police peut être utilisée; si vous choisissez une police trop large pour une fenêtre particulière, SnoopDos reviendra automatiquement à une police plus petite, mais seulement pour cette fenêtre. SnoopDos écrit automatiquement cette commande dans le fichier des préférences lorsque vous sauvez les préférences. Voir aussi : @{" Index des commandes " link CommandIndex} @{" BufferFont " link BufferFont} @ENDNODE @NODE WindowWidth @TITLE "Commande WindowWidth" Commande : WINDOWWIDTH Exemple : WINDOWWIDTH 80 Cette commande ajuste la largeur de la fenêtre principale de SnoopDos pour qu'un nombre d'exactement caractères soient affichés horizontalement. Si la fenêtre principale n'est pas ouverte, cette commande n'a aucun effet. Si la largeur demandée fait que la fenêtre est trop petite ou trop grande, SnoopDos va essayer de trouver une valeur qui soit la plus proche de celle que vous avez demandé. Zéro est une valeur spéciale qui fera en sorte que la largeur soit calculée pour qu'elle affiche entièrement la chaine du format actuel. La raison principale pour laquelle vous pourriez utiliser cette commande est que vous pouvez plus facilement créer votre format adapté à une sortie vers un fichier ou vers une imprimante. Ceci est particulièrement vrai si vous utilisez un Workbench sous une haute résolution comme par exemple 1024x768, auquel cas la fenêtre de SnoopDos peut être plus large que les 80 caractères habituels. Gardez à l'esprit que lorsque SnoopDos imprime vers un fichier trace, il ajoute un caractère au début de chaque ligne. Généralement ce caractère est un espace, mais il peut parfois être '\\" or '/' -- voir la commande @{" OpenLog " link OpenLog} pour plus de détails. Dans tous les cas, ce caractère supplémentaire a besoin d'être pris en compte lorsque vous définissez la largeur de la fenêtre. Par exemple, une fenêtre de 79 caractères de largeur produira des lignes de 80 caractères de long dans le fichier trace. Pour des raisons pratiques, le menu de la fenêtre de SnoopDos propose plusieurs largeurs communes par le sous-menu "Changer largeur fenêtre". Voir aussi : @{" Index des commandes " link CommandIndex} @{" Format editor " link FormatEditor} @ENDNODE @remark -------------------------------------------------------------- @remark @remark Menu reference @remark @remark -------------------------------------------------------------- @NODE Menu_Index @TITLE "Guide référence du menu de SnoopDos" SnoopDos propose les menus suivants dans la fenêtre @{" Principale " link MainWindow}. Cliquez sur l'un des noms de menus pour plus d'informations. @{" PROJET " link Menu_Project } @{" FENETRES " link Menu_Windows} +----------------------+ +-------------------------------+ | @{" Ouvrir Trace... " link Menu_Open_log } | | @{" Préférences... " link Menu_Show_setup } | | @{" Fermer Trace " link Menu_Close_log } | | @{" Fonctions... " link Menu_Show_functions } | | ------------------- | | @{" Format... " link Menu_Show_format } | | @{" · Pause " link Menu_Pause } | | ---------------------------- | | @{" · Arrêter " link Menu_Disable } | | @{" Largeur fenêtre " link Menu_Change_window_width } | | ------------------- | | ---------------------------- | | @{" Pas à pas " link Menu_Single_step } | | @{" Espacement texte " link Menu_Text_spacing } | | ------------------- | | @{" Type de fenêtre " link Menu_Window_type } | | @{" Priorité tâche " link Menu_Task_priority } | | @{" Nom Cible " link Menu_Target_name } | | ------------------- | | ---------------------------- | | @{" Aide... " link Menu_Help } | | @{" · Montrer ligne d'état? " link Menu_Show_status_line } | | @{" A propos... " link Menu_About } | | @{" · Montrer les gadgets? " link Menu_Show_gadgets } | | ------------------- | | ---------------------------- | | @{" Cacher " link Menu_Hide } | | @{" · Ouverture automatique? " link Menu_Auto_open_on_output } | | @{" Quitter " link Menu_Quit } | | @{" · Arrêter quand caché? " link Menu_Disable_when_hidden } | +----------------------+ +-------------------------------+ @{" PREFERENCES " link Menu_Settings } @{" BUFFER " link Menu_Buffer} +----------------------+ +-------------------------------+ | @{" Charger... " link Menu_Load } | | @{" Copier fenêtre vers clip " link Menu_Copy_window_to_clip} | | @{" Sauver " link Menu_Save } | | @{" Copier buffer vers clip " link Menu_Copy_buffer_to_clip} | | @{" Save sous... " link Menu_Save_as } | | ---------------------------- | | ------------------- | | @{" Sauver fenêtre... " link Menu_Save_window } | | @{" Valeurs défaut " link Menu_Reset_to_defaults} | | @{" Sauver buffer... " link Menu_Save_buffer } | | @{" Dernières sauvées " link Menu_Last_saved } | | ---------------------------- | | @{" Restaurer " link Menu_Restore } | | @{" Vider buffer " link Menu_Clear_buffer } | | ------------------- | +-------------------------------+ | @{" · Créer icônes? " link Menu_Create_icons } | +----------------------+ @ENDNODE @NODE Menu_Project "Menu Projet de SnoopDos" Le menu projet de SnoopDos contient les options suivantes. Cliquez sur l'une des options pour plus d'informations. MENU PROJET +------------------------+ | @{" Ouvrir Trace... " link Menu_Open_log } | Démarrer la sortie trace vers un nouveau fichier | @{" Fermer Trace " link Menu_Close_log } | Arrêter la trace vers le fichier trace | --------------------- | | @{" · Pause " link Menu_Pause } | Mettre en pause toutes les tâches surveillées qui sont appellées | @{" · Arrêter " link Menu_Disable } | Arrêter de surveiller les fonctions | --------------------- | | @{" Pas à pas " link Menu_Single_step } | Fait avancer toutes les tâches en Pause d'un pas | --------------------- | | @{" Priorité Tâche " link Menu_Task_priority} | Changer la priorité de la tâche SnoopDos | --------------------- | | @{" Aide... " link Menu_Help } | Appeler l'aide en ligne | @{" A propos... " link Menu_About } | Affiche la version et l'auteur | --------------------- | | @{" Cacher " link Menu_Hide } | Fermer la fenêtre et positionne SnoopDos en tâche de fond | @{" Quitter " link Menu_Quit } | Oter SnoopDos de la mémoire +------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Menu Fenêtres " link Menu_Windows} @{" Menu Préférences " link Menu_Settings} @{" Menu Buffer " link Menu_Buffer} @ENDNODE @NODE Menu_Open_log "Menu Projet/Ouvrir Trace..." MENU PROJET / OUVRIR TRACE... Cette option du menu vous permet d'ouvrir un nouveau fichier trace. Une fenêtre de requête de fichiers de type ASL est affichée, pour vous permettre de choisir le nom du fichier trace. Si vous choisissez un fichier déjà existant, SnoopDos vous donnera la possibilité de réécrire le fichier existant, ou d'ajouter la sortie en fin du fichier. Si vous désirez diriger la trace vers un device plutôt qu'un fichier disque, tapez le nom du device dans le gadget Répertoire de la fenêtre de requête ASL (par exemple PRT:). Dans ce cas, le nom du fichier ne doit pas être spécifié, à moins que vous ne dirigiez la sortie vers une fenêtre CON: où le nom du fichier doit représenter les options de la fenêtre (qui sont généralement le nom de la fenêtre ou CLOSE). Lorsqu'un fichier trace est ouvert, SnoopDos copie toute sortie affichée dans la fenêtre principale vers ce fichier, permettant un enregistrement permanent. Généralement, le format du fichier trace est le même que celui affiché dans la fenêtre principale, mais vous pouvez changer ceci en utilisant l'option @{" LogFormat " link LogFormat}. Notez que, contrairement au bouton @{" Open log " link MainOpenLog} dans la fenêtre principale, cette option affichera toujours une fenêtre de requête de fichiers. Lorsqu'un fichier trace est ouvert, cette option du menu sera désactivée. Sélectionner l'option menu @{" Fermer trace " link Menu_Close_log} l'autorisera à nouveau. Voir aussi : @{" Menu projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" OpenLog " link OpenLog} @ENDNODE @NODE Menu_Close_log "Menu Projet/Fermer trace" MENU PROJET / FERMER TRACE Cette option est le pendant de l'option du menu @{" Ouvrir Trace... " link Menu_Open_log}. Elle ferme tout fichier actuellement ouvert. Si aucun fichier trace n'est ouvert cette option est désactivée. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" CloseLog " link CloseLog} @ENDNODE @NODE Menu_Pause "Menu Projet/Pause" MENU PROJET / PAUSE Sélectionner cette option fait en sorte que toute tâche qui appelle une fonction surveillée par SnoopDos soit mise en pause avant d'éxécuter l'appel de la fonction. Ceci vous permet de voir les paramètres de la fonction avant que l'appel soit effectivement fait. Vous pouvez utiliser l'option du menu @{" Pas à pas " link Menu_Single_step} pour éxécuter la fonction et avancer à la suivante. Dé-sélectionner cette option du menu permettra aux tâches de s'éxécuter normalement à nouveau. Pour plus de détails, voir la commande @{" Pause" link Pause}. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" Pause " link Pause} @ENDNODE @NODE Menu_Disable "Menu Projet/Arrêter" MENU PROJET / ARRETER Sélectionner cette option désactive la surveillance de toutes les fonctions C'est un moyen pratique d'arrêter SnoopDos sans avoir à désélectionner manuellement chaque fonction, ou sans quitter. Pour autoriser à nouveau la surveillance, dé-sélectionnez tout simplement l'option du menu. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" Disable " link Disable} @ENDNODE @NODE Menu_Single_step "Menu Projet/Pas à pas" MENU PROJET / PAS A PAS Cette option fonctionne parallèlement à l'option du menu @{" Pause " link Menu_Pause}. Sélectionner Pas à pas permet de faire éxécuter à toutes les tâches en pause la fonction sur laquelle elles sont en attente. Chaque tâche sera automatiquement mise en pause la prochaine fois qu'elle rencontrera une fonction surveillée par SnoopDos. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" SingleStep " link SingleStep} @ENDNODE @NODE Menu_Task_priority "Menu Projet/Priorité tâche" MENU PROJET / PRIORITE TACHE Cette option du menu vous permet de changer la priorité de la tâche principale SnoopDos. Le sous-menu contient plusieurs valeurs classiques de priorités. Pour plus de détails sur les avantages et désavantages du changement de la priorité des tâches, voir la commande @{" TaskPri " link TaskPri}. Voir aussi : @{" Menu projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" TaskPri " link TaskPri} @ENDNODE @NODE Menu_Help "Menu Projet/Aide..." MENU PROJET / AIDE Cette option charge le fichier d'aide dans Amigaguide, en le positionnant sur la page contenu. Vous pouvez alors accéder à de l'aide sur n'importe quelle fonction de SnoopDos. Si vous obtenez une fenêtre message d'erreur disant "Impossible d'ouvrir la base de données", cela veut dire qu'AmigaGuide n'a pas pu localiser le fichier SnoopDos.guide. Si vous copiez le fichier dans le répertoire du programme SnoopDos, ou dans HELP:Français, cela ne devrait pas arriver. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" Help " link Help} @ENDNODE @NODE Menu_About "Menu Projet/A propos" MENU PROJET / A PROPOS Cette option affiche une fenêtre de requête contenant des informations sur l'auteur de SnoopDos, la version du programme, les conditions de distribution et le nom du port ARexx. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre Principale " link MainWindow} @ENDNODE @NODE Menu_Hide "Menu Projet/Cacher" MENU PROJET / CACHER Cette option ferme toutes les fenêtres de SnoopDos, mais laisse SnoopDos surveiller l'activité système en tâche de fond. Elle correspond à la commande @{" Hide " link Hide}. Si @{" HideMethod " link HideMethod} est à AUCUNE, cette option n'est pas disponible. Lorsque SnoopDos est caché, la fenêtre principale peut être réouverte en appuyant sur la @{" HotKey " link HotKey} définie. Selon la méthode pour cacher, vous pouvez aussi ouvrir l'AppIcon de SnoopDos, ou sélectionner l'option du menu Montrer SnoopDos dans le menu Outils du Workbench. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" Hide " link Hide} @ENDNODE @NODE Menu_Quit "Menu Projet/Quitter" MENU PROJET / QUITTER Cette option est utilisée pour ôter SnoopDos de la mémoire. Elle correspond à la commande @{" Quit " link Quit}. Notez que si un appel à l'une des fonctions surveillées en encore est cours, il se peut que SnoopDos soit dans l'impossibilité de quitter immédiatement. Voir la documentation sur la commande Quitter pour plus de détails. Voir aussi : @{" Menu Projet " link Menu_Project} @{" Fenêtre principale " link MainWindow} @{" Quit " link Quit} @ENDNODE @NODE Menu_Windows "Menu des fenêtres de SnoopDos" Le menu des fenêtres de SnoopDos contient les options suivantes qui contrôlent les quatre fenêtres utilisées par SnoopDos. Cliquez sur l'une des options pour plus informations. MENU DES FENETRES +--------------------------------+ | @{" Préférences... " link Menu_Show_setup } | Ouvre la fenêtre des préférences de SnoopDos | @{" Fonctions... " link Menu_Show_functions } | Ouvre la fenêtre des fonctions de SnoopDos | @{" Format... " link Menu_Show_format } | Ouvre la fenêtre de l'éditeur de format de SnoopDos | ----------------------------- | | @{" Largeur fenêtre " link Menu_Change_window_width } | Change le nombre de colonnes de texte | ----------------------------- | | @{" Espacement texte " link Menu_Text_spacing } | Ajuste l'espacement entre les lignes de texte | @{" Type de fenêtre " link Menu_Window_type } | Sélectionne le rafraîchissement Simple ou Smart des fenêtres | @{" Nom cible " link Menu_Target_name } | Aligne le champ Nom Cible à gauche ou à droite | ----------------------------- | | @{" · Montrer la ligne d'état? " link Menu_Show_status_line } | Active ou désactive la ligne d'état de SnoopDos | @{" · Montrer les gadgets? " link Menu_Show_gadgets } | Active ou désactive les gadgets de la fenêtre principale | ----------------------------- | | @{" · Ouverture automatique? " link Menu_Auto_open_on_output } | Si activé, ouverture automatique au lancement | @{" · Arrêter quand caché? " link Menu_Disable_when_hidden } | Si activé, ne surveille que lorsque la fenêtre est ouverte +--------------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Menu Projet menu " link Menu_Project} @{" Menu préférences " link Menu_Settings} @{" Menu Buffer " link Menu_Buffer} @ENDNODE @NODE Menu_Show_setup "Menu Fenêtres/Montrer Préférences..." MENU FENETRES / MONTRER PREFERENCES... Cette option du menu ouvre la fenêtre des @{" Préférences " link SettingsWindow} de SnoopDos. Elle correspond à la commande @{" OpenSetup " link OpenSetup}. Si la fenêtre était déjà ouverte, elle est ramenée au premier plan. Si vous appuyez sur la touche SHIFT pendant que vous sélectionnez cette option, la fenêtre sera alors fermée. Voir aussi : @{" Menu Fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" OpenSetup " link OpenSetup} @ENDNODE @NODE Menu_Show_functions "Menu fenêtres/Montrer Fonctions..." MENU FENETRES / MONTRER FONCTIONS... Cette option du menu ouvre la fenêtre des @{" Fonctions " link SettingsWindow} de SnoopDos. Elle correspond à la commande @{" OpenFunction " link OpenFunction}. Si la fenêtre était déjà ouverte, elle est ramenée au premier plan. Si vous appuyez sur la touche SHIFT en même temps, la fenêtre sera alors fermée. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" OpenFunction " link OpenFunction} @ENDNODE @NODE Menu_Show_format "Menu fenêtres/Montrer format..." MENU FENETRES / MONTRER FORMAT... Cette option du menu ouvre l'@{" Editeur de format " link FormatEditor} de SnoopDos. Elle correspond à la commande @{" OpenFormat " link OpenFormat}. Si la fenêtre était déjà ouverte, elle est ramenée au premier plan. Si vous appuyez sur la touche SHIFT en même temps, la fenêtre sera alors fermée. Voir aussi : @{" Menu Fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" OpenFormat " link OpenFormat} @ENDNODE @NODE Menu_Change_window_width "Menu Fenêtres/Largeur fenêtre" MENU FENETRES / LARGEUR FENETRE Cette option du menu vous permet d'ajuster la largeur de la fenêtre principale, pour qu'un nombre donné de colonnes de texte soit affiché. Elle correspond à la commande @{" WindowWidth " link WindowWidth}. Le sous-menu donne quelques largeur utiles. Si vous êtes en train de mettre en place un format d'affichage dans un fichier trace, vous pouvez mettre la largeur de la fenêtre à 78 ou 79 pour être sûr que votre format pourra tenir sur une page à imprimer ou dans un écran 80 colonnes. Gardez à l'esprit que la sortie vers un fichier trace nécessite une colonne supplémentaire; voir la commande @{" OpenLog " link OpenLog} pour plus de détails. En plus des tailles prédéfinies, vous pouvez aussi sélectionner "Au mieux". Ceci utilisera une valeur de largeur de la fenêtre qui soit la plus grande pour afficher entièrement le format actuel. Si vous avez redimensionné la fenêtre de SnoopDos avec la souris, ceci est un moyen pratique de vous assurer que vous ne perdez pas d'espace horizontalement. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" WindowWidth " link WindowWidth} @ENDNODE @NODE Menu_Text_spacing "Menu fenêtres/Espacement texte" MENU FENETRES / ESPACEMENT TEXTE Cette option du menu vous permet de modifier l'espacement entre les lignes de texte adjacentes dans la fenêtre principale. Elle correspond à la commande @{" TextSpacing " link TextSpacing}. Vous pouvez choisir 0, 1 ou 2 pixels supplémentaires de largeur dans le sous-menu. Chacun a ses préférences; essayez les trois, et choisissez celle qui vous plait le plus. Voir aussi : @{" Menu des fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" TextSpacing " link TextSpacing} @ENDNODE @NODE Menu_Window_type "Menu fenêtresu/Type de fenêtre" MENU FENETRES / TYPE DE FENETRE Cette option du menu vous permet de choisir quel type de rafraîchissement des fenêtres vous voulez que SnoopDos emploie. Les deux options des sous-menus correspondent aux commandes @{" SimpleRefresh " link SimpleRefresh} et @{" SmartRefresh " link SmartRefresh}. Les fenêtres à rafraîchissement Simple utilisent moins de mémoire, et peuvent s'afficher plus vite sur certaines cartes graphiques du commerce. Cependant, elles sont souvent plus lentes, du fait que l'Amiga doit recréer le contenu de chaque fenêtre à chaque fois qu'elles sont visibles à nouveau en entier. Les fenêtres à rafraîchissement Smart prennent moins de mémoire, mais sont beaucoup plus rapides sur les Amigas lents. Essayez les deux possibilités, et décidez laquelle est la meilleure pour vous. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" SimpleRefresh " link SimpleRefresh} @{" SmartRefresh " link SmartRefresh} @ENDNODE @NODE Menu_Target_name "Menu fenêtres/Nom Cible" MENU FENETRES / NOM CIBLE Cette option du menu vous permet de choisir de quelle manière vous voulez que le champ @{" Nom Cible " link Format_TargetName} soit affiché dans la fenêtre principale. Elle correspond aux commandes @{" LeftAligned " link LeftAligned} et @{" RightAligned " link RightAligned}. Si le Nom Cible est aligné à gauche, sa colonne ressemble à toutes les autres. S'il est aligné à droite, lorsqu'un nom est trop long pour être affiché entièrement dans la colonne, la portion la plus à droite du nom sera affichée au lieu de la portion la plus à gauche. Ceci est indiqué par un symbole "«" dans la première colonne du nom. L'alignement à droite est particulièrement utile si vous utilisez l'option @{" ShowFullPaths " link ShowFullPaths}, du fait qu'elle vous permet de voir le nom d'un fichier dont le nom de chemin est très long, au lieu de n'en montrer que le début. Les raccourcis clavier pour ces deux options sont AmigaGauche-[ et AmigaDroite-] (respectivement pour l'alignement à gauche et à droite); ceci fait en sorte qu'il soit très facile de passer en alignement à droite si vous voyez un Nom Cible trop grand, en repasser immédiatement à l'alignement à gauche lorsque vous aurez vu le nom qui vous était caché. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" LeftAligned " link LeftAligned} @{" RightAligned " link RightAligned} @ENDNODE @NODE Menu_Show_status_line "Menu fenêtres/Montrer la ligne d'état?" MENU FENETRES / MONTRER LA LIGNE D'ETAT? Cette option du menu vous permet de contrôler si oui ou non la ligne d'état doit être affichée dans la fenêtre prinicpale. Elle correspond aux commandes @{" ShowStatus " link ShowStatus} et @{" HideStatus " link HideStatus}. Cacher la ligne d'état vous permet d'obtenir plus de place pour l'affichage des évènements. Cependant, la laisser visible vous permet de vous rendre compte de l'état de SnoopDos d'un coup d'oeil. Essayez les deux et voyez de vous-même ce que vous préférez. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" ShowStatus " link ShowStatus} @{" HideStatus " link HideStatus} @ENDNODE @NODE Menu_Show_gadgets "Menu fenêtres/Montrer les gadgets?" MENU FENETRES / MONTRER LES GADGETS? Cette option vous permet de contrôler si oui ou non les boutons gadgets doivent être affichés dans la fenêtre principale. Elle correspond aux commandes @{" ShowGadgets " link ShowGadgets} et @{" HideGadgets " link HideGadgets}. Cacher les gadgets vous permet d'avoir plus de place pour l'affichage des évènements. Cependant, les laisser visible vous permet plus de possibilités avec la souris. Tous les gadgets ont des équivalents dans les options des menus, que vous pouvez utiliser lorsque les gadgets sont cachés. Vous pouvez aussi continuer à utiliser les raccourcis clavier des gadgets lorsqu'ils sont cachés. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" ShowGadgets " link ShowGadgets} @{" HideGadgets " link HideGadgets} @ENDNODE @NODE Menu_Auto_open_on_output "Menu fenêtres/Ouverture automatique?" MENU FENETRES / OUVERTURE AUTOMATIQUE? Cette option du menu contrôle si oui ou non SnoopDos doit automatiquement s'ouvrir quand un évènement survient alors qu'il est caché. Elle correspond à la commande @{" AutoOpen " link AutoOpen}. Généralement, vous laisserez cette option désactivée, puisque SnoopDos ne tournerait en tâche de fond que très peu de temps avant d'être automatiquement rappelé au premier plan, ce qui n'est pas le but recherché. Cependant, vous pouvez parfois attendre qu'une action spécifique survienne, provoquée par une tâche particulière. Dans ces circonstances, il peut être utile de fermer la fenêtre de SnoopDos, en étant sûr de ne pas rater un évènement vital lorsqu'il se produit. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" AutoOpen " link AutoOpen} @ENDNODE @NODE Menu_Disable_when_hidden "Menu fenêtres/Arrêter quand caché?" MENU FENETRES / ARRETER QUAND CACHE? Cette option du menu contrôle si oui ou non SnoopDos doit automatiquement arrêter la surveillance de toutes les fonctions quand il tourne en tâche de fond. Elle correspond à la commande @{" DisableWhenHidden " link DisableWhenHidden}. Généralement, vous laisserez cette option désactivée. Cependant, si vous n'utilisez SnoopDos qu'occasionellement, mais appréciez la possibilité de pouvoir l'appeler grâce à une Hotkey, activer cette option vous permet de garder SnoopDos chargé en mémoire et prêt à être utilisé, sans ralentissement de votre système. Voir aussi : @{" Menu fenêtres " link Menu_Windows} @{" Fenêtre principale " link MainWindow} @{" DisableWhenHidden " link DisableWhenHidden} @ENDNODE @NODE Menu_Settings "Menu des Préférences de SnoopDos" Le menu des préférences de SnoopDos contient les options qui permettent de contrôler la sauvegarde et le chargement des options du programme. Cliquez sur l'une des options pour plus d'informations. MENU PREFERENCES +------------------------+ | @{" Charger... " link Menu_Load } | Charger un nouveau fichier de préférences | @{" Sauver " link Menu_Save } | Sauver les préférences actuelles comme préférences par défaut | @{" Sauver sous... " link Menu_Save_as } | Sauver les préférences actuelles dans un nouveau fichier | --------------------- | | @{" Valeurs par defauts " link Menu_Reset_to_defaults} | Installer les préférences par défaut | @{" Dernières sauvées " link Menu_Last_saved } | Installer les préférences les plus récemment sauvées | @{" Restaurer " link Menu_Restore } | Restaurer les préférences utilisées au lancement | --------------------- | | @{" · Créer des icônes? " link Menu_Create_icons } | Si activé, sauver des icônes avec les fichiers de préférences +------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Menu Projet " link Menu_Project} @{" Menu fenêtres " link Menu_Windows} @{" Menu Buffer " link Menu_Buffer} @ENDNODE @NODE Menu_Load "Menu préférences/Charger..." MENU PREFERENCES / CHARGER... Cette option du menu vous permet de charger un fichier de préférences de SnoopDos. Elle correspond à la commande @{" LoadSettings " link LoadSettings}. Un fichier de préférences est un fichier texte standard, qui contient une liste de commandes SnoopDos à éxécuter. Généralement, il a été créé par SnoopDos lui-même en résulat d'une commande @{" SaveSettings " link SaveSettings} précédemment éxécutée, mais peut aussi être créé par l'utilisateur. La première ligne doit être "" sans quoi le fichier ne sera pas reconnu comme fichier de préférences valide. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" LoadSettings " link LoadSettings} @ENDNODE @NODE Menu_Save "Menu préférences/Sauver" MENU PREFERENCES / SAUVER Cette option du menu sauve les préférences actuelles de SnoopDos dans le fichier des préférences, comme défini par la commande @{" Settings " link Settings}. Vous pouvez arriver au même résultat en sélectionnant le gadget Sauver Prefs. dans la fenêtre principale. La prochaine fois que vous lancez SnoopDos, ces préférences seront automatiquement chargées. Ceci vous permet de conserver votre configuration de session en session. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" SaveDefSettings " link SaveDefSettings} @ENDNODE @NODE Menu_Save_as "Menu préfrences/Sauver sous..." MENU PREFERENCES / SAUVER SOUS... Cette option du menu vous permet de sauver les préférences actuelles vers un fichier de votre choix. Elle correspond à la commande @{" SaveSettings " link SaveSettings}. Ceci peut être utile en tant que point de départ de génération d'un fichier de configuration modifié. Cela peut aussi être un moyen pratique pour produire une liste sur papier de vos préférences, pour s'y référer ultérieurement -- tapez simplement PRT: dans le champ du répertoire de la fenêtre de requête de fichier ASL. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" SaveSettings " link SaveSettings} @ENDNODE @NODE Menu_Reset_to_defaults "Menu préférences/Valeurs par défaut" MENU PREFERENCES / VALEURS PAR DEFAUT Cete option du menu est un moyen pratique d'installer les préférences par défaut que SnoopDos utilise lorsque vous le démarrez sans fichier de configuration. Ceci est utile si vous avez tellement modifié les préférences que vous voulez tout reprendre à zéro. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" LoadSettings " link LoadSettings} @ENDNODE @NODE Menu_Last_saved "Menu préférences/Dernières sauvées" MENU PREFERENCES / DERNIERES SAUVEES Cette option du menu vous permet de recharger les dernières préférences qui ont été sauvées sur disque. Généralement, ce seront les préférences que SnoopDos a chargé lors de son initialisation, mais si vous avez sauvé les préférences depuis, le jeu de préférences le plus récent sera utilisé. Ce fichier est en fait relu depuis le disque comme si vous aviez utilisé @{" LoadSettings " link LoadSettings}. Vous pourrez aussi trouver cette option pratique si vous effectuez un changement dans les préférences (et plus particulièrement dans le format d'affichage) et que vous changez d'avis -- en sélectionnant cette option, vous pouvez rapidement annuler le changement. Voir aussi : @{" Menu préférnces " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" LoadSettings " link LoadSettings} @ENDNODE @NODE Menu_Restore "Menu préférences/Restaurer" MENU PREFERENCES / RESTAURER Cette option permet de restaurer les préférences que SnoopDos a chargé pendant son initialisation. Ceci est utile si vous modifiez les préférences et que vous appuyez accidentellement sur Sauver Prefs., ce qui rend vos changements permanents. En sélectionnant Restaurer, vous pouvez retrouver les préférences originelles et les sauver à nouveau. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" LoadSettings " link LoadSettings} @ENDNODE @NODE Menu_Create_icons "Menu préférences/Créer des icônes?" MENU PREFERENCES / CREER DES ICONES? Cette option du menu contrôle si oui ou non SnoopDos doit créer des icônes pour tous les fichiers sous Workbench. Elle correspond à la commande @{" CreateIcons " link CreateIcons}. Créer des icônes est pratique, parce que cela vous permet de manipuler des fichiers de préférences depuis le Workbench. Vous pouvez faire un double-clic sur le fichier des préférences pour charger les préférences dans SnoopDos (dans la mesure ou SnoopDos est dans le même répertoire ou dans votre chemin AmigaDOS) et vous pouvez aussi ajouter des commandes supplémentaires au ToolType pour que cet icône effectue des actions comme ouvrir un fichier trace. Voir la section @{" Fichier de préférences " link SettingsFiles} pour plus de détails. Notez qu'aucun icône n'est sauvé pour le fichier par défaut -- si vous voulez qu'il ait un icône, utilisez l'option du menu @{" Sauver sous " link Menu_Save_As}. Voir aussi : @{" Menu préférences " link Menu_Settings} @{" Fenêtre principale " link MainWindow} @{" CreateIcons " link CreateIcons} @ENDNODE @NODE Menu_Buffer "Menu du Buffer de SnoopDos" Le menu du buffer de SnoopDos contient des options qui contrôlent la sauvegarde et l'effacement du buffer des évènements. Cliquez sur l'une des options pour plus d'informations. MENU BUFFER +--------------------------------+ | @{" Copier fenêtre vers clip " link Menu_Copy_window_to_clip} | Copier le contenu de la fenêtre vers le clipborad | @{" Copier buffer vers clip " link Menu_Copy_buffer_to_clip} | Copier le contenu du buffer vers le clipboard | ----------------------------- | | @{" Sauver fenêtre... " link Menu_Save_window } | Sauver le contenu de la fenêtre vers un fichier | @{" Sauver buffer... " link Menu_Save_buffer } | Sauver le contenu du buffer vers un fichier | ----------------------------- | | @{" Vider buffer " link Menu_Clear_buffer } | Vider le buffer de tous les évènements +--------------------------------+ Voir aussi : @{" Fenêtre principale " link MainWindow} @{" Menu Projet " link Menu_Project} @{" Menu fenêtres " link Menu_Windows} @{" Menu des préférences " link Menu_Settings} @ENDNODE @NODE Menu_Copy_window_to_clip "Menu Buffer/Copier fenêtre vers clip" MENU BUFFER / COPIER FENETRE VERS CLIP Cette option du menu copie le contenu actuel de la fenêtre principale vers le clipboard. Elle correspond à la commande @{" CopyWindow " link CopyWindow}. Ceci est pratique lorque vous voulez copier une portion de la sortie des évènements de SnoopDos dans un traitement de textes -- vous pouvez tout simplement positionner la fenêtre pour afficher la portion qui vous intéresse, sélectionner Copier fenêtre et sélectionner Coller dans votre éditeur. Si la largeur de la fenêtre est insuffisante pour afficher une ligne entière de sortie des évènements, seule la portion affichée dans la fenêtre sera copiée. Vous pouvez utiliser l'option du menu @{" Copier buffer " link Menu_Copy_buffer_to_clip}. pour copier le buffer en entier vers le clipboard. Voir aussi : @{" Menu buffer " link Menu_Buffer} @{" Fenêtre principale " link MainWindow} @{" CopyWindow " link CopyWindow} @ENDNODE @NODE Menu_Copy_buffer_to_clip "Menu buffer/Copier buffer vers clip" MENU BUFFER / COPIER BUFFER VERS CLIP Cette option du menu copie le contenu entier du buffer des évènements vers le clipboard. Elle correspond à la commande @{" CopyBuffer " link CopyBuffer}. Ceci est pratique si vous voulez copier la sortie des évènements de SnoopDos vers un traitement de textes ou un éditeur de textes -- vous pouvez simplement sélectionner Copier buffer, puis sélectionner Coller dans votre éditeur de textes. Du fait que le contenu entier du buffer est copié, vous devrez faire attention avant d'utiliser cette fonction, surtout s'il y a eu beaucoup d'évènements. Vous pourrez trouver plus pratique d'utiliser l'option @{" Copy window " link Menu_Copy_window_to_clip}, qui ne copie que le texte affiché dans la fenêtre principale, plutôt que le buffer tout entier. Voir aussi : @{" Menu buffer " link Menu_Buffer} @{" Fenêtre principale " link MainWindow} @{" CopyBuffer " link CopyBuffer} @ENDNODE @NODE Menu_Save_window "Menu buffer/Sauver fenêtre..." MENU BUFFER / SAUVER FENETRE... Cette option du menu vous permet de sauver le contenu actuel de la fenêtre principale vers un fichier. Elle correspond à la commande @{" SaveWindow " link SaveWindow}. Si la largeur de la fenêtre est insuffisante pour afficher une ligne complète d'évènements, seule cette portion affichée dans la fenêtre sera sauvée. Voir aussi : @{" Menu buffer " link Menu_Buffer} @{" Fenêtre principale " link MainWindow} @{" SaveWindow " link SaveWindow} @ENDNODE @NODE Menu_Save_buffer "Menu buffer/Sauver buffer..." MENU BUFFER / SAUVER BUFFER... Cette option du menu vous permet de sauver le contenu entier du buffer des évènements vers un fichier. Elle correspond à la commande @{" SaveBuffer " link SaveBuffer}. Ceci est très pratique si vous avez surveillé l'activité d'un programme, et que vous vous apercevez trop tard que vous auriez dû ouvrir un fichier trace; vous pouvez utiliser cette option pour enregistrer les actions d'un programme. Voir aussi : @{" Menu buffer " link Menu_Buffer} @{" Fenêtre principale " link MainWindow} @{" SaveBuffer " link SaveBuffer} @ENDNODE @NODE Menu_Clear_buffer "Menu buffer/Vider buffer" MENU BUFFER / VIDER BUFFER Cette option du menu efface toute les sorties stockées dans le buffer des évènements. Elle correspond à la commande @{" ClearBuffer " link ClearBuffer}. Vider le buffer est toujours une bonne idée avant que vous ne commenciez à surveiller l'activité d'un nouveau programme, parce que cela évite toute confusion entre la sortie du nouveau programme et celle du programme précédent. De plus, les numéros de séquence des évènements repartent depuis le numéro 1 à nouveau, ce qui rend plus aisé le suivi des nouveaux évènements. Voir aussi : @{" Menu buffer " link Menu_Buffer} @{" Fenêtre principale " link MainWindow} @{" ClearBuffer " link ClearBuffer} @ENDNODE @remark -------------------------------------------------------------- @remark @remark End of menu reference @remark @remark -------------------------------------------------------------- @NODE Index @TITLE "SnoopDos Index" -- SNOOPDOS INDEX -- @{" Affichage " link EventOutput } @{" L'auteur " link Author } @{" Arrêter " link Disable } @{" Les nouveautés " link WhatsNew } @{" Ligne d'état " link StatusLine } @{" Champ Action " link Format_Action } @{" Limite pile " link StackLimit } @{" Champ Adresse Appel " link Format_CallAddr } @{" Champ Compteur " link Format_Count } @{" Mise en route rapide " link QuickStart } @{" Champ Date " link Format_Date } @{" Champ Heure " link Format_Time } @{" Nom processus " link Format_ProcessName } @{" Champ Hunk:Offset " link Format_HunkOffset } @{" Nom segment " link Format_SegmentName } @{" Champ Nom Cible " link Format_TargetName } @{" Champ N°tâche " link Format_TaskID } @{" Options des menus " link Menu_Index } @{" Champ résultat " link Format_Result } @{" Champs des options " link Format_Options } @{" Pas à pas " link SingleStep } @{" Contenu " link MAIN } @{" Patch Ramlib " link PatchRamLib } @{" Pause " link Pause } @{" Déboguage des paquets " link PacketDebugger } @{" Personnaliser trace " link AddLog } @{" Depuis le CLI " link CLI } @{" Depuis le Workbench " link Workbench } @{" Quitter SnoopDos " link Quit } @{" Distribution " link Distribution } @{" Remerciements " link Credits } @{" Editeur de format " link FormatEditor } @{" Support ARexx " link ARexx } @{" Fenêtre des fonctions " link FunctionWindow } @{" Support Clavier " link MainKeys } @{" Fenêtre principale " link MainWindow } @{" Support Clipboard " link CopyWindow } @{" Fenêtre préférences " link SettingsWindow } @{" Support des icônes " link CreateIcons } @{" Fichier préférences " link SettingsFiles } @{" Support des langages " link Language } @{" Fichier trace " link OpenLog } @{" Support fontes " link WindowFont } @{" Format des champs " link Format } @{" Support GNU C " link MonitorPackets } @{" Support Hotkey " link HotKey } @{" Historique " link History } @{" Surveiller appels ROM " link MonitorROMCalls } @{" Surveiller ARexx " link SendRexx } @{" Iconifier " link HideMethod } @{" Syntaxe des commandes " link CommandSyntax } @{" Ignorer tâches " link MatchName } @{" Index des commandes " link CommandIndex } @{" Titres des évènements " link EventHeadings } @{" Introduction " link Introduction } @ENDNODE