doc/html/AdminReference/auarf159.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="auarf158.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="auarf160.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_SETCELL" HREF="auarf002.htm#ToC_173">fs setcell</A></H2>
  19 <A NAME="IDX4955"></A>
  20 <A NAME="IDX4956"></A>
  21 <A NAME="IDX4957"></A>
  22 <A NAME="IDX4958"></A>
  23 <A NAME="IDX4959"></A>
  24 <A NAME="IDX4960"></A>
  25 <P><STRONG>Purpose</STRONG>
  26 <P>Allows or disallows running of setuid programs from specified cells
  27 <P><STRONG>Synopsis</STRONG>
  28 <PRE><B>fs setcell -cell</B> &lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>  [<B>-suid</B>]  [<B>-nosuid</B>]  [<B>-help</B>]
  29
  30 <B>fs setce -c</B> &lt;<VAR>cell&nbsp;name</VAR>><SUP>+</SUP>  [<B>-s</B>]  [<B>-n</B>]  [<B>-h</B>]
  31 </PRE>
  32 <P><STRONG>Description</STRONG>
  33 <P>The <B>fs setcell</B> command sets whether the Cache Manager allows
  34 programs (and other executable files) from each cell named by the
  35 <B>-cell</B> argument to run with setuid permission. By default,
  36 the Cache Manager allows programs from its home cell to run with setuid
  37 permission, but not programs from any foreign cells. A program belongs
  38 to the same cell as the file server machine that houses the volume in which
  39 the program's binary file resides, as specified in the file server
  40 machine's <B>/usr/afs/etc/ThisCell</B> file. The Cache Manager
  41 determines its own home cell by reading the <B>/usr/vice/etc/ThisCell</B>
  42 file at initialization.
  43 <P>To enable programs from each specified cell to run with setuid permission,
  44 include the <B>-suid</B> flag. To prohibit programs from running
  45 with setuid permission, include the <B>-nosuid</B> flag, or omit both
  46 flags.
  47 <P>The <B>fs setcell</B> command directly alters a cell's setuid
  48 status as recorded in kernel memory, so rebooting the machine is
  49 unnecessary. However, non-default settings do not persist across
  50 reboots of the machine unless the appropriate <B>fs setcell</B> command
  51 appears in the machine's AFS initialization file.
  52 <P>To display a cell's setuid status, issue the <B>fs
  53 getcellstatus</B> command.
  54 <P><STRONG>Cautions</STRONG>
  55 <P>AFS does not recognize effective UID: if a setuid program accesses
  56 AFS files and directories, it does so using the current AFS identity of the
  57 AFS user who initialized the program, not of the program's owner.
  58 Only the local file system recognizes effective UID.
  59 <P>Only members of the <B>system:administrators</B> group can turn
  60 on the setuid mode bit on an AFS file or directory.
  61 <P>When the setuid mode bit is turned on, the UNIX <B>ls -l</B> command
  62 displays the third user mode bit as an <TT>s</TT> instead of an
  63 <TT>x</TT>. However, the <TT>s</TT> does not appear on an AFS file
  64 or directory unless setuid permission is enabled for the cell in which the
  65 file resides.
  66 <P><STRONG>Options</STRONG>
  67 <DL>
  68 <P><DT><B>-cell
  69 </B><DD>Names each cell for which to set setuid status. Provide the fully
  70 qualified domain name, or a shortened form that disambiguates it from the
  71 other cells listed in the local <B>/usr/vice/etc/CellServDB</B>
  72 file.
  73 <P><DT><B>-suid
  74 </B><DD>Allows programs from each specified cell to run with setuid
  75 privilege. Provide it or the <B>-nosuid</B> flag, or omit both
  76 flags to disallow programs from running with setuid privilege.
  77 <P><DT><B>-nosuid
  78 </B><DD>Prevents programs from each specified cell from running with setuid
  79 privilege. Provide it or the <B>-suid</B> flag, or omit both flags
  80 to disallow programs form running with setuid privilege.
  81 <P><DT><B>-help
  82 </B><DD>Prints the online help for this command. All other valid options
  83 are ignored.
  84 </DL>
  85 <P><STRONG>Examples</STRONG>
  86 <P>The following command enables executable files from the State University
  87 cell to run with setuid privilege on the local machine:
  88 <PRE>   % <B>fs setcell -cell stateu.edu -suid</B>
  89
  90 </PRE>
  91 <P><STRONG>Privilege Required</STRONG>
  92 <P>The issuer must be logged in as the local superuser <B>root</B>.
  93 <P><STRONG>Related Information</STRONG>
  94 <P><A HREF="auarf144.htm#HDRFS_GETCELLSTATUS">fs getcellstatus</A>
  95 <P>
  96 <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="auarf158.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="auarf160.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>
  97 <!-- Begin Footer Records  ========================================== -->
  98 <P><HR><B>
  99 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 100 </B>
 101 <!-- End Footer Records  ============================================ -->
 102 <A NAME="Bot_Of_Page"></A>
 103 </BODY></HTML>