Manpages

NAME

smbclient − サ ー バ 上 の SMB/CIFS リ ソ ー ス に ア ク セ ス す る ftp の よ う な ク ラ イ ア ン ト

SYNOPSIS

smbclient servicename [ password ] [ -b <buffer size> ] [ -d debuglevel ] [ -D Directory ] [ -U username ] [ -W workgroup ] [ -M <netbios name> ] [ -m maxprotocol ] [ -A authfile ] [ -N ] [ -l logfile ] [ -L <netbios name> ] [ -I destinationIP ] [ -E <terminal code> ] [ -c <command string> ] [ -i scope ] [ -O <socket options> ] [ -p port ] [ -R <name resolve order> ] [ -s <smb config file> ] [ -T<c|x>IXFqgbNan ]

DESCRIPTION

こ の ツ ー ル は Samba <URL:samba.7.html> ス イ ー ト の 一 部 で あ る 。

smbclient は SMB/CIFS サ ー バ と 「 会 話 」 を す る こ と が で き る ク ラ イ ア ン ト で あ る 。 ftp プ ロ グ ラ ム (ftp(1)を 参 照 )と よ く 似 た イ ン タ ー フ ェ ー ス を 提 供 し 、 サ ー バ か ら ロ ー カ ル マ シ ン へ フ ァ イ ル を ダ ウ ン ロ ー ド し た り 、 ロ ー カ ル マ シ ン か ら サ ー バ へ と フ ァ イ ル を ア ッ プ ロ ー ド し た り 、 サ ー バ か ら デ ィ レ ク ト リ 情 報 を 取 得 す る な ど の 動 作 を 行 う 。

オ プ シ ョ ン

servicename

servicename は 利 用 し た い サ ー ビ ス の サ ー バ 上 で の 名 前 で あ る 。 サ ー ビ ス 名 は //server/service の よ う な 形 を と る 。 server は 利 用 し た い サ ー ビ ス を 提 供 し て い る SMB/CIFS サ ー バ の NetBIOS 名 で あ り 、 service は 提 供 さ れ て い る サ ー ビ ス の 名 前 で あ る 。 し た が っ て 、 SMB/CIFS サ ー バ "smbserver" の "printer" と い う サ ー ビ ス に 接 続 す る に は 、 次 の よ う な サ ー ビ ス 名 を 使 用 す る 。 //smbserver/printer 必 要 と さ れ る サ ー バ 名 が 、 一 概 に サ ー バ の IP(DNS)ホ ス ト 名 で あ る と は 限 ら な い こ と に 注 意 ! 必 要 と さ れ る 名 前 が NetBIOS 名 で あ り 、 そ の 名 前 は サ ー バ の 動 作 し て い る マ シ ン の IPホ ス ト 名 と 同 じ か も 知 れ な い し 、 異 な っ て い る か も 知 れ な い 。 サ ー バ 名 を 解 決 す る 方 法 は 、 smbclient の -R オ プ シ ョ ン か 、 smb.conf フ ァ イ ル 中 の name resolve order パ ラ メ ー タ に よ っ て 決 定 さ れ る 。 こ の パ ラ メ ー タ に よ り 、 管 理 者 が 、 名 前 解 決 の 順 番 や 方 式 を 変 更 す る 事 が 可 能 に な っ て い る 。

password 指 定 し た サ ー バ の サ ー ビ ス へ ア ク セ ス す る た め に 必 要 な パ ス ワ ー ド 。 こ の パ ラ メ ー タ が 指 定 さ れ た 場 合 、 -Nオ プ シ ョ ン (パ ス ワ ー ド プ ロ ン プ ト の 抑 止 ) が 自 動 的 に 設 定 さ れ る 。 デ フ ォ ル ト の パ ス ワ ー ド は な い 。 (こ の パ ラ メ ー タ を 用 い る か 、 -U オ プ シ ョ ン (以 下 を 参 照 )で パ ス ワ ー ド が 指 定 さ れ な か っ た 事 に よ り ) パ ス ワ ー ド が コ マ ン ド ラ イ ン か ら 指 定 さ れ ず 、 -N オ プ シ ョ ン も 指 定 さ れ て い な い 場 合 、 サ ー バ が パ ス ワ ー ド を 要 求 し て い る か ど う か に 関 わ ら ず 、 ク ラ イ ア ン ト は パ ス ワ ー ド 入 力 を 求 め る 。 (パ ス ワ ー ド が 必 要 で な い 場 合 は 、 単 に ENTER キ ー を 入 力 す る 事 で 、 空 の パ ス ワ ー ド を 渡 せ ば よ い 。 ) 注 意 : あ る 種 の サ ー バ (OS/2、 Windows for Workgroup な ど )は 、 大 文 字 の パ ス ワ ー ド を 要 求 す る 。 小 文 字 や 、 大 文 字 小 文 字 の 混 じ っ た パ ス ワ ー ド は 拒 否 さ れ る で あ ろ う 。 パ ス ワ ー ド を ス ク リ プ ト 中 に 記 述 す る と き は 、 十 分 注 意 す る こ と 。
-s smb.conf 重 要 な フ ァ イ ル smb.conf の 位 置 を 指 定 す る 。
-O socket options ク ラ イ ア ン ト 側 の ソ ケ ッ ト に 設 定 す る 、 TCP ソ ケ ッ ト の オ プ シ ョ ン で あ る 。 有 効 な オ プ シ ョ ン に つ い て は 、 smb.conf (5) マ ニ ュ ア ル ペ ー ジ 中 の 、 socket options パ ラ メ ー タ を 参 照 の こ と 。
-R <name resolve order> こ の オ プ シ ョ ン は Samba ス イ ー ト に 含 ま れ る プ ロ グ ラ ム が ホ ス ト 名 か ら IPア ド レ ス を 解 決 す る 際 の 手 段 、 順 序 を 決 定 す る の に 使 用 さ れ る 。 オ プ シ ョ ン は 、 名 前 解 決 の 手 段 ご と に 異 な る 、 ス ペ ー ス で 区 切 ら れ た 文 字 列 で あ る 。 オ プ シ ョ ン は 以 下 の 通 り : "lmhosts"、 "host"、 "wins" そ し て "bcast"。 こ れ ら は 、 以 下 の よ う な 名 前 解 決 を 行 う 。

こ の パ ラ メ ー タ が 設 定 さ れ て い な か っ た 場 合 、 smb.conf フ ァ イ ル 中 で 設 定 さ れ た (name resolve order) パ ラ メ ー タ が 使 わ れ る 。 デ フ ォ ル ト の 順 序 は 、 lmhosts、 host、 wins、 bcast で あ り 、 こ の パ ラ メ ー タ が 指 定 さ れ ず 、 smb.conf フ ァ イ ル 中 の name resolve order パ ラ メ ー タ も 記 述 さ れ て い な い 場 合 、 こ の 順 に 名 前 解 決 が 試 行 さ れ る 。

-M NetBIOS name こ の オ プ シ ョ ン を 指 定 す る と 、 "WinPopup" プ ロ ト コ ル を 使 っ て 、 別 の コ ン ピ ュ ー タ へ メ ッ セ ー ジ を 送 信 す る 事 が で き る 。 接 続 が 確 立 し て か ら 任 意 の メ ッ セ ー ジ を 入 力 す る 。 終 了 す る に は 、 ^D (control-D) を 入 力 す る 。 受 信 し た コ ン ピ ュ ー タ で WinPopup が 起 動 し て い れ ば 、 ユ ー ザ は お そ ら く ビ ー プ 音 と と も に 、 メ ッ セ ー ジ を 受 信 す る 事 に な る 。 WinPopup が 起 動 し て い な い と メ ッ セ ー ジ は 失 わ れ 、 な ん の エ ラ ー メ ッ セ ー ジ も 表 示 さ れ な い 。

1600 byte を 越 え る メ ッ セ ー ジ は 、 プ ロ ト コ ル の 仕 様 に よ る 制 限 の た め 、 自 動 的 に 切 り 捨 て ら れ る 。 便 利 な 使 用 例 と し て 、 smbclient を 通 し て メ ッ セ ー ジ を cat す る 方 法 を 紹 介 し よ う 。 例 え ば cat mymessage.txt | smbclient -M FRED と す る と 、 mymessage.txt フ ァ イ ル の 内 容 を メ ッ セ ー ジ と し て マ シ ン FRED に 送 る こ と が で き る 。 ま た -U や -I オ プ シ ョ ン も 、 メ ッ セ ー ジ の FROM や TO に 相 当 す る 設 定 を 指 定 し た い 場 合 は 、 便 利 な こ と も あ る 。

Samba で WinPopup メ ッ セ ー ジ を 受 け 取 る 方 法 は 、 smb.conf(5) の message command パ ラ メ ー タ を 参 照 の こ と 。 注 意 : WfWg PC で 常 に メ ッ セ ー ジ を 受 信 で き る よ う に し た い な ら 、 startup グ ル ー プ に WinPopup を コ ピ ー す る こ と 。

-i scope こ の パ ラ メ ー タ は 、 smbclient が 生 成 さ れ た NetBIOS 名 と 通 信 す る 際 に 用 い る NetBIOS ス コ ー プ を 指 定 す る 。 NetBIOS ス コ ー プ に つ い て の 詳 細 は 、 rfc1001.txt と rfc1002.txt を 参 照 の こ と 。 NetBIOS ス コ ー プ は 、 非 常 に 稀 に し か 用 い ら れ な い 。 こ の パ ラ メ ー タ を 設 定 で き る の は 、 シ ス テ ム 管 理 者 と し て 、 互 い に 通 信 す る 必 要 が あ る 全 て の NetBIOS マ シ ン の 管 理 責 任 を 持 っ て い る 時 く ら い だ ろ う 。

-n NetBIOS name デ フ ォ ル ト で は 、 ク ラ イ ア ン ト は NetBIOS 名 と し て 、 ロ ー カ ル マ シ ン の ホ ス ト 名 (を 大 文 字 化 し た も の )を 用 い る 。 こ の パ ラ メ ー タ は 、 ホ ス ト 名 を 置 き 換 え て 、 任 意 の NetBIOS 名 を 用 い る 事 を 可 能 に す る 。
-d debuglevel

debuglevel は 、 0 か ら 10 の 整 数 か 、 英 文 字 A を 指 定 す る 。 こ の パ ラ メ ー タ が 指 定 さ れ て い な い と き の デ フ ォ ル ト 値 は 0 で あ る 。 こ の 値 を 大 き く す る ほ ど 、 ク ラ イ ア ン ト の よ り 詳 細 な 動 作 状 況 が ロ グ フ ァ イ ル に 記 録 さ れ る 。 レ ベ ル 0 で は 、 致 命 的 な エ ラ ー や 非 常 に 重 大 な 警 告 の み が 記 録 さ れ る 。 レ ベ ル 1 は 、 日 常 的 に 使 用 す の に 適 し た レ ベ ル で あ り 、 実 行 さ れ た 操 作 に つ い て の 小 量 の 情 報 が 生 成 さ れ る 。

1 よ り 大 き い レ ベ ル を 指 定 し た 場 合 は 、 大 量 の ロ グ が 生 成 さ れ る の で 、 問 題 解 決 の 時 に の み 使 用 す べ き で あ る 。 3 よ り 大 き い レ ベ ル は 、 開 発 者 だ け が 利 用 す る よ う に 設 計 さ れ て お り 、 莫 大 な 量 の デ ー タ を 出 力 す る が 、 ほ と ん ど は 暗 号 の よ う な も の で あ る 。 debuglevel に A を 指 定 す る と 、 全 て の デ バ ッ グ メ ッ セ ー ジ が 出 力 さ れ る 。 こ れ は 、 開 発 者 (お よ び コ ー ド が 内 部 的 に ど の よ う に 実 行 さ れ て い る か を 本 当 に 知 り た い 人 ) 用 の 設 定 で あ る 。 こ の パ ラ メ ー タ を 指 定 す る と 、 smb.conf(5) フ ァ イ ル に 設 定 し た log level パ ラ メ ー タ よ り 優 先 さ れ る 事 に 注 意 。

