.TH "plistutil" 1
.SH "نام (NAME)"
plistutil \- تبدیل یک فایل plist بین قالب‌های باینری، XML و JSON
.SH "خلاصه دستور (SYNOPSIS)"
.B plistutil
[OPTIONS]
[-i FILE]
[-o FILE]
.SH "توضیحات (DESCRIPTION)"
ابزار plistutil امکان تبدیل یک فایل Property List (فهرست ویژگی‌ها) را بین قالب‌های باینری، XML و JSON فراهم می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-i, \-\-infile FILE
فایل ورودی (FILE) جهت تبدیل. اگر این آرگومان حذف شود یا \- به عنوان نام فایل ارسال گردد، plistutil داده‌ها را از stdin خواهد خواند.
.TP
.B \-o, \-\-outfile FILE
فایل خروجی (FILE) برای ذخیره نتیجه تبدیل. اگر این آرگومان حذف شود یا \- به عنوان نام فایل مشخص گردد، plistutil در stdout خواهد نوشت.
.TP
.B \-f, \-\-format [bin|xml|json|openstep]
اجبار قالب خروجی، صرف‌نظر از نوع قالب ورودی. این گزینه زمانی مفید است که قالب ورودی نامشخص باشد، اما خروجی باید همواره در قالبی مشخص (مانند xml یا json) باشد.

در صورت عدم تعیین، داده‌های plist از نوع XML به باینری تبدیل می‌شوند و برعکس. برای تبدیل به یا از JSON یا OpenStep، قالب خروجی باید به طور صریح مشخص شود.
.TP
.B \-p, \-\-print FILE
چاپ plist در قالبی خوانا برای انسان.
.TP
.B \-c, \-\-compact
فقط برای JSON و OpenStep: چاپ خروجی به صورت فشرده. به طور پیش‌فرض، خروجی به شکل قالب‌بندی‌شده و خوانا (pretty-print) تولید می‌شود.
.TP
.B \-s, \-\-sort
مرتب‌سازی الفبایی تمام گره‌های دیکشنری بر اساس کلید، پیش از تبدیل به قالب خروجی.
.TP
.B \-h, \-\-help
چاپ اطلاعات راهنما و نحوه استفاده از دستور.
.TP
.B \-d, \-\-debug
فعال‌سازی خروجی اشکال‌زدایی (debug) گسترده.
.TP
.B \-v, \-\-version
چاپ اطلاعات نسخه.
.SH "مثال‌ها (EXAMPLES)"
.TP
.B plistutil \-i test.plist \-o out.plist
تبدیل test.plist و نوشتن نتیجه در out.plist. اگر test.plist در قالب XML باشد، out.plist در قالب باینری خواهد بود. اگر test.plist در قالب باینری باشد، out.plist در قالب XML ذخیره می‌شود.
.TP
.B plistutil \-i test.plist \-o out.plist \-f bin
مشابه مورد قبل، اما خروجی همواره در قالب باینری خواهد بود.
.TP
.B plistutil \-i test.plist \-f xml
چاپ test.plist به صورت plist از نوع XML، صرف‌نظر از قالب ورودی.
.TP
.B plistutil \-i test.plist \-f xml \-o -
مشابه دستور قبلی.
.TP
.B plistutil \-i test.plist \-f json
چاپ test.plist به صورت plist از نوع JSON، صرف‌نظر از قالب ورودی.
.TP
.B cat test.plist |plistutil \-f xml
دریافت داده‌های plist از ورودی استاندارد (stdin) \- که از طریق دستور cat لوله‌کشی (pipe) شده \- و نوشتن خروجی به صورت XML در stdout.
.SH "نویسندگان (AUTHORS)"
Zach C.

Martin Szulecki

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

https://github.com/libimobiledevice/libplist