autogen - онлайн у хмарі

ПРОГРАМА:

ІМ'Я

автоген - Автоматичний генератор програм

СИНТАКСИС

автоген [- прапори] [- прапор [значення]] [--назва-опції[[=| ]значення]] [ ]

AutoGen створює текстові файли з шаблонів, використовуючи зовнішні визначення.

ОПИС

AutoGen призначений для генерування програмних файлів, які містять повторюваний текст із різноманітними
заміни. Мета полягає в тому, щоб спростити обслуговування програм, які містять великі
кількість повторюваного тексту. Це особливо цінно, якщо блоків декілька
такий текст, який потрібно синхронізувати.

Одним з поширених прикладів є проблема підтримки коду, необхідного для обробки програми
параметри. Варіанти обробки вимагають збереження як мінімум чотирьох різних конструкцій
правильний порядок у різних місцях вашої програми. Вам потрібно щонайменше: Символ прапора
у рядку прапора, код для обробки прапора, коли він зустрічається, глобальний стан
змінна або дві та рядок у тексті використання. Вам знадобиться більше речей, крім цього, якщо
ви обираєте реалізацію довгих імен параметрів, обробки конфігураційного файлу, середовища
змінні і так далі.

Все це можна зробити механічно; з відповідними шаблонами та цією програмою.

ВАРІАНТИ

Команда після опції вибрати визначення, Шаблони та схема Функції до використання
-L реж, --templ-dirs=реж
Шукайте шаблони в DIR. Ця опція може з’являтися необмежену кількість разів.

Додати каталог до списку каталогів автоген пошук при відкритті a
шаблон, як основний або включений шаблон. Останній запис має
найвищий пріоритет у списку пошуку. Тобто їх обшукують
зворотний порядок.

-T tpl-файл, --override-tpl=tpl-файл
Скористайтесь TPL-ФАЙЛ для шаблону. Ця опція може бути не встановлена ​​в середовищі
змінних або у файлах ініціалізації (rc).

Файли визначення визначають стандартний шаблон, який потрібно розгорнути. Цей варіант
замінить це ім’я та розгорне інший шаблон.

-l tpl-файл, --lib-шаблон=tpl-файл
Завантажити макроси AutoGen з TPL-ФАЙЛ. Ця опція може відображатися в необмеженій кількості
раз.

Макроси DEFINE зберігаються з цього файлу шаблону для використання в обробці основного
файл макросу. Текст шаблону, окрім макросу DEFINE, ігнорується.

Не використовуйте це. Замість цього використовуйте макрос INCLUDE у своєму шаблоні.

ПРИМІТКА: ЦЕ ВАРІАНТ IS ЗНИЖЕНИЙ

--визначення=файл, Fl -ні-означення
Прочитайте визначення з Фото, без визначень форма вимкне цю опцію. Це
параметр увімкнено за замовчуванням. Ця опція може бути не встановлена ​​в середовищі
змінних або у файлах ініціалізації (rc).

Використовуйте цей аргумент, щоб указати файл визначень вхідних даних із параметром командного рядка.
Якщо ви не вказали цю опцію, тоді має бути аргумент командного рядка, який
вказує файл, навіть якщо лише вказати стандартний вхід із дефісом (-). Вкажіть,
--без визначень якщо ви бажаєте обробити шаблон без активного AutoGen
визначення.

-- оболонка=оболонка
ім'я або ім'я шляху до використовуваної оболонки.

За замовчуванням, коли AutoGen збирається, конфігурація перевіряється на розумну
Оболонка, подібна до Борна, для обробки сценаріїв оболонки. Якщо конкретний шаблон
потребує альтернативної оболонки, її потрібно вказати за допомогою цього параметра в команді
рядок зі змінною середовища (SHELL) або в конфігурації/ініціалізації
файлу.

-m, --no-fmemopen
Не використовуйте потоки в пам’яті.

