qmanifest: new applet to verify and generate thick Manifests

This incorporates https://github.com/grobian/hashgen into portage-utils
as qmanifest.

Signed-off-by: Fabian Groffen <grobian@gentoo.org>

2 files changed, 123 insertions, 0 deletions

diff --git a/man/include/qmanifest.desc b/man/include/qmanifest.desc
new file mode 100644
index 0000000..b873419
--- /dev/null
+++ b/man/include/qmanifest.desc
@@ -0,0 +1,29 @@
+\fIqmanifest\fR allows to verify or generate thick signed Manifests in
+an ebuild tree.  By default, \fIqmanifest\fR will verify the main tree
+as specified by Portage's configuration (one can check which using
+\fIq\fR \fB-o\fR).  In this mode, it will output some information about
+the GPG signature of the top-level Manifest file, and further reports on
+any problems it encounters.
+.P
+This applet was originally a standalone program \fIhashgen\fR and its
+alias \fIhashverify\fR.  Aliases for these names are still available for
+historical reasons.  With the incorporation of \fIhashgen\fR in
+\fBportage-utils\fR, development on the former has stopped in favour of
+the latter.
+.P
+The arguments to \fIqmanifest\fR can be directories or names of
+overlays.  By default, each argument is attempted to be matched against
+all overlay names, and if that fails, treated as directory to presume a
+tree is in.  This behaviour can be overridden with the \fB-d\fR and
+\fB-o\fR flags to force treating the arguments as directories or
+overlay names respectively.  Note that overlay names are those as
+defined in \fIrepos.conf\fR from Portage's configuration.  The
+\fIrepo_name\fR files from the overlays themselves (if present) are
+ignored.
+.P
+This applet does similar things as \fIapp-portage/gemato\fR.  However,
+the output and implemented strategies are completely different.  When
+compiled with \fBUSE=openmp\fR, this applet will exploit parallelism
+where possible to traverse a tree.  Should you want to limit the number
+of parallel threads, export \fBOMP_NUM_THREADS\fR in your environment
+with the desired maximum amount of threads in use by \fIqmanifest\fR.
diff --git a/man/qmanifest.1 b/man/qmanifest.1
new file mode 100644
index 0000000..e223122
--- /dev/null
+++ b/man/qmanifest.1
@@ -0,0 +1,94 @@
+.\" generated by mkman.py, please do NOT edit!
+.TH qmanifest "1" "May 2019" "Gentoo Foundation" "qmanifest"
+.SH NAME
+qmanifest \- verify or generate thick Manifest files
+.SH SYNOPSIS
+.B qmanifest
+\fI[opts] <misc args>\fR
+.SH DESCRIPTION
+\fIqmanifest\fR allows to verify or generate thick signed Manifests in
+an ebuild tree.  By default, \fIqmanifest\fR will verify the main tree
+as specified by Portage's configuration (one can check which using
+\fIq\fR \fB-o\fR).  In this mode, it will output some information about
+the GPG signature of the top-level Manifest file, and further reports on
+any problems it encounters.
+.P
+This applet was originally a standalone program \fIhashgen\fR and its
+alias \fIhashverify\fR.  Aliases for these names are still available for
+historical reasons.  With the incorporation of \fIhashgen\fR in
+\fBportage-utils\fR, development on the former has stopped in favour of
+the latter.
+.P
+The arguments to \fIqmanifest\fR can be directories or names of
+overlays.  By default, each argument is attempted to be matched against
+all overlay names, and if that fails, treated as directory to presume a
+tree is in.  This behaviour can be overridden with the \fB-d\fR and
+\fB-o\fR flags to force treating the arguments as directories or
+overlay names respectively.  Note that overlay names are those as
+defined in \fIrepos.conf\fR from Portage's configuration.  The
+\fIrepo_name\fR files from the overlays themselves (if present) are
+ignored.
+.P
+This applet does similar things as \fIapp-portage/gemato\fR.  However,
+the output and implemented strategies are completely different.  When
+compiled with \fBUSE=openmp\fR, this applet will exploit parallelism
+where possible to traverse a tree.  Should you want to limit the number
+of parallel threads, export \fBOMP_NUM_THREADS\fR in your environment
+with the desired maximum amount of threads in use by \fIqmanifest\fR.
+.SH OPTIONS
+.TP
+\fB\-g\fR, \fB\-\-generate\fR
+Generate thick Manifests and sign.
+.TP
+\fB\-d\fR, \fB\-\-dir\fR
+Treat arguments as directories.
+.TP
+\fB\-o\fR, \fB\-\-overlay\fR
+Treat arguments as overlay names.
+.TP
+\fB\-\-root\fR \fI<arg>\fR
+Set the ROOT env var.
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+Make a lot of noise.
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+Tighter output; suppress warnings.
+.TP
+\fB\-C\fR, \fB\-\-nocolor\fR
+Don't output color.
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+Print this help and exit.
+.TP
+\fB\-V\fR, \fB\-\-version\fR
+Print version and exit.
+
+.SH "REPORTING BUGS"
+Please report bugs via http://bugs.gentoo.org/
+.br
+Product: Portage Development; Component: Tools
+.SH AUTHORS
+.nf
+Ned Ludd <solar@gentoo.org>
+Mike Frysinger <vapier@gentoo.org>
+Fabian Groffen <grobian@gentoo.org>
+.fi
+.SH "SEE ALSO"
+.BR q (1),
+.BR qatom (1),
+.BR qcheck (1),
+.BR qdepends (1),
+.BR qfile (1),
+.BR qgrep (1),
+.BR qkeyword (1),
+.BR qlist (1),
+.BR qlop (1),
+.BR qmerge (1),
+.BR qpkg (1),
+.BR qsearch (1),
+.BR qsize (1),
+.BR qtbz2 (1),
+.BR qtegrity (1),
+.BR quse (1),
+.BR qxpak (1)