نام (NAME)

persist-tool - فایل پیکربندی {{ site.product.short_name }}

خلاصه دستور (SYNOPSIS)

persist-tool [command] [options]

توضیحات (DESCRIPTION)

این صفحهٔ راهنما صرفاً یک چکیده است.

برنامهٔ persist-tool ابزاری است که می‌تواند برای استخراج محتوای فایل persist و دستکاری محتوای آن استفاده شود.

[](/assets/images/caution.png) احتیاط: ابزار Persist-tool ابزاری تخصصی برای کارشناسان syslog-ng است. از این ابزار استفاده نکنید مگر آن‌که دقیقاً بدانید چه کاری انجام می‌دهید. پیکربندی نادرست آن بدون هیچ هشداری منجر به آسیب جبران‌ناپذیر به فایل persist خواهد شد.

محدودیت‌ها: * توابع persist-state تنها با فایل‌های persist از نوع SLP4 یا جدیدتر قابل استفاده هستند. فایل‌های persist قدیمی‌تر پشتیبانی نمی‌شوند. * نویسه‌های عامه‌گر (wildcard) در نام‌های فایل و دایرکتوری پشتیبانی نمی‌شوند.

دستور DUMP (THE DUMP COMMAND)

dump [options] [persist_file]

از دستور dump برای چاپ محتوای فعلی فایل persist با قالب JSON در کنسول استفاده کنید.

دستور dump دارای گزینه‌های زیر است: --help یا -?
نمایش یک پیام راهنمای کوتاه. برای نمونه:

```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 " }
```

دستور ADD (THE ADD COMMAND)

add [options] [input_file]

از دستور add برای افزودن یا اصلاح یک مدخل وضعیت (state-entry) مشخص در فایل persist استفاده کنید. مدخل وضعیت باید در همان قالبی باشد که دستور dump آن را نمایش می‌دهد. اگر مدخل وضعیت ارائه‌شده از قبل وجود داشته باشد، به‌روزرسانی خواهد شد. در غیر این صورت، مقدار جدیدی اضافه می‌شود. اگر وضعیت persist مشخص‌شده نامعتبر باشد، نادیده گرفته خواهد شد.

برای استفاده از دستور add: از persist-tool dump برای چاپ محتوای فایل persist فعلی استفاده کرده و آن را به یک فایل هدایت کنید. محتوای این فایل را ویرایش کنید. سپس از persist-tool add به همراه این فایل برای اعمال تغییرات بر روی persist استفاده نمایید.

دستور add دارای گزینه‌های زیر است: --help یا -?
نمایش یک پیام راهنمای کوتاه.

--output-dir=<directory> یا -o
پارامتر الزامی. دایرکتوری‌ای که فایل persist در آن قرار دارد. نام فایل persist ذخیره‌شده در این دایرکتوری باید syslog-ng.persist باشد.

--persist-name=<filename> یا -p
پارامتر اختیاری. نام فایل persist جهت تولید. مقدار پیش‌فرض: syslog-ng.persist. برای نمونه:

``` 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
```

فایل‌ها (FILES)

/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/persist-tool

همچنین ببینید (SEE ALSO)

syslog-ng.conf(5)

نکته: اگر با مشکلی مواجه شدید یا برای syslog-ng OSE به راهنمایی نیاز دارید، به syslog-ng OSE Administration Guide[1] مراجعه کنید، یا از syslog-ng OSE mailing list[2] بازدید نمایید. برای دریافت اخبار و اطلاعیه‌ها دربارهٔ syslog-ng OSE، به syslog-ng OSE blogs[3] مراجعه کنید.

نویسندگان (AUTHORS)

این صفحهٔ راهنما از syslog-ng OSE Administration Guide[1] تولید شده است، که توسط چندین مشارکت‌کننده نوشته شده و صمیمانه از آن‌ها قدردانی می‌کنیم.

کپی‌رایت و تکثیر (COPYRIGHT)

نکات (NOTES)

[1] syslog-ng OSE Administration Guide
⟨https://syslog-ng.github.io/admin-guide/README⟩

[2] syslog-ng OSE mailing list
⟨https://lists.balabit.hu/mailman/listinfo/syslog-ng⟩

[3] syslog-ng OSE blogs
⟨https://syslog-ng.com/blog⟩