Manpages

ИМЯ

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 [AT] perm.ru> 2004