Guides DOCA Management C API programming for BlueField and ConnectX device administration.
npx skills add https://github.com/NVIDIA/skills --skill doca-mgmt
Please help me install this Agent Skill. Skill: doca-mgmt Source: https://github.com/NVIDIA/skills/tree/main/skills/doca-mgmt Command: npx skills add https://github.com/NVIDIA/skills --skill doca-mgmt
Developers building fleet-management or device-administration tools against NVIDIA BlueField DPUs and ConnectX NICs need to query and modify device-level state programmatically, but the DOCA Management API surface is EXPERIMENTAL, safety-critical, and easy to misuse — a wrong raw-command scope or an unrollbackable write can leave a device in an unrecoverable state.
doca_mgmt_dev_ctx and doca_mgmt_dev_rep_ctx contexts, probing sub-domain capability gates, and applying the correct lifecycle ordering.doca_mgmt_raw_cmd, and post-write re-query verification.DOCA_ERROR_* taxonomy that maps failures like DOCA_ERROR_IO_FAILED and DOCA_ERROR_OPERATING_SYSTEM to configuration, fwctl, firmware, or driver layers.Ask your agent to walk you through opening a doca_mgmt_dev_ctx on a BlueField device and querying its general capabilities with the doca-mgmt skill.
High-intent search queries and answers about installing and using this skill.
Create a doca_mgmt_dev_ctx on the device, optionally a doca_mgmt_dev_rep_ctx for a representor, then call doca_mgmt_device_caps_general_get on a transient caps-general handle. Always run the sub-domain capability gate first and treat DOCA_ERROR_NOT_SUPPORTED as the not-supported signal.
Use doca-mgmt for programmatic point-in-time queries and modifications of device state from C code. Choose doca-telemetry for continuous streaming metrics, doca_caps for interactive read-only CLI snapshots, and doca-bench for throughput or latency measurement.
Pick the narrowest scope that satisfies the operation: DEBUG_READ_ONLY for read-only queries, CONFIGURATION for persistent device-visible writes, and DEBUG_WRITE or DEBUG_WRITE_FULL for firmware-side mutation. Prefer a dedicated sub-domain wrapper over raw_cmd whenever one exists.
DOCA_ERROR_IO_FAILED means the fwctl ioctl reached the firmware but the firmware rejected the command. Re-confirm the four-way version match between pkg-config, doca_caps, and the install tree, verify the opcode against vendor documentation, then investigate device state if both pass.
Yes, most management-plane operations require root or an equivalent device-administration capability set, plus a host kernel exposing the /dev/fwctl character device. A DOCA_ERROR_OPERATING_SYSTEM on a non-root invocation is almost always a privilege gate.
No, every public doca_mgmt_* symbol is tagged EXPERIMENTAL under the DOCA_3 version bucket, so the API shape can change between releases. Re-run the full test workflow against each new DOCA install and verify symbols against the installed headers, not documentation memory.
air-gappedAutomate NVIDIA datacenter GPU bring-up on Ubuntu 24.04 with health validation.
grafanaManage and deploy Alloy pipeline configurations to Fleet Management collectors.
FernanSuozaExport bounded logs, counters, event traces, and health telemetry from embedded devices.
tray-tecnologiaList administrative users of a Tray store via the Tray Users API.