|Transferring from the Command Line|
Usage and examples for astokengen
A token authorizes the download of one or more files, or an upload of one or more files into a directory (called destination root). It supports the traditional “cp” paradigm of ascp (copy file1, file2, file3 to directory) or source/destination pairs (ascp --file-pair-list).
|Option (short form)||Option (long form)||Description|
|-A||--version||Print version information.|
|--mode=mode||Direction of the transfer mode (send | recv)|
|-u||--user=user||Generate the token for this user name. This name is embedded in the token and also used to retrieve further information from aspera.conf (user_value and token_life_seconds).|
|--file-list=filename||Specifies a file name that contains a list of sources for a download token. Each line of the file contains a single source and blank lines are ignored.|
|--file-pair-list=filename||Specifies a file name that contains a multiplexed list of source and destination pairs for an upload or download token. Each pair of lines encodes one source and one destination and blank lines are ignored.|
|-v token||Verify token against user and path parameters.|
|-t token||Display the contents of the token.|
|-k passphrase||Passphrase to decrypt token. For use with -t.|
|-b||Assume user name and paths are encoded in base64.|
|Example file list||
/monday/first_thing.txt /monday/next_thing.txt /monday/last_thing.txt
|Example file-pair list||
/monday/first_thing.txt /archive/monday/texts/first_thing /monday/next_thing.txt /archive/monday/texts/next_thing /monday/last_thing.txt /archive/monday/texts/last_thing
In a common upload, only the destination is encoded into the token.
astokengen --user=user --dest=path --mode=send
The destination is encoded into the token. Source paths are not allowed and will cause astokengen to fail. --path and --file-list are illegal in this case.
The destination is prepended to each of the destinations in the paired list file and they are all encoded into the token. The destinations are in each odd numbered line of the file (1, 3, 5, 7, and so on).
astokengen --user=user --dest=path --file-pair-list=filename --mode=send
In this case, --path and --file-list are illegal.
The specified paths are encoded into the token.
astokengen --user=user --path=file1 --path=file2 --mode=recv astokengen --user=user --file-list=filename --mode=recv
In this case, --dest and --file-pair-list are illegal.
The source files from the pair list are encoded in the token. The sources are in each even numbered line of the file (0, 2, 4, 6, 8, etc.).
astokengen --user=user --file-pair-list=filename --mode=recv
In this case, --dest, --path and --file-list are illegal.