Inaccuracy/typo in pbs docs.

sgp

New Member
Oct 9, 2024
6
0
1
I didn't find a feedback form in the docs so I've decided to create this thread.

In the https://pbs.proxmox.com/docs/technical-overview.html#chunks there is such text:

Code:
This chunk directory is further subdivided by the first four bytes of the chunk's checksum, so a chunk with the checksum

a342e8151cbf439ce65f3df696b54c67a114982cc0aa751f2852c2f7acc19a8b

lives in

<datastore-root>/.chunks/a342/

Aiui, a342 are not 4 bytes because they are not 4 regular (8-bit) characters; they are 4 hexadecimal digits. Thus, a342 is only 2 bytes.
If you asked me, "first four bytes" should be changed to "first two bytes (represented by four hexadecimal digits)", but that looks kinda clumsy.
 
Well, this quite a bit of a nitpick. :) It's ASCII encoded hexadecimal representation of the binary hash, especially the prefix as it becomes a directory name is then 4 ASCII chars. Anyhow, there's BZ [1] with Documentation category for this exactly.

[1] https://bugzilla.proxmox.com/
 
  • Like
Reactions: sgp
  • Like
Reactions: sgp

About

The Proxmox community has been around for many years and offers help and support for Proxmox VE, Proxmox Backup Server, and Proxmox Mail Gateway.
We think our community is one of the best thanks to people like you!

Get your subscription!

The Proxmox team works very hard to make sure you are running the best software and getting stable updates and security enhancements, as well as quick enterprise support. Tens of thousands of happy customers have a Proxmox subscription. Get yours easily in our online shop.

Buy now!