xml2ag(1) User Commands xml2ag(1)

xml2ag - تبدیل تعاریف XML به تعاریف و قالب‌های قابل استفاده در AutoGen

xml2ag [-flags] [-flag [value]] [--option-name[[=| ]value]] [ <def-file> ]

این برنامه هر فایل XML دلخواهی را به تعاریف معادل AutoGen تبدیل کرده و AutoGen را فراخوانی می‌کند.

قالب (template) از یکی از موارد زیر مشتق خواهد شد:
* گزینه خط فرمان --override-tpl
* یک صفت سطح بالا در XML با نام "template"
یکی از این دو باید ارائه شود، در غیر این صورت برنامه با پیام خطا خارج خواهد شد.

نام پایه (“base-name”) برای خروجی نیز به‌طور مشابه از یکی از موارد زیر خواهد بود:
* گزینه خط فرمان --base-name
* نام پایه فایل ‎.xml


فایل خروجی به جای پردازش توسط AutoGen.

به‌طور پیش‌فرض، خروجی برای پردازش به یک فرایند AutoGen تحویل داده می‌شود. با این حال، می‌توانید به جای آن، تعاریف را در یک فایل ذخیره کنید.

این گزینه‌ها عمدتاً مستقیماً به autogen فرستاده می‌شوند (pass-through). تنها استثنا --override-tpl است که قالب پیش‌فرض را در تعاریف خروجی جایگزین می‌کند. این گزینه از طریق خط فرمان منتقل نمی‌شود.


جستجو برای قالب‌ها در پوشه DIR. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

آرگومان عبوری (Pass-through) به AutoGen


استفاده از TPL-FILE به عنوان قالب.

آرگومان عبوری (Pass-through) به AutoGen


خواندن تعاریف از FILE.

آرگومان عبوری (Pass-through) به AutoGen


نام یا مسیر شل (shell) مورد استفاده.

آرگومان عبوری (Pass-through) به AutoGen


عدم استفاده از جریان‌های درون حافظه (in-mem streams).

آرگومان عبوری (Pass-through) به AutoGen


کاراکترهایی که معادل در نظر گرفته می‌شوند.

آرگومان عبوری (Pass-through) به AutoGen


مشخص کردن NAME به عنوان نام پایه خروجی.

آرگومان عبوری (Pass-through) به AutoGen


تنظیم زمان تغییر مطابق با آخرین فایل منبع.

آرگومان عبوری (Pass-through) به AutoGen


اجازه دادن به فایل‌های خروجی برای قابل نوشتن بودن (writable). حالت not-writable این گزینه را غیرفعال می‌کند.

آرگومان عبوری (Pass-through) به AutoGen


محدودیت روی حلقه‌های افزایشی (increment loops). این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار lim محدود به موارد زیر است:
دقیقاً -1، یا
در محدوده 1 تا 0x1000000

مقدار پیش‌فرض lim برای این گزینه برابر است با:
256

آرگومان عبوری (Pass-through) به AutoGen


محدود کردن عملیات شل سرور به SECONDS ثانیه. این گزینه یک عدد صحیح را به عنوان آرگومان دریافت می‌کند. مقدار seconds محدود به موارد زیر است:
در محدوده 0 تا 3600

آرگومان عبوری (Pass-through) به AutoGen


سطح جزئیات ردگیری (tracing). این گزینه یک کلمه کلیدی را به عنوان آرگومان دریافت می‌کند. این آرگومان یک مقدار شمارشی (enumeration) را تنظیم می‌کند که با مقایسه با ماکروی مقدار گزینه قابل بررسی است. کلمات کلیدی در دسترس عبارتند از:
nothing       debug-message server-shell
templates     block-macros  expressions
everything
یا معادل عددی آن‌ها.

مقدار پیش‌فرض level برای این گزینه برابر است با:
nothing

آرگومان عبوری (Pass-through) به AutoGen


فایل یا فیلتر خروجی ردگیری (tracing).

آرگومان عبوری (Pass-through) به AutoGen


نمایش درخت تعاریف.

آرگومان عبوری (Pass-through) به AutoGen


نمایش تعاریف استفاده‌شده.

آرگومان عبوری (Pass-through) به AutoGen


بر جای گذاشتن یک core dump هنگام خروج ناشی از خطا.

بسیاری از سیستم‌ها به‌طور پیش‌فرض محدودیت اندازه core را صفر در نظر می‌گیرند. اگر سیستم دارای هدر sys/resource.h باشد و این گزینه ارائه شود، در مسیر خروج ناشی از شکست، autogen تلاش خواهد کرد تا محدودیت soft core را به هر مقداری که محدودیت hard core است افزایش دهد. اگر این کار عمل نکرد، مدیر سیستم باید محدودیت اندازه hard core را افزایش دهد.


صرف‌نظر کردن از فایلی با این SUFFIX (پسوند). این گزینه می‌تواند به تعداد نامحدود تکرار شود. این گزینه نباید در ترکیب با هیچ‌یک از گزینه‌های زیر استفاده شود: select-suffix.

آرگومان عبوری (Pass-through) به AutoGen


مشخص کردن این پسوند خروجی. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

آرگومان عبوری (Pass-through) به AutoGen


نامی برای افزودن به فهرست تعاریف. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

آرگومان عبوری (Pass-through) به AutoGen


الگوی حذف از فهرست تعاریف. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

آرگومان عبوری (Pass-through) به AutoGen


ایجاد فایل وابستگی make. این گزینه می‌تواند به تعداد نامحدود تکرار شود.

آرگومان عبوری (Pass-through) به AutoGen

-?, --help

نمایش اطلاعات نحوه استفاده و خروج.
-!, --more-help

ارسال اطلاعات مبسوط نحوه استفاده از طریق یک صفحه‌بند (pager).

نمایش نسخه برنامه و خروج. حالت پیش‌فرض `v` است که نسخه ساده را نشان می‌دهد. حالت `c` اطلاعات کپی‌رایت را چاپ می‌کند و `n` اعلان کامل کپی‌رایت را چاپ خواهد کرد.

یکی از مقادیر خروج زیر بازگردانده خواهد شد:

0 (EXIT_SUCCESS)

اجرای موفقیت‌آمیز برنامه.
1 (EXIT_FAILURE)

عملیات ناموفق بود یا نحو دستور معتبر نبود.
70 (EX_SOFTWARE)

کتابخانه libopts با یک خطای عملیاتی داخلی مواجه شد. لطفاً آن را به نشانی autogen-users@lists.sourceforge.net گزارش دهید. با تشکر.

Bruce Korb

حق نشر (C) 1992-2018 متعلق به Bruce Korb است؛ تمامی حقوق محفوظ است. این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL)، نسخه ۳ یا جدیدتر منتشر شده است.

لطفاً گزارش‌های باگ را به نشانی autogen-users@lists.sourceforge.net ارسال کنید.

این صفحه راهنما توسط AutoGen از روی تعاریف گزینه‌های xml2ag تولید شده است.

23 Apr 2025 GNU AutoGen (5.18.16)