s3cmd icon indicating copy to clipboard operation
s3cmd copied to clipboard

Default length of `--restore-days` not documented

Open mlissner opened this issue 4 years ago • 1 comments

A bunch of examples show how to restore from Glacier using the restore command like:

s3cmd restore s3://some-bucket/

When these guides omit the --restore-days parameter, I assume one is being set by default, because it works, but the length of the restoration isn't documented in the help file. I tried searching the code too, but couldn't find it. It'd be great to get this documented.

mlissner avatar Apr 23 '21 23:04 mlissner

@mlissner the default restore period is 1 day

robd003 avatar Sep 27 '21 01:09 robd003

Thanks @robd003 for the reply.

@mlissner I think that it is documented already for some time "Number of days to keep restored file available (only for 'restore' command). Default is 1 day.". Or am I mistaken?

fviard avatar Aug 28 '22 01:08 fviard

Guess I missed it or it got updated? Huh.

mlissner avatar Aug 28 '22 01:08 mlissner

Hello, the default number of restore days is still not documented, why is that ? image

ServaneC avatar Nov 23 '23 10:11 ServaneC

@ServaneC the default number of days for restoration documented in the man page here: https://github.com/s3tools/s3cmd/blob/master/s3cmd.1#L286-L288

It's also shown in the help message as you posted above. https://github.com/s3tools/s3cmd/blob/master/s3cmd#L3057

  -D NUM, --restore-days=NUM
                        Number of days to keep restored file available (only
                        for 'restore' command). Default is 1 day.

This has been in the code base since 2018, are you running an up to date version of s3cmd?

robd003 avatar Nov 25 '23 05:11 robd003

I was talking about the online documentation: https://s3tools.org/usage

ServaneC avatar Dec 06 '23 09:12 ServaneC