1515. ftr VB CB
1616. ftr VBI CBI
1717.\}
18- .TH "fi_domain" "3" "2025 \- 03 \- 06 " "Libfabric Programmer\[cq ] s Manual" "#VERSION#"
18+ .TH "fi_domain" "3" "2026 \- 02 \- 11 " "Libfabric Programmer\[cq ] s Manual" "#VERSION#"
1919.hy
2020.SH NAME
2121.PP
@@ -228,6 +228,8 @@ struct fi_domain_attr {
228228 uint32_t tclass;
229229 size_t max_ep_auth_key;
230230 uint32_t max_group_id;
231+ uint64_t max_cntr_value;
232+ uint64_t max_err_cntr_value;
231233};
232234\f[ R ]
233235.fi
@@ -1029,6 +1031,43 @@ Providers that cannot meet the requested max_group_id will fail
10291031fi_getinfo().
10301032On output, providers may return a value higher than that requested by
10311033the application.
1034+ .SS Maximum Counter Value (max_cntr_value)
1035+ .PP
1036+ The maximum value returned by fi_cntr_read.
1037+ While counters use uint64_t, the full range may not be supported due to
1038+ hardware limitations.
1039+ This field allows providers to advertise their specific limits.
1040+ The default value is UINT64_MAX, which indicates the full counter range.
1041+ A value of 0 means the provider does not set the limit and should be
1042+ treated the same as the default value.
1043+ .PP
1044+ Applications may provide a non-zero max_cntr_value as input to
1045+ fi_getinfo to request a minimum supported counter range.
1046+ If the provider cannot satisfy the requested range, it should return
1047+ -FI_ENODATA.
1048+ The provider may return a value larger than the one requested.
1049+ .PP
1050+ Applications must manage counter values that approach this limit.
1051+ See \f[ V ] fi_cntr\f[ R ] (3) for details on counter limit handling
1052+ responsibilities.
1053+ .SS Maximum Error Counter Value (max_err_cntr_value)
1054+ .PP
1055+ The maximum value returned by fi_cntr_readerr.
1056+ Similar to max_cntr_value, this addresses provider-specific limitations
1057+ for error counter ranges.
1058+ The default value is UINT64_MAX, which indicates the full counter range.
1059+ A value of 0 means the provider does not set the limit and should be
1060+ treated the same as the default value.
1061+ .PP
1062+ Applications may provide a non-zero max_err_cntr_value as input to
1063+ fi_getinfo to request a minimum supported error counter range.
1064+ If the provider cannot satisfy the requested range, it should return
1065+ -FI_ENODATA.
1066+ The provider may return a value larger than the one requested.
1067+ .PP
1068+ Applications must manage error counter values that approach this limit.
1069+ See \f[ V ] fi_cntr\f[ R ] (3) for details on counter limit handling
1070+ responsibilities.
10321071.SH RETURN VALUE
10331072.PP
10341073Returns 0 on success.
@@ -1054,5 +1093,6 @@ resources appropriately for the installed provider(s).
10541093.PP
10551094\f[ V ] fi_getinfo\f[ R ] (3), \f[ V ] fi_endpoint\f[ R ] (3), \f[ V ] fi_av\f[ R ] (3),
10561095\f[ V ] fi_eq\f[ R ] (3), \f[ V ] fi_mr\f[ R ] (3) \f[ V ] fi_peer\f[ R ] (3)
1096+ \f[ V ] fi_cntr\f[ R ] (3)
10571097.SH AUTHORS
10581098OpenFabrics.
0 commit comments