.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "fi_info" "1" "2026\-02\-11" "Libfabric Programmer\[cq]s Manual" "Libfabric v2.6.0"
.hy
.SH "نام (NAME)"
.PP
fi_info \- پرس‌وجو و نمایش اطلاعات ارائه‌دهندگان رابط کاربری Libfabric
.SH "خلاصه دستور (SYNOPSIS)"
.IP
.nf
\f[C]
 fi_info [OPTIONS]
\f[R]
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
.B fi_info
می‌تواند برای پرس‌وجوی رابط‌های فابریک (fabric interfaces) موجود استفاده شود.
این ابزار از پالایش بر اساس گزینه‌های متعددی مانند نوع نقطه پایانی (endpoint type)، نام ارائه‌دهنده (provider name) یا حالت‌های پشتیبانی‌شده پشتیبانی می‌کند.
علاوه بر این،
.B fi_info
می‌تواند برای کشف متغیرهای محیطی که برای تنظیم پارامترهای خاص ارائه‌دهنده به کار می‌روند نیز استفاده شود.
اگر هیچ فیلتری تعیین نشود، تمام رابط‌های فابریک موجود برای همه ارائه‌دهندگان و انواع نقاط پایانی برگردانده خواهند شد.
.SH "گزینه‌ها (OPTIONS)"
.SS "پالایش (Filtering)"
.TP
\f[I]-n, \[en]node=<NAME>\f[R]
نام یا نشانی گره مورد استفاده برای پالایش رابط‌ها.
فقط رابط‌هایی که می‌توانند به گره یا نشانی داده‌شده دسترسی داشته باشند پاسخ خواهند داد.
.TP
\f[I]-P, \[en]port=<PORT>\f[R]
شماره درگاه (پورت) مورد استفاده برای پالایش رابط‌ها.
.TP
\f[I]-c, \[en]caps=<CAP1|CAP2>..\f[R]
فهرستی از قابلیت‌ها که با خط عمودی (pipe) از هم جدا شده‌اند و برای پالایش رابط‌ها استفاده می‌شوند.
فقط رابط‌هایی که از تمام قابلیت‌های داده‌شده پشتیبانی می‌کنند پاسخ خواهند داد.
برای اطلاعات بیشتر درباره قابلیت‌ها، به
.BR fi_getinfo (3)
مراجعه کنید.
.TP
\f[I]-m, \[en]mode=<MOD1|MOD2>..\f[R]
فهرستی از حالت‌ها که با خط عمودی از هم جدا شده‌اند و برای پالایش رابط‌ها استفاده می‌شوند.
فقط رابط‌هایی که از تمام حالت‌های داده‌شده پشتیبانی می‌کنند پاسخ خواهند داد.
برای اطلاعات بیشتر درباره حالت‌ها، به
.BR fi_getinfo (3)
مراجعه کنید.
.TP
\f[I]-t, \[en]ep_type=<EPTYPE>\f[R]
نوع ارتباط رابط فابریک مورد نظر را تعیین می‌کند.
برای نمونه، تعیین
.B FI_EP_DGRAM
فقط رابط‌هایی را برمی‌گرداند که از دیتاگرام غیرقابل اعتماد پشتیبانی می‌کنند.
برای اطلاعات بیشتر درباره انواع نقاط پایانی، به
.BR fi_endpoint (3)
مراجعه کنید.
.TP
\f[I]-a, \[en]addr_format=<FMT>\f[R]
پالایش رابط‌های فابریک بر اساس قالب نشانی آن‌ها.
برای نمونه، تعیین
.B FI_SOCKADDR_IN
تنها رابط‌هایی را برمی‌گرداند که از ساختارهای sockaddr_in برای نشانی‌دهی استفاده می‌کنند.
برای اطلاعات بیشتر درباره قالب‌های نشانی، به
.BR fi_getinfo (3)
مراجعه کنید.
.TP
\f[I]-p, \[en]provider=<PROV>\f[R]
پالایش رابط‌های فابریک بر اساس پیاده‌سازی ارائه‌دهنده.
برای فهرستی از ارائه‌دهندگان، گزینه
\f[V]--list\f[R]
را ببینید.
.TP
\f[I]-d, \[en]domain=<DOMAIN>\f[R]
پالایش رابط‌ها تنها به مواردی با نام دامنه داده‌شده.
.TP
\f[I]-f, \[en]fabric=<FABRIC>\f[R]
پالایش رابط‌ها تنها به مواردی با نام فابریک داده‌شده.
.SS "شناسایی و کشف (Discovery)"
.TP
\f[I]-e, \[en]env\f[R]
فهرست کردن متغیرهای محیطی مرتبط با libfabric که می‌توان از آن‌ها برای فعال‌سازی پیکربندی اضافی یا بهینه‌سازی و تنظیم استفاده کرد.
.TP
\f[I]-g [filter]\f[R]
مشابه گزینه \-e، با این تفاوت که خروجی به متغیرهای محیطی محدود می‌شود که زیررشته filter را در بر دارند.
.TP
\f[I]-l, \[en]list\f[R]
فهرست کردن ارائه‌دهندگان موجود libfabric.
.TP
\f[I]-v, \[en]verbose\f[R]
به صورت پیش‌فرض،
.B fi_info
خلاصه‌ای از هر یک از رابط‌های کشف‌شده را نمایش می‌دهد.
اگر گزینه پرحرف (verbose) فعال باشد، تمام محتویات ساختار
.B fi_info
نمایش داده می‌شود.
برای اطلاعات بیشتر درباره داده‌های موجود در ساختار fi_info، به
.BR fi_getinfo (3)
مراجعه کنید.
.TP
\f[I]\[en]version\f[R]
نمایش اطلاعات نسخه.
.SH "مثال‌های کاربردی (USAGE EXAMPLES)"
.IP
.nf
\f[C]
$ fi_info -p verbs -t FI_EP_DGRAM
\f[R]
.fi
.PP
این دستور تمام رابط‌های فابریکی را که از نوع نقطه پایانی FI_EP_DGRAM به همراه ارائه‌دهنده verbs استفاده می‌کنند برمی‌گرداند.
.IP
.nf
\f[C]
fi_info -c \[aq]FI_MSG|FI_READ|FI_RMA\[aq]
\f[R]
.fi
.PP
این دستور تمام رابط‌های فابریکی را برمی‌گرداند که می‌توانند از قابلیت‌های FI_MSG|FI_READ|FI_RMA پشتیبانی کنند.
.SH "خروجی (OUTPUT)"
.PP
به صورت پیش‌فرض
.B fi_info
خلاصه‌ای از رابط‌های فابریک کشف‌شده را نمایش می‌دهد:
.IP
.nf
\f[C]
$ ./fi_info -p verbs -t FI_EP_DGRAM
provider: verbs
    fabric: IB-0xfe80000000000000
    domain: mlx5_0-dgram
    version: 116.0
    type: FI_EP_DGRAM
    protocol: FI_PROTO_IB_UD

