'\" t
.\"     Title: howto
.\"    Author: Relearn Roaming Communities
.\" Generator: Asciidoctor 1.5.4
.\"      Date: 2019-06-23
.\"    Manual: Relearn Roaming Server Howto
.\"    Source: Relearn Roaming Server Howto 1.0.0
.\"  Language: English
.\"
.TH "HOWTO" "1" "2019-06-23" "Relearn Roaming Server Howto 1.0.0" "Relearn Roaming Server Howto"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.LINKSTYLE blue R < >
.SH "NAME"
howto \- the short story about how we propose to relearn the shell environment.
.SH "RELEARNING THE SHELL ENVIRONMENT"
.sp
In order to provide a more friendly and expressive shell environment for the
users of this feminist server, we propose to intervene within the workings of
Bash.
.sp
Bash loads the /etc/profile fill everytime it is invoked. This provides a way
for us to intervene. Every time a user enters the server via the SSH command, a
Bash session is invoked.
.sp
We therefore create two pads:
.sp
.if n \{\
.RS 4
.\}
.nf
http://relearn.local/etherdump/publish/bash\-pre\-exec
http://relearn.local/etherdump/publish/hooks
.fi
.if n \{\
.RE
.\}
.sp
We include the "\fIPUBLISH\fP" keyword on these pads which triggers
the Etherdump program which converts the pad to multiple formats and
stores them in the /var/www/html/etherdump/publish/.
.sp
The "bash\-pre\-exec" pad allows Bash to load our interventions which are described
in the "hooks" pad. We then load these within the default /etc/profile file with:
.sp
.if n \{\
.RS 4
.\}
.nf
cp /var/www/html/etherdump/publish/hooks /opt/hooks
cp /var/www/html/etherdump/publish/bash\-pre\-exec /opt/hooks/bash\-pre\-exec
source /opt/hooks/bash\-pre\-exec
source /opt/hooks/hooks
.fi
.if n \{\
.RE
.\}
.sp
At this point, the interventions that we define within the "hooks" pad, will be
invoked in the Bash session of every user on the system. This provides a new
way to relearn the shell environment.
.SH "ETHERDUMP"
.sp
This pad is locally available at the following pad:
.sp
.if n \{\
.RS 4
.\}
.nf
http://relearn.local:9001/p/howto
.fi
.if n \{\
.RE
.\}
.sp
We use the following "Magic Word" to publish this pad with etherdump:
.SH "AUTHOR(S)"
.sp
\fBRelearn Roaming Communities\fP
.RS 4
Author(s).
.RE