Download the PHP package shanept/assembly-simulator without Composer
On this page you can find all versions of the php package shanept/assembly-simulator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download shanept/assembly-simulator
More information about shanept/assembly-simulator
Files in shanept/assembly-simulator
Package assembly-simulator
Short Description Allows stepping through compiled assembly code. Provides access to registers and the stack for easy querying of values.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package assembly-simulator
AssemblySimulator
The AssemblySimulator project provides a means to step through compiled assembly code, operation by operation, and provides access to registers and the stack for easy querying of values. The implementation is quite simplistic, we only implement a few basic instructions. However the architecture allows for easy extensibility of the instruction set, to satisfy your project's needs.
The Simulator
The simulator may be manually instantiated, or instantiated by the SimulatorFactory. Note that using the SimulatorFactory does not restrict you from registering further instructions after the simulator is created. The following are equivalent:
Modes
The simulator supports operating in real, protected and long mode. In order to specify the mode under which the simulator should operate, provide one of the mode constants to either the constructor or the setMode function:
- Simulator::REAL_MODE
- Simulator::PROTECTED_MODE
- Simulator::LONG_MODE
Note: If you set the simulator mode with $simulator->setMode() function, you must perform a reset before performing any simulations, with a call to $simulator->reset(). See the Simulator Reset section.
Resetting the Simulator
There are some circumstances where you will need to reset the simulator - think of it like hitting the reset switch on your computer. The reset function is used to restore the simulator to a better known state. This includes clearing registers and the stack.
Registering Custom Instructions
In order to use the simulator, it must be instantiated with the instruction set you wish to use. An example is provided here with the default instruction set. Please note, if you wish to use the simulator with the default instruction set, you can simply use the SimulatorFactory.
For more information, see the custom instruction example.
The Code Buffer
Prior to simulation, the simulator must be provided a code buffer off which to operate. This must be provided as a binary string.
Examples
For more information, see the examples under the example directory.
- examples/getCdeclFunctionCallParameters.php - For a basic example of how to use the simulator.
- examples/registeringCustomInstruction.php - For an example of how to build and use a custom instruction.
- examples/registeringCustomInstructionWithFactory.php - As above, uses the SimulatorFactory.
- examples/myCustomInstruction.php - For an example of how a custom instruction is implemented.
