smbcquotas — NTFS 5 共有の Quota 情報を取得・設定する
smbcquotas
{//server/share} [-u user] [-L] [-F] [-S QUOTA_SET_COMMAND] [-n] [-t] [-v] [-d debuglevel] [-s configfile] [-l logdir] [-V] [-U username] [-N] [-k] [-A]
smbcquotas
プログラムは下記のオプションを提供する :
Quota の情報の取得や設定を行うユーザを指定する。 デフォルトでは、カレントユーザが使用される。
共有の Quota のレコードを全て表示する。
共有の Quota のステータスとデフォルトの制限を表示する。
このコマンドはユーザか共有の Quota の設定や変更を行う。 ユーザか共有かどちらに対して操作が行われるかは、後述される QUOTA_SET_COMMAND により決まる。
このオプションは全ての Quota 情報を数値化した値で 表示する。デフォルトでは SID を名前に、Quota の上限を文字列に変換する。
実際に処理は行わず、指定した引数の正当性を検証する。
冗長モードにする。
コマンドラインオプションの要約を表示する。
level
は0から10までの整数値である。既定値の値は、パラメータが設定されていなければ0である。
この値を大きくするほど、サーバの動作に関するより詳細な情報がログファイルに記録される。レベル 0 では、致命的なエラーと重大な警告のみが記録される。レベル 1 は日々の運用に適しており、少量の稼働状況に関する情報を生成する。
1 より上のレベルは大量のログが生成されるので、問題解決の時にのみ使用すべきである。 3 より上のレベルは開発者だけが利用するように設計されており、莫大な量のログデータが生成される。そのほとんどは非常に謎めいた内容となっている
プログラムのバージョン番号を表示する。
サーバーが必要とする詳細な設定を含む設定ファイルを指定する。このファイルには、サーバーが提供するサービスに関する記述や、どの printcap ファイルを利用するかといった情報が含まれている。詳細はsmb.conf
を参照のこと。設定ファイルの名前の既定値は、コンパイル時に決定される。
ログ/デバッグファイルのファイル名。拡張子として".progname"
が追加される(例えば log.smbclient,log.smbd,など)。ログファイルはクライアントによって削除されることはない。
このオプションを指定すると、クライアントはユーザーへのパスワード入力要求をしなくなる。パスワードが必要ないサービスにアクセスするときに有用である。
コマンドラインにパスワードが指定されておらず、このオプションも指定されていないと、クライアントはパスワードを要求する。
もしも、パスワードがコマンドライン上で指定され、このオプションも定義されていた場合、コマンドライン上のパスワードは無視され、パスワードは使われない。
Kerberos による認証を試みる。アクティブディレクトリ環境でのみ有効である。
このオプションは、指定したファイルから、接続に使用するユーザー名とパスワードを読み込むために使用する。ファイルの形式は次の通り:
username =password = domain =
ファイルのパーミッションを確認し、ほかのユーザーから参照されないように注意すること。
SMB のユーザー名、またはユーザー名とパスワードを指定する。
もしも %password を指定しないと、ユーザーにパスワードの入力を求める。クライアントはまず初めにUSER
、LOGNAME
の順に環境変数の存在を調べ、もしもどちらかが存在するならば、その文字列を大文字にする。環境変数が存在しない場合、ユーザ名としてGUEST
が用いられる。
このほかに、平文のユーザー名とパスワードを記述した認証ファイルを使用するオプションがある。このオプションは主にスクリプト向けに用意されており、認証情報をコマンドラインや環境変数に含めたくない場合に有用である。このオプションを利用するときは、ファイルのパーミッションを確認し、ほかのユーザーから参照されないように注意すること。詳細は-A
オプションを参照のこと。
パスワードをスクリプトに含める場合は注意すること。多くのシステムでは、実行中のプロセスのコマンドラインはps
コマンドで参照することができてしまう。安全のため、必ず、rpcclient
を使用して、パスワード入力を要求し、直接入力するようにしておくこと。
QUOTA_SET_COMMANDの形式は、その操作に固有の一連のパラメータが伴う 操作名である。
-u で指定されたユーザかカレントユーザ特有の Quota 制限を設定する :
UQLIM:
共有のデフォルトの Quota 制限を設定する :
FSQLIM:
共有の Quota 設定を変更する :
FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT
すべての制限はバイト数によって指定される。
smbcquotas
コマンドは操作の成功か、それ以外かにより exit status をセットする。exit status は以下のうちのいずれかである :
操作が成功した場合、smbcquotas は exit status として 0 を返す。 もし smbcquotas
が指定されたサーバに接続できなかった場合や、 Quota の情報を取得やセットしようとしてエラーが出た場合、exit status の 1 が返される。もしコマンドラインの引数の構文解析に対してエラーがあった場合、 exit status の 2 が返される。