Diffstat (limited to 'doc/guides/prog_guide/stack_lib.rst')
1 files changed, 28 insertions, 0 deletions
diff --git a/doc/guides/prog_guide/stack_lib.rst b/doc/guides/prog_guide/stack_lib.rst
new file mode 100644
@@ -0,0 +1,28 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2019 Intel Corporation.
+DPDK's stack library provides an API for configuration and use of a bounded
+stack of pointers.
+The stack library provides the following basic operations:
+* Create a uniquely named stack of a user-specified size and using a
+ user-specified socket.
+* Push and pop a burst of one or more stack objects (pointers). These function
+ are multi-threading safe.
+* Free a previously created stack.
+* Lookup a pointer to a stack by its name.
+* Query a stack's current depth and number of free entries.
+The stack consists of a contiguous array of pointers, a current index, and a
+spinlock. Accesses to the stack are made multi-thread safe by the spinlock.