smbctune コマンド

目的

Server Message Block (SMB) クライアント・ファイルシステムのマウント操作のチューナブル・パラメーター内を設定および表示します。

構文

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

説明

-s フラグを指定してこのコマンドを実行すると、引数としてチューナブル・パラメーターを指定することによってチューナブル・パラメーターに新しい値を設定できます。 チューナブル・パラメーターに新しい値を設定すると、smbctune コマンドはチューナブル・パラメーターの新しい値でカーネルを更新します。 -p フラグを -s フラグとともに使用すると、smbctune コマンドは新しい値で /etc/smbc/smbctune.conf ファイルを更新し、チューナブル・パラメーターを永続的なものにします。 このファイルは、論理区画が開始し、SMB クライアント・サブシステムを初期化するときに使用されます。

mount コマンドで -o フラグを使用して pver、 signing、 secure_negotiate、および encryption パラメーターを指定しない場合、 smbctune.conf ファイルから読み取られるか、 smbctune コマンドを使用して設定されるカーネルのチューナブル・パラメーター値からデフォルト値が使用されます。

フラグ

-f

/etc/smbc/smbctune.conf ファイルで指定されたチューナブル・パラメーター値を表示します。

-l

カーネルで指定されたチューナブル・パラメーター値を表示します。

-p

値を /etc/smbc/smbctune.conf ファイルに書き込むことによってチューナブル・パラメーター値を永続的なものにします。 -s との併用のみが可能です。

-s smbc_tunable_parameter=価値

指定した値を指定したチューナブル・パラメーターに設定します。 複数のチューナブル・パラメーターを 1 つのコマンドで更新できます。 負の値を指定してはなりません。

smbc_max_concurrent_mount

smbcd デーモンが一度に実行可能な同時認証の最大数を指定します。 この値は、1 回で処理できる同時マウント操作の数のしきい値制限を示します。 このチューナブル・パラメーターに新しい値を設定すると、 smbctune コマンドは smbcd デーモンをリフレッシュして、 userspace デーモン内の対応する値がそれに応じて変更されるようにします。 このチューナブル・パラメーターの有効な値は、0 からINT_MAX-1の範囲です。 デフォルト値は 0 です。

smbc_request_timeout

SMB クライアント・システムから SMB サーバーへの要求がタイムアウトになるまでの待機時間 (秒) が指定されます。 このチューナブル・パラメーターが 0 に設定されている場合、要求は SMB クライアント・システムにおいて期限切れになりません。 このチューナブル・パラメーターの有効な値は、0 からINT_MAX-1の範囲です。 このチューナブル・パラメーターのデフォルト値は 0 です。

smbc_max_connections

任意の数の SMB サーバーで存続できる SMB クライアント接続の最大数が指定されます。 このチューナブル・パラメーターが 0 に設定されている場合、SMB クライアント・システムは SMB サーバーとの接続を無制限に確立できます。 このチューナブル・パラメーターの有効な値は、0 からINT_MAX-1の範囲です。 このチューナブル・パラメーターは、デフォルトで 0 に設定されます。

smbc_lookup_cache_size

SMB クライアント・ルックアップ・ファイルのキャッシュ・メモリー・サイズが指定されます。 このルックアップ・ファイルにより、N 個のファイル ID が開いたままになり、その ID がルックアップ操作に再利用できるようになります。 このルックアップ・ファイルの内容は、マウント操作ごとに実装される最長時間未使用 (LRU) のキャッシュ・メモリーに似ています。 キャッシュ・メモリーのサイズは、SMB クライアント・システムのマウント操作ごとに同じです。 キャッシュ・メモリーのサイズは負の値にできません。 このチューナブル・パラメーターには、有効な値として 0 から 100 までの範囲で値を指定できます。 デフォルト値は 32 個のキャッシュ・エントリーです。 SMB サーバーに接続している SMB クライアント・システムの数が少ない場合は、より大きな値を設定できます。

smbc_krb5_lifetime

