xref: /aosp_15_r20/external/capstone/bindings/powershell/README.md (revision 9a0e4156d50a75a99ec4f1653a0e9602a5d45c18)
1*9a0e4156SSadaf EbrahimiThis documentation explains how to install & use the PowerShell binding for Capstone.
2*9a0e4156SSadaf Ebrahimi
3*9a0e4156SSadaf Ebrahimi
4*9a0e4156SSadaf EbrahimiInstall
5*9a0e4156SSadaf Ebrahimi------
6*9a0e4156SSadaf Ebrahimi
7*9a0e4156SSadaf EbrahimiCompile the relevant version (x86/x64) of `capstone.dll` and place it in
8*9a0e4156SSadaf Ebrahimi`./Capstone/Lib/Capstone/`.
9*9a0e4156SSadaf Ebrahimi
10*9a0e4156SSadaf EbrahimiAlternatively, pre-compiled DLL’s can be obtained from the Capstone homepage
11*9a0e4156SSadaf Ebrahimiat http://capstone-engine.org/download
12*9a0e4156SSadaf Ebrahimi
13*9a0e4156SSadaf Ebrahimi
14*9a0e4156SSadaf EbrahimiUsage
15*9a0e4156SSadaf Ebrahimi-----
16*9a0e4156SSadaf Ebrahimi
17*9a0e4156SSadaf EbrahimiTo use the PowerShell binding, the entire Capstone folder should be added to
18*9a0e4156SSadaf Ebrahimione of the PowerShell module directories:
19*9a0e4156SSadaf Ebrahimi
20*9a0e4156SSadaf Ebrahimi    # Global PSModulePath path
21*9a0e4156SSadaf Ebrahimi    %Windir%\System32\WindowsPowerShell\v1.0\Modules
22*9a0e4156SSadaf Ebrahimi
23*9a0e4156SSadaf Ebrahimi    # User PSModulePath path
24*9a0e4156SSadaf Ebrahimi    %UserProfile%\Documents\WindowsPowerShell\Modules
25*9a0e4156SSadaf Ebrahimi
26*9a0e4156SSadaf EbrahimiOnce this is done the module can be initialized by typing “Import-Module Capstone”
27*9a0e4156SSadaf Ebrahimiin a new PowerShell terminal. Further information on the usage of the binding
28*9a0e4156SSadaf Ebrahimican be obtained with the following command:
29*9a0e4156SSadaf Ebrahimi
30*9a0e4156SSadaf Ebrahimi    Get-Help Get-CapstoneDisassembly -Full