نام (NAME)

plutil — ابزار کار با فهرست‌های ویژگی (Property list)

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

plutil [-command] [-options] file

توضیحات (DESCRIPTION)

ابزار plutil می‌تواند برای ویرایش فهرست‌های ویژگی (property lists)، بررسی درستی نحو، یا تبدیل از یک قالب به قالب دیگر استفاده شود. اگر ‘-’ به عنوان مسیر فایل داده شود، از ورودی استاندارد (stdin) و خروجی استاندارد (stdout) استفاده می‌شود.

بخش اول، عملیاتی است که باید انجام شود و یکی از موارد زیر است:

-p

کل plist را در خروجی استاندارد (stdout) با قالب خوانا برای انسانِ GNUStep چاپ می‌کند.

-lint

بررسی می‌کند که آیا فایل plist قابل تجزیه و تحلیل است یا خیر.

-convert FMT

فهرست ویژگی را به قالب دیگری تبدیل می‌کند. ‘FMT’ می‌تواند یکی از موارد زیر باشد:

xml1

قالب Apple XML.

binary1

قالب Apple binary.

openstep

قالب OpenStep (بدون نوع، خوانا برای انسان).

gnustep

قالب GNUStep (دارای نوع، خوانا برای انسان).

json

قالب JSON (با اتلاف داده، خوانا برای انسان).

نام‌های NSPropertyListFormat نیز پذیرفته می‌شوند.

-insert PATH KEY Value

درج مقدار در مسیر کلید مشخص‌شده.

گزینه‌های عمومی عبارتند از:

مفهوم "keypath" در plutil یک زنجیره از کلیدهای جداشده با نقطه برای پیمایش شیء plist است. یک keypath خالی به خود شیء اشاره دارد. قالب کلیدها با لیترال‌های رشته‌ای plist در GNUStep مطابقت دارد.

نکات پیاده‌سازی (IMPLEMENTATION NOTES)

• رشته‌های نقل‌قول‌شده در keypath یک افزونه GNUStep هستند.
• قالب‌های خروجی تحت لفظی (literal) برای زبان‌های Objective-C و Swift هنوز پیاده‌سازی نشده‌اند.

وضعیت خروج (EXIT STATUS)

در صورت موفقیت مقدار 0 و در صورت بروز خطا مقدار غیرصفر برگردانده می‌شود.

مثال‌ها (EXAMPLES)

عیب‌یابی (DIAGNOSTICS)

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

pl(1) pldes(1)

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

این نسخه از plutil توسط Mingye Wang <arthur2e5@aosc.io> نوشته شده است. plutil نخستین بار در Mac OS X 10.2 ظاهر شد و قابلیت‌های مرتبط با مسیر را در حدود Mac OS X 10.13 دریافت کرد.