blob: b7aa61f589cb24256dd2e5e29e4aaea3a7d6d5da [file] [log] [blame]
Davide Pesavento36651f12023-01-02 17:07:21 -05001PSync: Partial/Full Sync Library based on BF and IBF
2====================================================
3
4.. toctree::
5 :hidden:
6 :maxdepth: 2
7
8 install
9 examples
10 release-notes
11 releases
Ashlesh Gawande465d1492019-01-10 15:12:01 -060012
Davide Pesavento51189592021-10-02 22:34:34 -040013PSync is a C++ library for name synchronization that implements the `PSync protocol
14<https://named-data.net/wp-content/uploads/2017/05/scalable_name-based_data_synchronization.pdf>`__.
15It uses Invertible Bloom Lookup Table (IBLT), also known as Invertible Bloom Filter (IBF),
16to represent the state of a producer in partial sync mode and the state of a node in full
17sync mode. An IBF is a compact data structure where difference of two IBFs can be computed
18efficiently. In partial sync, PSync uses a Bloom Filter to represent the subscription of
19list of the consumer.
Ashlesh Gawande465d1492019-01-10 15:12:01 -060020
Davide Pesavento51189592021-10-02 22:34:34 -040021PSync uses the `ndn-cxx <https://github.com/named-data/ndn-cxx>`__ library.
Ashlesh Gawande465d1492019-01-10 15:12:01 -060022
Davide Pesavento36651f12023-01-02 17:07:21 -050023Documentation
24-------------
25
26- :doc:`install`
27- :doc:`examples`
28- :doc:`release-notes`
29- :doc:`releases`
30
Davide Pesavento51189592021-10-02 22:34:34 -040031Contributing
32------------
Ashlesh Gawande465d1492019-01-10 15:12:01 -060033
Davide Pesavento51189592021-10-02 22:34:34 -040034We greatly appreciate contributions to the PSync code base, provided that they are
Davide Pesavento36651f12023-01-02 17:07:21 -050035licensed under the GNU LGPL version 3 or a compatible license (see `COPYING.md
Davide Pesavento51189592021-10-02 22:34:34 -040036<https://github.com/named-data/PSync/blob/master/COPYING.md>`__ for more information).
Davide Pesavento36651f12023-01-02 17:07:21 -050037If you are new to the NDN software community, please read our `Contributor's Guide
Davide Pesavento51189592021-10-02 22:34:34 -040038<https://github.com/named-data/.github/blob/master/CONTRIBUTING.md>`__ to get started.
39
40Please submit any bug reports or feature requests to the `PSync issue tracker
41<https://redmine.named-data.net/projects/psync/issues>`__.