aboutsummaryrefslogtreecommitdiff
path: root/contrib/sucap/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/sucap/README.md')
-rw-r--r--contrib/sucap/README.md22
1 files changed, 11 insertions, 11 deletions
diff --git a/contrib/sucap/README.md b/contrib/sucap/README.md
index 586f017..5cc0dcc 100644
--- a/contrib/sucap/README.md
+++ b/contrib/sucap/README.md
@@ -1,21 +1,21 @@
-This directory contains a port of the SimplePAMApp su to more
-aggressively use libcap.
+# A fully capable version of `su`
-The Makefile builds a binary called `su` that registers with PAM as
-the application `sucap`. We've provided a sample `/etc/pam.d/sucap`
-file in this directory named `sucap.pamconfig`.
+This directory contains a port of the `SimplePAMApp` `su` one that can
+work in a `PURE1E` `libcap`-_mode_ environment.
-The point of developing this is to better test the full libcap
+The point of developing this is to better test the full `libcap`
implementation, and to also provide a non-setuid-root worked example
-for testing PAM interaction with libcap and pam_cap.so. The
-expectations for `pam_unix.so` are that it includes this commit:
+for testing PAM interaction with `libcap` and `pam_cap.so`. The
+required expectations for `pam_unix.so` are that it include this
+commit:
+https://github.com/linux-pam/linux-pam/pull/373/commits/bf9b1d8ad909634000a7356af2d865a79d3f86f3
-The original sources were found here:
+The original sources for this version of `su` were found here:
https://kernel.org/pub/linux/libs/pam/pre/applications/SimplePAMApps-0.60.tar.gz
-The SimplePAMApps contain the same License as libcap (they were
+The `SimplePAMApps` contain the same License as `libcap` (they were
originally started by the same authors!). The credited Authors in the
above tarball were:
@@ -32,7 +32,7 @@ tar ball and is thus a derived work from that.
Finally, Andrew would like to apologize to Andrey for removing all of
the config support he worked to add all those decades ago..! I just
wanted to make a quick tester for a potential workaround for this
-pam_cap issue:
+`pam_cap.so` issue:
- https://bugzilla.kernel.org/show_bug.cgi?id=212945