doc/html/AdminReference/auarf165.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf164.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf166.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRFS_SYSNAME" HREF="auarf002.htm#ToC_179">fs sysname</A></H2>
  19 <A NAME="IDX4987"></A>
  20 <A NAME="IDX4988"></A>
  21 <A NAME="IDX4989"></A>
  22 <A NAME="IDX4990"></A>
  23 <A NAME="IDX4991"></A>
  24 <A NAME="IDX4992"></A>
  25 <A NAME="IDX4993"></A>
  26 <A NAME="IDX4994"></A>
  27 <A NAME="IDX4995"></A>
  28 <A NAME="IDX4996"></A>
  29 <A NAME="IDX4997"></A>
  30 <A NAME="IDX4998"></A>
  31 <A NAME="IDX4999"></A>
  32 <A NAME="IDX5000"></A>
  33 <P><STRONG>Purpose</STRONG>
  34 <P>Reports or sets the CPU/operating system type
  35 <P><STRONG>Synopsis</STRONG>
  36 <PRE><B>fs sysname</B> [<B>-newsys</B> &lt;<VAR>new&nbsp;sysname</VAR>>]  [<B>-help</B>]
  37
  38 <B>fs sy</B> [<B>-n</B> &lt;<VAR>new&nbsp;sysname</VAR>>]  [<B>-h</B>]
  39 </PRE>
  40 <P><STRONG>Description</STRONG>
  41 <P>The <B>fs sysname</B> command sets or displays the local machine's
  42 CPU/operating system type as recorded in kernel memory. The Cache
  43 Manager substitutes the string for the <VAR>@sys</VAR> variable which can occur
  44 in AFS pathnames; the <I>IBM AFS Quick Beginnings</I> and <I>IBM
  45 AFS Administration Guide</I> explain how using <VAR>@sys</VAR> can simplify
  46 cell configuration. It is best to use it sparingly, however, because it
  47 can make the effect of changing directories unpredictable.
  48 <P>The command always applies to the local machine only. If issued on
  49 an NFS client machine accessing AFS via the NFS/AFS Translator, the string is
  50 set or reported for the NFS client machine. The Cache Manager on the
  51 AFS client machine serving as the NFS client's NFS/AFS translator machine
  52 stores the value in its kernel memory, and so can provide the NFS client with
  53 the proper version of program binaries when the user issues commands for which
  54 the pathname to the binaries includes <I>@sys</I>. There is a
  55 separate record for each user logged into the NFS client, which implies that
  56 if a user adopts a new identity (UNIX UID) during a login session on the NFS
  57 client--perhaps by using the UNIX <B>su</B> command--he or she
  58 must verify that the correct string is set for the new identity also.
  59 <P><STRONG>Options</STRONG>
  60 <DL>
  61 <P><DT><B>-newsys
  62 </B><DD>Sets the CPU/operating system indicator string for the local
  63 machine. If this argument is omitted, the output displays the current
  64 setting instead. AFS uses a standardized set of strings; consult
  65 the <I>IBM AFS Quick Beginnings</I> or <I>AFS Release
  66 Notes</I>.
  67 <P><DT><B>-help
  68 </B><DD>Prints the online help for this command. All other valid options
  69 are ignored.
  70 </DL>
  71 <P><STRONG>Output</STRONG>
  72 <P>When the <B>-newsys</B> argument is omitted, the output reports the
  73 machine's system type in the following format:
  74 <PRE>   Current sysname is '<VAR>system_type</VAR>'
  75
  76 </PRE>
  77 <P><STRONG>Examples</STRONG>
  78 <P>The following example shows the output produced on a Sun SPARCStation
  79 running Solaris 5.7:
  80 <PRE>   % <B>fs sysname</B>
  81    Current sysname is 'sun4x_57'
  82
  83 </PRE>
  84 <P>The following command defines a machine to be a IBM RS/6000 running AIX
  85 4.2:
  86 <PRE>   % <B>fs sysname -newsys rs_aix42</B>
  87
  88 </PRE>
  89 <P><STRONG>Privilege Required</STRONG>
  90 <P>To display the current setting, no privilege is required. To include
  91 the <B>-newsys</B> argument on an AFS client machine, the issuer must be
  92 logged in as the local superuser <B>root</B>.
  93 <P><STRONG>Related Information</STRONG>
  94 <P><A HREF="auarf139.htm#HDRFS_EXPORTAFS">fs exportafs</A>
  95 <P><A HREF="auarf234.htm#HDRSYS">sys</A>
  96 <P><I>IBM AFS Quick Beginnings</I>
  97 <P><I>IBM AFS Administration Guide</I>
  98 <P>
  99 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf164.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf166.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 100 <!-- Begin Footer Records  ========================================== -->
 101 <P><HR><B>
 102 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 103 </B>
 104 <!-- End Footer Records  ============================================ -->
 105 <A NAME="Bot_Of_Page"></A>
 106 </BODY></HTML>