Якщо локальна бібліотека C підтримує "fopencookie(3GNU)"або"funopen(3BSD)" потім
AutoGen надає перевагу відкриттю потокового буфера в пам’яті замість анонімних файлів.
Це може призвести до проблем, якщо не вистачає віртуальної пам'яті. Якщо для a
певної програми, у вас не вистачає пам’яті, тоді вкажіть цей параметр. Це
малоймовірно в сучасному середовищі 64-розрядної віртуальної пам'яті.

На платформах без цих функцій опція приймається, але ігнорується.
fmemopen(POSIX) не є адекватним, оскільки його рядковий буфер не можна перерозподілити.
open_memstream(POSIX) is Також неадекватно, оскільки потік відкритий лише для
вихід. AutoGen потребує перерозподіленого буфера, доступного як для читання, так і для
письмова форма.

-- прирівняти=char-list
символів, які вважаються еквівалентними. За замовчуванням char-list для цього варіанту є:
_-^

Цей параметр змінить список символів, які вважаються еквівалентними. За замовчуванням
це три символи "_-^". (Останній є звичайним для Tandem/HP-NonStop,
і раніше я багато працював над тандемами.)

Команда після опції змінювати як вихід is обробляються
-b ім'я, --базова назва=ім'я
Вказувати ІМ'Я як базове ім'я для виведення. Ця опція може бути не встановлена
змінні середовища або у файлах ініціалізації (rc).

Шаблон може вказувати точну назву вихідного файлу. Зазвичай це не так.
Натомість ім’я складається з основного імені файлу визначень
додані суфікси. Ця опція замінить базову назву, отриману від
ім'я файлу визначень. Це потрібно, якщо немає файлу визначень і
рекомендовано, якщо визначення читаються зі стандартного вводу. Якщо визначення є
читати зі стандартного in, базова назва за замовчуванням stdin. Будь-який провідний каталог
компоненти в назві буде мовчки видалено. Якщо ви бажаєте вихідний файл
з'являться в певному каталозі, рекомендується "cd" у нього
каталог або використовуйте імена каталогів у специфікації формату для виведення
списки суфіксів, див.: псевдомакрос.

-- джерело-час, - Fl -no-source-time
встановити час моди до останнього джерела. The no-source-time форма вимкне цю опцію.

Якщо ви позначаєте вихідні файли ID макрос, а потім вихідні файли
завжди буде іншим, навіть якщо зміст насправді не змінився. Якщо ви використовуєте
цей параметр, тоді час модифікації вихідних файлів буде змінюватися, лише якщо
зміна вхідних файлів. Це допоможе зменшити непотрібні збірки.

--записуваний, - Fl -не-запис
Дозволити доступ до вихідних файлів. The не можна записувати форма вимкне цю опцію.

Цей параметр залишить доступними для запису вихідні файли. Зазвичай вихідні файли читаються-
тільки.

Команда після опції він має часто корисний в той час як налагодження new Шаблони
Вони вказують обмеження, які запобігають тому, щоб шаблон тривав надто довго або створював більше
вихід, ніж очікувалося.

--loop-limit=лім
Обмеження на приріст петель. Цей параметр приймає в якості аргументу ціле число.
Значення лім обмежено:
рівно -1, або
в діапазоні від 1 до 0x1000000
За умовчанням лім для цього варіанту є:
256

Цей параметр запобігає появі петель. Наприклад, якщо ви випадково вказали «ЗА
x (для-від 1) (для-до -1) (для-на 1)", для завершення знадобиться багато часу. Якщо ви
маєте більше 256 записів у таблицях, вам потрібно буде вказати новий ліміт за допомогою
цей варіант.

-t seconds, --час вийшов=seconds
Обмежте операції оболонки сервера СЕКУНДИ. Цей параметр приймає ціле число як
його аргумент. Значення seconds обмежено:
в діапазоні від 0 до 3600

AutoGen працює з серверним процесом оболонки. Більшість звичайних команд буде завершено
менше 10 секунд. Однак, якщо ваші команди вимагають більше часу, ніж цей, використовуйте
цей варіант.