$ ./fi_info -p tcp
provider: tcp
    fabric: 192.168.7.0/24
    domain: eth0
    version: 116.0
    type: FI_EP_MSG
    protocol: FI_PROTO_SOCK_TCP
\f[R]
.fi
.PP
برای مشاهده ساختار کامل fi_info، گزینه
\f[V]-v\f[R]
را مشخص کنید.
.IP
.nf
\f[C]
fi_info:
    caps: [ FI_MSG, FI_RMA, FI_TAGGED, FI_ATOMIC, FI_READ, FI_WRITE, FI_RECV, FI_SEND, FI_REMOTE_READ, FI_REMOTE_WRITE, FI_MULTI_RECV, FI_RMA_EVENT, FI_SOURCE, FI_DIRECTED_RECV ]
    mode: [  ]
    addr_format: FI_ADDR_IB_UD
    src_addrlen: 32
    dest_addrlen: 0
    src_addr: fi_addr_ib_ud://:::0/0/0/0
    dest_addr: (null)
    handle: (nil)
    fi_tx_attr:
        caps: [ FI_MSG, FI_RMA, FI_TAGGED, FI_ATOMIC, FI_READ, FI_WRITE, FI_SEND ]
        mode: [  ]
        op_flags: [  ]
        msg_order: [ FI_ORDER_RAR, FI_ORDER_RAW, FI_ORDER_RAS, FI_ORDER_WAW, FI_ORDER_WAS, FI_ORDER_SAW, FI_ORDER_SAS, FI_ORDER_RMA_RAR, FI_ORDER_RMA_RAW, FI_ORDER_RMA_WAW, FI_ORDER_ATOMIC_RAR, FI_ORDER_ATOMIC_RAW, FI_ORDER_ATOMIC_WAR, FI_ORDER_ATOMIC_WAW ]
        inject_size: 3840
        size: 1024
        iov_limit: 4
        rma_iov_limit: 4
        tclass: 0x0
    fi_rx_attr:
        caps: [ FI_MSG, FI_RMA, FI_TAGGED, FI_ATOMIC, FI_RECV, FI_REMOTE_READ, FI_REMOTE_WRITE, FI_MULTI_RECV, FI_RMA_EVENT, FI_SOURCE, FI_DIRECTED_RECV ]
        mode: [  ]
        op_flags: [  ]
        msg_order: [ FI_ORDER_RAR, FI_ORDER_RAW, FI_ORDER_RAS, FI_ORDER_WAW, FI_ORDER_WAS, FI_ORDER_SAW, FI_ORDER_SAS, FI_ORDER_RMA_RAR, FI_ORDER_RMA_RAW, FI_ORDER_RMA_WAW, FI_ORDER_ATOMIC_RAR, FI_ORDER_ATOMIC_RAW, FI_ORDER_ATOMIC_WAR, FI_ORDER_ATOMIC_WAW ]
        size: 1024
        iov_limit: 4
    fi_ep_attr:
        type: FI_EP_RDM
        protocol: FI_PROTO_RXD
        protocol_version: 1
        max_msg_size: 18446744073709551615
        msg_prefix_size: 0
        max_order_raw_size: 18446744073709551615
        max_order_war_size: 0
        max_order_waw_size: 18446744073709551615
        mem_tag_format: 0xaaaaaaaaaaaaaaaa
        tx_ctx_cnt: 1
        rx_ctx_cnt: 1
        auth_key_size: 0
    fi_domain_attr:
        domain: 0x0
        name: mlx5_0-dgram
        threading: FI_THREAD_SAFE
        progress: FI_PROGRESS_MANUAL
        resource_mgmt: FI_RM_ENABLED
        av_type: FI_AV_UNSPEC
        mr_mode: [  ]
        mr_key_size: 8
        cq_data_size: 8
        cq_cnt: 128
        ep_cnt: 128
        tx_ctx_cnt: 1
        rx_ctx_cnt: 1
        max_ep_tx_ctx: 1
        max_ep_rx_ctx: 1
        max_ep_stx_ctx: 0
        max_ep_srx_ctx: 0
        cntr_cnt: 0
        mr_iov_limit: 1
        caps: [  ]
        mode: [  ]
        auth_key_size: 0
        max_err_data: 0
        mr_cnt: 0
        tclass: 0x0
        max_ep_auth_key: 0
        max_group_id: 0
        max_cntr_value: 18446744073709551615
        max_err_cntr_value: 18446744073709551615
    fi_fabric_attr:
        name: IB-0xfe80000000000000
        prov_name: verbs;ofi_rxd
        prov_version: 116.0
        api_version: 1.16
    nic:
        fi_device_attr:
            name: mlx5_0
            device_id: 0x101b
            device_version: 0
            vendor_id: 0x02c9
            driver: (null)
            firmware: 20.33.1048
        fi_bus_attr:
            bus_type: FI_BUS_UNKNOWN
        fi_link_attr:
            address: (null)
            mtu: 4096
            speed: 0
            state: FI_LINK_UP
            network_type: InfiniBand
