.\"-
.\" Copyright 2008-2025 Tarsnap Backup Inc.
.\" All rights reserved
.\"
.Dd March 20, 2025
.Dt TARSNAP.CONF 5
.Os
.Sh "نام (NAME)"
.Nm tarsnap.conf
.Nd پرونده پیکربندی برای
.Xr tarsnap 1
.Sh "شرح (DESCRIPTION)"
پرونده
.Nm
توسط ابزار
.Xr tarsnap 1
خوانده می‌شود و گزینه‌های پیش‌فرضی را تعیین می‌کند که در صورت مشخص شدن همان گزینه‌ها در خط فرمان، نادیده گرفته خواهند شد.
گزینه‌ها را می‌توان در
.Pa /etc/tarsnap/tarsnap.conf
و/یا
.Pa ~/.tarsnaprc
مشخص کرد؛ اگر میان دو پرونده تداخلی وجود داشته باشد، پیکربندی محلی کاربر اولویت خواهد داشت.
.Pp
پرونده(های)
.Nm
شامل خطوطی هستند متشکل از یک نام گزینه حساس به حروف کوچک و بزرگ، و صفر یا یک پارامتر بسته به نوع گزینه.
خطوط خالی و خطوطی که با نویسه
.Ql #
آغاز می‌شوند نادیده گرفته می‌شوند.
.Pp
اگر پارامتری با نویسه
.Ql ~
آغاز شود، با دایرکتوری خانگی شناسه کاربری مؤثر جایگزین خواهد شد.
.Pp
گزینه‌های زیر را می‌توان مشخص کرد:
.Bl -tag -width "no-aggressive-networking"
.It Cm aggressive-networking
.It Cm cachedir Ar cache-dir
.It Cm checkpoint-bytes Ar bytespercheckpoint
.It Cm disk-pause Ar X
.It Cm exclude Ar pattern
.It Cm force-resources
.It Cm humanize-numbers
.It Cm include Ar pattern
.It Cm insane-filesystems
.It Cm iso-dates
.It Cm keyfile Pa key-file
.It Cm lowmem
.It Cm maxbw
.It Cm maxbw-rate
.It Cm maxbw-rate-down
.It Cm maxbw-rate-up
.It Cm nodump
.It Cm normalmem
.It Cm no-aggressive-networking
.It Cm no-config-exclude
.It Cm no-config-include
.It Cm no-disk-pause
.It Cm no-force-resources
.It Cm no-humanize-numbers
.It Cm no-insane-filesystems
.It Cm no-iso-dates
.It Cm no-maxbw
.It Cm no-maxbw-rate-down
.It Cm no-maxbw-rate-up
.It Cm no-nodump
.It Cm no-print-stats
.It Cm no-quiet
.It Cm no-retry-forever
.It Cm no-snaptime
.It Cm no-store-atime
.It Cm no-totals
.It Cm print-stats
.It Cm quiet
.It Cm retry-forever
.It Cm snaptime Pa file
.It Cm store-atime
.It Cm totals
.It Cm verylowmem
.El
.Pp
هر گزینه به همان شیوه گزینه متناظر
.Fl -option
مدیریت می‌شود؛ برای جزئیات بیشتر به
.Xr tarsnap 1
مراجعه کنید.
توجه داشته باشید که گزینه‌های
.Cm normalmem
و
.Cm no-*
تنها در پرونده پیکربندی مختص به کاربر
.Pa ~/.tarsnaprc
کاربرد دارند، جایی که برای بازنویسی گزینه‌های تنظیم‌شده در پرونده پیکربندی سراسری
.Pa /etc/tarsnap/tarsnap.conf
عمل می‌کنند.
.Sh "پرونده‌ها (FILES)"
.Bl -tag -width indent
.It Pa /etc/tarsnap/tarsnap.conf
پرونده پیکربندی سراسری سیستم
.Nm .
پارامترهای مشخص‌شده در اینجا تنها در صورتی اثرگذار خواهند بود که از طریق پرونده پیکربندی محلی کاربر جاری یا خط فرمان مشخص نشده باشند.
.It Pa ~/.tarsnaprc
پرونده پیکربندی
.Nm
برای کاربر جاری.
پارامترهای مشخص‌شده در اینجا اثرگذار خواهند بود مگر اینکه از طریق خط فرمان تعیین شده باشند.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr tarsnap 1