目 次


このマニュアルについて

第 1 章 サーバの動作の基本

構成ファイル

magnus.conf

server.xml

obj.conf

mime.types

動的再構成

サーバによるクライアントからの要求の処理方法

HTTP の基本

要求処理プロセスのステップ

要求の処理のための指令

新しいサーバアプリケーション関数の作成

第 2 章 obj.conf の構文と使用法

obj.conf に含まれるサーバの命令

指令の要約

Object タグ

name 属性を使うオブジェクト

ppath 属性を使うオブジェクト

server.xml に定義された変数

obj.conf 内の制御のフロー

AuthTrans

NameTrans

PathCheck

ObjectType

Service

AddLog

Error

obj.conf の編集上の構文規則

指令の順序

パラメータ

大文字、小文字の区別

区切り文字

引用符

空白文字

行の継続

パス名

コメント

obj.conf 指令の例について

第 3 章 事前定義済みの SAF および要求処理プロセス

バケットパラメータ

AuthTrans 段階

basic-auth

basic-ncsa

get-sslid

qos-handler

NameTrans 段階

assign-name

document-root

home-page

pfx2dir

redirect

strip-params

unix-home

PathCheck 段階

check-acl

deny-existence

find-index

find-links

find-pathinfo

get-client-cert

load-config

nt-uri-clean

ntcgicheck

require-auth

set-virtual-index

ssl-check

ssl-logout

unix-uri-clean

ObjectType 段階

force-type

set-default-type

shtml-hacktype

type-by-exp

type-by-extension

Service 段階

add-footer

add-header

append-trailer

imagemap

index-common

index-simple

key-toosmall

list-dir

make-dir

query-handler

remove-dir

remove-file

rename-file

send-cgi

send-file

send-range

send-shellcgi

send-wincgi

service-dump

shtml_send

stats-xml

upload-file

AddLog 段階

common-log

flex-log

record-useragent

Error 段階

send-error

qos-error

第 4 章 カスタム SAF の作成

SAF インタフェース

SAF パラメータ

pb (parameter block)

sn (session)

rq (request)

結果コード

カスタム SAF の作成と使用

ソースコードを記述する

コンパイルしリンクする

SAF を読み込んで初期化する

サーバに SAF を呼び出すように指示する

サーバを再構成する

SAF をテストする

NSAPI C 関数の概要

パラメータブロック操作ルーチン

Service SAF 用のプロトコルユーティリティ

メモリーの管理

ファイル入出力

ネットワーク入出力

スレッド

ユーティリティ

仮想サーバ

各指令用の SAF に要求される動作

Init SAF

AuthTrans SAF

NameTrans SAF

PathCheck SAF

ObjectType SAF

Service SAF

Error SAF

AddLog SAF

CGI から NSAPI への変換

第 5 章 NSAPI 関数のリファレンス

NSAPI 関数 (アルファベット順)

CALLOC

cinfo_find

condvar_init

condvar_notify

condvar_terminate

condvar_wait

crit_enter

crit_exit

crit_init

crit_terminate

daemon_atrestart

fc_close

fc_open

filebuf_buf2sd

filebuf_close

filebuf_getc

filebuf_open

filebuf_open_nostat

FREE

func_exec

func_find

log_error

MALLOC

net_ip2host

net_read

net_write

netbuf_buf2sd

netbuf_close

netbuf_getc

netbuf_grab

netbuf_open

param_create

param_free

pblock_copy

pblock_create

pblock_dup

pblock_find

pblock_findval

pblock_free

pblock_nninsert

pblock_nvinsert

pblock_pb2env

pblock_pblock2str

pblock_pinsert

pblock_remove

pblock_str2pblock

PERM_CALLOC

PERM_FREE

PERM_MALLOC

PERM_REALLOC

PERM_STRDUP

prepare_nsapi_thread

protocol_dump822

protocol_set_finfo

protocol_start_response

protocol_status

protocol_uri2url

protocol_uri2url_dynamic

REALLOC

request_get_vs

request_header

request_stat_path

request_translate_uri

session_dns

session_maxdns

shexp_casecmp

shexp_cmp

shexp_match

shexp_valid

STRDUP

system_errmsg

system_fclose

system_flock

system_fopenRO

system_fopenRW

system_fopenWA

system_fread

system_fwrite

system_fwrite_atomic

system_gmtime

system_localtime

system_lseek

system_rename

system_ulock

system_unix2local

systhread_attach

systhread_current

systhread_getdata

systhread_newkey

systhread_setdata

systhread_sleep

systhread_start

systhread_timerset

util_can_exec

util_chdir2path

util_cookie_find

util_env_find

util_env_free

util_env_replace

util_env_str

util_getline

util_hostname

util_is_mozilla

util_is_url

util_itoa

util_later_than

util_sh_escape

util_snprintf

