Quels sont les fichiers à inclure dans les rapports de plantage ?

Symptômes

Un plantage vient de se produire ou se produit fréquemment.

Cause

Le moyen le plus fiable de signaler un plantage est de fournir un scénario reproductible. Veuillez donc fournir une procédure étape par étape avec un contexte de départ bien défini. Cette méthode peut demander un certain effort, mais c'est de loin la plus susceptible de réussir.

En général, pour qu'un scénario soit reproductible, il est préférable que l'environnement soit aussi standard que possible. Il s'agit d'un processus de simplification et d'élimination. Si possible, un scénario devrait commencer avec un profil d'utilisateur BricsCAD® par défaut, un nouveau dessin, aucun plug-ins tiers ou de personnalisation de l'utilisateur, et un fichier CUI par défaut.

S'il n'est pas possible de fournir un scénario reproductible, nous pouvons dans certains cas déduire suffisamment d'informations à partir de fichiers de diagnostic supplémentaires.

Solution

Soumettez une demande de support comprenant les détails suivants :

  • Vérifiez si le problème peut être reproduit en mode sans échec. Pour exécuter BricsCAD® en mode sans échec, suivez les étapes décrites dans la section Comment démarrer BricsCAD® en mode sans échec, sans aucune application?

    Si le problème disparaît en mode sans échec, il peut être utile de repasser en mode normal et de désactiver ou désinstaller les plug-ins et les personnalisations pour identifier le coupable.

  • crash_report.txt ;
    Remarque :
    • Le fichier crash_report.txt est créé sous Windows et, à partir de BricsCAD® V24.2.02, sous Linux.
    • Sur macOS, le fichier bricscad-YYY-MM-DD-XXXXXXXX.ips est généré par le système d'exploitation.
    Le rapport de plantage est sauvegardé dans le dossier de démarrage de BricsCAD®. L'emplacement de ce dossier dépend de la façon dont vous démarrez BricsCAD® :
    • Dossier HOMEPATH (sous Windows, il s'agit généralement de C:\Users\%username%\)
    • Dossier dessin
    • Dossier du programme (C:\Program Files\Bricsys\BricsCAD V25 en_US)
  • Fichier de vidage sur incident (.dmp) ;

    Dans la plupart des cas, un plantage de programme donne lieu à un fichier crash dump (.dmp), qui est généré dans le même dossier que le fichier crash_report.txt.

    La création d'un fichier crash dump peut être activée ou désactivée en fonction du bit 2048 de QAFLAGS.

  • Profil utilisateur

    Les paramètres de votre profil d'utilisateur actuel peuvent être exportés vers un fichier à l'aide du gestionnaire de profils.

  • Fichier dessin

    Si un plantage est spécifique à un dessin, ce dessin sera utile.

  • Fournissez une description détaillée du flux de travail, y compris les commandes ou actions spécifiques qui peuvent être à l'origine du problème.
  • Attachez le retour complet de la commande _REDSDKINFO à partir de la ligne de commande de BricsCAD®.

    Imprime un rapport dans la fenêtre de commande contenant des informations sur les capacités graphiques de votre ordinateur. Appuyez sur F2 pour ouvrir la fenêtre Invite historique.

  • Fichier journal

    Utilisez la commande _LOGFILEON pour enregistrer toutes les invites du programme et toutes vos saisies au clavier. Le fichier est situé dans le dossier spécifié par la variable système _LOGFILEPATH.

Remarque :

Le terme plantage est souvent utilisé à tort pour d'autres problèmes, de sorte que l'analyste peut poser des questions pour définir exactement ce qui se passe. Un blocage ou un gel n'est pas un plantage, de même une opération extrêmement lente n'est pas un blocage. Une opération qui échoue avec une erreur mais qui ne ferme pas BricsCAD® n'est pas non plus un plantage.

Un rapport de plantage est enregistré dans le fichier crash_report.txt chaque fois que BricsCAD® plante. Le rapport de plantage est sauvegardé dans le dossier de démarrage de BricsCAD®. L'emplacement de ce dossier dépend de la façon dont vous avez démarré BricsCAD®, donc soyez conscient que plusieurs fichiers peuvent exister sur votre système dans différents dossiers. Si le programme n'a pas l'autorisation de créer le fichier dans le dossier de démarrage, le fichier est créé dans votre dossier %HOMEPATH% (sur Windows, typiquement c:\Users\[nom d'utilisateur]\). Parfois, le rapport de plantage est généré sans que le programme ne se ferme. Il arrive parfois qu'un plantage se produise sans qu'il y ait de rapport de plantage.

(Spécifique à Windows) Dans la plupart des cas, un plantage de programme entraîne un fichier crash dump (.dmp), qui est généré dans le même dossier que le fichier crash_report.txt. La création d'un fichier crash dump peut être activée ou désactivée en fonction du bit 2048 de QAFLAGS. Avant la version 18.2, le fichier crash dump n'était créé que si le bit 2048 de QAFLAGS était activé. Dans les versions plus récentes, la signification de l'indicateur a été inversée et le fichier crash dump est maintenant créé par défaut.

BricsCAD® peut enregistrer chaque commande exécutée dans un fichier journal. La génération de ce journal est contrôlée par la variable système LOGFILEMODE. Si LOGFILEMODE = 1, un fichier journal est créé chaque fois qu'un dessin est ouvert. Le format du fichier est DrawingName_aaaa-mm-jj_hh-mm-ss.log.

Les fichiers journaux de BricsCAD® sont sauvegardés dans le dossier spécifié par la variable système LOGFILEPATH. Par défaut, il s'agit du dossier indiqué par la variable système LOCALROOTPREFIX.