HNSDV_QUERY_DEVICE(3)

πŸ’… HNSDV_QUERY_DEVICE(3) πŸ’…

Okay so welcome to the HNS Direct Verbs Manual, bestie β€” this is the page for hnsdv_query_device, and it's lowkey giving "one job, done cute" energy. I'm obsessed. ✨

🌸 NAME 🌸

hnsdv_query_device - Query hns device specific attributes.

✨ SYNOPSIS ✨

              #include <infiniband/hnsdv.h>
              int hnsdv_query_device(struct ibv_context *context,
                                     struct hnsdv_context *attrs_out);

πŸ’– DESCRIPTION πŸ’–

The way that hnsdv_query_device() is literally just here to query hns device specific attributes β€” it's giving focused, lowkey iconic. No extra lore, no side quests, just device-attribute main character energy. πŸ’…

πŸŽ€ ARGUMENTS πŸŽ€

For context, please see the ibv_query_device(3) man page. That's the vibe check for that argument. 🫢

πŸ¦‹ attrs_out πŸ¦‹

              struct hnsdv_context {
                      uint64_t comp_mask;
                      uint64_t flags;
                      uint8_t congest_type;
                      uint8_t reserved[7];
              };

comp_mask β€” Bitmask specifying what fields in the structure are valid:

  • HNSDV_CONTEXT_MASK_CONGEST_TYPE: Congestion control algorithm is supported.

congest_type β€” Bitmask of supported congestion control algorithms.

  • HNSDV_QP_CREATE_ENABLE_DCQCN: Data Center Quantized Congestion Notification
  • HNSDV_QP_CREATE_ENABLE_LDCP: Low Delay Control Protocol
  • HNSDV_QP_CREATE_ENABLE_HC3: Huawei Converged Congestion Control
  • HNSDV_QP_CREATE_ENABLE_DIP: Destination IP based Quantized Congestion Notification

πŸ”₯ RETURN VALUE πŸ”₯

hnsdv_query_device() returns 0 on success, or the value of errno on failure (which indicates the failure reason). No cap. Slay. πŸ’―

🌈 SEE ALSO 🌈

πŸ“ NOTES πŸ“

  • flags is an out field and currently has no values. That's it β€” the whole note, periodt. πŸ’€

πŸ‘‘ AUTHORS πŸ‘‘

Junxian Huang <huangjunxian6@hisilicon.com> β€” shoutout to the author, fr fr. 🫢


Alright bestie, that's the whole page! Source/version: hns Β· date: 2024-02-06 Β· page: HNSDV_QUERY_DEVICE(3). Mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from