mirror of
https://github.com/rclone/rclone.git
synced 2025-12-12 06:24:14 +01:00
65 lines
2.2 KiB
Markdown
65 lines
2.2 KiB
Markdown
---
|
|
title: "rclone test speed"
|
|
description: "Run a speed test to the remote"
|
|
versionIntroduced: v1.72
|
|
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/test/speed/ and as part of making a release run "make commanddocs"
|
|
---
|
|
# rclone test speed
|
|
|
|
Run a speed test to the remote
|
|
|
|
## Synopsis
|
|
|
|
Run a speed test to the remote.
|
|
|
|
This command runs a series of uploads and downloads to the remote, measuring
|
|
and printing the speed of each test using varying file sizes and numbers of
|
|
files.
|
|
|
|
Test time can be innaccurate with small file caps and large files. As it
|
|
uses the results of an initial test to determine how many files to use in
|
|
each subsequent test.
|
|
|
|
It is recommended to use -q flag for a simpler output. e.g.:
|
|
|
|
rclone test speed remote: -q
|
|
|
|
**NB** This command will create and delete files on the remote in a randomly
|
|
named directory which will be automatically removed on a clean exit.
|
|
|
|
You can use the --json flag to only print the results in JSON format.
|
|
|
|
```
|
|
rclone test speed <remote> [flags]
|
|
```
|
|
|
|
## Options
|
|
|
|
```
|
|
--ascii Fill files with random ASCII printable bytes only
|
|
--chargen Fill files with a ASCII chargen pattern
|
|
--file-cap int Maximum number of files to use in each test (default 100)
|
|
-h, --help help for speed
|
|
--json Output only results in JSON format
|
|
--large SizeSuffix Size of large files (default 1Gi)
|
|
--medium SizeSuffix Size of medium files (default 10Mi)
|
|
--pattern Fill files with a periodic pattern
|
|
--seed int Seed for the random number generator (0 for random) (default 1)
|
|
--small SizeSuffix Size of small files (default 1Ki)
|
|
--sparse Make the files sparse (appear to be filled with ASCII 0x00)
|
|
--test-time Duration Length for each test to run (default 15s)
|
|
--zero Fill files with ASCII 0x00
|
|
```
|
|
|
|
See the [global flags page](/flags/) for global options not listed here.
|
|
|
|
## See Also
|
|
|
|
<!-- markdownlint-capture -->
|
|
<!-- markdownlint-disable ul-style line-length -->
|
|
|
|
* [rclone test](/commands/rclone_test/) - Run a test command
|
|
|
|
|
|
<!-- markdownlint-restore -->
|