kdesrc-build – Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

kdesrc-build — завантажує, збирає та встановлює програмне забезпечення KDE.

СИНТАКСИС

kdesrc-build [ВАРІАНТИ...] [Модулі ім'я | Модулі комплект ім'я...]

ОПИС

Команда kdesrc-build Команда використовується для створення програмного забезпечення KDE безпосередньо з його джерела
сховища. Його можна завантажувати зі сховищ Subversion або Git, інтерфейсів із KDE
бази даних проекту та підтримує контроль того, які параметри передаються зробити(1) і
cmake(1). Операція kdesrc-build зазвичай керується файлом конфігурації
~/.kdesrc-buildrc.

Команда Модулі ім'я or Модулі комплект ім'я як зазначено в командному рядку, мають бути такими іменами
були визначені у файлі конфігурації (або у визначенні модуля, або використання-модулі
декларації, або в а модуль-комплект визначення). Крім того, це може бути назва KDE
модуль, зазначений у базі даних проекту KDE (при цьому перед назві модуля можна поставити + to
змусити це).

kdesrc-build розроблено, щоб мати можливість бути повністю безголовим (проте див НАВКОЛИШНЄ СЕРЕДОВИЩЕ),
і тому зазвичай повністю ігнорує його введення. Вихід команди реєструється замість того, щоб бути
показано у виводі kdesrc-build.

Модулі будуються один за одним. Якщо модуль не вдається оновити, він не створений.
kdesrc-build не буде перервано лише через збій модуля, натомість буде продовжувати спроби
для оновлення та створення наступних модулів. За замовчуванням, kdesrc-build розпочне будівництво а
модуль, як тільки оновлення вихідного коду буде завершено для цього модуля, навіть якщо інше
оновлення відбуваються одночасно.

В кінці kdesrc-build покаже, які модулі не вдалося зібрати, і де були журнали
зберігається для цього запуску збірки.

ВАРІАНТИ

ПРИМІТКА: Деякі варіанти мають короткі форми, але kdesrc-build синтаксичний аналізатор параметрів не підтримує
об’єднання коротких варіантів в один на цьому етапі. (Наприклад, біг kdesrc-build -пв не буде
бути таким же, як kdesrc-build --удавайте -багатослівний).

-h, --допомога
Показує короткий синопсис і часто використовувані параметри командного рядка.

-p, --удавайте
Працюють в режимі «сухий хід». Не здійснюється доступ до мережі, файли журналів не створюються,
не будуються модулі та не вносяться інші постійні зміни на диск. один важливо
виняток полягає в тому, що якщо ви спробуєте створити модуль, який походить із проекту KDE
бази даних, а база даних ще не завантажена, база даних буде завантажена
оскільки вихід у притворному режимі може значно змінитися на основі результатів бази даних.

--встановити
Пропускає етап оновлення та складання та негайно намагається встановити модулі
дано.

--видалити
Пропускає етап оновлення та складання та негайно намагається видалити модулі
дано. ПРИМІТКА: це підтримується лише для систем збірки, які підтримують зробити деінсталяція
команду (наприклад, на основі KDE CMake).

--no-src
Пропускає етап оновлення джерела. Інші фази включені як звичайно. --no-svn це
застарілий псевдонім для цієї опції та буде вилучено в майбутньому випуску.

--не встановлюється
Пропускає етап встановлення зі складання. Інші фази включені як звичайно.

--не-будувати
Пропускає фазу складання для збірки. Внутрішня фаза встановлення залежить від збірки
фаза завершення, тому це фактично еквівалентно --src-only, але семантика
може змінитися в майбутньому (наприклад, коли тестові набори будуть переведені на власну фазу).

--без тестів
Вимикає запуск набору тестів для модулів на основі CMake. Щоб це було повністю ефективним
вимагає повторного запуску CMake, який можна примусити за допомогою --переналаштувати or
--refresh-build Варіанти.

--src-only
Виконує лише етап оновлення джерела, не збирає та не встановлює. --тільки svn це
застарілий псевдонім для цієї опції та буде вилучено в майбутньому випуску.

--лише для створення
Примусово виконувати процес збірки без попереднього оновлення вихідного коду. в
крім того, установка не проводиться. (Тестування все ще проводиться, якщо є,
але це зміниться в наступному випуску)

