Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
uname(1)			 User Commands			      uname(1)

       uname - print name of current system

       uname [-aimnprsvX]

       uname [-S system_name]

       The  uname  utility  prints information about the current system	on the
       standard	output.	When options are specified, symbols  representing  one
       or  more	system characteristics will be written to the standard output.
       If no options are specified, uname prints the  current  operating  sys-
       tem's  name.  The  options  print  selected information returned	by un-
       ame(2), sysinfo(2), or both.

       The following options are supported:

       -a	       Prints basic information	currently available  from  the

       -i	       Prints the name of the platform.

       -m	       Prints  the  machine hardware name (class). Use of this
		       option is discouraged. Use uname	-p instead. See	 NOTES
		       section below.

       -n	       Prints  the nodename (the nodename is the name by which
		       the system is known to a	communications network).

       -p	       Prints the current host's ISA or	processor type.

       -r	       Prints the operating system release level.

       -s	       Prints the name of the operating	system.	 This  is  the

       -S system_name  The nodename may	be changed by specifying a system name
		       argument. The system name  argument  is	restricted  to
		       SYS_NMLN	characters. SYS_NMLN is	an implementation spe-
		       cific value defined in <sys/utsname.h>. Only the	super-
		       user  is	 allowed this capability. This change does not
		       persist across reboots of the  system.  Use  sys-uncon-
		       fig(1M) to change a host's name permanently.

       -v	       Prints the operating system version.

       -X	       Prints expanded system information, one information el-
		       ement per line, as expected by SCO UNIX.	The  displayed
		       information includes:

			 o  system  name, node,	release, version, machine, and
			    number of CPUs.

			 o  BusType, Serial, and Users (set  to	 "unknown"  in

			 o  OEM# and Origin# (set to 0 and 1, respectively)

       Example 1: Printing the OS name and release level

       The following command:

       example%	uname -sr

       prints  the  operating  system name and release level, separated	by one
       <SPACE> character.

       See environ(5) for descriptions of the following	environment  variables
       that  affect  the  execution  of	uname: LANG, LC_ALL, LC_CTYPE, LC_MES-
       SAGES, and NLSPATH.

       SYSV3	This variable is used to override the default behavior of  un-
		ame.  This  is necessary to make it possible for some INTERAC-
		TIVE UNIX Systems and SCO UNIX programs	and  scripts  to  work
		properly.  Many	 scripts use uname to determine	the SYSV3 type
		or the version of the OS to ensure software is compatible with
		that  OS.  Setting  SYSV3  to  an empty	string will make uname
		print the following default values:

		nodename nodename 3.2 2	i386

		The individual elements	that uname displays can	also be	 modi-
		fied by	setting	SYSV3 in the following format:


		os		Operating system (IUS or SCO).

		sysname		System name.

		node		Nodename as displayed by the -n	option.

		rel		Release	level as displayed by the -r option.

		ver		Version	number as displayed by the -v option.

		mach		Machine	name as	displayed by -m	option.

		Do  not	 put  spaces  between  the elements.  If an element is
		omitted, the current system value will be used.

       The following exit values are returned:

       0	Successful completion.

       >0	An error occurred.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWcsu			   |
       |Interface Stability	     |Standard			   |

       arch(1),	 isalist(1),  sys-unconfig(1M),	 sysinfo(2),  uname(2),	 node-
       name(4),	attributes(5), environ(5), standards(5)

       Independent  software  vendors  (ISVs) and others who need to determine
       detailed	characteristics	of the platform	on which their software	is ei-
       ther being installed or executed	should use the uname command.

       To  determine  the  operating  system name and release level, use uname
       -sr. To determine only the operating system release  level,  use	 uname
       -r.  Notice  that operating system release levels are not guaranteed to
       be in x.y format	(such as 5.3, 5.4, 5.5,	and so forth); future releases
       could  be  in  the  x.y.z  format  (such	as 5.3.1, 5.3.2, 5.4.1,	and so

       In SunOS	4.x releases, the arch(1) command was often used to obtain in-
       formation  similar  to  that  obtained  by using	the uname command. The
       arch(1) command output "sun4" was often incorrectly interpreted to sig-
       nify  a	SunOS  SPARC  system.  If hardware platform information	is de-
       sired, use uname	-sp.

       The arch	-k and uname -m	commands return	 equivalent  values;  however,
       the use of either of these commands by third party programs is discour-
       aged, as	is the use of the arch command in general.  To	determine  the
       machine's Instruction Set Architecture (ISA or processor	type), use un-
       ame with	the -p option.

SunOS 5.10			  17 Sep 2003			      uname(1)


Want to link to this manual page? Use this URL:

home | help