Bug_Triage - glibc wiki (original) (raw)

GLIBC Bugzilla Bug Triage

We're looking for volunteers to help with the GLIBC Bugzilla bug triage initiative. The following is the list of a triage participant's duties:

  1. Deal with new bug reports in a timely manner.
  2. Identify duplicate bugs reports. Close duplicate reports as dupe. Duplicates will show up on the GLIBC duplicate bugs page.
  3. Verify bug validity, which involves the following:
    • Verify the validity of the test-case (identify user error).
    • Verify the behavior against the existing documentation (info page and man page).
    • Verify the bug premise against applicable standards (i.e. C11, POSIX, ieee754, ieee754r, ieee854).
    • Ask for clarification of standards and documentation from developers.
    • Make sure the bug still occurs with latest git glibc (especially applicable when reviewing old bugs).
    • Say in the bug what you have verified, for the benefit of future readers.
  4. Narrow the breadth of the bug's scope if applicable.
  5. Set bug fields in accordance with bugzilla procedures. In particular, ensure ASSIGNED and SUSPENDED states are used correctly, remove default assignees and ping the bug if someone assigned it to themself a long time ago but doesn't appear to have been working on it. Make sure the bug is in the most appropriate component ("libc", "ports", "nptl", "manual" etc.).
  6. Implement a minimal test-case from a user submitted test-case or create one if a test-case is lacking.
  7. Create a test-case that can be injected into the GLIBC test-skeleton.c framework.
  8. If the bug report includes a patch (or links to one previously posted on a mailing list) from someone covered by a current FSF copyright assignment, or too small to need an assignment, then try to review the patch, ask the submitter to post it to libc-alpha for a wider audience to review it, or ask the submitter to update it for current sources and repost it, as appropriate.
  9. Consider fixing the bug yourself if straightforward, or pester developers if appropriate via posting to libc-alpha.
  10. Once fixes are delivered verify that problem is fixed.
  11. Prepare fixes to man pages or info pages as necessary.
  12. Review old bugs in the same way from time to time.

If you can't do all those things for a bug, any subset of them is still useful.

Further reading of Roland McGrath's comments regarding GLIBC bug triage can be found here.

Participation Steps

  1. Don't be intimidated by the process. We appreciate contribution and the process can be refined as we go along.
  2. The bugzilla bug entry 'owner' field is an indication of the triage participant who is looking at the entry. If you're comfortable addressing the problem please assign yourself as the owner. Please remember to unassign yourself if no longer working on a bug.
  3. In the course of your bugzilla triage work you may identify two separate bugs. If you find the need to open a new bug entry follow the guidelines below.
  4. If you have questions on the process please contact libc-alpha@sourceware.org.

Guidelines for Bugzilla Fields

See bugzilla procedures for what settings of various fields in bugs mean.

Guidelines for New Features

New feature patches that don't get reviewed reasonably quickly should have bugzilla entries created for them; the same applies to other unreviewed patches that do not add new features. This is done so that patches don't get lost and so the release manager is able to find all patches when it comes time to spin a release.

Submitting a Bug Report

If you would like to submit a bug report against GLIBC please read the guidelines for filing a glibc bug.

Before you file, take a look at the GLIBC duplicate bugs page to see if you're filing something that's already been identified. Also do a query in bugzilla before you file.

  1. No man pages are part of glibc, DO NOT REPORT MAN PAGE BUGS HERE! There is a separate GLIBC man page project.

The Sourceware Bugzilla hosts GLIBC bugs under the glibc product.