Initial commit, including first packaged version

Changes committed:
	new file:   README.md
	new file:   rpmbuild/BUILD/sysmotd/LICENSE.txt
	new file:   rpmbuild/BUILD/sysmotd/README.txt
	new file:   rpmbuild/BUILD/sysmotd/sysmotd
	new file:   rpmbuild/BUILD/sysmotd/sysmotd.service
	new file:   rpmbuild/BUILD/sysmotd/sysmotd.timer
	new file:   rpmbuild/RPMS/noarch/sysmotd-0.0.1-1.fc37.noarch.rpm
	new file:   rpmbuild/SOURCES/sysmotd-0.0.1.tar.gz
	new file:   rpmbuild/SPECS/sysmotd.spec
	new file:   rpmbuild/SRPMS/sysmotd-0.0.1-1.fc37.src.rpm
	new file:   sysmotd/LICENSE.txt
	new file:   sysmotd/README.txt
	new file:   sysmotd/sysmotd
	new file:   sysmotd/sysmotd.preset
	new file:   sysmotd/sysmotd.service
	new file:   sysmotd/sysmotd.timer

Author: innovara

README.md

@@ -0,0 +1,85 @@
+# Summary
+
+sysmotd is essentially a shell script that produces a Message Of The Day (MOTD) which includes system information and statistics.
+
+It has been developed and tested on Fedora Linux and it might work on other Red Hat-based distributions with very small tweaks. It should also be relatively simple to port to other distributions that do not have their own dynamic MOTD generator.
+
+As of time of writting, Fedora only uses pam_motd.so for ssh log ins.
+
+# How it looks like
+
+A picture is worth a thousand words.
+
+
+
+# Background
+
+I am a long term Fedora user. Having worked with some Ubuntu servers lately, I found myself missing the system information and statistics that you get when you log in. When I installed Fedora 37 on a Raspberry Pi4, I saw that cockpit would generate a MOTD, and I decided to research a bit to find out if I could add my own with some system statistics on it.
+
+Out of the various sources I found, I would like to give credit to a couple that helped me a lot in getting the information that I wanted and what tools to use.
+
+[1] https://github.com/angela-d/motd-for-centos
+
+[2] https://gist.github.com/cha55son/6042560
+
+While these sources gave me a good start, I wanted to reduce the number of dependencies to a minimum and make the dynamic part of the MOTD as efficient as possible, so I soon re-wrote most of the stuff and started looking into how to avoid using the user's profile to trigger the script. That leads us to the next section.
+
+# Structure and how it works
+
+My understanding is that Debian and Ubuntu distribute a patched version of pam_motd.so. Theirs runs scripts in /etc/update-motd.d. Also, their PAM configuration includes lines for static and dyanamic MOTDs.
+
+[3] https://wiki.debian.org/motd
+
+Using a patched version of pam_motd.so would have been the preferred approach, since the script updating the dynamic part of the MOTD only runs when a user logs in. However, I didn't know how difficult it would be to get a change like that approved for Fedora. My assumption was, and still is, that the people behind Fedora or Red Hat know that Debian and Ubuntu are using this dynamic MOTD approach and if they have not implemented it yet, it is because they have some valid reasons.
+
+In that context, I resorted to use a systemd service to call the script and a timer to call the service, every minute. However, not all the parts of the script that generate the corresponding part of the MOTD run every minute.
+
+So, sysmotd is comprised of: 
+
+### `/usr/libexec/sysmotd`
+
+The shell script. It produces 3 files which are saved under `/run/motd.d`
+
+- 00-sysmotd-header.motd: colorful header that changes every 60 minutes.
+- 01-sysmotd-sysinfo.motd: system information which is updated every 60 seconds.
+- 02-sysmotd-updates.motd: updates available which is updated every 60 minutes. It uses Fedora's own dnf cache which runs whenever it runs. 
+
+### `/usr/lib/systemd/system/sysmotd.service`
+
+A systemd service to run the script. It is disabled and it should stay like that.
+
+### `/usr/lib/systemd/system/sysmotd.timer`
+
+A systemd timer to run the service every 60 seconds. The script works out which parts of the MOTD to update.
+It is enabled and started when the dnf package is installed.
+
+### `/usr/lib/systemd/system-preset/50-sysmotd.preset`
+
+A systemd preset file to disable sysmotd.service and enable sysmotd.timer by default.
+
+In summary, what you get when you install sysmotd is a systemd timer that every 60 seconds runs a service, that runs a script, which in turn updates the header every 60 minutes, system's information every 60 seconds, and the updates available every 60 minutes too.
+
+# How to install sysmotd and dependencies
+
+These are the Fedora packages that you need to have installed for sysmotd to work:
+
+```bash
+coreutils
+dnf
+figlet
+findutils
+gawk
+lolcat
+procps-ng
+systemd
+```
+
+Most systems will have all of them installed apart from `figlet` and `lolcat`.
+
+To install sysmotd and its dependencies, my recommendation is to download the rpm package under `rpmbuild/RPMS/noarch` in this repo, and install it with dnf.
+
+```
+sudo dnf install sysmotd-0.0.1-1.fc37.noarch.rpm
+```
+
+If you rather not install a package from an unknown source, and I wouldn't blame you for that, you can clone this repo and, after inspecting the files listed under the structure section, copy them to their respective folders. Please note that if you do this, and you are running selinux enforced, you will have to fix the context of the files.

