yfs-up - Recursively copy directories, preserving /afs metadata


yfs-up -source <source directory> -dest <destination directory> [-verbose] [-one | -1] [-rename] [-force] [-set_time | -x] [-preserve_mount | -m] [-help]


The yfs-up command recursively copies the files and subdirectories in a specified source directory to a specified destination directory. The command interpreter changes the destination directory and the files and subdirectories in it in the following ways:

The yfs-up command is idempotent, meaning that if its execution is interrupted by a network, server machine, or process outage, then a subsequent reissue of the same command continues from the interruption point, rather than starting over at the beginning. This saves time and reduces network traffic in comparison to the UNIX commands that provide similar functionality.

The yfs-up command returns a status code of 0 (zero) only if it succeeds. Otherwise, it returns a status code of 1 (one).



Prints a detailed trace to the standard output stream as the command runs.

-one | -1

Copies only the files in the top level source directory to the destination directory, rather than copying recursively through subdirectories. The source directory's ACL still overwrites the destination directory's. (This is the number one, not the letter l.)


Overwrites existing directories, subdirectories, and files even if the first (user) w (write) mode bit is turned off on the version in the destination directory.

-preserve_mount | -m

Recognize and copy mount points rather than traversing the volumes they reference during the recursive copy operation. Without -m, yfs-up's default behavior is to copy the contents of all volumes and subvolumes mounted under the source directory into the volume containing the destination directory.


Creates a backup copy of all files overwritten in the destination directory and its subdirectories, by adding a .old extension to each filename.

-set_time | -x

Sets the modification timestamp on each file to the time of the copying operation.

-source source directory

Names the directory to copy recursively.

-dest destination directory

Names the directory to which to copy. It does not have to exist already.


Prints the online help for this command. All other valid options are ignored.


The following command copies the contents of the directory dir1 to directory dir2:

   % yfs-up dir1 dir2


The issuer must have the a (administer) permission on the ACL of both the source and destination directories.


IBM Corporation 2000. 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.