Допустимий діапазон становить від 0 до 3600 секунд (1 година). Нуль вимкне серверний час
ліміт.

--слід=рівень
рівень деталізації трасування. Цей параметр приймає ключове слово як аргумент. The
аргумент встановлює значення перерахування, яке можна перевірити, порівнявши їх із
макрос значення параметра. Доступні ключові слова:
нічого оболонка сервера налагодження повідомлень
шаблони блок-макроси виразів
все
або їх числовий еквівалент.

За умовчанням рівень для цього варіанту є:
нічого

Цей параметр змусить AutoGen відобразити слід обробки свого шаблону.
Існує шість рівнів, кожен з яких включає повідомлення з попередніх рівнів:

нічого Взагалі не трасує (за замовчуванням)

debug-повідомлення Друк повідомлень із макросу AutoGen "DEBUG" (див.: DEBUG).

серверна оболонка Відстежує весь вхід і вихід до оболонки сервера. Це включає в себе a
"незалежний" сценарій ініціалізації оболонки довжиною близько 30 рядків. Його вихід є
відкинуто та не вставлено в жодний шаблон.

Шаблони Сліди виклику ВИЗНАЧИТИd макроси і ВКЛЮЧАТИs

блок-макроси Відстежує всі блокові макроси. Вищевказане плюс IF, ДЛЯ, СПРАВА та ВІД.

вирази Відображає результати обчислень виразів.

все Відображає навіть виклик кожного макросу AutoGen TEXT макроси (тобто
текст поза лапками макросу). Крім того, якщо ви перебудуєте ``expr.ini''
файл із увімкненим налагодженням, тоді всі виклики визначених схемою функцій AutoGen
також буде зареєстровано:
cd ${top_builddir}/agen5
DEBUG_ENABLED=true bash bootstrap.dir expr.ini
make CFLAGS='-g -DDEBUG_ENABLED=1'

Майте на увазі, що ви не можете перебудувати це джерело таким чином, не маючи попередньо
встановлено автоген виконуваний файл у вашому шляху пошуку. Через це "expr.ini"
знаходиться в списку розподілених джерел, а не в залежностях.

--відстеження=файл
відстеження вихідного файлу або фільтра.

Зазначений результат може бути назвою файлу, файлом, який додається до нього, або, якщо
Аргумент option починається з труба оператор (|), команда, яка отримає
відстеження виводу як стандартного в. Наприклад, --traceout='| менше буде проводити трасування
вихід через менше програма. Додавання до файлу вказується передуванням
ім'я файлу з двома символами більше (>>).

--show-defs
Покажіть дерево визначень. Цей параметр може не бути попередньо встановленим у змінних середовища
або у файлах ініціалізації (rc).

Це роздрукує повне дерево визначень перед обробкою шаблону.

--used-defines
Покажіть використані визначення. Ця опція може бути не встановлена ​​в середовищі
змінних або у файлах ініціалізації (rc).

Це роздрукує назви значень визначень, які шукали під час
обробка шаблону, незалежно від того, чи дійсно він знайдений. Можуть бути й інші
посилання на визначення в шаблоні в частинах шаблону, які не оцінюються.
Деякі з наведених імен можуть бути обчисленими іменами, а інші — аргументами макросу AutoGen.
Це не засіб для створення остаточного, всеохоплюючого списку всіх і
лише значення, використані з файлу визначення. Це призначено як допомога
лише шаблонна документація.

-C, --ядро
Залиште дамп ядра на виході з ладу.

У багатьох системах за замовчуванням встановлено нульовий розмір ядра. Якщо в системі є
sys/resource.h заголовок, і якщо ця опція вказана, то в аварійному виході
path, autogen спробує встановити межу м'якого ядра на будь-яке жорстке ядро
межа є. Якщо це не спрацює, то адміністратор повинен підняти жорстке ядро
обмеження розміру. у файлах визначень і файлах шаблонів" Вони вказують, які
випуски та частини випусків для виробництва.

