librex 0.0.18 → 0.0.19
Sign up to get free protection for your applications and to get access to all the features.
- data/Rakefile +2 -2
- data/lib/rex/LICENSE +29 -0
- data/lib/rex/arch.rb +103 -0
- data/lib/rex/arch/sparc.rb +75 -0
- data/lib/rex/arch/sparc.rb.ut.rb +18 -0
- data/lib/rex/arch/x86.rb +513 -0
- data/lib/rex/arch/x86.rb.ut.rb +93 -0
- data/lib/rex/assembly/nasm.rb +104 -0
- data/lib/rex/assembly/nasm.rb.ut.rb +22 -0
- data/lib/rex/codepage.map +104 -0
- data/lib/rex/compat.rb +311 -0
- data/lib/rex/constants.rb +113 -0
- data/lib/rex/elfparsey.rb +11 -0
- data/lib/rex/elfparsey/elf.rb +123 -0
- data/lib/rex/elfparsey/elfbase.rb +258 -0
- data/lib/rex/elfparsey/exceptions.rb +27 -0
- data/lib/rex/elfscan.rb +12 -0
- data/lib/rex/elfscan/scanner.rb +207 -0
- data/lib/rex/elfscan/search.rb +46 -0
- data/lib/rex/encoder/alpha2.rb +31 -0
- data/lib/rex/encoder/alpha2/alpha_mixed.rb +68 -0
- data/lib/rex/encoder/alpha2/alpha_upper.rb +79 -0
- data/lib/rex/encoder/alpha2/generic.rb +114 -0
- data/lib/rex/encoder/alpha2/unicode_mixed.rb +117 -0
- data/lib/rex/encoder/alpha2/unicode_upper.rb +129 -0
- data/lib/rex/encoder/ndr.rb +89 -0
- data/lib/rex/encoder/ndr.rb.ut.rb +44 -0
- data/lib/rex/encoder/nonalpha.rb +61 -0
- data/lib/rex/encoder/nonupper.rb +64 -0
- data/lib/rex/encoder/xdr.rb +106 -0
- data/lib/rex/encoder/xdr.rb.ut.rb +29 -0
- data/lib/rex/encoder/xor.rb +69 -0
- data/lib/rex/encoder/xor/dword.rb +13 -0
- data/lib/rex/encoder/xor/dword_additive.rb +13 -0
- data/lib/rex/encoders/xor_dword.rb +35 -0
- data/lib/rex/encoders/xor_dword_additive.rb +53 -0
- data/lib/rex/encoders/xor_dword_additive.rb.ut.rb +12 -0
- data/lib/rex/encoding/xor.rb +20 -0
- data/lib/rex/encoding/xor.rb.ts.rb +14 -0
- data/lib/rex/encoding/xor/byte.rb +15 -0
- data/lib/rex/encoding/xor/byte.rb.ut.rb +21 -0
- data/lib/rex/encoding/xor/dword.rb +21 -0
- data/lib/rex/encoding/xor/dword.rb.ut.rb +15 -0
- data/lib/rex/encoding/xor/dword_additive.rb +92 -0
- data/lib/rex/encoding/xor/dword_additive.rb.ut.rb +15 -0
- data/lib/rex/encoding/xor/exceptions.rb +17 -0
- data/lib/rex/encoding/xor/generic.rb +146 -0
- data/lib/rex/encoding/xor/generic.rb.ut.rb +120 -0
- data/lib/rex/encoding/xor/qword.rb +15 -0
- data/lib/rex/encoding/xor/word.rb +21 -0
- data/lib/rex/encoding/xor/word.rb.ut.rb +13 -0
- data/lib/rex/exceptions.rb +275 -0
- data/lib/rex/exceptions.rb.ut.rb +44 -0
- data/lib/rex/exploitation/cmdstager.rb +9 -0
- data/lib/rex/exploitation/cmdstager/base.rb +175 -0
- data/lib/rex/exploitation/cmdstager/debug_asm.rb +142 -0
- data/lib/rex/exploitation/cmdstager/debug_write.rb +136 -0
- data/lib/rex/exploitation/cmdstager/tftp.rb +63 -0
- data/lib/rex/exploitation/cmdstager/vbs.rb +128 -0
- data/lib/rex/exploitation/egghunter.rb +277 -0
- data/lib/rex/exploitation/egghunter.rb.ut.rb +25 -0
- data/lib/rex/exploitation/encryptjs.rb +77 -0
- data/lib/rex/exploitation/heaplib.js.b64 +331 -0
- data/lib/rex/exploitation/heaplib.rb +94 -0
- data/lib/rex/exploitation/javascriptosdetect.rb +897 -0
- data/lib/rex/exploitation/obfuscatejs.rb +335 -0
- data/lib/rex/exploitation/omelet.rb +320 -0
- data/lib/rex/exploitation/omelet.rb.ut.rb +13 -0
- data/lib/rex/exploitation/opcodedb.rb +818 -0
- data/lib/rex/exploitation/opcodedb.rb.ut.rb +279 -0
- data/lib/rex/exploitation/seh.rb +92 -0
- data/lib/rex/exploitation/seh.rb.ut.rb +19 -0
- data/lib/rex/file.rb +112 -0
- data/lib/rex/file.rb.ut.rb +16 -0
- data/lib/rex/image_source.rb +12 -0
- data/lib/rex/image_source/disk.rb +60 -0
- data/lib/rex/image_source/image_source.rb +46 -0
- data/lib/rex/image_source/memory.rb +37 -0
- data/lib/rex/io/bidirectional_pipe.rb +157 -0
- data/lib/rex/io/datagram_abstraction.rb +35 -0
- data/lib/rex/io/ring_buffer.rb +364 -0
- data/lib/rex/io/stream.rb +319 -0
- data/lib/rex/io/stream_abstraction.rb +197 -0
- data/lib/rex/io/stream_server.rb +211 -0
- data/lib/rex/job_container.rb +187 -0
- data/lib/rex/logging.rb +4 -0
- data/lib/rex/logging/log_dispatcher.rb +179 -0
- data/lib/rex/logging/log_sink.rb +42 -0
- data/lib/rex/logging/sinks/flatfile.rb +55 -0
- data/lib/rex/logging/sinks/stderr.rb +43 -0
- data/lib/rex/machparsey.rb +9 -0
- data/lib/rex/machparsey/exceptions.rb +34 -0
- data/lib/rex/machparsey/mach.rb +209 -0
- data/lib/rex/machparsey/machbase.rb +408 -0
- data/lib/rex/machscan.rb +9 -0
- data/lib/rex/machscan/scanner.rb +217 -0
- data/lib/rex/mime.rb +9 -0
- data/lib/rex/mime/header.rb +77 -0
- data/lib/rex/mime/message.rb +144 -0
- data/lib/rex/mime/part.rb +20 -0
- data/lib/rex/nop/opty2.rb +108 -0
- data/lib/rex/nop/opty2.rb.ut.rb +23 -0
- data/lib/rex/nop/opty2_tables.rb +300 -0
- data/lib/rex/ole.rb +205 -0
- data/lib/rex/ole/clsid.rb +47 -0
- data/lib/rex/ole/difat.rb +141 -0
- data/lib/rex/ole/directory.rb +231 -0
- data/lib/rex/ole/direntry.rb +240 -0
- data/lib/rex/ole/docs/dependencies.txt +8 -0
- data/lib/rex/ole/docs/references.txt +1 -0
- data/lib/rex/ole/fat.rb +99 -0
- data/lib/rex/ole/header.rb +204 -0
- data/lib/rex/ole/minifat.rb +77 -0
- data/lib/rex/ole/propset.rb +144 -0
- data/lib/rex/ole/samples/create_ole.rb +27 -0
- data/lib/rex/ole/samples/dir.rb +35 -0
- data/lib/rex/ole/samples/dump_stream.rb +34 -0
- data/lib/rex/ole/samples/ole_info.rb +23 -0
- data/lib/rex/ole/storage.rb +395 -0
- data/lib/rex/ole/stream.rb +53 -0
- data/lib/rex/ole/substorage.rb +49 -0
- data/lib/rex/ole/util.rb +157 -0
- data/lib/rex/parser/arguments.rb +97 -0
- data/lib/rex/parser/arguments.rb.ut.rb +67 -0
- data/lib/rex/parser/ini.rb +185 -0
- data/lib/rex/parser/ini.rb.ut.rb +29 -0
- data/lib/rex/parser/ip360_aspl_xml.rb +102 -0
- data/lib/rex/parser/ip360_xml.rb +97 -0
- data/lib/rex/parser/nessus_xml.rb +118 -0
- data/lib/rex/parser/netsparker_xml.rb +94 -0
- data/lib/rex/parser/nexpose_xml.rb +136 -0
- data/lib/rex/parser/nmap_xml.rb +137 -0
- data/lib/rex/parser/retina_xml.rb +109 -0
- data/lib/rex/payloads.rb +1 -0
- data/lib/rex/payloads/win32.rb +2 -0
- data/lib/rex/payloads/win32/common.rb +26 -0
- data/lib/rex/payloads/win32/kernel.rb +53 -0
- data/lib/rex/payloads/win32/kernel/common.rb +54 -0
- data/lib/rex/payloads/win32/kernel/migration.rb +12 -0
- data/lib/rex/payloads/win32/kernel/recovery.rb +50 -0
- data/lib/rex/payloads/win32/kernel/stager.rb +194 -0
- data/lib/rex/peparsey.rb +12 -0
- data/lib/rex/peparsey/exceptions.rb +32 -0
- data/lib/rex/peparsey/pe.rb +212 -0
- data/lib/rex/peparsey/pe_memdump.rb +63 -0
- data/lib/rex/peparsey/pebase.rb +1680 -0
- data/lib/rex/peparsey/section.rb +136 -0
- data/lib/rex/pescan.rb +13 -0
- data/lib/rex/pescan/analyze.rb +309 -0
- data/lib/rex/pescan/scanner.rb +206 -0
- data/lib/rex/pescan/search.rb +56 -0
- data/lib/rex/platforms.rb +1 -0
- data/lib/rex/platforms/windows.rb +51 -0
- data/lib/rex/poly.rb +132 -0
- data/lib/rex/poly/block.rb +477 -0
- data/lib/rex/poly/register.rb +100 -0
- data/lib/rex/poly/register/x86.rb +40 -0
- data/lib/rex/post.rb +8 -0
- data/lib/rex/post/dir.rb +51 -0
- data/lib/rex/post/file.rb +172 -0
- data/lib/rex/post/file_stat.rb +220 -0
- data/lib/rex/post/gen.pl +13 -0
- data/lib/rex/post/io.rb +182 -0
- data/lib/rex/post/meterpreter.rb +4 -0
- data/lib/rex/post/meterpreter/channel.rb +445 -0
- data/lib/rex/post/meterpreter/channel_container.rb +54 -0
- data/lib/rex/post/meterpreter/channels/pool.rb +160 -0
- data/lib/rex/post/meterpreter/channels/pools/file.rb +62 -0
- data/lib/rex/post/meterpreter/channels/pools/stream_pool.rb +103 -0
- data/lib/rex/post/meterpreter/channels/stream.rb +87 -0
- data/lib/rex/post/meterpreter/client.rb +364 -0
- data/lib/rex/post/meterpreter/client_core.rb +274 -0
- data/lib/rex/post/meterpreter/dependencies.rb +3 -0
- data/lib/rex/post/meterpreter/extension.rb +32 -0
- data/lib/rex/post/meterpreter/extensions/espia/espia.rb +58 -0
- data/lib/rex/post/meterpreter/extensions/espia/tlv.rb +16 -0
- data/lib/rex/post/meterpreter/extensions/incognito/incognito.rb +94 -0
- data/lib/rex/post/meterpreter/extensions/incognito/tlv.rb +21 -0
- data/lib/rex/post/meterpreter/extensions/networkpug/networkpug.rb +57 -0
- data/lib/rex/post/meterpreter/extensions/networkpug/tlv.rb +15 -0
- data/lib/rex/post/meterpreter/extensions/priv/fs.rb +118 -0
- data/lib/rex/post/meterpreter/extensions/priv/passwd.rb +61 -0
- data/lib/rex/post/meterpreter/extensions/priv/priv.rb +111 -0
- data/lib/rex/post/meterpreter/extensions/priv/tlv.rb +28 -0
- data/lib/rex/post/meterpreter/extensions/sniffer/sniffer.rb +101 -0
- data/lib/rex/post/meterpreter/extensions/sniffer/tlv.rb +26 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/constants.rb +333 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/dir.rb +282 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/file.rb +266 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/file_stat.rb +103 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/fs/io.rb +48 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/config.rb +144 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/interface.rb +73 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/route.rb +56 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/socket.rb +137 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/socket_subsystem/tcp_client_channel.rb +180 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/socket_subsystem/tcp_server_channel.rb +167 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/net/socket_subsystem/udp_channel.rb +208 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun.rb.ts.rb +6 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/api_constants.rb +38106 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/api_constants.rb.ut.rb +31 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/buffer_item.rb +47 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/buffer_item.rb.ut.rb +36 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_advapi32.rb +1818 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_iphlpapi.rb +96 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_kernel32.rb +3848 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_netapi32.rb +26 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_ntdll.rb +153 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_shell32.rb +21 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_user32.rb +3169 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/def/def_ws2_32.rb +599 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/dll.rb +318 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/dll_function.rb +100 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/dll_function.rb.ut.rb +42 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/dll_helper.rb +148 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/dll_helper.rb.ut.rb +127 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/multicall.rb +309 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/railgun.rb +204 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/tlv.rb +51 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/util.rb +630 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/win_const_manager.rb +75 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/railgun/win_const_manager.rb.ut.rb +103 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/stdapi.rb +149 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/config.rb +97 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/event_log.rb +192 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/event_log_subsystem/event_record.rb +41 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/power.rb +61 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process.rb +370 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/image.rb +129 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/io.rb +55 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/memory.rb +336 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/process_subsystem/thread.rb +141 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry.rb +279 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry_subsystem/registry_key.rb +193 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/registry_subsystem/registry_value.rb +102 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/sys/thread.rb +180 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/tlv.rb +211 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/ui.rb +227 -0
- data/lib/rex/post/meterpreter/extensions/stdapi/webcam/webcam.rb +63 -0
- data/lib/rex/post/meterpreter/inbound_packet_handler.rb +30 -0
- data/lib/rex/post/meterpreter/object_aliases.rb +83 -0
- data/lib/rex/post/meterpreter/packet.rb +688 -0
- data/lib/rex/post/meterpreter/packet_dispatcher.rb +431 -0
- data/lib/rex/post/meterpreter/packet_parser.rb +94 -0
- data/lib/rex/post/meterpreter/packet_response_waiter.rb +83 -0
- data/lib/rex/post/meterpreter/ui/console.rb +137 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher.rb +62 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/core.rb +730 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/espia.rb +108 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/incognito.rb +241 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/networkpug.rb +231 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv.rb +61 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/elevate.rb +98 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/passwd.rb +51 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/priv/timestomp.rb +132 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/sniffer.rb +187 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi.rb +65 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/fs.rb +442 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/net.rb +298 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/sys.rb +486 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/ui.rb +315 -0
- data/lib/rex/post/meterpreter/ui/console/command_dispatcher/stdapi/webcam.rb +157 -0
- data/lib/rex/post/meterpreter/ui/console/interactive_channel.rb +95 -0
- data/lib/rex/post/permission.rb +26 -0
- data/lib/rex/post/process.rb +57 -0
- data/lib/rex/post/thread.rb +57 -0
- data/lib/rex/post/ui.rb +52 -0
- data/lib/rex/proto.rb +13 -0
- data/lib/rex/proto.rb.ts.rb +8 -0
- data/lib/rex/proto/dcerpc.rb +6 -0
- data/lib/rex/proto/dcerpc.rb.ts.rb +9 -0
- data/lib/rex/proto/dcerpc/client.rb +361 -0
- data/lib/rex/proto/dcerpc/client.rb.ut.rb +491 -0
- data/lib/rex/proto/dcerpc/exceptions.rb +150 -0
- data/lib/rex/proto/dcerpc/handle.rb +47 -0
- data/lib/rex/proto/dcerpc/handle.rb.ut.rb +85 -0
- data/lib/rex/proto/dcerpc/ndr.rb +72 -0
- data/lib/rex/proto/dcerpc/ndr.rb.ut.rb +41 -0
- data/lib/rex/proto/dcerpc/packet.rb +253 -0
- data/lib/rex/proto/dcerpc/packet.rb.ut.rb +56 -0
- data/lib/rex/proto/dcerpc/response.rb +187 -0
- data/lib/rex/proto/dcerpc/response.rb.ut.rb +15 -0
- data/lib/rex/proto/dcerpc/uuid.rb +84 -0
- data/lib/rex/proto/dcerpc/uuid.rb.ut.rb +46 -0
- data/lib/rex/proto/dhcp.rb +7 -0
- data/lib/rex/proto/dhcp/constants.rb +33 -0
- data/lib/rex/proto/dhcp/server.rb +292 -0
- data/lib/rex/proto/drda.rb +5 -0
- data/lib/rex/proto/drda.rb.ts.rb +17 -0
- data/lib/rex/proto/drda/constants.rb +49 -0
- data/lib/rex/proto/drda/constants.rb.ut.rb +23 -0
- data/lib/rex/proto/drda/packet.rb +252 -0
- data/lib/rex/proto/drda/packet.rb.ut.rb +109 -0
- data/lib/rex/proto/drda/utils.rb +123 -0
- data/lib/rex/proto/drda/utils.rb.ut.rb +84 -0
- data/lib/rex/proto/http.rb +5 -0
- data/lib/rex/proto/http.rb.ts.rb +12 -0
- data/lib/rex/proto/http/client.rb +821 -0
- data/lib/rex/proto/http/client.rb.ut.rb +95 -0
- data/lib/rex/proto/http/handler.rb +46 -0
- data/lib/rex/proto/http/handler/erb.rb +128 -0
- data/lib/rex/proto/http/handler/erb.rb.ut.rb +21 -0
- data/lib/rex/proto/http/handler/erb.rb.ut.rb.rhtml +1 -0
- data/lib/rex/proto/http/handler/proc.rb +60 -0
- data/lib/rex/proto/http/handler/proc.rb.ut.rb +24 -0
- data/lib/rex/proto/http/header.rb +161 -0
- data/lib/rex/proto/http/header.rb.ut.rb +46 -0
- data/lib/rex/proto/http/packet.rb +407 -0
- data/lib/rex/proto/http/packet.rb.ut.rb +165 -0
- data/lib/rex/proto/http/request.rb +356 -0
- data/lib/rex/proto/http/request.rb.ut.rb +214 -0
- data/lib/rex/proto/http/response.rb +90 -0
- data/lib/rex/proto/http/response.rb.ut.rb +149 -0
- data/lib/rex/proto/http/server.rb +369 -0
- data/lib/rex/proto/http/server.rb.ut.rb +79 -0
- data/lib/rex/proto/ntlm.rb +7 -0
- data/lib/rex/proto/ntlm.rb.ut.rb +177 -0
- data/lib/rex/proto/ntlm/base.rb +326 -0
- data/lib/rex/proto/ntlm/constants.rb +74 -0
- data/lib/rex/proto/ntlm/crypt.rb +415 -0
- data/lib/rex/proto/ntlm/exceptions.rb +16 -0
- data/lib/rex/proto/ntlm/message.rb +536 -0
- data/lib/rex/proto/ntlm/utils.rb +764 -0
- data/lib/rex/proto/proxy/socks4a.rb +440 -0
- data/lib/rex/proto/rfb.rb +19 -0
- data/lib/rex/proto/rfb.rb.ut.rb +37 -0
- data/lib/rex/proto/rfb/cipher.rb +84 -0
- data/lib/rex/proto/rfb/client.rb +207 -0
- data/lib/rex/proto/rfb/constants.rb +52 -0
- data/lib/rex/proto/smb.rb +7 -0
- data/lib/rex/proto/smb.rb.ts.rb +8 -0
- data/lib/rex/proto/smb/client.rb +1952 -0
- data/lib/rex/proto/smb/client.rb.ut.rb +223 -0
- data/lib/rex/proto/smb/constants.rb +1047 -0
- data/lib/rex/proto/smb/constants.rb.ut.rb +18 -0
- data/lib/rex/proto/smb/crypt.rb +36 -0
- data/lib/rex/proto/smb/evasions.rb +66 -0
- data/lib/rex/proto/smb/exceptions.rb +858 -0
- data/lib/rex/proto/smb/simpleclient.rb +306 -0
- data/lib/rex/proto/smb/simpleclient.rb.ut.rb +128 -0
- data/lib/rex/proto/smb/utils.rb +103 -0
- data/lib/rex/proto/smb/utils.rb.ut.rb +20 -0
- data/lib/rex/proto/sunrpc.rb +1 -0
- data/lib/rex/proto/sunrpc/client.rb +195 -0
- data/lib/rex/proto/tftp.rb +12 -0
- data/lib/rex/proto/tftp/constants.rb +39 -0
- data/lib/rex/proto/tftp/server.rb +497 -0
- data/lib/rex/proto/tftp/server.rb.ut.rb +28 -0
- data/lib/rex/script.rb +42 -0
- data/lib/rex/script/base.rb +59 -0
- data/lib/rex/script/meterpreter.rb +15 -0
- data/lib/rex/script/shell.rb +9 -0
- data/lib/rex/service.rb +48 -0
- data/lib/rex/service_manager.rb +141 -0
- data/lib/rex/service_manager.rb.ut.rb +32 -0
- data/lib/rex/services/local_relay.rb +423 -0
- data/lib/rex/socket.rb +684 -0
- data/lib/rex/socket.rb.ut.rb +107 -0
- data/lib/rex/socket/comm.rb +119 -0
- data/lib/rex/socket/comm/local.rb +412 -0
- data/lib/rex/socket/comm/local.rb.ut.rb +75 -0
- data/lib/rex/socket/ip.rb +130 -0
- data/lib/rex/socket/parameters.rb +345 -0
- data/lib/rex/socket/parameters.rb.ut.rb +51 -0
- data/lib/rex/socket/range_walker.rb +346 -0
- data/lib/rex/socket/range_walker.rb.ut.rb +55 -0
- data/lib/rex/socket/ssl_tcp.rb +184 -0
- data/lib/rex/socket/ssl_tcp.rb.ut.rb +39 -0
- data/lib/rex/socket/ssl_tcp_server.rb +122 -0
- data/lib/rex/socket/ssl_tcp_server.rb.ut.rb +61 -0
- data/lib/rex/socket/subnet_walker.rb +75 -0
- data/lib/rex/socket/subnet_walker.rb.ut.rb +28 -0
- data/lib/rex/socket/switch_board.rb +278 -0
- data/lib/rex/socket/switch_board.rb.ut.rb +52 -0
- data/lib/rex/socket/tcp.rb +76 -0
- data/lib/rex/socket/tcp.rb.ut.rb +64 -0
- data/lib/rex/socket/tcp_server.rb +66 -0
- data/lib/rex/socket/tcp_server.rb.ut.rb +44 -0
- data/lib/rex/socket/udp.rb +164 -0
- data/lib/rex/socket/udp.rb.ut.rb +44 -0
- data/lib/rex/struct2.rb +5 -0
- data/lib/rex/struct2/c_struct.rb +181 -0
- data/lib/rex/struct2/c_struct_template.rb +39 -0
- data/lib/rex/struct2/constant.rb +26 -0
- data/lib/rex/struct2/element.rb +44 -0
- data/lib/rex/struct2/generic.rb +73 -0
- data/lib/rex/struct2/restraint.rb +54 -0
- data/lib/rex/struct2/s_string.rb +72 -0
- data/lib/rex/struct2/s_struct.rb +111 -0
- data/lib/rex/sync.rb +6 -0
- data/lib/rex/sync/event.rb +94 -0
- data/lib/rex/sync/read_write_lock.rb +176 -0
- data/lib/rex/sync/ref.rb +57 -0
- data/lib/rex/sync/thread_safe.rb +82 -0
- data/lib/rex/test.rb +35 -0
- data/lib/rex/text.rb +1163 -0
- data/lib/rex/text.rb.ut.rb +190 -0
- data/lib/rex/thread_factory.rb +42 -0
- data/lib/rex/time.rb +65 -0
- data/lib/rex/transformer.rb +115 -0
- data/lib/rex/transformer.rb.ut.rb +38 -0
- data/lib/rex/ui.rb +21 -0
- data/lib/rex/ui/interactive.rb +298 -0
- data/lib/rex/ui/output.rb +78 -0
- data/lib/rex/ui/output/none.rb +18 -0
- data/lib/rex/ui/progress_tracker.rb +96 -0
- data/lib/rex/ui/subscriber.rb +149 -0
- data/lib/rex/ui/text/color.rb +97 -0
- data/lib/rex/ui/text/color.rb.ut.rb +18 -0
- data/lib/rex/ui/text/dispatcher_shell.rb +467 -0
- data/lib/rex/ui/text/input.rb +117 -0
- data/lib/rex/ui/text/input/buffer.rb +75 -0
- data/lib/rex/ui/text/input/readline.rb +129 -0
- data/lib/rex/ui/text/input/socket.rb +95 -0
- data/lib/rex/ui/text/input/stdio.rb +45 -0
- data/lib/rex/ui/text/irb_shell.rb +57 -0
- data/lib/rex/ui/text/output.rb +80 -0
- data/lib/rex/ui/text/output/buffer.rb +61 -0
- data/lib/rex/ui/text/output/file.rb +43 -0
- data/lib/rex/ui/text/output/socket.rb +43 -0
- data/lib/rex/ui/text/output/stdio.rb +40 -0
- data/lib/rex/ui/text/progress_tracker.rb +56 -0
- data/lib/rex/ui/text/progress_tracker.rb.ut.rb +34 -0
- data/lib/rex/ui/text/shell.rb +328 -0
- data/lib/rex/ui/text/table.rb +279 -0
- data/lib/rex/ui/text/table.rb.ut.rb +55 -0
- data/lib/rex/zip.rb +93 -0
- data/lib/rex/zip/archive.rb +184 -0
- data/lib/rex/zip/blocks.rb +182 -0
- data/lib/rex/zip/entry.rb +104 -0
- data/lib/rex/zip/samples/comment.rb +32 -0
- data/lib/rex/zip/samples/mkwar.rb +138 -0
- data/lib/rex/zip/samples/mkzip.rb +19 -0
- data/lib/rex/zip/samples/recursive.rb +58 -0
- metadata +434 -1
@@ -0,0 +1,318 @@
|
|
1
|
+
# Copyright (c) 2010, patrickHVE@googlemail.com
|
2
|
+
# All rights reserved.
|
3
|
+
#
|
4
|
+
# Redistribution and use in source and binary forms, with or without
|
5
|
+
# modification, are permitted provided that the following conditions are met:
|
6
|
+
# * Redistributions of source code must retain the above copyright
|
7
|
+
# notice, this list of conditions and the following disclaimer.
|
8
|
+
# * Redistributions in binary form must reproduce the above copyright
|
9
|
+
# notice, this list of conditions and the following disclaimer in the
|
10
|
+
# documentation and/or other materials provided with the distribution.
|
11
|
+
# * The names of the author may not be used to endorse or promote products
|
12
|
+
# derived from this software without specific prior written permission.
|
13
|
+
#
|
14
|
+
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
15
|
+
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
16
|
+
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
17
|
+
# DISCLAIMED. IN NO EVENT SHALL patrickHVE@googlemail.com BE LIABLE FOR ANY
|
18
|
+
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
19
|
+
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
20
|
+
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
21
|
+
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
22
|
+
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
23
|
+
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
24
|
+
|
25
|
+
require 'rex/post/meterpreter/extensions/stdapi/railgun/dll_helper'
|
26
|
+
require 'rex/post/meterpreter/extensions/stdapi/railgun/dll_function'
|
27
|
+
require 'rex/post/meterpreter/extensions/stdapi/railgun/buffer_item'
|
28
|
+
|
29
|
+
module Rex
|
30
|
+
module Post
|
31
|
+
module Meterpreter
|
32
|
+
module Extensions
|
33
|
+
module Stdapi
|
34
|
+
module Railgun
|
35
|
+
|
36
|
+
#
|
37
|
+
# represents a DLL, e.g. kernel32.dll
|
38
|
+
#
|
39
|
+
class DLL
|
40
|
+
|
41
|
+
include DLLHelper
|
42
|
+
|
43
|
+
attr_accessor :functions
|
44
|
+
|
45
|
+
def initialize(dll_path, client, win_consts) #
|
46
|
+
@dll_path = dll_path
|
47
|
+
@client = client
|
48
|
+
@win_consts = win_consts
|
49
|
+
if( @client.platform =~ /x64/i )
|
50
|
+
@native = 'Q'
|
51
|
+
else
|
52
|
+
@native = 'V'
|
53
|
+
end
|
54
|
+
self.functions = {}
|
55
|
+
end
|
56
|
+
|
57
|
+
# adds a function to the DLL
|
58
|
+
# syntax for params:
|
59
|
+
# add_function("MessageBoxW", # name
|
60
|
+
# "DWORD", # return value
|
61
|
+
# [["DWORD","hWnd","in"], # params
|
62
|
+
# ["PWCHAR","lpText","in"],
|
63
|
+
# ["PWCHAR","lpCaption","in"],
|
64
|
+
# ["DWORD","uType","in"],
|
65
|
+
# ])
|
66
|
+
#
|
67
|
+
# Every function argument is described by a tuple (type,name,direction)
|
68
|
+
#
|
69
|
+
# windows_name: Use it when the actual windows name is different from the ruby variable
|
70
|
+
# for example when the actual func name is myFunc@4
|
71
|
+
# or when you want to create an alternative version of an existing function
|
72
|
+
#
|
73
|
+
# When new function is called it will return a list containing the return value and all inout params
|
74
|
+
def add_function(name, return_type, params, windows_name=nil)
|
75
|
+
if windows_name == nil
|
76
|
+
windows_name = name
|
77
|
+
end
|
78
|
+
@functions[name] = DLLFunction.new(return_type, params, windows_name)
|
79
|
+
end
|
80
|
+
|
81
|
+
private
|
82
|
+
|
83
|
+
# called when a function like "MessageBoxW" is called
|
84
|
+
def process_function_call(function, args)
|
85
|
+
raise "#{function.params.length} arguments expected. #{args.length} arguments provided." unless args.length == function.params.length
|
86
|
+
#puts "process_function_call(function.windows_name,#{PP.pp(args, "")})"
|
87
|
+
|
88
|
+
# We transmit the immediate stack and three heap-buffers:
|
89
|
+
# in, inout and out. The reason behind the separation is bandwidth.
|
90
|
+
# We don't want to transmit uninitialized data in or no-longer-needed data out.
|
91
|
+
|
92
|
+
# out-only-buffers that are ONLY transmitted on the way BACK
|
93
|
+
out_only_layout = {} # paramName => BufferItem
|
94
|
+
out_only_size_bytes = 0
|
95
|
+
#puts " assembling out-only buffer"
|
96
|
+
function.params.each_with_index do |param_desc, param_idx|
|
97
|
+
#puts " processing #{param_desc[1]}"
|
98
|
+
|
99
|
+
# Special case:
|
100
|
+
# The user can choose to supply a Null pointer instead of a buffer
|
101
|
+
# in this case we don't need space in any heap buffer
|
102
|
+
if param_desc[0][0,1] == 'P' # type is a pointer
|
103
|
+
if args[param_idx] == nil
|
104
|
+
next
|
105
|
+
end
|
106
|
+
end
|
107
|
+
|
108
|
+
# we care only about out-only buffers
|
109
|
+
if param_desc[2] == "out"
|
110
|
+
raise "error in param #{param_desc[1]}: Out-only buffers must be described by a number indicating their size in bytes " unless args[param_idx].class == Fixnum
|
111
|
+
buffer_size = args[param_idx]
|
112
|
+
if param_desc[0] == "PDWORD"
|
113
|
+
# bump up the size for an x64 pointer
|
114
|
+
if( @native == 'Q' and buffer_size == 4 )
|
115
|
+
args[param_idx] = 8
|
116
|
+
buffer_size = args[param_idx]
|
117
|
+
end
|
118
|
+
|
119
|
+
if( @native == 'Q' )
|
120
|
+
raise "Please pass 8 for 'out' PDWORDS, since they require a buffer of size 8" unless buffer_size == 8
|
121
|
+
elsif( @native == 'V' )
|
122
|
+
raise "Please pass 4 for 'out' PDWORDS, since they require a buffer of size 4" unless buffer_size == 4
|
123
|
+
end
|
124
|
+
end
|
125
|
+
|
126
|
+
out_only_layout[param_desc[1]] = BufferItem.new(param_idx, out_only_size_bytes, buffer_size, param_desc[0])
|
127
|
+
out_only_size_bytes += buffer_size
|
128
|
+
end
|
129
|
+
end
|
130
|
+
|
131
|
+
tmp = assemble_buffer("in", function, args)
|
132
|
+
in_only_layout = tmp[0]
|
133
|
+
in_only_buffer = tmp[1]
|
134
|
+
|
135
|
+
tmp = assemble_buffer("inout", function, args)
|
136
|
+
inout_layout = tmp[0]
|
137
|
+
inout_buffer = tmp[1]
|
138
|
+
|
139
|
+
# now we build the stack
|
140
|
+
# every stack dword will be described by two dwords:
|
141
|
+
# first dword describes second dword:
|
142
|
+
# 0 - literal,
|
143
|
+
# 1 = relative to in-only buffer
|
144
|
+
# 2 = relative to out-only buffer
|
145
|
+
# 3 = relative to inout buffer
|
146
|
+
|
147
|
+
# (literal numbers and pointers to buffers we have created)
|
148
|
+
literal_pairs_blob = ""
|
149
|
+
#puts " assembling literal stack"
|
150
|
+
function.params.each_with_index do |param_desc, param_idx|
|
151
|
+
#puts " processing (#{param_desc[0]}, #{param_desc[1]}, #{param_desc[2]})"
|
152
|
+
buffer = nil
|
153
|
+
# is it a pointer to a buffer on our stack
|
154
|
+
if ["PDWORD", "PWCHAR", "PCHAR", "PBLOB"].include? param_desc[0]
|
155
|
+
#puts " pointer"
|
156
|
+
if args[param_idx] == nil # null pointer?
|
157
|
+
buffer = [0].pack(@native) # type: DWORD (so the dll does not rebase it)
|
158
|
+
buffer += [0].pack(@native) # value: 0
|
159
|
+
elsif param_desc[2] == "in"
|
160
|
+
buffer = [1].pack(@native)
|
161
|
+
buffer += [in_only_layout[param_desc[1]].addr].pack(@native)
|
162
|
+
elsif param_desc[2] == "out"
|
163
|
+
buffer = [2].pack(@native)
|
164
|
+
buffer += [out_only_layout[param_desc[1]].addr].pack(@native)
|
165
|
+
elsif param_desc[2] == "inout"
|
166
|
+
buffer = [3].pack(@native)
|
167
|
+
buffer += [inout_layout[param_desc[1]].addr].pack(@native)
|
168
|
+
else
|
169
|
+
raise "unexpected direction"
|
170
|
+
end
|
171
|
+
else
|
172
|
+
#puts " not a pointer"
|
173
|
+
# it's not a pointer (LPVOID is a pointer but is not backed by railgun memory, ala PBLOB)
|
174
|
+
buffer = [0].pack(@native)
|
175
|
+
case param_desc[0]
|
176
|
+
when "LPVOID", "HANDLE"
|
177
|
+
num = param_to_number(args[param_idx])
|
178
|
+
buffer += [num].pack(@native)
|
179
|
+
when "DWORD"
|
180
|
+
num = param_to_number(args[param_idx])
|
181
|
+
buffer += [num % 4294967296].pack(@native)
|
182
|
+
when "WORD"
|
183
|
+
num = param_to_number(args[param_idx])
|
184
|
+
buffer += [num % 65536].pack(@native)
|
185
|
+
when "BYTE"
|
186
|
+
num = param_to_number(args[param_idx])
|
187
|
+
buffer += [num % 256].pack(@native)
|
188
|
+
when "BOOL"
|
189
|
+
case args[param_idx]
|
190
|
+
when true
|
191
|
+
buffer += [1].pack(@native)
|
192
|
+
when false
|
193
|
+
buffer += [0].pack(@native)
|
194
|
+
else
|
195
|
+
raise "param #{param_desc[1]}: true or false expected"
|
196
|
+
end
|
197
|
+
else
|
198
|
+
raise "unexpected type for param #{param_desc[1]}"
|
199
|
+
end
|
200
|
+
end
|
201
|
+
|
202
|
+
#puts " adding pair to blob"
|
203
|
+
literal_pairs_blob += buffer
|
204
|
+
#puts " buffer size %X" % buffer.length
|
205
|
+
#puts " blob size so far: %X" % literal_pairs_blob.length
|
206
|
+
end
|
207
|
+
|
208
|
+
#puts "\n\nsending Stuff to meterpreter"
|
209
|
+
request = Packet.create_request('stdapi_railgun_api')
|
210
|
+
request.add_tlv(TLV_TYPE_RAILGUN_SIZE_OUT, out_only_size_bytes)
|
211
|
+
|
212
|
+
request.add_tlv(TLV_TYPE_RAILGUN_STACKBLOB, literal_pairs_blob)
|
213
|
+
request.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_IN, in_only_buffer)
|
214
|
+
request.add_tlv(TLV_TYPE_RAILGUN_BUFFERBLOB_INOUT, inout_buffer)
|
215
|
+
|
216
|
+
request.add_tlv(TLV_TYPE_RAILGUN_DLLNAME, @dll_path )
|
217
|
+
request.add_tlv(TLV_TYPE_RAILGUN_FUNCNAME, function.windows_name)
|
218
|
+
|
219
|
+
response = @client.send_request(request)
|
220
|
+
|
221
|
+
#puts "receiving Stuff from meterpreter"
|
222
|
+
#puts "out_only_layout:"
|
223
|
+
#puts out_only_layout
|
224
|
+
|
225
|
+
rec_inout_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_INOUT)
|
226
|
+
rec_out_only_buffers = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_BUFFERBLOB_OUT)
|
227
|
+
rec_return_value = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_RET)
|
228
|
+
rec_last_error = response.get_tlv_value(TLV_TYPE_RAILGUN_BACK_ERR)
|
229
|
+
|
230
|
+
#puts "received stuff"
|
231
|
+
#puts "out_only_layout:"
|
232
|
+
#puts out_only_layout
|
233
|
+
|
234
|
+
# The hash the function returns
|
235
|
+
return_hash={"GetLastError" => rec_last_error}
|
236
|
+
|
237
|
+
#process return value
|
238
|
+
case function.return_type
|
239
|
+
when "LPVOID", "HANDLE"
|
240
|
+
if( @native == 'Q' )
|
241
|
+
return_hash["return"] = rec_return_value
|
242
|
+
else
|
243
|
+
return_hash["return"] = rec_return_value % 4294967296
|
244
|
+
end
|
245
|
+
when "DWORD"
|
246
|
+
return_hash["return"] = rec_return_value % 4294967296
|
247
|
+
when "WORD"
|
248
|
+
return_hash["return"] = rec_return_value % 65536
|
249
|
+
when "BYTE"
|
250
|
+
return_hash["return"] = rec_return_value % 256
|
251
|
+
when "BOOL"
|
252
|
+
return_hash["return"] = (rec_return_value != 0)
|
253
|
+
when "VOID"
|
254
|
+
return_hash["return"] = nil
|
255
|
+
else
|
256
|
+
raise "unexpected return type: #{function.return_type}"
|
257
|
+
end
|
258
|
+
#puts return_hash
|
259
|
+
#puts "out_only_layout:"
|
260
|
+
#puts out_only_layout
|
261
|
+
|
262
|
+
|
263
|
+
# process out-only buffers
|
264
|
+
#puts "processing out-only buffers:"
|
265
|
+
out_only_layout.each_pair do |param_name, buffer_item|
|
266
|
+
#puts " #{param_name}"
|
267
|
+
buffer = rec_out_only_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
268
|
+
case buffer_item.datatype
|
269
|
+
when "PDWORD"
|
270
|
+
return_hash[param_name] = buffer.unpack('V')[0]
|
271
|
+
when "PCHAR"
|
272
|
+
return_hash[param_name] = asciiz_to_str(buffer)
|
273
|
+
when "PWCHAR"
|
274
|
+
return_hash[param_name] = uniz_to_str(buffer)
|
275
|
+
when "PBLOB"
|
276
|
+
return_hash[param_name] = buffer
|
277
|
+
else
|
278
|
+
raise "unexpected type in out-only buffer of #{param_name}: #{buffer_item.datatype}"
|
279
|
+
end
|
280
|
+
end
|
281
|
+
#puts return_hash
|
282
|
+
|
283
|
+
# process in-out buffers
|
284
|
+
#puts "processing in-out buffers:"
|
285
|
+
inout_layout.each_pair do |param_name, buffer_item|
|
286
|
+
#puts " #{param_name}"
|
287
|
+
buffer = rec_inout_buffers[buffer_item.addr, buffer_item.length_in_bytes]
|
288
|
+
case buffer_item.datatype
|
289
|
+
when "PDWORD"
|
290
|
+
return_hash[param_name] = buffer.unpack('V')[0]
|
291
|
+
when "PCHAR"
|
292
|
+
return_hash[param_name] = asciiz_to_str(buffer)
|
293
|
+
when "PWCHAR"
|
294
|
+
return_hash[param_name] = uniz_to_str(buffer)
|
295
|
+
when "PBLOB"
|
296
|
+
return_hash[param_name] = buffer
|
297
|
+
else
|
298
|
+
raise "unexpected type in in-out-buffer of #{param_name}: #{buffer_item.datatype}"
|
299
|
+
end
|
300
|
+
end
|
301
|
+
#puts return_hash
|
302
|
+
#puts "finished"
|
303
|
+
|
304
|
+
return return_hash
|
305
|
+
end
|
306
|
+
|
307
|
+
# process_function_call
|
308
|
+
|
309
|
+
# we fake having methods like "MessageBoxW" by intercepting "method-not-found"-exceptions
|
310
|
+
def method_missing(func_symbol, *args)
|
311
|
+
func_name = func_symbol.to_s
|
312
|
+
raise "DLL-function #{func_name} not found. Known functions: #{PP.pp(@functions.keys, "")}" unless @functions.has_key? func_name
|
313
|
+
function = @functions[func_name]
|
314
|
+
return process_function_call(function, args)
|
315
|
+
end
|
316
|
+
end
|
317
|
+
|
318
|
+
end; end; end; end; end; end;
|
@@ -0,0 +1,100 @@
|
|
1
|
+
# Copyright (c) 2010, patrickHVE@googlemail.com
|
2
|
+
# All rights reserved.
|
3
|
+
#
|
4
|
+
# Redistribution and use in source and binary forms, with or without
|
5
|
+
# modification, are permitted provided that the following conditions are met:
|
6
|
+
# * Redistributions of source code must retain the above copyright
|
7
|
+
# notice, this list of conditions and the following disclaimer.
|
8
|
+
# * Redistributions in binary form must reproduce the above copyright
|
9
|
+
# notice, this list of conditions and the following disclaimer in the
|
10
|
+
# documentation and/or other materials provided with the distribution.
|
11
|
+
# * The names of the author may not be used to endorse or promote products
|
12
|
+
# derived from this software without specific prior written permission.
|
13
|
+
#
|
14
|
+
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
15
|
+
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
16
|
+
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
17
|
+
# DISCLAIMED. IN NO EVENT SHALL patrickHVE@googlemail.com BE LIABLE FOR ANY
|
18
|
+
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
19
|
+
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
20
|
+
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
21
|
+
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
22
|
+
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
23
|
+
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
24
|
+
|
25
|
+
module Rex
|
26
|
+
module Post
|
27
|
+
module Meterpreter
|
28
|
+
module Extensions
|
29
|
+
module Stdapi
|
30
|
+
module Railgun
|
31
|
+
|
32
|
+
#
|
33
|
+
# represents one function, e.g. MessageBoxW
|
34
|
+
#
|
35
|
+
class DLLFunction
|
36
|
+
@@allowed_datatypes = {
|
37
|
+
"VOID" => ["return"],
|
38
|
+
"BOOL" => ["in", "return"],
|
39
|
+
"DWORD" => ["in", "return"],
|
40
|
+
"WORD" => ["in", "return"],
|
41
|
+
"BYTE" => ["in", "return"],
|
42
|
+
"LPVOID" => ["in", "return"], # sf: for specifying a memory address (e.g. VirtualAlloc/HeapAlloc/...) where we dont want ot back it up with actuall mem ala PBLOB
|
43
|
+
"HANDLE" => ["in", "return"],
|
44
|
+
"PDWORD" => ["in", "out", "inout"], # todo: support for functions that return pointers to strings
|
45
|
+
"PWCHAR" => ["in", "out", "inout"],
|
46
|
+
"PCHAR" => ["in", "out", "inout"],
|
47
|
+
"PBLOB" => ["in", "out", "inout"],
|
48
|
+
}.freeze
|
49
|
+
|
50
|
+
@@directions = ["in", "out", "inout", "return"].freeze
|
51
|
+
|
52
|
+
attr_reader :return_type, :params, :windows_name
|
53
|
+
|
54
|
+
def initialize(return_type, params, windows_name)
|
55
|
+
check_return_type(return_type) # we do error checking as early as possible so the library is easier to use
|
56
|
+
check_params(params)
|
57
|
+
@return_type = return_type
|
58
|
+
@params = params
|
59
|
+
@windows_name = windows_name
|
60
|
+
end
|
61
|
+
|
62
|
+
private
|
63
|
+
|
64
|
+
def check_type_exists (type)
|
65
|
+
if not @@allowed_datatypes.has_key?(type)
|
66
|
+
raise ArgumentError, "Type unknown: #{type}. Allowed types: #{PP.pp(@@allowed_datatypes.keys, "")}"
|
67
|
+
end
|
68
|
+
end
|
69
|
+
|
70
|
+
def check_return_type (type)
|
71
|
+
check_type_exists(type)
|
72
|
+
if not @@allowed_datatypes[type].include?("return")
|
73
|
+
raise ArgumentError, "#{type} is not allowed as a return type"
|
74
|
+
end
|
75
|
+
end
|
76
|
+
|
77
|
+
def check_params (params)
|
78
|
+
params.each do |param|
|
79
|
+
raise ArgumentError, "each param must be descriped by a three-tuple [type,name,direction]" unless param.length == 3
|
80
|
+
type = param[0]
|
81
|
+
direction = param[2]
|
82
|
+
|
83
|
+
# Assert a valid type
|
84
|
+
check_type_exists(type)
|
85
|
+
|
86
|
+
# Only our set of predefined directions are valid
|
87
|
+
unless @@directions.include?(direction)
|
88
|
+
raise ArgumentError, "invalid direction: #{direction}"
|
89
|
+
end
|
90
|
+
|
91
|
+
# 'return' is not a valid direction in this context
|
92
|
+
unless direction != "return"
|
93
|
+
raise "direction 'return' is only for the return value of the function."
|
94
|
+
end
|
95
|
+
end
|
96
|
+
end
|
97
|
+
|
98
|
+
end
|
99
|
+
|
100
|
+
end; end; end; end; end; end
|
@@ -0,0 +1,42 @@
|
|
1
|
+
#!/usr/bin/env ruby
|
2
|
+
|
3
|
+
$:.unshift(File.join(File.dirname(__FILE__), '..', '..', '..','..','..','..','..', 'lib'))
|
4
|
+
|
5
|
+
require 'rex/post/meterpreter/extensions/stdapi/railgun/dll_function'
|
6
|
+
require 'test/unit'
|
7
|
+
|
8
|
+
module Rex
|
9
|
+
module Post
|
10
|
+
module Meterpreter
|
11
|
+
module Extensions
|
12
|
+
module Stdapi
|
13
|
+
module Railgun
|
14
|
+
class DLLFunction::UnitTest < Test::Unit::TestCase
|
15
|
+
|
16
|
+
VALID_RETURN_TYPE = 'DWORD'
|
17
|
+
NON_RETURN_DATATYPE = 'INVALID_RETURN_TYPE'
|
18
|
+
|
19
|
+
VALID_DIRECTION = 'out'
|
20
|
+
UNKNOWN_DIRECTION = 'unknown'
|
21
|
+
|
22
|
+
VALID_DATATYPE = 'PBLOB'
|
23
|
+
UNKNOWN_DATATYPE = 'UNKNOWN_DATATYPE'
|
24
|
+
|
25
|
+
def test_initialize
|
26
|
+
# TODO: haven't gotten around to writing this yet. Feel free to
|
27
|
+
# skip("incomplete test coverage")
|
28
|
+
#
|
29
|
+
# assert_nothing_raised("valid initialization should not raise") do
|
30
|
+
# end
|
31
|
+
#
|
32
|
+
# assert_raised(ArgumentError, "check_type_exists should raise ArgumentError on unknown datatypes") do
|
33
|
+
# end
|
34
|
+
|
35
|
+
end
|
36
|
+
end
|
37
|
+
end
|
38
|
+
end
|
39
|
+
end
|
40
|
+
end
|
41
|
+
end
|
42
|
+
end
|