diff options
Diffstat (limited to 'man')
| -rw-r--r-- | man/include/qmanifest.desc | 29 | ||||
| -rw-r--r-- | man/qmanifest.1 | 94 |
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) |