| xml2ag(1) | User Commands | xml2ag(1) |
نام (NAME)
xml2ag - تبدیل تعاریف XML به تعاریف و قالبهای قابل استفاده در AutoGen
خلاصه دستور (SYNOPSIS)
xml2ag [-flags] [-flag [value]] [--option-name[[=| ]value]] [ <def-file> ]
این برنامه هر فایل XML دلخواهی را به تعاریف معادل AutoGen تبدیل کرده و AutoGen را فراخوانی میکند.
توضیحات (DESCRIPTION)
قالب (template) از
یکی از
موارد زیر
مشتق خواهد
شد:
* گزینه خط
فرمان --override-tpl
* یک صفت سطح
بالا در XML با
نام "template"
یکی از این
دو باید
ارائه شود،
در غیر این
صورت
برنامه با
پیام خطا
خارج خواهد
شد.
نام پایه
(“base-name”) برای
خروجی نیز
بهطور
مشابه از
یکی از
موارد زیر
خواهد بود:
* گزینه خط
فرمان --base-name
* نام پایه
فایل .xml
گزینهها (OPTIONS)
سایر گزینهها از autogen مشتق شدهاند
- -O file, --output=file
-
فایل خروجی به جای پردازش توسط AutoGen.بهطور پیشفرض، خروجی برای پردازش به یک فرایند AutoGen تحویل داده میشود. با این حال، میتوانید به جای آن، تعاریف را در یک فایل ذخیره کنید.
سایر گزینهها
این گزینهها عمدتاً مستقیماً به autogen فرستاده میشوند (pass-through). تنها استثنا --override-tpl است که قالب پیشفرض را در تعاریف خروجی جایگزین میکند. این گزینه از طریق خط فرمان منتقل نمیشود.
- -L dir, --templ-dirs=dir
-
جستجو برای قالبها در پوشه DIR. این گزینه میتواند به تعداد نامحدود تکرار شود.آرگومان عبوری (Pass-through) به AutoGen
- -T tpl-file, --override-tpl=tpl-file
-
استفاده از TPL-FILE به عنوان قالب.آرگومان عبوری (Pass-through) به AutoGen
- --definitions=file
-
خواندن تعاریف از FILE.آرگومان عبوری (Pass-through) به AutoGen
- --shell=shell
-
نام یا مسیر شل (shell) مورد استفاده.آرگومان عبوری (Pass-through) به AutoGen
- -m, --no-fmemopen
-
عدم استفاده از جریانهای درون حافظه (in-mem streams).آرگومان عبوری (Pass-through) به AutoGen
- --equate=char-list
-
کاراکترهایی که معادل در نظر گرفته میشوند.آرگومان عبوری (Pass-through) به AutoGen
- -b name, --base-name=name
-
مشخص کردن NAME به عنوان نام پایه خروجی.آرگومان عبوری (Pass-through) به AutoGen
- --source-time
-
تنظیم زمان تغییر مطابق با آخرین فایل منبع.آرگومان عبوری (Pass-through) به AutoGen
- --writable, --not-writable
-
اجازه دادن به فایلهای خروجی برای قابل نوشتن بودن (writable). حالت not-writable این گزینه را غیرفعال میکند.آرگومان عبوری (Pass-through) به AutoGen
- --loop-limit=lim
-
محدودیت روی حلقههای افزایشی (increment loops). این گزینه یک عدد صحیح را به عنوان آرگومان دریافت میکند. مقدار lim محدود به موارد زیر است:
دقیقاً -1، یا در محدوده 1 تا 0x1000000
مقدار پیشفرض lim برای این گزینه برابر است با:
256آرگومان عبوری (Pass-through) به AutoGen
- -t seconds, --timeout=seconds
-
محدود کردن عملیات شل سرور به SECONDS ثانیه. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت میکند. مقدار seconds محدود به موارد زیر است:
در محدوده 0 تا 3600
آرگومان عبوری (Pass-through) به AutoGen
- --trace=level
-
سطح جزئیات ردگیری (tracing). این گزینه یک کلمه کلیدی را به عنوان آرگومان دریافت میکند. این آرگومان یک مقدار شمارشی (enumeration) را تنظیم میکند که با مقایسه با ماکروی مقدار گزینه قابل بررسی است. کلمات کلیدی در دسترس عبارتند از:
nothing debug-message server-shell templates block-macros expressions everything
یا معادل عددی آنها.
مقدار پیشفرض level برای این گزینه برابر است با:
nothingآرگومان عبوری (Pass-through) به AutoGen
- --trace-out=file
-
فایل یا فیلتر خروجی ردگیری (tracing).آرگومان عبوری (Pass-through) به AutoGen
- --show-defs
-
نمایش درخت تعاریف.آرگومان عبوری (Pass-through) به AutoGen
- --used-defines
-
نمایش تعاریف استفادهشده.آرگومان عبوری (Pass-through) به AutoGen
- -C, --core
-
بر جای گذاشتن یک core dump هنگام خروج ناشی از خطا.بسیاری از سیستمها بهطور پیشفرض محدودیت اندازه core را صفر در نظر میگیرند. اگر سیستم دارای هدر sys/resource.h باشد و این گزینه ارائه شود، در مسیر خروج ناشی از شکست، autogen تلاش خواهد کرد تا محدودیت soft core را به هر مقداری که محدودیت hard core است افزایش دهد. اگر این کار عمل نکرد، مدیر سیستم باید محدودیت اندازه hard core را افزایش دهد.
- -s suffix, --skip-suffix=suffix
-
صرفنظر کردن از فایلی با این SUFFIX (پسوند). این گزینه میتواند به تعداد نامحدود تکرار شود. این گزینه نباید در ترکیب با هیچیک از گزینههای زیر استفاده شود: select-suffix.آرگومان عبوری (Pass-through) به AutoGen
- -o suffix, --select-suffix=suffix
-
مشخص کردن این پسوند خروجی. این گزینه میتواند به تعداد نامحدود تکرار شود.آرگومان عبوری (Pass-through) به AutoGen
- -D value, --define=value
-
نامی برای افزودن به فهرست تعاریف. این گزینه میتواند به تعداد نامحدود تکرار شود.آرگومان عبوری (Pass-through) به AutoGen
- -U name-pat, --undefine=name-pat
-
الگوی حذف از فهرست تعاریف. این گزینه میتواند به تعداد نامحدود تکرار شود.آرگومان عبوری (Pass-through) به AutoGen
- -M type, --make-dep [type]
-
ایجاد فایل وابستگی make. این گزینه میتواند به تعداد نامحدود تکرار شود.آرگومان عبوری (Pass-through) به AutoGen
- -?, --help
-
نمایش اطلاعات نحوه استفاده و خروج. - -!, --more-help
-
ارسال اطلاعات مبسوط نحوه استفاده از طریق یک صفحهبند (pager). - -v [{v|c|n --version [{v|c|n}]}]
-
نمایش نسخه برنامه و خروج. حالت پیشفرض `v` است که نسخه ساده را نشان میدهد. حالت `c` اطلاعات کپیرایت را چاپ میکند و `n` اعلان کامل کپیرایت را چاپ خواهد کرد.
وضعیت خروج (EXIT STATUS)
یکی از مقادیر خروج زیر بازگردانده خواهد شد:
- 0 (EXIT_SUCCESS)
-
اجرای موفقیتآمیز برنامه. - 1 (EXIT_FAILURE)
-
عملیات ناموفق بود یا نحو دستور معتبر نبود. - 70 (EX_SOFTWARE)
-
کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به نشانی autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.
نویسندگان (AUTHORS)
Bruce Korb
کپیرایت (COPYRIGHT)
حق نشر (C) 1992-2018 متعلق به Bruce Korb است؛ تمامی حقوق محفوظ است. این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL)، نسخه ۳ یا جدیدتر منتشر شده است.
گزارش باگها (REPORTING BUGS)
لطفاً گزارشهای باگ را به نشانی autogen-users@lists.sourceforge.net ارسال کنید.
نکات (NOTES)
این صفحه راهنما توسط AutoGen از روی تعاریف گزینههای xml2ag تولید شده است.
| 23 Apr 2025 | GNU AutoGen (5.18.16) |