\f[R]
.fi
.PP
برای مشاهده متغیرهای محیطی مرتبط با libfabric از گزینه
\f[V]-e\f[R]
استفاده کنید.
.IP
.nf
\f[C]
$ ./fi_info -e
# FI_LOG_INTERVAL: Integer
# Delay in ms between rate limited log messages (default 2000)

# FI_LOG_LEVEL: String
# Specify logging level: warn, trace, info, debug (default: warn)

# FI_LOG_PROV: String
# Specify specific provider to log (default: all)

# FI_PROVIDER: String
# Only use specified provider (default: all available)
\f[R]
.fi
.PP
برای مشاهده متغیرهای محیطی مرتبط با libfabric حاوی زیررشته، از گزینه
\f[V]-g\f[R]
استفاده کنید.
.IP
.nf
\f[C]
$ ./fi_info -g tcp
# FI_OFI_RXM_DEF_TCP_WAIT_OBJ: String
# ofi_rxm: See def_wait_obj for description.  If set, this overrides the def_wait_obj when running over the tcp provider.  See def_wait_obj for valid values. (default: UNSPEC, tcp provider will select).

# FI_TCP_IFACE: String
# tcp: Specify interface name

# FI_TCP_PORT_LOW_RANGE: Integer
# tcp: define port low range

# FI_TCP_PORT_HIGH_RANGE: Integer
# tcp: define port high range

# FI_TCP_TX_SIZE: size_t
# tcp: define default tx context size (default: 256)

# FI_TCP_RX_SIZE: size_t
# tcp: define default rx context size (default: 256)

# FI_TCP_NODELAY: Boolean (0/1, on/off, true/false, yes/no)
# tcp: overrides default TCP_NODELAY socket setting

# FI_TCP_STAGING_SBUF_SIZE: Integer
# tcp: size of buffer used to coalesce iovec\[aq]s or send requests before posting to the kernel, set to 0 to disable

# FI_TCP_PREFETCH_RBUF_SIZE: Integer
# tcp: size of buffer used to prefetch received data from the kernel, set to 0 to disable

# FI_TCP_ZEROCOPY_SIZE: size_t
# tcp: lower threshold where zero copy transfers will be used, if supported by the platform, set to -1 to disable (default: 18446744073709551615)
\f[R]
.fi
.SH "همچنین ببینید (SEE ALSO)"
.PP
\f[V]fi_getinfo(3)\f[R], \f[V]fi_endpoint(3)\f[R]
.SH "نویسندگان (AUTHORS)"
OpenFabrics.