--refresh-build
Видаляє каталог збірки для модуля перед початком етапу збірки. Це має
бажаний побічний ефект форсування kdesrc-build щоб повторно налаштувати модуль і побудувати його
з «першого» стану без наявних тимчасових чи проміжних вихідних файлів. Використовуйте
цей варіант, якщо у вас виникли проблеми зі створенням модуля, але ви розумієте, що це займе
довше (можливо, набагато довше) для завершення збірки в результаті. У разі сумнівів використовуйте
цей варіант для всього kdesrc-build бігти.

--переналаштувати
Примусово запустити CMake, але без видалення каталогу збірки. Зазвичай ти
насправді хочу --refresh-build, але якщо ви на 100% впевнені, що змінюєте cmake-опції
не призведе до втрати поточного проміжного результату, то це може заощадити деякий час.

--лише для системної збірки
Перериває процес збірки для кожного побудованого модуля: Процес збірки складається з
звичайне налаштування до роботи включно cmake or конфігурувати (якщо доречно), але зробити
не запускається і не робиться спроба встановлення. Це в основному корисно лише для отримання речей
як конфігурувати --допомога та cmake-gui працювати. Зазвичай ви хочете --переналаштувати or
--refresh-build.

--resume-from=Foo
Використовуйте цю опцію, щоб пропустити обробку модуля до модуля Foo зустрічається. Foo
і всі наступні модулі будуть оброблятися нормально, як якщо б вони були вказані на
командний рядок. Якщо ви використовуєте цю опцію через помилку збірки, ви можете це зробити
розгляньте можливість використання --no-src крім того, щоб пропустити результуючу фазу оновлення джерела.

--resume-after=Foo
Це просто як --резюме-від, крім того, що модуль Foo is НЕ Входить до складу
список модулів для розгляду. Ви можете використовувати це, якщо ви вручну створили/встановили foo
після виправлення збірки і просто хочу продовжити звідти.

--ignore-modules
Війська ALL модулі, які відповідають цій опції, виключаються з розгляду
kdesrc-build. Це може бути корисно, якщо ви знаєте, що хочете обробити всі модулі, крім
для конкретних винятків.

--rc-файл=Foo
Використовуйте наданий файл, Foo, для конфігурації замість ~/.kdesrc-buildrc or
./kdesrc-buildrc. Файл може бути порожнім, але має існувати.

--префікс=Foo
Перевизначає kdedir налаштування Foo для цього пробігу. Крім того, має на увазі
--переналаштувати. Це робить НЕ насправді виконайте дію, яку ви думаєте, що вона виконує
(перекриваючи префікс можливість змінити місце встановлення модулів), хоча за
модулі за замовчуванням встановлені на kdedir налаштування якщо префікс не встановлено.

--приємно=Foo
Змінює наданий пріоритет ЦП kdesrc-build (і всі процеси, які використовуються kdesrc-build
наприклад зробити(1)). Foo має бути цілим числом від -20 до 19. Позитивні значення
є "приємнішими" для решти системи (тобто з нижчим пріоритетом).

Зауважте, що можливі пріоритети, доступні у вашій системі, можуть відрізнятися від
перераховані тут, див приємно(2) для отримання додаткової інформації. Зауважте також, що це лише змінюється центральний процесор
пріоритет, часто ви хочете змінити I / O пріоритет у системах, де це підтримується.
Немає параметра командного рядка для налаштування пріоритету вводу-виводу, але є
параметр файлу конфігурації: use-idle-io-priority (хоча, як і всі варіанти, є
загальний спосіб встановити це з командного рядка).

--запуск=Foo
Запускає програму з ім'ям Foo використання kdesrc-buildзвичайне середовище побудови. всі
Аргументи командного рядка, присутні після цього параметра, передаються до Foo як це запущено.

-колір
Вмикає «барвистий вихід». (Увімкнено за замовчуванням).

--без кольору
Вимикає «барвистий вихід». Це можна зробити постійним, налаштувавши параметр барвистий вихід
значення false (або 0) у вашому конфігураційному файлі.

--асинхронний
Мати kdesrc-build почніть процес збирання модуля, як тільки з’явиться вихідний код
закінчено завантаження. Без цієї опції kdesrc-build виконує всі оновлення джерел за адресою
один раз і тільки потім починається процес складання. Цей параметр увімкнено за замовчуванням.

--без асинхронності
Вимикає асинхронну побудову модулів. Побачити --асинхронний для більш детального
опис. Зауважте, що kdesrc-buildУ цьому режимі вихідні дані будуть дещо відрізнятися.

