Manpages

NAME

smbclient - 類 似 FTP操 作 方 式 的 訪 問 SMB/CIFS服 務 器 資 源 的 客 戶 端

總 覽 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] [-c <command string>] [-i scope] [-O <socket options>] [-p port] [-R <name resolve order>] [-s <smb config file>] [-T<c|x>IXFqgbNan] [-k]

描 述 DESCRIPTION

此 程 序 是 Samba(7)套 件 的 一 部 分 。

smbclient 是 個 可 以 和 SMB/CIFS服 務 器 “交 談 ”的 客 戶 端 程 序 。 它 提 供 了 類 似 FTP程 序 (參 見 ftp (1))的 用 戶 界 面 。 它 可 以 完 成 的 操 作 包 括 象 從 服 務 器 下 載 文 件 到 本 地 ， 上 傳 本 地 文 件 到 服 務 器 及 在 服 務 器 上 查 找 目 錄 信 息 等 。

選 項 OPTIONS

servicename

servicename就 是 你 要 使 用 的 服 務 名 稱 。 服 務 名 使 用 //server/service這 樣 的 形 式 ， 其 中 server 是 提 供 服 務 的 SMB/CIFS服 務 器 的 NetBIOS名 字 ， 而 service 是 可 獲 得 服 務 資 源 的 名 稱 。 所 以 如 果 要 聯 接 服 務 器 "smbserver"上 的 "printer"服 務 的 話 ， 應 該 使 用 這 樣 的 服 務 名 稱 ： //smbserver/printer 注 意 服 務 名 不 使 用 服 務 器 的 IP(或 DNS)主 機 名 ， 而 應 該 用 NetBIOS名 ， 而 它 可 能 與 服 務 器 的 IP主 機 名 相 同 當 然 也 可 能 不 相 同 。 服 務 器 名 是 根 據 smbclient使 用 的 -R 參 數 或 者 smb.conf(5)配 置 文 件 中 的 名 稱 解 析 順 序 參 數 來 解 析 的 。 名 稱 解 析 參 數 使 管 理 員 可 以 控 制 名 稱 解 析 的 順 序 和 方 法 。

password 用 password指 定 訪 問 服 務 時 所 需 的 口 令 。 如 果 使 用 了 這 個 選 項 ， 就 假 定 使 用 了 -N(suppress password prompt)參 數 ， 在 執 行 過 程 中 不 出 現 口 令 提 示 。 口 令 沒 有 默 認 值 。 如 果 在 命 令 行 上 沒 有 提 供 口 令 (或 者 使 用 這 個 參 數 ， 或 者 在 -U-fR參 數 中 指 定 )， 並 且 也 沒 有 使 用 -N選 項 ， 那 麼 即 使 需 要 的 服 務 項 不 要 求 口 令 ， 程 序 也 會 提 供 要 用 戶 輸 入 一 個 口 令 。 (如 果 服 務 不 需 要 口 令 ， 只 要 簡 單 地 打 個 回 車 就 向 服 務 器 迴 應 了 一 個 空 口 令 ) 注 意 ： 有 些 服 務 器 (包 括 OS/2和 Windows for Workgroups)會 強 調 使 用 大 寫 口 令 ， 它 們 會 拒 絕 小 寫 或 者 大 小 寫 混 合 的 口 令 。 在 腳 本 中 使 用 口 令 要 小 心 。 (可 能 有 安 全 問 題 嘛 ！ )
-R <name resolve order> 通 過 指 定 這 個 選 項 讓 Samba套 件 中 的 程 序 決 定 使 用 怎 樣 的 名 字 解 析 服 務 及 其 次 序 來 解 決 主 機 名 和 IP的 對 應 。 這 個 選 項 以 一 個 以 空 格 分 隔 的 不 同 的 名 稱 解 析 方 法 爲 選 項 值 。 可 選 值 是 ： “lmhosts”， “host”， “wins”和 “bcast”。 這 些 選 項 使 名 字 解 析 按 以 下 的 方 法 來 進 行 ：

lmhosts: 向 Samba的 lmhosts文 件 查 詢 IP地 址 。 If the line in lmhosts has no name type attached to the NetBIOS name (see the lmhosts(5) for details) then any name type matches for lookup.

host: 用 標 準 的 名 字 到 IP地 址 解 析 方 法 ： 系 統 /etc/hosts文 件 ， NIS或 DNS查 詢 。 如 何 使 用 這 個 名 字 解 析 由 系 統 決 定 。 舉 例 來 說 ， 在 IRIX或 者 Solaris系 統 中 ， /etc/nsswitch.conf文 件 會 處 理 這 些 問 題 。 Note that this method is only used if the NetBIOS name type being queried is the 0x20 (server) name type, otherwise it is ignored.

bcast: 向 配 置 文 件 中 interfaces參 數 列 出 的 每 個 已 知 本 地 接 口 進 行 廣 播 來 進 行 查 詢 。 這 是 最 不 可 靠 的 名 字 解 析 方 法 ， 因 爲 它 要 求 目 標 主 機 在 本 地 子 網 內 。 如 果 不 使 用 這 個 參 數 的 話 ， 將 按 smb.conf(5)配 置 文 件 中 (name resolve order)參 數 指 定 的 次 序 來 進 行 名 字 解 析 。 默 認 的 解 析 次 序 是 lmhosts， host， wins， bcast， 在 不 使 用 這 個 參 數 或 者 沒 有 在 smb.conf(5)配 置 文 件 中 設 定 name resolve order 參 數 的 情 況 下 將 使 用 這 樣 的 次 序 進 行 解 析 。

-M NetBIOS name 使 用 這 個 選 項 可 以 讓 你 以 “WinPopup” 協 議 向 其 它 計 算 機 發 送 信 息 。 一 旦 聯 接 成 功 你 就 可 以 發 送 信 息 了 ， 結 束 時 可 以 按 ^D(Ctl-D). 如 果 接 受 方 計 算 機 也 正 在 運 行 WinPopup的 話 ， 用 戶 會 收 到 發 送 的 信 息 並 且 系 統 可 能 會 鳴 叫 一 聲 。 如 果 對 方 並 沒 有 運 行 WinPopup的 話 信 息 就 被 丟 棄 ， 而 不 會 發 出 出 錯 信 息 。 如 果 發 送 的 信 息 超 過 1600字 節 的 話 會 自 動 被 截 斷 ， 因 爲 這 是 此 協 議 規 定 的 極 限 。 這 裏 有 個 很 有 用 的 小 技 巧 ， 通 過 smbclient， 用 cat處 理 信 息 ， 例 如 ：

cat mymessage.txt | smbclient -M FRED 將 會 把 mymessage.txt 中 的 信 息 發 送 給 主 機 FRED. 你 也 許 會 發 現 -U和 -I選 項 很 有 用 ， 因 爲 它 們 允 許 你 控 制 信 息 的 源 地 址 和 目 的 地 址 部 分 。 參 見 smb.conf(5)配 置 文 件 中 的 message command參 數 獲 得 如 何 在 Samba中 處 理 新 進 的 WinPopup消 息 的 詳 細 描 述 。 注 意 ： 如 果 你 總 是 要 用 你 的 WfWg PC的 WinPopup來 接 收 消 息 的 話 可 以 在 你 的 Windows機 器 中 把 它 拷 到 “啓 動 ”中 。

-p port 聯 接 服 務 器 所 用 的 TCP端 口 號 。 標 準 (衆 所 周 知 )的 SMB/CIFS服 務 器 TCP端 口 是 139， 當 然 也 是 默 認 值 。
-h|--help 打 印 出 命 令 行 幫 助 信 息 。
-I IP-address 指 定 要 聯 接 的 服 務 器 IP地 址 。 當 然 格 式 應 該 是 “a.b.c.d”。 通 常 client會 使 用 上 面 介 紹 過 的 name resolve order參 數 中 描 述 的 NetBIOS名 字 解 析 機 制 通 過 查 詢 嘗 試 查 找 一 個 已 命 名 的 SMB/CIFS服 務 器 。 使 用 這 個 參 數 會 強 制 客 戶 端 程 序 採 用 指 定 的 IP地 址 而 忽 略 要 聯 接 的 服 務 資 源 的 NetBIOS名 部 分 。 這 個 參 數 並 沒 有 默 認 值 。 如 果 不 指 定 的 話 程 序 會 用 上 面 說 的 方 法 來 自 動 檢 測 。

輸 入 流 中 。 默 認 情 況 下 ， 程 序 會 把 信 息 寫 入 標 準 輸 入 中 - 典 型 的 例 子 是 用 戶 的 tty。

host 命 令 會 顯 示 一 份 列 表 。 如 果 你 的 NetBIOS名 與 TCP/IP域 名 不 匹 配 或 者 要 在 其 它 網 絡 上 查 找 主 機 時 ， -I 選 項 會 非 常 有 用 。

