About

This repository is forked from https://github.com/CoreASM/coreasm.core. CoreASM is licensed under the Academic Free License version 3.0, which can be found in the LICENSE.md file and is also available on http://www.opensource.org/licenses/afl-3.0.php. All changes in this repository are licensed under the Academic Free License version 3.0 as well.

This repository contains changes to the CoreASM Engine that have been created to better support a CoreASM-based S-BPM interpreter and a semantic verification.

The separate releases are necessary, as important bug fixes were only published as SNAPSHOT version (see Issue 24) and important Pull Requests are still without any feedback. Until the currently open PRs are not merged I won't create additional PRs upstream.

Branches

The branch upstream follows the master branch of CoreASM. The master branch follows upstream, adds this README and a custom SNAPSHOT version.

These feature branches are based on upstream, and may be rebased when upstream is updated:

• jparsec3, Pull Request at PR29
  • updates the minimum required Java version to 8
  • updates jParsec to version 3.0 and makes some limited use of Java 8 lambdas
• fixes, Pull Request at PR30
  • various small fixes, performance improvements and other changes
• emError-deadlock, Pull Request at PR31
  • resolves an assertion error
  • add blocking wait for next command in emError
• codestyle
  • various code improvements
• ForkJoinPool, Pull Request pending
  • migrate from EDU.oswego.cs.dl.util.concurrent to java.util.concurrent, as it has been deprecated and merged into Java 7, where support continues
  • Exceptions are no longer caught and stored, but use the native error handling
  • as java.util.concurrent.ForkJoinPool no longer offers stats a custom measurement of execution times has been added
  • batched execution ([recursive] evaluation of multiple agents in one tasks) has been removed, as the ForkJoinPool can better distribute the work across workers
  • TODO: determine number of processors to be used

Since important features have not yet been merged upstream and additional work was needed, isolated branches on top of master became too hard to maintain.

The locke branch is now the default branch of this fork. It contains a somewhat stable version of features that are likely to be released next. Its history may be rewritten to pull in different features and pick commits from the development branch, but rebases unlikely to happen anymore.

There are some additional major differences to upstream & changes in the "locke" branch, that are not mentioned in the above feature branches:

• targets Java 11 (instead of Java 7)
• the maven layout has been changed
• TestEngineDriver: public constructor with properties
• robustness, performance and codestyle improvements
• currently not supported in this fork:
  • compiler (I started working on the branch dev-compiler)
  • eclipse modules / plugin

Development of experimental features happens in the dev branch, which is based on the locke branch. It must be considered as experimental, as it contains experiments and patches for my specific workload. I share them for the interested visitor, but be warned that the history is dirty and will be rewritten a lot (i.e. expect things that I try out but discard later on).

Some noteworthy changes of the "dev" branch, not in any feature nor the "locke" branch:

• SchedulerImp: public ForkJoinPool
• ConcurrentProgramEvaluator: removed AgentContext, added InterpreterCache
• ConcurrentProgramEvaluator: injectUpdates
• TestEngineDriver: return list of updates

Upstream Merged PRs

• nanoTime, Pull Request at PR27
  • adds the function nanoTime, which serves System.nanoTime(), to better measure elapsed time than the now function, which is based on System.currentTimeMillis()
• test-jar, no Pull Request intended
  • installing / publishing org.coreasm.engine now creates an additional test-jar, to make it possible to use the TestEngineDriver from external projects
• avoid-yield, Pull Request at PR26
  • uses a signal to wait for the Engine to be idle; the Engine uses a LinkedBlockingQueue to wait for a new command when it is idle. This improves CPU utilization as waiting threads no longer call Thread.yield() constantly in a loop until the condition changes
  • TestEngineDriver has been restructured to avoid an internal thread, on which was waited with an additional Thread.yield()-loop
  • this branch is based on test-jar, which should've been a separate PR

Releases

Releases are tagged with the suffix -locke-N. Their history will not be rewritten.

• 1.7.3-locke-6 at 2022-11-22
• 1.7.3-locke-5 at 2022-01-10
• 1.7.3-locke-4 at 2019-09-27
• 1.7.3-locke-3 at 2019-09-23
• 1.7.3-locke-2 at 2019-02-07
• 1.7.3-locke-1 at 2018-10-04