.. _module-pw_async2-backends:

========
Backends
========
The :ref:`pw_async2 interface <module-pw_async2-reference>` must be fulfilled
by a concrete implementation. You can use one of the Pigweed-provided backends
listed below or roll your own. If you roll your own, please consider
:ref:`contributing <docs-get-started-upstream>` it to upstream Pigweed!

.. _epoll: https://man7.org/linux/man-pages/man7/epoll.7.html

* :ref:`module-pw_async2_basic`. A backend that uses a thread-notification-based
  :cpp:class:`pw::async2::Dispatcher`.
* :ref:`module-pw_async2_epoll`. A backend that uses a :cpp:class:`pw::async2::Dispatcher`
  backed by Linux's `epoll`_ notification system.

.. toctree::
   :maxdepth: 1
   :hidden:

   Basic <../pw_async2_basic/docs>
   Linux epoll <../pw_async2_epoll/docs>