Manpages

NAME

rpcclient − MS-RPC 関 数 を 発 行 す る ク ラ イ ア ン ト ツ ー ル

SYNOPSIS

rpcclient [ -A authfile ] [ -c <command string> ] [ -d debuglevel ] [ -h ] [ -l logfile ] [ -N ] [ -s <smb config file> ] [ -U username[%password] ] [ -W workgroup ] [ -N ] server

DESCRIPTION

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

rpcclient は Samba の MS-RPC 機 能 を テ ス ト す る た め に 開 発 さ れ た ユ ー テ ィ リ テ ィ で あ る 。 こ れ は 開 発 と 安 定 と い う サ イ ク ル を 何 度 か 行 な っ て き て い る 。 シ ス テ ム 管 理 者 の 多 く が こ の ツ ー ル を 用 い て UNIX ワ ー ク ス テ ー シ ョ ン か ら Windows NT ク ラ イ ア ン ト を 管 理 す る ス ク リ プ ト を 記 述 し て い る 。

オ プ シ ョ ン

server 接 続 先 の サ ー バ を

NetBIOS 名 で 指 定 す る 。 サ ー バ は SMB/CIFS サ ー バ

で あ る 必 要 が あ る 。 こ の 名 前 の 解 決 に は smb.conf(5) フ ァ イ ル で 指 定 さ れ た name resolve order <URL:smb.conf.5.html#NAMERESOLVEORDER> パ ラ メ ー タ が 用 い ら れ る 。

-A filename こ の オ プ シ ョ ン は 、 接 続 時 の ユ ー ザ 名 と パ ス ワ ー ド を 読 み だ す フ ァ イ ル を 指 定 す る 。 フ ァ イ ル は 以 下 の 形 式 で 記 述 す る

username = <値 >

password = <値 >

domain = <値 >

フ ァ イ ル の パ ー ミ ッ シ ョ ン の 設 定 を 行 な っ て 意 図 し な い ユ ー ザ に ア ク セ ス を 禁 止 し て お く こ と を 忘 れ な い よ う に 。

-c ’command string’ 実 行 す る コ マ ン ド (以 下 で 記 述 す る も の )を セ ミ コ ロ ン で 区 切 っ て 指 定 す る 。
-d debuglevel

debuglevel を 設 定 す る 。 こ れ は 0 か ら 100 ま で の 値 を と る 。 Samba Team に バ グ レ ポ ー ト を 送 る 際 に は 、 こ の 値 を 100 に 設 定 す る こ と (BUGS.txt を 参 照 の こ と )。

-h コ マ ン ド ラ イ ン オ プ シ ョ ン の 概 要 を 出 力 す る

-l logbasename ロ ギ ン グ に 用 い る フ ァ イ ル 名 を 指 定 す る 。 フ ァ イ ル 名 に は .client と い う 拡 張 子 が つ け ら れ る 。 こ の フ ァ イ ル が ク ラ イ ア ン ト 側 か ら 削 除 さ れ る こ と は 決 し て な い 。

-N

rpcclient が パ ス ワ ー ド を 問 い 合 わ せ な い よ う に す る 。 通 常 rpcclient は パ ス ワ ー ド プ ロ ン プ ト を 表 示 す る 。 -U オ プ シ ョ ン も 参 照 の こ と 。

-s smb.conf

smb.conf フ ァ イ ル の 場 所 を 指 定 す る 。

-U username[%password]

SMB ユ ー ザ 名 も し く は ユ ー ザ 名 と パ ス ワ ー ド を 指 定 す る 。