-p port こ の 値 は 、 サ ー バ へ 接 続 す る と き に 利 用 す る TCP の ポ ー ト 番 号 で あ る 。 SMB/CIFS サ ー バ 用 の 標 準 の (well-known) TCP ポ ー ト 番 号 は 139 で あ り 、 こ れ が デ フ ォ ル ト 値 で あ る 。
-l logfilename 指 定 す る と 、 logfilenameは 、 ロ グ フ ァ イ ル の ベ ー ス 名 (base name) を 指 定 す る 。 こ の フ ァ イ ル に は 、 動 作 中 の ク ラ イ ア ン ト が 操 作 デ ー タ を 記 録 す る 。 デ フ ォ ル ト の ベ ー ス 名 は 、 コ ン パ イ ル 時 に 指 定 さ れ る 。 ベ ー ス 名 は 、 実 際 の ロ グ フ ァ イ ル 名 を 生 成 す る 際 に 用 い ら れ る 。 例 え ば ベ ー ス 名 が "log" の 場 合 、 デ バ ッ グ フ ァ イ ル 名 は 、 log.client の よ う に な る 。 生 成 さ れ た ロ グ フ ァ イ ル は 、 ク ラ イ ア ン ト に よ っ て 削 除 さ れ る 事 は な い 。

-I IP-address

IP address は 接 続 す る サ ー バ の IP ア ド レ ス を 表 す 。 こ れ は 、 標 準 的 な "a.b.c.d" 形 式 で 指 定 す る 。 通 常 ク ラ イ ア ン ト は 前 述 し た name resolve order パ ラ メ ー タ 中 で 記 述 し た NetBIOS 名 の 解 決 メ カ ニ ズ ム を 用 い て 検 索 す る 事 に よ り 、 そ の SMB/CIFS サ ー バ の ア ド レ ス を 解 決 し よ う と す る 。 こ の パ ラ メ ー タ を 使 う こ と で 、 ク ラ イ ア ン ト は 、 強 制 的 に 指 定 さ れ た IP ア ド レ ス を サ ー バ の IP ア ド レ ス と み な し 、 接 続 し よ う と し て い る リ ソ ー ス の NetBIOS 名 は 無 視 さ れ る 。 こ の パ ラ メ ー タ の デ フ ォ ル ト 値 は な い 。 こ の パ ラ メ ー タ が 指 定 さ れ な け れ ば 、 ア ド レ ス は 、 前 述 し た よ う に し て ク ラ イ ア ン ト が 自 動 的 に 決 定 す る 。

(stderr)に 出 力 す る よ う に す る 。 デ フ ォ ル ト で は 、 ク ラ イ ア ン ト は メ ッ セ ー ジ を 標 準 出 力 - 一 般 的 に は ユ ー ザ の tty - に 出 力 す る 。
-U username[%pass]

SMB の ユ ー ザ 名 、 ま た は ユ ー ザ 名 と パ ス ワ ー ド を 与 え る 。 %pass が 指 定 さ れ な け れ ば 、 ユ ー ザ に 問 い 合 わ さ れ る 。 ク ラ イ ア ン ト は ま ず USER 環 境 変 数 を チ ェ ッ ク し 、 次 に LOGNAME を チ ェ ッ ク す る 。 い ず れ か が 存 在 す れ ば そ の 値 の 文 字 列 を 大 文 字 に す る 。 そ れ ら の 変 数 に ’%’ 記 号 が 含 ま れ て い れ ば 、 そ れ 以 降 は パ ス ワ ー ド と し て 扱 わ れ る 。 こ れ ら の 環 境 変 数 が 見 つ か ら な け れ ば 、 ユ ー ザ 名 に は GUEST が 使 用 さ れ る 。 環 境 変 数 に (%pass 形 式 を 使 用 し た )パ ス ワ ー ド が 含 ま れ て い な け れ ば 、 smbclient は パ ス ワ ー ド を 得 る た め に PASSWD 環 境 変 数 を 探 す 。 -Afor more details. 第 三 の 選 択 肢 は 、 ド メ イ ン 名 、 ユ ー ザ 名 と パ ス ワ ー ド を 平 文 で 書 い た 「 証 明 書 フ ァ イ ル 」 の 使 用 で あ る 。 こ の 方 法 は 、 主 に コ マ ン ド ラ イ ン や 環 境 変 数 を 経 由 し て パ ス ワ ー ド を 扱 う こ と が 好 ま れ な い ス ク リ プ ト の た め に 提 供 さ れ る 。 こ の 方 法 を 使 用 す る と き は 、 好 ま し く な い ユ ー ザ が フ ァ イ ル に ア ク セ ス で き な い よ う に パ ー ミ ッ シ ョ ン が 正 し く 設 定 さ れ て い る こ と を 確 認 す る こ と 。 詳 細 は -A を 参 照 。 パ ス ワ ー ド を ス ク リ プ ト や PASSWD 環 境 変 数 に 含 め る 時 は 注 意 深 く 行 う こ と 。 多 く の シ ス テ ム で は 、 実 行 中 の プ ロ セ ス の コ マ ン ド ラ イ ン は ps コ マ ン ド で 表 示 さ れ て し ま う 。 安 全 の 為 に は 、 常 に smbclient が パ ス ワ ー ド プ ロ ン プ ト を 表 示 す る よ う に し 、 パ ス ワ ー ド を 直 接 入 力 す る よ う に す る こ と 。

-A filename こ の オ プ シ ョ ン に は 接 続 に 使 用 す る ユ ー ザ 名 、 ド メ イ ン 名 、 パ ス ワ ー ド を 読 み 込 む た め の フ ァ イ ル を 指 定 す る 。 フ ァ イ ル の フ ォ ー マ ッ ト は 次 の と お り 。

username = <value>
password = <value>
domain = <value>

