.\"
.\"
.\"     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 8
.SH "نام (NAME)"
svnserve \- سرور برای روش دسترسی به مخزن 'svn'
.SH "خلاصه دستور (SYNOPSIS)"
.TP
\fBsvnserve\fP [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
\fBsvnserve\fP امکان دسترسی به مخزن‌های ساب‌ورژن (Subversion) را با استفاده از پروتکل شبکه svn فراهم می‌کند. این برنامه می‌تواند هم به صورت یک فرآیند سرور مستقل (standalone) اجرا شود، و هم از طریق inetd اجرا گردد. هنگام راه‌اندازی \fBsvnserve\fP باید یک حالت عملیاتی را انتخاب کنید. گزینه‌های زیر توسط این برنامه شناخته می‌شوند:
.PP
.TP 5
\fB\-d\fP, \fB\-\-daemon\fP
باعث می‌شود \fBsvnserve\fP در حالت دیمن (daemon) اجرا شود. در این حالت، \fBsvnserve\fP به پس‌زمینه می‌رود و اتصالات TCP/IP را روی درگاه svn (به‌طور پیش‌فرض ۳۶۹۰) پذیرفته و سرویس‌دهی می‌کند.
.PP
.TP 5
\fB\-\-listen\-port\fP=\fIport\fP
باعث می‌شود \fBsvnserve\fP هنگام اجرا در حالت دیمن، به درگاه \fIport\fP گوش فرا دهد.
.PP
.TP 5
\fB\-\-listen\-host\fP=\fIhost\fP
باعث می‌شود \fBsvnserve\fP روی رابط شبکه مشخص‌شده توسط \fIhost\fP گوش فرا دهد، که می‌تواند یک نام میزبان یا یک نشانی IP باشد.
.PP
.TP 5
\fB\-\-foreground\fP
هنگامی که همراه با \fB\-d\fP استفاده شود، باعث می‌شود \fBsvnserve\fP در پیش‌زمینه باقی بماند. این گزینه عمدتاً برای اشکال‌زدایی مفید است.
.PP
.TP 5
\fB\-i\fP, \fB\-\-inetd\fP
باعث می‌شود \fBsvnserve\fP از توصیف‌کننده‌های فایل stdin/stdout استفاده کند، همان‌طور که برای یک دیمن در حال اجرا از طریق inetd مناسب است.
.PP
.TP 5
\fB\-h\fP, \fB\-\-help\fP
خلاصه‌ای از نحوه استفاده را نمایش داده و خارج می‌شود.
.PP
.TP 5
\fB\-\-version\fP
نسخه \fBsvnserve\fP و پس‌انه‌های سیستم‌فایل مخزن را که این برنامه پشتیبانی می‌کند، چاپ می‌کند.
.PP
.TP 5
\fB\-r\fP \fIroot\fP, \fB\-\-root\fP=\fIroot\fP
ریشه مجازی را برای مخزن‌های سرویس‌دهی‌شده توسط \fBsvnserve\fP تنظیم می‌کند. مسیرهای موجود در نشانی‌های اینترنتی (URL) ارائه‌شده توسط کلاینت، نسبت به این ریشه تفسیر خواهند شد و اجازه خروج از این ریشه را نخواهند داشت.
.PP
.TP 5
\fB\-R\fP \fB\-\-read\-only\fP
تمام عملیات نوشتن از طریق این نمونه از \fBsvnserve\fP را ممنوع می‌کند و تمام تنظیمات خط‌مشی دسترسی دیگر را نادیده می‌گیرد. از این گزینه برای تنظیم خط‌مشی دسترسی کلی مخزن استفاده نکنید؛ فایل پیکربندی مخزن \fBconf/svnserve.conf\fP برای همین منظور است. این گزینه فقط باید برای محدود کردن دسترسی از طریق یک روش خاص فراخوانی \fBsvnserve\fP استفاده شود؛ برای مثال، برای مجاز کردن دسترسی نوشتن از طریق SSH اما نه از طریق یک دیمن \fBsvnserve\fP، یا برای ایجاد یک کلید SSH محدود شده که فقط قابلیت دسترسی فقط‌خواندنی داشته باشد.
.PP
.TP 5
\fB\-t\fP, \fB\-\-tunnel\fP
باعث می‌شود \fBsvnserve\fP در حالت تونل (tunnel mode) اجرا شود، که بسیار شبیه به حالت عملکرد inetd است (سرویس‌دهی به یک اتصال از طریق stdin/stdout)، با این تفاوت که اتصال از پیش با نام کاربری مربوط به uid فعلی احراز هویت شده در نظر گرفته می‌شود. این فلگ توسط کلاینت هنگام اجرا از طریق یک عامل تونل انتخاب می‌شود.
.PP
.TP 5
\fB\-\-tunnel\-user\fP=\fIusername\fP
هنگامی که با \fB\-\-tunnel\fP ترکیب شود، نام کاربری از پیش احراز هویت شده را با \fIusername\fP ارائه‌شده جایگزین می‌کند. این گزینه در ترکیب با دستورالعمل "command" در فایل authorized_key مربوط به ssh مفید است تا به یک حساب کاربری سیستمی واحد اجازه دهد توسط چندین مشارکت‌کننده (committer) استفاده شود، در حالی که هر یک هویت ssh متمایزی دارند.
.PP
.TP 5
\fB\-T\fP, \fB\-\-threads\fP
هنگام اجرا در حالت دیمن، باعث می‌شود \fBsvnserve\fP به جای یک فرآیند، برای هر اتصال یک رشته (thread) ایجاد کند. فرآیند \fBsvnserve\fP همچنان در زمان راه‌اندازی به پس‌زمینه می‌رود.
.PP
.TP 5
\fB\-\-config\-file\fP=\fIfilename\fP
در صورت مشخص شدن، \fBsvnserve\fP یک بار در زمان راه‌اندازی برنامه \fIfilename\fP را می‌خواند و پیکربندی \fBsvnserve\fP را در حافظه موقت (کش) قرار می‌دهد. پیکربندی‌های گذرواژه و مجوزهایی که از \fIfilename\fP به آن‌ها ارجاع داده شده است، در هر اتصال بارگذاری خواهند شد. هنگامی که از این گزینه استفاده شود، \fBsvnserve\fP هیچ‌یک از فایل‌های \fBconf/svnserve.conf\fP مربوط به هر مخزن را نخواهد خواند. برای جزئیات مربوط به قالب فایل برای این گزینه، به صفحه راهنمای \fBsvnserve.conf\fP(5) مراجعه کنید.
.PP
.TP 5
\fB\-\-pid\-file\fP=\fIfilename\fP
در صورت مشخص شدن، \fBsvnserve\fP شناسه فرآیند (PID) خود را در \fIfilename\fP می‌نویسد.
.PP
.TP 5
\fB\-X\fP, \fB\-\-listen\-once\fP
باعث می‌شود \fBsvnserve\fP یک اتصال را روی درگاه svn بپذیرد، به آن سرویس دهد و خارج شود. این گزینه عمدتاً برای اشکال‌زدایی مفید است.
.PP
مگر در حالتی که گزینه \fB\-\-config\-file\fP در خط فرمان مشخص شده باشد، به محض اینکه کلاینت با ارسال URL خود یک مخزن را انتخاب کرد، \fBsvnserve\fP فایلی با نام \fBconf/svnserve.conf\fP را در دایرکتوری مخزن می‌خواند تا تنظیمات مربوط به مخزن (مانند اینکه از چه پایگاه داده احراز هویتی استفاده شود و چه خط‌مشی‌های مجوزی اعمال گردند) را تعیین کند. برای جزئیات مربوط به ساختار آن فایل، به صفحه راهنمای \fBsvnserve.conf\fP(5) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR svnserve.conf (5)