.TH persist\-tool 1 "18 December 2025" 4.10.2 "The persist\-tool manual page"
.SH "نام (NAME)"
.PP
persist\-tool \- فایل پیکربندی {{ site.product.short_name }}
.SH "خلاصه دستور (SYNOPSIS)"
.PP
persist\-tool [command] [options]
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحهٔ راهنما صرفاً یک چکیده است.
.PP
برنامهٔ persist\-tool ابزاری است که می‌تواند برای استخراج محتوای فایل persist و دستکاری محتوای آن استفاده شود.
.PP
[](/assets/images/caution.png)
\fBاحتیاط:\fP ابزار Persist\-tool ابزاری تخصصی برای کارشناسان syslog\-ng است. از این ابزار استفاده نکنید مگر آن‌که دقیقاً بدانید چه کاری انجام می‌دهید. پیکربندی نادرست آن بدون هیچ هشداری منجر به آسیب جبران‌ناپذیر به فایل persist خواهد شد.
.PP
محدودیت‌ها:
* توابع persist\-state تنها با فایل‌های persist از نوع \fB\fCSLP4\fR یا جدیدتر قابل استفاده هستند. فایل‌های persist قدیمی‌تر پشتیبانی نمی‌شوند.
* نویسه‌های عامه‌گر (wildcard) در نام‌های فایل و دایرکتوری پشتیبانی نمی‌شوند.
.SH "دستور DUMP (THE DUMP COMMAND)"
.PP
.RS
.nf
dump [options] [persist_file]
.fi
.RE
.PP
از دستور \fB\fCdump\fR برای چاپ محتوای فعلی فایل persist با قالب JSON در کنسول استفاده کنید.
.PP
دستور \fB\fCdump\fR دارای گزینه‌های زیر است:
\fB\fC\-\-help\fR یا \fB\fC\-?\fR
    نمایش یک پیام راهنمای کوتاه. برای نمونه:
.PP
.RS
.nf
```config
    persist\-tool dump /Users/hofi/Develop/Balabit/syslog-ng/build/install/var/syslog\-ng persist
``` 
یک خروجی معتبر به صورت زیر است:

```config
run_id = { "value": "00 00 00 00 0C 00 00 00 " }
host_id = { "value": "00 00 00 00 5F 49 2F 01 " }
```
.fi
.RE
.SH "دستور ADD (THE ADD COMMAND)"
.PP
.RS
.nf
add [options] [input_file]
.fi
.RE
.PP
از دستور \fB\fCadd\fR برای افزودن یا اصلاح یک مدخل وضعیت (state\-entry) مشخص در فایل persist استفاده کنید. مدخل وضعیت باید در همان قالبی باشد که دستور \fB\fCdump\fR آن را نمایش می‌دهد. اگر مدخل وضعیت ارائه‌شده از قبل وجود داشته باشد، به‌روزرسانی خواهد شد. در غیر این صورت، مقدار جدیدی اضافه می‌شود. اگر وضعیت persist مشخص‌شده نامعتبر باشد، نادیده گرفته خواهد شد.
.PP
برای استفاده از دستور \fB\fCadd\fR: از \fB\fCpersist\-tool dump\fR برای چاپ محتوای فایل persist فعلی استفاده کرده و آن را به یک فایل هدایت کنید. محتوای این فایل را ویرایش کنید. سپس از \fB\fCpersist\-tool\fR add به همراه این فایل برای اعمال تغییرات بر روی persist استفاده نمایید.
.PP
دستور \fB\fCadd\fR دارای گزینه‌های زیر است:
\fB\fC\-\-help\fR یا \fB\fC\-?\fR
    نمایش یک پیام راهنمای کوتاه.
.PP
\fB\fC\-\-output\-dir=<directory>\fR یا \fB\fC\-o\fR
    پارامتر الزامی. دایرکتوری‌ای که فایل persist در آن قرار دارد. نام فایل persist ذخیره‌شده در این دایرکتوری باید syslog\-ng.persist باشد.
.PP
\fB\fC\-\-persist\-name=<filename>\fR یا \fB\fC\-p\fR
    پارامتر اختیاری. نام فایل persist جهت تولید. مقدار پیش‌فرض: syslog\-ng.persist. برای نمونه:
.PP
.RS
.nf
``` shell
/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/persist\-tool add dump_persist \-o .
```

یک خروجی معتبر به صورت زیر است:

```config
log_reader_curpos(Application)      OK
affile_sd_curpos(/var/aaa.txt)        OK
```

یک خروجی نامعتبر به صورت زیر است:

```config
log_reader_curpos(Application)      OK
wrong
FAILED (error: Invalid entry syntax)
affile_sd_curpos(/var/aaa.txt)        OK
```
.fi
.RE
.SH "فایل‌ها (FILES)"
.PP
/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/persist\-tool
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fB\fCsyslog\-ng.conf\fR(5)
.PP
\fBنکته:\fP
اگر با مشکلی مواجه شدید یا برای syslog\-ng OSE به راهنمایی نیاز دارید، به \fIsyslog\-ng OSE Administration Guide\fP[1] مراجعه کنید، یا از \fIsyslog\-ng OSE mailing list\fP[2] بازدید نمایید.
برای دریافت اخبار و اطلاعیه‌ها دربارهٔ syslog\-ng OSE، به \fIsyslog\-ng OSE blogs\fP[3] مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.PP
این صفحهٔ راهنما از \fIsyslog\-ng OSE Administration Guide\fP[1] تولید شده است، که توسط چندین مشارکت‌کننده نوشته شده و صمیمانه از آن‌ها قدردانی می‌کنیم.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.SH "نکات (NOTES)"
.PP
[1] \fB\fCsyslog\-ng OSE Administration Guide\fR
    \[la]https://syslog-ng.github.io/admin-guide/README\[ra]
.PP
[2] \fB\fCsyslog\-ng OSE mailing list\fR
    \[la]https://lists.balabit.hu/mailman/listinfo/syslog-ng\[ra]
.PP
[3] \fB\fCsyslog\-ng OSE blogs\fR
    \[la]https://syslog-ng.com/blog\[ra]