-t terminal code 用 這 個 選 項 告 訴 smbclient怎 樣 解 釋 從 遠 程 服 務 器 上 傳 來 的 文 件 名 。 通 常 ， UNIX系 統 對 亞 洲 多 字 節 的 語 言 的 實 現 與 SMB/CIFS服 務 器 使 用 的 字 符 集 不 同 (例 如 用 EUC代 替 SJIS)。 設 置 這 個 參 數 可 以 讓 smbclient 在 UNIX文 件 名 與 SMB文 件 名 之 間 進 行 正 確 的 轉 換 。 不 過 ， 這 個 選 項 還 沒 有 經 過 嚴 格 的 測 試 ， 所 以 可 能 會 有 些 問 題 。 終 端 編 碼 包 含 CWsjis, CWeuc, CWjis7, CWjis8, CWjunet, CWhex, CWcap. 當 然 這 個 列 表 並 不 完 整 ， 要 獲 取 完 整 列 表 請 查 看 samba 源 碼 。
-b buffersize 在 對 服 務 器 進 行 上 /下 傳 文 件 時 可 以 用 這 個 選 項 來 改 變 傳 輸 緩 衝 大 小 。 默 認 值 是 65520個 字 節 。 當 從 一 個 Win9x的 服 務 器 上 進 行 文 件 傳 輸 時 ， 把 這 個 值 設 爲 稍 小 一 點 的 值 (例 如 1200字 節 )可 以 得 到 一 些 速 度 提 升 。

-s <configuration file> 指 定 的 這 個 文 件 包 含 服 務 器 需 要 的 配 置 詳 細 信 息 。 文 件 中 的 信 息 包 含 針 對 服 務 器 的 信 息 ， 比 如 使 用 什 麼 printcap文 件 ， 還 有 所 有 服 務 器 提 供 的 服 務 的 描 述 。 參 見 smb.conf來 獲 得 更 多 信 息 。 默 認 的 配 置 文 件 名 是 在 編 譯 時 指 定 的 。
-d|--debug=debuglevel

debuglevel 調 試 等 級 是 個 從 0到 10的 整 數 。 參 數 未 指 定 時 默 認 值 爲 0。 如 果 這 個 值 越 高 ， 越 多 關 於 服 務 器 的 詳 細 活 動 信 息 將 被 記 錄 到 文 件 中 。 在 0調 試 級 時 ， 只 記 錄 緊 急 錯 誤 和 嚴 重 警 告 。 對 於 平 日 的 運 行 服 務 ， 1調 試 級 是 個 合 理 的 等 級 ， 它 只 產 生 小 量 的 關 於 執 行 操 作 的 信 息 。

1以 上 的 調 試 級 將 產 生 相 當 多 的 記 錄 數 據 ， 並 且 只 在 解 決 問 題 時 纔 有 用 。 3以 上 的 調 試 級 只 被 設 計 爲 讓 開 發 者 使 用 並 會 產 生 極 大 數 量 的 記 錄 數 據 ， 而 且 其 中 很 多 部 分 非 常 難 以 理 解 。 注 意 在 此 使 用 這 個 參 數 將 越 過 在 smb.conf (5)文 件 中 的 log level參 數 。

-l|--logfile=logbasename 指 定 一 個 記 錄 和 調 試 的 文 件 名 。 文 件 會 被 添 加 .client擴 展 名 。 記 錄 文 件 無 法 被 客 戶 端 刪 除 。

Try to authenticate with kerberos. Only useful in an Active Directory environment.

-A|--authfile=filename

This option allows you to specify a file from which to read the username and password used in the connection. The format of the file is

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

Make certain that the permissions on the file restrict access from unwanted users.

-U|--user=username[%password] 這 個 參 數 指 定 程 序 聯 接 時 使 用 的 用 戶 名 或 者 用 戶 名 和 密 碼 如 果 沒 指 定 %password， 將 提 示 用 戶 輸 入 。 程 序 會 使 用 環 境 變 量 USER或 LOGNAME， 如 果 任 何 一 個 存 在 就 會 被 轉 換 爲 大 寫 。 如 果 既 沒 有 用 戶 名 也 不 存 在 環 境 變 量 的 話 ， 將 使 用 GUEST作 爲 用 戶 名 。

A third option is to use a credentials file which contains the plaintext of the username and password. This option is mainly provided for scripts where the admin does not wish to pass the credentials on the command line or via environment variables. If this method is used, make certain that the permissions on the file restrict access from unwanted users. See the -A for more details. 在 腳 本 中 包 含 口 令 或 者 使 用 PASSWD環 境 變 量 時 要 小 心 。 而 且 在 很 多 系 統 中 ， 運 行 的 命 令 行 可 以 通 過 ps命 令 來 查 看 ， 所 以 讓 rpcclient提 示 輸 入 口 令 並 直 接 鍵 入 會 比 較 安 全 。

