Skip to content

Commit

Permalink
aisloader: '--subdir' vs prefix (clarify)
Browse files Browse the repository at this point in the history
Signed-off-by: Alex Aizman <alex.aizman@gmail.com>
  • Loading branch information
alex-aizman committed Oct 3, 2024
1 parent 14f838a commit 7e7e8e4
Show file tree
Hide file tree
Showing 2 changed files with 6 additions and 3 deletions.
7 changes: 5 additions & 2 deletions bench/tools/aisloader/run.go
Original file line number Diff line number Diff line change
Expand Up @@ -585,8 +585,11 @@ func addCmdLine(f *flag.FlagSet, p *params) {
"when true, generate object names of 32 random characters. This option is ignored when loadernum is defined")
f.BoolVar(&p.randomProxy, "randomproxy", false,
"when true, select random gateway (\"proxy\") to execute I/O request")
f.StringVar(&p.subDir, "subdir", "", "when writing: virtual destination directory for all aisloader-generated objects;\n"+
"when listing: list objects with names that have the specified prefix (that may or may not be a virtual directory")
f.StringVar(&p.subDir, "subdir", "", "For GET requests, '-subdir' is a prefix that may or may not be an actual _virtual directory_;\n"+
"For PUTs, '-subdir' is a virtual destination directory for all aisloader-generated objects;\n"+
"See also:\n"+
"\t- closely related CLI '--prefix' option: "+cmn.GitHubHome+"/blob/main/docs/cli/object.md\n"+
"\t- virtual directories: "+cmn.GitHubHome+"/blob/main/docs/howto_virt_dirs.md")
f.Uint64Var(&p.putShards, "putshards", 0, "spread generated objects over this many subdirectories (max 100k)")
f.BoolVar(&p.uniqueGETs, "uniquegets", true,
"when true, GET objects randomly and equally. Meaning, make sure *not* to GET some objects more frequently than the others")
Expand Down
2 changes: 1 addition & 1 deletion docs/aisloader.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ For the most recently updated command-line options and examples, please run `ais
| -statsdport | `int` | StatsD UDP port | `8125` |
| -statsdprobe | `bool` | Test-probe StatsD server prior to benchmarks | `true` |
| -statsinterval | `int` | Interval in seconds to print performance counters; 0 - disabled | `10` |
| -subdir | `string` | Virtual destination directory for all aisloader-generated objects | `""` |
| -subdir | `string` | For GET requests, `-subdir` is a prefix that may or may not be an actual [virtual directory](/docs/howto_virt_dirs.md). For PUT, `-subdir` is a virtual destination directory for all aisloader-generated objects. See closely related [CLI](/docs/cli/object.md) `--prefix` option. | `""` |
| -test-probe | `bool`| Test StatsD server prior to running benchmarks | `false` |
| -timeout | `string` | Client HTTP timeout; `0` = infinity) | `10m` |
| -tmpdir | `string` | Local directory to store temporary files | `/tmp/ais` |
Expand Down

0 comments on commit 7e7e8e4

Please sign in to comment.