diff options
Diffstat (limited to '')
| -rwxr-xr-x | rolectl | 74 | ||||
| -rw-r--r-- | rolectl.1 | 73 |
2 files changed, 147 insertions, 0 deletions
@@ -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 |