-n <primary NetBIOS name> 使 用 這 個 選 項 讓 你 越 過 機 器 的 主 機 名 而 使 用 你 要 用 的 NetBIOS名 。 這 樣 作 和 設 置 smb.conf文 件 中 的 netbios name選 項 作 用 相 同 。 但 是 ， 命 令 行 設 置 比 配 置 文 件 中 的 設 置 優 先 級 高 。
-i <scope> 這 個 參 數 指 定 一 個 產 生 NetBIOS名 字 時 nmblookup用 來 通 信 所 需 要 的 NetBIOS範 圍 。 對 於 NetBIOS範 圍 這 個 概 念 ， 可 以 參 見 rfc1001.txt和 rfc1002.txt這 兩 個 文 件 中 的 詳 細 定 義 。 實 際 上 這 個 NetBIOS範 圍 的 概 念 很 少 被 用 到 ， 僅 當 你 作 爲 負 責 整 個 NetBIOS通 信 的 管 理 員 時 纔 要 設 置 。
-W|--workgroup=domain 設 置 用 戶 名 的 SMB域 。 這 個 選 項 越 過 了 smb.conf配 置 文 件 中 的 默 認 域 。 如 果 指 定 的 域 與 服 務 器 NetBIOS名 相 同 ， 會 使 得 用 戶 使 用 服 務 器 本 地 安 全 管 理 local SAM來 登 錄 (與 域 SAM相 反 ).
-O socket options

TCP套 接 字 選 項 用 來 在 客 戶 端 設 定 套 接 字 方 面 的 功 能 。 參 見 smb.conf(5)手 冊 頁 中 的 socket options參 數 獲 得 合 法 的 選 項 列 表 。

-T tar options 我 們 可 以 用 smbclient來 對 位 於 SMB/CIFS共 享 資 源 上 的 所 有 文 件 建 立 兼 容 tar(1) 格 式 的 備 份 。 可 使 用 的 tar選 項 是 以 下 這 些 ：

x - 用 這 個 標 誌 可 以 把 本 地 的 一 個 tar備 份 文 件 釋 放 (恢 復 )到 共 享 資 源 上 。 除 非 使 用 了 -D選 項 ， tar備 份 文 件 將 從 共 享 資 源 的 頂 層 開 始 恢 復 。 當 然 了 ， 使 用 這 個 參 數 時 後 面 必 須 緊 跟 一 個 想 要 恢 復 的 文 件 名 ， 設 備 ， 或 者 用 "-"代 表 標 準 輸 入 。 與 上 面 一 樣 ， 這 個 標 誌 的 功 能 正 好 與 c標 誌 的 功 能 相 反 。 恢 復 後 文 件 的 建 立 時 間 (mtime)會 被 tar文 件 中 保 存 的 日 期 來 替 換 , 而 目 錄 無 法 做 到 這 一 點 的 。

I - 用 這 個 標 誌 可 以 包 含 文 件 和 目 錄 。 當 在 用 -T參 數 時 指 定 了 一 個 文 件 名 的 話 這 就 是 默 認 的 操 作 了 。 在 釋 放 或 建 立 時 tar文 件 都 會 包 含 這 些 內 容 (同 時 不 會 包 含 其 他 的 內 容 )。 參 見 下 面 的 示 例 。 文 件 名 通 配 符 有 兩 種 方 式 ， 參 見 下 面 r 。

X - 排 除 文 件 和 目 錄 。 在 釋 放 或 者 建 立 備 份 時 使 這 些 文 件 或 目 錄 不 被 包 含 在 內 。 請 看 下 面 的 示 例 文 件 名 通 配 符 有 兩 種 方 式 ， 參 見 下 面 r 。

g - 增 量 備 份 。 只 備 份 設 置 了 歸 檔 位 的 文 件 。 必 須 與 c標 誌 一 起 使 用 。

q - 靜 態 工 作 。 當 操 作 進 行 時 沒 有 輸 出 。 它 的 意 義 與 tar相 應 的 靜 態 工 作 模 式 一 樣 。

r - 用 正 則 表 達 式 來 描 述 包 含 或 排 除 操 作 。 當 用 HAVE_REGEX_H編 譯 的 話 ， 用 通 常 的 正 則 表 達 式 可 以 描 述 排 除 操 作 及 要 排 除 的 文 件 ， 但 是 這 種 模 式 工 作 非 常 慢 。 如 果 沒 有 用 HAVE_REGEX_H的 話 ， 僅 僅 可 以 用 通 配 符 ’*’和 ’?’。

a -設 定 歸 檔 位 。 使 用 這 個 標 誌 在 備 份 時 對 文 件 設 置 歸 檔 位 。 必 須 與 g和 fIc標 誌 一 起 用 .

Tar Long File Names

