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 system.

       -i    Prints the	name of	the hardware implementation (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 default.

       -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 specific value defined in  <sys/ut-
	     sname.h>.	Only  the  super-user is allowed this capability. This
	     change does not persist across reboots of the system. Use sys-un-
	     config(1M)	to change a host's name	permanently.

       -v    Prints the	operating system version.

       -X    Prints  expanded  system information, one information element per
	     line, as expected by SCO  UNIX.  The  displayed  information  in-

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

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

		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.

       SYSV3 This  variable is used to override	the default behavior of	uname.
	     This is necessary to make it possible for some  INTERACTIVE  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  de-
	     fault values:

	     nodename nodename 3.2 2 i386

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


	      os    Operating system (IUS or SCO).

		    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	 omit-
	      ted, the current system value will be used.

       See  environ(5) for descriptions	of the following environment variables
       that affect the execution of uname: LC_CTYPE, LC_MESSAGES, and NLSPATH.

       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			   |

       arch(1),	 isalist(1),  sys-unconfig(1M),	 sysinfo(2),  uname(2),	 node-
       name(4),	attributes(5), environ (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 desired,
       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.9			  9 Jun	2000			      uname(1)


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

home | help