chiark / gitweb /
doc: Fix spec for copyup/copydown to describe actual behaviours
authorIan Jackson <ijackson@chiark.greenend.org.uk>
Fri, 29 Jul 2011 14:31:05 +0000 (15:31 +0100)
committerIan Jackson <ijackson@chiark.greenend.org.uk>
Fri, 29 Jul 2011 14:31:05 +0000 (15:31 +0100)
doc/README.virtualisation-server
lib/VirtSubproc.py [moved from virt-subproc/VirtSubproc.py with 100% similarity]

index 7d40ef521e2043fa0431547a4707a1332ca848a3..c077e5afdb9c762f7bbbcb87375c802b9e8ece0e 100644 (file)
@@ -162,9 +162,9 @@ Protocol
   response
        ok <exit-status>
 
-  Executes the command (args separated by commas, everything
-  url-encoded).  stdin, stdout, stderr are files on the testbed
-  (must be files, not pipes).
+  Executes the command (args separated by commas, everything including
+  filenames and env var names and values url-encoded).  stdin, stdout,
+  stderr are files on the testbed (must be files, not pipes).
 
   Currently defined keyword arguments:
 
@@ -198,11 +198,21 @@ Protocol
                that facility is available.
 
 * Commands
-       copydown <host-tree> <testbed-path>
-       copyup <testbed-tree> <host-path>
+       copydown <host-path> <testbed-path>
+       copyup <testbed-path> <host-path>
 
-  Like cp -dR --preserve=mode,timestamps exce[t across the testbed
-  boundary.
+  Either
+
+  1. Both paths end in `/', in which case the source must be an
+     existing directory.  The destination directory is replaced with a
+     copy as if made by cp -dR --preserve=mode,timestamps except
+     across the testbed boundary.
+
+  2. Neither path ends in `/', in which case the source must be an
+     existing file.  The data from the source file is written to the
+     destination as if via shell redirection; except that if for
+     copydown of an executable file, `chmod +x' is run on the
+     destination file after the copy.
 
 
 * Command