smbclient -L host の よ う に し て 使 う と 、 サ ー ビ ス の 一 覧 が 表 示 さ れ る 。 NetBIOS 名 が TCP/IP の DNS の ホ ス ト 名 に 一 致 し な い 場 合 や 、 別 の ネ ッ ト ワ ー ク 上 の ホ ス ト の 情 報 を 表 示 し よ う と し て い る 場 合 は 、 -I オ プ シ ョ ン が 役 に た つ 。
-t terminal code こ の オ プ シ ョ ン は 、 smbclient に 対 し て リ モ ー ト サ ー バ が 表 示 す る フ ァ イ ル 名 を ど の よ う に 変 換 す べ き か を 指 定 す る 。 通 常 、 ア ジ ア 言 語 の マ ル チ バ イ ト 文 字 の UNIX 上 で の 実 装 は 、 SMB/CIFS サ ー バ と 異 な る 文 字 セ ッ ト を 使 用 し て い る (例 え ば SJIS と EUC の よ う に )。 こ の パ ラ メ ー タ を 設 定 す る こ と で 、 smbclient は UNIX 上 の フ ァ イ ル 名 と SMB サ ー バ 上 の フ ァ イ ル 名 と の 変 換 を 正 し く 行 う よ う に な る 。 こ の オ プ シ ョ ン は 厳 格 に テ ス ト さ れ た も の で は な く 、 多 少 問 題 が あ る か も 知 れ な い 。

terminal code に は sjis、 euc、 jis7、 jis8, junet、 hex、 cap が あ る 。 こ れ は 全 て で は な く 、 完 全 な リ ス ト は 、 Samba の ソ ー ス コ ー ド を チ ェ ッ ク し て 欲 し い 。

-b buffersize こ の オ プ シ ョ ン は サ ー バ と フ ァ イ ル の 送 受 信 を 行 な う と き の 送 受 信 バ ッ フ ァ の サ イ ズ を 変 更 す る 。 デ フ ォ ル ト 値 は 65520 バ イ ト で あ る 。 こ の 値 を (最 小 1200 バ イ ト ま で )小 さ く す る こ と で 、 Windows 9x サ ー バ と の フ ァ イ ル の 転 送 が ス ピ ー ド ア ッ プ す る こ と が 確 認 さ れ て い る 。
-W WORKGROUP 接 続 時 に smb.conf に 記 述 さ れ て い る workgroup パ ラ メ ー タ で 指 定 さ れ た デ フ ォ ル ト の ワ ー ク グ ル ー プ (ド メ イ ン )名 よ り も 優 先 す る 。 こ れ は 特 定 の サ ー バ へ の 接 続 時 に 必 要 か も 知 れ な い 。
-T tar options

smbclient は SMB/CIFS 共 有 上 の 全 て の フ ァ イ ル に お い て 、 tar(1) 互 換 の バ ッ ク ア ッ プ を 行 う 事 が で き る 。 こ の オ プ シ ョ ン に 設 定 可 能 な 副 次 的 な tar フ ラ グ は 以 下 の と お り 。

Tar に お け る 長 い フ ァ イ ル 名

smbclient の tar オ プ シ ョ ン は 、 現 在 バ ッ ク ア ッ プ と リ ス ト ア の 両 方 で 長 い フ ァ イ ル 名 を サ ポ ー ト し て い る 。 し か し 、 フ ァ イ ル の フ ル パ ス 名 は 1024 バ イ ト 以 下 で あ る 必 要 が あ る 。 ま た tar ア ー カ イ ブ が 作 成 さ れ た 時 、 smbclient の tar オ プ シ ョ ン は そ の ア ー カ イ ブ 内 の 全 て の フ ァ イ ル を 絶 対 フ ァ イ ル 名 で は な く 、 相 対 フ ァ イ ル 名 で 記 録 す る 。

Tar フ ァ イ ル 名 全 て の フ ァ イ ル に は 、 DOS の パ ス 名 (’\’を パ ス 名 の 区 切 り と す る ) を 付 与 す る か 、 UNIX の パ ス 名 (’/’を パ ス 名 の 区 切 り と す る ) を 付 与 す る こ と が で き る 。 例

tar フ ァ イ ル の backup.tar を mypc 上 の myshare (パ ス ワ ー ド な し )に リ ス ト ア す る 。

smbclient //mypc/yshare "" -N -Tx backup.tar

users/docs 以 外 の 全 て を リ ス ト ア す る

smbclient //mypc/myshare "" -N -TXx backup.tar users/docs

users/docs 配 下 の フ ァ イ ル を 含 む tar フ ァ イ ル を 作 成 す る 。

smbclient //mypc/myshare "" -N -Tc backup.tar users/docs 上 記 と 同 じ tar フ ァ イ ル を 作 成 す る が 、 DOS の パ ス 名 を 使 用 す る 。

smbclient //mypc/myshare "" -N -Tc backup.tar users\\edocs

