Commande bugfiler

Editer en ligne

Objectif

Stocke automatiquement les rapports de bogue dans les répertoires de courrier spécifiés.

Syntaxe

bugfiler [ -d ] [ -m MessageMode ] [ -b BugUserName ] [ MailDirectory ]

Descriptif

La commande bugfiler intercepte automatiquement les rapports de bogues, les récapitule et les stocke dans les dossiers appropriés du répertoire spécifié par la variable MailDirectory .

Le programme de distribution du courrier lance la commande bugfiler via une ligne du fichier /etc/aliases . Le format de la ligne est le suivant:

bugs:"|/usr/lib/bugfiler $HOME/bugstuff"

Dans l'exemple, les rapports de bogue sont placés dans le répertoire $HOME/bugstuff . Si aucun répertoire n'est spécifié, la commande bugfiler place les rapports de bogue dans le répertoire par défaut $HOME/mail .

Remarque: Le répertoire $HOME/mail doit être créé pour que la commande bugfiler puisse être utilisée comme répertoire par défaut.

Si le BugUserName est différent debugsl'entrée dans le fichier /etc/aliases doit contenir un drapeau -b BugUserName, comme dans l'exemple suivant :

hadley:"|/usr/lib/bugfiler -b hadley"

Dans cet exemple,hadleyest déclaré comme étant le BugUserName et tous les rapports de bogues sont placés dans le répertoire par défaut /home/hadley/mail. Tous les répertoires utilisés par la commande bugfiler doivent appartenir àhadley.

La commande bugfiler lit les rapports de bogues à partir de l'entrée standard, vérifie le format de chaque rapport, puis envoie un message accusant réception (fichier $HOME/MailDirectory/.ack ) ou indique un format incorrect (fichier $HOME/MailDirectory/.format ).

Les rapports de bogues incorrectement formatés sont classés dans le répertoire errors , que la commande bugfiler crée en tant que sous-répertoire de la variable MailDirectory . Les rapports de bogues doivent être au format indiqué dans le fichier /usr/lib/bugformat . Utilisez la commande sendbug pour démarrer le fichier /usr/lib/bugformat . La commande bugfiler récapitule les rapports de bogues valides et les fichier dans le dossier spécifié dans le fichier Index:Ligne du rapport. Nom du répertoire source dans leIndex:La ligne doit correspondre à l'un des noms de répertoire de l'annuaire de messagerie. La commande " bugfiler ajoute une ligne au format suivant au fichier " MailDirectory/ "résumé " :

DirectoryName/MessageNumber IndexInformation SubjectInformation

Remarque: La commande bugfiler ne reconnaît pas le courrier transféré. Il avertit le réexpéditeur, et non l'expéditeur, sauf si unReply-To: la ligne est incluse dans l'en-tête du rapport.

Format des rapports de bogue

Les rapports de bogues doivent être soumis au format ARPA RFC 822. La commande sendbug contient des informations permettant de composer et d'envoyer par courrier électronique des rapports de bogue au format correct.

Les rapports requièrent les lignes d'en-tête suivantes pour une indexation correcte:

Article Descriptif
Date: Suivie de la date à laquelle la commande bugfiler reçoit le rapport.
From: Suivi de l'adresse de retour valide de l'expéditeur.
Subject: Suivi d'un bref résumé du problème.
Index: Suivi du chemin du répertoire source et du fichier source, du numéro de version et, le cas échéant, du mot clé Fix .

Le corps du rapport de bogue requiert les lignes suivantes:

Article Descriptif
Description: Suivi d'une description détaillée du problème, de la suggestion ou de la plainte.
Repeat-By: Suivi d'une procédure pour répéter le problème.
Fix: Suivie d'une commande diff comparant les anciens et les nouveaux fichiers source ou d'une description de la manière de résoudre le problème. Incluez leFix:ligne uniquement si le mot clé Fix est spécifié dans laIndex:ligne.

Redistribution des rapports de bogue

Les rapports de bogues peuvent être redistribués en fonction des informations d'indexation contenues dans le fichier MailDirectory/.redist. Le fichier MailDirectory/.redist est examiné à la recherche d'une ligne commençant par un nom d'index suivi d'une tabulation. Après le nom de l'index et l'onglet se trouve une liste d'adresses électroniques séparées par des virgules pour recevoir des copies des rapports de bogue. Si la liste se poursuit sur plusieurs lignes, chaque ligne mais la dernière doit se terminer par une barre oblique inversée (\). Voici un exemple d'informations d'index dans le fichier .redist :

myindex   joe@hal,mary@mercutio,martha@banquo,sarah@mephisto,\
dee@hamlet,dewayne@ceasar

Indicateurs

Article Descriptif
-b BugUserName Indique un nouvel ID utilisateur. Si l'option -b BugUserName n'est pas spécifiée, la commande bugfiler utilise par défaut le nom d'utilisateur.
-d Active le débogage. Lorsque l'indicateur -d est spécifié, la commande bugfiler envoie des messages d'erreur à la sortie standard.
-m MessageMode Définit la protection des messages. L'indicateur -m MessageMode spécifie les droits d'accès aux fichiers, à l'aide du format hexadécimal, pour tous les fichiers créés par la commande bugfiler .

Exemples

  1. La syntaxe de la commande bugfiler lorsqu'elle est utilisée avec les trois indicateurs et une variable MailDirectory spécifiée est la suivante:
    hadley:"|/usr/lib/bugfiler -d -m 755 -b hadley 
/home/hadley/bugdir"
    Lorsqu'elle est placée dans le fichier /etc/aliases , cette ligne démarre le débogage et définit les droits d'accès aux fichiers surrwxr-xr-x, déclarehadleycomme BugUserName, et spécifie le /home/hadley/bugdir.
  2. Voici un exemple de rapport de bogue:
    Date: Mon, 27 Nov 89 11:26:15 -600
From: a@B
Subject: Read not setting errno correctly
Index: LFS/rdwr.c workstation 3.1
 
Description: Read not setting errno correctly
 
Repeat-By: Start an NFS daemon and it receives errors. Errno is
zero.

Fichiers

Article Descriptif
/etc/ alias Contient des alias à l'échelle du système pour le système de transport du courrier.
usr /sbin/sendmail Contient le programme de distribution du courrier.
MailDirectory/résumé Contient les récapitulatifs du rapport de bogue.
Nom de l'utilisateur/MailDirectory/.ack Contient le message envoyé dans l'accusé de réception.
Nom de l'utilisateur/MailDirectory/.format Contient le message envoyé lorsque des erreurs de format sont détectées.
MailDirectory/.redist Contient la liste de redistribution des rapports de bogue.