1 <?xml version="1.0" encoding="UTF-8" ?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
4 <!-- English Revision: 662627:1330980 (outdated) -->
7 Licensed to the Apache Software Foundation (ASF) under one or more
8 contributor license agreements. See the NOTICE file distributed with
9 this work for additional information regarding copyright ownership.
10 The ASF licenses this file to You under the Apache License, Version 2.0
11 (the "License"); you may not use this file except in compliance with
12 the License. You may obtain a copy of the License at
14 http://www.apache.org/licenses/LICENSE-2.0
16 Unless required by applicable law or agreed to in writing, software
17 distributed under the License is distributed on an "AS IS" BASIS,
18 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19 See the License for the specific language governing permissions and
20 limitations under the License.
23 <modulesynopsis metafile="mod_dav_lock.xml.meta">
25 <name>mod_dav_lock</name>
26 <description><module>mod_dav</module> 用の汎用ロックモジュール</description>
27 <status>Extension</status>
28 <sourcefile>mod_dav_lock.c</sourcefile>
29 <identifier>dav_lock_module</identifier>
30 <compatibility>バージョン 2.1 以降</compatibility>
33 <p>このモジュールは <module>mod_dav</module> のどのバックエンド
34 からでも使える汎用ロック API を提供します。
35 使用には最低限 <module>mod_dav</module>
36 を必要としますが、これを利用するバックエンドが存在しないと役に立たないので、
37 そのような場合はサーバに読み込むべきではありません。
38 <module>mod_dav_lock</module>
39 を実際に利用するバックエンドモジュールの例としては subversion
40 プロバイダモジュールの <a href="http://subversion.tigris.org/"
41 >mod_dav_svn</a> があります。</p>
43 <p><module>mod_dav_fs</module> は特化された専用のバージョンを
44 使うため、この汎用モジュールは<em>必要ない</em>ことに注意して
47 <p><module>mod_dav_lock</module> を機能させるには、
49 module="mod_dav_lock">DavGenericLockDB</directive> を使って
50 ロックデータベースの場所を指定するだけです。</p>
52 <note><title>開発者向けのメモ</title>
53 <p>ロックを提供している関数へのポインタを取得するためには、
54 <code>ap_lookup_provider</code> API を、引数 <code>dav-lock</code>,
55 <code>generic</code>, <code>0</code> を指定して使う必要が
59 <seealso><module>mod_dav</module></seealso>
62 <name>DavGenericLockDB</name>
63 <description>DAV ロックデータベースの場所</description>
64 <syntax>DavGenericLockDB <var>file-path</var></syntax>
65 <contextlist><context>server config</context><context>virtual host</context>
66 <context>directory</context>
70 <p><directive>DavGenericLockDB</directive> ディレクティブを
71 使って、拡張子を除いたロックデータベースへのフルパスを
72 指定します。絶対パスでないときは <directive
73 module="core">ServerRoot</directive> からの相対パスとして
74 扱われます。<module>mod_dav_lock</module> の実装ではユーザの
75 ロックを追跡するのに SDBM データベースを使います。</p>
77 <example><title>例</title>
78 DavGenericLockDB var/DavLock
81 <p>ロックデータベースファイルのあるディレクトリは
82 Apache が実行されている <directive module="mpm_common">User</directive>
83 と <directive module="mpm_common" >Group</directive> によって
84 書き込み可能でなければなりません。セキュリティ上の理由から、
85 既存のディレクトリのパーミッションを変更するのではなく、
86 専用のディレクトリを作るのが良いでしょう。上の例では、
88 module="core">ServerRoot</directive> の下の <code>var/</code>
89 ディレクトリに、ファイル名の本体が <code>DavLock</code> で
90 サーバが追加する拡張子を持つファイルを作成します。</p>