=begin

= mod_ruby Apacheǥ쥯ƥ

[((<ܼ|URL:index.ja.jis.html>))
|((<RD|URL:directives.ja.euc.rd>))]

* ((<RubyAddPath|RubyAddPath directory...>))
* ((<RubyRequire|RubyRequire library...>))
* ((<RubyHandler|RubyHandler expr>))
* ((<RubyPassEnv|RubyPassEnv name...>))
* ((<RubyTransHandler|RubyTransHandler expr>))
* ((<RubyAuthenHandler|RubyAuthenHandler expr>))
* ((<RubyAuthzHandler|RubyAuthzHandler expr>))
* ((<RubyAccessHandler|RubyAccessHandler expr>))
* ((<RubyTypeHandler|RubyTypeHandler expr>))
* ((<RubyFixupHandler|RubyFixupHandler expr>))
* ((<RubyLogHandler|RubyLogHandler expr>))
* ((<RubyHeaderParserHandler|RubyHeaderParserHandler expr>))
* ((<RubyPostReadRequestHandler|RubyPostReadRequestHandler expr>))
* ((<RubyInitHandler|RubyInitHandler expr>))
* ((<RubyCleanupHandler|RubyCleanupHandler expr>))
* ((<RubySetEnv|RubySetEnv name val>))
* ((<RubyTimeOut|RubyTimeOut sec>))
* ((<RubySafeLevel|RubySafeLevel level>))
* ((<RubyOutputMode|RubyOutputMode mode>))
* ((<RubyRestrictDirectives|RubyRestrictDirectives flag>))
* ((<RubyGcPerRequest|RubyGcPerRequest flag>))
* ((<RubyKanjiCode|RubyKanjiCode kcode>))

--- RubyAddPath directory...
      饤֥θѥ˥ǥ쥯ȥɲä롣

      :

        RubyAddPath /home/shugo/ruby

--- RubyRequire library...
      ((|library|))(({require}))롣

      :

        RubyRequire apache/ruby-run
        RubyRequire cgi

--- RubyHandler expr
      ruby-objectϥɥǼºݤ˽Ԥ֥Ȥ֤ꤹ롣
      request֥Ȥ((|handler|))᥽åɤƤФ롣

      :

        <Location /ruby>
          SetHandler ruby-object
          RubyHandler Apache::RubyRun.instance
        </Location>