util_sprintf

util_strcasecmp

util_strftime

util_strncasecmp

util_uri_escape

util_uri_is_evil

util_uri_parse

util_uri_unescape

util_vsnprintf

util_vsprintf

vs_alloc_slot

vs_get_data

vs_get_default_httpd_object

vs_get_doc_root

vs_get_httpd_objset

vs_get_id

vs_get_mime_type

vs_lookup_config_var

vs_register_cb

vs_set_data

vs_translate_uri

第 6 章 カスタム SAF の例

ビルドに含まれている例

AuthTrans の例

例のインストール

ソースコード

NameTrans の例

例のインストール

ソースコード

PathCheck の例

例のインストール

ソースコード

ObjectType の例

例のインストール

ソースコード

Service の例

例のインストール

ソースコード

より複雑な Service の例

AddLog の例

例のインストール

ソースコード

サービス品質の例

例のインストール

ソースコード

第 7 章 magnus.conf の構文と使用法

Init SAF

cindex-init

define-perf-bucket

dns-cache-init

flex-init

flex-rotate-init

init-cgi

init-clf

init-uhome

load-modules

nt-console-init

perf-init

pool-init

register-http-method

stats-init

thread-pool-init

サーバ情報

ExtraPath

MtaHost

NetSiteRoot

ServerConfigurationFile

ServerID

ServerRoot

TempDir

TempDirSecurity

User

言語に関する問題

AdminLanguage

ClientLanguage

DefaultCharSet

DefaultLanguage

DNS 検索

AsyncDNS

DNS

スレッド、プロセス、および接続

ConnQueueSize

HeaderBufferSize

IOTimeout

KeepAliveThreads

KeepAliveTimeout

KernelThreads

ListenQ

MaxKeepAliveConnections

MaxProcs (UNIX のみ)

PostThreadsEarly

RcvBufSize

RqThrottle

RqThrottleMin

SndBufSize

StackSize

StrictHttpHeaders

TerminateTimeout

ThreadIncrement

UseNativePoll (UNIX のみ)

ネイティブスレッドプール

NativePoolStackSize

NativePoolMaxThreads

NativePoolMinThreads

NativePoolQueueSize

CGI

CGIExpirationTimeout

CGIStubIdleTimeout

CGIWaitPid (UNIX のみ)

MaxCGIStubs

MinCGIStubs

WincgiTimeout

エラーログ作成と統計収集

ErrorLog

ErrorLogDateFormat

LogFlushInterval

LogVerbose

LogVsId

PidLog

ACL

ACLCacheLifetime

ACLUserCacheSize

ACLGroupCacheSize

セキュリティ

Security

SSLCacheEntries

SSLClientAuthDataLimit

SSLClientAuthTimeout

SSLSessionTimeout

SSL3SessionTimeout

チャンクされたエンコーディング

UseOutputStreamSize

ChunkedRequestBufferSize

ChunkedRequestTimeout

その他

ChildRestartCallback

HTTPVersion

MaxRqHeaders

Umask (UNIX のみ)

第 8 章 仮想サーバの構成ファイル

server.dtd ファイル

server.xml ファイル

変数

サーバマネージャとクラスマネージャの使用

server.dtd および server.xml 内の要素

SERVER

VARS

LS (待機ソケット)

CONNECTIONGROUP

SSLPARAMS

MIME

ACLFILE

VSCLASS

VS (仮想サーバ)

QOSPARAMS

USERDB

要求処理のための仮想サーバの選択

ユーザデータベースの選択

iPlanet LDAP スキーマ

コンバージェンスツリー

ドメインコンポーネント (dc) ツリー

付録 A データ構造体のリファレンス

いくつかのデータ構造体の非公開化

session

pblock

pb_entry

pb_param

Session->client

request

stat

shmem_s

cinfo

付録 B MIME タイプ

はじめに

MIME タイプを判別する

タイプが応答へどのように影響するか

クライアントが MIME タイプを使って行なう作業

MIME タイプファイルの構文

MIME タイプファイルの例

付録 C ワイルドカードパターン

ワイルドカードパターン

ワイルドカードの例

付録 D 時刻の書式

付録 E HTTP (HyperText Transfer Protocol)

準拠

要求

要求メソッド、URI、およびプロトコルのバージョン

要求ヘッダー

要求データ

応答

HTTP プロトコルのバージョン、状態コード、および原因を示す文字列

応答ヘッダー

応答データ

バッファ化されたストリーム

付録 F 動的に結果をキャッシュする関数

dr_cache_destroy

dr_cache_init

dr_cache_refresh

dr_net_write

fc_net_write

付録 G NSAPI 関数とマクロのアルファベット順リスト

付録 H magnus.conf 内の指令のアルファベット順リスト

付録 I 事前定義済みの SAF のアルファベット順リスト

索引