DeleGate version 8.8 リファレンスマニュアル の日本語訳

翻訳者: 鈴木 雄(すずき ひろし)setter AT i-red DOT info

翻訳開始日:2001/8/23(v7.5) (1997/11-v4.3)
最終更新日:2004/1/18(v8.8.9)

翻訳者コメント:

"翻訳のドラフト"です。
翻訳の正確さなどは、一切保証しません(できません(^^;)。
必ず、原文(http://www.delegate.org/)を併用して下さい。

誤訳や欠落などに関するご指摘は謹んでお受けいたしますm(__)m

----------------------------- 以下本文 ------------------------------


DeleGate version 8.8 リファレンスマニュアル
Copyright (c) 1994-2000 Yutaka Sato <ysato AT etl DOT go DOT jp> <y DOT sato AT delegate DOT org>
Copyright (c) 1994-2000 Electrotechnical Laboratry (ETL), AIST, MITI
Copyright (c) 2001-2004 National Institute of Advanced Industrial Science and Technology (AIST)

Permission to use this material for evaluation, copy this material for your own use, and distribute the copies via publically accessible on-line media, without fee, is hereby granted provided that the above copyright notice and this permission notice appear in all copies. AIST makes no representations about the accuracy or suitability of this material for any purpose. it is provided "as is", without any express or implied warranties.


上記部分(著作権と使用許諾に関する記述)は、 そのままつける必要があるので、訳さないでおきます。(訳者)
参考のための訳:
著作権 (c) 1994-2000 Yutaka Sato <ysato AT etl DOT go DOT jp> <y DOT sato AT delegate DOT org>
著作権 (c) 1994-2000 Electrotechnical Laboratry (ETL), AIST, MITI
著作権 (c) 2001-2002 National Institute of Advanced Industrial Science and Technology (AIST)

本マテリアルの、
・評価のための使用
・自らが使用するための複製
・誰もがアクセス可能なオンラインメディアを経由した複製の無料配布
許可は、 上記の著作権通知、および、この認可通知を、全ての複製中で、 閲覧可能なことを条件として、認めます。 AISTは、本マテリアルのあらゆる目的に対する、正確さや、適合性に関する表示をしません。 それは、いかなる、明示、または、暗示された保証がともなわないまま、提供されています。


このドキュメントは、DeleGate/8.Xをベースにして書かれています。 このドキュメント(原文の英語マニュアルに関してのみ)に関するコメントは、 mailto:feedback@delegate.org まで、お願いします。 なお、それらの内容は、 http://www.delegate.org/feedback/ で、共有・公開します。 DeleGate ホームページ http://www.delegate.org/ で、最新の状態をご覧ください。 さらに、初心者の方々は、 http://www.delegate.org/delegate/tutorial/ にて、ショートチュートリアルをお読みになることを推奨します。
[skeleton] [frame] ... these links are active only when accessed via origin HTTP-DeleGate

順列目次

目次

--------- --------- --------- --------- --------- --------- --------- ---------
DELEGATED(8)		     メンテナンス コマンド		   DELEGATED(8)

名称

概要 説明

オプション

   -P option  --   DeleGateの入り口ポート番号
	      ==  -Pport[,port]*
	 port == [host:]portNum[/udp]
      portNum == number[-number]
   -f option  --  フォアグラウンドで実行
   -r option  -- 再起動
   -v option  --  ログレベルを制御
	      ==  -v[vdtsau]
-d option -- サブコンポーネントのデバッグ == -d[hs]
   -S option  --  SIGCHLD シグナルを監視します
   -T option  --  システムコールトレース
	      ==  -T[xsdt]*
   -F option  --  拡張機能
	      ==  -Ffunction
   -- option  --  コマンドライン引数を隠す
   parameter  ==  name=value
   conditional parameter == (condition)parameter
   -e option  ==  -ename=value
用語

パラメータ

一般

ルーティング

アクセス制御

リソース使用制限

キャッシュ制御

マウント

データ変換

フィルタ制御

ローカルファイル使用法

ホスト名解決

プロトコル詳細
SERVER parameter* == SERVER=protocol[://host[:portNum]][:-:MountOptions]
	  portNum == [+|-]number
		  -- default: SERVER=delegate
ADMIN parameter == ADMIN=user@host.domain
		-- default: コンパイル時に指定のもの
OWNER parameter* == OWNER=user[/group][:srcHostList]
		 -- default: OWNER="nobody/nogroup"
		 -- 制約: ほとんどのUnixでスーパーユーザのみ
CRON parameter* == CRON="crontab-spec"
	crontab-spec == minute hour day month dayOfWeek action
		     -- default: none
INETD parameter* == INETD="inetd-conf"
      inetd-conf == port sockType proto waitStat uid execPath argList
	    port == [host:]portNum
	sockType == stream|dgram
	   proto == tcp|udp
	waitStat == nowait ("wait" は、まだサポートされていません。)
		 -- default: none
HOSTLIST parameter* ==	HOSTLIST=listName:HostList
CMAP parameter* == CMAP=resultStr:mapName:connMap
	connMap == ProtoList:dstHostList:srcHostList
		-- default: none
LIBPATH parameter == LIBPATH=dirPath[:dirPath]*
		  -- default: LIBPATH=LIBPATH='.:${STARTDIR}:${LIBDIR}:${EXECDIR}:${ETCDIR}'
DATAPATH parameter  ==	DATAPATH=dirPath[:dirPath]*
		    --	default: DATAPATH='.:${DGROOT}:${STARTDIR}
DGPATH parameter == DGPATH=dirPath[:dirPath]*
		 -- default: DGPATH='+:.:${HOME}/delegate:${ETCDIR}'
DGOPTS parameter == DGOPTS=opt[,opt]*
		 -- default: none
SOCKOPT parameter   ==	SOCKOPT=[no]name[:value]
		    --	default: reuse
PORT parameter == PORT=port[,port]*
	  port == [host:]portNum[/udp]
       portNum == number[-number]
	       -- default: none
FORWARD parameter*  ==	FORWARD=gatewayURL[-_-connMap]
	gatewayURL  ==  gwproto://gwhost[:gwport]
	   connMap  ==  protoList:dstHostList:srcHostList
		    --	default: none
ROUTE parameter* == ROUTE=proto://host:port/-_-dstHostList:srcHostList
		 -- default: none
MASTER parameter* == MASTER=host:port[/masterControl][:dstHostList]
		  -- default: none
MASTERP parameter == MASTERP=[host:port]
		  -- default: none
RPORT parameter == RPORT={tcp|udp}[:host]
		-- default: none
PROXY parameter* == PROXY=host:port[:dstHostList]
		 -- default: none
SOCKS parameter* == SOCKS=host[:[port][/socksOpt][:dstHostList[:srcHostList]]]
	   socksOpt  ==	[ -4 | -r ]*
		 -- default: none
SSLTUNNEL parameter == SSLTUNNEL=host:port
		    -- default: none
VSAP parameter == VSAP=host:port
	       -- default: none
CONNECT parameter* == CONNECT=connSeq[:connMap]
	   connSeq == connType[,connType]*
	  connType == cache|icp|master|https|vsap|direct|socks|udp
	   connMap == ProtoList[:dstHostList[:srcHostList]]
		   -- default: CONNECT="c,i,m,h,v,s,d:*:*:*"
SRCIF parameter*    ==	SRCIF=host[:[port][:connMap]]
	   connMap  ==  ProtoList:dstHostList:srcHostList
		    --	default: SRCIF="*:*:*:*:*"
TUNNEL parameter == TUNNEL=tunnelType:script
      tunnelType == tty7
		 -- default: none
PERMIT parameter* ==  PERMIT=connMap
	   connMap  ==  ProtoList:dstHostList:srcHostList
		  --  default: none
REJECT parameter*   ==	REJECT=connMap
	   connMap  ==  ProtoList:dstHostList:srcHostList
		    --	default: none
REMITTABLE parameter == REMITTABLE=ProtoList
		     -- default: REMITTABLE="*" for generalist
		     -- default: REMITTABLE="." for specialist
REACHABLE parameter* == REACHABLE=dstHostList
		     -- default: REACHABLE="*" (全てのホストに到達可能)
RELIABLE parameter* == RELIABLE=srcHostList
		    -- default: RELIABLE=".localnet"

これは、RELIABLE=Hosts1 RELIABLE=Hosts2 のような、 複数のRELIABLEパラメータを、単一の RELIABLE="Hosts1,Hosts2" へ、単純に、結合したものへ解釈しますが、 Hosts1 または、Hosts2 が、 否定 または、 合成演算子に含まれる場合、 "Hosts1 または Hosts2" を意味するものではありません。 もし、この文章の意味が理解できない場合は、かわりに、複数のPERMITパラメータを使用することを推奨します。

RELAY parameter*    ==	RELAY=relayTypeList[:connMap]
     relayTypeList  ==  relayType[,relayType]*
	 relayType  ==  proxy | delegate | vhost | no | nojava | noapplet
	   connMap  ==  ProtoList:dstHostList:srcHostList
		    --	default: RELAY="delegate,vhost,nojava:*:*:.localnet"
				 RELAY="proxy:*:*:*"
AUTH parameter* == AUTH=what:authProto:who
		-- default: none
AUTHORIZER parameter* == AUTHORIZER=authServList[@realmValue][:connMap]
       authServList  ==	authServ[,authServ]* | & | *
	   authServ  ==	authHost[/portNum]
	   authHost  ==	hostName | hostAddr
	    connMap  ==	ProtoList:dstHostList:srcHostList
		     -- default: none
		     -- 制限: Telnet, FTP, NNTP, SMTP, Socks および、HTTP に、適用可能
MYAUTH parameter*   ==	MYAUTH=username:password[:connMap]
		    --	default: none
		    --	制限: Socks, VSAP, SMTP, および HTTP のみに適用可能
RIDENT parameter == RIDENT=ridentType[,ridentType]*
      ridentType == client|server
		 -- default: none
MAXIMA parameter* == MAXIMA=what:number,...
		 -- default: MAXIMA=listen:20,ftpcc:2,...
TIMEOUT parameter* == TIMEOUT=what:seconds,...
		   -- default: TIMEOUT=dns:10,acc:10,con:10,lin:30,...
DELAY parameter* == DELAY=what:seconds
		 -- default: DELAY=reject:60,unknown:60,...
MOUNT parameter* == MOUNT="vURL rURL [MountOptions]"
		 -- default: MOUNT="/* SERVER_URL*"
MountOptions == option[,option]*
URICONV parameter* == URICONV={convSpec|defElem|defAttr}
	  convSpec == convList:attrList
	   defElem == defelem:+,elemnameList
	   defAttr == defattr:+,attrnameList
		   -- default: URICONV=dump で見れます。
BASEURL parameter == BASEURL=URL
		  -- default: none
DELEGATE parameter == DELEGATE=gwHost:Port[:ProtoList]
		   -- default: DELEGATE=currentHost:currentPort
CACHE parameter* == CACHE=cacheControl[,cacheControl]*
    cacheControl == do | no | ro
		 -- default: none
		 -- 制限: HTTP, FTP, NNTP, Gopher に適用されます。
EXPIRE parameter* == EXPIRE=validity[/custody][:connMap]
	  connMap == ProtoList:dstHostList:srcHostList
	 validity == period
	  custody == period
	   period == Num[d|h|m|s]
		  -- default: EXPIRE=1h
CACHEFILE parameter == CACHEFILE=fileNameSpec
		    -- default: CACHEFILE='$[server:%P/%L/%p]'
ICP parameter* == ICP=icpServerList[:icpServerSpec[:connMap]]
 icpServerList == icpServer[,icpServer]*
     icpServer == icpHost[/icpType/proxyPort/icpPort]
 icpServerSpec == icpOptions:proxyPort:icpPort
       connMap == ProtoList:dstHostList:srcHostList
	       -- default: none
-- 制限: {HTTP,FTP}-DeleGate に対し適用
CHARCODE parameter == CHARCODE=[inputCode/]outputCode
	outputCode == charCode
	  charCode == iso-2022-jp | euc-jp | shift_jis | JIS | EUC | SJIS | UTF8
		   -- default: none
HTMLCONV parameter == HTMLCONV=convList
	  convList == conv[,conv]*
	      conv == deent|enent|fullurl
		   -- default: HTMLCONV=deent
MIMECONV parameter == MIMECONV=mimeConv[,mimeConv]
	  mimeConv == thru | charcode | nospenc
		   -- default: none
		   -- MIMECONV="" CHARCODE パラメータが与えられた場合
FCL parameter	  == FCL=filterCommand
FTOCL parameter   == FTOCL=filterCommand
FFROMCL parameter == FFROMCL=filterCommand
FSV parameter	  == FSV=filterCommand
FTOSV parameter   == FTOSV=filterCommand
FFROMSV parameter == FFROMSV=filterCommand
FMD parameter	  == FMD=filterCommand
FTOMD parameter   == FTOMD=filterCommand
FFROMMD parameter == FFROMMD=filterCommand
filterCommand	   == [-s,][-p,][-w,]command
		  -- default: none
XCOM parameter == XCOM=filterCommand
XFIL parameter == XFIL=filterCommand
	       -- default: none
CHROOT parameter == CHROOT=dirPath
		 -- default: none
		 -- 制限: 大抵のUnixで、super-user のみ
DGROOT parameter    ==	DGROOT=dirPath
		    --	default:  on Unix: '/' if CHROOT is set or
					   '${HOME}/delegate' or
					   '/var/spool/delegate-${OWNER}' or
					   '/tmp/delegate-${OWNER}'
			       on Windows: '/Program Files/DeleGate'
SHARE parameter == SHARE=dirPatternList
		-- default: empty
UMASK parameter == UMASK=mask
		-- default: the value of umask(2)
VARDIR parameter == VARDIR=dirPath
		 -- default: VARDIR='${DGROOT?&:/var/spool/delegate}'
CACHEDIR parameter == CACHEDIR=dirPath
		   -- default: CACHEDIR='${VARDIR}/cache'
ETCDIR parameter == ETCDIR=dirPath
		 -- default: ETCDIR='${VARDIR}/etc'
LOGDIR parameter == LOGDIR=dirPath
		 -- default: LOGDIR='${VARDIR}/log'
LOGFILE parameter  == LOGFILE=[LogFilename]
PROTOLOG parameter == PROTOLOG=[LogFilename][:logFormat]
ERRORLOG parameter == ERRORLOG=LogFilename
TRACELOG parameter == TRACELOG=LogFilename
		   -- default: LOGFILE='${LOGDIR}/${PORT}'
		   -- default: PROTOLOG='${LOGDIR}/${PORT}.${PROTO}'
		   -- default: ERRORLOG='${LOGDIR}/errors.log'
		   -- default: TRACELOG='${LOGDIR}/ptrace.log'

エージングのためのLogFilenameとdirPathの置換え

EXPIRELOG parameter == EXPIRELOG=LogFilename
		    -- default: EXPIRELOG='${LOGDIR}/expire.log'
WORKDIR parameter == WORKDIR=dirPath
		  -- default: WORKDIR='${VARDIR}/work/${PORT}'
ACTDIR parameter  == ACTDIR=dirPath
TMPDIR parameter  == TMPDIR=dirPath
PIDFILE parameter == PIDFILE=fileName
		  -- default: ACTDIR='${ACTDIR}/act'
		  -- default: TMPDIR=system dependent
		  -- default: PIDFILE='${ACTDIR}/pid/${PORT}'
HOSTS parameter* == HOSTS=nameList[/addrList]
	nameList == name | {name[,name]*}
	addrList == addr | {addr[,addr]*}
		 -- default: HOSTS=localhost/127.0.0.1
RESOLV parameter == RESOLV=[resolver[,resolver]*]
	resolver == cache | file | nis | dns | sys
		 -- default: RESOLV=cache,file,nis,dns,sys
RES_CONF parameter == RES_CONF=URL
		   -- default: RES_CONF="file:/etc/resolv.conf" or from registry (on Windows)
RES_NS parameter == RES_NS=dnsServer[//socksV5Host]
		 -- default: RES_CONF による
RES_RR parameter == RES_RR=HostList
		 -- default: RES_RR="*"
RES_VRFY parameter == RES_VRFY=""
		   -- default: none
RES_DEBUG parameter == RES_VRFY=number
		    -- default: none
PROTOLIST
 ProtoList == [!]protoSpec[,ProtoList]
 protoSpec == protocolName[/[portNumList][/methodList]]
HOSTLIST
	HostList  ==  [!][-iType]hostSpec[,HostList]
	   iType  ==  {h|a|c|*}/[iType]
	hostSpec  ==  [{userList}@]hostSpec[/netMask]
	userList  ==  userNamePattern[,userNamePattern]*
	hostSpec  ==  hostNamePattern|hostAddrPattern
 userNamePattern  ==  [*]uname[*]
 hostNamePattern  ==  [*]hname[*]
 hostAddrPattern  ==  IPaddressPattern|IPrange
	 netMask  ==  IPaddress|maskLength
パラメータ置換

CFI と CFI スクリプト

URL書換えによるプロキシ動作

プロトコルの詳細と使用例

共通の表記

TCPrelay

UDPrelay

DGAuth サーバ

PAM server

SockMux サーバ

Socks サーバ

HTTP プロキシ/サーバ

HTTP 伝送ログ書式

HTTPCONF parameter == what:conf
FILETYPE parameter == suffix:gopherType:altText:iconName:contentType
		   -- default: FILETYPE=".txt:0:TXT:text:text/plain"
			       FILETYPE=...
CGIENV parameter == CGIENV=name[,name]*
		 -- default: CGIENV="*"

HTTP-DeleGate の AUTH パラメータ

ユーザによるDeleGateの構成

SHTMLファイルでのサーバサイドの実装(SSI)

ICP プロキシ/サーバ

  ICPCONF parameter* == ICPCONF={icpMaxima|icpConf}
	   icpMaxima == para:N|hitage:N|hitobjage:N|hitobjsize:N|timeout:N
	     icpConf == icpOptions:ProtoList:dstHostList:srcHostList
		     -- default: ICPCONF=para:2,hitage:1d,...

FTP プロキシ/サーバ

FTPCONF parameter*  ==	FTPCONF=ftpControl[:{sv|cl}]
	   ftpControl  ==  nopasv | noport | noxdc | rawxdc
		    --	default: none

FTP 伝送ログ書式

Telnet プロキシ/サーバ

POP プロキシ

IMAP プロキシ

SMTP プロキシ/サーバ
SMTPCONF parameter  ==	SMTPCONF=what:conf
		    --	default: SMTPCONF=bgdatasize:64K
SMTPGATE parameter  ==	SMTPGATE=dirPath
		    --	default: SMTPGATE='${ETCDIR}/smtpgate'

NNTP プロキシ/サーバ

NNTPのMountOptions
NNTPCONF parameter* == what:conf
		    -- default: NNTPCONF=upact:600/300/120

LDAP プロキシ

Whois プロキシ

X プロキシ

Gopher プロキシ

SSL プロキシ

DNS (Domain Name System) プロキシ/サーバ

DNSCONF parameter* == what:value

CU-SeeMe プロキシ

予約名

AF_LOCAL ソケット

カスタマイズ

アタッカー防御

プラットフォームに関する詳細

紳士的再起動

機能オプション
-Fauth -{a|d|v} username[:password] hostname[:portnumber] [expire]
AUTHORIZER のサーバとして hostname に対する、定義済み(キャッシュされた)認証情報を、追加,削除、または、表示します。 hostname の前に "-" がつく場合、実サーバなしの仮想名と同一となります。
例)

ファイル

参考文献

著者

フィードバック

配布
リリース 8.8.9		最終更新: 2004年1月15日

--------- --------- --------- --------- --------- --------- --------- ---------