rpmbuild/BUILD/sysmotd/LICENSE.txt

@@ -0,0 +1,101 @@
+#!/usr/bin/sh
+#   
+#   sysmotd - generates a MOTD (Message Of The Day) including system 
+#   information on Fedora Linux, and possibly other Red Hat-based distributions.
+#   
+#   Copyright (C) 2022  Manuel Fombuena <mfombuena@innovara.co.uk>
+#   
+#   This program is free software: you can redistribute it and/or modify
+#   it under the terms of the GNU General Public License as published by
+#   the Free Software Foundation, either version 3 of the License, or
+#   (at your option) any later version.
+#   
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU General Public License for more details.
+#   
+#   You should have received a copy of the GNU General Public License
+#   along with this program.  If not, see <https://www.gnu.org/licenses/>.
+#   
+
+# directory where the motd files will live
+rundir="/run/motd.d"
+header="$rundir/00-header.motd"
+sysinfo="$rundir/01-sysinfo.motd"
+updates="$rundir/02-updates.motd"
+
+# some variables
+. /etc/os-release
+
+# hostname
+hostname=$(uname -n)
+
+# uptime
+uptime=$(awk '{print int($1)}' /proc/uptime)
+upDays=$((uptime/60/60/24))
+upHours=$((uptime/60/60%24))
+upMins=$((uptime/60%60))
+upSecs=$((uptime%60))
+
+# avg load
+load1=$(awk '{print $1}' /proc/loadavg)
+load5=$(awk '{print $2}' /proc/loadavg)
+load15=$(awk '{print $3}' /proc/loadavg)
+
+# memory
+mem_total=$(awk '/MemTotal/ {print $2;}' /proc/meminfo)
+mem_used=$(($mem_total-$(awk '/MemFree/ {print $2;}' /proc/meminfo)-$(awk '/Buffers/ {print $2;}' /proc/meminfo)-$(awk '/\yCached\y/ {print $2;}' /proc/meminfo)))
+mem_perc=$(($mem_used*100/$mem_total))
+swap_total=$(awk '/SwapTotal/ {print $2;}' /proc/meminfo)
+swap_used=$((${swap_total} - $(awk '/SwapFree/ {print $2;}' /proc/meminfo)-$(awk '/SwapCached/ {print $2;}' /proc/meminfo)))
+swap_perc=$((swap_used*100/swap_total))
+
+# filesystem info
+root_used=$(df -h --output=used / | awk '{if (NR!=1) print $1}')
+root_total=$(df -h --output=size / | awk '{if (NR!=1) print $1}')
+root_perc=$(df -h --output=pcent / | awk '{if (NR!=1) print $1}')
+
+# users
+users=$(users | wc -w)
+
+# processes
+processes=$(ps aux --no-headers | wc -l)
+
+### MOTD ###
+
+# colourful header. Updated every 60 minutes only but no real performance gain
+NEED_UPDATE="FALSE"
+[ -z "$(find "$header" -newermt 'now-60 minutes' 2> /dev/null)" ] && NEED_UPDATE="TRUE"
+
+if [[ "$NEED_UPDATE" = "TRUE" ]]; then
+    echo "$(figlet ${REDHAT_SUPPORT_PRODUCT} ${REDHAT_SUPPORT_PRODUCT_VERSION} -c | lolcat -r -f)" > $header
+fi
+
+# sysinfo update
+echo -e "Welcome to ${PRETTY_NAME} ($(uname -o) $(uname -r))
+
+System information as of $(date)
+
+Hostname:\t${hostname}\t\tMemory usage:\t$((${mem_used}/1024))/$((${mem_total}/1024))M (${mem_perc}%)
+Uptime:\t\t${upDays}d ${upHours}h ${upMins}m ${upSecs}s\t\t\tSwap usage:\t$((${swap_used}/1024))/$((${swap_total}/1024))M (${swap_perc}%)
+Load 1-5-15min:\t${load1}-${load5}-${load15}\t\t\tUsage of /:\t${root_used}/${root_total} (${root_perc})
+Processes:\t${processes}\t\t\t\tUsers:\t\t${users}
+" > $sysinfo
+
+# updates available updated every 60 minutes using CACHE.
+# dnf's cache is updated by the system using its own service and timer. The conservative 
+# approach is to not to change this.
+NEED_UPDATE="FALSE"
+[ -z "$(find "$updates" -newermt 'now-60 minutes' 2> /dev/null)" ] && NEED_UPDATE="TRUE"
+
+if [[ "$NEED_UPDATE" = "TRUE" ]]; then
+       n_updates=$(dnf update --assumeno --cacheonly --noplugins | awk '/^Upgrade/ {print $2;}')
+    if [[ $n_updates -eq 0 ]]; then
+       echo -e "There were no updates available when last checked.\n" > $updates
+    elif [[ $n_updates -eq 1 ]]; then
+       echo -e "There was 1 update available when last checked.\n" > $updates
+    else
+       echo -e "There were ${n_updates} updates available when last checked.\n" > $updates
+    fi
+fi

