net/mctp/test/utils.c
Source file repositories/reference/linux-study-clean/net/mctp/test/utils.c
File Facts
- System
- Linux kernel
- Corpus path
net/mctp/test/utils.c- Extension
.c- Size
- 6830 bytes
- Lines
- 312
- Domain
- Networking Core
- Bucket
- Sockets, Protocols, Packet Path, And Network Policy
- Inferred role
- Networking Core: operation-table or driver-model contract
- Status
- pattern implementation candidate
Why This File Exists
Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Defines an operation table; this is where Linux turns generic core objects into subsystem-specific behavior.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- 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/netdevice.hlinux/mctp.hlinux/if_arp.hnet/mctp.hnet/mctpdevice.hnet/pkt_sched.hutils.h
Detected Declarations
function mctp_test_dev_txfunction mctp_test_dev_setupfunction mctp_test_destroy_devfunction mctp_test_dst_outputfunction mctp_test_dst_setupfunction mctp_test_route_destroyfunction mctp_test_skb_set_devfunction mctp_test_bind_run
Annotated Snippet
static const struct net_device_ops mctp_test_netdev_ops = {
.ndo_start_xmit = mctp_test_dev_tx,
};
static void mctp_test_dev_setup(struct net_device *ndev)
{
ndev->type = ARPHRD_MCTP;
ndev->mtu = MCTP_DEV_TEST_MTU;
ndev->hard_header_len = 0;
ndev->tx_queue_len = 0;
ndev->flags = IFF_NOARP;
ndev->netdev_ops = &mctp_test_netdev_ops;
ndev->needs_free_netdev = true;
}
static struct mctp_test_dev *__mctp_test_create_dev(unsigned short lladdr_len,
const unsigned char *lladdr)
{
struct mctp_test_dev *dev;
struct net_device *ndev;
int rc;
if (WARN_ON(lladdr_len > MAX_ADDR_LEN))
return NULL;
ndev = alloc_netdev(sizeof(*dev), "mctptest%d", NET_NAME_ENUM,
mctp_test_dev_setup);
if (!ndev)
return NULL;
dev = netdev_priv(ndev);
dev->ndev = ndev;
ndev->addr_len = lladdr_len;
dev_addr_set(ndev, lladdr);
skb_queue_head_init(&dev->pkts);
rc = register_netdev(ndev);
if (rc) {
free_netdev(ndev);
return NULL;
}
rcu_read_lock();
dev->mdev = __mctp_dev_get(ndev);
dev->mdev->net = mctp_default_net(dev_net(ndev));
rcu_read_unlock();
/* bring the device up; we want to be able to TX immediately */
rtnl_lock();
dev_open(ndev, NULL);
rtnl_unlock();
return dev;
}
struct mctp_test_dev *mctp_test_create_dev(void)
{
return __mctp_test_create_dev(0, NULL);
}
struct mctp_test_dev *mctp_test_create_dev_with_addr(mctp_eid_t addr)
{
struct mctp_test_dev *dev;
dev = __mctp_test_create_dev(0, NULL);
if (!dev)
return NULL;
dev->mdev->addrs = kmalloc_objs(u8, 1, GFP_KERNEL);
if (!dev->mdev->addrs) {
mctp_test_destroy_dev(dev);
return NULL;
}
dev->mdev->num_addrs = 1;
dev->mdev->addrs[0] = addr;
return dev;
}
struct mctp_test_dev *mctp_test_create_dev_lladdr(unsigned short lladdr_len,
const unsigned char *lladdr)
{
return __mctp_test_create_dev(lladdr_len, lladdr);
}
void mctp_test_destroy_dev(struct mctp_test_dev *dev)
{
skb_queue_purge(&dev->pkts);
mctp_dev_put(dev->mdev);
Annotation
- Immediate include surface: `linux/netdevice.h`, `linux/mctp.h`, `linux/if_arp.h`, `net/mctp.h`, `net/mctpdevice.h`, `net/pkt_sched.h`, `utils.h`.
- Detected declarations: `function mctp_test_dev_tx`, `function mctp_test_dev_setup`, `function mctp_test_destroy_dev`, `function mctp_test_dst_output`, `function mctp_test_dst_setup`, `function mctp_test_route_destroy`, `function mctp_test_skb_set_dev`, `function mctp_test_bind_run`.
- Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
- Implementation status: pattern implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
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.