Debian Codegraph @

contrib/sucap/README.md

raw
1 # A fully capable version of `su`
2
3 This directory contains a port of the `SimplePAMApp` `su` one that can
4 work in a `PURE1E` `libcap`-_mode_ environment.
5
6 The point of developing this is to better test the full `libcap`
7 implementation, and to also provide a non-setuid-root worked example
8 for testing PAM interaction with `libcap` and `pam_cap.so`. The
9 required expectations for `pam_unix.so` are that it include this
10 commit:
11
12 https://github.com/linux-pam/linux-pam/pull/373/commits/bf9b1d8ad909634000a7356af2d865a79d3f86f3
13
14 The original sources for this version of `su` were found here:
15
16 https://kernel.org/pub/linux/libs/pam/pre/applications/SimplePAMApps-0.60.tar.gz
17
18 The `SimplePAMApps` contain the same License as `libcap` (they were
19 originally started by the same authors!). The credited Authors in the
20 above tarball were:
21
22 - Andrew [G.] Morgan
23 - Andrey V. Savochkin
24 - Alexei V. Galatenko
25
26 The code in this present directory is freely adapted from the above
27 tar ball and is thus a derived work from that.
28
29 **NOTE** As of the time of writing, this adaptation is likely rife
30 with bugs.
31
32 Finally, Andrew would like to apologize to Andrey for removing all of
33 the config support he worked to add all those decades ago..! I just
34 wanted to make a quick tester for a potential workaround for this
35 `pam_cap.so` issue:
36
37 - https://bugzilla.kernel.org/show_bug.cgi?id=212945
38
39 Andrew G. Morgan <[email protected]>
40 2021-06-30