.\"
.\"
.\"     Licensed to the Apache Software Foundation (ASF) under one
.\"     or more contributor license agreements.  See the NOTICE file
.\"     distributed with this work for additional information
.\"     regarding copyright ownership.  The ASF licenses this file
.\"     to you under the Apache License, Version 2.0 (the
.\"     "License"); you may not use this file except in compliance
.\"     with the License.  You may obtain a copy of the License at
.\"
.\"       http://www.apache.org/licenses/LICENSE-2.0
.\"
.\"     Unless required by applicable law or agreed to in writing,
.\"     software distributed under the License is distributed on an
.\"     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
.\"     KIND, either express or implied.  See the License for the
.\"     specific language governing permissions and limitations
.\"     under the License.
.\"
.\"
.\" You can view this file with:
.\" nroff -man [filename]
.\"
.TH svnserve.conf 5
.SH "نام (NAME)"
svnserve.conf \- فایل پیکربندی مخزن برای svnserve
.SH "خلاصه دستور (SYNOPSIS)"
.TP
\fIrepository-path\fP\fB/conf/svnserve.conf\fP
.SH "توضیحات (DESCRIPTION)"
فایل
.B svnserve.conf
رفتار دیمن
.B svnserve
را برای هر مخزن کنترل می‌کند. این فایل در زیرشاخه
.B conf
مخزن قرار دارد.
.PP
ساختار کلی این فایل مشابه ساختار فایل‌های پیکربندی کاربر ساب‌ورژن است. در بالاترین سطح، بخش‌ها قرار دارند که با کلماتی درون قلاب‌ها (براکت‌ها) مشخص می‌شوند؛ در داخل هر بخش، تعاریف متغیرها به صورت «variable = value» هستند. خطوطی که با «#» آغاز می‌شوند نادیده گرفته خواهند شد.
.B svnserve.conf
در حال حاضر تنها از یک بخش به نام «general» استفاده می‌کند و از متغیرهای زیر پشتیبانی می‌نماید:
.PP
.TP 5
\fBanon-access\fP = \fBnone\fP|\fBread\fP|\fBwrite\fP
سطح دسترسی را برای کاربران احراز هویت‌نشده تعیین می‌کند. دسترسی
.B write
اجازه انجام تمام عملیات مخزن را می‌دهد. دسترسی
.B read
اجازه انجام تمام عملیات به جز ثبت تغییرات (commit) و تغییر ویژگی‌های بازنگری (revision properties) را فراهم می‌کند. دسترسی
.B none
هیچ دسترسی‌ای نمی‌دهد. سطح پیش‌فرض،
.B read
است.
.PP
.TP 5
\fBauth-access\fP = \fBnone\fP|\fBread\fP|\fBwrite\fP
سطح دسترسی را برای کاربران احراز هویت‌شده با استفاده از همان سطوح دسترسی بالا تعیین می‌کند. سطح پیش‌فرض،
.B write
است.
.PP
.TP 5
\fBpassword-db\fP = \fIfilename\fP
محل پایگاه‌داده رمزهای عبور را مشخص می‌کند.
.I filename
می‌تواند نسبت به دایرکتوری conf مخزن باشد. هیچ مقدار پیش‌فرضی وجود ندارد. پایگاه‌داده رمزهای عبور همان ساختار کلی این فایل را دارد. این فایل تنها از یک بخش «users» استفاده می‌کند؛ هر متغیر در این بخش یک نام کاربری و هر مقدار، یک رمز عبور است.
.PP
.TP 5
\fBauthz-db\fP = \fIpath\fP
گزینه authz-db محل قوانین مجوزدهی برای کنترل دسترسی مبتنی بر مسیر را تعیین می‌کند.
.I path
می‌تواند نسبت به دایرکتوری conf مخزن باشد. همچنین
.I path
می‌تواند یک نشانی وب نسبی به مخزن (^/) یا یک URL مطلق file:// به یک فایل متنی در مخزن ساب‌ورژن باشد. هیچ مقدار پیش‌فرضی وجود ندارد. اگر یک authz-db را تعیین نکنید، هیچ کنترل دسترسی مبتنی بر مسیری انجام نمی‌شود.
.PP
.TP 5
\fBrealm\fP = \fIrealm\-name\fP
قلمرو (realm) احراز هویت مخزن را تنظیم می‌کند. اگر دو مخزن پایگاه‌داده رمزهای عبور یکسانی داشته باشند، باید قلمرو یکسانی نیز داشته باشند و بالعکس؛ این ارتباط به کلاینت‌ها امکان می‌دهد برای چندین مخزن از یک رمز عبور ذخیره‌شده (کش‌شده) استفاده کنند. مقدار پیش‌فرض realm همان شناسه یکتای جهانی (uuid) مخزن است.
.SH "مثال (EXAMPLE)"
مثال زیر از
.B svnserve.conf
دسترسی خواندن را برای کاربران احراز هویت‌شده مجاز دانسته و هیچ دسترسی‌ای به کاربران ناشناس نمی‌دهد، به یک پایگاه‌داده passwd در همان دایرکتوری اشاره می‌کند و یک نام قلمرو (realm) تعریف می‌نماید.
.PP
.nf
 [general]
 anon-access = none
 auth-access = read
 password-db = passwd
 realm = My First Repository
.fi
.PP
فایل «passwd» به شکل زیر خواهد بود:
.PP
.nf
 [users]
 joeuser = joepassword
 jayrandom = randomjay
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR svnserve (8)