livesys - Reports the configured CPU/operating system type
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 IBM
AFS Quick Beginnings and IBM AFS 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
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.
The machine’s system type appears as a text string:
The following example shows the output produced on a Linux system with
a 2.6 kernel:
IBM AFS Quick Beginnings
IBM AFS Administration Guide
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
Copyright 2005 Russ Allbery <firstname.lastname@example.org>
This documentation is covered by the IBM Public License Version 1.0.
It was written by Russ Allbery based on the sys man page.