(訳 注 : 原 文 は -tc と な っ て い る が 、 -Tc が 正 し い と 思 わ れ る 。 ま た 、 \ は コ マ ン ド ラ イ ン 上 で は \\ と す る 必 要 が あ る 。 共 有 上 に あ る 全 て の フ ァ イ ル と デ ィ レ ク ト リ を 含 む tar フ ァ イ ル を 作 成 す る 。

smbclient //mypc/myshare "" -N -Tc backup.tar *
-D initial directory 動 作 を 開 始 す る 前 に 、 デ ィ レ ク ト リ initial directory に 移 動 す る 。 お そ ら く 、 利 用 さ れ る の は tar オ プ シ ョ ン -T が 指 定 さ れ た と き だ け だ ろ う 。
-c command string

command string は セ ミ コ ロ ン で 区 切 っ た コ マ ン ド の リ ス ト で あ る 。 こ の コ マ ン ド は 、 標 準 入 力 か ら 受 け 取 る コ マ ン ド の 代 わ り に 実 行 さ れ る 。 -N オ プ シ ョ ン が -c オ プ シ ョ ン に よ っ て 、 暗 黙 の 内 に 設 定 さ れ る 。 こ の オ プ シ ョ ン が 特 に 役 立 つ の は 、 ス ク リ プ ト で 利 用 し た り 、 標 準 入 力 を 例 え ば -c ’print -’ の よ う に し て サ ー バ に 出 力 し た り す る 場 合 で あ る 。

オ ペ レ ー シ ョ ン (操 作 )

ク ラ イ ア ン ト が 起 動 す る と 、 ユ ー ザ に は 以 下 の よ う な プ ロ ン プ ト が 表 示 さ れ る 。

smb:\> バ ッ ク ス ラ ッ シ ュ ("\")は サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ を 示 し て お り 、 作 業 デ ィ レ ク ト リ を 変 え る と 、 こ の 表 示 も 変 わ る 。 こ の プ ロ ン プ ト は 、 ク ラ イ ア ン ト の 準 備 が で き 、 ユ ー ザ の コ マ ン ド 実 行 を 待 機 し て い る 事 を 示 し て い る 。 各 コ マ ン ド は 、 一 つ の 単 語 で あ る が 、 コ マ ン ド に よ っ て は 、 コ マ ン ド 固 有 の パ ラ メ ー タ を 指 定 す る 事 も で き る 。 コ マ ン ド と パ ラ メ ー タ は 、 特 に 注 釈 が な い 限 り 、 ス ペ ー ス で 区 切 ら れ る 。 全 て の コ マ ン ド は 大 文 字 小 文 字 を 識 別 し な い 。 コ マ ン ド の パ ラ メ ー タ は 、 コ マ ン ド に よ っ て 大 文 字 と 小 文 字 が 区 別 さ れ た り さ れ な か っ た り す る 。 ス ペ ー ス が 含 ま れ て い る フ ァ イ ル 名 は 、 名 前 を ダ ブ ル ク オ ー ト 文 字 で 、 例 え ば 、 "a long file name" の よ う に 括 る 事 で 指 定 で き る 。 大 括 弧 ("[" と "]")で 括 ら れ て 示 さ れ て い る パ ラ メ ー タ (例 え ば "[parameter]")は 、 オ プ シ ョ ン で あ る 。 指 定 さ れ な か っ た 場 合 、 コ マ ン ド は 適 切 な デ フ ォ ル ト 値 を 用 い る 。 不 等 号 記 号 ("<" と ">")で 括 ら れ て 示 さ れ て い る パ ラ メ ー タ (例 え ば "")は 、 必 須 で あ る 。 サ ー バ 上 で の コ マ ン ド の 実 行 は 、 実 際 に サ ー バ に 対 し て 要 求 を 発 行 す る 事 で 実 行 さ れ る 事 に 注 意 し て ほ し い 。 従 っ て 、 そ の 動 作 は サ ー バ 間 で 異 な る 場 合 が あ り 、 サ ー バ の 実 装 方 法 に 依 存 し て い る 。 利 用 で き る コ マ ン ド を 以 下 に ア ル フ ァ ベ ッ ト 順 で 紹 介 す る 。
? [command]

command を 指 定 す る と 、 ? コ マ ン ド は 指 定 さ れ た コ マ ン ド に つ い て の 簡 潔 で 有 益 な 説 明 を 表 示 す る 。 command を 指 定 し な い と 、 利 用 で き る コ マ ン ド の 一 覧 が 表 示 さ れ る 。

! [shell command]

shell command を 指 定 す る と 、 ! コ マ ン ド は ロ ー カ ル で シ ェ ル を 起 動 し 、 指 定 さ れ た シ ェ ル コ マ ン ド を 起 動 す る 。 コ マ ン ド を 指 定 し な い と 、 ロ ー カ ル な シ ェ ル が 起 動 す る 。

altname file ク ラ イ ア ン ト は 、 フ ァ イ ル ま た は デ ィ レ ク ト リ の "代 わ り "の 名 前 (8.3形 式 の 名 前 )を 返 す よ う に サ ー バ に 要 求 す る 。
cancel jobid0 [jobid1] ... [jobidN] ク ラ イ ア ン ト は 、 与 え ら れ た ジ ョ ブ IDの 印 刷 ジ ョ ブ を キ ャ ン セ ル す る よ う に サ ー バ に 要 求 す る 。
chmod file mode in octal こ の コ マ ン ド は サ ー バ の CIFS UNIX拡 張 の サ ポ ー ト に 依 存 し 、 サ ー バ が サ ポ ー ト し て い な い 場 合 は 失 敗 す る 。 ク ラ イ ア ン ト は 、 UNIX で の 標 準 形 式 で あ る 8進 数 で の UNIXパ ー ミ ッ シ ョ ン に 変 更 す る よ う に サ ー バ に 要 求 す る 。
chown file uid gid こ の コ マ ン ド は サ ー バ の CIFS UNIX拡 張 の サ ポ ー ト に 依 存 し 、 サ ー バ が サ ポ ー ト し て い な い 場 合 は 失 敗 す る 。 ク ラ イ ア ン ト は 、 与 え ら れ た 10進 数 の ユ ー ザ ID、 グ ル ー プ IDに 所 有 者 を 変 更 す る よ う に サ ー バ に 要 求 す る 。 現 在 は 、 与 え ら れ た 名 前 か ら リ モ ー ト の uid と gid を 検 索 す る 方 法 は な い こ と に 注 意 。 こ れ は 、 将 来 の バ ー ジ ョ ン の CIFS UNIX 拡 張 に よ っ て 対 応 さ れ る か も し れ な い 。
cd [directory name]

"directory name" を 指 定 す る と 、 サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ が 指 定 さ れ た デ ィ レ ク ト リ に な る 。 何 ら か の 理 由 で 指 定 さ れ た デ ィ レ ク ト リ に ア ク セ ス で き な い と 、 操 作 は 失 敗 す る 。 デ ィ レ ク ト リ 名 を 指 定 し な い と 、 サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ が 表 示 さ れ る 。

del <mask> ク ラ イ ア ン ト が サ ー バ に 対 し 、 サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ で mask に 一 致 す る す べ て の フ ァ イ ル を 削 除 す る よ う に 要 求 す る 。
dir <mask> サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ で 、 mask に 一 致 す る フ ァ イ ル の 一 覧 を サ ー バ か ら 入 手 し 、 表 示 す る 。

get <remote file name> [local file name]

remote file name と い う 名 前 の フ ァ イ ル を サ ー バ か ら ク ラ イ ア ン ト を 実 行 し て い る マ シ ン へ コ ピ ー す る 。 local file name が 指 定 さ れ て い る と 、 そ れ が ロ ー カ ル に コ ピ ー さ れ る フ ァ イ ル の 名 前 と な る 。 smbclient に よ る フ ァ イ ル の 転 送 は 、 す べ て binary モ ー ド で 行 わ れ る こ と に 注 意 し て ほ し い 。 lowercase コ マ ン ド も 参 照 の こ と 。

help [command] 前 述 の ? コ マ ン ド を 参 照 の こ と 。
lcd [directory name]

directory name を 指 定 す る と 、 ロ ー カ ル マ シ ン 上 の 現 在 の 作 業 デ ィ レ ク ト リ が 指 定 さ れ た デ ィ レ ク ト リ に な る 。 何 ら か の 理 由 で 指 定 さ れ た デ ィ レ ク ト リ に ア ク セ ス で き な い と 、 操 作 は 失 敗 す る 。 デ ィ レ ク ト リ 名 を 指 定 し な い と 、 ロ ー カ ル マ シ ン 上 の 現 在 の 作 業 デ ィ レ ク ト リ が 表 示 さ れ る 。

link source destination こ の コ マ ン ド は サ ー バ の CIFS UNIX拡 張 の サ ポ ー ト に 依 存 し 、 サ ー バ が サ ポ ー ト し て い な い 場 合 は 失 敗 す る 。 ク ラ イ ア ン ト は 、 source と destination フ ァ イ ル の 間 に ハ ー ド リ ン ク を 作 成 す る よ う に サ ー バ に 要 求 す る 。 source フ ァ イ ル は 存 在 し て い な け れ ば な ら な い 。
lowercase

get お よ び mget コ マ ン ド に お い て 、 フ ァ イ ル 名 を 小 文 字 化 す る か ど う か の 設 定 を 切 り 換 え る 。 小 文 字 化 を ON に す る と 、 get お よ び mget コ マ ン ド を 使 っ た と き に 、 ロ ー カ ル の フ ァ イ ル 名 が 小 文 字 に 変 換 さ れ る 。 こ れ は 、 サ ー バ か ら (い わ ゆ る ) MS-DOS 形 式 の 名 前 を 持 つ フ ァ イ ル を コ ピ ー す る と き に 役 立 つ 。 UNIX シ ス テ ム で は 、 フ ァ イ ル 名 を 小 文 字 に す る の が 一 般 的 で あ る た め で あ る 。

ls <mask> 前 述 の dir コ マ ン ド を 参 照 の こ と 。
mask <mask> こ の コ マ ン ド は 、 mget と mput コ マ ン ド が 再 帰 的 な 操 作 を 行 う と き に 用 い る マ ス ク を 設 定 す る 。 再 帰 モ ー ド が ON の と き 、 mget と mput コ マ ン ド に 指 定 す る マ ス ク は フ ァ イ ル に 対 す る フ ィ ル タ と し て で は な く 、 デ ィ レ ク ト リ に 対 す る フ ィ ル タ と し て 働 く 。

mask コ マ ン ド で 指 定 す る マ ス ク は 、 そ れ ら の デ ィ レ ク ト リ 配 下 の フ ァ イ ル を フ ィ ル タ す る た め に 必 要 と な る 。 た と え ば 、 mget コ マ ン ド が "source*" の と き に mask が 指 定 さ れ て お り 、 mask コ マ ン ド で 指 定 さ れ た マ ス ク が "*.c" で 、 再 帰 モ ー ド が ON で あ っ た と す る 。 す る と mget コ マ ン ド は 、 現 在 の 作 業 デ ィ レ ク ト リ 中 の "source*" に 一 致 す る す べ て の デ ィ レ ク ト リ 配 下 で 、 "*.c" に 一 致 す る す べ て の フ ァ イ ル を 取 得 す る 。 デ フ ォ ル ト で は mask の 値 は 空 (’*’ と 同 等 ) に な っ て お り 、 mask コ マ ン ド を 使 っ て 変 更 さ れ る ま で 変 わ ら な い 。 mask の 値 は 、 最 後 に 指 定 さ れ た 値 を 保 ち 続 け る 。 予 想 外 の 結 果 を 招 か な い よ う に 、 mget か mput コ マ ン ド を 使 っ た 後 に は 、 mask の 値 を ’*’ に 戻 し て お く こ と が 賢 明 で あ る 。

md <directory name>

mkdir コ マ ン ド を 参 照 の こ と 。

mget <mask>

mask に 一 致 す る す べ て の フ ァ イ ル を 、 サ ー バ か ら ク ラ イ ア ン ト を 実 行 し て い る マ シ ン に コ ピ ー す る 。 再 帰 モ ー ド に な っ て い る か ど う か に よ っ て 、 mask の 解 釈 が 異 な る こ と に 注 意 。 詳 細 は recurse と mask コ マ ン ド を 参 照 の こ と 。 smbclient に よ る フ ァ イ ル の 転 送 は 、 す べ て binary モ ー ド で 行 わ れ る こ と に 注 意 し て ほ し い 。 lowercase も 参 照 の こ と 。

mkdir <directory name> 指 定 さ れ た 名 前 の 新 し い デ ィ レ ク ト リ を (ユ ー ザ の ア ク セ ス が 許 可 さ れ て い る ) サ ー バ 上 に 作 成 す る 。
mput <mask> ロ ー カ ル マ シ ン 上 の 現 在 の 作 業 デ ィ レ ク ト リ 内 で mask に 一 致 す る す べ て の フ ァ イ ル を 、 サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ に コ ピ ー す る 。 再 帰 モ ー ド に な っ て い る か ど う か に よ っ て 、 mask の 解 釈 が 異 な る こ と に 注 意 。 詳 細 は 、 recurse と mask コ マ ン ド を 参 照 の こ と 。 smbclient に よ る フ ァ イ ル の 転 送 は 、 す べ て binary モ ー ド で 行 わ れ る こ と に 注 意 し て ほ し い 。
print <file name> 指 定 し た ロ ー カ ル マ シ ン 上 の フ ァ イ ル を 、 サ ー バ 上 の 印 刷 サ ー ビ ス を 使 っ て 印 刷 す る 。

printmode コ マ ン ド も 参 照 の こ と 。

printmode <graphics or text> 印 刷 モ ー ド を 、 バ イ ナ リ デ ー タ (グ ラ フ ィ カ ル な 情 報 な ど )用 、 ま た は テ キ ス ト 用 に 設 定 す る 。 設 定 後 の print コ マ ン ド で 、 現 在 設 定 さ れ て い る 印 刷 モ ー ド が 利 用 さ れ る 。

put <local file name> [remote file name]

local file name と い う 名 前 の フ ァ イ ル を ク ラ イ ア ン ト を 実 行 し て い る マ シ ン か ら サ ー バ に コ ピ ー す る 。 remote file name が 指 定 さ れ て い る と 、 そ れ が サ ー バ に コ ピ ー さ れ る フ ァ イ ル の 名 前 と な る 。 smbclient に よ る フ ァ イ ル の 転 送 は 、 す べ て binary モ ー ド で 行 わ れ る こ と に 注 意 し て ほ し い 。 lowercase コ マ ン ド も 参 照 の こ と 。

が 見 ら れ る 。

rd <directory name>

rmdir コ マ ン ド を 参 照 の こ と 。

recurse

mget と mput コ マ ン ド に お い て 、 デ ィ レ ク ト リ を 再 帰 的 に 辿 る か ど う か の 設 定 を 切 り 換 え る 。 こ の 設 定 が ON で あ る と 、 そ れ ら の コ マ ン ド は 、 対 象 と な る デ ィ レ ク ト リ (す な わ ち 、 コ ピ ー 元 と な る デ ィ レ ク ト リ )内 の す べ て の デ ィ レ ク ト リ を 処 理 し 、 コ マ ン ド に 指 定 し た mask に 一 致 す る デ ィ レ ク ト リ を 再 帰 的 に 辿 る 。 フ ァ イ ル は 、 mask コ マ ン ド を 使 っ て 指 定 し た マ ス ク に 一 致 す る も の だ け が 、 処 理 の 対 象 と な る 。 mask コ マ ン ド も 参 照 の こ と 。 こ の 設 定 が OFF で あ る 場 合 、 コ ピ ー 元 と な る マ シ ン の 作 業 デ ィ レ ク ト リ か ら 、 mget ま た は mput コ マ ン ド に 指 定 さ れ た マ ス ク に 一 致 す る フ ァ イ ル だ け が コ ピ ー さ れ る 。 mask コ マ ン ド を 使 っ て 指 定 さ れ た マ ス ク は 無 視 さ れ る 。

rm <mask>

mask に 一 致 す る す べ て の フ ァ イ ル を サ ー バ 上 の 現 在 の 作 業 デ ィ レ ク ト リ か ら 削 除 す る 。

rmdir <directory name> 指 定 さ れ た 名 前 の (ユ ー ザ の ア ク セ ス が 許 可 さ れ て い る ) デ ィ レ ク ト リ を サ ー バ か ら 削 除 す る 。
setmode <filename> <perm=[+|\-]rsha>

DOS 版 の attrib コ マ ン ド と 同 等 に 、 フ ァ イ ル の パ ー ミ ッ シ ョ ン を 設 定 す る 。 例 え ば

setmode myfile +r は myfile を 読 み 込 み 専 用 に す る 。

symlink source destination こ の コ マ ン ド は サ ー バ の CIFS UNIX拡 張 の サ ポ ー ト に 依 存 し 、 サ ー バ が サ ポ ー ト し て い な い 場 合 は 失 敗 す る 。 ク ラ イ ア ン ト は 、 source と destination フ ァ イ ル の 間 に シ ン ボ リ ッ ク リ ン ク を 作 成 す る よ う に サ ー バ に 要 求 す る 。 source フ ァ イ ル は 存 在 し て い な け れ ば な ら な い 。 サ ー バ は 現 在 接 続 し て い る 共 有 の 外 を さ す リ ン ク は 作 成 し な い こ と に 注 意 。 こ れ は Samba server に よ っ て 強 化 さ れ た 。
tar <c|x>[IXbgNa]

tar 作 業 を 行 う 。 前 述 の -T コ マ ン ド ラ イ ン オ プ シ ョ ン を 参 照 の こ と 。 こ の コ マ ン ド の 動 作 は tarmode コ マ ン ド (下 記 を 参 照 ) に 影 響 さ れ る 。 パ ラ メ ー タ g (増 分 ) と N (更 新 ) を 使 う と 、 tarmode の 設 定 に 影 響 を 及 ぼ す 。 tar x (展 開 ) 時 の オ プ シ ョ ン に "-" (標 準 入 力 ) を 使 っ て も 動 作 し な い だ ろ う 。 コ マ ン ド ラ イ ン オ プ シ ョ ン で 使 う よ う に す る こ と 。

blocksize <blocksize> ブ ロ ッ ク サ イ ズ 。 こ の オ プ シ ョ ン の 後 に は 有 効 な (1 以 上 の ) ブ ロ ッ ク サ イ ズ を 指 定 し な け れ ば な ら な い 。 こ の オ プ シ ョ ン に よ り 、 tar フ ァ イ ル は 、 blocksize*TBLOCK (通 常 512 バ イ ト )ブ ロ ッ ク の 単 位 で 書 き 出 さ れ る よ う に な る 。
tarmode <full|inc|reset|noreset> ア ー カ イ ブ ビ ッ ト に 関 す る tar の 動 作 を 設 定 す る 。 full(完 全 )モ ー ド で は 、 tar は ア ー カ イ ブ ビ ッ ト の 状 態 に 関 わ ら ず 、 す べ て を バ ッ ク ア ッ プ す る (こ れ が デ フ ォ ル ト の モ ー ド )。 incremental(増 分 ) モ ー ド で は 、 tar は ア ー カ イ ブ ビ ッ ト が 設 定 さ れ た フ ァ イ ル だ け を バ ッ ク ア ッ プ す る 。 reset モ ー ド で は 、 tar は バ ッ ク ア ッ プ し た フ ァ イ ル の ア ー カ イ ブ ビ ッ ト を ク リ ア す る (読 み 書 き で き る 共 有 に お い て )。

注 意

サ ー バ に よ っ て は 、 与 え ら れ た ユ ー ザ 名 、 パ ス ワ ー ド 、 共 有 名 (サ ー ビ ス 名 と も 言 う )、 マ シ ン 名 な ど の 大 文 字 小 文 字 を 厳 格 に 識 別 す る 。 サ ー バ へ の 接 続 が 失 敗 し た と き は 、 す べ て の パ ラ メ ー タ を 大 文 字 に し て 試 し て み よ う 。 あ る 種 の サ ー バ に 接 続 す る と き に は 、 -n オ プ シ ョ ン を 使 わ な け れ ば な ら な い よ う な 場 合 が よ く あ る 。 た と え ば OS/2 の LanManager で は 、 有 効 な NetBIOS 名 が 使 わ れ て い な け れ ば な ら な い 。 よ っ て 、 サ ー バ が 知 っ て い る 有 効 な 名 前 を 与 え る 必 要 が あ る 。 サ ー バ が LANMAN2 プ ロ ト コ ル を サ ポ ー ト し て い る 場 合 、 smbclient は 長 い フ ァ イ ル 名 を サ ポ ー ト す る 。

環 境 変 数

変 数 USER の 値 は 、 ク ラ イ ア ン ト が 使 用 す る ユ ー ザ の 名 前 と な る 。 こ の 情 報 は 、 プ ロ ト コ ル の レ ベ ル が 充 分 高 く 、 セ ッ シ ョ ン レ ベ ル の パ ス ワ ー ド を サ ポ ー ト し て い る 場 合 に だ け 利 用 さ れ る 。 変 数 PASSWD の 値 は 、 ク ラ イ ア ン ト が 使 用 す る ユ ー ザ の パ ス ワ ー ド と な る 。 こ の 情 報 は 、 プ ロ ト コ ル の レ ベ ル が 充 分 高 く 、 セ ッ シ ョ ン レ ベ ル の パ ス ワ ー ド を サ ポ ー ト し て い る 場 合 に だ け 利 用 さ れ る 。 変 数 LIBSMB_PROG に は サ ー バ へ の 接 続 に 代 わ り ク ラ イ ア ン ト が 接 続 す る 、 system() で 起 動 さ れ る パ ス を 設 定 す る 。 こ の 機 能 は aid の 開 発 を 主 用 途 と し 、 LMHOSTS フ ァ イ ル の 利 用 時 に 効 果 を 発 揮 す る 。

イ ン ス ト ー ル

ク ラ イ ア ン ト プ ロ グ ラ ム を ど こ に 置 く べ き か は 、 各 シ ス テ ム 管 理 者 が 判 断 す べ き 問 題 で あ る 。 よ っ て 、 以 下 は た だ の 提 案 で あ る 。 ク ラ イ ア ン ト ソ フ ト ウ ェ ア は /usr/local/samba/bin か /usr/samba/bin に イ ン ス ト ー ル し 、 デ ィ レ ク ト リ は 全 ユ ー ザ か ら 読 み 出 し 可 能 で root の み 書 き 込 み 可 能 に す る こ と が 推 奨 さ れ る 。 ク ラ イ ア ン ト プ ロ グ ラ ム 自 身 は す べ て の ユ ー ザ か ら 実 行 可 能 に す る べ き で あ る 。 ク ラ イ ア ン ト を setuid や setgid し な い よ う に ! ク ラ イ ア ン ト の ロ グ フ ァ イ ル は 、 そ の ユ ー ザ だ け が 読 み 書 き 可 能 な デ ィ レ ク ト リ に 置 く こ と 。 ク ラ イ ア ン ト を テ ス ト す る に は 、 動 作 し て い る SMB/CIFS サ ー バ の 名 前 を 知 ら な く て は な ら な い 。 smbd(8) を 一 般 ユ ー ザ で も 起 動 す る こ と が で き る 。 そ の 場 合 、 ユ ー ザ が 利 用 で き る ポ ー ト (た い て い は 1024 よ り 大 き い ポ ー ト 番 号 な ら ど こ で も よ い ) で デ ー モ ン と し て サ ー バ を 起 動 す る こ と で 、 適 切 な テ ス ト 環 境 と な る だ ろ う 。

診 断

ク ラ イ ア ン ト に よ っ て 出 さ れ た ほ と ん ど の 診 断 メ ッ セ ー ジ は 、 指 定 さ れ た ロ グ フ ァ イ ル に 記 録 さ れ る 。 ロ グ フ ァ イ ル の 名 前 は コ ン パ イ ル 時 に 指 定 さ れ る が 、 コ マ ン ド ラ イ ン で 変 更 す る こ と も で き る 。 利 用 で き る 診 断 メ ッ セ ー ジ の 量 と 内 容 は 、 ク ラ イ ア ン ト で 設 定 さ れ た デ バ ッ グ レ ベ ル に 依 存 す る 。 問 題 を 抱 え て い る な ら 、 デ バ ッ グ レ ベ ル を 3 に 設 定 し て ロ グ フ ァ イ ル に 目 を 通 し て ほ し い 。

バ ー ジ ョ ン

こ の マ ニ ュ ア ル ペ ー ジ は Samba バ ー ジ ョ ン 2.2 一 式 用 で あ る 。

著 者

オ リ ジ ナ ル の Samba ソ フ ト ウ ェ ア と 関 連 す る ユ ー テ ィ リ テ ィ は 、 Andrew Tridgell に よ っ て 作 ら れ た 。 Samba は 現 在 、 Linux カ ー ネ ル が 開 発 さ れ て い る よ う な 方 法 で の オ ー プ ン ソ ー ス プ ロ ジ ェ ク ト で あ る Samba Team に よ っ て 開 発 さ れ て い る 。 オ リ ジ ナ ル の Samba の マ ニ ュ ア ル ペ ー ジ は Karl Auer に よ っ て 書 か れ た 。 マ ニ ュ ア ル ペ ー ジ の ソ ー ス は YODL 形 式 (別 の 、 優 秀 な オ ー プ ン ソ ー ス ソ フ ト ウ ェ ア で 、 ftp://ftp.icce.rug.nl/pub/unix/ <URL:ftp://ftp.icce.rug.nl/pub/unix/>; に あ る )で 変 換 さ れ 、 Jeremy Allison に よ っ て Samba 2.0 リ リ ー ス の た め に 更 新 さ れ た 。 Samba 2.2 の た め の DocBook 形 式 へ の 変 換 は Gerald Carter が 行 っ た 。

日 本 語 訳

よ う す け