ОПИС
layman є сценарій, що дозволяє вам додавати, видаляти і оновлювати оверлеї Gentoo з найрізноманітніших джерел.
ВАЖЛИВО
За допомогою layman легко підключати та оновлювати оверлеї Gentoo - але, на жаль, не складніше і ЗЛАМАТИ вашу систему.
У головному дереві портежей містяться ебілди, за якість яких Gentoo відповідає, оскільки вони все підтримуються розробниками проекту. Але більшість оверлеїв, які ви можете підключити за допомогою layman. не дають таких гарантій, тому, використовуючи їх, ви піддаєте свою систему небезпеки. Завжди пам'ятайте про це, встановлюючи сторонні ебілди.
Щоб забезпечити безпеку системи, вам ОБОВ'ЯЗКОВО слід ознайомитися з ебілдом, перш ніж його встановлювати.
ОПЦИИ
дії
Нижче перераховані доступні дії layman.
Завантажує віддалений список оверлеїв. Як правило, вам НЕ потрібно явно вказувати цю опцію: завантаження буде проведена автоматично при запуску дій sync, sync-all або list. Щоб відмовитися від автоматичного завантаження, використовуйте опцію --nofetch.
Додає вказаний оверлей з кешованого віддаленого списку до ваших локально встановленим оверлеїв. Щоб додати всі оверлеї зі списку, використовуйте параметр "ALL".
Видаляє зазначений оверлей з числа встановлених локально у вашій системі. Щоб видалити всі оверлеї, використовуйте параметр "ALL".
Оновлює вказаний оверлей. Щоб синхронізувати всі оверлеї, використовуйте параметр "ALL".
Виводить всю доступну інформацію за вказаною Оверлей.
Оновлює все оверлеї. Аліас для -s ALL.
Виводить вміст віддаленого списку оверлеїв.
Виводить список оверлеїв, встановлених локально.
інші опції
Нижче перераховані інші опції layman.
Встановлює шлях доступу до альтернативного конфігураційного файлу.
Не дозволяє layman автоматично завантажувати списки віддалених оверлеїв. За замовчуванням layman при кожній дії sync, list або fetch завантажує все віддалено розміщені списки.
Не дозволяє layman перевіряти вилучені списки оверлеїв на наявність повного опису. За замовчуванням layman відхиляє оверлеї, для яких немає опису або контактної інформації.
Повністю відключає виведення повідомлень в ході роботи layman. У такому "тихому" режимі дочірні процеси запускаються з відключеним стандартним введенням даних, щоб уникнути нескінченних інтерактивних сеансів; таким чином, дочірній процес може бути перерваний у будь-якій ситуації, що вимагає явних дій користувача. Це може статися, наприклад, якщо у вас оверлей на сервері Subversion і сертифікат SSL вимагає підтвердження вручну.
Задає для layman докладний висновок: вам буде надана інформація про накладення, які ви можете завантажити.
Скасовує кольоровий висновок для layman.
Задає для layman компактний висновок. Допустимі значення рівня лежать в інтервалі від 0 до 4, причому 0 відповідає повного відключення інформаційних повідомлень. При рівні нижче 3 справедливі ті ж обмеження, що для опції --quiet.
Використовуйте цю опцію в зв'язці з --add. Вона дозволяє змінити пріоритет доданого оверлею і тим самим впливає на порядок записів файлу make.conf. Чим нижче виставлений рівень, тим раніше запис з'явиться в списку. Допустимий інтервал значень - від 0 до 100. За умовчанням значення приймається рівним 50.
НАЛАШТУВАННЯ
За замовчуванням layman зчитує параметри конфігурації з файлу /etc/layman/layman.cfg. Всього можуть бути налаштовані сім параметрів.
Каталог, який буде використаний для зберігання оверлеїв і всіх додаткових даних, необхідних layman. За замовчуванням це / var / lib / layman. layman зберігає свої дані не в / var, а в підкаталогах / usr / portage. Було прийнято рішення реалізувати підтримку мережевих файлових систем. Якщо дерево портежей у вас на nfs або подібної файлової системи, і до одного репозитарій ебілдов по мережі мають доступ кілька машин, потрібно також зберігати всі необхідні layman дані в дереві. Отже, і синхронізація оверлеїв повинна відбуватися в одному місці.
Тут layman зберігає завантажений глобальний список оверлеїв. Каталог за замовчуванням -% (storage) s / cache.xml.
Тут layman зберігає список встановлених оверлеїв. Каталог за замовчуванням -% (storage) s / overlays.xml.
Якщо вам необхідно використовувати проксі-сервер, вкажіть його тут.
Встановіть значення "yes", якщо слід заборонити layman відстежувати оверлеї, що не мають контактної інформації або опису.
РОБОТА З оверлеїв
Утиліта layman покликана забезпечити зручність супроводу оверлеїв Gentoo без додаткової настройки.
списки оверлеїв
Крім того, layman допускає визначення в цьому списку локальних файлів. Переконайтеся, що шляхи доступу до них мають стандартний для URL префікс file: //.
Якщо для доступу в Інтернет вам потрібен проксі-сервер, ви можете скористатися відповідної змінної в файлі конфігурації layman. Layman також бере до уваги значення змінної оточення http_proxy. якщо воно визначено.
локальний кеш
layman зберігає локальну копію завантаженого віддаленого списку. За умовчанням вона поміщається в файл /var/lib/layman/cache.xml. Цей файл існує тільки в одному екземплярі і перезаписується кожен раз, коли ви запускаєте layman.
Обробка файлу /etc/make.conf
Оскільки layman покликаний автоматично включати оверлеї в вашу систему, йому повинно бути доступна зміна змінної PORTDIR_OVERLAY в файлі /etc/make.conf. Але саме /etc/make.conf є основним конфігураційним файлом Gentoo, життєво важливим для нормально функціонування системи, і його автоматичне зміна була б небезпечно. Проте ви можете дозволити це layman. встановивши /etc/make.conf значенням змінної make_conf в файлі конфігурації.
Стандартні настройки layman містяться в файлі /var/lib/layman/make.conf. Якщо ви хочете зберігати їх в іншому місці, змініть ім'я цього файлу.
При першому зверненні файл може не існувати. В цьому випадку layman сам створить його.
Немає необхідності видаляти стандартну змінну PORTDIR_OVERLAY з файлу make.conf. У міру необхідності layman буде додавати нові оверлеї до існуючого значенням, так що всі ваші колишні записи збережуться.
Додавання, видалення та оновлення оверлеїв
Після завантаження віддаленого списку layman робить можливим додавання оверлеїв з цього списку в вашу систему. Буде зроблена спроба завантажити оверлей. Якщо завантаження пройшла успішно, інформація про оверлее буде скопійована з кешу в список локально встановлених оверлеїв. Крім того, layman при цьому змінить значення змінної PORTDIR_OVERLAY таким чином, щоб воно включало нові шляхи доступу до оверлеїв.
Видалення оверлеїв layman виробляє повністю, не залишаючи ніякого сміття.
Щоб оновити всі оверлеї під керуванням layman. ви можете запустити його з опцією --sync ALL або включивши --sync-all.
Виведення списку оверлеїв
Щоб вивести список доступних або встановлених оверлеїв, запустіть layman з опціями --list або --list-local відповідно.
Перед ім'ям кожного повністю підтримуваного оверлею в списку буде стояти зелений Астеріск, а перед ім'ям оверлею, який вам не вдасться використовувати, оскільки ви не маєте необхідним функціоналом - червоний Астеріск.
За замовчуванням layman відображає тільки повністю підтримувані оверлеї, опускаючи інші. Крім того, починаючи з версії 1.0.7 layman виводить попередження про накладення з порожнім полем опису або без контактної інформації; якщо ви віддаєте перевагу поведінку layman, запропоноване в ранніх версіях, використовуйте прапор опції k або виставте опцію nocheck в файлі конфігурації.
Пошук ебілдов в оверлеїв
типи оверлеїв
В даний час layman підтримує оверлеї, що експортуються через rsync. subversion. bzr. darcs. git. mercurial або поширювані у вигляді tar-пакет.
СПИСКИ оверлеїв
Формат списку оверлеїв
layman використовує централізований список оверлеїв в форматі XML. Цей файл виглядає наступним чином:
Локальне додавання оверлею
Просто створіть список оверлеїв в форматі, описаному вище, і запустіть layman з ключем -o. Перед локальним URL файлу слід поставити file: //.
Глобальне додавання оверлею
Всі розробники Gentoo мають доступ до цього сховища через CVS і можуть змінювати склад пропонованих оверлеїв.
Приклади
встановити оверлей
До вашого списку встановлених оверлеїв буде додано оверлей wrobel.
Синхронізувати ваші оверлеї
Все оверлеї будуть оновлені.
Виконати ряд дій
layman -f -a wrobel -a webapps-experimental
Буде отримано віддалений список оверлеїв і, негайно після цього, додані два зазначених оверлею.
ФАЙЛИ
Конфігураційний файл, що містить настройки за замовчуванням для layman