Module: Msf::Post::Linux::Kernel

Includes:
Common, File
Defined in:
lib/msf/core/post/linux/kernel.rb

Instance Method Summary collapse

Methods included from File

#_append_file_powershell, #_append_file_unix_shell, #_can_echo?, #_read_file_meterpreter, #_read_file_powershell, #_read_file_powershell_fragment, #_shell_command_with_success_code, #_shell_process_with_success_code, #_unix_max_line_length, #_win_ansi_append_file, #_win_ansi_write_file, #_win_bin_append_file, #_win_bin_write_file, #_write_file_meterpreter, #_write_file_powershell, #_write_file_powershell_fragment, #_write_file_unix_shell, #append_file, #attributes, #cd, #chmod, #copy_file, #dir, #directory?, #executable?, #exist?, #expand_path, #exploit_data, #exploit_source, #file?, #file_local_write, #file_remote_digestmd5, #file_remote_digestsha1, #file_remote_digestsha2, #immutable?, #initialize, #mkdir, #pwd, #read_file, #readable?, #rename_file, #rm_f, #rm_rf, #setuid?, #stat, #upload_and_chmodx, #upload_file, #writable?, #write_file

Methods included from Common

#clear_screen, #cmd_exec, #cmd_exec_get_pid, #cmd_exec_with_result, #command_exists?, #create_process, #get_env, #get_envs, #initialize, #peer, #report_virtualization, #rhost, #rport

Instance Method Details

#aslr_enabled? ⇒ Boolean

Returns true if Address Space Layout Randomization (ASLR) is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



198
199
200
201
202
203
 
# File 'lib/msf/core/post/linux/kernel.rb', line 198

def aslr_enabled?
  aslr = read_file('/proc/sys/kernel/randomize_va_space').to_s.strip
  aslr.eql?('1') || aslr.eql?('2')
rescue StandardError
  raise 'Could not determine ASLR status'
end

#cpu_flags ⇒ Array

Returns a list of CPU flags

Returns:

  • (Array)

Raises:

  • (RuntimeError) —

    If execution fails.



119
120
121
122
123
124
125
126
127
 
# File 'lib/msf/core/post/linux/kernel.rb', line 119

def cpu_flags
  cpuinfo = read_file('/proc/cpuinfo').to_s

  return unless cpuinfo.include? 'flags'

  cpuinfo.scan(/^flags\s*:(.*)$/).flatten.join(' ').split(/\s/).map(&:strip).reject(&:empty?).uniq
rescue StandardError
  raise 'Could not retrieve CPU flags'
end

#dmesg_restrict? ⇒ Boolean

Returns true if dmesg restriction is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



249
250
251
252
253
 
# File 'lib/msf/core/post/linux/kernel.rb', line 249

def dmesg_restrict?
  read_file('/proc/sys/kernel/dmesg_restrict').to_s.strip.eql? '1'
rescue StandardError
  raise 'Could not determine kernel.dmesg_restrict status'
end

#exec_shield_enabled? ⇒ Boolean

Returns true if Exec-Shield is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



211
212
213
214
215
216
 
# File 'lib/msf/core/post/linux/kernel.rb', line 211

def exec_shield_enabled?
  exec_shield = read_file('/proc/sys/kernel/exec-shield').to_s.strip
  exec_shield.eql?('1') || exec_shield.eql?('2')
rescue StandardError
  raise 'Could not determine exec-shield status'
end

#grsec_installed? ⇒ Boolean

Returns true if grsecurity is installed

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



288
289
290
291
292
 
# File 'lib/msf/core/post/linux/kernel.rb', line 288

def grsec_installed?
  cmd_exec('test -c /dev/grsec && echo true').to_s.strip.include? 'true'
rescue StandardError
  raise 'Could not determine grsecurity status'
end

#kaiser_enabled? ⇒ Boolean

Returns true if Kernel Address Isolation (KAISER) is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



159
160
161
162
163
 
# File 'lib/msf/core/post/linux/kernel.rb', line 159

def kaiser_enabled?
  cpu_flags.include? 'kaiser'
rescue StandardError
  raise 'Could not determine KAISER status'
end

#kernel_arch ⇒ String

Returns the kernel hardware architecture Based on values from en.wikipedia.org/wiki/Uname

Returns:

  • (String) 


65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/msf/core/post/linux/kernel.rb', line 65