-v, -багатослівний
Підвищує рівень багатослівності kdesrc-build вихід (що вже справедливо
багатослівно!)

-q, --спокійно
Робить kdesrc-build менш шумний. Відображаються лише важливі повідомлення.

-- справді тихо
Робить kdesrc-build ще менше шумно. Відображаються лише попередження/помилки.

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

--примусово будувати
Зазвичай, коли kdesrc-build помічає, що немає оновлення джерела для модуля, який
було раніше успішно встановлено, він не намагається створити чи встановити його
модуль. Ви можете передати цей прапорець, щоб вимкнути цю поведінку і завжди запускати зробити.

--без знімків
Зазвичай kdesrc-build підтримує використання знімків tar-архів вихідного репозиторію для зменшення
навантаження на інфраструктуру KDE для клонів git для деяких модулів KDE. Передача цієї опції
вимикає цю функцію.

--delete-my-patches
Цей параметр потрібно передати, щоб дозволити kdesrc-build щоб видалити конфліктне джерело
каталогів. Наразі це трапляється лише при спробі клонувати модуль на основі git
якщо наявний вихідний каталог. Ніколи не вказуйте цю опцію, якщо вона не є
запропоновано kdesrc-build, і тільки якщо ви не проти вихідних каталогів, які є
посилання на видалення та повторне клонування.

--Foo=бар
Будь-який параметр, не зазначений вище, перевіряється, щоб перевірити, чи відповідає він списку можливих
параметри файлу конфігурації. Якщо так, параметр файлу конфігурації Foo є тимчасово
встановлений в бар на час цього пробігу.

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

EXIT СТАТУС

0
Успіх

1
Зазвичай це означає, що деяка частина процесу оновлення, збирання або встановлення не вдалася, але це так
також використовується для будь-якого ненормального завершення програми, інакше не описаного нижче.

5
Надійшов сигнал, що вбили kdesrc-build, але він намагався працювати нормально
зачиняти.

8
Невідома опція була передана в командному рядку.

99
Було створено виняток, що вимушене kdesrc-build перервати рано.

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

ГОЛОВНА
Використовується для розширення імен файлів тильдою і є базовою за замовчуванням для джерела, збірки,
та каталоги встановлення.

PATH
Ця змінна середовища контролює шлях пошуку за замовчуванням для виконуваних файлів. Ти можеш
використовувати binpath параметр файлу конфігурації, який можна додати до цієї змінної (наприклад, для запуску
від крон(8)).

LC_*
Змінні середовища, починаючи з LC_, контролюють локаль, яка використовується kdesrc-build.
хоча kdesrc-build на даний момент все ще не локалізується, багато хто з команд ним
використання є. kdesrc-build зазвичай встановлюється LC_ALL=C для команд, які необхідно перевірити
виведення, але ви також можете зробити це вручну. Якщо налаштування LC_ALL=C виправляє a
kdesrc-build проблема, будь ласка, надішліть звіт про помилку.

SSH_AGENT_PID
Цю змінну середовища перевіряють, щоб перевірити чи ssh-agent(1) працює, але тільки якщо
kdesrc-build визначає, що ви перевіряєте модуль, який вимагає входу по SSH
(але ви повинні знати це, оскільки жоден модуль не вимагає цього за замовчуванням).

KDESRC_BUILD_USE_TTY
Якщо встановлено, ця змінна примусить kdesrc-build не закривати його вхід під час виконання
системні процеси. Зазвичай kdesrc-build закриває stdin, оскільки stdout і stderr для
його дочірні процеси перенаправляються, і тому користувач ніколи не побачить вхідних даних
все одно підкажіть.

KDESRC_BUILD_DUMP_CONTEXT
Якщо встановлено, ця змінна друкує опис свого "контексту побудови" відразу після цього
читання параметрів і аргументів командного рядка та визначення модулів для створення. ти
майже ніколи не хочу встановлювати це.

інші
Багато програм використовуються kdesrc-build в ході його виконання, в т.ч
svn(1) мерзотник(1) зробити(1), і cmake(1). Кожна з цих програм може мати свої власні
відповідь на змінні середовища, що встановлюються. kdesrc-build пройде середовище
змінні, які встановлюються під час виконання цих процесів. Ви можете переконатися в певному
змінні середовища (напр CC or CXX) встановлюються за допомогою set-env конфігурація
параметр файлу.

Використовуйте kdesrc-build онлайн за допомогою служб onworks.net