Руководство FreeBSD для разработчиков | ||
---|---|---|
Пред. | Глава 5. Рекомендации и требования к исходному коду | След. |
Иногда может быть необходимо включить некоторый нежелательный для нас файл в дерево исходных текстов FreeBSD. Например, если устройство требует загрузки в него некоторого маленького двоичного кода перед тем, как устройство заработает, и мы не имеем исходных текстов этого кода, то говорится, что двоичный файл является нежелательным. Для включения нежелательных файлов в дерево исходных текстов FreeBSD имеются следующие соглашения.
Любой файл, интерпретируемый или выполняемый системным(и) CPU, не в форме исходного кода, является нежелательным.
Любой файл с лицензией, ограничивающей более, чем BSD или GNU, является нежелательным.
Файл, содержащий загружаемые двоичные данные, используемые аппаратным обеспечением, не являются нежелательными, если только к нему не применимы условия (1) или (2). Он должен быть сохранен в нейтральном к архитектуре формате ASCII (рекомендуется применить утилиты file2c или uuencode).
Любой нежелательный файл требует особого одобрения со стороны Правления до того, как он будет добавлен в хранилище CVS.
Нежелательные файлы помещаются в каталог src/contrib или src/sys/contrib.
Части одного модуля должны храниться вместе. Нет необходимости разбивать их, если только нет совместного использования с кодом, не являющимся нежелательным.
Объектные файлы именуются arch/filename.o.uu>.
Файлы ядра;
Должны всегда упоминаться в conf/files.* (для упрощения построения).
Должны всегда присутствовать в LINT, но Правление решает в каждом конкретном случае, должны ли они быть раскомментированы или нет. Конечно, позже Правление может изменить свое решение.
Вопрос о вхождении в состав релиза решается Группой Выпусков Релизов.
Файлы уровня пользователя:
Правление решает, должен ли код стать частью выполнения команды make world.
Релиз инженер решает, войдут ли они в релиз.
Пред. | Начало | След. |
Программное обеспечение сторонних производителей | Уровень выше | Динамические библиотеки |
Этот, и другие документы, могут быть скачаны с ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.
По вопросам, связанным с FreeBSD, прочитайте документацию прежде чем писать в <questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите <doc@FreeBSD.org>.
По вопросам, связанным с русским переводом документации, пишите в рассылку <frdp@FreeBSD.org.ua>.
Информация по подписке на эту рассылку находится на сайте проекта перевода.