libnfb-ext-python 0.1.0__tar.gz → 0.1.1__tar.gz

libnfb_ext_python-0.1.1/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2003-2022 CESNET
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

libnfb_ext_python-0.1.1/MANIFEST.in

@@ -0,0 +1,3 @@
+# Include Cython source and C headers in sdist
+recursive-include nfb/ext/python *.pyx *.pxd *.h *.c
+include readme.rst LICENSE

libnfb_ext_python-0.1.1/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: libnfb-ext-python
+Version: 0.1.1
+Summary: Python extension for libnfb — implement NFB device backends in Python
+Author: Martin Spinler
+Author-email: Martin Spinler <spinler@cesnet.cz>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/CESNET/ndk-sw
+Project-URL: Documentation, https://cesnet.github.io/ndk-sw/
+Project-URL: Repository, https://github.com/CESNET/ndk-sw
+Project-URL: Bug Tracker, https://github.com/CESNET/ndk-sw/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Cython
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: fdt
+Requires-Dist: nfb
+Dynamic: author
+Dynamic: license-file
+
+Installation
+------------
+
+libnfb_ext_python package requires nfb package for build.
+The wanted nfb package is probably not available in ordinary way, so
+local (venv) installation via pip can be done for example like this:
+
+# current directory is root of this git repository
+$ pip wheel -w ./localwhldir ./pynfb/
+$ pip install --find-links ./localwhldir ./ext/libnfb_ext_python/

libnfb_ext_python-0.1.1/libnfb_ext_python.egg-info/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.4
+Name: libnfb-ext-python
+Version: 0.1.1
+Summary: Python extension for libnfb — implement NFB device backends in Python
+Author: Martin Spinler
+Author-email: Martin Spinler <spinler@cesnet.cz>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/CESNET/ndk-sw
+Project-URL: Documentation, https://cesnet.github.io/ndk-sw/
+Project-URL: Repository, https://github.com/CESNET/ndk-sw
+Project-URL: Bug Tracker, https://github.com/CESNET/ndk-sw/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Cython
+Classifier: Topic :: System :: Hardware
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.8
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Requires-Dist: fdt
+Requires-Dist: nfb
+Dynamic: author
+Dynamic: license-file
+
+Installation
+------------
+
+libnfb_ext_python package requires nfb package for build.
+The wanted nfb package is probably not available in ordinary way, so
+local (venv) installation via pip can be done for example like this:
+
+# current directory is root of this git repository
+$ pip wheel -w ./localwhldir ./pynfb/
+$ pip install --find-links ./localwhldir ./ext/libnfb_ext_python/

{libnfb_ext_python-0.1.0 → libnfb_ext_python-0.1.1}/libnfb_ext_python.egg-info/SOURCES.txt

@@ -1,4 +1,7 @@
+LICENSE
+MANIFEST.in
 pyproject.toml
+readme.rst
 setup.py
 libnfb_ext_python.egg-info/PKG-INFO
 libnfb_ext_python.egg-info/SOURCES.txt
@@ -7,4 +10,8 @@ libnfb_ext_python.egg-info/requires.txt
 libnfb_ext_python.egg-info/top_level.txt
 nfb/ext/python/__init__.py
 nfb/ext/python/ext_entry.c
-nfb/ext/python/shim.c
+nfb/ext/python/shim.c
+nfb/ext/python/shim.h
+nfb/ext/python/shim.pxd
+nfb/ext/python/shim.pyx
+nfb/ext/python/shim_api.h

{libnfb_ext_python-0.1.0 → libnfb_ext_python-0.1.1}/libnfb_ext_python.egg-info/requires.txt

@@ -1 +1,2 @@
 fdt
+nfb

libnfb_ext_python-0.1.1/nfb/ext/python/shim.h

@@ -0,0 +1,70 @@
+/* Generated by Cython 3.2.5 */
+
+#ifndef __PYX_HAVE__shim
+#define __PYX_HAVE__shim
+
+#include "Python.h"
+
+#ifndef __PYX_HAVE_API__shim
+
+#ifdef CYTHON_EXTERN_C
+    #undef __PYX_EXTERN_C
+    #define __PYX_EXTERN_C CYTHON_EXTERN_C
+#elif defined(__PYX_EXTERN_C)
+    #ifdef _MSC_VER
+    #pragma message ("Please do not define the '__PYX_EXTERN_C' macro externally. Use 'CYTHON_EXTERN_C' instead.")
+    #else
+    #warning Please do not define the '__PYX_EXTERN_C' macro externally. Use 'CYTHON_EXTERN_C' instead.
+    #endif
+#else
+  #ifdef __cplusplus
+    #define __PYX_EXTERN_C extern "C"
+  #else
+    #define __PYX_EXTERN_C extern
+  #endif
+#endif
+
+#ifndef DL_IMPORT
+  #define DL_IMPORT(_T) _T
+#endif
+
+__PYX_EXTERN_C int pynfb_ext_get_ops(char const *, struct libnfb_ext_ops *);
+__PYX_EXTERN_C int nfb_ext_python_open(char const *, int, void **, void **);
+__PYX_EXTERN_C void nfb_ext_python_close(void *);
+__PYX_EXTERN_C int nfb_pynfb_bus_open(void *, int, int, void **, struct libnfb_bus_ext_ops *);
+__PYX_EXTERN_C void nfb_pynfb_bus_close(void *);
+__PYX_EXTERN_C Py_ssize_t nfb_pynfb_bus_read(void *, void *, size_t, off_t);
+__PYX_EXTERN_C Py_ssize_t nfb_pynfb_bus_write(void *, void const *, size_t, off_t);
+__PYX_EXTERN_C int nfb_pyndp_queue_open(struct nfb_device *, void *, unsigned int, int, int, struct ndp_queue **);
+__PYX_EXTERN_C int nfb_pyndp_queue_close(struct ndp_queue *);
+__PYX_EXTERN_C int pyndp_start(void *);
+__PYX_EXTERN_C int pyndp_stop(void *);
+__PYX_EXTERN_C unsigned int pyndp_rx_burst_get(void *, struct ndp_packet *, unsigned int);
+__PYX_EXTERN_C int pyndp_rx_burst_put(void *);
+__PYX_EXTERN_C unsigned int pyndp_tx_burst_get(void *, struct ndp_packet *, unsigned int);
+__PYX_EXTERN_C int pyndp_tx_burst_put(void *);
+__PYX_EXTERN_C int pyndp_tx_burst_flush(void *);
+
+#endif /* !__PYX_HAVE_API__shim */
+
+/* WARNING: the interface of the module init function changed in CPython 3.5. */
+/* It now returns a PyModuleDef instance instead of a PyModule instance. */
+
+/* WARNING: Use PyImport_AppendInittab("shim", PyInit_shim) instead of calling PyInit_shim directly from Python 3.5 */
+PyMODINIT_FUNC PyInit_shim(void);
+
+#if PY_VERSION_HEX >= 0x03050000 && (defined(__GNUC__) || defined(__clang__) || defined(_MSC_VER) || (defined(__cplusplus) && __cplusplus >= 201402L))
+#if defined(__cplusplus) && __cplusplus >= 201402L
+[[deprecated("Use PyImport_AppendInittab(\"shim\", PyInit_shim) instead of calling PyInit_shim directly.")]] inline
+#elif defined(__GNUC__) || defined(__clang__)
+__attribute__ ((__deprecated__("Use PyImport_AppendInittab(\"shim\", PyInit_shim) instead of calling PyInit_shim directly."), __unused__)) __inline__
+#elif defined(_MSC_VER)
+__declspec(deprecated("Use PyImport_AppendInittab(\"shim\", PyInit_shim) instead of calling PyInit_shim directly.")) __inline
+#endif
+static PyObject* __PYX_WARN_IF_PyInit_shim_INIT_CALLED(PyObject* res) {
+  return res;
+}
+#define PyInit_shim() __PYX_WARN_IF_PyInit_shim_INIT_CALLED(PyInit_shim())
+#endif
+
+#endif /* !__PYX_HAVE__shim */

libnfb_ext_python-0.1.1/nfb/ext/python/shim.pxd

@@ -0,0 +1,121 @@
+from posix.types cimport off_t
+
+from libc.stdint cimport uint8_t, uint16_t, uint32_t, uint64_t
+from libc.stdlib cimport malloc, strtoull, free
+from libc.string cimport strlen, memcpy, strncmp
+
+from cpython.ref cimport PyObject, Py_INCREF, Py_DECREF
+
+from libc.stdio cimport printf
+cimport libc.errno
+
+
+cdef extern from "<libfdt.h>":
+    int fdt_get_path(const void *fdt, int nodeoffset, char *buf, int buflen)
+
+cdef extern from "<nfb/ndp.h>":
+    cdef struct nfb_device:
+        pass
+
+    cdef struct nfb_comp:
+        pass
+
+    cdef struct ndp_packet:
+        unsigned char *data
+        unsigned char *header
+        unsigned data_length
+        unsigned header_length
+        uint16_t flags
+
+    cdef struct ndp_queue:
+        pass
+
+cdef extern from "<nfb/ext.h>":
+    ctypedef ssize_t nfb_bus_read_func(void *p, void *buf, size_t nbyte, off_t offset)
+    ctypedef ssize_t nfb_bus_write_func(void *p, const void *buf, size_t nbyte, off_t offset)
+
+    ctypedef int libnfb_ext_ops_open(const char *devname, int oflag, void **priv, void **fdt)
+    ctypedef void libnfb_ext_ops_close(void *priv)
+    ctypedef int libnfb_ext_ops_bus_open_mi(void *dev_priv, int bus_node, int comp_node, void ** bus_priv, libnfb_bus_ext_ops* ops)
+    ctypedef void libnfb_ext_ops_bus_close_mi(void *bus_priv)
+    ctypedef int libnfb_ext_ops_comp_lock(const nfb_comp *comp, uint32_t features)
+    ctypedef void libnfb_ext_ops_comp_unlock(const nfb_comp *comp, uint32_t features)
+
+    ctypedef int libnfb_ext_ops_ndp_queue_open(nfb_device *dev, void *dev_priv, unsigned index, int dir, int flags, ndp_queue ** pq)
+    ctypedef int libnfb_ext_ops_ndp_queue_close(ndp_queue *q)
+
+    ctypedef unsigned ndp_rx_burst_get_t(void *priv, ndp_packet *packets, unsigned count)
+    ctypedef int ndp_rx_burst_put_t(void *priv)
+
+    ctypedef unsigned ndp_tx_burst_get_t(void *priv, ndp_packet *packets, unsigned count)
+    ctypedef int ndp_tx_burst_put_t(void *priv)
+    ctypedef int ndp_tx_burst_flush_t(void *priv)
+
+    struct libnfb_ext_ops:
+        libnfb_ext_ops_open open
+        libnfb_ext_ops_close close
+        libnfb_ext_ops_bus_open_mi bus_open_mi
+        libnfb_ext_ops_bus_close_mi bus_close_mi
+        libnfb_ext_ops_comp_lock comp_lock
+        libnfb_ext_ops_comp_unlock comp_unlock
+
+        libnfb_ext_ops_ndp_queue_open ndp_queue_open
+        libnfb_ext_ops_ndp_queue_close ndp_queue_close
+
+    cdef struct libnfb_bus_ext_ops:
+        nfb_bus_read_func *read
+        nfb_bus_write_func *write
+
+    ctypedef struct ndp_queue_ops_burst_tx:
+        ndp_tx_burst_get_t get
+        ndp_tx_burst_put_t put
+        ndp_tx_burst_flush_t flush
+    ctypedef struct ndp_queue_ops_burst_rx:
+        ndp_rx_burst_get_t get
+        ndp_rx_burst_put_t put
+
+    ctypedef union ndp_queue_ops_burst:
+        ndp_queue_ops_burst_rx rx
+        ndp_queue_ops_burst_tx tx
+
+    ctypedef struct ndp_queue_ops_control:
+        int (*start)(void *priv)
+        int (*stop)(void *priv)
+
+    cdef struct ndp_queue_ops:
+        ndp_queue_ops_burst burst
+        ndp_queue_ops_control control
+
+    cdef ndp_queue * ndp_queue_create(nfb_device *dev, int numa, int type, int index)
+    cdef void ndp_queue_destroy(ndp_queue* q)
+
+    cdef void* ndp_queue_get_priv(ndp_queue *q)
+    cdef void ndp_queue_set_priv(ndp_queue *q, void *priv)
+
+    cdef ndp_queue_ops* ndp_queue_get_ops(ndp_queue *q)
+
+
+cdef public api:
+    int pynfb_ext_get_ops(const char *devname, libnfb_ext_ops* ops) noexcept
+
+    int nfb_ext_python_open(const char *devname, int oflag, void **priv, void **fdt) noexcept with gil
+    void nfb_ext_python_close(void *priv) noexcept with gil
+
+    int nfb_pynfb_bus_open(void *dev_priv, int bus_node, int comp_node, void ** bus_priv, libnfb_bus_ext_ops* ops) noexcept with gil
+    void nfb_pynfb_bus_close(void *bus_priv) noexcept with gil
+
+    ssize_t nfb_pynfb_bus_read(void *bus_priv, void *buf, size_t nbyte, off_t offset) noexcept with gil
+    ssize_t nfb_pynfb_bus_write(void *bus_priv, const void *buf, size_t nbyte, off_t offset) noexcept with gil
+
+    cdef int nfb_pyndp_queue_open(nfb_device *dev, void *dev_priv, unsigned index, int dir, int flags, ndp_queue ** pq) noexcept with gil
+    cdef int nfb_pyndp_queue_close(ndp_queue *q) noexcept with gil
+
+    cdef int pyndp_start(void *priv) with gil
+    cdef int pyndp_stop(void *priv) with gil
+
+    cdef unsigned pyndp_rx_burst_get(void *priv, ndp_packet *packets, unsigned count) with gil
+    cdef int pyndp_rx_burst_put(void *priv) with gil
+
+    cdef unsigned pyndp_tx_burst_get(void *priv, ndp_packet *packets, unsigned count) with gil
+    cdef int pyndp_tx_burst_put(void *priv) with gil
+    cdef int pyndp_tx_burst_flush(void *priv) with gil

libnfb_ext_python-0.1.1/nfb/ext/python/shim.pyx

@@ -0,0 +1,272 @@
+cdef api const char *libnfb_ext_compatible_pattern = "libnfb-ext-compat_pattern:"
+
+def get_libnfb_ext_path(nfb):
+    # early version of libnfb relies on a pattern "libnfb-ext-" somewhere in device string/path
+    base = __file__ + ":" + libnfb_ext_compatible_pattern.decode()
+    # new extension identification string must have a "libnfb-ext:" prefix (backward incompatible)
+    #base = "libnfb-ext:" + __file__ + ":"
+    return base + str(id(nfb))
+
+cdef class __NfbWrapper:
+    cdef char * fdt
+    cdef object nfb
+    cdef list bus
+
+cdef int nfb_ext_python_open(const char *devname, int oflag, void **priv, void **fdt) noexcept with gil:
+    cdef int ret
+    cdef uint64_t addr
+    cdef object nfb
+    cdef bytes dtb
+    cdef PyObject* _nfb
+    cdef __NfbWrapper wrap
+
+    addr = strtoull(devname + strlen(libnfb_ext_compatible_pattern), NULL, 10)
+    _nfb = <PyObject*> <void*> addr
+    nfb = <object> _nfb
+
+    wrap = __NfbWrapper()
+    Py_INCREF(wrap)
+    wrap.nfb = <object> _nfb
+
+    dtb = nfb._nfb_ext_python_dtb
+    ret = len(dtb)
+
+    wrap.fdt = <char*> malloc(ret)
+    if wrap.fdt == NULL:
+        Py_DECREF(wrap)
+        return -libc.errno.ENOMEM
+
+    memcpy(wrap.fdt, <const char*>dtb, ret)
+
+    fdt[0] = wrap.fdt
+    priv[0] = <void*><PyObject*> wrap
+
+    return 0
+
+cdef void nfb_ext_python_close(void *priv) noexcept with gil:
+    cdef PyObject* _wrap
+    cdef __NfbWrapper wrap
+    cdef object nfb
+    cdef bytes dtb
+
+    _wrap = <PyObject*> priv
+    wrap = <object> _wrap
+
+    # The libnfb is responsible for freeing fdt
+    #free(wrap.fdt)
+    Py_DECREF(wrap)
+
+cdef ssize_t nfb_pynfb_bus_read(void *p, void *buf, size_t nbyte, off_t offset) noexcept with gil:
+    cdef PyObject* _bus = <PyObject *> p
+    cdef object bus = <object> _bus
+    cdef bytes data
+    cdef ssize_t ret
+
+    nfb, comp_node, bus_node = bus
+    data = nfb.read(bus_node, comp_node, offset, nbyte)
+    ret = len(data)
+    if ret > int(nbyte):
+        ret = -1
+
+    if ret > 0:
+        memcpy(buf, <const char*>data, ret)
+
+    return ret
+
+cdef ssize_t nfb_pynfb_bus_write(void *p, const void *buf, size_t nbyte, off_t offset) noexcept with gil:
+    cdef PyObject* _bus = <PyObject *> p
+    cdef object bus = <object> _bus
+    cdef const char* c_data = <const char*> buf
+    cdef bytes data = c_data[:nbyte]
+
+    nfb, comp_node, bus_node = bus
+    nfb.write(bus_node, comp_node, offset, data)
+
+    return nbyte
+
+cdef int nfb_pynfb_bus_open(void *dev_priv, int bus_offset, int comp_offset, void ** bus_priv, libnfb_bus_ext_ops* ops) noexcept with gil:
+    cdef PyObject* _wrap = <PyObject*> dev_priv
+    cdef __NfbWrapper wrap = <object> _wrap
+
+    cdef int ret
+    cdef char * path
+    cdef object bus
+    cdef bytes bpath
+
+    path = <char*> malloc(1024)
+    if path == NULL:
+        return -libc.errno.ENOMEM
+
+    fdt = wrap.nfb._nfb_ext_python_fdt
+
+    ret = fdt_get_path(wrap.fdt, comp_offset, path, 1024)
+    comp_node = fdt.get_node((<bytes>path).decode())
+    ret = fdt_get_path(wrap.fdt, bus_offset, path, 1024)
+    bus_node = fdt.get_node((<bytes>path).decode())
+
+    free(path)
+
+    ops.read = <nfb_bus_read_func*> nfb_pynfb_bus_read
+    ops.write = <nfb_bus_write_func*> nfb_pynfb_bus_write
+
+    bus = (wrap.nfb, comp_node, bus_node)
+
+    Py_INCREF(bus)
+    bus_priv[0] = <PyObject*>bus
+
+    return 0
+
+cdef void nfb_pynfb_bus_close(void *priv) noexcept with gil:
+    cdef PyObject* _bus = <PyObject *> priv
+    cdef object bus = <object> _bus
+
+    Py_DECREF(bus)
+
+# NDP functions
+
+cdef int pyndp_start(void *priv) noexcept with gil:
+    cdef object t = <object>priv
+
+    queue, temp = t
+    queue.start()
+
+    return 0
+
+cdef int pyndp_stop(void *priv) noexcept with gil:
+    cdef object t = <object>priv
+
+    queue, temp = t
+    queue.stop()
+
+    return 0
+
+cdef unsigned pyndp_rx_burst_get(void *priv, ndp_packet *packets, unsigned count) noexcept with gil:
+    cdef object t = <object>priv
+
+    cdef uint8_t* c_data
+    cdef uint8_t* c_hdr
+
+    queue, temp = t
+
+    pkts = queue.burst_get(count)
+    cnt = min(len(pkts), count)
+    for i in range(cnt):
+        pkt, hdr, flags = pkts[i]
+
+        c_data = pkt
+        c_hdr = hdr
+        packets[i].data_length = len(pkt)
+        packets[i].header_length = len(hdr)
+        packets[i].data = c_data
+        packets[i].header = c_hdr
+        packets[i].flags = flags
+
+    return cnt
+
+cdef int pyndp_rx_burst_put(void *priv) noexcept with gil:
+    cdef object t = <object>priv
+
+    queue, temp = t
+    queue.burst_put()
+
+    return 0
+
+cdef unsigned pyndp_tx_burst_get(void *priv, ndp_packet *packets, unsigned count) noexcept with gil:
+    cdef object t = <object>priv
+    queue, temp = t
+
+    pkts = []
+    for i in range(count):
+        pkts.append((
+            int(packets[i].data_length),
+            int(packets[i].header_length),
+            int(packets[i].flags),
+        ))
+    prep = queue.burst_get(pkts)
+
+    for i in range(len(prep)):
+        packets[i].data = <unsigned char*>prep[i][0]
+        packets[i].header = <unsigned char*>prep[i][1]
+
+    return len(prep)
+
+cdef int pyndp_tx_burst_put(void *priv) noexcept with gil:
+    cdef object t = <object>priv
+
+    queue, temp = t
+    queue.burst_put()
+
+    return 0
+
+cdef int pyndp_tx_burst_flush(void *priv) noexcept with gil:
+    cdef object t = <object>priv
+
+    queue, temp = t
+    queue.burst_flush()
+    return 0
+
+
+cdef int nfb_pyndp_queue_open(nfb_device *dev, void *dev_priv, unsigned index, int dir, int flags, ndp_queue ** pq) noexcept with gil:
+    cdef PyObject* _wrap = <PyObject*> dev_priv
+    cdef __NfbWrapper wrap = <object> _wrap
+
+    cdef int ret
+    cdef ndp_queue *q
+    cdef ndp_queue_ops* ops
+
+    cdef object t
+
+    try:
+        queue = wrap.nfb.queue_open(index, dir, flags)
+        assert queue is not None
+    except:
+        return -libc.errno.ENODEV
+
+    q = ndp_queue_create(dev, -1, dir, index)
+    if q == NULL:
+        return -libc.errno.ENOMEM
+
+    t = (queue, [])
+    Py_INCREF(t)
+
+    ndp_queue_set_priv(q, <PyObject*>t);
+
+    ops = ndp_queue_get_ops(q)
+    ops.control.start = pyndp_start
+    ops.control.stop = pyndp_stop
+    if dir == 0:
+        ops.burst.rx.get = pyndp_rx_burst_get
+        ops.burst.rx.put = pyndp_rx_burst_put
+    else:
+        ops.burst.tx.get = pyndp_tx_burst_get
+        ops.burst.tx.put = pyndp_tx_burst_put
+        ops.burst.tx.flush = pyndp_tx_burst_flush
+
+    pq[0] = q
+
+    return 0
+
+cdef int nfb_pyndp_queue_close(ndp_queue *q) noexcept with gil:
+    cdef object t = <object>ndp_queue_get_priv(q)
+
+    queue, temp = t
+    Py_DECREF(t)
+    return 0
+
+cdef int nfb_pynfb_comp_lock(const nfb_comp *comp, uint32_t features) noexcept with gil:
+    # TODO
+    return 1;
+
+cdef void nfb_pynfb_comp_unlock(const nfb_comp *comp, uint32_t features) noexcept with gil:
+    pass
+
+cdef int pynfb_ext_get_ops(const char *devname, libnfb_ext_ops* ops) noexcept:
+    ops.open = nfb_ext_python_open
+    ops.close = nfb_ext_python_close
+    ops.bus_open_mi = nfb_pynfb_bus_open
+    ops.bus_close_mi = nfb_pynfb_bus_close
+    ops.comp_lock = nfb_pynfb_comp_lock
+    ops.comp_unlock = nfb_pynfb_comp_unlock
+    ops.ndp_queue_open = nfb_pyndp_queue_open
+    ops.ndp_queue_close = nfb_pyndp_queue_close
+    return 1

