new feature: function call arguments
A pull request for this has already been merged.
- #1678 by @yelhamer — merged
- Dominant language
- Python
- Stars
- 6.2k
- Forks
- 726
- Avg merge
- 11d 11h
- Merged PRs (30d)
- 7
Description
Summary
Can we create a way to associate function arguments (mostly for numbers and strings) with calls to known functions?
Possible syntax:
- call:
- number: 4
- api: CreateProcess
See discussion in #921 around syntax.
This is easier to understand by humans and we can be a little smarter in the analysis phase.
We should restrict this feature to analysis engines/formats/runtimes for which we can reliably extract the arguments (like .NET). Then, when its working well, we can try to backport to other engines/formats/runtimes (like x86). TBD if this sort of analysis is expected by all backends, e.g. SMDA.
Motivation
Looking for examples for #767 reminded me of the other most common use case for basic block subscopes...
Grouping function calls and their arguments, like
- basic block:
- and:
- api: kernel32.QueryInformationJobObject
- number: 0x3 = JobObjectBasicProcessIdList
or
- basic block:
- and:
- api: SendMessage
- number: 0x40a = WM_CAP_DRIVER_CONNECT
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Review the syntax discussion in issue #921 and the closed, merged pull request #1678 before starting. Define the supported analysis engines, formats, and runtimes, then establish how completion will be verified for reliable extraction of function-call arguments.
Written by the indexing model from the issue text.
Assessment
- Domain
- reverse-engineering
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100