NOME¶

uname - restituisce nome e informazioni sul kernel attuale

SINTASSI¶

#include <sys/utsname.h>

int uname(struct utsname *buf);

DESCRIZIONE¶

uname() restituisce informazione sul sistema attraverso il puntatore buf. La struttura utsname è definita in <sys/utsname.h>:

struct utsname {


    char sysname[];


    char nodename[];


    char release[];


    char version[];


    char machine[];
#ifdef _GNU_SOURCE


    char domainname[];
#endif
};

La lunghezza degli array in una struttura utsname non è specificata; i campi sono terminati con un byte nullo ('\0').

VALORE RESTITUITO¶

In caso di esito positivo viene restituito zero, altrimenti -1 e errno viene impostato di conseguenza.

ERRORI¶

EFAULT

buf non è valido.

CONFORME A¶

SVr4, POSIX.1-2001. Non c'è alcuna chiamata a uname() in 4.3BSD.

Il membro domainname (il nome di dominio NIS o YP) è un'estensione GNU.

NOTE¶

Questa è una chiamata di sistema, e si presume che il sistema operativo sappia il suo nome, rilascio e versione. Essa inoltre sa su quale hardware funziona. Quindi quattro dei campi della struttura sono significativi. D'altra parte il campo nodename è insignificante: esso dà il nome della macchina presente in qualche rete indefinita, ma tipicamente le macchine si trovano in più di una rete e hanno più nomi. Inoltre il kernel non ha modo di sapere queste cose, quindi bisogna dirgli cosa rispondere. Lo stesso vale per il campo aggiuntivo domainname.

A questo scopo Linux usa le chiamate di sistema sethostname(2) e setdomainname(2). Notare che non c'è alcuno standard che dice che il nome host impostato da sethostname(2) è la stessa stringa del campo nodename della struttura restituita da uname() (in verità, alcuni sistemi permettono un nome host di 256 byte e un nome nodo di 8 byte), ma ciò è vero in Linux. Lo stesso vale per setdomainname(2) e per il campo domainname.

La lunghezza dei campi nella struttura varia. Alcuni sistemi operativi o librerie usano un valore prefissato 9 o 33 o 65 o 257. Altri sistemi usano SYS_NMLN o _SYS_NMLN o UTSLEN o _UTSNAME_LENGTH. E' chiaramente una pessima idea usare una qualunque di queste costanti; si usi solo sizeof(...). Spesso è scelto 257 per avere spazio per un nome di host internet.

Parte dell'informazione utsname è anche accessibile attraverso sysctl(2) e attraverso /proc/sys/kernel/{ostype, hostname, osrelease, version, domainname}.

VEDERE ANCHE¶

uname(1), getdomainname(2), gethostname(2)