NAME

       livesys - Reports the configured CPU/operating system type

SYNOPSIS

       livesys

DESCRIPTION

       The livesys command displays the string stored in kernel memory that indicates the local
       machine's CPU/operating system (OS) type, conventionally called the sysname.  The Cache
       Manager substitutes this string for the @sys variable which can occur in AFS pathnames;
       the OpenAFS Quick Start Guides 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, which can also be used to
       view the current value.  If a sysname list was set using fs sysname, only the first value
       in the list will be reported by livesys.

CAUTIONS

       To see the full sysname list, use fs sysname rather than this command.  livesys is mostly
       useful for scripts that need to know the primary sysname for the local system (to create
       directories that will later be addressed using @sys, for example).

       livesys first appeared in OpenAFS 1.2.2.  Scripts that need to support older versions of
       AFS should parse the output of fs sysname or use sys.

OUTPUT

       The machine's system type appears as a text string, by itself, on a single line.

EXAMPLES

       The following example shows the output produced on a Linux system with a 2.6 kernel:

          % livesys
          i386_linux26

PRIVILEGE REQUIRED

       None

SEE ALSO

       fs_sysname(1), sys(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.

       Copyright 2005 Russ Allbery <rra@stanford.edu>

       This documentation is covered by the IBM Public License Version 1.0.  It was written by
       Russ Allbery based on the sys man page.