Scripting via Command Line

Top  Previous  Next

When you start S3Express, the S3Express shell opens with a command prompt where you can type and execute all commands or copy and paste them, as shown in this picture:

 


 

But alternatively you can also run S3Express in automated mode, by passing commands to execute on the S3Express command line or via a text file.

The S3Express command line supports the following flags:

 

S3Express [commands, ...] [-exit] [-ini:commandfile] [-od] [-nm] [-h]

 

Command Line Flag

Description

Example

[commands, ...]

A list of commands. Separate commands with spaces.
If needed, surround each command with double quotation marks (").

S3Express ls

S3Express "put c:\folder\* bucket -onlydiff" "ls bucket" q

S3Express "put c:\folder\* bucket" "put c:\folderA\*.jpg bucket/jpgfolder/" q

[-exit]

Automatically exit S3Express once all the commands are executed. This is equivalent to having the command q as the last command.

S3Express "put c:\folder\* bucket -onlydiff" -exit

[-ini:commandfile]

Load commands from file commandfile. Each command should be on a separate line. The file should be a text file saved as UTF-8 or ANSI , see also the command exec.

S3Express -ini:"c:\folder\mycommandfile.txt" -exit 

 

The file c:\folder\mycommandfile.txt must be a UTF-8 or ANSI text file. Each command must be on a separate line, e.g.:

 

put c:\folder\* bucket -onlydiff 

ls bucket

q
 
More examples here: exec

[-od]

Load commands from file S3Express.ini that is saved in the same folder as S3Express.exe.

S3Express -od

 

The file S3Express.ini must be a UTF-8 or ANSI text file. Each command must be on a separate line, see example above.

[-nm]

Do not maximize the S3Express window at startup.

S3Express -nm

[-h]

Run S3Express completely hidden. No console is shown and no user interaction is possible. Note that the -h implies the -exit flag, that is, if the -h is used S3Express will automatically close once all the commands are executed.

S3Express "put c:\folder\* bucket -onlydiff" -h

 

Note:
When using double quotation marks inside double quotation marks on the command line, the internal double quotation marks must be escaped by a \.
For example:
 
s3express "put \"g:\folder\folder with space\" \"bucket\folder with space\" -s -onlydiff -t:16 -minoutput -mul:50" -nm -exit
 
Alternatively the commands can be put in a text file (e.g. commandfile.txt):
 
put "G:\folder\folder with space" "bucket\folder with space" -s -onlydiff -t:16 -minoutput -mul:50
quit
 
and then run with : s3express -ini:commandfile.txt -nm

 

 

Exit Codes

 

S3Express.exe returns 0 if all executed commands were successful. It will return 1 otherwise.