Skip to content

Documentation for reading Miri's output #2066

Open
@nicholasbishop

Description

@nicholasbishop

The readme has a lot of excellent documentation on inputs to Miri (e.g. all the options that can be passed into MIRIFLAGS), but currently has relatively little to say about Miri's output. It would be great to have examples of common errors produced by Miri and how to read them.

It would also be helpful to have some quick documentation of the notation used in errors. For example, in this error message:

error: Undefined Behavior: trying to reborrow <349938> for Unique permission at alloc136736[0x0], but that tag does not exist in the borrow stack for this location

There are two bits of notation: <349938> and alloc136736[0x0]. I think <123> represents a tag, and maybe the [0x0] represents an offset from an allocation? Whatever the case is, would be great to have it documented in the readme.

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-diagnosticserrors and warnings emitted by miriA-docsArea: affects documentationC-enhancementCategory: a PR with an enhancement or an issue tracking an accepted enhancement

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions