drivers/net/ethernet/netronome/nfp/nfp_shared_buf.c
Source file repositories/reference/linux-study-clean/drivers/net/ethernet/netronome/nfp/nfp_shared_buf.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/net/ethernet/netronome/nfp/nfp_shared_buf.c- Extension
.c- Size
- 3802 bytes
- Lines
- 150
- Domain
- Driver Families
- Bucket
- drivers/net
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/kernel.hnet/devlink.hnfpcore/nfp_cpp.hnfpcore/nfp_nffw.hnfp_abi.hnfp_app.hnfp_main.h
Detected Declarations
function nfp_shared_buf_pool_unitfunction nfp_shared_buf_pool_getfunction nfp_shared_buf_pool_setfunction nfp_shared_buf_registerfunction nfp_shared_buf_unregister
Annotated Snippet
// SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
/* Copyright (C) 2018 Netronome Systems, Inc. */
#include <linux/kernel.h>
#include <net/devlink.h>
#include "nfpcore/nfp_cpp.h"
#include "nfpcore/nfp_nffw.h"
#include "nfp_abi.h"
#include "nfp_app.h"
#include "nfp_main.h"
static u32 nfp_shared_buf_pool_unit(struct nfp_pf *pf, unsigned int sb)
{
__le32 sb_id = cpu_to_le32(sb);
unsigned int i;
for (i = 0; i < pf->num_shared_bufs; i++)
if (pf->shared_bufs[i].id == sb_id)
return le32_to_cpu(pf->shared_bufs[i].pool_size_unit);
WARN_ON_ONCE(1);
return 0;
}
int nfp_shared_buf_pool_get(struct nfp_pf *pf, unsigned int sb, u16 pool_index,
struct devlink_sb_pool_info *pool_info)
{
struct nfp_shared_buf_pool_info_get get_data;
struct nfp_shared_buf_pool_id id = {
.shared_buf = cpu_to_le32(sb),
.pool = cpu_to_le32(pool_index),
};
unsigned int unit_size;
int n;
unit_size = nfp_shared_buf_pool_unit(pf, sb);
if (!unit_size)
return -EINVAL;
n = nfp_mbox_cmd(pf, NFP_MBOX_POOL_GET, &id, sizeof(id),
&get_data, sizeof(get_data));
if (n < 0)
return n;
if (n < sizeof(get_data))
return -EIO;
pool_info->pool_type = le32_to_cpu(get_data.pool_type);
pool_info->threshold_type = le32_to_cpu(get_data.threshold_type);
pool_info->size = le32_to_cpu(get_data.size) * unit_size;
pool_info->cell_size = unit_size;
return 0;
}
int nfp_shared_buf_pool_set(struct nfp_pf *pf, unsigned int sb,
u16 pool_index, u32 size,
enum devlink_sb_threshold_type threshold_type)
{
struct nfp_shared_buf_pool_info_set set_data = {
.id = {
.shared_buf = cpu_to_le32(sb),
.pool = cpu_to_le32(pool_index),
},
.threshold_type = cpu_to_le32(threshold_type),
};
unsigned int unit_size;
unit_size = nfp_shared_buf_pool_unit(pf, sb);
if (!unit_size || size % unit_size)
return -EINVAL;
set_data.size = cpu_to_le32(size / unit_size);
return nfp_mbox_cmd(pf, NFP_MBOX_POOL_SET, &set_data, sizeof(set_data),
NULL, 0);
}
int nfp_shared_buf_register(struct nfp_pf *pf)
{
struct devlink *devlink = priv_to_devlink(pf);
unsigned int i, num_entries, entry_sz;
struct nfp_cpp_area *sb_desc_area;
u8 __iomem *sb_desc;
int n, err;
if (!pf->mbox)
return 0;
n = nfp_pf_rtsym_read_optional(pf, NFP_SHARED_BUF_COUNT_SYM_NAME, 0);
if (n <= 0)
Annotation
- Immediate include surface: `linux/kernel.h`, `net/devlink.h`, `nfpcore/nfp_cpp.h`, `nfpcore/nfp_nffw.h`, `nfp_abi.h`, `nfp_app.h`, `nfp_main.h`.
- Detected declarations: `function nfp_shared_buf_pool_unit`, `function nfp_shared_buf_pool_get`, `function nfp_shared_buf_pool_set`, `function nfp_shared_buf_register`, `function nfp_shared_buf_unregister`.
- Atlas domain: Driver Families / drivers/net.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.