GNUInstallDirs

Определение стандартных каталогов установки GNU

Предоставляет переменные каталогов установки, определённые в Стандартах кодирования GNU.

Переменные результатов

Включение этого модуля определяет следующие переменные:

CMAKE_INSTALL_<dir>

Путь к файлам заданного типа. Это значение может быть передано в параметры DESTINATION команд install() для соответствующего типа файлов.

CMAKE_INSTALL_FULL_<dir>

Абсолютный путь, полученный из соответствующего значения CMAKE_INSTALL_<dir>. Если значение не является абсолютным путем, абсолютный путь обычно строится путем добавления значения переменной CMAKE_INSTALL_PREFIX в качестве префикса. Однако существуют некоторые специальные случаи, как описано ниже.

где <dir> равно:

BINDIR: пользовательские исполняемые файлы (bin)
SBINDIR: исполняемые файлы системного администратора (sbin)
LIBEXECDIR: исполняемые файлы программы (libexec)
SYSCONFDIR: только для чтения данные одной машины (etc)
SHAREDSTATEDIR: модифицируемые архитектурно-независимые данные (com)
LOCALSTATEDIR: модифицируемые данные одной машины (var)
LIBDIR: библиотеки объектного кода (lib или lib64 или lib/<multiarch-tuple> в Debian)
INCLUDEDIR: заголовки файлов C (include)
OLDINCLUDEDIR: заголовки файлов C для не-gcc (/usr/include)
DATAROOTDIR: корень только для чтения архитектурно-независимых данных (share)
DATADIR: только для чтения архитектурно-независимые данные (DATAROOTDIR)
INFODIR: документация info (DATAROOTDIR/info)
LOCALEDIR: языково-зависимые данные (DATAROOTDIR/locale)
MANDIR: документация man (DATAROOTDIR/man)
DOCDIR: корень документации (DATAROOTDIR/doc/PROJECT_NAME)

Если включающий модуль не определяет значение, будет использоваться показанное выше значение по умолчанию, и это значение появится в кэше для редактирования пользователем.

Особые случаи

Следующие значения CMAKE_INSTALL_PREFIX являются особыми:

/

Для <dir> кроме SYSCONFDIR и LOCALSTATEDIR, значение CMAKE_INSTALL_<dir> предваряется usr/, если это не абсолютный путь, указанный пользователем. Например, значение INCLUDEDIR include становится usr/include. Это требуется Стандартами кодирования GNU, которые гласят:

При построении полной системы GNU префикс будет пустым, а /usr будет символической ссылкой на /.

/usr

Для <dir> равного SYSCONFDIR или LOCALSTATEDIR, CMAKE_INSTALL_FULL_<dir> вычисляется путем добавления просто / в начало значения CMAKE_INSTALL_<dir>, если это не абсолютный путь, указанный пользователем. Например, значение SYSCONFDIR etc становится /etc. Это требуется Стандартами кодирования GNU.

/opt/...

Для <dir> равного SYSCONFDIR или LOCALSTATEDIR, CMAKE_INSTALL_FULL_<dir> вычисляется путем присоединения префикса к значению CMAKE_INSTALL_<dir>, если это не абсолютный путь, указанный пользователем. Например, значение SYSCONFDIR etc становится /etc/opt/.... Это определено Стандартом иерархии файловой системы.

© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.5/module/GNUInstallDirs.html