CERBERUS/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty.git synced 2026-05-13 08:26:56 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Improve machine id docs formatting

Browse source
This commit is contained in:
Kovid Goyal 2026-04-12 12:46:49 +05:30
parent f81111245e
commit 916173dcb3
No known key found for this signature in database
GPG key ID: 06BC317B515ACE7C
1 changed files with 21 additions and 8 deletions
Download patch file Download diff file Expand all files Collapse all files

29
docs/dnd-protocol.rst
View file

@ -484,14 +484,27 @@ Machine id
The machine id is used to detect when the source and destination machines for a
drag and drop are different. It is of the form: ``version:ASCII printable
chars``. The leading ``version`` field allows for changing the format or
semantics of this field in the future. The actual id is the machine id (the
contents of :file:`/etc/machine-id` with trailing whitespace removed on Linux/BSD and
:file:`HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography\\MachineGuid` on
Windows and ``IOPlatformUUID`` on macOS). This machine id is then hashed using
a :rfc:`HMAC <2104>` with :rfc:`SHA-256 <6234>` as the digest algorithm and the
key being the ASCII bytes: ``tty-dnd-protocol-machine-id``. The hashing is done
so as to not easily leak the actual machine id and to ensure that the value is
of fixed size. This gives a final value of::
semantics of this field in the future. The actual id is the machine id which
is:
.. tab:: macOS
The value returned by the ``IOPlatformUUID`` system function.
.. tab:: Windows
The contents of the :file:`HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Cryptography\\MachineGuid`
registry key.
.. tab:: Other
The contents of the :file:`/etc/machine-id` file with trailing whitespace removed
This machine id is then hashed using a :rfc:`HMAC <2104>` with :rfc:`SHA-256
<6234>` as the digest algorithm and the key being the ASCII bytes:
``tty-dnd-protocol-machine-id``. The hashing is done so as to not easily leak
the actual machine id and to ensure that the value is of fixed size and
consisting only of ASCII printable characters. This gives a final value of::
1:hashed machine id hexadecimal encoded