Class: Msf::Sessions::MainframeShell
- Inherits:
-
CommandShell
- Object
- CommandShell
- Msf::Sessions::MainframeShell
- Defined in:
- lib/msf/base/sessions/mainframe_shell.rb
Overview
This class provides basic interaction with a Unix Systems Service command shell on a mainframe (IBM System Z) running Z/OS This session is initialized with a stream that will be used as the pipe for reading and writing the command shell.
Date: Oct 8, 2015
Author: Bigendian Smalls
Instance Attribute Summary collapse
-
#translate_1047 ⇒ Object
Returns the value of attribute translate_1047.
Attributes included from Msf::Session::Interactive
Attributes included from Rex::Ui::Interactive
#completed, #interacting, #next_session, #on_command_proc, #on_print_proc, #on_run_command_error_proc, #orig_suspend, #orig_usr1, #orig_winch
Attributes included from Rex::Ui::Subscriber::Input
Attributes included from Rex::Ui::Subscriber::Output
Attributes included from Msf::Session
#alive, #db_record, #exploit, #exploit_datastore, #exploit_task, #exploit_uuid, #framework, #info, #machine_id, #payload_uuid, #routes, #sid, #sname, #target_host, #target_port, #username, #uuid, #via, #workspace
Attributes included from Framework::Offspring
Attributes inherited from CommandShell
#arch, #banner, #max_threads, #platform
Class Method Summary collapse
Instance Method Summary collapse
-
#desc ⇒ Object
Returns the session description.
- #execute_file(full_path, args) ⇒ Object
-
#initialize(*args) ⇒ MainframeShell
constructor
initialize as mf shell session.
-
#shell_read(length = -1,, timeout = 1) ⇒ Object
override shell_read to include decode of cp1047.
-
#shell_write(buf) ⇒ Object
override shell_write to include encode of cp1047.
Methods included from Msf::Session::Provider::SingleCommandShell
#command_termination, #set_is_echo_shell, #shell_close, #shell_command_token, #shell_command_token_base, #shell_command_token_unix, #shell_command_token_win32, #shell_init, #shell_read_until_token, #to_cmd
Methods included from Msf::Session::Basic
Methods included from Msf::Session::Interactive
#_interact, #_interact_complete, #_interrupt, #_suspend, #_usr1, #abort_foreground, #abort_foreground_supported, #cleanup, #comm_channel, #interactive?, #kill, #run_cmd, #tunnel_local, #tunnel_peer, #user_want_abort?
Methods included from Rex::Ui::Interactive
#_interact, #_interact_complete, #_interrupt, #_local_fd, #_remote_fd, #_stream_read_local_write_remote, #_stream_read_remote_write_local, #_suspend, #_winch, #detach, #handle_suspend, #handle_usr1, #handle_winch, #interact, #interact_stream, #prompt, #prompt_yesno, #restore_suspend, #restore_usr1, #restore_winch
Methods included from Rex::Ui::Subscriber
Methods included from Rex::Ui::Subscriber::Input
Methods included from Rex::Ui::Subscriber::Output
#flush, #print, #print_blank_line, #print_error, #print_good, #print_line, #print_status, #print_warning
Methods included from Msf::Session
#alive?, #cleanup, #comm_channel, #dead?, #inspect, #interactive?, #kill, #log_file_name, #log_source, #name, #name=, #register?, #session_host, #session_host=, #session_port, #session_port=, #session_type, #set_from_exploit, #set_via, #tunnel_local, #tunnel_peer, #tunnel_to_s, type, #type, #via_exploit, #via_payload
Methods inherited from CommandShell
#_file_transfer, #_interact, #_interact_stream, #abort_foreground_supported, binary_exists, #binary_exists, #bootstrap, #cleanup, #cmd_background, #cmd_background_help, #cmd_download, #cmd_download_help, #cmd_help, #cmd_help_help, #cmd_irb, #cmd_irb_help, #cmd_pry, #cmd_pry_help, #cmd_resource, #cmd_resource_help, #cmd_sessions, #cmd_sessions_help, #cmd_shell, #cmd_shell_help, #cmd_source, #cmd_source_help, #cmd_upload, #cmd_upload_help, #commands, #docs_dir, #process_autoruns, #run_builtin_cmd, #run_single, #shell_close, #shell_command, #shell_init, type, #type
Methods included from Rex::Ui::Text::Resource
Methods included from Scriptable
#execute_script, included, #legacy_script_to_post_module
Constructor Details
#initialize(*args) ⇒ MainframeShell
initialize as mf shell session
33 34 35 36 37 38 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 33 def initialize(*args) self.platform = 'mainframe' self.arch = ARCH_ZARCH self.translate_1047 = true super end |
Instance Attribute Details
#translate_1047 ⇒ Object
Returns the value of attribute translate_1047.
98 99 100 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 98 def translate_1047 @translate_1047 end |
Class Method Details
.can_cleanup_files ⇒ Object
85 86 87 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 85 def self.can_cleanup_files false end |
Instance Method Details
#desc ⇒ Object
Returns the session description.
44 45 46 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 44 def desc "Mainframe shell" end |
#execute_file(full_path, args) ⇒ Object
80 81 82 83 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 80 def execute_file(full_path, args) #mfimpl raise NotImplementedError end |
#shell_read(length = -1,, timeout = 1) ⇒ Object
override shell_read to include decode of cp1047
52 53 54 55 56 57 58 59 60 61 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 52 def shell_read(length=-1, timeout=1) begin rv = Rex::Text.from_ibm1047(rstream.get_once(length, timeout)) framework.events.on_session_output(self, rv) if rv return rv rescue ::Rex::SocketError, ::EOFError, ::IOError, ::Errno::EPIPE => e shell_close raise e end end |
#shell_write(buf) ⇒ Object
override shell_write to include encode of cp1047
67 68 69 70 71 72 73 74 75 76 77 78 |
# File 'lib/msf/base/sessions/mainframe_shell.rb', line 67 def shell_write(buf) #mfimpl return unless buf begin framework.events.on_session_command(self, buf.strip) rstream.write(Rex::Text.to_ibm1047(buf)) rescue ::Rex::SocketError, ::EOFError, ::IOError, ::Errno::EPIPE => e shell_close raise e end end |