smbclient的 tar選 項 現 在 可 以 在 備 份 與 恢 復 操 作 時 支 持 長 文 件 名 了 。 但 是 ， 文 件 的 完 整 路 徑 描 述 必 須 小 於 1024 個 字 節 。 而 且 ， 當 建 立 了 一 個 歸 檔 包 時 ， smbclient的 tar選 面 會 用 文 件 相 對 路 徑 寫 入 歸 檔 包 中 ， 而 不 是 絕 對 路 徑 。

Tar Filenames 所 有 的 文 件 名 都 要 以 DOS路 徑 名 (以 ’\\’作 分 隔 符 )或 UNIX路 徑 名 (以 ’/’作 分 隔 符 )給 出 。 示 例 把 備 份 文 件 backup.tar恢 復 到 位 於 mypc上 的 myshare中 (無 須 口 令 )

smbclient //mypc/yshare "" -N -Tx backup.tar 恢 復 除 了 users/docs以 外 的 所 有 內 容

smbclient //mypc/myshare "" -N -TXx backup.tar users/docs 在 users/docs下 建 立 一 個 備 份 文 件

smbclient //mypc/myshare "" -N -Tc backup.tar users/docs 與 上 面 操 作 相 同 ， 不 過 用 的 是 DOS路 徑 名

smbclient //mypc/myshare "" -N -tc backup.tar users\docs 對 共 享 資 源 上 所 有 內 容 (文 件 和 目 錄 )作 一 完 整 的 備 份

smbclient //mypc/myshare "" -N -Tc backup.tar *

-D initial directory 在 開 始 前 用 這 個 參 數 來 改 變 初 始 目 錄 。 可 能 只 在 用 tar的 -T選 項 才 用 。
-c command string 命 令 字 符 串 串 是 一 個 以 單 引 號 (“’”)分 隔 的 用 來 替 換 標 準 輸 入 提 示 的 一 系 列 命 令 列 表 ， 這 個 參 數 意 味 着 -N。 當 使 用 腳 本 或 者 要 打 印 標 準 輸 入 信 息 到 服 務 器 時 這 個 選 項 就 非 常 有 用 了 ， 例 如 ： -c ’print -’

操 作 OPERATIONS

一 旦 運 行 了 這 個 命 令 ， 就 會 在 用 戶 的 提 示 行 出 現 以 下 信 息 ：

smb:\> 反 斜 槓 符 ("\\")指 出 了 在 服 務 器 上 用 戶 當 前 的 工 作 路 徑 ， 如 果 這 個 路 徑 改 變 了 的 話 ， 相 同 的 提 示 也 會 改 變 。 提 示 符 表 示 用 戶 準 備 好 並 等 待 執 行 一 個 用 戶 命 令 。 每 個 命 令 都 是 一 個 單 獨 的 詞 ， 一 般 隨 後 可 以 有 選 擇 地 指 定 一 些 命 令 所 需 的 參 數 。 命 令 和 參 數 之 間 用 空 格 來 分 隔 ， 除 非 有 其 它 規 定 。 當 然 所 有 命 令 都 區 分 大 小 寫 ， 而 參 數 可 能 不 一 定 要 區 分 大 小 寫 ， 不 過 這 應 該 由 命 令 來 決 定 。 要 在 文 件 名 中 使 用 空 格 的 話 必 須 用 雙 引 號 封 閉 ， 例 如 ： "a long file name"。 以 方 括 號 ("[]")封 閉 的 參 數 是 可 選 項 ， 如 果 沒 有 使 用 ， 命 令 還 是 以 默 認 的 情 況 執 行 ； 而 以 尖 括 號 <>封 閉 的 參 數 就 是 必 須 的 了 。 注 意 ， 所 有 對 服 務 器 的 命 令 操 作 實 際 上 是 完 成 的 是 向 服 務 器 發 送 一 個 請 求 。 因 而 ， 這 種 動 作 可 能 在 服 務 器 到 服 務 器 之 間 會 作 些 改 變 ， 這 由 服 務 器 的 實 現 方 式 來 決 定 。 下 面 以 字 母 次 序 給 出 可 以 使 用 的 命 令 。
? [command] 如 果 指 定 了 command ， 那 麼 ?命 令 就 顯 示 該 命 令 的 一 些 簡 單 介 紹 信 息 。 如 果 單 獨 使 用 ?的 話 ， 它 會 給 出 一 份 給 用 命 令 的 列 表 。
! [shell command] 如 果 指 定 了 shell command， 那 麼 !命 令 會 執 行 一 個 本 地 的 命 令 解 釋 器 並 運 行 指 定 的 shell命 令 。 如 果 不 指 定 要 運 行 哪 個 shell命 令 ， 那 麼 就 只 執 行 一 個 本 地 命 令 解 釋 器 。
altname file

