Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs about slow msgpack when using the binary (1.4) #8615

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/binaries/00_README.txt
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,10 @@ platforms).

Reporting issues
----------------
If you find issues, please open a ticket on our issue tracker:

Please first check the FAQ and whether a github issue already exists.

If you find a NEW issue, please open a ticket on our issue tracker:

https://github.com/borgbackup/borg/issues/

Expand Down
26 changes: 26 additions & 0 deletions docs/faq.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1035,6 +1035,32 @@ A workaround is to set the option ``--files-cache=ctime,size`` to exclude the in
number comparison from the files cache check so that files with different inode
numbers won't be treated as modified.

Using a pure-python msgpack! This will result in lower performance.
-------------------------------------------------------------------

borg uses `msgpack` to serialize/deserialize data.

`msgpack` has 2 implementations:

- a fast one (C code compiled into a platform specific binary), and
- a slow pure-python one.

The slow one is used if it can't successfully import the fast one.

If you use the pyinstaller-made borg "fat binary" which we offer on github
releases, it could be that you downloaded a binary that does not match the
(g)libc on your system.

Binaries made for an older glibc than the one you have on your system usually
just work, but the opposite is not necessarily the case and can lead to misc.
issues - like failing to load the fast msgpack code or not working at all.

So: try a binary made for an older glibc.

If you see this without using a "fat binary" from us, it usually means that
msgpack is not built / installed correctly. It could be also that the platform
is not fully supported (so the python code works, but there is no fast binary
code).

Is there a way to limit bandwidth with Borg?
--------------------------------------------
Expand Down
Loading