--- RubyTransHandler expr
      URIν񤭴Ԥ֥Ȥ֤ꤹ롣
      request֥Ȥ((|translate_uri|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyTransHandler Apache::Foo.instance
        </Location>

--- RubyAuthenHandler expr
      桼IDȥѥɤγǧԤ֥Ȥ֤ꤹ롣
      request֥Ȥ((|authenticate|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyAuthenHandler Apache::Foo.instance
        </Location>

--- RubyAuthzHandler expr
      ꥽¤ɬפȤ뤫ɤγǧԤ֥Ȥ֤
      ꤹ롣
      request֥Ȥ((|authorize|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyAuthzHandler Apache::Foo.instance
        </Location>

--- RubyAccessHandler expr
      Ԥ֥Ȥ֤ꤹ롣
      request֥Ȥ((|check_access|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyAccessHandler Apache::Foo.instance
        </Location>

--- RubyTypeHandler expr
      MIME-typeΥåԤ֥Ȥ֤ꤹ롣
      request֥Ȥ((|find_types|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyTypeHandler Apache::Foo.instance
        </Location>

--- RubyFixupHandler expr
      ƤǸѹ륪֥Ȥ֤ꤹ롣
      request֥Ȥ((|fixup|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyFixupHandler Apache::Foo.instance
        </Location>

--- RubyLogHandler expr
      ꥯȤˤĤƤξϿ륪֥Ȥ֤ꤹ롣
      request֥Ȥ((|log_transaction|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyLogHandler Apache::Foo.instance
        </Location>

--- RubyHeaderParserHandler expr
      إåΥѡ򤹤륪֥Ȥ֤ꤹ롣
      request֥Ȥ((|log_transaction|))᥽åɤƤФ롣
      Apache 1.x ǤΤ߻ѤǤ롣

      :

        <Location /ruby>
          RubyHeaderParserHandler Apache::Foo.instance
        </Location>


--- RubyPostReadRequestHandler expr
      ꥯȤɤߤ塢¾Υե˸ƤФ륪֥Ȥ
      ֤ꤹ롣
      request֥Ȥ((|post_read_request|))᥽åɤƤФ롣

      :

        <Location /ruby>
          RubyPostReadRequestHandler Apache::Foo.instance
        </Location>

--- RubyInitHandler expr
      ҥץ뵯ưľ˸ƤФ륪֥Ȥ֤ꤹ롣
      request֥Ȥ((|init|))᥽åɤƤФ롣
      Х٥(Ĥޤ((|<Location>|))((|<Directory>|))
      ((|<Files>|))γ)ǻꤹȡ((<RubyPostReadRequestHandler>))
      ˼¹Ԥ졢Ǥʤ((<RubyHeaderParserHandler>))
      ¹Ԥ롣

      :

        RubyInitHandler Apache::Foo.instance

        <Location /ruby>
          RubyInitHandler Apache::Foo.instance
        </Location>

--- RubyCleanupHandler expr
      ꡼󥢥å׻˸ƤФ륪֥Ȥ֤ꤹ롣
      ꥯȴλˡrequest֥Ȥ((|cleanup|))᥽åɤ
      ƤФ롣

      :

        RubyCleanupHandler Apache::Foo.instance

        <Location /ruby>
          RubyCleanupHandler Apache::Foo.instance
        </Location>

--- RubyPassEnv name...
      ץȤ˼ϤĶѿ̾ꤹ롣
      Υǥ쥯ƥ֤ꤵʤä硢CGIĶѿ(QUERY_STRINGʤ)
      ΤߤRubyץȤϤ롣
      Υƥ쥯ƥ֤ꤵ줿硢٤ƤCGIĶѿȡꥹȤ줿
      ¾δĶѿRubyץȤѲǽȤʤ롣
      Τߤ˻ġ

      :

        RubyPassEnv HOSTNAME OSTYPE MACHTYPE

--- RubySetEnv name val
      ץȤ˼ϤĶѿͤꤹ롣

      :

        RubySetEnv LANG "ja_JP.eucJP"

--- RubyTimeOut sec
      ץȤΥॢȻ(ñ̤)ꤹ롣
      ॢȻ֤᤮Ƥ¹ԤƤ륹ץȤ϶Ū
      λ롣
      Τߤ˻ġ

      :

        RubyTimeOut 60

--- RubySafeLevel level
      ((|$SAFE|))Υǥեͤꤹ롣
      Τߤ˻ġ

      $SAFEϥƥ٥Ǥ롣
      $SAFEͤ04ޤǤǤʤФʤʤ
      mod_rubyǤ$SAFEΥǥեͤ1Ǥ롣

      $SAFE1ʾξ硢Rubyϥ桼줿ǡŪΤ
      ѤΤػߤ롣

      $SAFE2ʾξ硢RubyϤǤ񤭹ळȤΤǤ꤫ץ
      եɤ뤳Ȥػߤ롣
      writable locations.

      $SAFE3ʾξ硢줿٤ƤΥ֥Ȥϱ롣

      $SAFE4ʾξ硢RubyϥХѿʤɤΥХʾ֤ѹ
      ػߤ롣

      :

        RubySafeLevel 2

--- RubyOutputMode mode
      ץȤνϥ⡼ɤꤹ롣((|mode|))(({nosync})), (({sync})),
      (({syncheader}))ΤΤɤ줫ĤǤʤФʤʤ((|mode|))
      (({nosync}))ξ硢ץȤΤ٤ƤνϤϥХåե󥰤졢
      Ȥμ¹Ԥνλ˥եå夵롣((|mode|))(({sync}))ξ硢
      ȤΤ٤ƤνϤϤ˥饤Ȥ롣((|mode|))
      (({syncheader}))ξ硢إåνϤΤߤ졢¾νϤϥХ
      ե󥰤롣ǥեͤ(({nosync}))
      
      :

        RubyOutputMode syncheader

--- RubyRestrictDirectives flag
      ¾ΡRubyǻϤޤǥ쥯ƥ(RubyHandlerRubySetEnvʤ)
      .htaccess¤뤫ɤꤹ롣ǥեȤ(({off}))
      ͭФʤʣΥ桼Ѥʤɤ(({on}))ˤȡ
      дԤmod_rubyȤȤǤ롣ǤΤ߻
      뤳ȤǤ롣

      :

        RubyRestrictDirectives on

--- RubyGcPerRequest flag
      ƥꥯȤνGC¹Ԥ뤫ɤꤹ롣

      :

        RubyGcPerRequest on

--- RubyKanjiCode kcode
      Ruby((|$KCODE|))ꤹ롣ǥեͤ(({"NONE"}))

      :

        RubyKanjiCode euc

=end