def kernel_arch
  arch = kernel_hardware
  return ARCH_X64 if arch == 'x86_64' || arch == 'amd64'
  return ARCH_AARCH64 if arch == 'aarch64' || arch == 'arm64'
  return ARCH_ARMLE if arch.start_with? 'arm'
  return ARCH_X86 if arch.end_with? '86'
  return ARCH_PPC if arch == 'ppc'
  return ARCH_PPC64 if arch == 'ppc64'
  return ARCH_PPC64LE if arch == 'ppc64le'
  return ARCH_MIPS if arch == 'mips'
  return ARCH_MIPS64 if arch == 'mips64'
  return ARCH_SPARC if arch == 'sparc'
  return ARCH_RISCV32LE if arch == 'riscv32'
  return ARCH_RISCV64LE if arch == 'riscv64'
  return ARCH_LOONGARCH64 if arch == 'loongarch64'

  arch
end

#kernel_config ⇒ Array

Returns the kernel boot config with comments removed

Returns:

  • (Array)

Raises:

  • (RuntimeError) —

    If execution fails.



90
91
92
93
94
95
96
97
98
99
 
# File 'lib/msf/core/post/linux/kernel.rb', line 90

def kernel_config
  release = kernel_release
  output = read_file("/boot/config-#{release}").to_s.strip
  return if output.empty?

  config = output.split("\n").map(&:strip).reject(&:empty?).reject { |i| i.start_with? '#' }
  config
rescue StandardError
  raise 'Could not retrieve kernel config'
end

#kernel_hardware ⇒ String

Returns the kernel hardware

Returns:

  • (String) 


55
56
57
 
# File 'lib/msf/core/post/linux/kernel.rb', line 55

def kernel_hardware
  uname('-m')
end

#kernel_modules ⇒ Array

Returns the kernel modules

Returns:

  • (Array)

Raises:

  • (RuntimeError) —

    If execution fails.



107
108
109
110
111
 
# File 'lib/msf/core/post/linux/kernel.rb', line 107

def kernel_modules
  read_file('/proc/modules').to_s.scan(/^[^ ]+/)
rescue StandardError
  raise 'Could not determine kernel modules'
end

#kernel_name ⇒ String

Returns the kernel name

Returns:

  • (String) 


46
47
48
 
# File 'lib/msf/core/post/linux/kernel.rb', line 46

def kernel_name
  uname('-s')
end

#kernel_release ⇒ String

Returns the kernel release

Returns:

  • (String) 


28
29
30
 
# File 'lib/msf/core/post/linux/kernel.rb', line 28

def kernel_release
  uname('-r')
end

#kernel_version ⇒ String

Returns the kernel version

Returns:

  • (String) 


37
38
39
 
# File 'lib/msf/core/post/linux/kernel.rb', line 37

def kernel_version
  uname('-v')
end

#kpti_enabled? ⇒ Boolean

Returns true if Kernel Page-Table Isolation (KPTI) is enabled, false if not.

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



171
172
173
174
175
 
# File 'lib/msf/core/post/linux/kernel.rb', line 171

def kpti_enabled?
  cpu_flags.include? 'pti'
rescue StandardError
  raise 'Could not determine KPTI status'
end

#kptr_restrict? ⇒ Boolean

Returns true if kernel pointer restriction is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



237
238
239
240
241
 
# File 'lib/msf/core/post/linux/kernel.rb', line 237

def kptr_restrict?
  read_file('/proc/sys/kernel/kptr_restrict').to_s.strip.eql? '1'
rescue StandardError
  raise 'Could not determine kernel.kptr_restrict status'
end

#lkrg_installed? ⇒ Boolean

Returns true if Linux Kernel Runtime Guard (LKRG) kernel module is installed

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



276
277
278
279
280
 
# File 'lib/msf/core/post/linux/kernel.rb', line 276

def lkrg_installed?
  directory?('/proc/sys/lkrg')
rescue StandardError
  raise 'Could not determine LKRG status'
end

#mmap_min_addr ⇒ Integer

Returns mmap minimum address

Returns:

  • (Integer)

Raises:

  • (RuntimeError) —

    If execution fails.



261
262
263
264
265
266
267
268
 
# File 'lib/msf/core/post/linux/kernel.rb', line 261

def mmap_min_addr
  mmap_min_addr = read_file('/proc/sys/vm/mmap_min_addr').to_s.strip
  return 0 unless mmap_min_addr =~ /\A\d+\z/

  mmap_min_addr
rescue StandardError
  raise 'Could not determine system mmap_min_addr'
end

#pax_installed? ⇒ Boolean