libnfb_ext_python-0.1.1/nfb/ext/python/shim_api.h

@@ -0,0 +1,179 @@
+/* Generated by Cython 3.2.5 */
+
+#ifndef __PYX_HAVE_API__shim
+#define __PYX_HAVE_API__shim
+#ifdef __MINGW64__
+#define MS_WIN64
+#endif
+#include "Python.h"
+#include "shim.h"
+
+static int (*__pyx_api_f_4shim_pynfb_ext_get_ops)(char const *, struct libnfb_ext_ops *) = 0;
+#define pynfb_ext_get_ops __pyx_api_f_4shim_pynfb_ext_get_ops
+static int (*__pyx_api_f_4shim_nfb_ext_python_open)(char const *, int, void **, void **) = 0;
+#define nfb_ext_python_open __pyx_api_f_4shim_nfb_ext_python_open
+static void (*__pyx_api_f_4shim_nfb_ext_python_close)(void *) = 0;
+#define nfb_ext_python_close __pyx_api_f_4shim_nfb_ext_python_close
+static int (*__pyx_api_f_4shim_nfb_pynfb_bus_open)(void *, int, int, void **, struct libnfb_bus_ext_ops *) = 0;
+#define nfb_pynfb_bus_open __pyx_api_f_4shim_nfb_pynfb_bus_open
+static void (*__pyx_api_f_4shim_nfb_pynfb_bus_close)(void *) = 0;
+#define nfb_pynfb_bus_close __pyx_api_f_4shim_nfb_pynfb_bus_close
+static Py_ssize_t (*__pyx_api_f_4shim_nfb_pynfb_bus_read)(void *, void *, size_t, off_t) = 0;
+#define nfb_pynfb_bus_read __pyx_api_f_4shim_nfb_pynfb_bus_read
+static Py_ssize_t (*__pyx_api_f_4shim_nfb_pynfb_bus_write)(void *, void const *, size_t, off_t) = 0;
+#define nfb_pynfb_bus_write __pyx_api_f_4shim_nfb_pynfb_bus_write
+static int (*__pyx_api_f_4shim_nfb_pyndp_queue_open)(struct nfb_device *, void *, unsigned int, int, int, struct ndp_queue **) = 0;
+#define nfb_pyndp_queue_open __pyx_api_f_4shim_nfb_pyndp_queue_open
+static int (*__pyx_api_f_4shim_nfb_pyndp_queue_close)(struct ndp_queue *) = 0;
+#define nfb_pyndp_queue_close __pyx_api_f_4shim_nfb_pyndp_queue_close
+static int (*__pyx_api_f_4shim_pyndp_start)(void *) = 0;
+#define pyndp_start __pyx_api_f_4shim_pyndp_start
+static int (*__pyx_api_f_4shim_pyndp_stop)(void *) = 0;
+#define pyndp_stop __pyx_api_f_4shim_pyndp_stop
+static unsigned int (*__pyx_api_f_4shim_pyndp_rx_burst_get)(void *, struct ndp_packet *, unsigned int) = 0;
+#define pyndp_rx_burst_get __pyx_api_f_4shim_pyndp_rx_burst_get
+static int (*__pyx_api_f_4shim_pyndp_rx_burst_put)(void *) = 0;
+#define pyndp_rx_burst_put __pyx_api_f_4shim_pyndp_rx_burst_put
+static unsigned int (*__pyx_api_f_4shim_pyndp_tx_burst_get)(void *, struct ndp_packet *, unsigned int) = 0;
+#define pyndp_tx_burst_get __pyx_api_f_4shim_pyndp_tx_burst_get
+static int (*__pyx_api_f_4shim_pyndp_tx_burst_put)(void *) = 0;
+#define pyndp_tx_burst_put __pyx_api_f_4shim_pyndp_tx_burst_put
+static int (*__pyx_api_f_4shim_pyndp_tx_burst_flush)(void *) = 0;
+#define pyndp_tx_burst_flush __pyx_api_f_4shim_pyndp_tx_burst_flush
+
+static char const **__pyx_api_vp_4shim_libnfb_ext_compatible_pattern = 0;
+#define libnfb_ext_compatible_pattern (*__pyx_api_vp_4shim_libnfb_ext_compatible_pattern)
+static int __Pyx_ImportVoidPtr_3_2_5(PyObject *module, const char *name, void **p, const char *sig);
+
+#ifndef __PYX_HAVE_RT_ImportFromPxd_3_2_5
+#define __PYX_HAVE_RT_ImportFromPxd_3_2_5
+static int __Pyx_ImportFromPxd_3_2_5(PyObject *module, const char *name, void **p, const char *sig, const char *what) {
+    PyObject *d = 0;
+    PyObject *cobj = 0;
+    d = PyObject_GetAttrString(module, "__pyx_capi__");
+    if (!d)
+        goto bad;
+#if (defined(Py_LIMITED_API) && Py_LIMITED_API >= 0x030d0000) || (!defined(Py_LIMITED_API) && PY_VERSION_HEX >= 0x030d0000)
+    PyDict_GetItemStringRef(d, name, &cobj);
+#else
+    cobj = PyDict_GetItemString(d, name);
+    Py_XINCREF(cobj);
+#endif
+    if (!cobj) {
+        PyErr_Format(PyExc_ImportError,
+            "%.200s does not export expected C %.8s %.200s",
+                PyModule_GetName(module), what, name);
+        goto bad;
+    }
+    if (!PyCapsule_IsValid(cobj, sig)) {
+        PyErr_Format(PyExc_TypeError,
+            "C %.8s %.200s.%.200s has wrong signature (expected %.500s, got %.500s)",
+             what, PyModule_GetName(module), name, sig, PyCapsule_GetName(cobj));
+        goto bad;
+    }
+    *p = PyCapsule_GetPointer(cobj, sig);
+    if (!(*p))
+        goto bad;
+    Py_DECREF(d);
+    Py_DECREF(cobj);
+    return 0;
+bad:
+    Py_XDECREF(d);
+    Py_XDECREF(cobj);
+    return -1;
+}
+#endif
+
+#ifndef __PYX_HAVE_RT_ImportVoidPtr_3_2_5
+#define __PYX_HAVE_RT_ImportVoidPtr_3_2_5
+static int __Pyx_ImportVoidPtr_3_2_5(PyObject *module, const char *name, void **p, const char *sig) {
+    return __Pyx_ImportFromPxd_3_2_5(module, name, p, sig, "variable");
+}
+#endif
+
+static int __Pyx_ImportFunction_3_2_5(PyObject *module, const char *funcname, void (**f)(void), const char *sig);
+
+#ifndef __PYX_HAVE_RT_ImportFromPxd_3_2_5
+#define __PYX_HAVE_RT_ImportFromPxd_3_2_5
+static int __Pyx_ImportFromPxd_3_2_5(PyObject *module, const char *name, void **p, const char *sig, const char *what) {
+    PyObject *d = 0;
+    PyObject *cobj = 0;
+    d = PyObject_GetAttrString(module, "__pyx_capi__");
+    if (!d)
+        goto bad;
+#if (defined(Py_LIMITED_API) && Py_LIMITED_API >= 0x030d0000) || (!defined(Py_LIMITED_API) && PY_VERSION_HEX >= 0x030d0000)
+    PyDict_GetItemStringRef(d, name, &cobj);
+#else
+    cobj = PyDict_GetItemString(d, name);
+    Py_XINCREF(cobj);
+#endif
+    if (!cobj) {
+        PyErr_Format(PyExc_ImportError,
+            "%.200s does not export expected C %.8s %.200s",
+                PyModule_GetName(module), what, name);
+        goto bad;
+    }
+    if (!PyCapsule_IsValid(cobj, sig)) {
+        PyErr_Format(PyExc_TypeError,
+            "C %.8s %.200s.%.200s has wrong signature (expected %.500s, got %.500s)",
+             what, PyModule_GetName(module), name, sig, PyCapsule_GetName(cobj));
+        goto bad;
+    }
+    *p = PyCapsule_GetPointer(cobj, sig);
+    if (!(*p))
+        goto bad;
+    Py_DECREF(d);
+    Py_DECREF(cobj);
+    return 0;
+bad:
+    Py_XDECREF(d);
+    Py_XDECREF(cobj);
+    return -1;
+}
+#endif
+
+#ifndef __PYX_HAVE_RT_ImportFunction_3_2_5
+#define __PYX_HAVE_RT_ImportFunction_3_2_5
+static int __Pyx_ImportFunction_3_2_5(PyObject *module, const char *funcname, void (**f)(void), const char *sig) {
+    union {
+        void (*fp)(void);
+        void *p;
+    } tmp;
+    int result = __Pyx_ImportFromPxd_3_2_5(module, funcname, &tmp.p, sig, "function");
+    if (result == 0) {
+        *f = tmp.fp;
+    }
+    return result;
+}
+#endif
+
+
+static int import_shim(void) {
+  PyObject *module = 0;
+  module = PyImport_ImportModule("shim");
+  if (!module) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pynfb_ext_get_ops", (void (**)(void))&__pyx_api_f_4shim_pynfb_ext_get_ops, "int (char const *, struct libnfb_ext_ops *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_ext_python_open", (void (**)(void))&__pyx_api_f_4shim_nfb_ext_python_open, "int (char const *, int, void **, void **)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_ext_python_close", (void (**)(void))&__pyx_api_f_4shim_nfb_ext_python_close, "void (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pynfb_bus_open", (void (**)(void))&__pyx_api_f_4shim_nfb_pynfb_bus_open, "int (void *, int, int, void **, struct libnfb_bus_ext_ops *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pynfb_bus_close", (void (**)(void))&__pyx_api_f_4shim_nfb_pynfb_bus_close, "void (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pynfb_bus_read", (void (**)(void))&__pyx_api_f_4shim_nfb_pynfb_bus_read, "Py_ssize_t (void *, void *, size_t, off_t)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pynfb_bus_write", (void (**)(void))&__pyx_api_f_4shim_nfb_pynfb_bus_write, "Py_ssize_t (void *, void const *, size_t, off_t)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pyndp_queue_open", (void (**)(void))&__pyx_api_f_4shim_nfb_pyndp_queue_open, "int (struct nfb_device *, void *, unsigned int, int, int, struct ndp_queue **)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "nfb_pyndp_queue_close", (void (**)(void))&__pyx_api_f_4shim_nfb_pyndp_queue_close, "int (struct ndp_queue *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_start", (void (**)(void))&__pyx_api_f_4shim_pyndp_start, "int (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_stop", (void (**)(void))&__pyx_api_f_4shim_pyndp_stop, "int (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_rx_burst_get", (void (**)(void))&__pyx_api_f_4shim_pyndp_rx_burst_get, "unsigned int (void *, struct ndp_packet *, unsigned int)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_rx_burst_put", (void (**)(void))&__pyx_api_f_4shim_pyndp_rx_burst_put, "int (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_tx_burst_get", (void (**)(void))&__pyx_api_f_4shim_pyndp_tx_burst_get, "unsigned int (void *, struct ndp_packet *, unsigned int)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_tx_burst_put", (void (**)(void))&__pyx_api_f_4shim_pyndp_tx_burst_put, "int (void *)") < 0) goto bad;
+  if (__Pyx_ImportFunction_3_2_5(module, "pyndp_tx_burst_flush", (void (**)(void))&__pyx_api_f_4shim_pyndp_tx_burst_flush, "int (void *)") < 0) goto bad;
+  if (__Pyx_ImportVoidPtr_3_2_5(module, "libnfb_ext_compatible_pattern", (void **)&__pyx_api_vp_4shim_libnfb_ext_compatible_pattern, "char const *") < 0) goto bad;
+  Py_DECREF(module); module = 0;
+  return 0;
+  bad:
+  Py_XDECREF(module);
+  return -1;
+}
+
+#endif /* !__PYX_HAVE_API__shim */

libnfb_ext_python-0.1.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = [
+	"setuptools>=40.1.0",
+	"Cython>=0.29.33",
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "libnfb-ext-python"
+version = "0.1.1"
+description = "Python extension for libnfb — implement NFB device backends in Python"
+readme = "readme.rst"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Martin Spinler", email = "spinler@cesnet.cz" },
+]
+requires-python = ">=3.8"
+dependencies = [
+    "fdt",
+    "nfb",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Cython",
+    "Topic :: System :: Hardware",
+    "Topic :: System :: Hardware :: Hardware Drivers",
+]
+
+[project.urls]
+Homepage = "https://github.com/CESNET/ndk-sw"
+Documentation = "https://cesnet.github.io/ndk-sw/"
+Repository = "https://github.com/CESNET/ndk-sw"
+"Bug Tracker" = "https://github.com/CESNET/ndk-sw/issues"

libnfb_ext_python-0.1.1/readme.rst

@@ -0,0 +1,10 @@
+Installation
+------------
+
+libnfb_ext_python package requires nfb package for build.
+The wanted nfb package is probably not available in ordinary way, so
+local (venv) installation via pip can be done for example like this:
+
+# current directory is root of this git repository
+$ pip wheel -w ./localwhldir ./pynfb/
+$ pip install --find-links ./localwhldir ./ext/libnfb_ext_python/

libnfb_ext_python-0.1.0/PKG-INFO

@@ -1,9 +0,0 @@
-Metadata-Version: 2.4
-Name: libnfb-ext-python
-Version: 0.1.0
-Author: Martin Spinler
-Author-email: spinler@cesnet.cz
-Requires-Dist: fdt
-Dynamic: author
-Dynamic: author-email
-Dynamic: requires-dist

libnfb_ext_python-0.1.0/libnfb_ext_python.egg-info/PKG-INFO

@@ -1,9 +0,0 @@
-Metadata-Version: 2.4
-Name: libnfb-ext-python
-Version: 0.1.0
-Author: Martin Spinler
-Author-email: spinler@cesnet.cz
-Requires-Dist: fdt
-Dynamic: author
-Dynamic: author-email
-Dynamic: requires-dist

libnfb_ext_python-0.1.0/pyproject.toml

@@ -1,6 +0,0 @@
-[build-system]
-requires = [
-	"setuptools>=40.1.0",
-	"Cython>=0.29.33",
-]
-build-backend = "setuptools.build_meta"