doc/man-pages/pod1/livesys.pod

   1 =head1 NAME
   2
   3 livesys - Reports the configured CPU/operating system type
   4
   5 =head1 SYNOPSIS
   6
   7 =for html
   8 <div class="synopsis">
   9
  10 B<livesys>
  11
  12 =for html
  13 </div>
  14
  15 =head1 DESCRIPTION
  16
  17 The B<livesys> command displays the string stored in kernel memory that
  18 indicates the local machine's CPU/operating system (OS) type,
  19 conventionally called the I<sysname>.  The Cache Manager substitutes this
  20 string for the I<@sys> variable which can occur in AFS pathnames; the
  21 I<IBM AFS Quick Beginnings> and I<IBM AFS Administration Guide> explain
  22 how using I<@sys> can simplify cell configuration.
  23
  24 To set a new value in kernel memory, use the B<fs sysname> command, which
  25 can also be used to view the current value.  If a sysname list was set
  26 using B<fs sysname>, only the first value in the list will be reported by
  27 B<livesys>.
  28
  29 =head1 CAUTIONS
  30
  31 To see the full sysname list, use B<fs sysname> rather than this command.
  32 B<livesys> is mostly useful for scripts that need to know the primary
  33 sysname for the local system (to create directories that will later be
  34 addressed using I<@sys>, for example).
  35
  36 B<livesys> first appeared in OpenAFS 1.2.2.  Scripts that need to support
  37 older versions of AFS should parse the output of B<fs sysname> or use
  38 B<sys>.
  39
  40 =head1 OUTPUT
  41
  42 The machine's system type appears as a text string:
  43
  44    I<system_type>
  45
  46 =head1 EXAMPLES
  47
  48 The following example shows the output produced on a Linux system with a
  49 2.6 kernel:
  50
  51    % livesys
  52    i386_linux26
  53
  54 =head1 PRIVILEGE REQUIRED
  55
  56 None
  57
  58 =head1 SEE ALSO
  59
  60 L<fs_sysname(1)>,
  61 L<sys(1)>
  62
  63 I<IBM AFS Quick Beginnings>
  64
  65 I<IBM AFS Administration Guide>
  66
  67 =head1 COPYRIGHT
  68
  69 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
  70
  71 Copyright 2005 Russ Allbery <rra@stanford.edu>
  72
  73 This documentation is covered by the IBM Public License Version 1.0.  It
  74 was written by Russ Allbery based on the B<sys> man page.