-s Суфікс, --пропуск-суфікс=Суфікс
Пропустіть файл з цим СУФІКС. Ця опція може відображатися в необмеженій кількості
разів. Цей параметр може не бути попередньо встановленим у змінних середовища або в
файли ініціалізації (rc). Цей параметр не повинен з’являтися в поєднанні з будь-яким із
наступні параметри: виб.-суф.

Іноді може бути небажаним створювати всі вказані вихідні файли
в шаблоні. (Наприклад, тільки .h файл заголовка, але не файл .c програма
текст.) Для цього вкажіть --skip-suffix=c у командному рядку.

-o Суфікс, --select-суфікс=Суфікс
вкажіть цей вихідний суфікс. Ця опція може з’являтися необмежену кількість разів.
Цей параметр може бути не встановлений у змінних середовища або під час ініціалізації (rc)
файли.

Якщо ви бажаєте замінити специфікації суфіксів у шаблоні, ви можете використати їх
або більше копій цього варіанту. Перегляньте специфікацію суфікса в @ref{pseudo
макрос} розділу інформаційного документа.

-D значення, --визначити=значення
ім'я, яке потрібно додати до списку визначень. Ця опція може відображатися в необмеженій кількості
раз.

Імена визначення AutoGen використовуються для таких цілей:

Розділи визначень AutoGen можна ввімкнути або вимкнути за допомогою стилю C
директиви #ifdef і #ifndef.

Визначаючи значення для імені, ви можете вказати індекс для певного значення.
Цей індекс може бути літеральним значенням, параметром визначення або значенням #define-d у
самі визначення.

Ім'я файлу може мати префікс $NAME/, $NAME частина рядка імені
буде замінено на визначене значення d для ІМ'Я.

Коли AutoGen завершує завантаження визначень, визначені значення експортуються
до середовища з, putenv(3). Потім ці значення можна використовувати в сценаріях оболонки
з ${NAME@} посилань і в шаблонах с (getenv "ІМ'Я").

Під час обробки шаблону ви можете вказати індекс для отримання певного значення.
Цей індекс також може бути визначеним значенням d.

Цілком еквівалентно розмістити цю назву в експортованому середовищі.
Внутрішньо це те, що насправді робить AutoGen із цією опцією.

-U ім'я-пат, --невизначити=ім'я-пат
шаблон видалення списку визначень. Ця опція може відображатися в необмеженій кількості
разів. Цей параметр може не бути попередньо встановленим у змінних середовища або в
файли ініціалізації (rc).

Подібно до «C», AutoGen використовує #ifdef/#ifndef директиви попередньої обробки. Цей варіант
призведе до видалення відповідних імен зі списку визначених значень.

це варіант is використовуваний до автоматизувати залежність відстеження
-M тип, --make-dep [тип]
видавати файл залежності make. Ця опція може з’являтися необмежену кількість разів.
Цей параметр може бути не встановлений у змінних середовища або під час ініціалізації (rc)
файли.

Цей варіант веде себе досить близько до способу -M ряд варіантів роботи з
компілятор gcc, за винятком того, що замість простого випуску попередника
залежності, це також видає залежності наступників (вихідні цільові файли). за
за замовчуванням буде розміщено вихідну інформацію про залежність .d, але може
також вказується с -MF. Позначку часу на цьому файлі буде змінено
так що він буде на одну секунду старшим за найстаріший основний вихідний файл.

Ціллю в цьому файлі залежностей зазвичай буде назва файлу залежностей, але
також можна замінити за допомогою -MT. AutoGen не змінюватиме вміст
цей файл, але він може створити його та налаштувати час модифікації відповідно до відповідності
час початку.

NB: ці другі літери є частиною аргументу option, отже -MF повинні бути
символ пробілу в лапках або пропущено, і -M "F " є прийнятним, оскільки
F є частиною аргументу параметра.