The client will request that the server return the "alternate" name (the 8.3 name) for a file or directory.

cancel jobid0 [jobid1] ... [jobidN]

The client will request that the server cancel the printjobs identified by the given numeric print job ids.

chmod file mode in octal

This command depends on the server supporting the CIFS UNIX extensions and will fail if the server does not. The client requests that the server change the UNIX permissions to the given octal mode, in standard UNIX format.

chown file uid gid

This command depends on the server supporting the CIFS UNIX extensions and will fail if the server does not. The client requests that the server change the UNIX user and group ownership to the given decimal values. Note there is currently no way to remotely look up the UNIX uid and gid values for a given name. This may be addressed in future versions of the CIFS UNIX extensions.

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所 用 的 傳 送 模 式 爲 二 進 制 模 式 。 同 時 參 見 lowercase命 令 。
help [command] 同 以 上 的 ?命 令 相 同 。
lcd [directory name] 把 本 機 目 錄 改 爲 directory name指 定 的 地 點 。 如 果 要 換 的 目 錄 是 不 可 訪 問 的 話 ， 操 作 將 會 失 敗 。 如 果 不 指 定 目 錄 名 ， 則 顯 示 當 前 本 機 的 工 作 路 徑 。
link source destination

This command depends on the server supporting the CIFS UNIX extensions and will fail if the server does not. The client requests that the server create a hard link between the source and destination files. The source file must not exist.

lowercase 在 get和 mget命 令 中 選 用 小 寫 字 符 作 爲 文 件 名 。 當 選 擇 了 小 寫 狀 態 時 ， 用 get和 mget命 令 時 會 把 本 地 文 件 名 都 轉 換 爲 小 寫 。 從 服 務 器 上 拷 貝 MSDOS 文 件 時 這 個 選 項 非 常 有 用 ， 因 爲 小 寫 文 件 名 是 UNIX系 統 的 標 準 。
ls <mask> 同 以 上 的 dir命 令 。
mask <mask> 此 命 令 允 許 用 戶 設 置 在 mget和 mput命 令 的 遞 歸 形 式 操 作 中 使 用 的 一 個 掩 碼 (通 配 符 )。 當 選 擇 了 遞 歸 複 製 目 錄 時 ， mget和 mput命 令 指 定 這 個 掩 碼 (通 配 符 )作 爲 目 錄 過 濾 器 。 用 mask命 令 指 定 的 掩 碼 可 以 用 來 過 濾 目 錄 中 的 文 件 。 例 如 ， 如 果 在 mget命 令 中 指 定 了 掩 碼 "source*"， 並 且 用 mask命 令 指 定 了 文 件 掩 碼 "*.c"， 並 且 選 擇 了 遞 歸 複 製 目 錄 的 話 ， mget命 令 會 下 載 所 有 在 當 前 工 作 目 錄 中 匹 配 "source*"的 目 錄 以 及 其 下 所 有 匹 配 "*.c" 的 文 件 。 注 意 掩 碼 (通 配 符 )默 認 值 是 空 (等 價 於 "*")， 除 非 使 用 mask命 令 來 改 變 它 。 它 會 一 直 保 持 最 近 一 次 指 定 的 值 。 爲 了 避 免 出 現 意 外 的 結 果 ， 在 使 用 了 mget和 mput命 令 之 後 把 值 改 回 "*"是 比 較 明 智 的 。
md <directory name> 同 以 上 的 mkdir命 令 。
mget <mask> 複 製 服 務 器 上 所 有 匹 配 mask 的 文 件 到 本 機 。 注 意 mask在 命 令 的 遞 歸 調 用 和 非 遞 歸 調 用 兩 種 方 法 之 間 有 不 同 的 解 釋 含 義 - 請 參 考 recurse和 mask命 令 獲 得 更 多 信 息 。 其 次 就 是 smbclient傳 送 的 方 式 是 二 進 制 的 。 另 見 lowercase命 令 。
mkdir <directory name> 在 服 務 器 上 建 立 指 定 名 稱 的 目 錄 (當 然 用 戶 要 有 相 應 的 訪 問 權 限 )。
mput <mask> 複 製 本 機 上 當 前 目 錄 內 所 有 匹 配 mask 的 文 件 到 服 務 器 當 前 工 作 目 錄 。 注 意 mask在 命 令 的 遞 歸 調 用 和 非 遞 歸 調 用 兩 種 方 法 之 間 有 不 同 的 解 釋 含 義 - 請 參 考 recurse和 mask命 令 獲 得 更 多 信 息 。 其 次 就 是 smbclient 傳 送 的 方 式 是 二 進 制 的 。
print <file name> 打 印 本 機 上 指 定 的 文 件 到 服 務 器 的 可 打 印 資 源 上 。 參 見 printmode命 令 。
printmode <graphics or text> 設 定 打 印 模 式 以 適 應 二 進 制 數 據 (例 如 圖 形 信 息 )或 文 本 ， 這 樣 後 續 的 打 印 命 令 皆 使 用 當 前 設 好 的 打 印 模 式 。

