Skip to content

GreenteaOS/Caramel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Warning

Extreme Confectionery!

The interoperability/compatibility plugin

Provides interoperability between various instances of deprecated/obsolete programs in the PE format, system programs and user environment.

Emulates backwards compatible environment of the deprecated/obsolete platforms (as stated by the original platforms provider) on a no more supported hardware.

Contribution guidelines

In case contributor does attempts at reverse engineering: all corresponding contributions should follow Council Directive 91/250/EEC, Directive (EU) 2016/943 of the European Parliament and newer directives related to reverse engineering.

Most countries follow similar rules:

Illegal use of works protected by copyright

All contributors should be expected at any moment be willing to provide evidence of the proper reverse engineering techniques being in use.

Screenshots of the reverse engineering software (with related project files), video and step by step description of the knowledge obtaining process applied with the sole goals as described per this guideline (i.e. interoperability). Additional information may be requested.

Right to reverse engineer

As per Article 6 Decompilation 1. (a) you should own a legal copy/license of the software before doing any attempts at reverse engineering. The software should be officially deprecated/obsolete.

As a safety measure we assume that most contributions obtained a right to use a copy of the listed program bundles at some point in their lifetime:

  • Windows XP
  • Windows Vista
  • Windows 8
  • Windows 8.1

Caution

Windows 7 is still supported

We assume that none of the contributors had the right to utilize any of the "server", "beta" or other editions.

Note

Be very aware before using any knowledge from other reverse engineering projects if they conform to those guidelines

Companion programs

Original - legaly obtained (partially or fully) copy of a computer program

Some programs are required to be reimplemented to provide the interoperability environment (like cmd.exe).

Do NOT create computer program substantially similar in its expression to the original one (except when its required for the interoperability):

  • Use different programming languages, here we use Hexa and NASM assembly dialect
  • Extend default functionality and show this as a clear intent to the user
  • Apply visual language (style guide) and naming distinct from the original
  • In the properties or other user facing elements textually express program goal is to achieve the interoperability

Trademarks

Microsoft®, Windows™, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

Other names and brands may be claimed as the property of others.

GNU LESSER GENERAL PUBLIC LICENSE VERSION 3

All code should be under this one or compatible license.

Usage

Requires executive capable of the Tofita API set. Load PE and attach Caramel .dll files into the address space of the process. Remember to run every entry point. FS/GS registers should contain thread-local data and initialization structures.