Due to the nature of Qiling Framework design, operating system API and posix syscalls will always be "missing" compare to real kernel. We covered around 40% of Windows API, Linux based syscall and unknown amount of coverage on UEFI. This will be a continuous and never-ending job and help from community is highly appreciated. We hope for more contributors to help on API or syscall implementation, either adding or maintaining them.

Our job is to make syscall or API as close to kernel as possible. But there are times, not 100% emulating the kernel is just fine too. For example, pid, uid, mprotect related syscall are just a quick return value and write into a appropriate register.

Posix syscall

We split the posix/syscall.py file into multiple files in posix/syscall directory. Seperation of syscall should follow its header, which is defined in the syscall function.

For example, syscall setpriority is defined in resource.h, ql_syscall_setpriority should be in syscall/resource.py. ql_syscall_clock_gettime should be in syscall/time.py.

Operating System API (Windows or UEFI)

This is applicable to operational API as well, the header file will be the guideline how we can split the API into different files.

How to start

Before writing an API or syscall, user can always try ql.os.set_api or ql.os.set_syscall. Please see Hijack. This will be a very simple way to test out customized syscall or API before modifying the core source codes.

Contributing

After adding syscall into core. Please make sure edit qiling/os/linux/.py to match the syscall function and syscall number.

API mapping is being done in ql.hook_code()