Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 1133DD4A604 for ; Fri, 16 Jan 2026 06:13:44 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1vgd53-0008O9-Sy; Fri, 16 Jan 2026 01:13:09 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1vgd51-0008Mv-Dv for grub-devel@gnu.org; Fri, 16 Jan 2026 01:13:07 -0500 Received: from mail-wm1-x342.google.com ([2a00:1450:4864:20::342]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1vgd4z-0002ac-6R for grub-devel@gnu.org; Fri, 16 Jan 2026 01:13:07 -0500 Received: by mail-wm1-x342.google.com with SMTP id 5b1f17b1804b1-4801bc328easo10181875e9.3 for ; Thu, 15 Jan 2026 22:13:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1768543983; x=1769148783; darn=gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=gc/8VcGmn3WbhwZZqPeavEHoEbKNEVIrAu6oJE3A9Cg=; b=bHZuXx/sYaHdLk5B7YtPj/cuGdcFfcqK81K8K58624BgifuMyw22edvwvy5f+isIZi ogx8SMioBApHbAdb2B1/bFCaDLa29EKg/4kHT+JW9Q/rcacHeZ10PjxV/gNCkAjqaP9N K+NNzTWh9YyW5W7ir/7rDsdxB3ub1jTkEmTn4V8HB4KxMOOMvFVOYOrejRJjYCaJausv Pb/xZtinoK2P7yh4CA5Pu5fSpPhah1vi23vKpnftOhp3xUx2LVoeLBSETT1x+E5M8tcW agrS+512UUM/RaQLdTmn0iIS5Gq+eoZ4YZQCQ0hiBph4ErEpjf0NPfd8i4mTmXa5dkHg 6gtg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1768543983; x=1769148783; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=gc/8VcGmn3WbhwZZqPeavEHoEbKNEVIrAu6oJE3A9Cg=; b=oFaTGspC8FCkp4ZxIXFxDnQ08shPxtg1KIEeStBhM1cAvxbt2fnAZAIbUWPMuzW0LH u1cBOOE2B6yBdf5KOqrF9nkOQCkabwJqKZg/wzTT/ymo7Kfzdqk3jUcQ7dXfdIXiMxg4 G4CCluqiWuujT59T8Y9Rnh/kISVxVs48kRyn3qDvkzhB1otdoSeAkiHkPcPaF2n2sdqV EsQCwSEcQEpdCnqT3Fdw9mfylXNjqLe/4BD2naF99+yNa+kqh8mgdKLdVRISyiu7/Cbv vNM0ty6MXhFBRmh+7yiND7dQl5RTenRV3uj+hq+DqT5kBekAGNKDVUCEpyAeXHwS5gv2 17yA== X-Gm-Message-State: AOJu0YwWA5RK+V5wEwfv9+JUNKLTNkq20h9SvIO6RCbZGAIazdluB4oy LblaWNNwbtJjeWKBKZiVZexfMt6VT7D2A6sBGGI2on1wzDanDOrzOwdKYbjueJacN/qjflI6wJf Wu7xF48U= X-Gm-Gg: AY/fxX5zH48K7YYlo/IciAaArEQtabeCxMlUXNKCu4DC7+pQsibNp7zJEksF+Ltm9+M QqFyYtaHtG7zGhgpN6sr96Db5416pKc/p4j7zYcpvSkYWWFG/GNoou2o4yswvb9DdOYCZaVQALa Qx+lVe4l1KddBi88QK0OnfPkZVp2r57LIBAaFMApxct3qwHUY/jhZ268Sw/F7tUPGYHi7HJxjxK hYu57XC3iXJ7oq1M9D4bCjMZA5cR8s9c1w8rheqCVTpBH4UgbN72y23DNn0riSUaRLy8eeRnKla oCtfvo8TvXDxqAa4rC3UuSYKtqo0Rv4eQBne/CwuNnPb4TQNKPRhFZNM0PaZdZjdwzMwj+15q/Y DYeUtc3Zt7ll0Rp+o+jMjaYY4+5nZTplgWK58xH88FzKlP4TIcqLMB7gjy2cTltBUfat5murmLV PcSbCXafVlCuQep5ekMqK2AoO96REKo43qDDCLcg== X-Received: by 2002:a05:600c:3f06:b0:475:dde5:d91b with SMTP id 5b1f17b1804b1-4801eb0359amr16260695e9.17.1768543983391; Thu, 15 Jan 2026 22:13:03 -0800 (PST) Received: from localhost (111-240-141-30.dynamic-ip.hinet.net. [111.240.141.30]) by smtp.gmail.com with UTF8SMTPSA id d9443c01a7336-2a719411cc0sm10132135ad.85.2026.01.15.22.13.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 15 Jan 2026 22:13:02 -0800 (PST) To: The development of GNU GRUB Subject: [PATCH 2/3] docs: Add documentation for MFA key protector Date: Fri, 16 Jan 2026 14:12:51 +0800 Message-ID: <20260116061252.569068-3-glin@suse.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20260116061252.569068-1-glin@suse.com> References: <20260116061252.569068-1-glin@suse.com> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::342; envelope-from=glin@suse.com; helo=mail-wm1-x342.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Gary Lin via Grub-devel Reply-To: The development of GNU GRUB Cc: Gary Lin , Daniel Kiper Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org Sender: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org VGhpcyBwYXRjaCBhZGRzIHRoZSBkb2N1bWVudGF0aW9uIGZvciB0aGUgTXVsdGktRmFjdG9yIEF1 dGhlbnRpY2F0aW9uCihNRkEpIGtleSBwcm90ZWN0b3IgYW5kIGV4cGxhaW5zIHRoZSBzcGxpdC1r ZXkgYXJjaGl0ZWN0dXJlLgoKQWRkaXRpb25hbGx5LCB0aGUgZm9sbG93aW5nIG5ldyBjb21tYW5k cyBhcmUgZG9jdW1lbnRlZCBpbiB0aGUgY29tbWFuZApzZWN0aW9uOgoKKiBtZmFfa2V5X3Byb3Rl Y3Rvcl9pbml0IC8gbWZhX2tleV9wcm90ZWN0b3JfY2xlYXIKKiBmaWxlX2tleV9wcm90ZWN0b3Jf aW5pdCAvIGZpbGVfa2V5X3Byb3RlY3Rvcl9jbGVhcgoqIHB3X2tleV9wcm90ZWN0b3JfaW5pdCAv IHB3X2tleV9wcm90ZWN0b3JfY2xlYXIKClNpZ25lZC1vZmYtYnk6IEdhcnkgTGluIDxnbGluQHN1 c2UuY29tPgotLS0KIGRvY3MvZ3J1Yi50ZXhpIHwgMTg4ICsrKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxODggaW5zZXJ0aW9u cygrKQoKZGlmZiAtLWdpdCBhL2RvY3MvZ3J1Yi50ZXhpIGIvZG9jcy9ncnViLnRleGkKaW5kZXgg NzE4MTAwOWI2Li5jODg2ZDYxZmIgMTAwNjQ0Ci0tLSBhL2RvY3MvZ3J1Yi50ZXhpCisrKyBiL2Rv Y3MvZ3J1Yi50ZXhpCkBAIC02Njg4LDYgKzY2ODgsOCBAQCB5b3UgZm9yZ2V0IGEgY29tbWFuZCwg eW91IGNhbiBydW4gdGhlIGNvbW1hbmQgQGNvbW1hbmR7aGVscH0KICogZmFsc2U6OiAgICAgICAg ICAgICAgICAgICAgICAgRG8gbm90aGluZywgdW5zdWNjZXNzZnVsbHkKICogZmR0ZHVtcDo6ICAg ICAgICAgICAgICAgICAgICAgUmV0cmlldmUgZGV2aWNlIHRyZWUgaW5mb3JtYXRpb24KICogZmls ZTo6ICAgICAgICAgICAgICAgICAgICAgICAgVGVzdCB0aGUgcHJvdmlkZWQgZmlsZSBhZ2FpbnN0 IGEgdHlwZQorKiBmaWxlX2tleV9wcm90ZWN0b3JfaW5pdDo6ICAgICBJbml0aWFsaXplIHRoZSBm aWxlIGtleSBwcm90ZWN0b3IKKyogZmlsZV9rZXlfcHJvdGVjdG9yX2NsZWFyOjogICAgQ2xlYXIg dGhlIGZpbGUga2V5IHByb3RlY3RvcgogKiBmd3NldHVwOjogICAgICAgICAgICAgICAgICAgICBS ZWJvb3QgaW50byB0aGUgZmlybXdhcmUgc2V0dXAgbWVudQogKiBnZGJpbmZvOjogICAgICAgICAg ICAgICAgICAgICBQcm92aWRlIGluZm8gZm9yIGRlYnVnZ2luZyB3aXRoIEdEQgogKiBnZXR0ZXh0 OjogICAgICAgICAgICAgICAgICAgICBUcmFuc2xhdGUgYSBzdHJpbmcKQEAgLTY3MTAsNiArNjcx Miw4IEBAIHlvdSBmb3JnZXQgYSBjb21tYW5kLCB5b3UgY2FuIHJ1biB0aGUgY29tbWFuZCBAY29t bWFuZHtoZWxwfQogKiBsc21lbTo6ICAgICAgICAgICAgICAgICAgICAgICBMaXN0IGZyZWUgYW5k IGFsbG9jYXRlZCBtZW1vcnkgYmxvY2tzCiAqIGxzbWVtcmVnaW9uczo6ICAgICAgICAgICAgICAg IExpc3QgbWVtb3J5IHJlZ2lvbnMKICogbWQ1c3VtOjogICAgICAgICAgICAgICAgICAgICAgQ29t cHV0ZSBvciBjaGVjayBNRDUgaGFzaAorKiBtZmFfa2V5X3Byb3RlY3Rvcl9pbml0OjogICAgICBJ bml0aWFsaXplIHRoZSBNRkEga2V5IHByb3RlY3RvcgorKiBtZmFfa2V5X3Byb3RlY3Rvcl9jbGVh cjo6ICAgICBDbGVhciB0aGUgTUZBIGtleSBwcm90ZWN0b3IKICogbW9kdWxlOjogICAgICAgICAg ICAgICAgICAgICAgTG9hZCBtb2R1bGUgZm9yIG11bHRpYm9vdCBrZXJuZWwKICogbXVsdGlib290 OjogICAgICAgICAgICAgICAgICAgTG9hZCBtdWx0aWJvb3QgY29tcGxpYW50IGtlcm5lbAogKiBu YXRpdmVkaXNrOjogICAgICAgICAgICAgICAgICBTd2l0Y2ggdG8gbmF0aXZlIGRpc2sgZHJpdmVy cwpAQCAtNjcyMSw2ICs2NzI1LDggQEAgeW91IGZvcmdldCBhIGNvbW1hbmQsIHlvdSBjYW4gcnVu IHRoZSBjb21tYW5kIEBjb21tYW5ke2hlbHB9CiAqIHBsYWlubW91bnQ6OiAgICAgICAgICAgICAg ICAgIE9wZW4gZGV2aWNlIGVuY3J5cHRlZCBpbiBwbGFpbiBtb2RlCiAqIHBsYXk6OiAgICAgICAg ICAgICAgICAgICAgICAgIFBsYXkgYSB0dW5lCiAqIHByb2JlOjogICAgICAgICAgICAgICAgICAg ICAgIFJldHJpZXZlIGRldmljZSBpbmZvCisqIHB3X2tleV9wcm90ZWN0b3JfaW5pdDo6ICAgICAg IEluaXRpYWxpemUgdGhlIHBhc3N3b3JkIGtleSBwcm90ZWN0b3IKKyogcHdfa2V5X3Byb3RlY3Rv cl9jbGVhcjo6ICAgICAgQ2xlYXIgdGhlIHBhc3N3b3JkIGtleSBwcm90ZWN0b3IKICogcmRtc3I6 OiAgICAgICAgICAgICAgICAgICAgICAgUmVhZCB2YWx1ZXMgZnJvbSBtb2RlbC1zcGVjaWZpYyBy ZWdpc3RlcnMKICogcmVhZDo6ICAgICAgICAgICAgICAgICAgICAgICAgUmVhZCB1c2VyIGlucHV0 CiAqIHJlYm9vdDo6ICAgICAgICAgICAgICAgICAgICAgIFJlYm9vdCB5b3VyIGNvbXB1dGVyCkBA IC03NTYwLDYgKzc1NjYsNDAgQEAgaGliZXJuYXRlZCBpbWFnZQogQGVuZCBkZWZmbgogCiAKK0Bu b2RlIGZpbGVfa2V5X3Byb3RlY3Rvcl9pbml0CitAc3Vic2VjdGlvbiBmaWxlX2tleV9wcm90ZWN0 b3JfaW5pdAorCitAZGVmZm4gQ29tbWFuZCBmaWxlX2tleV9wcm90ZWN0b3JfaW5pdCBbIEBvcHRp b257LS1rZXktZmlsZX0gfCBAb3B0aW9uey1rfSBAdmFye2ZpbGVfcGF0aH1dWyBAb3B0aW9uey0t a2V5ZmlsZS1vZmZzZXR9IHwgQG9wdGlvbnstT30gQHZhcntvZmZzZXR9XVsgQG9wdGlvbnstLWtl eWZpbGUtc2l6ZX0gfCBAb3B0aW9uey1TfSBAdmFye3NpemV9XQorSW5pdGlhbGl6ZSB0aGUgZmls ZSBrZXkgcHJvdGVjdG9yLgorCitUaGlzIGNvbW1hbmQgY29uZmlndXJlcyB0aGUgZmlsZSBrZXkg cHJvdGVjdG9yLCB3aGljaCBhbGxvd3MgR1JVQiB0byByZWFkIGEKK2NyeXB0b2dyYXBoaWMga2V5 IChvciBhIHBhcnQgb2YgYSBrZXkpIGZyb20gYSBmaWxlIG9uIHRoZSBkaXNrLiBUaGlzIGlzIGNv bW1vbmx5Cit1c2VkIGluIGNvbmp1bmN0aW9uIHdpdGggdGhlIE1GQSBrZXkgcHJvdGVjdG9yIEB4 cmVme01GQSBrZXkgcHJvdGVjdG9yfSBvciBmb3IKK2F1dG9tYXRpYyBkaXNrIHVubG9ja2luZyB2 aWEgYSBrZXkgZmlsZS4KKworVGhlIEBvcHRpb257LWt9IG9wdGlvbiBzcGVjaWZpZXMgdGhlIHBh dGggdG8gdGhlIGtleSBmaWxlIChAdmFye2ZpbGVfcGF0aH0pLgorVGhlIEBvcHRpb257LU99IG9w dGlvbiBza2lwcyB0aGUgZmlyc3QgQHZhcntvZmZzZXR9IGJ5dGVzIG9mIHRoZSBmaWxlLiBUaGUg a2V5IGRhdGEgaXMKK3JlYWQgc3RhcnRpbmcgZnJvbSB0aGlzIG9mZnNldC4gVGhlIGRlZmF1bHQg aXMgMC4KK1RoZSBAb3B0aW9uey1TfSBvcHRpb24gcmVhZHMgZXhhY3RseSBAdmFye3NpemV9IGJ5 dGVzIG9mIGRhdGEgZnJvbSB0aGUgZmlsZSB0bwordXNlIGFzIHRoZSBrZXkuIElmIHRoaXMgb3B0 aW9uIGlzIG5vdCBzcGVjaWZpZWQsIHRoZSBlbnRpcmUgZmlsZSBpcyB0eXBpY2FsbHkgdXNlZC4K KworRXhhbXBsZToKK0BleGFtcGxlCitmaWxlX2tleV9wcm90ZWN0b3JfaW5pdCAtayAoaGQwLGdw dDEpL2VmaS9ncnViL2tleWZpbGUuYmluIC1PIDUxMiAtUyA2NAorQGVuZCBleGFtcGxlCisKK0lu IHRoaXMgZXhhbXBsZSwgdGhlIGZpbGUga2V5IHByb3RlY3RvciByZWFkcyA2NCBieXRlcyBmcm9t IEBmaWxle2tleWZpbGUuYmlufSwKK3N0YXJ0aW5nIGF0IG9mZnNldCA1MTIuCitAZW5kIGRlZmZu CisKK0Bub2RlIGZpbGVfa2V5X3Byb3RlY3Rvcl9jbGVhcgorQHN1YnNlY3Rpb24gZmlsZV9rZXlf cHJvdGVjdG9yX2NsZWFyCisKK0BkZWZmbiBDb21tYW5kIGZpbGVfa2V5X3Byb3RlY3Rvcl9jbGVh cgorQ2xlYXIgdGhlIGZpbGUga2V5IHByb3RlY3RvciBpZiBwcmV2aW91c2x5IGluaXRpYWxpemVk LgorQGVuZCBkZWZmbgorCisKIEBub2RlIGZ3c2V0dXAKIEBzdWJzZWN0aW9uIGZ3c2V0dXAKIApA QCAtNzg2Myw2ICs3OTAzLDQzIEBAIEFsaWFzIGZvciBAY29kZXtoYXNoc3VtIC0taGFzaCBtZDUg YXJnIEBkb3Rze319LiBTZWUgY29tbWFuZCBAY29tbWFuZHtoYXNoc3VtfQogKEBweHJlZntoYXNo c3VtfSkgZm9yIGZ1bGwgZGVzY3JpcHRpb24uCiBAZW5kIGRlZmZuCiAKK0Bub2RlIG1mYV9rZXlf cHJvdGVjdG9yX2luaXQKK0BzdWJzZWN0aW9uIG1mYV9rZXlfcHJvdGVjdG9yX2luaXQKKworQGRl ZmZuIENvbW1hbmQgbWZhX2tleV9wcm90ZWN0b3JfaW5pdCBbIEBvcHRpb257LS1wcm90ZWN0b3Ix fSB8IEBvcHRpb257LTF9IEB2YXJ7cHJvdGVjdG9yMX1dIFtAb3B0aW9uey0tcHJvdGVjdG9yMn0g fCBAb3B0aW9uey0yfSBAdmFye3Byb3RlY3RvcjJ9XQorSW5pdGlhbGl6ZSB0aGUgTXVsdGktRmFj dG9yIEF1dGhlbnRpY2F0aW9uIChNRkEpIGtleSBwcm90ZWN0b3IuCisKK1RoZSBNRkEga2V5IHBy b3RlY3RvciBwcm92aWRlcyB0d28tZmFjdG9yIGF1dGhlbnRpY2F0aW9uIGZvciB1bmxvY2tpbmcg ZW5jcnlwdGVkCitwYXJ0aXRpb25zIChlLmcuLCBMVUtTKS4gSXQgZG9lcyBub3Qgc3RvcmUgdGhl IGRpc2sga2V5IGl0c2VsZiBidXQgcmVsaWVzIG9uIGEKK3NwbGl0LWtleSBhcmNoaXRlY3R1cmUu IFRoZSBmaW5hbCBkaXNrIGtleSBpcyBkZXJpdmVkIGJ5IGNvbWJpbmluZyBwYXJ0aWFsIGtleXMK K3JldHJpZXZlZCBmcm9tIHR3byBvdGhlciBzcGVjaWZpZWQga2V5IHByb3RlY3RvcnMuCisKK1Ro ZSBvcHRpb25zIEBvcHRpb257LS1wcm90ZWN0b3IxfSAob3IgQG9wdGlvbnstMX0pIGFuZCBAb3B0 aW9uey0tcHJvdGVjdG9yMn0KKyhvciBAb3B0aW9uey0yfSkgc3BlY2lmeSB0aGUgbmFtZXMgb2Yg dGhlIHR3byB1bmRlcmx5aW5nIGtleSBwcm90ZWN0b3JzIHRvIHVzZQorKGZvciBleGFtcGxlLCBA c2FtcHtmaWxlfSBhbmQgQHNhbXB7cGFzc3dvcmR9KS4KKworVGhlIG9yZGVyIG9mIHRoZSBwcm90 ZWN0b3JzIGlzIGNydWNpYWwuIFRoZSBNRkEga2V5IHByb3RlY3RvciByZWNvbnN0cnVjdHMgdGhl CitmaW5hbCBrZXkgYnkgY29uY2F0ZW5hdGluZyB0aGUga2V5IGZyb20gdGhlIGZpcnN0IHByb3Rl Y3RvciAoQHZhcntwcm90ZWN0b3IxfSkKK3dpdGggdGhlIGtleSBmcm9tIHRoZSBzZWNvbmQgcHJv dGVjdG9yIChAdmFye3Byb3RlY3RvcjJ9KS4KKworRXhhbXBsZToKK0BleGFtcGxlCitmaWxlX2tl eV9wcm90ZWN0b3JfaW5pdCAtayAoaGQwLGdwdDEpL2VmaS9ncnViL2tleWZpbGUuYmluCittZmFf a2V5X3Byb3RlY3Rvcl9pbml0IC0xIGZpbGUgLTIgcGFzc3dvcmQKK2NyeXB0b21vdW50IC11IDxV VUlEPiAtUCBtZmEKK0BlbmQgZXhhbXBsZQorCitJbiB0aGlzIGV4YW1wbGUsIHRoZSBmaXJzdCBw YXJ0IG9mIHRoZSBrZXkgaXMgcmVhZCBmcm9tIGEgZmlsZSwgYW5kIHRoZSBzZWNvbmQKK3BhcnQg aXMgcmVxdWVzdGVkIGZyb20gdGhlIHVzZXIgdmlhIGEgcGFzc3dvcmQgcHJvbXB0LgorQGVuZCBk ZWZmbgorCitAbm9kZSBtZmFfa2V5X3Byb3RlY3Rvcl9jbGVhcgorQHN1YnNlY3Rpb24gbWZhX2tl eV9wcm90ZWN0b3JfY2xlYXIKKworQGRlZmZuIENvbW1hbmQgbWZhX2tleV9wcm90ZWN0b3JfY2xl YXIKK0NsZWFyIHRoZSBNRkEga2V5IHByb3RlY3RvciBpZiBwcmV2aW91c2x5IGluaXRpYWxpemVk LgorQGVuZCBkZWZmbgorCiBAbm9kZSBtb2R1bGUKIEBzdWJzZWN0aW9uIG1vZHVsZQogCkBAIC04 MDg2LDYgKzgxNjMsMjggQEAgVGhlIG9wdGlvbiBAb3B0aW9uey0tcGFydC11dWlkfSBpcyBjdXJy ZW50bHkgb25seSBpbXBsZW1lbnRlZCBmb3IgTVNET1MgYW5kIEdQVAogQGVuZCBkZWZmbgogCiAK K0Bub2RlIHB3X2tleV9wcm90ZWN0b3JfaW5pdAorQHN1YnNlY3Rpb24gcHdfa2V5X3Byb3RlY3Rv cl9pbml0CisKK0BkZWZmbiBDb21tYW5kIHB3X2tleV9wcm90ZWN0b3JfaW5pdCBbIEBvcHRpb257 LS1wYXNzd29yZH0gfCBAb3B0aW9uey1wfSBAdmFye3Bhc3N3b3JkfV0KK0luaXRpYWxpemUgdGhl IHBhc3N3b3JkIGtleSBwcm90ZWN0b3IuIFRoaXMgYWxsb3dzIHByb3ZpZGluZyBhIHN0YXRpYwor cGFzc3dvcmQgdG8gdGhlIEBjb21tYW5ke2NyeXB0b21vdW50fSBjb21tYW5kLCBlbmFibGluZyBu b24taW50ZXJhY3RpdmUKK3VubG9ja2luZy4gVGhlIG9wdGlvbiBAb3B0aW9uey0tcGFzc3dvcmR9 IChvciBAb3B0aW9uey1wfSkgc2V0cyB0aGUKK3Bhc3N3b3JkIGluIGNsZWFyIHRleHQuCisKK05P VEU6IEluIGdlbmVyYWwsIHRoZXJlIGlzIG5vIG5lZWQgdG8gaW52b2tlIHRoaXMgY29tbWFuZC4g QnkgZGVmYXVsdCwgdGhlCitwYXNzd29yZCBrZXkgcHJvdGVjdG9yIGlzIGluaXRpYWxpemVkIGlt cGxpY2l0bHkgYW5kIHByb21wdHMgdGhlIHVzZXIgZm9yCitpbnB1dCBpbnRlcmFjdGl2ZWx5Lgor QGVuZCBkZWZmbgorCitAbm9kZSBwd19rZXlfcHJvdGVjdG9yX2NsZWFyCitAc3Vic2VjdGlvbiBw d19rZXlfcHJvdGVjdG9yX2NsZWFyCisKK0BkZWZmbiBDb21tYW5kIHB3X2tleV9wcm90ZWN0b3Jf Y2xlYXIKK0NsZWFyIHRoZSBwYXNzd29yZCBrZXkgcHJvdGVjdG9yIGlmIHByZXZpb3VzbHkgaW5p dGlhbGl6ZWQuCitAZW5kIGRlZmZuCisKKwogQG5vZGUgcmRtc3IKIEBzdWJzZWN0aW9uIHJkbXNy CiAKQEAgLTkyMTgsNiArOTMxNyw3IEBAIGVudmlyb25tZW50IHZhcmlhYmxlcyBhbmQgY29tbWFu ZHMgYXJlIGxpc3RlZCBpbiB0aGUgc2FtZSBvcmRlci4KICogTWVhc3VyZWQgQm9vdDo6ICAgICAg ICAgICAgICAgICAgICAgIE1lYXN1cmluZyBib290IGNvbXBvbmVudHMKICogTG9ja2Rvd246OiAg ICAgICAgICAgICAgICAgICAgICAgICAgIExvY2tkb3duIHdoZW4gYm9vdGluZyBvbiBhIHNlY3Vy ZSBzZXR1cAogKiBUUE0yIGtleSBwcm90ZWN0b3I6OiAgICAgICAgICAgICAgICAgTWFuYWdpbmcg ZGlzayBrZXkgd2l0aCBUUE0yIGtleSBwcm90ZWN0b3IKKyogTUZBIGtleSBwcm90ZWN0b3I6OiAg ICAgICAgICAgICAgICAgIE1hbmFnaW5nIGRpc2sga2V5IHdpdGggTUZBIGtleSBwcm90ZWN0b3IK ICogU2lnbmluZyBjZXJ0aWZpY2F0ZSBhbmQgaGFzaCBmaWxlczo6IENlcnRpZmljYXRlIGFuZCBo YXNoIGZpbGUgc2lnbmluZwogKiBTaWduaW5nIEdSVUIgaXRzZWxmOjogICAgICAgICAgICAgICAg RW5zdXJpbmcgdGhlIGludGVncml0eSBvZiB0aGUgR1JVQiBjb3JlIGltYWdlCiAqIEhhcmRlbmlu Zzo6ICAgICAgICAgICAgICAgICAgICAgICAgICBDb25maWd1cmF0aW9uIGFuZCBjdXN0b21pemF0 aW9uIHRvIG1heGltaXplIHNlY3VyaXR5CkBAIC0xMDAzMCw2ICsxMDEzMCw5NCBAQCB3aGljaCBp bmNyZWFzZXMgdGhlIHJpc2sgb2YgcGFzc3dvcmQgbGVha2FnZSBkdXJpbmcgdGhlIHByb2Nlc3Mu IE1vcmVvdmVyLCB0aGUKIHN1cGVydXNlciBsaXN0IG11c3QgYmUgd2VsbCBtYWludGFpbmVkLCBh bmQgdGhlIHBhc3N3b3JkIHVzZWQgY2Fubm90IGJlCiBzeW5jaHJvbml6ZWQgd2l0aCBMVUtTIGtl eSByb3RhdGlvbi4KIAorQG5vZGUgTUZBIGtleSBwcm90ZWN0b3IKK0BzZWN0aW9uIE11bHRpLUZh Y3RvciBBdXRoZW50aWNhdGlvbiAoTUZBKSBrZXkgcHJvdGVjdG9yCisKK1RoZSBNRkEga2V5IHBy b3RlY3RvciBlbmhhbmNlcyB0aGUgc2VjdXJpdHkgb2YgZW5jcnlwdGVkIHBhcnRpdGlvbnMgKHN1 Y2ggYXMgTFVLUykKK2J5IGVuZm9yY2luZyBhIHNwbGl0LWtleSBhcmNoaXRlY3R1cmUuIFVubGlr ZSBzdGFuZGFyZCBrZXkgcHJvdGVjdG9ycyB0aGF0IHN0b3JlCitvciByZXRyaWV2ZSBhIHNpbmds ZSBzdGF0aWMga2V5LCB0aGUgTUZBIHByb3RlY3RvciBkZXJpdmVzIHRoZSBkaXNrIHVubG9ja2lu ZyBrZXkKK2J5IGNvbWJpbmluZyBwYXJ0aWFsIGtleXMgZnJvbSB0d28gZGlzdGluY3Qgc291cmNl cy4KKworVGhpcyBhcHByb2FjaCBlbnN1cmVzIHRoYXQgYW4gYXR0YWNrZXIgY2Fubm90IHVubG9j ayB0aGUgZW5jcnlwdGVkIGRpc2sgaWYgdGhleQorY29tcHJvbWlzZSBvbmx5IG9uZSBvZiB0aGUg ZmFjdG9ycyAoZm9yIGV4YW1wbGUsIHN0ZWFsaW5nIGEgVVNCIGRyaXZlIHdpdGggYSBrZXkKK2Zp bGUgYnV0IGxhY2tpbmcgdGhlIHBhc3NwaHJhc2UpLgorCitUaGUgTUZBIGtleSBwcm90ZWN0b3Ig YWN0cyBhcyBhIGxvZ2ljIGxheWVyIG9uIHRvcCBvZiBvdGhlciBleGlzdGluZyBrZXkKK3Byb3Rl Y3RvcnMuIEl0IHJlcXVpcmVzIHR3byB1bmRlcmx5aW5nIGtleSBwcm90ZWN0b3JzLCByZWZlcnJl ZCB0byBhcworQHZhcntQcm90ZWN0b3IgMX0gYW5kIEB2YXJ7UHJvdGVjdG9yIDJ9LgorCitAZW51 bWVyYXRlCitAaXRlbQorQHZhcntQcm90ZWN0b3IgMX0gcmV0cmlldmVzIHRoZSBmaXJzdCBzZWdt ZW50IG9mIHRoZSBrZXkgKGUuZy4sIGZyb20gYSBmaWxlKS4KK0BpdGVtCitAdmFye1Byb3RlY3Rv ciAyfSByZXRyaWV2ZXMgdGhlIHNlY29uZCBzZWdtZW50IG9mIHRoZSBrZXkgKGUuZy4sIGZyb20g dXNlciBpbnB1dCkuCitAaXRlbQorVGhlIE1GQSBrZXkgcHJvdGVjdG9yIGNvbmNhdGVuYXRlcyB0 aGVzZSBzZWdtZW50cyB0byByZWNvbnN0cnVjdCB0aGUgZmluYWwgZGlzayBrZXkuCitAZW5kIGVu dW1lcmF0ZQorCitGb3IgYSBjb21wbGV0ZSByZWZlcmVuY2Ugb24gdGhlIGNvbW1hbmQgc3ludGF4 IGFuZCBvcHRpb25zLCBwbGVhc2Ugc2VlCitAcmVme21mYV9rZXlfcHJvdGVjdG9yX2luaXR9Lgor CitAc3Vic2VjdGlvbiBFeGFtcGxlIFdvcmtmbG93CisKK0hlcmUgYXJlIHRoZSBzYW1wbGUgY29t bWFuZHMgdG8gY3JlYXRlIGEgTFVLUyBrZXkgKEBmaWxle2x1a3Mua2V5fSkgYnkKK2NvbmNhdGVu YXRpbmcgYSA2NC1ieXRlIHJhbmRvbSBmaWxlIChAZmlsZXtrZXlmaWxlLmJpbn0pIGFuZCBhIHVz ZXIKK3Bhc3NwaHJhc2UgYW5kIGVucm9sbCB0aGUga2V5IGludG8gdGhlIHRhcmdldCBwYXJ0aXRp b24gKHNkYTIpLgorCitAZXhhbXBsZQorIyBHZW5lcmF0ZSB0aGUgcmFuZG9tIGtleSBmaWxlCitA a2Jke2RkIGlmPS9kZXYvcmFuZG9tIG9mPWtleWZpbGUuYmluIGJzPTEgY291bnQ9NjR9CisKKyMg Q29tYmluZSB0aGUga2V5IGZpbGUgYW5kIHRoZSB1c2VyIHBhc3N3b3JkCitAa2Jke2NwIGtleWZp bGUuYmluIGx1a3Mua2V5fQorQGtiZHtyZWFkIC1wICJwYXNzd29yZCA6IiAtcyBwYXNzd29yZCAm JiBwcmludGYgIiVzIiAiJHBhc3N3b3JkIiA+PiBsdWtzLmtleSB9CisKKyMgRW5yb2xsIHRoZSBj b21iaW5lZCBrZXkgaW50byBMVUtTCitAa2Jke2NyeXB0c2V0dXAgbHVrc0FkZEtleSAvZGV2L3Nk YTIgbHVrcy5rZXl9CitAZW5kIGV4YW1wbGUKKworVG8gdW5sb2NrIHRoZSBwYXJ0aXRpb24sIHRo ZSB1bmRlcmx5aW5nIGtleSBwcm90ZWN0b3JzIG11c3QgYmUgaW5pdGlhbGl6ZWQKK2ZpcnN0LiBU aGUgQGNvbW1hbmR7ZmlsZV9rZXlfcHJvdGVjdG9yX2luaXR9IGNvbW1hbmQgY29uZmlndXJlcyB0 aGUgZmlsZQorcHJvdGVjdG9yIGJ5IHNwZWNpZnlpbmcgdGhlIHBhdGggdG8gdGhlIGtleSBmaWxl IChAZmlsZXtrZXlmaWxlLmJpbn0pLiBOb3RlCit0aGF0IHRoZSBwYXNzd29yZCBrZXkgcHJvdGVj dG9yIGlzIGluaXRpYWxpemVkIGltcGxpY2l0bHkgYW5kIHJlcXVpcmVzIG5vCitzcGVjaWZpYyBz ZXR1cCBjb21tYW5kLgorCitPbmNlIGNvbmZpZ3VyZWQsIHVzZSBAY29tbWFuZHttZmFfa2V5X3By b3RlY3Rvcl9pbml0fSB0byBkZWZpbmUgdGhlIG9yZGVyIG9mCit0aGUgZmFjdG9ycy4gRmluYWxs eSwgd2hlbiBAY29tbWFuZHtjcnlwdG9tb3VudH0gaXMgaW52b2tlZCB3aXRoIEBvcHRpb257LVAg bWZhfSwKK0dSVUIgcmV0cmlldmVzIHRoZSBrZXkgZmlsZSAoRmFjdG9yIDEpIGFuZCBwcm9tcHRz IHRoZSB1c2VyIGZvciB0aGUKK3Bhc3NwaHJhc2UgKEZhY3RvciAyKS4KKworQGV4YW1wbGUKK2dy dWI+IEBrYmR7ZmlsZV9rZXlfcHJvdGVjdG9yX2luaXQgLWsgKGhkMCxncHQxKS9lZmkvZ3J1Yi9r ZXlmaWxlLmJpbn0KK2dydWI+IEBrYmR7bWZhX2tleV9wcm90ZWN0b3JfaW5pdCAtMSBmaWxlIC0y IHBhc3N3b3JkfQorZ3J1Yj4gQGtiZHtjcnlwdG9tb3VudCAtdSA8VVVJRD4gLVAgbWZhfQorQGVu ZCBleGFtcGxlCisKK0FsdGVybmF0aXZlbHksIHRoZSBrZXkgZmlsZSAoQGZpbGV7a2V5ZmlsZS5i aW59KSBjYW4gYmUgc2VhbGVkIHdpdGggdGhlIFRQTQordG8gZW5oYW5jZSBzZWN1cml0eS4KKwor QGV4YW1wbGUKK0Bncm91cAorQGtiZHtncnViLXByb3RlY3QgLS1hY3Rpb249YWRkIFwKKyAgICAg ICAgICAgICAtLXByb3RlY3Rvcj10cG0yIFwKKyAgICAgICAgICAgICAtLXRwbTItcGNycz0wLDIs NCw3IFwKKyAgICAgICAgICAgICAtLXRwbTJrZXkgXAorICAgICAgICAgICAgIC0tdHBtMi1rZXlm aWxlPWtleWZpbGUuYmluIFwKKyAgICAgICAgICAgICAtLXRwbTItb3V0ZmlsZT0vYm9vdC9lZmkv ZWZpL2dydWIvc2VhbGVkLnRwbX0KK0BlbmQgZ3JvdXAKK0BlbmQgZXhhbXBsZQorCitJbiB0aGlz IHNjZW5hcmlvLCB0aGUgTUZBIGtleSBwcm90ZWN0b3IgaXMgY29uZmlndXJlZCB0byByZXRyaWV2 ZSB0aGUgZmlyc3QKK2tleSBzZWdtZW50IGZyb20gdGhlIHRwbTIga2V5IHByb3RlY3RvciBhbmQg dGhlIHNlY29uZCBmcm9tIHRoZSBwYXNzd29yZCBrZXkKK3Byb3RlY3Rvci4KKworQGV4YW1wbGUK K2dydWI+IEBrYmR7dHBtMl9rZXlfcHJvdGVjdG9yX2luaXQgLVQgKGhkMCxncHQxKS9lZmkvZ3J1 Yi9zZWFsZWQudHBtfQorZ3J1Yj4gQGtiZHttZmFfa2V5X3Byb3RlY3Rvcl9pbml0IC0xIHRwbTIg LTIgcGFzc3dvcmR9CitncnViPiBAa2Jke2NyeXB0b21vdW50IC11IDxVVUlEPiAtUCBtZmF9CitA ZW5kIGV4YW1wbGUKKworCiBAbm9kZSBTaWduaW5nIGNlcnRpZmljYXRlIGFuZCBoYXNoIGZpbGVz CiBAc2VjdGlvbiBTaWduaW5nIGNlcnRpZmljYXRlIGFuZCBoYXNoIGZpbGVzCiBYLjUwOSBjZXJ0 aWZpY2F0ZSAocHVibGljIGtleSkgZmlsZXMgYW5kIGhhc2ggZmlsZXMgKGJpbmFyeS9jZXJ0aWZp Y2F0ZSBoYXNoIGZpbGVzKQotLSAKMi41MS4wCgoKX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX18KR3J1Yi1kZXZlbCBtYWlsaW5nIGxpc3QKR3J1Yi1kZXZlbEBn bnUub3JnCmh0dHBzOi8vbGlzdHMuZ251Lm9yZy9tYWlsbWFuL2xpc3RpbmZvL2dydWItZGV2ZWwK