summaryrefslogtreecommitdiff
path: root/python
diff options
context:
space:
mode:
Diffstat (limited to 'python')
-rw-r--r--python/vyos/utils/auth.py4
-rw-r--r--python/vyos/utils/disk.py51
-rw-r--r--python/vyos/utils/kernel.py77
3 files changed, 130 insertions, 2 deletions
diff --git a/python/vyos/utils/auth.py b/python/vyos/utils/auth.py
index d014f756f..a0b3e1cae 100644
--- a/python/vyos/utils/auth.py
+++ b/python/vyos/utils/auth.py
@@ -42,6 +42,10 @@ def split_ssh_public_key(key_string, defaultname=""):
def get_current_user() -> str:
import os
current_user = 'nobody'
+ # During CLI "owner" script execution we use SUDO_USER
if 'SUDO_USER' in os.environ:
current_user = os.environ['SUDO_USER']
+ # During op-mode or config-mode interactive CLI we use USER
+ elif 'USER' in os.environ:
+ current_user = os.environ['USER']
return current_user
diff --git a/python/vyos/utils/disk.py b/python/vyos/utils/disk.py
index ee540b107..d4271ebe1 100644
--- a/python/vyos/utils/disk.py
+++ b/python/vyos/utils/disk.py
@@ -1,4 +1,4 @@
-# Copyright 2023 VyOS maintainers and contributors <maintainers@vyos.io>
+# Copyright 2023-2024 VyOS maintainers and contributors <maintainers@vyos.io>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
@@ -21,3 +21,52 @@ def device_from_id(id):
for device in path.iterdir():
if device.name.endswith(id):
return device.readlink().stem
+
+def get_storage_stats(directory, human_units=True):
+ """ Return basic storage stats for given directory """
+ from re import sub as re_sub
+ from vyos.utils.process import cmd
+ from vyos.utils.convert import human_to_bytes
+
+ # XXX: using `df -h` and converting human units to bytes
+ # may seem pointless, but there's a reason.
+ # df uses different header field names with `-h` and without it ("Size" vs "1K-blocks")
+ # and outputs values in 1K blocks without `-h`,
+ # so some amount of conversion is needed anyway.
+ # Using `df -h` by default seems simpler.
+ #
+ # This is what the output looks like, as of Debian Buster/Bullseye:
+ # $ df -h -t ext4 --output=source,size,used,avail,pcent
+ # Filesystem Size Used Avail Use%
+ # /dev/sda1 16G 7.6G 7.3G 51%
+
+ out = cmd(f"df -h --output=source,size,used,avail,pcent {directory}")
+ lines = out.splitlines()
+ lists = [l.split() for l in lines]
+ res = {lists[0][i]: lists[1][i] for i in range(len(lists[0]))}
+
+ convert = (lambda x: x) if human_units else human_to_bytes
+
+ stats = {}
+
+ stats["filesystem"] = res["Filesystem"]
+ stats["size"] = convert(res["Size"])
+ stats["used"] = convert(res["Used"])
+ stats["avail"] = convert(res["Avail"])
+ stats["use_percentage"] = re_sub(r'%', '', res["Use%"])
+
+ return stats
+
+def get_persistent_storage_stats(human_units=True):
+ from os.path import exists as path_exists
+
+ persistence_dir = "/usr/lib/live/mount/persistence"
+ if path_exists(persistence_dir):
+ stats = get_storage_stats(persistence_dir, human_units=human_units)
+ else:
+ # If the persistence path doesn't exist,
+ # the system is running from a live CD
+ # and the concept of persistence storage stats is not applicable
+ stats = None
+
+ return stats
diff --git a/python/vyos/utils/kernel.py b/python/vyos/utils/kernel.py
index 1f3bbdffe..847f80108 100644
--- a/python/vyos/utils/kernel.py
+++ b/python/vyos/utils/kernel.py
@@ -1,4 +1,4 @@
-# Copyright 2023 VyOS maintainers and contributors <maintainers@vyos.io>
+# Copyright 2023-2024 VyOS maintainers and contributors <maintainers@vyos.io>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
@@ -36,3 +36,78 @@ def unload_kmod(k_mod):
if os.path.exists(f'/sys/module/{module}'):
if call(f'rmmod {module}') != 0:
raise ConfigError(f'Unloading Kernel module {module} failed')
+
+def list_loaded_modules():
+ """ Returns the list of currently loaded kernel modules """
+ from os import listdir
+ return listdir('/sys/module/')
+
+def get_module_data(module: str):
+ """ Retrieves information about a module """
+ from os import listdir
+ from os.path import isfile, dirname, basename, join
+ from vyos.utils.file import read_file
+
+ def _get_file(path):
+ # Some files inside some modules are not readable at all,
+ # we just skip them.
+ try:
+ return read_file(path)
+ except PermissionError:
+ return None
+
+ mod_path = join('/sys/module', module)
+ mod_data = {"name": module, "fields": {}, "parameters": {}}
+
+ for f in listdir(mod_path):
+ if f in ["sections", "notes", "uevent"]:
+ # The uevent file is not readable
+ # and module build info and memory layout
+ # in notes and sections generally aren't useful
+ # for anything but kernel debugging.
+ pass
+ elif f == "drivers":
+ # Drivers are dir symlinks,
+ # we just list them
+ drivers = listdir(join(mod_path, f))
+ if drivers:
+ mod_data["drivers"] = drivers
+ elif f == "holders":
+ # Holders (module that use this one)
+ # are always symlink to other modules.
+ # We only need the list.
+ holders = listdir(join(mod_path, f))
+ if holders:
+ mod_data["holders"] = holders
+ elif f == "parameters":
+ # Many modules keep their configuration
+ # in the "parameters" subdir.
+ ppath = join(mod_path, "parameters")
+ ps = listdir(ppath)
+ for p in ps:
+ data = _get_file(join(ppath, p))
+ if data:
+ mod_data["parameters"][p] = data
+ else:
+ # Everything else...
+ # There are standard fields like refcount and initstate,
+ # but many modules also keep custom information or settings
+ # in top-level fields.
+ # For now we don't separate well-known and custom fields.
+ if isfile(join(mod_path, f)):
+ data = _get_file(join(mod_path, f))
+ if data:
+ mod_data["fields"][f] = data
+ else:
+ raise RuntimeError(f"Unexpected directory inside module {module}: {f}")
+
+ return mod_data
+
+def lsmod():
+ """ Returns information about all loaded modules.
+ Like lsmod(8), but more detailed.
+ """
+ mods_data = []
+ for m in list_loaded_modules():
+ mods_data.append(get_module_data(m))
+ return mods_data