doc/html/AdminReference/auarf136.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="auarf135.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="auarf137.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_COPYACL" HREF="auarf002.htm#ToC_150">fs copyacl</A></H2>
  19 <A NAME="IDX4753"></A>
  20 <A NAME="IDX4754"></A>
  21 <A NAME="IDX4755"></A>
  22 <A NAME="IDX4756"></A>
  23 <P><STRONG>Purpose</STRONG>
  24 <P>Copies an ACL from one directory to one or more other directories
  25 <P><STRONG>Synopsis</STRONG>
  26 <PRE><B>fs copyacl -fromdir</B> &lt;<VAR>source&nbsp;directory&nbsp;(or&nbsp;DFS&nbsp;file)</VAR>>
  27            <B>-todir</B> &lt;<VAR>destination&nbsp;directory&nbsp;(or&nbsp;DFS&nbsp;file)</VAR>><SUP>+</SUP>
  28            [<B>-clear</B>]  [<B>-id</B>]  [<B>-if</B>]  [<B>-help</B>]
  29
  30 <B>fs co -f</B> &lt;<VAR>source&nbsp;directory&nbsp;(or&nbsp;DFS&nbsp;file)</VAR>>
  31       <B>-t</B> &lt;<VAR>destination&nbsp;directory&nbsp;(or&nbsp;DFS&nbsp;file)</VAR>><SUP>+</SUP>
  32       [<B>-c</B>]  [<B>-id</B>]  [<B>-if</B>]  [<B>-h</B>]
  33 </PRE>
  34 <P><STRONG>Description</STRONG>
  35 <P>The <B>fs copyacl</B> command copies the access control list (ACL) from
  36 a source directory to each specified destination directory. The source
  37 directory's ACL is unchanged, and changes to the destination
  38 directory's ACL obey the following rules:
  39 <UL>
  40 <P><LI>If an entry on the source ACL does not already exist on the destination
  41 ACL, it is added.
  42 <P><LI>If an entry exists on both the source and destination ACLs, the
  43 permissions from the source ACL entry replace the current permissions on the
  44 destination ACL entry.
  45 <P><LI>If an entry on the destination ACL has no corresponding entry on the
  46 source ACL, it is removed if the <B>-clear</B> flag is included and is
  47 unchanged otherwise. In other words, if the <B>-clear</B> flag is
  48 provided, the source ACL completely replaces the destination ACL.
  49 </UL>
  50 <P>When using this command to copy ACLs between objects in DFS filespace
  51 accessed via the AFS/DFS Migration Toolkit Protocol Translator, it is possible
  52 to specify files, as well as directories, with the <B>-fromdir</B> and
  53 <B>-todir</B> arguments. For more information on copying ACLs
  54 between DFS directories and files, refer to the <I>IBM AFS/DFS Migration
  55 Toolkit Administration Guide and Reference</I>.
  56 <P><STRONG>Cautions</STRONG>
  57 <P>Do not copy ACLs between AFS and DFS files or directories. The ACL
  58 formats are incompatible.
  59 <P><STRONG>Options</STRONG>
  60 <DL>
  61 <P><DT><B>-fromdir
  62 </B><DD>Specifies the source directory from which to copy the ACL.
  63 (Specifying an AFS file copies its directory's ACL, but specifying a DFS
  64 file copies its own ACL). A partial pathname is interpreted relative to
  65 the current working directory.
  66 <P><DT><B>-todir
  67 </B><DD>Specifies each directory for which to alter the ACL to match the source
  68 ACL. (Specifying an AFS file halts the command with an error, but
  69 specifying a DFS file alters the file's ACL). A partial pathname
  70 is interpreted relative to the current working directory.
  71 <P>Specify the read/write path to each directory (or DFS file), to avoid the
  72 failure that results from attempting to change a read-only volume. By
  73 convention, the read/write path is indicated by placing a period before the
  74 cell name at the pathname's second level (for example,
  75 <B>/afs/.abc.com</B>). For further discussion of the
  76 concept of read/write and read-only paths through the filespace, see the
  77 <B>fs mkmount</B> reference page.
  78 <P><DT><B>-clear
  79 </B><DD>Replaces the ACL of each destination directory with the source ACL.
  80 <P><DT><B>-id
  81 </B><DD>Modifies the Initial Container ACL of each DFS directory named by the
  82 <B>-todir</B> argument, rather than the regular Object ACL. This
  83 argument is supported only when both the source and each destination directory
  84 reside in DFS and are accessed via the AFS/DFS Migration Toolkit Protocol
  85 Translator.
  86 <P><DT><B>-if
  87 </B><DD>Modifies the Initial Object ACL of each DFS directory named by the
  88 <B>-todir</B> argument, rather than the regular Object ACL. This
  89 argument is supported only when both the source and each destination directory
  90 reside in DFS and are accessed via the AFS/DFS Migration Toolkit Protocol
  91 Translator.
  92 <P><DT><B>-help
  93 </B><DD>Prints the online help for this command. All other valid options
  94 are ignored.
  95 </DL>
  96 <P><STRONG>Examples</STRONG>
  97 <P>The following example command copies the current working directory's
  98 ACL to its subdirectory called <B>reports</B>. Note that the source
  99 directory's ACL is unaffected. Entries on the <B>reports</B>
 100 directory's that are not on the source ACL of the current directory
 101 remain unaffected as well, because the <B>-clear</B> flag is not
 102 used.
 103 <PRE>   % <B>fs listacl . reports</B>
 104    Access list for . is
 105    Normal rights:
 106       pat rlidwka
 107       smith rlidwk
 108    Access list for reports is
 109    Normal rights:
 110       pat rl
 111       pat:friends rl
 112    Negative rights
 113       jones rlidwka
 114
 115    % <B>fs copyacl -fromdir . -todir reports</B>
 116
 117    % <B>fs listacl . reports</B>
 118    Access list for . is
 119    Normal rights:
 120       pat rlidwka
 121       smith rlidwk
 122    Access list for reports is
 123    Normal rights:
 124       pat rlidwka
 125       pat:friends rl
 126       smith rlidwk
 127    Negative rights
 128       jones rlidwka
 129
 130 </PRE>
 131 <P><STRONG>Privilege Required</STRONG>
 132 <P>To copy an ACL between AFS objects, the issuer must have the <B>l</B>
 133 (<B>lookup)</B>) permission on the source directory's ACL and the
 134 <B>a</B> (<B>administer</B>) permission on each destination
 135 directory's ACL. If the <B>-fromdir</B> argument names a file
 136 rather than a directory, the issuer must have both the <B>l</B> and
 137 <B>r</B> (<B>read</B>) permissions on the ACL of the file's
 138 directory.
 139 <P>To copy an ACL between DFS objects, the issuer must have the <B>r</B>
 140 permission on the source directory or file's ACL and the <B>c</B>
 141 (<B>control</B>) permission on each destination directory or file's
 142 ACL.
 143 <P><STRONG>Related Information</STRONG>
 144 <P><A HREF="auarf148.htm#HDRFS_LISTACL">fs listacl</A>
 145 <P><A HREF="auarf153.htm#HDRFS_MKMOUNT">fs mkmount</A>
 146 <P><A HREF="auarf157.htm#HDRFS_SETACL">fs setacl</A>
 147 <P><I>IBM AFS/DFS Migration Toolkit Administration Guide and Reference</I>
 148 <P>
 149 <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="auarf135.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="auarf137.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>
 150 <!-- Begin Footer Records  ========================================== -->
 151 <P><HR><B>
 152 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 153 </B>
 154 <!-- End Footer Records  ============================================ -->
 155 <A NAME="Bot_Of_Page"></A>
 156 </BODY></HTML>