%password が 指 定 さ れ て い な か っ た 場 合 は 、 パ ス ワ ー ド プ ロ ン プ ト が 表 示 さ れ る 。 な お 、 ク ラ イ ア ン ト は 、 USER 環 境 変 数 の 値 、 つ い で LOGNAME環 境 変 数 の 値 を 確 認 し 、 い ず れ か が 設 定 さ れ て い れ ば 、 値 を 大 文 字 に し た も の を 初 期 値 と し て 保 持 し て い る 。 こ れ ら の 変 数 が 設 定 さ れ て い な か っ た 場 合 は 、 ユ ー ザ 名 と し て GUEST が 設 定 さ れ て い る 。 更 に 、 ユ ー ザ 名 と パ ス ワ ー ド を 平 文 で 含 む 認 証 情 報 フ ァ イ ル を 利 用 す る こ と も 可 能 で あ る 。 こ の オ プ シ ョ ン は 、 管 理 者 が コ マ ン ド ラ イ ン や 環 境 変 数 か ら 認 証 情 報 を 入 力 す る こ と の で き な い ス ク リ プ ト で の 用 途 を 主 眼 と し て 提 供 さ れ て い る 。 こ の 方 法 を 利 用 す る 場 合 は 、 フ ァ イ ル の パ ー ミ ッ シ ョ ン の 設 定 を 行 い 、 意 図 し な い ユ ー ザ に ア ク セ ス を 禁 止 し て お く こ と を 忘 れ な い よ う に 。 詳 細 は -A オ プ シ ョ ン を 参 照 の こ と 。 パ ス ワ ー ド を ス ク リ プ ト に 含 む 場 合 は 慎 重 に 行 な う こ と 。 多 く の シ ス テ ム に お い て 、 ps コ マ ン ド に よ っ て 実 行 中 プ ロ セ ス の コ マ ン ド ラ イ ン を 確 認 す る こ と が 可 能 で あ る 。 安 全 の た め に は rpcclient が 常 に パ ス ワ ー ド プ ロ ン プ ト を 表 示 す る よ う に し て 、 直 接 パ ス ワ ー ド を 入 力 す る よ う に し て お く こ と 。

-W domain 指 定 し た ユ ー ザ が 所 属 す る SMB ド メ イ ン を 指 定 す る 。 こ れ は smb.conf で 設 定 さ れ た デ フ ォ ル ト の ド メ イ ン 名 を 上 書 き す る 。 指 定 さ れ た ド メ イ ン が サ ー バ の NetBIOS名 と 同 じ 場 合 、 ク ラ イ ア ン ト の ロ グ フ ァ イ ル に 、 (ド メ イ ン の SAMで な く ) サ ー バ の ロ ー カ ル な SAMが 用 い ら れ た こ と が 記 録 さ れ る 。

コ マ ン ド

- lookupnames + + lookupsids - Resolve a list + of SIDs to usernames. + + + lookupnames - Resolve s list + of usernames to SIDs. + +

LSARPC

lsaquery

lookupsids - リ ス ト さ れ た SID を ユ ー ザ 名 に 解 決 す る 。

lookupnames - リ ス ト さ れ た ユ ー ザ 名 を SID に 解 決 す る 。

enumtrusts

SAMR

queryuser

querygroup

queryusergroups

querygroupmem

queryaliasmem

querydispinfo

querydominfo

enumdomgroups

SPOOLSS

adddriver <arch> <config> - プ リ ン タ ド ラ イ バ 情 報 を サ ー バ に 登 録 す る た め に AddPrinterDriver() RPC の 呼 び 出 し を 行 な う 。 ド ラ イ バ フ ァ イ ル は getdriverdir コ マ ン ド が 返 却 し た デ ィ レ ク ト リ 中 に 予 め 存 在 し て い る 必 要 が あ る 。 arch に 設 定 で き る 値 は getdriverdir コ マ ン ド で 取 得 で き る 値 に な る 。 config パ ラ メ ー タ で は 以 下 の 形 式 の フ ァ イ ル を 指 定 す る

Long Printer Name:\

Driver File Name:\

Data File Name:\

Config File Name:\

Help File Name:\

Language Monitor Name:\

Default Data Type:\

Comma Separated list of Files

空 の フ ィ ー ル ド に は 、 "NULL" を 入 力 し て お く こ と

Samba は 、 双 方 向 通 信 を サ ポ ー ト し て い る ロ ー カ ル プ リ ン タ で の み 利 用 可 能 な Print Monitor の サ ポ ー ト を 行 な わ な い 。 こ の フ ィ ー ル ド は 必 ず "NULL" に し て お く こ と 。 別 の NT プ リ ン ト サ ー バ に コ マ ン ド を 発 行 す る 場 合 、 ド ラ イ バ の Print Monitor を 事 前 に イ ン ス ト ー ル し て い な い と 、 RPC に 失 敗 す る 。

addprinter <printername> <sharename> <drivername> <port> - 別 の サ ー バ 上 に プ リ ン タ を 追 加 す る 。 こ の プ リ ン タ は 自 動 的 に 共 有 さ れ る 。 こ の コ マ ン ド を 実 行 す る 前 に 、 プ リ ン タ ド ラ イ バ を サ ー バ 上 に イ ン ス ト ー ル し て ( adddriver を 参 照 の こ と )、 portを 適 切 な ポ ー ト 名 に し て お く (enumportsを 参 照 ) 必 要 が あ る こ と に 注 意 。

