89 lines
2.2 KiB
Groff
89 lines
2.2 KiB
Groff
'\" 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 |