rpmbuild/BUILD/sysmotd/README.txt

@@ -0,0 +1,9 @@
+[Unit]
+Description=sysmotd service to update MOTD
+
+[Service]
+Type=oneshot
+User=root
+Group=root
+RemainAfterExit=no
+ExecStart=/usr/libexec/sysmotd

rpmbuild/BUILD/sysmotd/sysmotd

@@ -0,0 +1,11 @@
+[Unit]
+Description=Timer for sysmotd service
+Requires=sysmotd.service
+
+[Timer]
+Unit=sysmotd.service
+OnBootSec=15s
+OnUnitActiveSec=1m  
+
+[Install]
+WantedBy=timers.target

rpmbuild/BUILD/sysmotd/sysmotd.service

@@ -0,0 +1,71 @@
+Name:           sysmotd
+Version:        0.0.1
+Release:        1%{?dist}
+Summary:        Generates a MOTD (Message Of The Day) including system information on Fedora Linux
+BuildArch:      noarch
+
+License:        GPLv3+
+URL:            https://github.com/innovara/sysmotd
+Source0:        %{name}-%{version}.tar.gz
+
+Requires:       bash
+Requires:       coreutils
+Requires:       dnf
+Requires:       figlet
+Requires:       findutils
+Requires:       gawk
+Requires:       lolcat
+Requires:       procps-ng
+Requires:       systemd
+
+%description
+
+Sysmotd produces a MOTD that includes system information being collected
+on a regular basis. Users will see the MOTD when logging in via ssh.
+
+%prep
+%autosetup
+
+
+%build
+
+
+%install
+
+mkdir -p %{buildroot}/%{_libexecdir}
+%{__install} -Dm744 %{name} %{buildroot}/%{_libexecdir}/%{name}
+
+mkdir -p %{buildroot}/%{_unitdir}
+%{__install} -Dm644 %{name}.service %{buildroot}/%{_unitdir}/%{name}.service
+%{__install} -Dm644 %{name}.timer %{buildroot}/%{_unitdir}/%{name}.timer
+
+
+%{__install} -Dm644 %{name}.preset %{buildroot}/%{_presetdir}/50-%{name}.preset
+
+%files
+%license LICENSE.txt
+%doc README.txt
+%{_libexecdir}/%{name}
+%{_unitdir}/%{name}.service
+%{_unitdir}/%{name}.timer
+%{_presetdir}/50-%{name}.preset
+
+
+%post
+
+%systemd_post %{name}.timer
+systemctl start %{name}.timer > /dev/null 2>&1
+
+%preun
+
+%systemd_preun %{name}.timer
+%systemd_preun %{name}.service
+
+%postun
+
+rm -f /run/motd.d/*%{name}*
+
+
+%changelog
+* Mon Dec 26 2022 Manuel Fombuena <mfombuena@innovara.co.uk>
+- First version being packaged