docs(role): Add reminders/comments why we're installing packages

Arch-based systems will never automatically enable a systemd service
unit for the administrator. Check if 'sysstat.service' exists. Start
and enable it if so.

defaults/main.yml

@@ -1,49 +1,100 @@
 # SPDX-License-Identifier: MIT
 packages_linux_common_all_families:
+    # A download manager more capable than wget
+  - 'aria2'
+    # Shell-based math operations
   - 'bc'
+    # A nice system stats and health overview
   - 'btop'
+    # Brings mkfs.fat and related tools for the rare occasion that we absolutely
+    # have to work with a FAT-formatted partition.
   - 'dosfstools'
+    # DHCP server response debugging
   - 'dhcping'
+    # Fast host liveness scanner
   - 'fping'
+    # Version control
   - 'git'
+    # Network bandwidth and performance measurement
   - 'iperf3'
+    # Manipulate JSON
   - 'jq'
+    # All things FTP, SFTP, FTP over SSL etc.
+  - 'lftp'
+    # Log file navigator
   - 'lnav'
+    # Process inspector
   - 'lsof'
+    # In-memory file transfer buffer
   - 'mbuffer'
+    # Advanced trace routes
   - 'mtr'
+    # ncurses disk usage
   - 'ncdu'
+    # Network performance measurement
   - 'netperf'
+    # Run multiple processes in parallel, mostly when they don't do so natively
+    # to better utilize CPU resources for a performance boost
   - 'parallel'
+    # Partition editor
   - 'parted'
+    # Apply patch files
   - 'patch'
+    # Parallel gzip
   - 'pigz'
+    # Pipe viewer to visualize network throughput inbetween two shell pipes
   - 'pv'
+    # Multi-purpose file transfer
+  - 'rclone'
+    # Best-in-class data sync
   - 'rsync'
+    # Hardware stress testing
   - 'stress-ng'
+    # E-mail transfer debugging
   - 'swaks'
+    # System statistics and load monitor
+  - 'sysstat'
+    # Network traffic inspector
   - 'tcpdump'
+    # Nice interface to WireShark CLI
+  - 'termshark'
+    # Terminal multiplexer
   - 'tmux'
+    # Basic trace routes
   - 'traceroute'
+    # Print directory tree content
   - 'tree'
+    # Unzip zip files
   - 'unzip'
+    # Basic file transfer utility
   - 'wget'
 
 packages_linux_common_archlinux:
+    # We care about dig to debug DNS server responses
   - 'bind'
+    # A nicer CLI diff tool
   - 'difftastic'
+    # Better ls
   - 'eza'
+    # YAML file manipulation, diffs, merges etc.
   - 'go-yq'
+    # GPT disk editor
   - 'gptfdisk'
+    # Send crafted TCP packets for debugging purposes
   - 'openbsd-netcat'
+    # Allow a Proxmox VE hostto interact with a VM
   - 'qemu-guest-agent'
+    # Python manager
   - 'uv'
+    # WireShark CLI
+  - 'wireshark-cli'
 
 packages_linux_paru_archlinux:
   - 'downgrade'
   - 'flent'
   - 'mmv'
   - 'paccache-hook'
+  - 'tmux-resurrect'
 
 packages_linux_common_debian:
   - 'apt-file'
@@ -54,6 +105,7 @@ packages_linux_common_debian:
   - 'gdisk'
   - 'mmv'
   - 'netcat-openbsd'
+  - 'tshark'
   - 'unattended-upgrades'
   - 'xxd'
 

tasks/base-package-auxiliary-settings-single-package-single-config.yml

@@ -31,7 +31,7 @@
     path: '{{ pkg.global_config_file }}'
 
 - name: 'Remove per-package config'
-  when: 'stat_result.pkg.name not in ansible_facts.packages'
+  when: 'stat_result.pkg.name not in ansible_facts.packages and stat_result.stat.exists'
   loop_control:
     loop_var: 'stat_result'
     label: 'If ''{{ stat_result.pkg.name }}'' package is absent and system-wide config file ''{{ stat_result.pkg.global_config_file }}'' is present remove config file'

tasks/base-package-auxiliary-settings-sysstat.yml

@@ -0,0 +1,10 @@
+# SPDX-License-Identifier: MIT
+- name: 'Gather service facts'
+  ansible.builtin.service_facts:
+
+- name: 'If ''sysstat.service'' exists make sure it''s running'
+  when: '''sysstat.service'' in ansible_facts[''services'']'
+  ansible.builtin.service:
+      name: 'sysstat.service'
+      state: 'started'
+      enabled: true

tasks/base-package-auxiliary-settings-tmux.yml

@@ -10,21 +10,21 @@
     create: true
     block: '{{ tmux_global_config_resurrect }}'
 
-- name: 'If Arch Linux and ''tmux-resurrect'' package is absent never auto-load tmux-resurrect on tmux start system-wide'
+- name: 'Get stats of ''{{ tmux_global_config_file }}'''
-  when: '(ansible_facts[''os_family''] | lower == ''archlinux'') and (''tmux-resurrect'' not in ansible_facts.packages)'
+  ansible.builtin.stat:
+    path: '{{ tmux_global_config_file }}'
+  register: 'role_common_packages__tmux_global_config_file_stats'
+
+- name: 'If Arch Linux and ''tmux-resurrect'' package is absent and system-wide config file ''{{ tmux_global_config_file }}'' is present remove config block from file'
+  when: '(ansible_facts[''os_family''] | lower == ''archlinux'') and (''tmux-resurrect'' not in ansible_facts.packages) and (role_common_packages__tmux_global_config_file_stats.stat.exists)'
   ansible.builtin.blockinfile:
     marker: '# {mark} ANSIBLE MANAGED BLOCK - tmux-resurrect'
     path: '{{ tmux_global_config_file }}'
     state: 'absent'
     block: '{{ tmux_global_config_resurrect }}'
 
-- name: 'Get stats of ''{{ tmux_global_config_file }}'''
+- name: 'If ''{{ tmux_global_config_file }}'' exists and is 0 bytes delete it'
-  ansible.builtin.stat:
+  when: '(role_common_packages__tmux_global_config_file_stats.stat.exists) and (role_common_packages__tmux_global_config_file_stats.stat.size == 0)'
-    path: '{{ tmux_global_config_file }}'
-  register: 'role_common_packages__tmux_global_config_file_stats'
-
-- name: 'If ''{{ tmux_global_config_file }}'' is 0 bytes delete it'
-  when: 'role_common_packages__tmux_global_config_file_stats.stat.size == 0'
   ansible.builtin.file:
     path: '{{ tmux_global_config_file }}'
     state: 'absent'

tasks/base-package-auxiliary-settings.yml

@@ -1,3 +1,4 @@
 # SPDX-License-Identifier: MIT
+- import_tasks: 'base-package-auxiliary-settings-sysstat.yml'
 - import_tasks: 'base-package-auxiliary-settings-tmux.yml'
 - import_tasks: 'base-package-auxiliary-settings-single-package-single-config.yml'