misc/ssss: Updated for version 0.5.7.

Signed-off-by: B. Watson <urchlay@slackware.uk>

Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>

7 files changed, 32 insertions, 217 deletions

diff --git a/misc/ssss/patches/0003-Fix-use-of-memset.patch b/misc/ssss/patches/0003-Fix-use-of-memset.patch
deleted file mode 100644
index 8323cf2292c9..000000000000
--- a/misc/ssss/patches/0003-Fix-use-of-memset.patch
+++ /dev/null
@@ -1,21 +0,0 @@
-From: Tomasz Buchert <tomasz@debian.org>
-Date: Wed, 2 Sep 2015 19:44:42 +0200
-Subject: Fix use of memset
-
----
- ssss.c | 2 +-
- 1 file changed, 1 insertion(+), 1 deletion(-)
-
-diff --git a/ssss.c b/ssss.c
-index 717b98b..d2415b4 100644
---- a/ssss.c
-+++ b/ssss.c
-@@ -171,7 +171,7 @@ void field_print(FILE* stream, const mpz_t x, int hexmode)
-     size_t t;
-     unsigned int i;
-     int printable, warn = 0;
--    memset(buf, degree / 8 + 1, 0);
-+    memset(buf, 0, degree / 8 + 1);
-     mpz_export(buf, &t, 1, 1, 0, 0, x);
-     for(i = 0; i < t; i++) {
-       printable = (buf[i] >= 32) && (buf[i] < 127);
diff --git a/misc/ssss/patches/series b/misc/ssss/patches/series
index 60d8346abb96..cf26d42e4cf7 100644
--- a/misc/ssss/patches/series
+++ b/misc/ssss/patches/series
@@ -1,2 +1 @@
-0003-Fix-use-of-memset.patch
 0004-Remove-the-direct-PayPal-link.patch
diff --git a/misc/ssss/slack-desc b/misc/ssss/slack-desc
index d80db2ad9808..33bf2bcfc97c 100644
--- a/misc/ssss/slack-desc
+++ b/misc/ssss/slack-desc
@@ -13,7 +13,7 @@ ssss: participants, each of which is allocated a share of the secret.
 ssss: The secret can only be reconstructed when the shares are combined
 ssss: together; individual shares are of no use on their own.
 ssss:
-ssss: Homepage: http://point-at-infinity.org/ssss/
+ssss:
 ssss:
 ssss:
 ssss:
diff --git a/misc/ssss/ssss.1 b/misc/ssss/ssss.1
index 1a2342984d12..3268f57ba3b6 100644
--- a/misc/ssss/ssss.1
+++ b/misc/ssss/ssss.1
@@ -1,10 +1,10 @@
-.TH SSSS "1" "July 2023" "0.5" "SlackBuilds.org"
+.TH SSSS "1" "September 2023" "0.5" "SlackBuilds.org"
 .SH NAME
 ssss \- Split and Combine Secrets using Shamir's Secret Sharing Scheme.
 .SH SYNOPSIS
-\fBssss-split -t \fIthreshold\fB -n \fIshares\fB [-w \fItoken\fB] [-s \fIlevel\fB] [-x] [-q] [-Q] [-D] [-v]
+\fBssss-split -t \fIthreshold\fB -n \fIshares\fB [-w \fItoken\fB] [-s \fIlevel\fB] [-M] [-r] [-x] [-q] [-Q] [-D] [-v]
 
-ssss-combine -t \fIthreshold\fB [-x] [-q] [-Q] [-D] [-v]
+ssss-combine -t \fIthreshold\fB [-M] [-r -n \fIshares\fB] [-x] [-q] [-Q] [-D] [-v]
 \f1
 .SH DESCRIPTION
 ssss is an implementation of Shamir's Secret Sharing Scheme. The program suite does both: the generation of shares for a known secret, and the reconstruction of a secret using user-provided shares.
@@ -20,12 +20,18 @@ Specify the number of shares necessary to reconstruct the secret.
 \fB-n \fIshares\fB\f1
 Specify the number of shares to be generated.
 .TP
+\fB-M\f1
+Require a successful memory lock in order to proceed, and terminate if one was not obtained. Option is not available if the code was compiled with NOMLOCK.
+.TP
 \fB-w \fItoken\fB\f1
 Text token to name shares in order to avoid confusion in case one utilizes secret sharing to protect several independent secrets. The generated shares are prefixed by these tokens.
 .TP
 \fB-s \fIlevel\fB\f1
 Enforce the scheme's security level (in bits). This option implies an upper bound for the length of the shared secret (shorter secrets are padded). Only multiples of 8 in the range from 8 to 1024 are allowed. If this option is ommitted (or the value given is 0) the security level is chosen automatically depending on the secret's length. The security level directly determines the length of the shares.
 .TP
+\fB-r\f1
+Recovery mode: \fBssss-combine\f1 reads in a set of \fIt\f1 shares and reconstruct \fIn\f1 shares again. \fBssss-split\f1 doesn't generate shares randomly, but asks the secret and \fIt\f1 - 1 shares (secret is treated here as a share). Usable to recover forgotten shares.
+.TP
 \fB-x\f1
 Hex mode: use hexadecimal digits in place of ASCII characters for I/O. This is useful if one wants to protect binary data, like block cipher keys.
 .TP
@@ -36,7 +42,7 @@ Quiet mode: disable all unnecessary output. Useful in scripts.
 Extra quiet mode: like \fB-q\f1, but also suppress warnings.
 .TP
 \fB-D\f1
-Disable the diffusion layer added in version 0.2. This option is needed when shares are combined that where generated with ssss version 0.1.
+Disable the diffusion layer added in version 0.2. This option is needed when shares are combined that were generated with ssss version 0.1.
 .TP
 \fB-v\f1
 Print version information.
@@ -57,6 +63,6 @@ gpg -c < file.plain > file.encrypted
 .SH SECURITY
 \fBssss\f1 tries to lock its virtual address space into RAM for privacy reasons. But this may fail for two reasons: either the current uid doesn't permit page locking, or the RLIMIT_MEMLOCK is set too low. After printing a warning message \fBssss\f1 will run even without obtaining the desired mlock. 
 .SH AUTHOR
-This software (v0.5) was written in 2006 by B. Poettering (ssss AT point-at-infinity.org). Find the newest version of ssss on the project's homepage: \fBhttp://point-at-infinity.org/ssss/\f1. 
+The original software (v0.5) was written in 2006 by B. Poettering (ssss AT point-at-infinity.org). Find the newest version of ssss on the project's homepage: \fBhttp://point-at-infinity.org/ssss/\f1. The amended versions (v0.5.1+) were written between 2011..2020 by Jon D Frisby (jfrisby AT mrjoy.com). Find the newest version on github: \fBhttps://github.com/MrJoy/ssss\f1. 
 .SH FURTHER READING
 \fBhttp://en.wikipedia.org/wiki/Secret_sharing\f1
diff --git a/misc/ssss/ssss.1.html b/misc/ssss/ssss.1.html
deleted file mode 100644
index cbcee6ee6fab..000000000000
--- a/misc/ssss/ssss.1.html
+++ /dev/null
@@ -1,177 +0,0 @@
-<body text="#000000" link="#0000ff" bgcolor="#ffffff"><center><table width="80%">
-<tr><td><h1>ssss</h1>
-<h2>Split and Combine Secrets using Shamir's Secret Sharing Scheme.</h2>
-
-
-<h2>Synopsis</h2>
-<b>
-      ssss-split -t <em>threshold</em> -n <em>shares</em> [-w <em>token</em>] 
-         [-s <em>level</em>] [-x] [-q] [-Q] [-D] [-v]<br>
-
-      ssss-combine -t <em>threshold</em> [-x] [-q] [-Q] [-D] [-v]<br>
-
-</b>
-
-
-<h2>Description</h2>
-
-<p>ssss is an implementation of Shamir's Secret Sharing Scheme. The
-program suite does both: the generation of shares for a known secret,
-and the reconstruction of a secret using user-provided shares.</p>
-
-
-
-<h2>Commands</h2>
-
-      <p><b>ssss-split</b>: prompt the user for a secret and generate a set of
-      corresponding shares.</p>
-      
-      <p><b>ssss-combine</b>: read in a set of shares and reconstruct
-      the secret.</p>
-
-
-
-<h2>Options</h2>
-
-
-      
-<p><b>-t <em>threshold</em></b></p> 
-<p>Specify the number of
-      shares necessary to reconstruct the secret.</p>
-    
-
-
-      
-<p><b>-n <em>shares</em></b></p>
-
-      <p>Specify the number of shares to be generated.</p>
-
-      
-      
-      <p><b>-w <em>token</em></b></p>
-
-      <p>Text token to name shares in order to avoid confusion in case one
-      utilizes secret sharing to protect several independent secrets. The
-      generated shares are prefixed by these tokens.</p>
-
-      
-      
-      <p><b>-s <em>level</em></b></p>
-
-      <p>Enforce the scheme's security level (in bits). This option
-      implies an upper bound for the length of the shared secret
-      (shorter secrets are padded). Only multiples of 8 in the range
-      from 8 to 1024 are allowed. If this option is ommitted (or the
-      value given is 0) the security level is chosen automatically
-      depending on the secret's length.  The security level directly
-      determines the length of the shares.</p>
-
-      
-
-      <p><b>-x</b></p>
-
-      <p>Hex mode: use hexadecimal digits in place of ASCII characters for
-      I/O. This is useful if one wants to protect binary data, like
-      block cipher keys.</p>
-
-      
-
-      <p><b>-q</b></p>
-
-      <p>Quiet mode: disable all unnecessary output. Useful in scripts.
-      </p>
-
-      
-      <p><b>-Q</b></p>
-
-      <p>Extra quiet mode: like <b>-q</b>, but also suppress
-warnings.</p>
-
-      
-
-      <p><b>-D</b></p>
-
-      <p>Disable the diffusion layer added in version 0.2. This option
-      is needed when shares are combined that where generated with
-      ssss version 0.1.</p>
-
-      
-
-      <p><b>-v</b></p>
-
-      <p>Print version information.</p>
-
-      
-
-
-<h2>Example</h2>
-
-<p>
-        In case you want to protect your login password with a set of ten
-        shares in such a way that any three of them can reconstruct the
-        password, you simply run the command
-</p>
-
-<p>
-          ssss-split -t 3 -n 10 -w passwd
-</p>
-
-<p>
-        To reconstruct the password pass three of the generated shares
-        (in any order) to
-</p>
-
-<p>
-          ssss-combine -t 3
-</p>
-
-
-
-<h2>Notes</h2>
-
-<p>
-To protect a secret larger than 1024 bits a hybrid technique has to be
-applied: encrypt the secret with a block cipher and apply secret
-sharing to just the key. Among others openssl and gpg can do the
-encryption part:
-</p>
-<p>
-openssl bf -e &lt; file.plain &gt; file.encrypted
-</p>
-<p>
-gpg -c &lt; file.plain &gt; file.encrypted
-</p>
-
-
-
-
-<h2>Security</h2>
-
-<p>
-<b>ssss</b> tries to lock its virtual address space into RAM for
-privacy reasons. But this may fail for two reasons: either the current uid
-doesn't permit page locking, or the RLIMIT_MEMLOCK is set too
-low. After printing a warning message <b>ssss</b> will run even without
-obtaining the desired mlock.
-</p>
-
-
-
-
-<h2>Author</h2>
-
-        This software (v0.5) was written in 2006 by B. Poettering
-        (ssss AT point-at-infinity.org). Find the newest version of
-        ssss on the project's homepage: <a href = "http://point-at-infinity.org/ssss/">http://point-at-infinity.org/ssss/</a>.
-
-
-
-<h2>Further reading</h2>
-
-        <a href = "http://en.wikipedia.org/wiki/Secret_sharing">http://en.wikipedia.org/wiki/Secret_sharing</a>
-
-
-
-
-</td></tr></table></center>
-</body>
diff --git a/misc/ssss/ssss.SlackBuild b/misc/ssss/ssss.SlackBuild
index d40d69e11562..27c75fc97fe2 100644
--- a/misc/ssss/ssss.SlackBuild
+++ b/misc/ssss/ssss.SlackBuild
@@ -26,6 +26,12 @@
 # markus reichelt, email removed.
 # 2011 Apr 07 - initial release
 
+# 20230911 bkw: update for v0.5.7.
+# - switch to MrJoy's fork, which has some minor enhancements.
+# - get rid of ssss.1.html: the existing one in our repo is outdated,
+#   and the updated one doesn't build properly. it's the same content
+#   as the man page, anyway, so redundant.
+
 # 20230709 bkw: BUILD=2
 # - new maintainer.
 # - man page symlinks to the actual command names.
@@ -36,7 +42,7 @@
 cd $(dirname $0) ; CWD=$(pwd)
 
 PRGNAM=ssss
-VERSION=${VERSION:-0.5}
+VERSION=${VERSION:-0.5.7}
 BUILD=${BUILD:-2}
 TAG=${TAG:-_SBo}
 PKGTYPE=${PKGTYPE:-tgz}
@@ -73,9 +79,11 @@ set -e
 rm -rf $PKG
 mkdir -p $TMP $PKG $OUTPUT
 cd $TMP
-rm -rf $PRGNAM-$VERSION
-tar xvf $CWD/$PRGNAM-$VERSION.tar.gz
-cd $PRGNAM-$VERSION
+rm -rf $PRGNAM-releases-v$VERSION
+# 20230911 bkw: since upstream puts a / in the tag name (releases/v0.5.7),
+# the magic github URL includes a "v" in the filename.
+tar xvf $CWD/$PRGNAM-releases-v$VERSION.tar.gz
+cd $PRGNAM-releases-v$VERSION
 chown -R root:root .
 find -L .  -perm /111 -a \! -perm 755 -a -exec chmod 755 {} + -o \
         \! -perm /111 -a \! -perm 644 -a -exec chmod 644 {} +
@@ -84,6 +92,7 @@ find -L .  -perm /111 -a \! -perm 755 -a -exec chmod 755 {} + -o \
 # need the Makefile patch, and the "man page" patch really patches the
 # XML source to the man page, which doesn't help us because we can't
 # rebuild the man page anyway.
+# 20230911 bkw: no longer need the memset patch, upstream applied it already.
 for i in $( cat $CWD/patches/series ); do
   patch -p1 < $CWD/patches/$i
 done
@@ -100,6 +109,8 @@ sed -i "s/-O2/${SLKCFLAGS}/" Makefile
 # 20230709 bkw: 'make ssss.1' is supposed to build the man page, but
 # fails. Original script author included the man page with the
 # script. We can't do "make" with no argument here...
+# 20230911 bkw: MrJoy's fork has a 'make install', but it doesn't do
+# what we want. Manual install still works.
 make ssss-split
 
 # 20230709 bkw: ssss-combine is just a symlink.
@@ -112,10 +123,7 @@ gzip -9c < $CWD/ssss.1 > $PKGMAN1/ssss.1.gz
 ln -s ssss.1.gz $PKGMAN1/ssss-split.1.gz
 ln -s ssss.1.gz $PKGMAN1/ssss-combine.1.gz
 
-# 20230709 bkw: ssss.1.html is the same content as the man page, don't
-# really need, but it's been in the package for ~11 years, so leave it.
-cp -a HISTORY LICENSE THANKS doc.html $PKGDOC
-cat $CWD/ssss.1.html > $PKGDOC/ssss.1.html
+cp -a README* HISTORY* LICENSE* THANKS* doc.html $PKGDOC
 cat $CWD/$PRGNAM.SlackBuild > $PKGDOC/$PRGNAM.SlackBuild
 
 mkdir -p $PKG/install
diff --git a/misc/ssss/ssss.info b/misc/ssss/ssss.info
index 9404cbec8d56..a19e09bb6303 100644
--- a/misc/ssss/ssss.info
+++ b/misc/ssss/ssss.info
@@ -1,8 +1,8 @@
 PRGNAM="ssss"
-VERSION="0.5"
-HOMEPAGE="http://point-at-infinity.org/ssss/"
-DOWNLOAD="http://point-at-infinity.org/ssss/ssss-0.5.tar.gz"
-MD5SUM="24227252aa195a146d09de1df10357a1"
+VERSION="0.5.7"
+HOMEPAGE="https://github.com/MrJoy/ssss/"
+DOWNLOAD="https://github.com/MrJoy/ssss/archive/releases/v0.5.7/ssss-releases-v0.5.7.tar.gz"
+MD5SUM="63c757d7b9a06e074d4a58193401cece"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES=""