radosgw-admin: mildly confusing man page and usage message

radosgw-admin: mildly confusing man page and usage message

[Florian Haas]

Hi,

just noticed that radosgw-admin comes with a bit of confusing content in
its man page and usage message:

EXAMPLES
       Generate a new user:

       $ radosgw-admin user gen --display-name="johnny rotten"
--email=johnny@rotten.com

As far as I remember "user gen" is gone, and it's now "user create".
However:

radosgw-admin user create --display-name="test" --email=test@demo
user_id was not specified, aborting

... is followed by a usage message that doesn't mention user_id anywhere
(the option string is --uid). So conceivably the example could also use
a mention of --uid.

Also, is there a way to retrieve the "next available" user_id or just
tell radosgw-admin to use max(user_id)+1?

If one of the Ceph guys could provide a quick comment on this, I can
send a patch to the man page RST. Thanks.

Cheers,
Florian

Re: radosgw-admin: mildly confusing man page and usage message

[Yehuda Sadeh]

On Mon, Jun 11, 2012 at 2:35 PM, Florian Haas <florian@hastexo.com> wrote:
> Hi,
>
> just noticed that radosgw-admin comes with a bit of confusing content in
> its man page and usage message:
>
> EXAMPLES
>       Generate a new user:
>
>       $ radosgw-admin user gen --display-name="johnny rotten"
> --email=johnny@rotten.com
>
> As far as I remember "user gen" is gone, and it's now "user create".
> However:
>
> radosgw-admin user create --display-name="test" --email=test@demo
> user_id was not specified, aborting
>
> ... is followed by a usage message that doesn't mention user_id anywhere
> (the option string is --uid). So conceivably the example could also use
> a mention of --uid.
>
> Also, is there a way to retrieve the "next available" user_id or just
> tell radosgw-admin to use max(user_id)+1?
>
> If one of the Ceph guys could provide a quick comment on this, I can
> send a patch to the man page RST. Thanks.
>

Minimum required to create a user:

radosgw-admin user create --uid=<user id> --display-name=<display name>

The user id is actually a user 'account' name, not necessarily a
numeric value. The email param is optional.

Yehuda
--
To unsubscribe from this list: send the line "unsubscribe ceph-devel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: radosgw-admin: mildly confusing man page and usage message

[Florian Haas]

On 06/11/12 23:39, Yehuda Sadeh wrote:
>> If one of the Ceph guys could provide a quick comment on this, I can
>> send a patch to the man page RST. Thanks.
>>
> 
> Minimum required to create a user:
> 
> radosgw-admin user create --uid=<user id> --display-name=<display name>
> 
> The user id is actually a user 'account' name, not necessarily a
> numeric value. The email param is optional.

Thanks. https://github.com/ceph/ceph/pull/13

Cheers,
Florian