4d25105e41
EVR: 3.7.9-2 Lock-SHA256: b30df30538b14ddd335b1d9e982d64c2b0b7c7e811e6e6cd95f534773c25fd6d Branch: niceos-5.2 |
||
|---|---|---|
| METADATA | ||
| SBOM | ||
| SOURCES | ||
| SPECS | ||
| .gitignore | ||
| OWNERS | ||
| README.md | ||
libarchive
English
Overview
libarchive is a C library for reading and writing archive files and related streaming formats. The upstream project also ships command-line tools such as bsdtar and bsdcpio that use the library. (libarchive.org)
Purpose and typical use cases
The package is used to process archive data in software that needs to list, extract, create, or convert archive contents. Typical use cases include:
- archive handling in system tools and packaging workflows
- integration into applications that need archive read/write support
- command-line archive operations through the upstream tools shipped with the project
- automated verification and regression testing of archive-processing behavior in build and CI environments (libarchive.org)
Typical users include system administrators, developers, CI/CD maintainers, and security or release engineering teams that need a reusable archive library in a Linux distribution. That role should be understood as packaging and integration support; NiceOS maintainers should verify any distribution-specific assumptions before relying on them.
Upstream project
The upstream project describes libarchive as a portable archive library with documentation, release materials, and source code published through its official web site and GitHub repository. The project site is the preferred reference for upstream documentation and release information. (libarchive.org)
Official upstream links:
Dist-git repository contents
This NiceOS dist-git repository contains the packaging sources for the RPM, not the full upstream source tree. The expected layout is:
SPECS/— RPM spec files and packaging logicSOURCES/— source metadata and manifest files used by the packaging workflowMETADATA/— repository metadata used by NiceOS toolingSBOM/— software bill of materials material, if generated for this package
The repository may also contain auxiliary packaging files required by NiceOS automation. Large upstream source archives are intentionally not stored in this Git repository.
Source storage and integrity policy
NiceOS stores source integrity information in manifest files under SOURCES/. The upstream source payload is fetched or staged by the build workflow, while the Git repository retains the metadata needed to identify and verify the source set. This README does not print file-specific checksums or other mutable digest values.
Maintainers should verify that:
- the manifest file set matches the intended upstream source set
- the referenced upstream release artifacts still correspond to the package being updated
- any locally maintained patches remain applicable
- the packaging metadata still matches the current upstream build system and file layout
NiceOS maintenance notes
Before updating this package, NiceOS maintainers should check:
- upstream release notes and changelog entries for packaging-impacting changes
- whether the spec file needs file list, build option, or dependency updates
- whether
SOURCES/manifests need regeneration after a source refresh - whether
SBOM/content, if present, needs regeneration or review - whether any downstream patches can be dropped, refreshed, or must be kept
- whether tests or validation steps used by NiceOS need adjustment after upstream changes
Risks to consider include format support changes, API or ABI changes, build system changes, and changes to installed command-line behavior. If any of these are unclear from upstream materials, NiceOS maintainers should verify them before committing an update.
Build and verification checklist
Use this checklist for RPM maintenance work:
- confirm the upstream source reference in
SOURCES/ - review the spec for build-time options and package split rules
- ensure the package still builds in the target NiceOS build environment
- run the package test suite if it is enabled by the spec or downstream policy
- verify that installed files match the expected package contents
- check that license and documentation files are packaged correctly
- review generated metadata, including
SBOM/if the repository uses it - inspect build logs for warnings, failures, or unexpected feature changes
- confirm that no unintended source files were added to the Git repository
References
Русский
Обзор
libarchive — это библиотека на C для чтения и записи архивных файлов и связанных потоковых форматов. В upstream-проекте также поставляются командные утилиты bsdtar и bsdcpio, использующие эту библиотеку. (libarchive.org)
Назначение и типовые сценарии использования
Пакет используется для обработки архивных данных в программном обеспечении, которому требуется просмотр, извлечение, создание или преобразование архивов. Типовые сценарии:
- работа с архивами в системных утилитах и пакетных рабочих процессах
- подключение библиотеки в приложениях, которым нужен доступ к архивам на чтение и запись
- использование командных утилит upstream-проекта для архивных операций
- автоматическая проверка и регрессионное тестирование логики обработки архивов в сборочных и CI/CD-средах (libarchive.org)
Типичные пользователи: системные администраторы, разработчики, сопровождающие CI/CD и специалисты по безопасности или выпуску, которым нужна повторно используемая библиотека для работы с архивами в Linux-дистрибутиве. Эту роль следует понимать как поддержку упаковки и интеграции; при наличии дистрибутивных предположений их нужно отдельно проверить.
Upstream-проект
Upstream-проект описывает libarchive как переносимую библиотеку для работы с архивами с документацией, материалами релизов и исходным кодом, опубликованными на официальном сайте и в репозитории GitHub. Официальный сайт следует использовать как основной источник по документации и релизной информации upstream-проекта. (libarchive.org)
Официальные ссылки upstream:
Содержимое dist-git репозитория
Этот dist-git-репозиторий NiceOS содержит упаковочные материалы для RPM, а не полный upstream source tree. Ожидаемая структура:
SPECS/— spec-файлы RPM и логика упаковкиSOURCES/— метаданные исходников и manifest-файлы, используемые процессом сборкиMETADATA/— метаданные репозитория, используемые инструментами NiceOSSBOM/— материалы software bill of materials, если они формируются для этого пакета
В репозитории также могут находиться вспомогательные файлы, требуемые автоматизацией NiceOS. Крупные upstream-архивы исходного кода намеренно не хранятся в этом Git-репозитории.
Политика хранения исходных файлов и контроля целостности
NiceOS хранит сведения о целостности исходников в manifest-файлах внутри SOURCES/. Полезная нагрузка upstream-исходников загружается или подготавливается рабочим процессом сборки, а Git-репозиторий содержит только метаданные, нужные для идентификации и проверки набора исходников. В этом README не приводятся контрольные суммы и другие изменяемые значения хэшей.
Сопровождающим следует проверить:
- что набор manifest-файлов соответствует ожидаемому набору upstream-исходников
- что ссылки на upstream-релизные артефакты действительно относятся к обновляемому пакету
- что локальные патчи по-прежнему применимы
- что метаданные упаковки соответствуют текущей системе сборки upstream и структуре файлов
Замечания по сопровождению в НАЙС.ОС
Перед обновлением пакета сопровождающим NiceOS следует проверить:
- заметки о релизе upstream и записи changelog на предмет изменений, влияющих на упаковку
- требуется ли обновление списков файлов, параметров сборки или зависимостей в spec-файле
- требуется ли регенерация manifest-файлов в
SOURCES/после обновления исходников - требуется ли регенерация или проверка содержимого
SBOM/, если оно используется - можно ли удалить, обновить или оставить downstream-патчи
- нужно ли корректировать тесты или процедуры валидации, используемые в NiceOS
К возможным рискам относятся изменения поддержки форматов, изменения API или ABI, изменения системы сборки и изменения поведения устанавливаемых командных утилит. Если по материалам upstream это неясно, перед фиксацией обновления следует выполнить дополнительную проверку.
Контрольный список сборки и проверки
Рекомендуемый контрольный список для сопровождения RPM:
- проверить ссылку на upstream-исходники в
SOURCES/ - просмотреть spec-файл на предмет параметров сборки и правил разделения пакетов
- убедиться, что пакет собирается в целевой среде NiceOS
- запустить набор тестов пакета, если он включён spec-файлом или политикой downstream
- проверить, что установленные файлы соответствуют ожидаемому содержимому пакета
- убедиться, что файлы лицензии и документации упакованы корректно
- проверить сгенерированные метаданные, включая
SBOM/, если они используются - просмотреть журналы сборки на наличие предупреждений, ошибок и неожиданных изменений возможностей
- убедиться, что в Git-репозиторий не были добавлены лишние исходные файлы
Ссылки
Dist-git repository notes
- Package repository:
rpms/libarchive - NiceOS branch:
niceos-5.2 - This README is intentionally stable and does not include EVR, source archive checksums or lock hashes.