WARNING: This is the _old_ Lustre wiki, and it is in the process of being retired. The information found here is all likely to be out of date. Please search the new wiki for more up to date information.

Difference between revisions of "Developers Guide to Bugzilla for Lustre"

From Obsolete Lustre Wiki
Jump to navigationJump to search
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
INTRO...
+
<small>''(Updated: Dec 2009)''</small>
 +
__TOC__
 +
This developer's guide to Bugzilla describes how Bugzilla is used by developers. To report a bug, see [[Reporting Bugs]].
  
=== Accepting a Bug ===
+
=== Fixing a Bug ===
  
When a bug is first filed, it is assigned to someone and its status is NEW. When that person accepts the bug its status changes to ACCEPTED, which signifies that he has acknowledged the bug and is working on it.
+
When attaching a patch for inspection, please follow the procedure in [[Submitting Patches]].
  
 
=== Resolving a Bug ===
 
=== Resolving a Bug ===
  
When an issue is resolved and awaiting verification from the person who filed it, it is marked RESOLVED. From here, bugs are either re-opened and become REOPENED, are marked VERIFIED by the person who filed the bug, or are closed for good (when the product ships) and become CLOSED. CLOSED is rarely used.
+
When an issue is resolved and awaiting verification from the person who filed it, it is marked RESOLVED. From here, bugs either become REOPENED, are marked VERIFIED by the person who filed the bug, or are CLOSED for good (when the product ships). CLOSED is rarely used.
  
 
A bug can be resolved for one of a number of reasons:
 
A bug can be resolved for one of a number of reasons:
Line 17: Line 19:
 
* The issue cannot be reproduced (WORKSFORME).
 
* The issue cannot be reproduced (WORKSFORME).
 
* The issue is already filed elsewhere (DUPLICATE).
 
* The issue is already filed elsewhere (DUPLICATE).
 
=== Advanced ===
 
 
A bug may have one or more keywords (http://bugzilla.lustre.org/describekeywords.cgi) associated with it, each of which has a special meaning. Consistent application of keywords allow for extremely useful searches.
 
 
By default, the reporter and assignee receive email when changes are made to a bug (you can change your email preferences at http://bugzilla.lustre.org/userprefs.cgi?tab=email). If you are interested in a bug, or want someone else to be involved, enter that person's account name in the Cc field. Any old email address will not work--this person must have a Bugzilla account to be on the Cc list.
 
 
Each bug has a list of bugs that it blocks and depends on. This list is updated automatically when you mark a bug as DUPLICATE, but you can also add your own dependency data by adding bugs to these fields. This feature is frequently used to create meta-bugs which are just placeholders to gather dependency data. For example, a "Lustre 1.0" bug would depend on all of the bugs that need to be fixed before Lustre 1.0 is released.
 
  
 
=== Private Groups ===
 
=== Private Groups ===
  
If you are the member of a private group, a checkbox will appear in the bug submission form and in the bug status. Check this box to make the bug visible only to members of the group (typically your organization and CFS staff). This is frequently used for bugs which contain sensitive information or have severe security implications.
+
If you are the member of a private group, a checkbox will appear in the bug submission form and in the bug status. Check this box to make the bug visible only to members of the group (typically your organization and Lustre™ staff). This is frequently used for bugs which contain sensitive information or have severe security implications.
  
 
=== Reports and Searches ===
 
=== Reports and Searches ===
  
Bugzilla can generate tables and charts (http://bugzilla.lustre.org/report.cgi) for various criteria. If you want to distribute a chart, please don't link to the chart page itself, because it will re-run the query for each hit. Instead, save the image somewhere, then link to the image directly. Our server thanks you.
+
Bugzilla can generate [http://bugzilla.lustre.org/report.cgi reports] in the form of tables and charts for various criteria.  
 +
 
 +
'''''Note:''''' If you want to distribute a chart, please don't link to the chart page itself, because it will re-run the query for each hit. Instead, save the image somewhere, then link to the image directly.
  
 
=== Saved Searches ===
 
=== Saved Searches ===
  
If you find yourself running the same searches frequently, you may wish to save them to the toolbar. It will give you one-click access to the search results that you use the most.
+
If you find yourself running the same searches frequently, you may wish to save them to the Bugzilla toolbar that is present at the bottom of every page. It will give you one-click access to the search results that you use the most.
 +
 
 +
Each time you perform a search, you will see a button labeled ''Remember Search'' at th end of the search results.  To save the search, enter a name for the search in the box to the right of the button and click the ''Remember Search'' button.  A search of that name will be put into your Bugzilla toolbar.
  
For example, clicking on [http://bugzilla.lustre.org/buglist.cgi?query_format=&short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&remember=1&remtype=asnamed&newqueryname=All+Bugs&tofooter=1&remaction=run&namedcmd=All+Bugs&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= this link] will add a query named "All Bugs" that will show you all open Lustre bugs.
+
To remove a search from the toolbar, run the search again and select ''Forget Search  'search name' '' displayed after the search results.
  
[http://bugzilla.lustre.org/buglist.cgi?query_format=&short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&priority=P1&priority=P2&priority=P3&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&remember=1&remtype=asnamed&newqueryname=Important&tofooter=1&remaction=run&namedcmd=All+Bugs&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0= This link] will add a query named "Important", which will show you all open bugs with a priority of P3 and higher.
+
To modify a search, run the search again and select ''Edit Search''

Latest revision as of 06:55, 22 February 2010

(Updated: Dec 2009)

This developer's guide to Bugzilla describes how Bugzilla is used by developers. To report a bug, see Reporting Bugs.

Fixing a Bug

When attaching a patch for inspection, please follow the procedure in Submitting Patches.

Resolving a Bug

When an issue is resolved and awaiting verification from the person who filed it, it is marked RESOLVED. From here, bugs either become REOPENED, are marked VERIFIED by the person who filed the bug, or are CLOSED for good (when the product ships). CLOSED is rarely used.

A bug can be resolved for one of a number of reasons:

  • A fix for the issue was checked into the tree and tested (FIXED).
  • The bug report was too vague, described a non-bug, or is otherwise not useful (INVALID).
  • The issue is valid, but no action will be taken anytime soon (REMIND).
  • The issue is valid, but no action will ever be taken (WONTFIX).
  • The issue cannot be reproduced (WORKSFORME).
  • The issue is already filed elsewhere (DUPLICATE).

Private Groups

If you are the member of a private group, a checkbox will appear in the bug submission form and in the bug status. Check this box to make the bug visible only to members of the group (typically your organization and Lustre™ staff). This is frequently used for bugs which contain sensitive information or have severe security implications.

Reports and Searches

Bugzilla can generate reports in the form of tables and charts for various criteria.

Note: If you want to distribute a chart, please don't link to the chart page itself, because it will re-run the query for each hit. Instead, save the image somewhere, then link to the image directly.

Saved Searches

If you find yourself running the same searches frequently, you may wish to save them to the Bugzilla toolbar that is present at the bottom of every page. It will give you one-click access to the search results that you use the most.

Each time you perform a search, you will see a button labeled Remember Search at th end of the search results. To save the search, enter a name for the search in the box to the right of the button and click the Remember Search button. A search of that name will be put into your Bugzilla toolbar.

To remove a search from the toolbar, run the search again and select Forget Search 'search name' displayed after the search results.

To modify a search, run the search again and select Edit Search