.TH "idevicesyslog" 1
.SH "نام (NAME)"
idevicesyslog \- رله کردن لاگ سیستم (syslog) یک دستگاه متصل‌شده.
.SH "خلاصه دستور (SYNOPSIS)"
.B idevicesyslog
[OPTIONS]

.SH "توضیحات (DESCRIPTION)"

رله کردن لاگ سیستم (syslog) یک دستگاه متصل‌شده.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-u, \-\-udid UDID
هدف‌گیری دستگاهی خاص با شناسه UDID
.TP
.B \-n, \-\-network
اتصال به دستگاه تحت شبکه
.TP
.B \-x, \-\-exit
خروج هنگام قطع اتصال دستگاه
.TP
.B \-d, \-\-debug
فعال‌سازی اشکال‌زدایی ارتباطات
.TP
.B \-h, \-\-help
چاپ اطلاعات نحوه استفاده
.TP
.B \-v, \-\-version
چاپ اطلاعات نسخه.
.TP
.B \-\-no\-colors
غیرفعال‌سازی خروجی رنگی
.TP
.B \-o, \-\-output FILE
نوشتن در FILE به جای خروجی استاندارد (stdout). این کار خروجی رنگی را غیرفعال می‌کند، اما می‌توان مجدداً آن را با \f[B]\-\-colors\f[] فعال کرد.
اگر FILE از قبل وجود داشته باشد، بدون هشدار بازنویسی خواهد شد.
.TP
.B \-\-colors
اجبار به نوشتن خروجی رنگی، برای مثال هنگام استفاده از \f[B]\-\-output\f[].
.TP
.B \-\-syslog\-relay
استفاده از سرویس قدیمی syslog_relay به جای os_trace_relay (مخصوص iOS 9+).

.SH "دستورها (COMMANDS)"
.TP
.B pidlist
چاپ فهرستی از شناسه فرآیند (PID) و نام تمام فرآیندهایی که در حال حاضر روی دستگاه در حال اجرا هستند.
.TP
.B archive PATH
درخواست یک logarchive از دستگاه. این داده‌ها با قالب tar در PATH نوشته می‌شوند. برای ارسال مستقیم از طریق لوله (pipe) به فرآیندی دیگر، از \- به عنوان PATH استفاده کنید.
در ادامه گزینه‌هایی برای محدود کردن داده‌های پیام لاگ آورده شده است.

به منظور مشاهده logarchive در یک نمایش‌دهنده لاگ سازگار، می‌توانید داده‌های خروجی را با لوله به \f[B]tar\f[] بفرستید تا در یک دایرکتوری جدید استخراج شود:

\f[B]mkdir test.logarchive && tools/idevicesyslog archive - |tar -C test.logarchive -xv\f[]

این کار همچنین نام فایل‌ها را حین استخراج چاپ خواهد کرد.
.TP
گزینه‌های بیشتر برای \f[B]archive\f[]:
.TP
.B \-\-start\-time VALUE
زمان شروع داده‌های لاگ بر اساس برچسب زمانی یونیکس (UNIX timestamp). پیام‌های قبل از این زمان نادیده گرفته می‌شوند.
.TP
.B \-\-age\-limit VALUE
حداکثر عمر داده‌های لاگ، احتمالاً بر حسب تعداد روز.
.TP
.B \-\-size\-limit VALUE
محدود کردن اندازه آرشیو. واحد آن در حال حاضر نامشخص است، بنابراین می‌توانید آن را بیازمایید.
.TP
به یاد داشته باشید که دستگاه معمولاً تنها سابقه چند دقیقه گذشته را نگه می‌دارد، بنابراین ممکن است این گزینه‌ها نتیجه مورد نظر را به همراه نداشته باشند. این یک باگ نیست.

.SH "گزینه‌های فیلتر (FILTER OPTIONS)"
.TP
.B \-m, \-\-match STRING
فقط چاپ پیام‌هایی که شامل STRING هستند
.TP
.B \-M, \-\-unmatch STRING
چاپ پیام‌هایی که شامل STRING نیستند
.TP
.B \-t, \-\-trigger STRING
شروع ثبت لاگ با تطابق رشته STRING

هنگامی که مشخص شود، ثبت لاگ به محض مواجهه با پیامی که شامل رشته داده‌شده باشد آغاز خواهد شد. همچنین ببینید
\f[B]\-T, \-\-untrigger\f[]. سایر فیلترها همچنان اعمال می‌شوند، اما بدیهی است که پیام‌های فیلترشده تنها پس از آغاز ثبت لاگ چاپ خواهند شد.
.TP
.B \-T, \-\-untrigger STRING
توقف ثبت لاگ با تطابق رشته STRING

