1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="livesys1">
4 <refentrytitle>livesys</refentrytitle>
5 <manvolnum>1</manvolnum>
8 <refname>livesys</refname>
9 <refpurpose>Reports the configured CPU/operating system type</refpurpose>
12 <title>Synopsis</title>
13 <para><emphasis role="bold">livesys</emphasis></para>
17 <title>Description</title>
18 <para>The <emphasis role="bold">livesys</emphasis> command displays the string stored in kernel memory that
19 indicates the local machine's CPU/operating system (OS) type,
20 conventionally called the <emphasis>sysname</emphasis>. The Cache Manager substitutes this
21 string for the <emphasis>@sys</emphasis> variable which can occur in AFS pathnames; the
22 <emphasis>IBM AFS Quick Beginnings</emphasis> and <emphasis>IBM AFS Administration Guide</emphasis> explain
23 how using <emphasis>@sys</emphasis> can simplify cell configuration.</para>
25 <para>To set a new value in kernel memory, use the <emphasis role="bold">fs sysname</emphasis> command, which
26 can also be used to view the current value. If a sysname list was set
27 using <emphasis role="bold">fs sysname</emphasis>, only the first value in the list will be reported by
28 <emphasis role="bold">livesys</emphasis>.</para>
32 <title>Cautions</title>
33 <para>To see the full sysname list, use <emphasis role="bold">fs sysname</emphasis> rather than this command.
34 <emphasis role="bold">livesys</emphasis> is mostly useful for scripts that need to know the primary
35 sysname for the local system (to create directories that will later be
36 addressed using <emphasis>@sys</emphasis>, for example).</para>
38 <para><emphasis role="bold">livesys</emphasis> first appeared in OpenAFS 1.2.2. Scripts that need to support
39 older versions of AFS should parse the output of <emphasis role="bold">fs sysname</emphasis> or use
40 <emphasis role="bold">sys</emphasis>.</para>
45 <para>The machine's system type appears as a text string:</para>
48 I&lt;system_type&gt;
53 <title>Examples</title>
54 <para>The following example shows the output produced on a Linux system with a
64 <title>Privilege Required</title>
69 <title>See Also</title>
70 <para><link linkend="fs_sysname1">fs_sysname(1)</link>,
71 <link linkend="sys1">sys(1)</link></para>
73 <para><emphasis>IBM AFS Quick Beginnings</emphasis></para>
75 <para><emphasis>IBM AFS Administration Guide</emphasis></para>
79 <title>Copyright</title>
80 <para>IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.</para>
82 <para>Copyright 2005 Russ Allbery <rra@stanford.edu></para>
84 <para>This documentation is covered by the IBM Public License Version 1.0. It
85 was written by Russ Allbery based on the <emphasis role="bold">sys</emphasis> man page.</para>