Docs

Torch Object Storage

tosutil

tosutil FAQ

This topic covers common questions you may have while using tosutil.

What should I do if the progress bar gets stuck when I click or scroll the mouse while executing a tosutil command in the CMD window on Windows 10?

This is because QuickEdit mode is enabled by default in Windows 10 Command Prompt (CMD). Clicking the mouse or performing other actions triggers the system to enter QuickEdit mode. This causes the standard output and the tosutil command progress bar to freeze.

We recommend disabling QuickEdit mode. Steps:

Right-click Command Prompt in the upper-left corner of the window. Then, click Defaults. In the Edit Options area, uncheck the box next to QuickEdit mode and click OK.

What should I do if the file name exceeds the operating system's limit while downloading a file with tosutil on Windows?

The Windows system has stricter limitations on file name length. If a file has an extended suffix, its name may exceed the allowable length. You can resolve this issue by specifying the temporary download directory in one of the following ways:

Specify defaultTempFileDir=xxx in the configuration file.

Specify -tempFileDir=xxx when executing the cp command.

What should I do if tosutil reports "server returned an invalid body"?

This error typically occurs when the domain name or endpoint of your TOS service is configured incorrectly. Currently, TOS SDKs only support TOS endpoints, not S3 endpoints. For example, the TOS endpoint for Beijing is tos-cn-beijing.volces.com, and the S3 endpoint for Beijing is tos-s3-cn-beijing.volces.com.

You must configure the domain name to a TOS endpoint. For more information, see Regions and endpoints.

What should I do if the progress bar resets to zero or goes backwards when I'm uploading or downloading large files with tosutil?

This issue is usually caused by a slow or unstable network connection. This causes tosutil to retry, during which time progress is recalculated.

First, check for network problems. If you cannot solve the problem, try specifying a smaller part size when executing the command. For example, set -ps=5mb when using the command.

If these steps do not solve the problem, submit a ticket to contact our technical team.

What should I do if tosutil reports "use of closed network connection" when uploading?

This error is usually caused by an unstable network connection between the client and the TOS server, or by a client request that exceeds the available bandwidth. You can try the following:

Troubleshoot network problems.

Adjust the configuration and execution parameters of tosutil. Set the -p and -j parameters to lower values and do not set the concurrency too high. Example:

# .tosutilconfig file

# Incerase the number of retries
maxRetryCount=10
# Increase timeout
socketTimeout=300

If these steps do not solve the problem, submit a ticket to contact our technical team.

What is the process for changing the access credentials of tosutil?

To change the access credentials, you need to re-initialize tosutil. See Step 1: Initialize tosutil for instructions.

What should I do if some files fail to upload using the tosutil cp command?

We recommend checking the logs at /root/.tosutil_log/tosutil.log and using the error details in the logs to troubleshoot the issue.

tip

The default path for tosutil logs is /root/.tosutil_log/tosutil.log. You can modify the path in the tosutil configuration file or retrieve it from the file.

How can I limit the size and number of the tosutil log files?

The size and number of log files can be specified through the utilMaxLogSize and utilLogBackups parameters in the tosutil configuration file. For more information, see tosutil configuration parameters.

Last updated: 2025.12.17 18:33:42