Inaccuracy/typo in pbs docs.

sgp

New Member
Oct 9, 2024
7
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