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




fs_sysname(1), livesys(1)

The OpenAFS Quick Start Guides at

The OpenAFS Administration Guide at


IBM Corporation 2000. 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.


"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.