enumdata - サ ー バ 上 に あ る プ リ ン タ の 設 定 情 報 を 一 覧 す る 。 Windows NT ク ラ イ ア ン ト の 場 合 、 こ れ ら の 情 報 は レ ジ ス ト リ に 格 納 さ れ て い る が 、 Samba サ ー バ の 場 合 、 プ リ ン タ 用 の TDB フ ァ イ ル 中 に 格 納 さ れ て い る 。 こ の コ マ ン ド は 、 Microsoft Platform SDK 中 に あ る GetPrinterData() 関 数 に 相 当 す る 。 (こ の コ マ ン ド は 現 在 実 装 さ れ て い な い )

deldriver - す べ て の ア ー キ テ ク チ ャ 用 の 指 定 さ れ た プ リ ン タ ド ラ イ バ を 削 除 す る 。 こ れ は 、 既 存 の ド ラ イ バ フ ァ イ ル を サ ー バ か ら 削 除 す る わ け で は な く 、 サ ー バ の ド ラ イ バ の リ ス ト か ら エ ン ト リ だ け を 削 除 す る も の で あ る 。

enumjobs <printer> - 指 定 さ れ た プ リ ン タ の ジ ョ ブ お よ び そ の 状 況 を 表 示 す る 。 こ の コ マ ン ド は 、 Microsoft Platform SDK 中 の EnumJobs() 関 数 に 相 当 す る 。 (こ の コ マ ン ド は 現 在 実 装 さ れ て い な い )

enumports [level] - 指 定 さ れ た info level で EnumPorts() 関 数 を 呼 び 出 す 。 現 在 、 info level 1 と 2 の み が サ ポ ー ト さ れ て い る 。

enumdrivers [level] - EnumPrinterDrivers() を 実 行 す る 。 こ れ は 全 て の ア ー キ テ ク チ ャ 用 の イ ン ス ト ー ル さ れ た ド ラ イ バ の 一 覧 を 表 示 す る 。 フ ラ グ と オ プ シ ョ ン の 詳 細 に つ い て は 、 Microsoft Platform SDK の ド キ ュ メ ン ト を 参 照 の こ と 。 現 在 、 info level 1, 2, 3 の み が サ ポ ー ト さ れ て い る 。

enumprinters [level] - EnumPrinters() を 実 行 す る 。 こ れ は 共 有 さ れ て い る イ ン ス ト ー ル 済 プ リ ン タ の 一 覧 を 表 示 す る 。 フ ラ グ と オ プ シ ョ ン の 詳 細 に つ い て は 、 Microsoft Platform SDK の ド キ ュ メ ン ト を 参 照 の こ と 。 現 在 、 info level 0, 1, 2 の み が サ ポ ー ト さ れ て い る 。

getdata <printername> - 指 定 さ れ た プ リ ン タ の 設 定 情 報 を 取 得 す る 。 詳 細 な 情 報 に 付 い て は 、 enumdata コ マ ン ド を 参 照 の こ と 。 こ の コ マ ン ド は Microsoft Platform SDK 中 の GetPrinterData() に 相 当 す る も の で あ る 。 (こ の コ マ ン ド は 現 在 実 装 さ れ て い な い )

getdriver <printername> - 指 定 さ れ た プ リ ン タ の プ リ ン タ ド ラ イ バ の 情 報 (ド ラ イ バ フ ァ イ ル 、 設 定 フ ァ イ ル 、 関 連 す る フ ァ イ ル な ど )を 取 得 す る 。 こ の コ マ ン ド は Microsoft Platform SDK 中 の GetPrinterDriver() に 相 当 す る も の で あ る 。 現 在 、 info level 1, 2, 3 の み が サ ポ ー ト さ れ て い る 。

getdriverdir <arch> - GetPrinterDriverDirectory() RPC を 発 行 し て 、 SMB 共 有 名 と 指 定 さ れ た arch 用 の プ リ ン タ ド ラ イ バ の 格 納 さ れ て て い る サ ブ デ ィ レ ク ト リ と を 取 得 す る 。 archに 指 定 で き る 値 は 、 "Windows 4.0" (for Windows 95/98), "Windows NT x86", "Windows NT PowerPC", "Windows Alpha_AXP", "Windows NT R4000" で あ る 。

getprinter <printername> - 現 在 の プ リ ン タ 情 報 を 取 得 す る 。 こ の コ マ ン ド は Microsoft Platform SDK の GetPrinter() に 相 当 す る 。

