| Appendix |
344
To send random data in place of a source file (do not read from the source), you can specify the file as
faux:///
fname
?
fsize
.
fname
is the name assigned to the file on the destination and
fsize
is the number of bytes
to send.
fsize
can be set with modifiers (k/K, m/M, g/G, t/T, p/P, or e/E) to a maximum of 7x2
60
bytes (7 EiB).
For example:
# ascp --mode=send --user=
username
--host=
host_ip_address
faux:///
fname
?
fsize
target_path
Faux Source Directory
In some cases, you might want to test the transfer of an entire directory, rather than a single file. Specify the faux
source directory with the following syntax:
faux:///
dirname
?
file=
file
&count=
count
&size=
size
&inc=
increment
&seq=
sequence
&buf_init=
buf_option
Where:
•
dirname
is a name for the directory (required)
•
file
is the root for file names, default is "file" (optional)
•
count
is the number of files in the directory (required)
•
size
is the size of the first file in the directory, default 0 (optional).
size
can be set with modifiers (k/K, m/M, g/G,
t/T, p/P, or e/E) to a maximum of 7x2
60
bytes (7 EiB).
•
increment
is the increment of bytes to use to determine the file size of the next file, default 0 (optional)
•
sequence
is how to determine the size of the next file: "sequential" or "random". Default is "sequential" (optional).
When set to "sequential", file size is calculated as:
size
+ ((
N
- 1) *
increment
)
Where
N
is the file index; for the first file,
N
is one.
When set to "random", file size is calculated as:
size
+/- (
rand
*
increment
)
Where
rand
is a random number between zero and one. If necessary,
increment
is automatically adjusted to
prevent the file size from being negative.
For both options,
increment
is adjusted to prevent the file size from from exceeding 7x2
60
bytes.
•
buf_option
is how faux source data are initialized: "none", "zero", or "random". Default is "zero". "none" is not
allowed for downloads (Ascp run with
--mode=recv
).
When the defaults are used, Ascp sends a directory that is named
dirname
and that contains
count
number of zero-
byte files that are named file_
count
.
For example, to transfer a faux directory ("mydir") that contains 1 million files to
/tmp
on 10.0.0.2, and the files in
mydir
are named "testfile" and file size increases sequentially from 0 to 2 MB by an increment of 2 bytes:
# ascp --mode=send --user=
username
--host=10.0.0.2 faux:///mydir?
file=testfile&count=1m&size=0&inc=2&seq=sequential /tmp
Faux Target
To send data but not save the results to disk at the destination (do not write to the target), specify the target as
faux://
.
For example, to send a real file to a faux target, run the following command:
# ascp --mode=send --user=
username
--host=
host_ip_address
source_file1
faux://
