diff options
author | Karl Berry <karl@freefriends.org> | 2018-02-11 01:23:33 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-02-11 01:23:33 +0000 |
commit | c75d4c44087a0c230c790a51cb9f425fa602cbac (patch) | |
tree | e3128da62142cbd5fe2436f2dc475ffa2baa533a /Master/texmf-dist | |
parent | fa5d45823129987e649ebfca8992cc159f733759 (diff) |
tl-update-auto
git-svn-id: svn://tug.org/texlive/trunk@46594 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.1 | 70 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf | bin | 126116 -> 125886 bytes |
2 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 $ diff --git a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf Binary files differindex 68c81c00968..f74cc72ec53 100644 --- a/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tlmgr.man1.pdf |