openprinter <printername> - 指 定 し た プ リ ン タ に 対 し て 、 OpenPrinterEx() と ClosePrinter() RPC を 実 行 す る 。

setdriver <printername> <drivername> - SetPrinter() コ マ ン ド を 実 行 し て 、 既 に イ ン ス ト ー ル さ れ て い る プ リ ン タ 用 の プ リ ン タ ド ラ イ バ を 更 新 す る 。 更 新 さ れ る プ リ ン タ ド ラ イ バ は 、 プ リ ン ト サ ー バ 上 に 適 切 に イ ン ス ト ー ル さ れ て い る 必 要 が あ る 。 イ ン ス ト ー ル さ れ て い る プ リ ン タ や ド ラ イ バ の 一 覧 を 取 得 す る 方 法 に 付 い て は enumprintersenumdrivers コ マ ン ド も 参 照 の こ と 。

GENERAL OPTIONS

debuglevel - 現 在 の debug level を 設 定 す る 。 こ れ は ロ グ 情 報 の 書 き 込 み に 影 響 す る 。

help (?) - コ マ ン ド の 全 て と 、 幾 つ か の コ マ ン ド に 付 い て の よ り 詳 細 な 説 明 を 表 示 す る 。

quit (exit) - rpcclientを 終 了 さ せ る 。

BUGS

rpcclient は 開 発 者 の テ ス ト ツ ー ル と し て の 利 用 を 念 頭 に 置 い て い る た め 、 あ ま り 動 作 が 安 定 し て い な い 部 分 (コ マ ン ド ラ イ ン の 解 析 な ど )も あ る 。 不 正 な パ ラ メ ー タ を 解 析 し よ う と す る と 、 失 敗 し て コ ア ダ ン プ す る の は 既 知 の 不 具 合 で あ る 。

Luke Leighton の オ リ ジ ナ ル の rpcclient マ ニ ュ ア ル ペ ー ジ よ り :

"警 告 ! SMB 上 の MSRPC コ ー ド は ネ ッ ト ワ ー ク ト レ ー ス を 行 な う こ と で 開 発 中 で あ る 。 オ リ ジ ナ ル の 開 発 者 (Microsoft)か ら は 、 SMB 上 で MSRPC が ど の よ う に 動 作 す る か 、 個 々 の MSRPC サ ー ビ ス が ど の よ う に 動 作 す る か に つ い て の 情 報 は 提 供 さ れ て い な い 。 こ れ ら の サ ー ビ ス に 関 す る Microsoft の 実 装 も 、 場 所 に よ っ て は か な り 風 変 わ り で あ る こ と が 明 ら か に な っ て い る 。

Samba へ の 実 装 も 同 様 に 場 あ た り 的 な 面 が あ る 。 多 く の サ ー ビ ス の 実 装 が 解 明 さ れ る に つ れ て 、 smbd(8)rpcclient(1) へ の 実 装 も 可 能 に な っ て き て い る が 、 幾 つ か の コ マ ン ド や サ ー ビ ス に つ い て の 互 換 性 は な い 。 な お 、 Microsoft に 対 し て 送 ら れ た レ ポ ー ト に よ っ て 発 見 さ れ た り 報 告 さ れ た り し た 問 題 が サ ー ビ ス パ ッ ク で 修 正 さ れ て い る が 、 こ れ に よ り 結 果 と し て 互 換 性 が 損 な わ れ る こ と が あ る 。 "

バ ー ジ ョ ン

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

AUTHOR

オ リ ジ ナ ル の Samba ソ フ ト ウ ェ ア と 関 連 す る ユ ー テ ィ リ テ ィ は 、 Andrew Tridgell に よ っ て 作 成 さ れ た 。 現 在 Samba は Samba Team に よ っ て 、 Linux カ ー ネ ル の 開 発 と 同 様 の オ ー プ ン ソ ー ス プ ロ ジ ェ ク ト と し て 開 発 が 行 な わ れ て い る 。 オ リ ジ ナ ル の rpcclient マ ニ ュ ア ル ペ ー ジ は Matthew Geddes と Luke Keneth Casson Leighton に よ っ て 作 成 さ れ 、 Gerald Carter に よ っ て 書 き 直 さ れ た 。 Samba 2.2 に お け る DocBook 形 式 へ の 変 換 は 、 Gerald Carter に よ っ て 行 な わ れ た 。

日 本 語 訳

• 高 橋 基 信

(monyo [AT] samba.jp)