Scroll to navigation

CASUPLOAD(1) User Commands CASUPLOAD(1)

NAME

casupload - casupload

SYNOPSIS

casupload

DESCRIPTION

Display usage and exit.
Print version information and exit. [optional]
URL for the CAS service [optional]
Name of the CAS instance [optional]
Server TLS certificate for CAS (PEM-encoded) [optional]
Client private TLS key for CAS (PEM-encoded) [optional]
Client TLS certificate for CAS (PEM-encoded) [optional]
Authentication token for CAS (JWT, OAuth token etc), will be included as an HTTP Authorization bearer token [optional]
Access token refresh timeout for CAS service [optional]
Use GoogleAPIAuth for CAS service [optional]
Credential helper executable for CAS service [optional]
Retry limit for gRPC errors for CAS service [optional]
Retry delay for gRPC errors for CAS service [optional]
gRPC status code(s) as string(s) to retry on for CAS service e.g., 'UNKNOWN', 'INTERNAL' [optional]
Timeout for gRPC requests for CAS service (set to 0 to disable timeout) [optional]
Minimum throughput for gRPC requests for CAS service, bytes per seconds. The value may be suffixed with K, M, G or T. [optional]
gRPC keepalive pings period for CAS service (set to 0 to disable keepalive pings) [optional]
gRPC load balancing policy for CAS service (valid options are 'round_robin' and 'grpclb') [optional]
Follow symlinks in the inputs [optional]
Capture mtime of files to be uploaded [optional]
Capture Unix mode of files to be uploaded [optional]
Allow temporary chmod to read unreadable files during upload [optional]
Bit mask in the octal format to turn off bits in captured unix modes of files, e.g. --file-umask=0222 makes all files non-writable [optional]
Node property attached to the uploaded path, e.g. --node-property foo=bar [optional]
Calculate and print digests, do not upload anything [optional]
Set a custom digest function. Default: SHA256 Supported functions: SHA512, SHA384, SHA256, SHA1, MD5 [optional]
Write output root digest to the file in the form "<HASH>/<SIZE_BYTES>" [optional]
Write output tree digest to the file in the form "<HASH>/<SIZE_BYTES>" [optional]
Ignore files in the input directories that match the patterns in the specified file. Patterns format is as in .gitignore except ! and ** are not supported. [optional]
Set the format to upload directories in. '--directory-format=root' will upload individually and return a digest of the root directory. '--directory-format=tree' will upload as a single tree message. '--directory-format=both' will do both. [optional]
The number of threads to upload blobs to remote CAS. Default=min(hardware-concurrency*2,32) [optional]
The number of threads to hash files to digests. Default=min(hardware-concurrency,16) [optional]
Use the LocalCAS API to capture directories. This requires connecting to buildbox-casd. [optional]
Skip caching blobs in the LocalCAS storage when using the LocalCAS API. This has no effect if `--use-localcas` isn't set. [optional]
[Deprecated] Use --remote [optional]
Log level (debug, error, info, trace, warning) [optional, default = "error"]
Set log level to 'debug' [optional] POSITIONAL [required]

Uploads the given files and directories to CAS, then prints the digest hash and size of the corresponding Directory messages.

The files are placed in CAS subdirectories corresponding to their paths. For example, 'casupload file1.txt subdir/file2.txt' would create a CAS directory containing file1.txt and a subdirectory called 'subdir' containing file2.txt.

The directories will be uploaded individually as merkle trees. The merkle tree for a directory will contain all of the content within the directory.

Example usage: casupload --remote=http://localhost:50051 foo.c foo.h

March 2026 casupload 1.4.0