fs_copyacl - Copies an ACL from a file or directory to one or more other files or directories
fs copyacl -frompath <source directory or file> -topath <destination directory or file>+ [-clear] [-help]
The fs copyacl command copies the access control list (ACL) from a source directory or file to each specified destination directory or file. The source's ACL is unchanged, and changes to the destination ACL obey the following rules:
If an entry on the source ACL does not already exist on the destination ACL, it is added.
If an entry exists on both the source and destination ACLs, the permissions from the source ACL entry replace the current permissions on the destination ACL entry.
If an entry on the destination ACL has no corresponding entry on the source ACL, it is removed if the -clear flag is included and is unchanged otherwise. In other words, if the -clear flag is provided, the source ACL completely replaces the destination ACL.
Specifies the source directory or file from which to copy the ACL. A partial pathname is interpreted relative to the current working directory.
Specifies each directory or file for which to alter the ACL to match the source ACL. A partial pathname is interpreted relative to the current working directory.
Specify the read/write path to avoid the failure that results from attempting to change a read-only volume. By convention, the read/write path is indicated by placing a period before the cell name at the pathname's second level (for example, /afs/.example.com). For further discussion of the concept of read/write and read-only paths through the filespace, see the fs mkmount reference page.
Replaces the ACL of each destination directory or file with the source ACL.
Prints the online help for this command. All other valid options are ignored.
The following example command copies the current working directory's ACL to its subdirectory called reports. Note that the source directory's ACL is unaffected. Entries on the reports directory's that are not on the source ACL of the current directory remain unaffected as well, because the -clear flag is not used.
% fs listacl . reports Access list for . is Normal rights: pat rlidwka smith rlidwk Access list for reports is Normal rights: pat rl pat:friends rl Negative rights jones rlidwka % fs copyacl -frompath . -topath reports % fs listacl . reports Access list for . is Normal rights: pat rlidwka smith rlidwk Access list for reports is Normal rights: pat rlidwka pat:friends rl smith rlidwk Negative rights jones rlidwka
To copy an ACL between objects, the issuer must have the l
(lookup) permission on the source's ACL for a directory or the r
(read) permission for a file, and the a
(administer) permission on each destination's ACL.
auristorfs_acls(7), fs_cleanacl(1), fs_listacl(1), fs_mkmount(1), fs_setacl(1)
IBM Corporation 2000. http://www.ibm.com/ All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.