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

翻訳者: 鈴木 雄(すずき ひろし)<setter at i-red dot info>

翻訳開始日:2001/8/23(v7.5) (1997/11-v4.3)
最終更新日:2006/10/20 (v9.2.5)

翻訳者コメント:

翻訳の正確さなどは、一切保証しません (できません(^^;;;)。
ですから、この文書をお読みになる方は、*必ず*原文 (http://www.delegate.org/delegate/) を併用して下さい。

誤訳などのご指摘は大歓迎ですm(__)m


DeleGate version 9.2 リファレンスマニュアル
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-2006 National Institute of Advanced Industrial Science and Technology (AIST)
AIST-Product-ID: 2000-ETL-198715-01, H14PRO-049, H15PRO-165, H18PRO-443

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 佐藤 豊 <ysato AT etl DOT go DOT jp> <y DOT sato AT delegate DOT org>
著作権 (c) 1994-2000 電子技術総合研究所 (ETL), AIST, MITI
著作権 (c) 2001-2006 独立行政法人 産業技術総合研究所 (AIST)
AIST-Product-ID: 2000-ETL-198715-01, H14PRO-049, H15PRO-165, H18PRO-443

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


このドキュメントは、DeleGate/9.X の最新バージョンをベースにして書かれています。 このドキュメント (訳注: 原文の英語マニュアルに関してのみ) に関するコメントは、 mailto:feedback@delegate.org まで、お願いします。 なお、それらの内容は、 http://www.delegate.org/feedback/ で、共有/公開します。 DeleGate ホームページ http://www.delegate.org/ で、最新状況をご覧ください。 さらに、初心者の方々は、 http://www.delegate.org/delegate/tutorial/ にて、簡潔な入門書をお読みになることを推奨します。 http://www.delegate.org/delegate/HowToDG.html に、使用例集があります。 DeleGate で何ができるか確認するのに便利でしょう。
[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][/admin]
      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 でスーパーユーザのみ
		 -- 制限: Windows 上でのサービスのユーザの設定
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
TLSCONF parameter*  ==  TLSCONF=tlsConf[,tlsConf]*
           tlsConf  ==  what:value
                    --  default: TLSCONF=scache:do,xcache:do
STLS parameter*     ==  STLS=stlsSpecs[,sslwayCom][:connMap]
         stlsSpecs  ==  [-]stlsSpec[/ssl][,stlsSpecs]
           stlsSpec  ==  fsv | fcl | mitm | imimSec
         sslwayCom  ==  {sslway [-Vrfy] [-CApath dir] ...}
           connMap  ==  ProtoList:dstHostList:srcHostList
                    --  default: none
                    --  制限: HTTP, FTP, SMTP, POP, IMAP, SOCKS に対して有効
                    --  必須: SSLway
DYLIB parameter     ==  DYLIB=libfilePattern[,libfilePattern]*
                    --  default: DYLIB='dglib*.so,lib*.so,dglib*.dylib,lib*.dylib'
LDPATH parameter    ==  LDPATH=dirPath[;dirPath]*
                    --  default: LDPATH='${LIBDIR};${EXECDIR};/usr/lib;/lib'
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}'
DGSIGN parameter    ==  DGSIGN=signatureSpec
                     --  default: DGSIGN="V.R.P/Y.M.D"
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
                    -- 制限:  HTTP, FTP, Telnet に適用可能
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|proxy|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="*" - generalist 用
                    -- default: REMITTABLE="." - specialist 用
REACHABLE parameter* == REACHABLE=dstHostList
                    -- default: REACHABLE="*" (全てのホストに接続可能)
RELIABLE parameter* == RELIABLE=srcHostList
                    -- default: RELIABLE=".localnet"
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][(reprUser)]
	   authHost  ==	hostName | hostAddr
	 realmValue  == word | {words separated with space}
	    connMap  ==	ProtoList:dstHostList:srcHostList
		     -- default: none
		     -- 制限: Telnet, FTP, NNTP, SMTP, IMAP, Socks, SockMux および、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
COUNTER parameter*  ==  COUNTER=listOfCounterControl
    counterControl  ==  do | total | acc | ssi | ref | err | ro | no | mntpV
                    --  default: COUNTER=no
                    --  制限: HTTP, SMTP, FTP, DNS に適用可能
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
                    --  CHARCODE パラメータが与えられた場合 MIMECONV=""
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:  Unix: '/' CHROOT が設定されるか
                                           '${HOME}/delegate',
                                           '/var/spool/delegate-${OWNER}',
                                           '/tmp/delegate-${OWNER}' の場合
                                  Windows: '/Program Files/DeleGate'
SHARE parameter     ==  SHARE=dirPatternList
                    --  default: empty
UMASK parameter     == UMASK=mask
                    -- default: 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'
SYSLOG parameter*   ==  SYSLOG=[syslogOpts,][syslogServ]
        syslogOpts  ==  syslogOpt[,syslogOpts]
         syslogOpt  ==  -vt | -vs | -vS | -vH | -fname
                    --  default: none

エージングのための 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='${DGROOT}/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  ==  resType[:[resParam][:[queryHostList][:clientHostList]]]
           resType  ==  cache | file | nis | dns | sys
                    --  default: RESOLV=cache,file,nis,dns,sys
RES_WAIT parameter  ==  RES_WAIT=seconds:hostname
                    --  default: RES_CONF="10:WWW.DeleGate.ORG"
RES_CONF parameter  ==  RES_CONF=URL
                    --  default: RES_CONF="file:/etc/resolv.conf"
                        or from registry (on Windows)
RES_NS parameter    ==  RES_NS=nsList
                    --  nsList=dnsServ[,nsList]
                    --  dnsServ=dnsServer[//socksV5Host]
                    --  default: depend on RES_CONF
RES_AF parameter    ==  RES_AF=afOrder
            afOrder ==  46 | 64 | 4 | 6
                    --  default: 46
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 parameter*  ==  host:port:option[,option]*
            option  ==  acc | con | ssl
                    --  default: none
                    --  status: tentative
SOXCONF parameter*  ==  confSpec[,confSpec]*
                    --  default: none

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 用のマウントオプション

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 の MountOption
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 ソケット

カスタマイズ

アタッカー防御

設定の暗号化

プラットフォーム特有の問題

紳士的再起動

機能オプション

ファイル

参考文献

著者

フィードバック

配布
リリース 9.2.5             最終更新: 2006年10月20日

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