當 用 提 示 時 ， 在 執 行 命 令 期 間 會 提 示 用 戶 對 每 個 要 傳 送 的 文 件 進 行 確 認 。 反 之 ， 所 有 傳 送 操 作 都 不 會 出 現 提 示 。

put <local file name> [remote file name] 從 本 機 拷 貝 名 爲 local file name的 文 件 到 服 務 器 上 並 取 名 爲 remote file name。 與 上 面 提 到 的 一 樣 ， smbclient 傳 送 用 的 是 二 進 制 模 式 。 參 見 lowercase命 令 。

exit命 令 。
rd <directory name> 參 見 rmdir命 令 。
recurse 以 目 錄 遞 歸 方 式 運 行 mget和 mput命 令 。 當 使 用 了 遞 歸 方 式 時 ， 這 些 執 行 的 命 令 會 處 理 源 目 錄 下 所 有 的 子 目 錄 ， 進 入 匹 配 通 配 符 的 子 目 錄 。 只 有 與 mask命 令 指 定 的 通 配 符 相 符 的 文 件 纔 會 被 處 理 。 參 見 mask命 令 。 當 沒 有 使 用 這 種 遞 歸 方 式 時 ， 只 有 源 主 機 當 前 工 作 目 錄 中 與 匹 配 通 配 符 的 文 件 纔 會 被 複 制 。 mask命 令 指 定 的 通 配 符 將 被 忽 略 。
rm <mask> 刪 除 所 有 服 務 器 上 當 前 工 作 目 錄 中 與 mask相 符 的 文 件 。
rmdir <directory name> 從 服 務 器 上 刪 除 指 定 的 目 錄 ， 當 然 了 ， 需 要 一 定 的 用 戶 訪 問 權 限 。
setmode <filename> <perm=[+|\-]rsha> 與 DOS命 令 attrib類 似 的 東 東 ， 用 來 設 定 文 件 權 限 ， 例 如 ：

setmode myfile +r 將 把 myfile設 爲 只 讀 。

symlink source destination

This command depends on the server supporting the CIFS UNIX extensions and will fail if the server does not. The client requests that the server create a symbolic hard link between the source and destination files. The source file must not exist. Note that the server will not create a link to any path that lies outside the currently connected share. This is enforced by the Samba server.

tar <c|x>[IXbgNa] 執 行 一 個 tar操 作 。 參 見 上 面 的 -T 命 令 行 選 項 。 tarmode命 令 可 能 會 影 響 具 體 的 行 爲 。 還 有 就 是 g(增 量 方 式 )和 N(新 建 方 式 )會 改 變 tarmode設 定 。 這 裏 要 注 意 的 是 tar x參 數 前 加 "-"可 能 會 導 致 命 令 不 執 行 ， 應 當 使 用 命 令 行 選 項 方 式 。
blocksize <blocksize> 塊 大 小 。 參 數 後 必 須 跟 一 上 合 法 的 (就 是 比 0大 的 數 啦 )塊 尺 寸 。 因 爲 在 執 行 命 令 時 ， tar文 件 要 被 寫 到 一 個 大 小 爲 blocksize*TBLOCK(一 般 是 512字 節 )的 塊 中 。
tarmode <full|inc|reset|noreset> 根 據 歸 檔 位 來 改 變 tar的 行 爲 。 當 用 完 全 備 份 時 ， tar會 備 份 所 有 的 內 容 而 不 管 歸 檔 位 是 如 何 設 置 的 ， 這 正 好 是 默 認 的 工 作 模 式 。 當 爲 增 量 模 式 時 ， 它 只 備 份 置 有 歸 檔 位 的 文 件 。 而 用 重 組 模 式 時 ， tar會 對 所 有 要 備 份 文 件 的 歸 檔 位 進 行 復 位 (同 時 讀 /寫 共 享 )。

注 意 NOTES

