smbctune 命令

在线编辑

用途

设置并显示服务器消息块 (SMB) 客户机文件系统的安装操作的可调参数。

语法

smbctune [ -l | -f ] | [ [ -p ] -s smbc_tunable_parameter1=value smbc_tunable_parameter2=value …]

描述

您可以使用 -s 标志运行此命令，以通过将可调参数指定为自变量来设置可调参数的新值。 为可调参数设置新值时， smbctune 命令会使用可调参数的新值来更新内核。 如果将 -p 标志与 -s 标志一起使用，那么 smbctune 命令会使用新值更新 /etc/smbc/smbctune.conf 文件，以使可调参数具有持久性。 当逻辑分区启动并初始化 SMB 客户机子系统时，将使用此文件。

如果未使用 -o 标志将 pver， signing， secure_negotiate和 encryption 参数与 mount 命令一起指定，那么将从内核中的可调参数值中使用缺省值，这些参数值是从 smbctune.conf 文件中读取的参数值或使用 smbctune 命令设置的参数值。

标志

-f
显示 /etc/smbc/smbctune.conf 文件中指定的可调参数值。
-l
显示内核中指定的可调参数值。
-p
通过将值写入 /etc/smbc/smbctune.conf 文件，使可调参数值具有持久性。 只能与-s 一起使用。
-s 可调参数=价值
将指定的值设置为指定的可调参数。 您可以在单个命令中更新多个可调参数。 不得指定任何负值。
smbc_最大并发挂载数
指定 smbcd 守护程序一次可以执行的最大并发认证数。 此值指示一次可以处理的并发安装操作数目的阈值限制。 当您对此可调参数设置新值时， smbctune 命令将刷新 smbcd 守护程序，以便 userspace 守护程序中的相应值相应地更改。 此可调参数的有效值可以在 0-INT_MAX-1范围内。 缺省值为 0。
smbc_请求超时
指定 SMB 客户机系统针对 SMB 服务器的请求超时之前等待的时间（秒）。 此可调参数设置为 0 时，SMB 客户机系统上的请求不会到期。 此可调参数的有效值可以在 0-INT_MAX-1范围内。 此可调参数的缺省值为 0。
smbc_最大连接数
指定可以与任意数量的 SMB 服务器存在的最大 SMB 客户机连接数。 当此可调参数设置为 0 时，SMB 客户机系统可以与 SMB 服务器建立无限数量的连接。 此可调参数的有效值可以在 0-INT_MAX-1范围内。 缺省情况下，此可调参数设置为 0。
smbc_查找缓存大小
指定 SMB 客户机查询文件的高速缓存内存大小。 此查询文件使 N 个文件标识保持打开状态，以便可以复用这些标识进行查询操作。 此查询文件的内容类似于为每个安装操作实现的最近最少使用的 (LRU) 高速缓存内存。 对于 SMB 客户机系统的每个安装操作，高速缓存内存的大小相同。 高速缓存内存的大小不能为负值。 此可调参数的有效值可以在 0 到 100 范围内。 缺省值为 32 个高速缓存条目。 如果连接到 SMB 服务器的 SMB 客户机系统数量较少，您可以设置更大的值。
smbc_krb5_lifetime
指定令牌到期时间。 SMB 客户机系统与 SMB 服务器通过使用令牌互相进行通信。 此令牌在特定时间段内有效。 根据 Kerberos 认证的缺省值，令牌的有效期为 10 小时。 经过该时间段之后，SMB 客户机系统与 SMB 服务器之间经过认证的会话将到期，您无法对已安装的远程共享执行任何其他操作。 令牌到期时间将同时保存在 SMB 客户机凭证的高速缓存内存中以及令牌中。 可以通过向 SMB 服务器重新进行认证来更新令牌的持续时间。 可以将此可调参数设置为小于 10 小时的值，以便您可以在 10 小时之前向 SMB 服务器重新进行认证。 此可调参数的有效值可以在 0-INT_MAX-1范围内。 缺省值为 0。
smbc_krb5_renew_till
指定可以重新认证令牌以更新令牌持续时间的最长时间（秒）。 经过此时间段之后，将删除现有令牌上下文，并创建和使用经过认证的新的令牌上下文。 此可调参数的有效值可以在 0-INT_MAX-1范围内。 缺省值为 0。 Kerberos 认证遵循它自己的缺省值。
smbc_文件租约启用
在 SMB 客户机文件系统中启用租用功能。 缺省情况下，此可调参数处于启用状态，并且适用于每个 SMB 客户机文件系统。

仅当在 SMB 客户机和 SMB 服务器系统中启用了文件租赁功能，并且 SMB 服务器支持文件租赁功能时， SMB 客户机文件系统才能使用文件租赁功能。 文件租用功能优先于 oplock 功能。 有效值为 1 和 0。 仅当 SMB 客户机系统上没有 SMB 客户机安装点时，您才能更改此可调参数的值。

smbc_oplock_启用
为 SMB 客户机系统启用机会锁 (oplock) 功能。 缺省情况下，此可调参数处于启用状态，并且适用于每个 SMB 客户机系统。
仅当在 SMB 服务器和 SMB 客户机系统中启用了 oplock 功能，并且在 SMB 服务器或 SMB 客户机系统中禁用了文件租赁功能时， SMB 客户机文件系统才能使用 oplock 功能。 有效值为 1 和 0。 仅当 SMB 客户机系统上没有 SMB 客户机安装点时，您才能更改此可调参数的值。
注: 当 SMB 服务器或 SMB 客户机系统禁用文件租赁功能和 oplock 功能时， SMB 客户机文件系统使用直接 I/O 操作。
smbc_协议版本
指定用来与 SMB 服务器进行通信的 SMB 协议的版本。 有效值为 2.1、3.0.2 和 auto。 缺省值为 auto。 对于值 auto，将根据 SMB 服务器的指定版本使用 SMB 客户机协议版本 2.1 或版本 3.0.2 。
smbc_签名
指定 SMB 客户机的文件系统是否需要数字签名进行通信。 有效值为 enabled 和 required。 缺省值为 enabled。
smbc_secure_协商
指定 SMB 客户机的文件系统是否需要安全方言协商功能。 有效值为 desired， required和 disabled。 缺省值为 desired。
smbc_加密
指定 SMB 客户机文件系统是否需要加密。 有效值为 desired， required和 disabled。 缺省值为 desired。
下表显示了 smbctune.conf 文件中的几个可调参数及其 mount 命令的对等选项。
smbctune.conf 文件的可调参数 相应的安装选项 有效可调参数值 (smbctune.conf 文件) 缺省可调参数值 (smbctune.conf 文件)
smbc_协议版本 帕弗 2.1， 3.0.2， auto auto
smbc_签名 签名 已启用，必需 启用
smbc_secure_协商 secure_协商 所需，必需，已禁用 期望
smbc_加密 加密 (encryption) 所需，必需，已禁用 期望

退出状态

0
指示成功。
>0
指示错误。

示例

  • 要将 smbc_max_concurrent_mount 可调参数的值设置为 20 ，请输入以下命令:
    /usr/sbin/smbctune -s smbc_max_concurrent_mount=20
  • 要更新 smbc_max_concurrent_mount 可调参数值，请输入以下命令:
    /usr/sbin/smbctune -p -s smbc_max_concurrent_mount=20
    注: 此命令还会更新 smbctune.conf 文件，这将使更新具有持久性。