uk.me.mjt:crashjvm

Crashes the JVM. Use it to ensure your test runners handle crashes gracefully!

License	MIT License
Categories	CRaSH General Purpose Libraries Utility
GroupId	uk.me.mjt
ArtifactId	crashjvm
Last Version	1.0
Release Date	Oct 19, 2016
Type	jar
Description	uk.me.mjt:crashjvm Crashes the JVM. Use it to ensure your test runners handle crashes gracefully!
Project URL	https://github.com/michaeltandy/crashjvm
Source Code Management	https://github.com/michaeltandy/crashjvm

Download crashjvm

Filename	Size
crashjvm-1.0.pom
crashjvm-1.0.jar	22 KB
crashjvm-1.0-sources.jar	5 KB
crashjvm-1.0-javadoc.jar	26 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/uk.me.mjt/crashjvm/ -->
<dependency>
    <groupId>uk.me.mjt</groupId>
    <artifactId>crashjvm</artifactId>
    <version>1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/uk.me.mjt/crashjvm/
implementation 'uk.me.mjt:crashjvm:1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/uk.me.mjt/crashjvm/
implementation ("uk.me.mjt:crashjvm:1.0")

Apache Buildr

'uk.me.mjt:crashjvm:jar:1.0'

Apache Ivy

<dependency org="uk.me.mjt" name="crashjvm" rev="1.0">
  <artifact name="crashjvm" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='uk.me.mjt', module='crashjvm', version='1.0')
)

Scala SBT

libraryDependencies += "uk.me.mjt" % "crashjvm" % "1.0"

Leiningen

[uk.me.mjt/crashjvm "1.0"]

Dependencies

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.10

Project Modules

There are no modules declared in this project.

crashjvm

Uses JNI to trigger JVM crashes. Use it to ensure your test runners handle crashes gracefully!

The native libraries are bundled into the jar and extracted at runtime, so they should work seamlessly on the supported platforms.

How to use

Import the dependency in the normal maven way

        <dependency>
            <groupId>uk.me.mjt</groupId>
            <artifactId>crashjvm</artifactId>
            <version>1.0</version>
            <scope>test</scope>
        </dependency>

Then in your tests you can trigger various crashes like so:

import uk.me.mjt.CrashJvm;

public class ExampleClass {
    public void exampleMethod() {
        CrashJvm.loadedOk(); // Checks the native library has imported.
        CrashJvm.exit(); // Equivalent to the C stdlib method exit(66)
        CrashJvm.abort(); // Equivalent to the C stdlib method abort()
        CrashJvm.segfault(); // Causes a segmentation fault
    }
}

Platforms supported

Thanks to Travis and Appveyor, native libraries are included for the following platforms:

	x86 64-bit	x86 32-bit
Linux	Compiled & tested (on Ubuntu Trusty)	Compiled
Mac	Compiled & tested (on 10.12.6)	Compiled
Windows†	Compiled & tested (on Server 2012 R2)	Compiled

^†I've been informed that Windows NT 4.0 isn't compatible. Patches welcome, I suppose?

If you know of a free CI service will allow me to compile and test on other CPU architectures, let me know and I'll integrate it.

Almost-reproducible build

If you're looking to reproduce the build and check for nerfarious deeds on my part, feel free! The native libraries were all built on public CI platforms, and the jar includes the build numbers as well as the versions of the compilers used.

A rebuild won't be byte-for-byte identical, because of timestamps in the windows libraries and zip file timestamps in the jar but other than that I don't know of any reason the build shouldn't reproduce.

Versions

Version
1.0 Oct 19, 2016