|SYS(1)||AFS Command Reference||SYS(1)|
sys - Reports the compile-time CPU/operating system type
The sys command displays the string set at compile time that indicates the local machine's CPU/operating system (OS) type, conventionally called the sysname. This string is the default for the value stored in kernel memory. The Cache Manager substitutes this string for the @sys variable which can occur in AFS pathnames; the OpenAFS Quick Start Guide and OpenAFS Administration Guide explain how using @sys can simplify cell configuration.
To set a new value in kernel memory, use the fs sysname command. To view the current value set in the kernel, use either fs sysname or livesys.
You almost always want to use livesys rather than this command. The sys command displays a single value hard-coded at compile time. It does not query the Cache Manager for the current value and it does not report sysname lists. If you have changed the local system type with fs sysname, or if you run a version of sys compiled differently than the Cache Manager running on the system, the value returned will not match the behavior of the Cache Manager. The only reason to use sys is that livesys wasn't available in older versions of AFS.
The machine's system type appears as a text string:
The following example shows the output produced on a Sun Netra T1 running Solaris 10:
% sys sun4x_510
The OpenAFS Quick Start Guides at <http://docs.openafs.org/>.
The OpenAFS Administration Guide at <http://docs.openafs.org/AdminGuide/>.
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.