mirror of
https://github.com/ceph/ceph
synced 2024-12-11 22:18:18 +00:00
92fa2ff8fc
Keeping the generated files in version control lets us support builds from scratch without requiring the full documentation toolchain to be installed. The files were just copied over from build-doc/output/man, after a ./admin/build-doc call. When redoing this, also take care to remove any roff output if a file was removed from doc/man, and update Makefile.am. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
183 lines
3.4 KiB
Groff
183 lines
3.4 KiB
Groff
.TH "RADOSGW_ADMIN" "8" "September 09, 2011" "dev" "Ceph"
|
|
.SH NAME
|
|
radosgw_admin \- rados REST gateway user administration utility
|
|
.
|
|
.nr rst2man-indent-level 0
|
|
.
|
|
.de1 rstReportMargin
|
|
\\$1 \\n[an-margin]
|
|
level \\n[rst2man-indent-level]
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
-
|
|
\\n[rst2man-indent0]
|
|
\\n[rst2man-indent1]
|
|
\\n[rst2man-indent2]
|
|
..
|
|
.de1 INDENT
|
|
.\" .rstReportMargin pre:
|
|
. RS \\$1
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
. nr rst2man-indent-level +1
|
|
.\" .rstReportMargin post:
|
|
..
|
|
.de UNINDENT
|
|
. RE
|
|
.\" indent \\n[an-margin]
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.nr rst2man-indent-level -1
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
..
|
|
.\" Man page generated from reStructeredText.
|
|
.
|
|
.SH SYNOPSIS
|
|
.nf
|
|
\fBradosgw_admin\fP \fIcommand\fP [ \fIoptions\fP \fI...\fP ]
|
|
.fi
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBradosgw_admin\fP is a RADOS gateway user administration utility. It
|
|
allows creating and modifying users.
|
|
.SH COMMANDS
|
|
.sp
|
|
\fIcommand\fP can be one of the following options:
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \fBuser create\fP
|
|
Create a new user
|
|
.TP
|
|
.B \fBuser modify\fP
|
|
Modify a user
|
|
.TP
|
|
.B \fBuser info\fP
|
|
Display information of a user
|
|
.TP
|
|
.B \fBuser rm\fP
|
|
Remove a user
|
|
.TP
|
|
.B \fBbucket list\fP
|
|
List all buckets
|
|
.TP
|
|
.B \fBbucket unlink\fP
|
|
Remove a bucket
|
|
.TP
|
|
.B \fBpolicy\fP
|
|
Display bucket/object policy
|
|
.TP
|
|
.B \fBlog show\fP
|
|
Show the log of a bucket (with a specified date)
|
|
.UNINDENT
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-c ceph.conf, \-\-conf=ceph.conf
|
|
Use \fIceph.conf\fP configuration file instead of the default
|
|
\fB/etc/ceph/ceph.conf\fP to determine monitor addresses during
|
|
startup.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-m monaddress[:port]
|
|
Connect to specified monitor (instead of looking through ceph.conf).
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-uid=uid
|
|
The S3 user/access key.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-secret=secret
|
|
The S3 secret.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-display\-name=name
|
|
Configure the display name of the user.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-email=email
|
|
The e\-mail address of the user
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-bucket=bucket
|
|
Specify the bucket name.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-object=object
|
|
Specify the object name.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-date=yyyy\-mm\-dd
|
|
The date need for some commands
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-os\-user=group:name
|
|
The OpenStack user (only needed for use with OpenStack)
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-os\-secret=key
|
|
The OpenStack key
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-auth\-uid=auid
|
|
The librados auid
|
|
.UNINDENT
|
|
.SH EXAMPLES
|
|
.sp
|
|
Generate a new user:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ radosgw_admin user gen \-\-display\-name="johnny rotten" \-\-email=johnny@rotten.com
|
|
User ID: CHBQFRTG26I8DGJDGQLW
|
|
Secret Key: QR6cI/31N+J0VKVgHSpEGVSfEEsmf6PyXG040KCB
|
|
Display Name: johnny rotten
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
Remove a user:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ radosgw_admin user rm \-\-uid=CHBQFRTG26I8DGJDGQLW
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
Remove a bucket:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ radosgw_admin bucket unlink \-\-bucket=foo
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
Show the logs of a bucket from April 1st 2011:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ radosgw_admin log show \-\-bucket=foo \-\-date=2011=04\-01
|
|
.ft P
|
|
.fi
|
|
.SH AVAILABILITY
|
|
.sp
|
|
\fBradosgw_admin\fP is part of the Ceph distributed file system. Please
|
|
refer to the Ceph wiki at \fI\%http://ceph.newdream.net/wiki\fP for more
|
|
information.
|
|
.SH SEE ALSO
|
|
.sp
|
|
\fBceph\fP(8)
|
|
.SH COPYRIGHT
|
|
2011, New Dream Network
|
|
.\" Generated by docutils manpage writer.
|
|
.\"
|
|
.
|