-M може супроводжуватися будь-якою з літер M, F, P, T, Q, D або G. Однак лише F,
Q, T і P мають значення. Усі, крім F, мають дещо різні значення. -MT
тлумачиться як значення є дозорним файлом, який залежатиме від усіх вхідних даних
(шаблони та файли визначення), і всі вихідні файли залежатимуть від цього
дозорний файл. Він підходить для використання як реальна мішень. Q лікується
ідентично T, за винятком того, що символи долара ('$') подвоюються. П обумовлює особливу
clean (clobber) фальшиве правило, яке буде вставлено у фрагмент файлу make. Порожній
правило завжди створюється для створення списку цілей.

Це рекомендоване використання:
-MFwhatever-you-like.dep -MTyour-sentinel-file -MP
а потім у вашому Makefile, зробіть автоген правило:
-include whatever-you-like.dep
clean_targets += clean-your-sentinel-file
.sp
ваш-дозорний-файл:
autogen -MT$@@ -MF$*.d .....
.sp
місцево-чистий :
rm -f $(чисті_цілі)

Час модифікації у файлі залежностей налаштовано на одну секунду раніше
найраніша позначка часу будь-якого іншого вихідного файлу. Отже, він підходить для
використовувати як дозорний файл, що свідчить про успішний запуск програми.
(-включати це GNU make спосіб визначення «включити це, якщо воно існує». Ваша марка
має підтримувати цю функцію, або ваш процес початкового завантаження має створити файл.)

Все це також можна вказати за допомогою DEPENDENCIES_OUTPUT or AUTOGEN_MAKE_DEP
змінні середовища. Якщо визначено, інформація про залежність буде виведена. Якщо
визначається вільним текстом пробілу, який є чимось іншим, ніж правда, false, так,
немає, 0 or 1, тоді рядок буде прийнято як ім’я вихідного файлу. Якщо він містить a
рядок пробілів, перша лексема така, як вище, а друга лексема
розглядається як цільовий (дозорний) файл -MT в абзацах вище.
DEPENDENCIES_OUTPUT буде проігноровано, якщо є кілька послідовностей пробілів
символів або якщо його вміст, зокрема, false, немає or 0.

допомогти, версія та варіант обробка
-?, --допомога
Відобразити інформацію про використання та вийти.

-!, --більше-допоможіть
Передайте інформацію про розширене використання через пейджер.

-> [cfgfile], --save-opts [=cfgfile]
Збережіть стан опції до cfgfile. За замовчуванням є останній файл конфігурації
перераховані в ВАРІАНТ PRESETS розділ, нижче. Після оновлення команда вийде
файл конфігурації.

-< cfgfile, --load-opts=cfgfile, --no-load-opts
Завантажити параметри з cfgfile, без навантаження форма вимкне завантаження
попередні файли config/rc/ini. --no-load-opts обробляється рано, не в порядку.

-v [{v|c|n -- версія [{v|c|n}]}]
Вивести версію програми та вийти. Стандартним режимом є `v', проста версія.
Режим `c' надрукує інформацію про авторські права, а `n' надрукує повне авторське право
повідомлення.

ВАРІАНТ PRESETS

Будь-який варіант, який не позначений як НЕ попередньо налаштований можна попередньо встановити шляхом завантаження значень з
файл(и) конфігурації ("RC" або ".INI") і значення зі змінних середовища з назвою:
AUTOGEN_ or АВТОГЕН
Попередні налаштування середовища мають пріоритет (обробляються пізніше) конфігурації
файли The homerc файли "$ HOME"І".". Якщо будь-який з цих каталогів, то файл
файл .autogenrc шукається в цих каталогах.

НАВКОЛИШНЄ СЕРЕДОВИЩЕ

Читати ВАРІАНТ PRESETS для змінних середовища конфігурації.

Використовуйте autogen онлайн за допомогою сервісів onworks.net