OnWorks favicon

afs-up - Online in the Cloud

Run afs-up in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command afs-up that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



up - Recursively copy directories, preserving AFS metadata


up [-v] [-1] [-f] [-r] [-x] [-m]
<source directory> <destination directory>


The 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:

· It copies the source directory's access control list (ACL) to the destination
directory and its subdirectories, overwriting any existing ACLs.

· If the issuer is logged on as the local superuser root and has AFS tokens as a member
of the group system:administrators, then the source directory's owner (as reported by
the "ls -ld" command) becomes the owner of the destination directory and all files and
subdirectories in it. Otherwise, the issuer's user name is recorded as the owner.

· If a file or directory exists in both the source and destination directories, the
source version overwrites the destination version. The overwrite operation fails if
the first (user) "w" (write) mode bit is turned off on the version in the destination
directory, unless the -f flag is provided.

· The modification timestamp on a file (as displayed by the "ls -l" command) in the
source directory overwrites the timestamp on a file of the same name in the
destination directory, but the timestamp on an existing subdirectory in the
destination directory remains unchanged. If the command creates a new subdirectory in
the destination directory, the new subdirectory's timestamp is set to the time of the
copy operation, rather than to the timestamp that the subdirectory has in the source

The 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

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

This command does not use the syntax conventions of the AFS command suites. Provide the
command name and all option names in full.


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

-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

-f 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.

-m Recognize and copy mount points rather than traversing the volumes they reference
during the recursive copy operation. Without -m, 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.

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

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

source directory
Names the directory to copy recursively.

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


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

% up dir1 dir2


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


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.

Use afs-up online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

  • 1
    Phaser is a fast, free, and fun open
    source HTML5 game framework that offers
    WebGL and Canvas rendering across
    desktop and mobile web browsers. Games
    can be co...
    Download Phaser
  • 2
    VASSAL Engine
    VASSAL Engine
    VASSAL is a game engine for creating
    electronic versions of traditional board
    and card games. It provides support for
    game piece rendering and interaction,
    Download VASSAL Engine
  • 3
    OpenPDF - Fork of iText
    OpenPDF - Fork of iText
    OpenPDF is a Java library for creating
    and editing PDF files with a LGPL and
    MPL open source license. OpenPDF is the
    LGPL/MPL open source successor of iText,
    Download OpenPDF - Fork of iText
  • 4
    Toolbox for Java/JTOpen
    Toolbox for Java/JTOpen
    The IBM Toolbox for Java / JTOpen is a
    library of Java classes supporting the
    client/server and internet programming
    models to a system running OS/400,
    i5/OS, o...
    Download Toolbox for Java/JTOpen
  • 5
    D3.js (or D3 for Data-Driven Documents)
    is a JavaScript library that allows you
    to produce dynamic, interactive data
    visualizations in web browsers. With D3
    Download D3.js
  • 6
    A fast tunnel proxy that helps you
    bypass firewalls This is an application
    that can also be fetched from
    It ha...
    Download Shadowsocks
  • 7
    GLPI Themes
    GLPI Themes
    Download release at
    Color themes for GLPI 0.84 and 0.85 New
    Modifications for GLPI This is an
    application that c...
    Download GLPI Themes
  • More »

Linux commands