文件列表:

CODE_OF_CONDUCT.md (3379, 2023-04-07)
Gemfile (39, 2023-04-07)
LICENSE (11345, 2023-04-07)
Rakefile (861, 2023-04-07)
bin/ (0, 2023-04-07)
bin/build-machine.rb (1397, 2023-04-07)
bin/instruction.rb.erb (2605, 2023-04-07)
bin/instructions.rb.erb (1802, 2023-04-07)
examples/ (0, 2023-04-07)
examples/print-string.rb (600, 2023-04-07)
fisk.gemspec (747, 2023-04-07)
lib/ (0, 2023-04-07)
lib/fisk.rb (21816, 2023-04-07)
lib/fisk/ (0, 2023-04-07)
lib/fisk/basic_block.rb (3710, 2023-04-07)
lib/fisk/encoding.rb (3105, 2023-04-07)
lib/fisk/errors.rb (1430, 2023-04-07)
lib/fisk/helpers.rb (3105, 2023-04-07)
lib/fisk/instructions.rb (188376, 2023-04-07)
lib/fisk/instructions/ (0, 2023-04-07)
lib/fisk/instructions/adc.rb (20426, 2023-04-07)
lib/fisk/instructions/adcx.rb (3244, 2023-04-07)
lib/fisk/instructions/add.rb (20415, 2023-04-07)
lib/fisk/instructions/addpd.rb (1626, 2023-04-07)
lib/fisk/instructions/addps.rb (1516, 2023-04-07)
lib/fisk/instructions/addsd.rb (1625, 2023-04-07)
lib/fisk/instructions/addss.rb (1625, 2023-04-07)
lib/fisk/instructions/addsubpd.rb (1621, 2023-04-07)
lib/fisk/instructions/addsubps.rb (1621, 2023-04-07)
lib/fisk/instructions/adox.rb (3247, 2023-04-07)
lib/fisk/instructions/aesdec.rb (1709, 2023-04-07)
lib/fisk/instructions/aesdeclast.rb (1730, 2023-04-07)
lib/fisk/instructions/aesenc.rb (1709, 2023-04-07)
lib/fisk/instructions/aesenclast.rb (1730, 2023-04-07)
lib/fisk/instructions/aesimc.rb (1709, 2023-04-07)
lib/fisk/instructions/aeskeygenassist.rb (1928, 2023-04-07)
... ...

