Skip to content

wasmtime: Add a Config::native_unwind_info method#4643

Merged
fitzgen merged 1 commit intobytecodealliance:mainfrom
fitzgen:unwind-info-config
Aug 8, 2022
Merged

wasmtime: Add a Config::native_unwind_info method#4643
fitzgen merged 1 commit intobytecodealliance:mainfrom
fitzgen:unwind-info-config

Conversation

@fitzgen
Copy link
Member

@fitzgen fitzgen commented Aug 8, 2022

This method configures whether native unwind information (e.g. .eh_frame on
Linux) is generated or not.

This helps integrate with third-party stack capturing tools, such as the system
unwinder or the backtrace crate. It does not affect whether Wasmtime can
capture stack traces in Wasm code that it is running or not.

Unwind info is always enabled on Windows, since the Windows ABI requires it.

This configuration option defaults to true.

Additionally, we deprecate Config::wasm_backtrace since we can always cheaply
capture stack traces ever since
#4431.

Fixes #4554

@fitzgen
Copy link
Member Author

fitzgen commented Aug 8, 2022

@peterhuene could you take a look at this and double check that the Windows-related bits make sense? Not 100% sure what I've said/configured is correct. Thanks!

Copy link
Member

@peterhuene peterhuene left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks reasonable to me!

This method configures whether native unwind information (e.g. `.eh_frame` on
Linux) is generated or not.

This helps integrate with third-party stack capturing tools, such as the system
unwinder or the `backtrace` crate. It does not affect whether Wasmtime can
capture stack traces in Wasm code that it is running or not.

Unwind info is always enabled on Windows, since the Windows ABI requires it.

This configuration option defaults to true.

Additionally, we deprecate `Config::wasm_backtrace` since we can always cheaply
capture stack traces ever since
bytecodealliance#4431.

Fixes bytecodealliance#4554
@fitzgen fitzgen force-pushed the unwind-info-config branch from d85c0e7 to fd9ba6b Compare August 8, 2022 19:55
@github-actions github-actions bot added fuzzing Issues related to our fuzzing infrastructure wasmtime:api Related to the API of the `wasmtime` crate itself wasmtime:config Issues related to the configuration of Wasmtime labels Aug 8, 2022
@github-actions
Copy link

github-actions bot commented Aug 8, 2022

Subscribe to Label Action

cc @fitzgen, @peterhuene

Details This issue or pull request has been labeled: "fuzzing", "wasmtime:api", "wasmtime:config"

Thus the following users have been cc'd because of the following labels:

  • fitzgen: fuzzing
  • peterhuene: wasmtime:api

To subscribe or unsubscribe from this label, edit the .github/subscribe-to-label.json configuration file.

Learn more.

@github-actions
Copy link

github-actions bot commented Aug 8, 2022

Label Messager: wasmtime:config

It looks like you are changing Wasmtime's configuration options. Make sure to
complete this check list:

  • If you added a new Config method, you wrote extensive documentation for
    it.

    Details

    Our documentation should be of the following form:

    Short, simple summary sentence.
    
    More details. These details can be multiple paragraphs. There should be
    information about not just the method, but its parameters and results as
    well.
    
    Is this method fallible? If so, when can it return an error?
    
    Can this method panic? If so, when does it panic?
    
    # Example
    
    Optional example here.
    
  • If you added a new Config method, or modified an existing one, you
    ensured that this configuration is exercised by the fuzz targets.

    Details

    For example, if you expose a new strategy for allocating the next instance
    slot inside the pooling allocator, you should ensure that at least one of our
    fuzz targets exercises that new strategy.

    Often, all that is required of you is to ensure that there is a knob for this
    configuration option in wasmtime_fuzzing::Config (or one
    of its nested structs).

    Rarely, this may require authoring a new fuzz target to specifically test this
    configuration. See our docs on fuzzing for more details.

  • If you are enabling a configuration option by default, make sure that it
    has been fuzzed for at least two weeks before turning it on by default.


Details

To modify this label's message, edit the .github/label-messager/wasmtime-config.md file.

To add new label messages or remove existing label messages, edit the
.github/label-messager.json configuration file.

Learn more.

@fitzgen fitzgen merged commit ec47335 into bytecodealliance:main Aug 8, 2022
@fitzgen fitzgen deleted the unwind-info-config branch August 8, 2022 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fuzzing Issues related to our fuzzing infrastructure wasmtime:api Related to the API of the `wasmtime` crate itself wasmtime:config Issues related to the configuration of Wasmtime

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Config::wasm_backtrace in the face of fp-based unwinding

3 participants