Pegasus httpd 2.2 仕様書

• 1.0.0 Pegasus 2.2 で導入された新しい内容
• 1.1.0 ダイジェスト認証のサポート
• 1.2.0 日本語のファイル名に対応
• 2.0.0 Pegasus 2.1 から 2.2 への変更
• 2.1.0 /sys/lib/httpd.conf
• 2.2.0 /usr/web/etc/nonce
• 2.3.0 $web/etc/passwd
• 2.4.0 $web/doc/~
• 3.0.0 CGI ツールの変更と追加
• 3.1.0 webm
• 4.0.0 URI シンタックスの変遷
• 4.1.0 RFC1630 (1994)
• 4.2.0 RFC1738 (1994)
• 4.3.0 RFC1808 (1995)
• 4.4.0 RFC1945 (1996)
• 4.5.0 RFC2068 (1997)
• 4.6.0 RFC2396 (1998)
• 4.7.0 RFC2616 (1999)
• 4.8.0 RFC3986 (2005)
• 4.9.0 Blacklist
• 4.10.0 mon の実行方法が変わりました。
• 4.11.0 証明書(certificate)
• 4.12.0 MP3 と MP4
• 4.13.0 ソースファイル
• 4.14.0 ファイル構成のサンプル

更新: 2006/07/30

Pegasus 2.2 で導入された新しい内容

ダイジェスト認証のサポート

日本語のファイル名に対応

日本語のファイル名へ対応への対応問題は意外とややこしい問題を含んでおり、多分、Pegasus 2.2 はバグを含んでいるでしょう。

Pegasus 2.1 から 2.2 への変更

/sys/lib/httpd.conf

# allowbasic		0	# 1: allow basic authentication

	allowbasic	1

/usr/web/etc/nonce

	/usr/web/etc/nonce

term% pwd
/usr/web/etc
term% ls -l
d-rwxrwx--- M 8 arisawa web       0 Jul 15 21:55 nonce

$web/etc/passwd

	/usr/alice/web

#       old format is
#               user key path
#       the key is produced by
#               echo -n 'password' | md5sum
#       for example
#               echo -n 'black cat' | md5sum
#
#       new format is
#               user key path realm
#       the key is produced by
#               echo -n 'user:realm:password' | md5sum
#       for example
#               echo -n 'arisawa:/private:black cat' | md5sum
#
arisawa c05f2777ab3d9488d07d0e3f8e38c79a        /me
arisawa a7f0bde701b79510db88dfa4ae0295cd        /private /private

この内容は

• ユーザ名
  
• 認証キー
  
• 保護されるバス名
  
• 認証レルム名
  

$web/doc/~

	/usr/alice/web/doc/

	http://host/~alice/foo

	/usr/alice/web/doc/foo

	/usr/bob/www/doc/

	/usr/bob/www/doc/~/

	/usr/alice/web/doc/~/

実はこの仕組みを考えたのは favicon.ico 対策からでした。Safari などのブラウザはしっつこく favicon.ico を

	http://host/favicon.ico

	http://host/~alice/foo/

CGI ツールの変更と追加

webm

URI シンタックスの変遷

	scheme://host:port/path;params?query

	net_path       = "//" net_loc [ abs_path ]
	abs_path       = "/" rel_path
	rel_path       = [ path ] [ ";" params ] [ "?" query ]
	params         = param *( ";" param )
	param          = *( pchar | "/" )

RFC1630 (1994)

	表題: Universal Resource Identifiers in WWW

RFC1738 (1994)

	表題: Uniform Resource Locators (URL)

ここでは HTTP で使用されている URL のシンタックスを次のように説明しています。

httpurl        = "http://" hostport [ "/" hpath [ "?" search ]]
hpath          = hsegment *[ "/" hsegment ]
hsegment       = *[ uchar | ";" | ":" | "@" | "&" | "=" ]
search         = *[ uchar | ";" | ":" | "@" | "&" | "=" ]

safe           = "$" | "-" | "_" | "." | "+"
extra          = "!" | "*" | "'" | "(" | ")" | ","
unreserved     = alpha | digit | safe | extra
uchar          = unreserved | escape

ftpurl         = "ftp://" login [ "/" fpath [ ";type=" ftptype ]]
ftptype        = "A" | "I" | "D" | "a" | "i" | "d"

RFC1808 (1995)

	表題: Relative Uniform Resource Locators

Base:

