Etercifs/devel

Порядок разработки etercifs

Репозиторий cifs-2.6

Назначение: из него собираются пакеты с исходниками etercifs для всех поддерживаемых ядер.

Адрес: http://git.etersoft.ru/people/piastry/packages/cifs-2.6.git (

Осторожно, большой объем!

).

Ветки и их назначение:

master - обновляется из git://git.kernel.org/pub/scm/linux/kernel/git/sfrench/cifs-2.6.git и содержит исходные версии ядер 2.6.xx (но не 2.6.xx.y) и 3.x.

v2.6.xx-etercifs (например v2.6.32-etercifs) - содержит исходники с нашими патчами.

Текущие бранчи:

Актуальные ветки, для поддерживаемых ядер:

legacy-etercifs

legacy-centos52-etercifs

...

legacy-centos56-etercifs

legacy-centos60-etercifs

v2.6.16-etercifs (legacy для SUSE)

v2.6.23-etercifs

...

v2.6.39-etercifs

v3.0-etercifs

...

v3.19-etercifs

Актуальные ветки с нашими патчами:

etersoft-common

etersoft-share-flags

etersoft-wine

Ветки vx.x.xx-etercifs регулярно обновляются из стабильных веток ядра вида stable/linux-x.x.y (если, конечно, изменения затрагивали содержимое папки fs/cifs).

Репозиторий etercifs

Назначение: из него собирается пакет etercifs со скриптами сборки и запуска сервиса, c исходниками для старых ядер (предположительно для 2.6.18-2.6.22) и исходниками для новых ядер.

Адрес: http://git.etersoft.ru/people/piastry/packages/etercifs.git

Рабочая ветка одна - master.

Содержимое:

- Папка sources/legacy содержит исходники модуля для старых ядер. Для каждой версии ядра с 18 по 22 создается симлинк вида kernel-source-etercifs-2.6.18-1.50c.tar.bz2, который указывает на legacy-исходники.

- Папки sources/centosxx содержит исходники модуля для CentOS x.x ядер.

- Папки sources/x.x.xx содержит исходники модуля для новых ядер.

Папка etercifs содержит скрипты, которые попадают в пакет etercifs:

- etercifs и etercifs.outformat - заготовки для rc-скриптов.

- buildmodule.sh - скрипт для сборки.

- functions.sh - функции для buildmodule.sh.

- etermount - скрипт для удобного монтирования шары.

Алгоритм сборки модуля etercifs (кратко):

1. Определяем, какая версия ядра.

2. Определяем, в зависимости от дистрибутива, место, где лежат исходники ядра.

3. Из исходников etercifs выбираем самый последний (по версии cifs и релизу), соответствующий текущему ядру.

4. Создаем временную директорию, распаковываем в неё исходники etercifs.

5. Собираем модуль ядра.

Алгоритм добавления новых версий ядра Linux (версия на английском)

1. Скачиваем изменения из основной ветки ядра (http://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git) в git репозитории cifs-2.6.

2. Обновляем ветки etersoft-* путем "git merge vX.x". В случае возникновения конфликтов, разрешаем их и делаем результирующий коммит. Убеждаемся в корректности компиляции модуля из каждой ветки etersoft-*.

3. Создаем новую ветку vX.x-etercifs, куда по очереди проводим слияние веток etersoft-*.

4. Создаем новую папку source/X.x/ в git репозитории etercifs и переносим туда получившиеся исходники модуля для нового ядра.

5. Добавляем правила в .gear/rules по аналогии с существующими записями. Версию модуля берем из файла cifsfs.h исходников.

6. Обновляем файлы AUTHORS, TODO, CHANGES в директории etercifs/ из cifs-2.6/Documentation/filesystems/cifs/.

7. Добавляем информацию о новом ядре в etercifs.spec по аналогии с существующими записями.

Алгоритм сборки пакета etercifs

Требуются репозитории etersoft-build-utils и korinf.

1. Добавляем исходники для новых ядер (как сказано выше).

2. Проверяем наличие обновлений модуля в стабильных ветках (уже добавленных в etercifs), сливаем их с нашими ветками вида vX.x-etercifs в репозитории cifs-2.6 и заменяем в репозитории etercifs старые исходники в каталогах соответствующих версий ядра новыми.

3. Меняем версию в etercifs.spec, генерируем changelog и делаем gear-commit.

4. Публикуем srcrpm: [путь до etersoft-build-utils]/bin/rpmpub [версия, например "5.4.11"] etercifs.spec.

5. Собираем для всех систем: [путь до korinf]/bin-cifs/etercifs.sh all [версия, например "5.4.11"].