Returns true if PaX is installed

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



300
301
302
303
304
 
# File 'lib/msf/core/post/linux/kernel.rb', line 300

def pax_installed?
  read_file('/proc/self/status').to_s.include? 'PaX:'
rescue StandardError
  raise 'Could not determine PaX status'
end

#selinux_enforcing? ⇒ Boolean

Returns true if SELinux is in enforcing mode

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



324
325
326
327
328
329
330
331
332
333
334
335
 
# File 'lib/msf/core/post/linux/kernel.rb', line 324

def selinux_enforcing?
  return false unless selinux_installed?

  sestatus = cmd_exec('/usr/sbin/sestatus').to_s.strip
  raise unless sestatus.include?('SELinux')

  return true if sestatus =~ /Current mode:\s*enforcing/

  false
rescue StandardError
  raise 'Could not determine SELinux status'
end

#selinux_installed? ⇒ Boolean

Returns true if SELinux is installed

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



312
313
314
315
316
 
# File 'lib/msf/core/post/linux/kernel.rb', line 312

def selinux_installed?
  cmd_exec('id').to_s.include? 'context='
rescue StandardError
  raise 'Could not determine SELinux status'
end

#smap_enabled? ⇒ Boolean

Returns true if kernel and hardware supports Supervisor Mode Access Prevention (SMAP), false if not.

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



135
136
137
138
139
 
# File 'lib/msf/core/post/linux/kernel.rb', line 135

def smap_enabled?
  cpu_flags.include? 'smap'
rescue StandardError
  raise 'Could not determine SMAP status'
end

#smep_enabled? ⇒ Boolean

Returns true if kernel and hardware supports Supervisor Mode Execution Protection (SMEP), false if not.

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



147
148
149
150
151
 
# File 'lib/msf/core/post/linux/kernel.rb', line 147

def smep_enabled?
  cpu_flags.include? 'smep'
rescue StandardError
  raise 'Could not determine SMEP status'
end

#uname(opts = '-a') ⇒ String

Returns uname output

Parameters:

  • opt (String) —

    uname options, defaults to -a

Returns:

  • (String)

Raises:

  • (RuntimeError) —

    If execution fails.



17
18
19
20
21
 
# File 'lib/msf/core/post/linux/kernel.rb', line 17

def uname(opts = '-a')
  cmd_exec("uname #{opts}").to_s.strip
rescue StandardError
  raise "Failed to run uname #{opts}"
end

#unprivileged_bpf_disabled? ⇒ Boolean

Returns true if unprivileged bpf is disabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



224
225
226
227
228
229
 
# File 'lib/msf/core/post/linux/kernel.rb', line 224

def unprivileged_bpf_disabled?
  unprivileged_bpf_disabled = read_file('/proc/sys/kernel/unprivileged_bpf_disabled').to_s.strip
  return unprivileged_bpf_disabled == '1' || unprivileged_bpf_disabled == '2'
rescue StandardError
  raise 'Could not determine kernel.unprivileged_bpf_disabled status'
end

#userns_enabled? ⇒ Boolean

Returns true if user namespaces are enabled, false if not.

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



183
184
185
186
187
188
189
190
 
# File 'lib/msf/core/post/linux/kernel.rb', line 183

def userns_enabled?
  return false if read_file('/proc/sys/user/max_user_namespaces').to_s.strip.eql? '0'
  return false if read_file('/proc/sys/kernel/unprivileged_userns_clone').to_s.strip.eql? '0'

  true
rescue StandardError
  raise 'Could not determine userns status'
end

#yama_enabled? ⇒ Boolean

Returns true if Yama is enabled

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



358
359
360
361
362
363
364
 
# File 'lib/msf/core/post/linux/kernel.rb', line 358

def yama_enabled?
  return false unless yama_installed?

  !read_file('/proc/sys/kernel/yama/ptrace_scope').to_s.strip.eql? '0'
rescue StandardError
  raise 'Could not determine Yama status'
end

#yama_installed? ⇒ Boolean

Returns true if Yama is installed

Returns:

  • (Boolean)

Raises:

  • (RuntimeError) —

    If execution fails.



343
344
345
346
347
348
349
350
 
# File 'lib/msf/core/post/linux/kernel.rb', line 343

def yama_installed?
  ptrace_scope = read_file('/proc/sys/kernel/yama/ptrace_scope').to_s.strip
  return true if ptrace_scope =~ /\A\d\z/

  false
rescue StandardError
  raise 'Could not determine Yama status'
end