?y         = <URL:http://a/b/c/d;p?y>
g?y        = <URL:http://a/b/c/g?y>
;x         = <URL:http://a/b/c/d;x>
g;x        = <URL:http://a/b/c/g;x>

RFC1945 (1996)

	表題: Hypertext Transfer Protocol -- HTTP/1.0

URIs have been known by many names: WWW addresses, Universal Document
Identifiers, Universal Resource Identifiers [2], and finally the
combination of Uniform Resource Locators (URL) [4] and Names (URN)
[16]. As far as HTTP is concerned, Uniform Resource Identifiers are
simply formatted strings which identify--via name, location, or any
other characteristic--a network resource.

URI            = ( absoluteURI | relativeURI ) [ "#" fragment ]
absoluteURI    = scheme ":" *( uchar | reserved )
relativeURI    = net_path | abs_path | rel_path
net_path       = "//" net_loc [ abs_path ]
abs_path       = "/" rel_path
rel_path       = [ path ] [ ";" params ] [ "?" query ]
path           = fsegment *( "/" segment )
fsegment       = 1*pchar
segment        = *pchar
params         = param *( ";" param )
param          = *( pchar | "/" )
scheme         = 1*( ALPHA | DIGIT | "+" | "-" | "." )
net_loc        = *( pchar | ";" | "?" )
query          = *( uchar | reserved )
fragment       = *( uchar | reserved )
pchar          = uchar | ":" | "@" | "&" | "=" | "+"
uchar          = unreserved | escape
unreserved     = ALPHA | DIGIT | safe | extra | national
escape         = "%" HEX HEX
reserved       = ";" | "/" | "?" | ":" | "@" | "&" | "=" | "+"
extra          = "!" | "*" | "'" | "(" | ")" | ","
safe           = "$" | "-" | "_" | "."
unsafe         = CTL | SP | <"> | "#" | "%" | "<" | ">"
national       = <any OCTET excluding ALPHA, DIGIT,
                 reserved, extra, safe, and unsafe>

For definitive information on URL syntax and semantics, see RFC 1738
[4] and RFC 1808 [9]. The BNF above includes national characters not
allowed in valid URLs as specified by RFC 1738, since HTTP servers
are not restricted in the set of unreserved characters allowed to
represent the rel_path part of addresses, and HTTP proxies may
receive requests for URIs not defined by RFC 1738.

RFC2068 (1997)

RFC2396 (1998)

	表題: Uniform Resource Identifiers (URI): Generic Syntax

o A URI is a sequence of characters, which is not always
represented as a sequence of octets.

o A URI may be transcribed from a non-network source, and thus
should consist of characters that are most likely to be able to
be typed into a computer, within the constraints imposed by
keyboards (and related input devices) across languages and
locales.

o A URI often needs to be remembered by people, and it is easier
for people to remember a URI when it consists of meaningful
components.

URI の一般的なシンタックスを議論している RFC2396 になると param の現れる場所が増えており

	net_path      = "//" authority [ abs_path ]
	abs_path      = "/"  path_segments
	path_segments = segment *( "/" segment )
	segment       = *pchar *( ";" param )
	param         = *pchar
	pchar         = unreserved | escaped |
			":" | "@" | "&" | "=" | "+" | "$" | ","

RFC2616 (1999)

	表題: Hypertext Transfer Protocol -- HTTP/1.1

	http_URL = "http:" "//" host [ ":" port ] [ abs_path [ "?" query ]]

RFC3986 (2005)

	http://a/b/c/d;p?q

	?y		=	http://a/b/c/d;p?y

	;x		=	http://a/b/c/;x

	http://a/b/c/d;x

	http://a/b/c/;x

Blacklist

	/sys/lib/http.conf

...
# maxconnect      30      # max connections by a single remote IP
# obstime               3       # observation time to detect burst access (in unit of sec)
# maxaccess     20      # allowed max access in obstime
# lockouttime   180     # lockouttime for maxconnect and maxaccess  (in unit of
...

mon の実行方法が変わりました。

証明書(certificate)

MP3 と MP4

.mp3            audio           mpeg           -        y      # Kenar
.mp4            video           mp4            -        y      # Kenar

僕の家庭内のLAN環境では問題なく動作しますが、大学と僕の家では途切れ途切れです。また、普通のパソコンをストリーミングサーバにして多人数のアクセスを許した場合にはサーバが保たないと思います。

ソースファイル

ファイル構成のサンプル