UNAME(2)

ИМЯ
uname - получить имя и информацию о текущем ядре

ОБЗОР
#include <sys/utsname.h>

int uname(struct utsname *buf);

ОПИСАНИЕ
uname возвращает системную информацию в структуре, на которую указывает buf. Структура utsname определяется в <sys/utsname.h>:
    struct utsname {
    char sysname[];
    char nodename[];
    char release[];
    char version[];
    char machine[];
    #ifdef _GNU_SOURCE
    char domainname[];
    #endif
    };
Длина массива в struct utsname не задаётся; поля завершаются нулевым символом.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
В случае успеха возвращается ноль. В случае ошибки возвращается -1 и значение errno устанавливается соответствующим образом.

ОШИБКИ

EFAULT
    Неправильное значение buf .

СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, SVID, POSIX, X/OPEN. В BSD 4.3 вызова uname не существует.

Имя домена domainname для члена домена (домена NIS или YP) является расширением GNU.

ЗАМЕЧАНИЯ
Это системный вызов и операционная система видимо знает своё имя, подверсию и версию. Она также знает на какой платформе она запущена. Таким образом четыре поля, описанной выше структуры являются важными. С другой стороны, поле nodename является менее важным: оно содержит имя текущей машины в какой-либо неопределённой сети, но обычно машины входят более чем в одну сеть и имеют несколько имён. У ядра нет способа узнать об этих вещах, так что ему необходимо сказать, что здесь отвечать. Тоже касается и другого дополнительно поля domainname.

Чтобы подсказать ядру, в Linux используются системные вызовы sethostname(2) и setdomainname(2). Заметим, что не существует стандарта, чтобы сказать имя узла какой длины устанавливается вызовом sethostname(2), но именно это имя будет в поле nodename структуры, возвращаемой вызовом uname (в самом деле, некоторые системы разрешают 256-байтовые имена узлов и только 8-байтовые nodename), но это так в Linux. Это же касается и вызова setdomainname(2) и поля domainname.

Длина указанных выше полей в структуре может быть разной. Некоторые операционные системы или библиотеки используют жёсткие ограничения 9 или 33, или 65, или 257. Другие системы используют SYS_NMLN или _SYS_NMLN, или UTSLEN, или _UTSNAME_LENGTH. Использование таких констант -- это плохая идея -- просто используйте sizeif(...). Часто 257 выбирается, чтобы соответствовать имени узла в сети Интернет.

В Linux было три системных вызова uname(). Первый использовал длину 9, второй использовал 85, а третий также использует 65, но добавляет поле domainname field.

Часть информации, возвращаемой данным системным вызовом также доступна через sysctl и через файлы /proc/sys/kernel/{ostype, hostname, osrelease, version, domainname}.

СМОТРИ ТАКЖЕ
uname(1), getdomainname(2), gethostname(2)

ПЕРЕВОД
Перевёл с английского Виктор Вислобоков <corochoone@perm.ru> 2004