'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH gerbera 1 2025-10-17 "" ""
.SH "نام (NAME)"
gerbera \- سرور چندرسانه‌ای UPnP
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\fBgerbera\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[
\fB-h|--help\fR
] [
\fB-D|--debug\fR
] [
\fB-v|--version\fR
] [
\fB--compile-info\fR
] [
\fB--create-config=Sections\fR
] [
\fB--create-example-config=Sections\fR
] [
\fB--create-advanced-config=Sections\fR
] [
\fB--check-config\fR
] [
\fB--print-options\fR
] [
\fB--offline\fR
] [
\fB--drop-tables\fR
] [
\fB--init-lastfm\fR
] [
\fB-d|-daemon\fR
] [
\fB-u|--user \fIusername\fB
\fR] [
\fB-P|--pidfile \fIpid file\fB
\fR] [
\fB-c|--config \fIconfig file\fB
\fR] [
\fB-f|--cfgdir \fIconfig dir\fB
\fR] [
\fB-l|--logfile \fIlogfile\fB
\fR] [
\fB--rotatelog \fIlogfile\fB
\fR] [
\fB--syslog \fILOG\fB
\fR] [
\fB--add-file \fIfile\fB
\fR] [
\fB--set-option \fIopt=val\fB
\fR] [
\fB-p|--port \fIport\fB
\fR] [
\fB-i|--ip \fIIP address\fB
\fR] [
\fB-e|--interface \fIinterface\fB
\fR] [
\fB-m|--home \fIhome dir\fB
\fR] [
\fB--magic \fImagic\fB
\fR] [
\fB--import-mode \fImt|grb\fB
\fR] [
\fB-l|--debug-mode \fIfacilities\fB
\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
این صفحه راهنما پارامترهای خط فرمان
Gerbera
را شرح می‌دهد. برای مستندات دقیق و مفصل لطفاً فایل README ارائه‌شده همراه با Gerbera را مطالعه کرده یا از نشانی https://gerbera.io بازدید فرمایید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\*(T<\fB\-i\fR\*(T>, \*(T<\fB\-\-ip\fR\*(T>
سرور به نشانی IP داده‌شده متصل (bind) می‌شود؛ در حال حاضر امکان اتصال به چند رابط شبکه وجود ندارد، بنابراین اتصال به 0.0.0.0 ممکن نخواهد بود.
.TP
\*(T<\fB\-e\fR\*(T>, \*(T<\fB\-\-interface\fR\*(T>
سرور به رابط شبکه مشخص‌شده متصل می‌شود؛ در حال حاضر در هر لحظه تنها اتصال به یک رابط شبکه امکان‌پذیر است.
.TP
\*(T<\fB\-p\fR\*(T>, \*(T<\fB\-\-port\fR\*(T>
شماره درگاه (port) سرور را که برای رابط کاربری وب، ارائه فایل‌های چندرسانه‌ای و درخواست‌های UPnP استفاده خواهد شد مشخص می‌کند؛ حداقل مقدار مجاز 49152 است. در صورت حذف این گزینه یک درگاه پیش‌فرض انتخاب خواهد شد، اما در این حالت ممکن است پس از راه‌اندازی مجدد سرور، درگاه تغییر کند.
.TP
\*(T<\fB\-u\fR\*(T>, \*(T<\fB\-\-user\fR\*(T>
کاهش دسترسی‌ها (drop privileges) به کاربر مشخص‌شده در زمان راه‌اندازی. اطمینان حاصل کنید که کلیه فایل‌های رسانه‌ای توسط این کاربر قابل خواندن باشند. همچنین مطمئن شوید که دایرکتوری خانگی برای این کاربر قابل نوشتن است.
.TP
\*(T<\fB\-c\fR\*(T>, \*(T<\fB\-\-config\fR\*(T>
به‌طور پیش‌فرض Gerbera به دنبال فایلی با نام config.xml در دایرکتوری ~/.config/gerbera می‌گردد. این گزینه به شما امکان می‌دهد نام و مکان فایل پیکربندی را به انتخاب خود مشخص کنید. مسیر فایل باید مطلق (absolute) باشد.
.TP
\*(T<\fB\-m\fR\*(T>, \*(T<\fB\-\-home\fR\*(T>
یک دایرکتوری خانگی جایگزین مشخص می‌کند. به‌طور پیش‌فرض Gerbera تلاش می‌کند دایرکتوری خانگی کاربر را از متغیر محیطی (HOME) دریافت کند، سپس به دنبال دایرکتوری .config/gerbera در پوشه خانگی کاربر می‌گردد. در صورت یافتن .config/gerbera تلاش می‌شود فایل پیکربندی پیش‌فرض (config.xml) پیدا شود.
.PP
این گزینه در دو حالت کاربرد دارد: زمانی که دایرکتوری خانگی از محیط قابل دریافت نیست (در این حالت می‌توانید از
.B \-c
نیز برای اشاره به فایل پیکربندی خود استفاده کنید) یا زمانی که قصد دارید یک پیکربندی جدید را در مکانی غیرمعمول آزمایش کنید (برای نمونه هنگام راه‌اندازی در حالت دیمن). در حالت دوم می‌توانید این پارامتر را با پارامتر توضیح داده‌شده در «دایرکتوری پیکربندی» ترکیب کنید.
.TP
\*(T<\fB\-f\fR\*(T>, \*(T<\fB\-\-cfgdir\fR\*(T>
دایرکتوری پیکربندی پیش‌فرض از ترکیب پوشه خانگی کاربر و مسیر پیش‌فرض .config/gerbera به دست می‌آید؛ این گزینه به شما امکان می‌دهد نام‌گذاری پیش‌فرض دایرکتوری را بازنویسی کنید. این ویژگی برای راه‌اندازی سرور در مکانی غیراستاندارد کاربرد دارد.
.TP
\*(T<\fB\-\-scripts\fR\*(T>
دایرکتوری مربوط به فایل‌های سفارشی جاوااسکریپت می‌تواند درون config.xml یا از طریق این گزینه در خط فرمان تعیین شود.
.TP
\*(T<\fB\-f\fR\*(T>, \*(T<\fB\-\-magic\fR\*(T>
فایل magic را تعیین یا رونویسی می‌کند. به‌طور پیش‌فرض این مقدار از متغیرهای محیطی GERBERA_MAGIC_FILE یا MEDIATOMB_MAGIC_FILE خوانده می‌شود.
.TP
\*(T<\fB\-\-add\-file\fR\*(T>
فایل مشخص‌شده را بدون نیاز به تعامل با رابط کاربری به پایگاه‌داده می‌افزاید. مسیر باید مطلق باشد؛ اگر مسیر مربوط به یک دایرکتوری باشد، به صورت بازگشتی (recursive) اضافه خواهد شد. اگر مسیر مربوط به یک فایل باشد، تنها همان فایل مشخص‌شده وارد پایگاه‌داده می‌شود.
.TP
\*(T<\fB\-\-print\-options\fR\*(T>
چاپ تمامی شماره‌های گزینه‌های قابل استفاده با
.BR \-\-set\-option .
.TP
\*(T<\fB\-\-set\-option\fR\*(T>
شماره گزینه مشخص‌شده را روی مقدار مناسب آن مانند config.xml تنظیم می‌کند. این کار مقادیر config.xml را بازنویسی می‌کند. برای مشاهده گزینه‌های معتبر به
.B \-\-print\-options
مراجعه کنید. گزینه‌های متعدد را می‌توان با ویرگول از هم جدا کرد یا از طریق استفاده مجدد از
.B \-\-set\-option
مشخص نمود.
.TP
\*(T<\fB\-l\fR\*(T>, \*(T<\fB\-\-logfile\fR\*(T>
پیام‌های لاگ به stdout ارسال نمی‌شوند، بلکه همه موارد به فایل مشخص‌شده هدایت می‌شوند.
.TP
\*(T<\fB\-l\fR\*(T>, \*(T<\fB\-\-rotatelog\fR\*(T>
پیام‌های لاگ به stdout ارسال نمی‌شوند، بلکه همه موارد به فایل چرخشی مشخص‌شده هدایت می‌شوند. این فرایند ۱۰ فایل با اندازه ۵ مگابایت را چرخش (rotate) می‌دهد.
.TP
\*(T<\fB\-l\fR\*(T>, \*(T<\fB\-\-syslog\fR\*(T>
پیام‌های لاگ به stdout ارسال نمی‌شوند، بلکه همه موارد به syslog هدایت می‌شوند. آرگومان اختیاری مشخص‌کننده facility سرویس syslog است. در صورت ارائه نشدن آرگومان، مقدار LOG_USER استفاده می‌شود.
.TP
\*(T<\fB\-D\fR\*(T>, \*(T<\fB\-\-debug\fR\*(T>
فعال‌سازی خروجی لاگ اشکال‌زدایی (debug).
.TP
\*(T<\fB\-d\fR\*(T>, \*(T<\fB\-\-daemon\fR\*(T>
تبدیل فرآیند به دیمن (daemonize) پس از راه‌اندازی.
.TP
\*(T<\fB\-\-compile\-info\fR\*(T>
چاپ اطلاعات پیکربندی کامپایل (پیش‌فرض‌های کتابخانه‌های مورد استفاده و قابلیت‌های فعال‌شده) و خروج.
.TP
\*(T<\fB\-\-create\-config=Section\fR\*(T>
.TP
\*(T<\fB\-\-create\-example\-config=Section\fR\*(T>
.TP
\*(T<\fB\-\-create\-advanced\-config=Section\fR\*(T>
چاپ پیکربندی پیش‌فرض/نمونه/پیشرفته در stdout و خروج. می‌توانید خروجی را در فایل config.xml کپی کرده و متناسب با نیاز خود تنظیم کنید. برای دریافت تنها یک بخش مشخص، می‌توانید نام بخش‌ها را با علامت | جدا نمایید.
.TP
\*(T<\fB\-\-modules=Module\fR\*(T>
فعال‌سازی تولید ویژگی‌های from-file در Module. می‌توانید نام ماژول‌ها را با | جدا کنید تا چند بخش به عنوان ماژول بارگذاری شوند.
.TP
\*(T<\fB\-\-check\-config\fR\*(T>
بررسی پیکربندی جاری پیش از اجرای سرویس و خروج. این گزینه همراه با
.B \-\-debug
بسیار مفید است.
.TP
\*(T<\fB\-\-offline\fR\*(T>
عدم پاسخ به درخواست‌های UPnP مانند browse. این گزینه هنگام اجرای پویش‌های گسترده جهت مقداردهی اولیه پایگاه‌داده سودمند است تا هیچ کلاینتی نتواند با دسترسی به پایگاه‌داده سرعت واردسازی را کاهش دهد.
.TP
\*(T<\fB\-\-drop\-tables\fR\*(T>
حذف (drop) تمامی جدول‌های پایگاه‌داده و خروج.
.TP
\*(T<\fB\-\-init\-lastfm\fR\*(T>
دریافت کلید نشست Last.FM بر پایه apiKey و apiSecret در پیکربندی. نیازمند آن است که Gerbera همراه با پشتیبانی از Last.FM API 2.0 کامپایل شده باشد.
.TP
\*(T<\fB\-\-version\fR\*(T>
چاپ اطلاعات نگارش برنامه و خروج.
.TP
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
چاپ خلاصه‌ای از گزینه‌های موجود خط فرمان.