1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
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">
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>
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> <<VAR>source directory (or DFS file)</VAR>>
27 <B>-todir</B> <<VAR>destination directory (or DFS file)</VAR>><SUP>+</SUP>
28 [<B>-clear</B>] [<B>-id</B>] [<B>-if</B>] [<B>-help</B>]
30 <B>fs co -f</B> <<VAR>source directory (or DFS file)</VAR>>
31 <B>-t</B> <<VAR>destination directory (or DFS file)</VAR>><SUP>+</SUP>
32 [<B>-c</B>] [<B>-id</B>] [<B>-if</B>] [<B>-h</B>]
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:
40 <P><LI>If an entry on the source ACL does not already exist on the destination
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.
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>
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.
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.
79 </B><DD>Replaces the ACL of each destination directory with the source ACL.
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
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
93 </B><DD>Prints the online help for this command. All other valid options
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
103 <PRE> % <B>fs listacl . reports</B>
108 Access list for reports is
115 % <B>fs copyacl -fromdir . -todir reports</B>
117 % <B>fs listacl . reports</B>
122 Access list for reports is
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
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
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>
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 ========================================== -->
152 <br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
154 <!-- End Footer Records ============================================ -->
155 <A NAME="Bot_Of_Page"></A>