Format de fichier trcfmt

Objectif

Stocke les modèles de trace.

Descriptif

La commande trcrpt , qui formate les rapports de trace, utilise des modèles de trace pour déterminer comment les données contenues dans les entrées de trace doivent être formatées. Tous les modèles de trace sont stockés dans le fichier modèle maître, /etc/trcfmt. Les modèles de trace identifient l'ID de point d'ancrage de trace, le numéro de version et d'édition, le niveau d'indentation, le libellé d'événement et les zones de description des données. Les zones de description de données contiennent des informations de formatage pour les données d'entrée de trace et peuvent être répétées autant de fois que nécessaire pour formater toutes les données de trace dans l'entrée de trace.

Modification de ce fichier

Le fichier trcfmt ne doit être modifié qu'à l'aide de la commande trcupdate . Les points d'ancrage de trace dont la valeur est inférieure à 010 sont destinés à être utilisés en interne par les fonctions de trace. Si ces points d'ancrage sont modifiés, les performances de la trace, en particulier de trcrpt, sont imprévisibles.

Entrées de trace

L'organisation du mot de crochet varie selon que l'application qui produit le mot de crochet est une application 32 bits ou une application 64 bits.

Mots de point d'ancrage de trace 32 bits:

Mots de point d'ancrage de trace 64 bits:

Pointeur de données

DATA POINTER est un pointeur vers la position en cours dans l'entrée de trace. Le paramètre DATA POINTER est modifié par le trcrpt lorsqu'il interprète le modèle et formate l'entrée de trace. La position initiale de DATA POINTER est le troisième octet de HookWord for HookTypes 1, 9, 2, A, 6,etEet le premier octet après HookWord for HookTypes 0et8.

Formatage des données de trace

Niveau d'indentation

Les données de trace formatées sont alignées dans des colonnes correspondant à la source de l'événement de trace. Il est identifié dans chaque modèle à l'aide du descripteur L=X . Les valeurs possibles de la commande L=X sont les suivantes:

Caractère de continuation

Une barre oblique inversée (\) à la fin d'une ligne doit être utilisée pour continuer un modèle sur la ligne suivante.

Libellés ou chaînes de texte

Les chaînes individuelles (ou les libellés) peuvent être séparées par un nombre quelconque d'espaces ou de tabulations, mais tous les espaces excédentaires sont compressés à un blanc dans le rapport de trace, sauf si d'autres structures de format sont appliquées. Les libellés sont placés entre guillemets ("").

Codes de format

POINTEUR DE DONNEES Codes de format de position

Codes de format de sortie

Codes de format de l'interpréteur

Instructions de commutation

Une instruction SWITCH est un code de format suivi d'une virgule. Chaque entrée CASE de l'instruction SWITCH se compose des éléments suivants:

1. Une 'MatchValue' avec un type (généralement numérique) correspondant au code de format.
2. Un'Chaîne' 'simple ou un'Descripteur' nouveau'délimité par des accolades. Un descripteur est une séquence de codes de format, de chaînes, de commutateurs et de boucles.
3. Délimiteur de virgule.

Le commutateur se termine par une entrée CASE sans délimiteur de virgule. L'entrée CASE est sélectionnée en tant que première entrée dont la valeur MatchValue est égale à l'extension du code de format. La valeur de correspondance spéciale'\ *'est un caractère générique et correspond à n'importe quoi.

Le pointeur DATA est avancé par le code de format.

Instructions LOOP

Les boucles sont utilisées pour générer des tampons binaires de données ; par conséquent, le descripteur d'un LOOP est généralement X0 ou X1. La syntaxe d'une boucle est LOOP format_code {descriptor}. Le descripteur est exécuté N fois, où N est la valeur numérique du code de format.

Le pointeur DATA est avancé par le code de format et par les opérations du descripteur.

Macros

Les macros sont des variables temporaires qui fonctionnent comme des variables de shell. Une valeur leur est affectée avec la syntaxe suivante:

{{ $xxx = EXPR }}

où EXPR est une combinaison de codes de format, de macros et de constantes. Les opérateurs + (addition),-(soustraction), / (division) et * (multiplication). sont autorisés dans les macros.

Macros prédéfinies

Macros intégrées

Les macros intégrées sont les suivantes:

Fichiers