# Fisk - A Pure Ruby x86-64 Assembler Tired of writing Ruby in Ruby? Now you can write assembly in Ruby with Fisk! This is a pure Ruby x86-64 assembler (I guess). I'm not 100% sure if it counts as pure Ruby because it just reads an XML file and metaprograms most of it. Anyway, you can use it to write assembly in Ruby, then have it assembled. I named it after Wilson Fisk mainly because it reminds me of [this project](https://github.com/seattlerb/wilson) and because I've been playing lots of Spider-Man. ## Usage Here is an example of assembling something: ```ruby fisk = Fisk.new binary = fisk.asm do push rbp mov rbp, rsp int lit(3) pop rbp ret end ``` Fisk uses Intel assembly syntax, so the first operand is the *destination*, and the second operand is the source. So for example `mov rax, imm8(1)` means "put an immediate that is 8 bits wide with the value of 1 in the RAX register". ## Sizes and Memory Operands In order to select the right x86 instruction to emit, Fisk needs to know the types of the operands. Register types are already implied, but things like immediates and memory operands need to be specified. Below are a few examples. Putting a 32 bit immediate in the RAX register: ```ruby mov rax, imm32(0xFFF) ``` Dereferencing the value in RAX and storing the value in the RAX register: ```ruby mov rax, m64(rax) ``` Dereferencing the value 8 bytes away RAX and storing the value in the R9 register: ```ruby mov r9, m64(rax, 8) ``` ## Register Allocation Fisk supports simple register assignment. You can make temporary registers, then have Fisk assign registers for you. For example: ```ruby fisk = Fisk.new # Make some temporary registers reg1 = fisk.register("temp1") reg2 = fisk.register("temp2") # XOR the two virtual registers fisk.xor reg1, reg2 # Ask Fisk to assign registers from the pool of registers passed in fisk.assign_registers([fisk.r9, fisk.r10]) ``` Currently, Fisk won't spill registers for you, it just raises an exception. ## Executing Assembly Now, it's not very fun to assemble something unless you can execute it. So here is an example of how to execute the above assembly. This assembly code will send an interrupt and tell the debugger to stop. So let's write the machine code to some executable memory, and call it from a Ruby program that we will start in lldb. ```ruby require "fisk" require "fisk/helpers" module Break fisk = Fisk.new jitbuf = Fisk::Helpers.jitbuffer 4096 fisk.asm(jitbuf) do push rbp mov rbp, rsp int lit(3) pop rbp ret end define_singleton_method :dance!, &jitbuf.to_function([], Fiddle::TYPE_VOID) end def deep i = 2 if i == 0 Break.dance! else deep(i - 1) end end deep ``` If we launch this script under lldb, the debugger will halt the process when we call the `dance!` method: ``` [aaron@tc-lan-adapter ~/g/fisk (master)]$ lldb ~/git/ruby/ruby -- -I lib fun.rb error: module importing failed: invalid pathname (lldb) target create "/Users/aaron/git/ruby/ruby" procCurrent executable set to '/Users/aaron/git/ruby/ruby' (x86_64). (lldb) settings set -- target.run-args "-I" "lib" "fun.rb" (lldb) process launch Process 33042 launched: '/Users/aaron/git/ruby/ruby' (x86_64) Process 33042 stopped * thread #1, queue = 'com.apple.main-thread', stop reason = EXC_BREAKPOINT (code=EXC_I386_BPT, subcode=0x0) frame #0: 0x00000001007f4005 -> 0x1007f4005: popq %rbp 0x1007f4006: retq 0x1007f4007: addb %al, (%rax) 0x1007f4009: addb %al, (%rax) Target 0: (ruby) stopped. (lldb) bt * thread #1, queue = 'com.apple.main-thread', stop reason = EXC_BREAKPOINT (code=EXC_I386_BPT, subcode=0x0) * frame #0: 0x00000001007f4005 frame #1: 0x00007fff2db538e5 libffi.dylib`ffi_call_unix64 + 85 frame #2: 0x00007fff2db5322a libffi.dylib`ffi_call_int + 692 frame #3: 0x0000000107458e3d fiddle.bundle`nogvl_ffi_call(ptr=0x00007ffeefbf9bb0) at function.c:204:5 frame #4: 0x00000001002e704f ruby`rb_nogvl(func=(fiddle.bundle`nogvl_ffi_call at function.c:201), data1=0x00007ffeefbf9bb0, ubf=0x0000000000000000, data2=0x0000000000000000, flags=0) at thread.c:1671:5 frame #5: 0x00000001002e7570 ruby`rb_thread_call_without_gvl(func=(fiddle.bundle`nogvl_ffi_call at function.c:201), data1=0x00007ffeefbf9bb0, ubf=0x0000000000000000, data2=0x0000000000000000) at thread.c:1787:12 frame #6: 0x00000001074585a6 fiddle.bundle`function_call(argc=0, argv=0x00000001080280c8, self=0x0000000128f85fd8) at function.c:375:15 frame #7: 0x0000000100383ca7 ruby`call_cfunc_m1(recv=0x0000000128f85fd8, argc=0, argv=0x00000001080280c8, func=(fiddle.bundle`function_call at function.c:211)) at vm_insnhelper.c:2594:12 frame #8: 0x000000010037ef99 ruby`vm_call_cfunc_with_frame(ec=0x0000000100b069b0, reg_cfp=0x0000000108127eb0, calling=0x00007ffeefbfa030) at vm_insnhelper.c:2924:11 frame #9: 0x0000000100377603 ruby`vm_call_cfunc(ec=0x0000000100b069b0, reg_cfp=0x0000000108127eb0, calling=0x00007ffeefbfa030) at vm_insnhelper.c:2945:12 frame #10: 0x0000000100376f2b ruby`vm_call_method_each_type(ec=0x0000000100b069b0, cfp=0x0000000108127eb0, calling=0x00007ffeefbfa030) at vm_insnhelper.c:3414:16 frame #11: 0x00000001003769e9 ruby`vm_call_method(ec=0x0000000100b069b0, cfp=0x0000000108127eb0, calling=0x00007ffeefbfa030) at vm_insnhelper.c:3507:20 frame #12: 0x00000001003578f5 ruby`vm_call_general(ec=0x0000000100b069b0, reg_cfp=0x0000000108127eb0, calling=0x00007ffeefbfa030) at vm_insnhelper.c:3550:12 frame #13: 0x000000010036d688 ruby`vm_sendish(ec=0x0000000100b069b0, reg_cfp=0x0000000108127eb0, cd=0x0000000100e2be30, block_handler=0x0000000000000000, method_explorer=mexp_search_method) at vm_insnhelper.c:4525:15 frame #14: 0x000000010033f3de ruby`vm_exec_core(ec=0x0000000100b069b0, initial=0x0000000000000000) at insns.def:789:11 frame #15: 0x0000000100361d6e ruby`rb_vm_exec(ec=0x0000000100b069b0, mjit_enable_p=true) at vm.c:2162:22 frame #16: 0x00000001003884c5 ruby`invoke_bmethod(ec=0x0000000100b069b0, iseq=0x000000010781d168, self=0x0000000128f7d180, captured=0x00000001294ef620, me=0x0000000128f85f10, type=0x0000000022220101, opt_pc=0) at vm.c:1292:11 frame #17: 0x0000000100360321 ruby`rb_vm_invoke_bmethod [inlined] invoke_iseq_block_from_c(ec=0x0000000100b069b0, captured=0x00000001294ef620, self=0x0000000128f7d180, argc=0, argv=0x00007ffeefbfcab0, kw_splat=0, passed_block_handler=0x0000000000000000, cref=0x0000000000000000, is_lambda=1, me=0x0000000128f85f10) at vm.c:1337:9 frame #18: 0x000000010036017d ruby`rb_vm_invoke_bmethod [inlined] invoke_block_from_c_proc(ec=0x0000000100b069b0, proc=0x00000001294ef620, self=0x0000000128f7d180, argc=0, argv=0x00007ffeefbfcab0, kw_splat=0, passed_block_handler=0x0000000000000000, is_lambda=1, me=0x0000000128f85f10) at vm.c:1434 frame #19: 0x00000001003600cf ruby`rb_vm_invoke_bmethod(ec=0x0000000100b069b0, proc=0x00000001294ef620, self=0x0000000128f7d180, argc=0, argv=0x00007ffeefbfcab0, kw_splat=0, block_handler=0x0000000000000000, me=0x0000000128f85f10) at vm.c:1470 frame #20: 0x000000010037f3e7 ruby`vm_call_bmethod_body(ec=0x0000000100b069b0, calling=0x00007ffeefbfcd20, argv=0x00007ffeefbfcab0) at vm_insnhelper.c:2983:11 frame #21: 0x0000000100377e8f ruby`vm_call_bmethod(ec=0x0000000100b069b0, cfp=0x0000000108127ee8, calling=0x00007ffeefbfcd20) at vm_insnhelper.c:3003:12 frame #22: 0x00000001003770c9 ruby`vm_call_method_each_type(ec=0x0000000100b069b0, cfp=0x0000000108127ee8, calling=0x00007ffeefbfcd20) at vm_insnhelper.c:3440:16 frame #23: 0x00000001003769e9 ruby`vm_call_method(ec=0x0000000100b069b0, cfp=0x0000000108127ee8, calling=0x00007ffeefbfcd20) at vm_insnhelper.c:3507:20 frame #24: 0x00000001003578f5 ruby`vm_call_general(ec=0x0000000100b069b0, reg_cfp=0x0000000108127ee8, calling=0x00007ffeefbfcd20) at vm_insnhelper.c:3550:12 frame #25: 0x000000010036d688 ruby`vm_sendish(ec=0x0000000100b069b0, reg_cfp=0x0000000108127ee8, cd=0x0000000100e2bcb0, block_handler=0x0000000000000000, method_explorer=mexp_search_method) at vm_insnhelper.c:4525:15 frame #26: 0x000000010033f3de ruby`vm_exec_core(ec=0x0000000100b069b0, initial=0x0000000000000000) at insns.def:789:11 frame #27: 0x0000000100361de7 ruby`rb_vm_exec(ec=0x0000000100b069b0, mjit_enable_p=true) at vm.c:2171:22 frame #28: 0x0000000100363070 ruby`rb_iseq_eval_main(iseq=0x000000010781da28) at vm.c:2419:11 frame #29: 0x00000001000dbefb ruby`rb_ec_exec_node(ec=0x0000000100b069b0, n=0x000000010781da28) at eval.c:317:2 frame #30: 0x00000001000dbd83 ruby`ruby_run_node(n=0x000000010781da28) at eval.c:375:30 frame #31: 0x00000001000036fc ruby`main(argc=4, argv=0x00007ffeefbff5f8) at main.c:47:9 frame #32: 0x00007fff20530621 libdyld.dylib`start + 1 frame #33: 0x00007fff20530621 libdyld.dylib`start + 1 ``` Note that in order to produce a stack trace like the above, the Ruby binary must include the debugging symbols (otherwise, the `ruby` frames will not be displayed); this is accomplished by specifying the `--ggdb3` compiler flag: - if compiling Ruby from source, use `./configure optflags=-gddb3` in the build process - if using a version manager, refer to the help; example for RVM: `optflags="-ggdb3" rvm install 3.0.2 --disable-binary`

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：