SYS(1)							       AFS Command Reference							    SYS(1)

NAME

       sys - Reports the compile-time CPU/operating system type

SYNOPSIS

       sys

DESCRIPTION

       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.

CAUTIONS

       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.

OUTPUT

       The machine's system type appears as a text string:

	  I<system_type>

EXAMPLES

       The following example shows the output produced on a Sun SPARCStation running Solaris 5.7:

	  % sys
	  sun4x_57

PRIVILEGE REQUIRED

       None

SEE ALSO

       fs_sysname(1), livesys(1)

       The OpenAFS Quick Start Guides at <http://docs.openafs.org/>.

       The OpenAFS Administration Guide at <http://docs.openafs.org/AdminGuide/>.

COPYRIGHT

       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.

OpenAFS 							    2012-03-26								    SYS(1)