一 些 服 務 器 對 用 戶 提 供 的 用 戶 名 、 口 令 、 共 享 資 源 名 (也 就 是 服 務 名 )和 機 器 名 的 大 小 寫 形 式 非 常 挑 剔 。 如 果 你 聯 接 失 敗 ， 試 一 下 全 部 用 大 寫 。 通 常 你 在 聯 接 某 種 服 務 器 時 用 -n選 項 會 方 便 一 點 。 例 如 OS/2 LanManager會 強 調 要 使 用 合 法 的 NetBIOS名 字 ， 所 以 你 需 要 提 供 讓 服 務 器 可 以 理 解 的 合 法 名 字 。

smbclient支 持 在 服 務 器 使 用 LANMAN2及 更 高 的 協 議 時 使 用 長 文 件 名 。

環 境 變 量 ENVIRONMENT VARIABLES

USER變 量 包 含 使 用 客 戶 端 的 用 戶 的 用 戶 名 。 只 有 當 連 接 的 協 議 等 級 足 夠 高 ， 支 持 會 話 級 別 的 口 令 時 才 使 用 此 信 息 。

PASSWD變 量 包 含 使 用 客 戶 端 的 用 戶 的 口 令 。 只 有 當 連 接 的 協 議 等 級 足 夠 高 ， 支 持 會 話 級 別 的 口 令 時 才 使 用 此 信 息 。

The variable LIBSMB_PROG may contain the path, executed with system(), which the client should connect to instead of connecting to a server. This functionality is primarily intended as a development aid, and works best when using a LMHOSTS file

安 裝 INSTALLATION

存 放 這 個 程 序 的 位 置 對 於 個 人 的 系 統 管 理 員 來 說 也 是 件 麻 煩 事 。 下 面 僅 僅 是 一 些 建 議 。 推 薦 你 把 smbclient軟 件 包 安 裝 到 /usr/local/samba/bin/或 /usr/samba/bin/目 錄 中 ， 而 這 個 目 錄 對 所 有 人 來 說 應 該 是 隻 讀 的 ， 對 root纔 是 可 寫 的 。 程 序 本 身 可 以 被 所 有 人 調 用 ， 但 是 它 不 是 setuid或 者 setgid的 。 而 程 序 的 記 錄 文 件 應 該 放 在 一 個 用 戶 可 讀 寫 的 目 錄 中 。 要 測 試 這 個 程 序 ， 你 要 先 知 道 運 行 SMB/CIFS的 服 務 器 名 。 這 個 服 務 器 可 能 運 行 着 smbd(8) a守 護 進 程 並 提 供 一 個 用 戶 可 以 訪 問 的 端 口 (通 常 端 口 號 大 於 1024)， 這 樣 用 戶 就 可 以 用 這 些 數 據 來 測 試 了 。

診 斷 DIAGNOSTICS

通 常 情 況 下 診 斷 信 息 都 記 錄 到 指 定 好 的 記 錄 文 件 中 。 這 個 文 件 的 名 稱 是 在 編 譯 時 指 定 的 ， 但 也 可 以 用 命 令 行 來 指 定 。 用 戶 可 以 得 到 的 診 斷 信 息 的 數 量 和 種 類 取 決 於 用 戶 執 行 客 戶 端 程 序 時 所 用 的 調 試 等 級 。 如 果 你 發 現 有 問 題 的 話 ， 把 調 試 級 設 到 3並 詳 細 閱 讀 記 錄 文 件 裏 的 內 容 。

版 本 VERSION

此 手 冊 頁 是 針 對 Samba套 件 版 本 2.2的 。

作 者 AUTHOR

samba軟 件 和 相 關 工 具 最 初 由 Andrew Tridgell創 建 。 samba現 在 由 Samba Team 作 爲 開 源 軟 件 來 發 展 ， 類 似 linux內 核 的 開 發 方 式 。 最 初 的 samba手 冊 頁 是 Karl Auer寫 的 。 手 冊 頁 源 碼 已 經 轉 換 爲 YODL格 式 (另 一 種 很 好 的 開 源 軟 件 ， 可 以 在 ftp://ftp.ice.rug.nl/pub/unix找; 到 )， 由 Jeremy Sllison 更 新 到 Samba2.0 版 本 。 Gerald Carter 在 Samba2.2中 將 它 轉 化 爲 DocBook 格 式 。 Alexander Bokovoy 在 Samba 3.0中 實 現 了 DocBook XML4.2 格 式 的 轉 換 。

[中 文 版 維 護 人 ]

meaculpa <meaculpa [AT] 21cn.com>

[中 文 版 最 新 更 新 ]

2000/12/08

《 中 國 linux論 壇 man手 冊 頁 翻 譯 計 劃 》 :

http://cmpp.linuxforum.net

跋

本 頁 面 中 文 版 由 中 文 man 手 冊 頁 計 劃 提 供 。 中 文 man 手 冊 頁 計 劃 ： https://github.com/man-pages-zh/manpages-zh