Not logged in - Log In / Register

Revision 3 as of 2007-06-20 16:02:42

Clear message

Anchor(support) This document describes the extra data interface to the bug tracker in Launchpad that can be used by bug reporting tools such as [https://launchpad.net/Apport Apport]. If you have questions or comments about this document, please address them to #launchpad on freenode, or ask on the [https://lists.ubuntu.com/mailman/listinfo/launchpad-users launchpad-users mailing list].



The bug tracker provides an extra interface for filing bugs. By uploading a specifically formatted file to Launchpad prior to filing a bug, data and fields contained in the file will be incorporated into the bug during the filing process.

This file can be used to provide additional information like logs, dumps and command outputs to bugs without burdening the users with finding and uploading the relevant files/details.

File Format

The file containing the extra data should be a MIME multipart message. The bug tracker uses the Content-Disposition to determine how to handle each part.


By placing certain fields in the header of the file, some initial values and the behaviour of the filed bug can be determined prior to filing it.

Subject: bar crashes foo

This will be used to populate the suggested title for the bug.

Tags: foo bar

The filed bug will be tagged with supplied tags.

Private: yes

The filed bug will be marked as private (only the report will be subscribed to it).

Subscribers: launchpad-user user@example.com

The specified Launchpad users and/or registered e-mail addresses will be subscribed to the filed bug.


The first part with a Content-Disposition of inline will be appended to the bug description after it is filed.

Additional parts that have a Content-Disposition of inline will become comments for the filed bug.

Parts with a Content-Disposition of attachment will have have their contents added as attachments to the filed bug.

Filing a bug

Prior to filing a bug the extra data file needs to be stored in Launchpad. This can be done via the page https://launchpad.net/+storeblob. Upon successful storing of the file a token will be provided both within the page and contained in the HTTP headers as X-Launchpad-Blob-Token.

Filing a bug can be achieved by accessing the page https://launchpad.net/bugs/+filebug/<token> replacing <token> with the token received previously. However this page requires the user to specify the Distribution/Package or Project. An alternative is to use the URL syntax https://bugs.launchpad.net/<distribution>/+source/<package>/+filebug/<token> or https://bugs.launchpad.net/<project>/+filebug/<token> replacing <distribution>, <package> and <project> as appropriate.

The process after this point is the same as filing a bug normally except that certain fields may be pre-populated.

Sample File

MIME-Version: 2.0 
Content-type: multipart/mixed; boundary=boundary
Subject: Initial bug summary
Tags: foo bar
Private: yes
Subscribers: launchpad-user user@example.com

Content-disposition: inline
Content-type: text/plain; charset=utf-8

This should be added to the description.

Content-disposition: inline
Content-type: text/plain; charset=utf-8

This should be added as a comment.

Content-disposition: attachment; filename='attachment1'
Content-type: text/plain; charset=utf-8

This is an attachment.

Content-disposition: inline
Content-type: text/plain; charset=utf-8

This should be added as another comment.

Content-disposition: attachment; filename='attachment2'
Content-description: Attachment description.
Content-Transfer-Encoding: base64
Content-Type: application/x-gzip




Known Issues

Currently any errors within the extra data file are ignored with no feedback provided.