From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 300C26C17E for ; Wed, 22 Sep 2021 07:47:52 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 1540B154CE for ; Wed, 22 Sep 2021 07:47:52 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 0A749154BF for ; Wed, 22 Sep 2021 07:47:50 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 9EE0D4459F for ; Wed, 22 Sep 2021 07:47:50 +0200 (CEST) Message-ID: Date: Wed, 22 Sep 2021 07:47:00 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:93.0) Gecko/20100101 Thunderbird/93.0 Content-Language: en-US To: Proxmox Backup Server development discussion , Hannes Laimer References: <20210920091839.12252-1-h.laimer@proxmox.com> From: Thomas Lamprecht In-Reply-To: <20210920091839.12252-1-h.laimer@proxmox.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.252 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pbs-devel] applied: [PATCH proxmox-backup] docs/technical-overview: add troubleshooting section X-BeenThere: pbs-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Backup Server development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Sep 2021 05:47:52 -0000 On 20.09.21 11:18, Hannes Laimer wrote: > --- > docs/technical-overview.rst | 58 +++++++++++++++++++++++++++++++++++++ > 1 file changed, 58 insertions(+) > > applied, thanks! I reformated the text and adapted it also a bit wording/grammar wise, but it'd be great if Dylan could take another look. I also changed thew use of relative paths in the examples to absolute ones with some meaning encoded, IMO that is easier for a non-involved user to understand what's going on. In the recovery example I tried to convey that skip-crc is also useful for trying to restore partially corrupted files. There it'd be still good to add a sentence to where the files will be restored too, as those are rather big and thus it may be relevant to know and maybe even have an optional param for that (if not already there?) Also, while reading over this I though again that a `diff` command would be interesting, i.e., one that allows to pass two snapshots and outputs the amount of differing chunks (or even the full list + positions with a --verbose option).