هنگامی که مشخص شود، ثبت لاگ به محض مواجهه با پیامی که شامل رشته داده‌شده باشد متوقف خواهد شد. همچنین ببینید
\f[B]\-t, \-\-trigger\f[]. سایر فیلترها همچنان اعمال می‌شوند، اما بدیهی است که پیام‌های فیلترشده تنها پیش از توقف ثبت لاگ چاپ خواهند شد.

نکته: اگر هیچ \f[B]\-\-trigger\f[] مشخص نشده باشد، idevicesyslog پس از مواجهه با پیام لاگ منطبق خارج خواهد شد.
.TP
.B \-p, \-\-process PROCESS
فقط چاپ پیام‌های فرآیند(های) منطبق

مقدار PROCESS رشته‌ای است که می‌تواند یک شناسه عددی فرآیند (PID) یا نام یک فرآیند باشد. همچنین از چندین نام فرآیند یا PID در یک رشته که با | از یکدیگر جدا شده‌اند پشتیبانی می‌کند (حتماً از علامت نقل‌قول استفاده کنید!).
.TP
.B \-e, \-\-exclude PROCESS
چاپ تمام پیام‌ها به جز فرآیند(های) منطبق

مقدار PROCESS رشته‌ای است که می‌تواند یک شناسه عددی فرآیند (PID) یا نام یک فرآیند باشد. همچنین از چندین نام فرآیند یا PID در یک رشته که با | از یکدیگر جدا شده‌اند پشتیبانی می‌کند (حتماً از علامت نقل‌قول استفاده کنید!).
.TP
.B \-q, \-\-quiet
تنظیم یک فیلتر برای مستثنی کردن فرآیندهای پر سر و صدای معمول

از آنجا که syslog می‌تواند بسیار شلوغ و پر سر و صدا باشد، این سوئیچ سریع خط فرمان اجازه می‌دهد مجموعه‌ای از پیش تعریف‌شده از فرآیندهای شناخته‌شده بی‌صدا شوند. فهرست فرآیندهایی که بی‌صدا می‌شوند را می‌توان با \f[B]\-\-quiet\-list\f[] دریافت کرد.
.TP
.B \-\-quiet\-list
چاپ فهرست فرآیندهای مربوط به \f[B]\-\-quiet\f[] و خروج
.TP
.B \-k, \-\-kernel
فقط چاپ پیام‌های هسته (kernel)

این گزینه در واقع معادل ارسال \f[B]\-\-process kernel\f[] است، با این استثنا که می‌توان آن را همراه با \f[B]\-\-quiet\f[] استفاده کرد تا فرآیندهای شلوغ بی‌صدا شوند اما همچنان تمامی پیام‌های لاگ هسته دریافت گردند.
.TP
.B \-K, \-\-no\-kernel
نادیده گرفتن پیام‌های هسته

این گزینه معادل ارسال \f[B]\-\-exclude kernel\f[] است.

.SH "مثال‌ها (EXAMPLES)"
.TP
.B idevicesyslog \-u 00008030\-0000111ABC000DEF
رله کردن syslog دستگاهی با UDID معادل 00008030-0000111ABC000DEF.
.TP
.B idevicesyslog \-x
رله کردن syslog دستگاه و خروج به محض قطع اتصال دستگاه.
.TP
.B idevicesyslog \-m '####' \-e 'identityservicesd' \-K
فقط چاپ پیام‌های لاگی که شامل رشته #### بوده و منشأ آن‌ها identityservicesd یا هسته نباشد.
.TP
.B idevicesyslog \-p MyApp \-p ReportCrash
فقط چاپ پیام‌های لاگ مربوط به فرآیندهای 'MyApp' و 'ReportCrash'.
.TP
.B idevicesyslog \-p 'MyApp|ReportCrash'
مشابه مثال قبل با ساختار نحوی متفاوت.
.TP
.B idevicesyslog \-e 'backboardd|CommCenter|mDNSResponder'
صرف‌نظر کردن از پیام‌های لاگ فرآیندهای backboardd و CommCenter و mDNSResponder.
.TP
.B idevicesyslog \-q \-k
صرف‌نظر کردن از پیام‌های لاگ فرآیندهای پر سر و صدای معمول، اما چاپ قطعی پیام‌های لاگ هسته.
.TP
.B idevicesyslog \-K
صرف‌نظر کردن از پیام‌های لاگ هسته، اما چاپ تمامی پیام‌های دیگر.
.TP
.B idevicesyslog \-t 'backlight on' \-T 'backlight off' \-q
شروع ثبت لاگ هنگام روشن شدن نور پس‌زمینه دستگاه و توقف آن هنگام خاموش شدن نور پس‌زمینه، به همراه بی‌صدا کردن فرآیندهای پر سر و صدا.

.SH "نویسندگان (AUTHORS)"
Nikias Bassen, Martin Szulecki

صفحه راهنما جهت انطباق با دبیان توسط Julien Lavergne نوشته شده است.

.SH "در وب (ON THE WEB)"
https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice