Initial commit0.1.0

2 files changed, 147 insertions, 0 deletions

diff --git a/rolectl b/rolectl
new file mode 100755
index 0000000..3351dbc
--- /dev/null
+++ b/rolectl
@@ -0,0 +1,74 @@
+#!/bin/sh
+
+STOW_DIR=/etc/portage/stow
+TARGET=/etc/portage
+
+stowcmd="stow -d "$STOW_DIR" -t "$TARGET""
+
+need_root() {
+	if test $(id -u) -ne 0; then
+		printf 'This action requires superuser access.\n'
+		exit 1
+	fi
+}
+
+add() {
+	need_root
+	$stowcmd -S "$@"
+}
+
+remove() {
+	need_root
+	$stowcmd -D "$@"
+}
+
+flush() {
+	need_root
+	list | xargs -- $stowcmd -D
+}
+
+rebuild() {
+	need_root
+	list | xargs -- $stowcmd -R
+}
+
+list() {
+	subcmd="$1"
+	shift
+	case $subcmd in
+		active) list_active;;
+		all) list_all;;
+		available) list_available;;
+		*) list_active;;
+	esac
+}
+
+list_active() {
+	# XXX: -r for xargs is a GNU extension
+	find /etc/portage/ -lname "*stow/*" -print0 2>/dev/null \
+		| xargs -r0 readlink \
+		| sed 's:.*stow/\([^/]\+\)/.*:\1:' \
+		| sort -u
+}
+
+list_all() {
+	ls -1 "$STOW_DIR"
+}
+
+list_available() {
+	tmp="$(mktemp)" || exit 1
+	list_active > "$tmp"
+	list_all | comm -13 "$tmp" - 
+	rm -f "$tmp"
+}
+
+cmd="$1"
+shift
+case $cmd in
+	add) add "$@";;
+	flush) flush;;
+	list) list "$@";;
+	rebuild) rebuild;;
+	remove) remove "$@";;
+	*) list_active;;
+esac
diff --git a/rolectl.1 b/rolectl.1
new file mode 100644
index 0000000..2efc2a5
--- /dev/null
+++ b/rolectl.1
@@ -0,0 +1,73 @@
+.Dd February 24, 2019
+.Dt ROLECTL 1
+.Os
+.Sh NAME
+.Nm rolectl
+.Nd manage portage roles with stow
+.Sh SYNOPSIS
+.Nm
+.Op Ar command
+.Sh DESCRIPTION
+.Nm
+is a program to add, remove, and list portage roles.
+.Pp
+A
+.Dq role
+is a directory comprised of a set of portage configuration files
+pertaining to a specific service, usage, et cetera.
+Roles are placed into
+.Em /etc/portage/stow .
+.Pp
+.Nm
+uses
+.Xr stow 1
+to build a full set of portage configuration files in
+.Em /etc/portage .
+It does so by creating symlinks in
+.Em /etc/portage
+that point back to the actual files in the role directories.
+.Pp
+The commands are as follows:
+.Bl -tag -width Ds
+.It Sy add Em role
+Activates the given role on the system.
+.It Sy flush
+Deactivates all actives roles on the system.
+.It Sy list [ Em type ]
+Lists roles of the given type.
+If no type is given, list roles of the
+.Dq active
+type.
+The types are as follows:
+.Bl -tag -width Ds
+.It Sy active
+Lists roles that are active on the system.
+.It Sy all
+Lists all roles.
+.It Sy available
+Lists roles that not active on the system.
+.El
+.It Sy rebuild
+Deactivates all active roles and then activates them again.
+This is used to incorporate files that have been added to an already
+active role.
+.It Sy remove Em role
+Deactivates the given role on the system.
+.El
+.Pp
+If no command is given,
+.Nm
+will list active roles.
+.Sh FILES
+.Bl -tag -width Ds
+.It Em /etc/portage/stow
+The base directory containing all portage roles.
+.El
+.Sh SEE ALSO
+.Xr stow 1 ,
+.Xr portage 5
+.Sh AUTHORS
+.An -nosplit
+.Nm
+was written by
+.An Wolfgang Müller Aq Mt vehk@vehk.de