1515. ftr VB CB
1616. ftr VBI CBI
1717.\}
18- .TH "fi_domain" "3" "2025\- 01 \- 30 " "Libfabric Programmer\[cq ] s Manual" "#VERSION#"
18+ .TH "fi_domain" "3" "2025\- 03 \- 06 " "Libfabric Programmer\[cq ] s Manual" "#VERSION#"
1919.hy
2020.SH NAME
2121.PP
@@ -444,17 +444,21 @@ The table assumes that all peers enable or disable RM the same.
444444.PP
445445.TS
446446tab(@ ) ;
447- cw (7.7n ) cw (16.2n ) cw (16. 2n) cw (15.4n ) cw (14.6n ).
447+ cw (5.4n ) cw (11.3n ) cw (11.3n) cw (10.8n) cw (10. 2n) cw (10.8n ) cw (10.2n ).
448448T {
449449Res ource
450450T }@T{
451451DGRAM EP -no R M
452452T }@T{
453453DGRAM EP -with R M
454454T }@T{
455- R DM/ MSG EP -no R M
455+ MSG EP -no R M
456456T }@T{
457- R DM/MSG EP -with R M
457+ MSG EP -with R M
458+ T }@T{
459+ R DM EP -no R M
460+ T }@T{
461+ R DM EP -with R M
458462T }
459463_
460464T {
@@ -467,6 +471,10 @@ T}@T{
467471un defined err or
468472T }@T{
469473EA GAIN
474+ T }@T{
475+ un defined err or
476+ T }@T{
477+ EA GAIN
470478T }
471479T {
472480R x Ct x
@@ -478,6 +486,10 @@ T}@T{
478486un defined err or
479487T }@T{
480488EA GAIN
489+ T }@T{
490+ un defined err or
491+ T }@T{
492+ EA GAIN
481493T }
482494T {
483495T x C Q
@@ -489,6 +501,10 @@ T}@T{
489501un defined err or
490502T }@T{
491503EA GAIN
504+ T }@T{
505+ un defined err or
506+ T }@T{
507+ EA GAIN
492508T }
493509T {
494510R x C Q
@@ -500,6 +516,10 @@ T}@T{
500516un defined err or
501517T }@T{
502518EA GAIN
519+ T }@T{
520+ un defined err or
521+ T }@T{
522+ EA GAIN
503523T }
504524T {
505525Tar get EP
@@ -511,6 +531,10 @@ T}@T{
511531trans mit err or
512532T }@T{
513533retrie d
534+ T }@T{
535+ trans mit err or
536+ T }@T{
537+ retrie d
514538T }
515539T {
516540N o R x Buffer
@@ -522,6 +546,10 @@ T}@T{
522546trans mit err or
523547T }@T{
524548retrie d
549+ T }@T{
550+ trans mit err or
551+ T }@T{
552+ retrie d
525553T }
526554T {
527555R x Buf Overrun
@@ -533,6 +561,10 @@ T}@T{
533561truncate or err or
534562T }@T{
535563truncate or err or
564+ T }@T{
565+ truncate or err or
566+ T }@T{
567+ truncate or err or
536568T }
537569T {
538570Un matched R MA
@@ -544,6 +576,10 @@ T}@T{
544576trans mit err or
545577T }@T{
546578trans mit err or
579+ T }@T{
580+ trans mit err or
581+ T }@T{
582+ trans mit err or
547583T }
548584T {
549585R MA Overrun
@@ -555,6 +591,25 @@ T}@T{
555591trans mit err or
556592T }@T{
557593trans mit err or
594+ T }@T{
595+ trans mit err or
596+ T }@T{
597+ trans mit err or
598+ T }
599+ T {
600+ Unreac hable EP
601+ T }@T{
602+ dropped
603+ T }@T{
604+ dropped
605+ T }@T{
606+ n ot applicable
607+ T }@T{
608+ n ot applicable
609+ T }@T{
610+ trans mit err or
611+ T }@T{
612+ trans mit err or
558613T }
559614.TE
560615.PP
@@ -627,15 +682,30 @@ Unlike send operations, RMA operations that attempt to access a memory
627682address that is either not registered for such operations, or attempt to
628683access outside of the target memory region will fail, resulting in a
629684transmit error.
630- .PP
631- When a resource management error occurs on an endpoint, the endpoint is
632- transitioned into a disabled state.
633- Any operations which have not already completed will fail and be
634- discarded.
635- For connectionless endpoints, the endpoint must be re-enabled before it
636- will accept new data transfer operations.
637- For connected endpoints, the connection is torn down and must be
638- re-established.
685+ .TP
686+ \f[I] Unreachable EP \f[ R ]
687+ Unreachable endpoint is a connectionless specific scenario where
688+ transmit operations are issued to unreachable target endpoints.
689+ Such scenarios include no-route-to-host or down target NIC.
690+ For FI_EP_DGRAM endpoints, transmit operations targeting an unreachable
691+ endpoint will have operation dropped.
692+ For FI_EP_RDM, target operations targeting an unreachable endpoint will
693+ result in a transmit error.
694+ .PP
695+ When a resource management error occurs on an a connected endpoint, the
696+ endpoint will transition into a disabled state and the connection torn
697+ down.
698+ A disabled endpoint will drop any queued or inflight operations.
699+ .PP
700+ The behavior of resource management errors on connectionless endpoints
701+ depends on the type of error.
702+ If RM is disabled and one of the following errors occur, the endpoint
703+ will be disabled: Tx Ctx, Rx Ctx, Tx CQ, or Rx CQ.
704+ For other errors (Target EP, No Rx Buffer, etc.), the operation may
705+ fail, but the endpoint will remain enabled.
706+ A disabled endpoint will drop or fail any queued or inflight operations.
707+ In addition, a disabled endpoint must be re-enabled before it will
708+ accept new data transfer operations.
639709.PP
640710There is one notable restriction on the protections offered by resource
641711management.
0 commit comments