"""Readings of the host's processes: listening sockets, log sources, running backups. The first two commands are napalm-device-types' and read-only. Root only widens what they see -- ``ss`` names every process behind a socket, ``/proc//fd`` shows every process's open files -- so both go through sudo where the driver can, and as the login user where it cannot; the mixins then say the reading is not ``attributed``. The running backups need no root: every process's command line and cgroup are readable to the login user (``_running_backups``). """ from __future__ import annotations from typing import TYPE_CHECKING from napalm_device_types import ListeningSocketsMixin, LogSourcesMixin from napalm_linux._running_backups import LinuxRunningBackupsMixin #: Seconds either reading may take; a busy host lists thousands of descriptors. _READ_TIMEOUT = 60 class LinuxProcessReadingsMixin(ListeningSocketsMixin, LogSourcesMixin, LinuxRunningBackupsMixin): """The transports for ``get_listening_sockets`` and ``get_log_sources``, and ``get_running_backups``.""" if TYPE_CHECKING: # pragma: no cover - the driver's own, declared for type checkers def _send(self, command: str, read_timeout: float = 100) -> str: ... def _run_privileged(self, command: str, timeout: float = 100) -> str: ... def _read_as_root_if_possible(self, command: str, privileged: bool) -> str: if privileged: return self._run_privileged(command, _READ_TIMEOUT) return self._send(command, read_timeout=_READ_TIMEOUT) def _run_listening_sockets_command(self, command: str, *, privileged: bool) -> str: return self._read_as_root_if_possible(command, privileged) def _run_log_sources_command(self, command: str, *, privileged: bool) -> str: return self._read_as_root_if_possible(command, privileged)