xref: /linux/Documentation/networking/smc-sysctl.rst (revision a23e1966932464e1c5226cb9ac4ce1d5fc10ba22)
112bbb0d1SDust Li.. SPDX-License-Identifier: GPL-2.0
212bbb0d1SDust Li
3f9f52c34SDust Li==========
412bbb0d1SDust LiSMC Sysctl
5f9f52c34SDust Li==========
612bbb0d1SDust Li
712bbb0d1SDust Li/proc/sys/net/smc/* Variables
8f9f52c34SDust Li=============================
912bbb0d1SDust Li
1012bbb0d1SDust Liautocorking_size - INTEGER
1112bbb0d1SDust Li	Setting SMC auto corking size:
1212bbb0d1SDust Li	SMC auto corking is like TCP auto corking from the application's
1312bbb0d1SDust Li	perspective of view. When applications do consecutive small
1412bbb0d1SDust Li	write()/sendmsg() system calls, we try to coalesce these small writes
1512bbb0d1SDust Li	as much as possible, to lower total amount of CDC and RDMA Write been
1612bbb0d1SDust Li	sent.
1712bbb0d1SDust Li	autocorking_size limits the maximum corked bytes that can be sent to
1812bbb0d1SDust Li	the under device in 1 single sending. If set to 0, the SMC auto corking
1912bbb0d1SDust Li	is disabled.
2012bbb0d1SDust Li	Applications can still use TCP_CORK for optimal behavior when they
2112bbb0d1SDust Li	know how/when to uncork their sockets.
2212bbb0d1SDust Li
2312bbb0d1SDust Li	Default: 64K
244bc5008eSWen Gu
254bc5008eSWen Gusmcr_buf_type - INTEGER
264bc5008eSWen Gu        Controls which type of sndbufs and RMBs to use in later newly created
274bc5008eSWen Gu        SMC-R link group. Only for SMC-R.
284bc5008eSWen Gu
294bc5008eSWen Gu        Default: 0 (physically contiguous sndbufs and RMBs)
304bc5008eSWen Gu
314bc5008eSWen Gu        Possible values:
324bc5008eSWen Gu
334bc5008eSWen Gu        - 0 - Use physically contiguous buffers
344bc5008eSWen Gu        - 1 - Use virtually contiguous buffers
354bc5008eSWen Gu        - 2 - Mixed use of the two types. Try physically contiguous buffers first.
364bc5008eSWen Gu          If not available, use virtually contiguous buffers then.
3777eee325SWen Gu
3877eee325SWen Gusmcr_testlink_time - INTEGER
3977eee325SWen Gu	How frequently SMC-R link sends out TEST_LINK LLC messages to confirm
4077eee325SWen Gu	viability, after the last activity of connections on it. Value 0 means
4177eee325SWen Gu	disabling TEST_LINK.
4277eee325SWen Gu
4377eee325SWen Gu	Default: 30 seconds.
440227f058STony Lu
450227f058STony Luwmem - INTEGER
460227f058STony Lu	Initial size of send buffer used by SMC sockets.
470227f058STony Lu
480227f058STony Lu	The minimum value is 16KiB and there is no hard limit for max value, but
490227f058STony Lu	only allowed 512KiB for SMC-R and 1MiB for SMC-D.
500227f058STony Lu
51a1602d74SGerd Bayer	Default: 64KiB
520227f058STony Lu
530227f058STony Lurmem - INTEGER
540227f058STony Lu	Initial size of receive buffer (RMB) used by SMC sockets.
550227f058STony Lu
560227f058STony Lu	The minimum value is 16KiB and there is no hard limit for max value, but
570227f058STony Lu	only allowed 512KiB for SMC-R and 1MiB for SMC-D.
580227f058STony Lu
59a1602d74SGerd Bayer	Default: 64KiB
60f8e80fc4SGuangguan Wang
61f8e80fc4SGuangguan Wangsmcr_max_links_per_lgr - INTEGER
62f8e80fc4SGuangguan Wang	Controls the max number of links can be added to a SMC-R link group. Notice that
63f8e80fc4SGuangguan Wang	the actual number of the links added to a SMC-R link group depends on the number
64f8e80fc4SGuangguan Wang	of RDMA devices exist in the system. The acceptable value ranges from 1 to 2. Only
65f8e80fc4SGuangguan Wang	for SMC-R v2.1 and later.
66f8e80fc4SGuangguan Wang
67f8e80fc4SGuangguan Wang	Default: 2
681f2c9dd7SGuangguan Wang
691f2c9dd7SGuangguan Wangsmcr_max_conns_per_lgr - INTEGER
701f2c9dd7SGuangguan Wang	Controls the max number of connections can be added to a SMC-R link group. The
711f2c9dd7SGuangguan Wang	acceptable value ranges from 16 to 255. Only for SMC-R v2.1 and later.
721f2c9dd7SGuangguan Wang
731f2c9dd7SGuangguan Wang	Default: 255
74