Майкл Керриск (http://man7.org/mtk/) (Michael Kerrisk) анонсировал (https://www.mail-archive.com/linux-kernel@vger.kernel.o...) версию 4.10 коллекции (https://www.kernel.org/doc/man-pages/) системных руководств (man) для Linux. Более 40 участников внесли свой вклад в процесс подготовки новой версии, было внесено более 600 изменений, охвативших 160 страниц. Эти изменения включают себя, среди прочего, добавление одиннадцати новых страниц и существенную переработку ещё трёх.
Краткий обзор (http://linux-man-pages.blogspot.com/2017/03/man-pages-410-is...) изменений (http://man7.org/linux/man-pages/changelog.html#release_4.10):
- Существенно переработаны и расширены страницы add_key(2) (http://man7.org/linux/man-pages/man2/add_key.2.html), keyctl(2) (http://man7.org/linux/man-pages/man2/keyctl.2.html) и request_key(2) (http://man7.org/linux/man-pages/man2/request_key.2.html), описывающие системные вызовы для работы с подсистемой (https://www.kernel.org/doc/Documentation/security/keys.txt) хранения криптографических ключей;
- При содействии Дэвида Хоуэллса, разработчика подсистемы хранения криптографических ключей и библиотеки libkeyutils (https://git.kernel.org/pub/scm/linux/kernel/git/dhowells/key.../), ряд страниц руководства был перенесён в проект man-pages, так как они описывают интерфейсы ядра keyrings(7) (http://man7.org/linux/man-pages/man7/keyrings.7.html), persistent-keyring(7) (http://man7.org/linux/man-pages/man7/persistent-keyring.7.html), process-keyring(7) (http://man7.org/linux/man-pages/man7/process-keyring.7.html), session-keyring(7) (http://man7.org/linux/man-pages/man7/session-keyring.7.html), thread-keyring(7) (http://man7.org/linux/man-pages/man7/thread-keyring.7.html), user-keyring(7) (http://man7.org/linux/man-pages/man7/user-keyring.7.html), user-session-keyring(7) (http://man7.org/linux/man-pages/man7/user-session-keyring.7....). Многие из них были обновлены и дополнены в процессе переноса;
- Добавлена страница ioctl_iflags(2) (http://man7.org/linux/man-pages/man2/ioctl_iflags.2.html), которая описывает флаги inode (атрибуты, которыми позволяет манипулировать команда chattr(1) (http://man7.org/linux/man-pages/man1/chattr.1.html)) и команда ioctl(2) (http://man7.org/linux/man-pages/man2/ioctl.2.html) для работы с этими флагами;
- Детали команд ioctl(2) (http://man7.org/linux/man-pages/man2/ioctl.2.html) для работы с пространствами имён объектов (namespaces) вынесены из namespaces(7) (http://man7.org/linux/man-pages/man7/namespaces.7.html) в отдельную страницу ioctl_ns(2) (http://man7.org/linux/man-pages/man2/ioctl_ns.2.html);
- Добавлена страница getentropy(3) (http://man7.org/linux/man-pages/man3/getentropy.3.html), описывающая одноимённую библиотечную функцию, добавленную (https://sourceware.org/bugzilla/show_bug.cgi?id=17252) в glibc 2.25;
- Описание использования функций, которые можно вызывать из обработчика сигнала, перенесено из signal(7) (http://man7.org/linux/man-pages/man7/signal.7.html) в отдельную страницу signal-safety(7) (http://man7.org/linux/man-pages/man7/signal-safety.7.html). В процессе также были добавлены некоторые детали, такие как отличия glibc от того, что указано в POSIX.
URL: https://www.mail-archive.com/linux-kernel@vger.kernel.o...
Новость: http://www.opennet.dev/opennews/art.shtml?num=46219