summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man/man1/tlmgr.1
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-02-11 01:23:33 +0000
committerKarl Berry <karl@freefriends.org>2018-02-11 01:23:33 +0000
commitc75d4c44087a0c230c790a51cb9f425fa602cbac (patch)
treee3128da62142cbd5fe2436f2dc475ffa2baa533a /Master/texmf-dist/doc/man/man1/tlmgr.1
parentfa5d45823129987e649ebfca8992cc159f733759 (diff)
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@46594 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man/man1/tlmgr.1')
-rw-r--r--Master/texmf-dist/doc/man/man1/tlmgr.170
1 files changed, 34 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.1 b/Master/texmf-dist/doc/man/man1/tlmgr.1
index 230253736be..c40a1fcf710 100644
--- a/Master/texmf-dist/doc/man/man1/tlmgr.1
+++ b/Master/texmf-dist/doc/man/man1/tlmgr.1
@@ -129,7 +129,7 @@
.\" ========================================================================
.\"
.IX Title "TLMGR 1"
-.TH TLMGR 1 "2018-01-04" "perl v5.26.1" "User Contributed Perl Documentation"
+.TH TLMGR 1 "2018-02-11" "perl v5.26.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -291,9 +291,11 @@ only useful in debugging.
.IP "\fB\-\-no\-require\-verification\fR" 4
.IX Item "--no-require-verification"
.PD
-Instructs \f(CW\*(C`tlmgr\*(C'\fR to only accept signed and verified remotes. In any
-other case \f(CW\*(C`tlmgr\*(C'\fR will quit operation.
-See \*(L"\s-1CRYPTOGRAPHIC VERIFICATION\*(R"\s0 below for details.
+Verify that all remote repositories to be correctly signed, or quit.
+With \f(CW\*(C`\-\-no\-require\-verification\*(C'\fR, all verification is omitted. By
+default, verification is performed (but not required) if GnuPG and the
+relevant keys are available. See \*(L"\s-1CRYPTOGRAPHIC VERIFICATION\*(R"\s0 below for
+details.
.IP "\fB\-\-usermode\fR" 4
.IX Item "--usermode"
Activates user mode for this run of \f(CW\*(C`tlmgr\*(C'\fR; see \*(L"\s-1USER MODE\*(R"\s0 below.
@@ -306,9 +308,11 @@ Uses \fIdir\fR for the tree in user mode; see \*(L"\s-1USER MODE\*(R"\s0 below.
.IP "\fB\-\-no\-verify\-downloads\fR" 4
.IX Item "--no-verify-downloads"
.PD
-Enables or disables cryptographic verification of downloaded database files.
-A working GnuPG (\f(CW\*(C`gpg\*(C'\fR) binary needs to be present in the path, otherwise
-this option has no effect. See \*(L"\s-1CRYPTOGRAPHIC VERIFICATION\*(R"\s0 below for details.
+Enables or disables cryptographic verification of all downloaded
+database files. A working GnuPG (\f(CW\*(C`gpg\*(C'\fR) binary needs to be present in
+the path, otherwise this option has no effect. By default, the main
+repository is verified, while any other repositories are not verified.
+See \*(L"\s-1CRYPTOGRAPHIC VERIFICATION\*(R"\s0 below for details.
.PP
The standard options for TeX Live programs are also accepted:
\&\f(CW\*(C`\-\-help/\-h/\-?\*(C'\fR, \f(CW\*(C`\-\-version\*(C'\fR, \f(CW\*(C`\-q\*(C'\fR (no informational messages), \f(CW\*(C`\-v\*(C'\fR
@@ -1186,11 +1190,12 @@ Save the local \s-1TLPDB,\s0 presumably after other operations have changed it.
.IX Item "get [var] =item set [var [val]]"
Get the value of \fIvar\fR, or set it to \fIval\fR. Possible \fIvar\fR names:
\&\f(CW\*(C`debug\-translation\*(C'\fR, \f(CW\*(C`machine\-readable\*(C'\fR, \f(CW\*(C`no\-execute\-actions\*(C'\fR,
-\&\f(CW\*(C`require\-verification\*(C'\fR, \f(CW\*(C`verify\-downloads\*(C'\fR, \f(CW\*(C`repository\*(C'\fR, and \f(CW\*(C`prompt\*(C'\fR. All
-except \f(CW\*(C`repository\*(C'\fR and \f(CW\*(C`prompt\*(C'\fR are booleans, taking values 0 and 1, and behave
-like the corresponding command line option. The \f(CW\*(C`repository\*(C'\fR variable
-takes a string, and sets the remote repository location. The \f(CW\*(C`prompt\*(C'\fR variable
-takes a string, and sets the current default prompt.
+\&\f(CW\*(C`require\-verification\*(C'\fR, \f(CW\*(C`verify\-downloads\*(C'\fR, \f(CW\*(C`repository\*(C'\fR, and
+\&\f(CW\*(C`prompt\*(C'\fR. All except \f(CW\*(C`repository\*(C'\fR and \f(CW\*(C`prompt\*(C'\fR are booleans, taking
+values 0 and 1, and behave like the corresponding command line option.
+The \f(CW\*(C`repository\*(C'\fR variable takes a string, and sets the remote
+repository location. The \f(CW\*(C`prompt\*(C'\fR variable takes a string, and sets the
+current default prompt.
.Sp
If \fIvar\fR or then \fIval\fR is not specified, it is prompted for.
.SS "uninstall"
@@ -1448,11 +1453,8 @@ make sense to set this.
.PP
The \f(CW\*(C`no\-checksums\*(C'\fR key needs more explanation. By default, package
checksums computed and stored on the server (in the \s-1TLPDB\s0) are compared
-to checksums computed locally after downloading. That is, for each
-\&\f(CW\*(C`texlive.tlpdb\*(C'\fR loaded from a repository, the corresponding checksum
-file \f(CW\*(C`texlive.tlpdb.sha512\*(C'\fR is also downloaded, and \f(CW\*(C`tlmgr\*(C'\fR confirms
-whether the checksum of the downloaded \s-1TLPDB\s0 file agrees with the
-download data. \f(CW\*(C`no\-checksums\*(C'\fR disables this process.
+to checksums computed locally after downloading. \f(CW\*(C`no\-checksums\*(C'\fR
+disables this process.
.PP
The checksum algorithm is \s-1SHA\-512.\s0 Your system must have one of (looked
for in this order) the Perl \f(CW\*(C`Digest::SHA\*(C'\fR module, the \f(CW\*(C`openssl\*(C'\fR
@@ -1468,26 +1470,22 @@ context.) \f(CW\*(C`no\-checksums\*(C'\fR avoids the warning.
\&\f(CW\*(C`tlmgr\*(C'\fR and \f(CW\*(C`install\-tl\*(C'\fR perform cryptographic verification if
possible. If verification is performed and successful, the programs
report \f(CW\*(C`(verified)\*(C'\fR after loading the \s-1TLPDB\s0; otherwise, they report
-\&\f(CW\*(C`(not verified)\*(C'\fR. Either way, by default the installation and/or
+\&\f(CW\*(C`(not verified)\*(C'\fR. But either way, by default the installation and/or
updates proceed normally.
.PP
-If a program named \f(CW\*(C`gpg\*(C'\fR is available (that is, it is found in the
-\&\f(CW\*(C`PATH\*(C'\fR), cryptographic signatures will be checked. In this case we
-require that the main repository is signed, but signing is not required
-for additional repositories. If \f(CW\*(C`gpg\*(C'\fR is not available, signatures are
-not checked and no verification is carried out, but \f(CW\*(C`tlmgr\*(C'\fR proceeds
-normally.
-.PP
-The attempted verification can be suppressed by specifying
-\&\f(CW\*(C`\-\-no\-verify\-downloads\*(C'\fR on the command line, or the entry
-\&\f(CW\*(C`verify\-downloads=0\*(C'\fR in a \f(CW\*(C`tlmgr\*(C'\fR config file (described in
-\&\*(L"\s-1CONFIGURATION FILE FOR TLMGR\*(R"\s0). On the other hand, you can
-\&\fIrequire\fR verification by specifying \f(CW\*(C`\-\-require\-verification\*(C'\fR on the
-command line, or \f(CW\*(C`require\-verification=1\*(C'\fR in a \f(CW\*(C`tlmgr\*(C'\fR config file;
-in this case, if verification is not possible, the program quits.
-Note that as mentioned above, if \f(CW\*(C`gpg\*(C'\fR is available, the main repository
-is always required to have a signature. Using the \f(CW\*(C`\-\-require\-verification\*(C'\fR
-switch, \f(CW\*(C`tlmgr\*(C'\fR also requires signatures from additional repositories.
+If a program named \f(CW\*(C`gpg\*(C'\fR is available (that is, found in \f(CW\*(C`PATH\*(C'\fR),
+cryptographic signatures will be checked. In this case we require the
+main repository be signed, but not any additional repositories. If
+\&\f(CW\*(C`gpg\*(C'\fR is not available, signatures are not checked and no verification
+is carried out, but \f(CW\*(C`tlmgr\*(C'\fR proceeds normally.
+.PP
+The attempted verification can be suppressed entirely by specifying
+\&\f(CW\*(C`\-\-no\-verify\-downloads\*(C'\fR on the command line, or a line
+\&\f(CW\*(C`verify\-downloads=0\*(C'\fR in a \f(CW\*(C`tlmgr\*(C'\fR config file (see \*(L"\s-1CONFIGURATION
+FILE FOR TLMGR\*(R"\s0). On the other hand, you can \fIrequire\fR successful
+verification by specifying \f(CW\*(C`\-\-require\-verification\*(C'\fR on the command
+line, or \f(CW\*(C`require\-verification=1\*(C'\fR in a \f(CW\*(C`tlmgr\*(C'\fR config file; in this
+case, if verification is not possible, or fails, the program quits.
.PP
Cryptographic verification requires checksum checking (described just
above) to succeed, and a working GnuPG (\f(CW\*(C`gpg\*(C'\fR) program (see below for
@@ -2032,4 +2030,4 @@ This script and its documentation were written for the TeX Live
distribution (<http://tug.org/texlive>) and both are licensed under the
\&\s-1GNU\s0 General Public License Version 2 or later.
.PP
-\&\f(CW$Id:\fR tlmgr.pl 46207 2018\-01\-04 18:34:36Z karl $
+\&\f(CW$Id:\fR tlmgr.pl 46591 2018\-02\-11 00:19:58Z karl $