mirror of
https://git.openafs.org/openafs.git
synced 2025-01-22 08:50:17 +00:00
114 lines
6.2 KiB
HTML
114 lines
6.2 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
|
||
|
|
<HTML><HEAD>
|
||
|
|
<TITLE>Administration Reference</TITLE>
|
||
|
|
<!-- Begin Header Records ========================================== -->
|
||
|
|
<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
|
||
|
|
<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
|
||
|
|
<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
|
||
|
|
<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
|
||
|
|
<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
|
||
|
|
</HEAD><BODY>
|
||
|
|
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
|
||
|
|
<BODY bgcolor="ffffff">
|
||
|
|
<!-- End Header Records ============================================ -->
|
||
|
|
<A NAME="Top_Of_Page"></A>
|
||
|
|
<H1>Administration Reference</H1>
|
||
|
|
<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="auarf238.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="auarf240.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>
|
||
|
|
<P>
|
||
|
|
<H2><A NAME="HDRUP" HREF="auarf002.htm#ToC_253">up</A></H2>
|
||
|
|
<A NAME="IDX5493"></A>
|
||
|
|
<A NAME="IDX5494"></A>
|
||
|
|
<A NAME="IDX5495"></A>
|
||
|
|
<P><STRONG>Purpose</STRONG>
|
||
|
|
<P>Recursively copies the contents of a source directory to a destination
|
||
|
|
directory.
|
||
|
|
<P><STRONG>Synopsis</STRONG>
|
||
|
|
<PRE><B>up</B> [<B>-v</B>] [<B>-1</B>] [<B>-f</B>] [<B>-r</B>] [<B>-x</B>] <<VAR>source directory</VAR>> <<VAR>destination directory</VAR>>
|
||
|
|
</PRE>
|
||
|
|
<P>This command does not use the syntax conventions of the AFS command
|
||
|
|
suites. Provide the command name and all option names in full.
|
||
|
|
<P><STRONG>Description</STRONG>
|
||
|
|
<P>The <B>up</B> 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:
|
||
|
|
<UL>
|
||
|
|
<P><LI>It copies the source directory's access control list (ACL) to the
|
||
|
|
destination directory and its subdirectories, overwriting any existing
|
||
|
|
ACLs.
|
||
|
|
<P><LI>If the issuer is logged on as the local superuser <B>root</B> and has
|
||
|
|
AFS tokens as a member of the group <B>system:administrators</B>,
|
||
|
|
then the source directory's owner (as reported by the <B>ls -ld</B>
|
||
|
|
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.
|
||
|
|
<P><LI>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) <B>w</B> (<B>write</B>)
|
||
|
|
mode bit is turned off on the version in the destination directory, unless the
|
||
|
|
<B>-f</B> flag is provided.
|
||
|
|
<P><LI>The modification timestamp on a file (as displayed by the <B>ls -l</B>
|
||
|
|
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
|
||
|
|
directory.
|
||
|
|
</UL>
|
||
|
|
<P>The <B>up</B> 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.
|
||
|
|
<P>The <B>up</B> command returns a status code of <B>0</B> (zero) only
|
||
|
|
if it succeeds. Otherwise, it returns a status code of <B>1</B>
|
||
|
|
(one).
|
||
|
|
<P><STRONG>Options</STRONG>
|
||
|
|
<DL>
|
||
|
|
<P><DT><B>-v
|
||
|
|
</B><DD>Prints a detailed trace to the standard output stream as the command
|
||
|
|
runs.
|
||
|
|
<P><DT><B>-1
|
||
|
|
</B><DD>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
|
||
|
|
<B>l</B>.)
|
||
|
|
<P><DT><B>-f
|
||
|
|
</B><DD>Overwrites existing directories, subdirectories, and files even if the
|
||
|
|
first (user) <B>w</B> (<B>write</B>) mode bit is turned off on the
|
||
|
|
version in the destination directory.
|
||
|
|
<P><DT><B>-r
|
||
|
|
</B><DD>Creates a backup copy of all files overwritten in the destination
|
||
|
|
directory and its subdirectories, by adding a <B>.old</B> extension
|
||
|
|
to each filename.
|
||
|
|
<P><DT><B>-x
|
||
|
|
</B><DD>Sets the modification timestamp on each file to the time of the copying
|
||
|
|
operation.
|
||
|
|
<P><DT><B><VAR>source directory</VAR>
|
||
|
|
</B><DD>Names the directory to copy recursively.
|
||
|
|
<P><DT><B><VAR>destination directory</VAR>
|
||
|
|
</B><DD>Names the directory to which to copy. It does not have to exist
|
||
|
|
already.
|
||
|
|
</DL>
|
||
|
|
<P><STRONG>Examples</STRONG>
|
||
|
|
<P>The following command copies the contents of the directory <VAR>dir1</VAR> to
|
||
|
|
directory <VAR>dir2</VAR>:
|
||
|
|
<PRE> % <B>up dir1 dir2</B>
|
||
|
|
|
||
|
|
</PRE>
|
||
|
|
<P><STRONG>Privilege Required</STRONG>
|
||
|
|
<P>The issuer must have the <B>a</B> (<B>administer</B>) permission on
|
||
|
|
the ACL of both the source and destination directories.
|
||
|
|
<P>
|
||
|
|
<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="auarf238.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="auarf240.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>
|
||
|
|
<!-- Begin Footer Records ========================================== -->
|
||
|
|
<P><HR><B>
|
||
|
|
<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
|
||
|
|
</B>
|
||
|
|
<!-- End Footer Records ============================================ -->
|
||
|
|
<A NAME="Bot_Of_Page"></A>
|
||
|
|
</BODY></HTML>
|