トークンの有効期限時刻が指定されます。 SMB クライアント・システムと SMB サーバーは、トークンを使用して相互に通信します。 このトークンは一定期間有効です。 このトークンは、Kerberos 認証のデフォルト値に基づけば 10 時間有効です。 この期限を過ぎると、SMB クライアント・システムと SMB サーバーの間の認証済みセッションは期限切れになり、マウントされたリモート共有に対して他のいずれの操作も実行できなくなります。 トークンの有効期限時刻は SMB クライアント資格情報のキャッシュ・メモリーと、トークンの両方に、保存されます。 トークンの期間は、SMB サーバーに対して再認証することによって更新できます。 10 時間経過する前に SMB サーバーに対して再認証できるように、このチューナブル・パラメーターを 10 時間より短い値に設定します。 このチューナブル・パラメーターの有効な値は、0 からINT_MAX-1の範囲です。 デフォルト値は 0 です。

smbc_krb5_renew_till

トークン期間を更新するためにトークンを再認証できる最大時間 (秒) が指定されます。 この期間を過ぎると、既存のトークン・コンテキストは削除され、新しい認証済みトークン・コンテキストが作成されて使用されます。 このチューナブル・パラメーターの有効な値は、0 からINT_MAX-1の範囲です。 デフォルト値は 0 です。 Kerberos 認証は、それ独自のデフォルト値に従います。

smbc_file_lease_enable

SMB クライアント・ファイルシステムでリース機能が有効になります。 デフォルトでは、このチューナブル・パラメーターは有効になっており、各 SMB クライアント・ファイルシステムに適用可能です。

SMB クライアント・ファイルシステムは、ファイル・リース機能が SMB クライアント・システムと SMB サーバー・システムで有効になっていて、かつ SMB サーバーがファイル・リース機能をサポートする場合にのみ、ファイル・リース機能を使用できます。 ファイル・リース機能は、oplock 機能に優先します。 有効な値は 1 および 0 です。 このチューナブル・パラメーターの値は、SMB クライアント・マウント・ポイントが SMB クライアント・システムで使用できない場合にのみ変更します。

smbc_oplock_enable

SMB クライアント・システムのオポチュニスティック・ロック (oplock) 機能が有効になります。 デフォルトでは、このチューナブル・パラメーターは有効になっており、各 SMB クライアント・システムに適用可能です。

SMB クライアント・ファイルシステムは、oplock 機能が SMB サーバー・システムと SMB クライアント・システムで有効になっていて、かつファイル・リース機能が SMB サーバー・システムまたは SMB クライアント・システムで無効になっている場合にのみ、oplock 機能を使用できます。 有効な値は 1 および 0 です。 このチューナブル・パラメーターの値は、SMB クライアント・マウント・ポイントが SMB クライアント・システムで使用できない場合にのみ変更します。

注: SMB サーバーまたは SMB クライアント・システムがファイル・リース機能および oplock 機能を使用不可にすると、SMB クライアント・ファイルシステムは直接入出力操作を使用します。

smbc_protocol_version

SMB サーバーとの通信に使用される SMB プロトコルのバージョンが指定されます。 有効な値は 2.1、3.0.2、および auto です。 デフォルト値はautoです。 値が auto の場合、SMB サーバーの指定バージョンに基づいて、SMB クライアント・プロトコル・バージョン 2.1 またはバージョン 3.0.2 が使用されます。

smbc_signing

SMB クライアントのファイルシステムに通信用のデジタル署名が必要かどうかが指定されます。 有効な値は enabled と required です。 デフォルト値はenabledです。

smbc_secure_negotiate

SMB クライアントのファイルシステムにセキュア・ダイアレクト・ネゴシエーション機能が必要かどうかが指定されます。 有効な値は、desired、required、および disabled です。 デフォルト値は desired です。

smbc_encryption

SMB クライアント・ファイルシステムに暗号化が必要かどうかが指定されます。 有効な値は、desired、required、および disabled です。 デフォルト値は desired です。

終了状況

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 ファイルも更新します。これにより、更新は永続的になります。