| idevicesyslog(1) | General Commands Manual | idevicesyslog(1) |
نام (NAME)
idevicesyslog - رله کردن لاگ سیستم (syslog) یک دستگاه متصل‌شده.
خلاصه دستور (SYNOPSIS)
idevicesyslog [OPTIONS]
توضیحات (DESCRIPTION)
رله کردن لاگ سیستم (syslog) یک دستگاه متصل‌شده.
گزینه‌ها (OPTIONS)
- -u, --udid UDID
- هدف‌گیری دستگاهی خاص با شناسه UDID
- -n, --network
- اتصال به دستگاه تحت شبکه
- -x, --exit
- خروج هنگام قطع اتصال دستگاه
- -d, --debug
- فعال‌سازی اشکال‌زدایی ارتباطات
- -h, --help
- چاپ اطلاعات نحوه استفاده
- -v, --version
- چاپ اطلاعات نسخه.
- --no-colors
- غیرفعال‌سازی خروجی رنگی
- -o, --output FILE
- نوشتن در FILE به جای خروجی استاندارد (stdout). این کار خروجی رنگی را غیرفعال می‌کند، اما می‌توان مجدداً آن را با --colors فعال کرد. اگر FILE از قبل وجود داشته باشد، بدون هشدار بازنویسی خواهد شد.
- --colors
- اجبار به نوشتن خروجی رنگی، برای مثال هنگام استفاده از --output.
- --syslog-relay
- استفاده از سرویس قدیمی syslog_relay به جای os_trace_relay (مخصوص iOS 9+).
دستورها (COMMANDS)
- pidlist
- چاپ فهرستی از شناسه فرآیند (PID) و نام تمام فرآیندهایی که در حال حاضر روی دستگاه در حال اجرا هستند.
- archive PATH
- درخواست یک
logarchive از
دستگاه. این
داده‌ها با
قالب tar در PATH
نوشته
می‌شوند.
برای ارسال
مستقیم از
طریق لوله (pipe)
به فرآیندی
دیگر، از -
به عنوان PATH
استفاده
کنید. در
ادامه
گزینه‌هایی
برای محدود
کردن
داده‌های
پیام لاگ
آورده شده
است.
به منظور مشاهده logarchive در یک نمایش‌دهنده لاگ سازگار، می‌توانید داده‌های خروجی را با لوله به tar بفرستید تا در یک دایرکتوری جدید استخراج شود:
mkdir test.logarchive && tools/idevicesyslog archive - |tar -C test.logarchive -xv
این کار همچنین نام فایل‌ها را حین استخراج چاپ خواهد کرد.
- گزینه‌های بیشتر برای archive:
- --start-time VALUE
- زمان شروع داده‌های لاگ بر اساس برچسب زمانی یونیکس (UNIX timestamp). پیام‌های قبل از این زمان نادیده گرفته می‌شوند.
- --age-limit VALUE
- حداکثر عمر داده‌های لاگ، احتمالاً بر حسب تعداد روز.
- --size-limit VALUE
- محدود کردن اندازه آرشیو. واحد آن در حال حاضر نامشخص است، بنابراین می‌توانید آن را بیازمایید.
- به یاد داشته باشید که دستگاه معمولاً تنها سابقه چند دقیقه گذشته را نگه می‌دارد، بنابراین ممکن است این گزینه‌ها نتیجه مورد نظر را به همراه نداشته باشند. این یک باگ نیست.
گزینه‌های فیلتر (FILTER OPTIONS)
- -m, --match STRING
- فقط چاپ پیام‌هایی که شامل STRING هستند
- -M, --unmatch STRING
- چاپ پیام‌هایی که شامل STRING نیستند
- -t, --trigger STRING
- شروع ثبت
لاگ با
تطابق رشته
STRING
هنگامی که مشخص شود، ثبت لاگ به محض مواجهه با پیامی که شامل رشته داده‌شده باشد آغاز خواهد شد. همچنین ببینید -T, --untrigger. سایر فیلترها همچنان اعمال می‌شوند، اما بدیهی است که پیام‌های فیلترشده تنها پس از آغاز ثبت لاگ چاپ خواهند شد.
- -T, --untrigger STRING
- توقف ثبت
لاگ با
تطابق رشته
STRING
هنگامی که مشخص شود، ثبت لاگ به محض مواجهه با پیامی که شامل رشته داده‌شده باشد متوقف خواهد شد. همچنین ببینید -t, --trigger. سایر فیلترها همچنان اعمال می‌شوند، اما بدیهی است که پیام‌های فیلترشده تنها پیش از توقف ثبت لاگ چاپ خواهند شد.
نکته: اگر هیچ --trigger مشخص نشده باشد، idevicesyslog پس از مواجهه با پیام لاگ منطبق خارج خواهد شد.
- -p, --process PROCESS
- فقط چاپ
پیام‌های
فرآیند(های)
منطبق
مقدار PROCESS رشته‌ای است که می‌تواند یک شناسه عددی فرآیند (PID) یا نام یک فرآیند باشد. همچنین از چندین نام فرآیند یا PID در یک رشته که با | از یکدیگر جدا شده‌اند پشتیبانی می‌کند (حتماً از علامت نقل‌قول استفاده کنید!).
- -e, --exclude PROCESS
- چاپ تمام
پیام‌ها به
جز
فرآیند(های)
منطبق
مقدار PROCESS رشته‌ای است که می‌تواند یک شناسه عددی فرآیند (PID) یا نام یک فرآیند باشد. همچنین از چندین نام فرآیند یا PID در یک رشته که با | از یکدیگر جدا شده‌اند پشتیبانی می‌کند (حتماً از علامت نقل‌قول استفاده کنید!).
- -q, --quiet
- تنظیم یک
فیلتر برای
مستثنی
کردن
فرآیندهای
پر سر و
صدای معمول
از آنجا که syslog می‌تواند بسیار شلوغ و پر سر و صدا باشد، این سوئیچ سریع خط فرمان اجازه می‌دهد مجموعه‌ای از پیش تعریف‌شده از فرآیندهای شناخته‌شده بی‌صدا شوند. فهرست فرآیندهایی که بی‌صدا می‌شوند را می‌توان با --quiet-list دریافت کرد.
- --quiet-list
- چاپ فهرست فرآیندهای مربوط به --quiet و خروج
- -k, --kernel
- فقط چاپ
پیام‌های
هسته (kernel)
این گزینه در واقع معادل ارسال --process kernel است، با این استثنا که می‌توان آن را همراه با --quiet استفاده کرد تا فرآیندهای شلوغ بی‌صدا شوند اما همچنان تمامی پیام‌های لاگ هسته دریافت گردند.
- -K, --no-kernel
- نادیده
گرفتن
پیام‌های
هسته
این گزینه معادل ارسال --exclude kernel است.
مثال‌ها (EXAMPLES)
- idevicesyslog -u 00008030-0000111ABC000DEF
- رله کردن syslog دستگاهی با UDID معادل 00008030-0000111ABC000DEF.
- idevicesyslog -x
- رله کردن syslog دستگاه و خروج به محض قطع اتصال دستگاه.
- idevicesyslog -m '####' -e 'identityservicesd' -K
- فقط چاپ پیام‌های لاگی که شامل رشته #### بوده و منشأ آن‌ها identityservicesd یا هسته نباشد.
- idevicesyslog -p MyApp -p ReportCrash
- فقط چاپ پیام‌های لاگ مربوط به فرآیندهای 'MyApp' و 'ReportCrash'.
- idevicesyslog -p 'MyApp|ReportCrash'
- مشابه مثال قبل با ساختار نحوی متفاوت.
- idevicesyslog -e 'backboardd|CommCenter|mDNSResponder'
- صرف‌نظر کردن از پیام‌های لاگ فرآیندهای backboardd و CommCenter و mDNSResponder.
- idevicesyslog -q -k
- صرف‌نظر کردن از پیام‌های لاگ فرآیندهای پر سر و صدای معمول، اما چاپ قطعی پیام‌های لاگ هسته.
- idevicesyslog -K
- صرف‌نظر کردن از پیام‌های لاگ هسته، اما چاپ تمامی پیام‌های دیگر.
- idevicesyslog -t 'backlight on' -T 'backlight off' -q
- شروع ثبت لاگ هنگام روشن شدن نور پس‌زمینه دستگاه و توقف آن هنگام خاموش شدن نور پس‌زمینه، به همراه بی‌صدا کردن فرآیندهای پر سر و صدا.
نویسندگان (AUTHORS)
Nikias Bassen, Martin Szulecki
صفحه راهنما جهت انطباق با دبیان توسط Julien Lavergne نوشته شده است.