.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.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
..
.TH "RGW-POLICY-TEST" "8" "Nov 02, 2026" "dev" "Ceph"
.SH NAME
rgw-policy-test \- test evaluation of bucket policy
.SH SYNOPSIS
.nf
\fBrgw\-policy\-test\fP
[\-e \fIkey*=*value\fP]... [\-t \fItenant\fP] [\-R resource] [\-I identity] \fIaction\fP \fIfilename\fP
.fi
.sp
.SH DESCRIPTION
.sp
This utility reads a policy from a file or stdin and evaluates it
against the supplied identity, resource, action, and request context
(the key/value pairs evaluated by conditions.) The utility will print
a trace of evaluating the policy and the effect of its evaluation.
.sp
On error it will print a message and return non\-zero.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-t *tenant*, \-\-tenant *tenant*
Specify \fItenant\fP as the tenant. If not provided, the default
(empty) tenant is used.
.UNINDENT
.INDENT 0.0
.TP
.B \-e *key*=*value*, \-\-environment *key*=*value*
Add (\fIkey\fP, \fIvalue\fP) to the environment for evaluation. May be
specified multiple times.
.UNINDENT
.INDENT 0.0
.TP
.B \-I *SCHEMA:STRING*, \-\-identity *SCHEMA:STRING*
Specify \fIidentity\fP as the identity whose access is to be checked.
.UNINDENT
.INDENT 0.0
.TP
.B \-R *ARN*, \-\-resource *ARN*
Specify \fIARN\fP as the resource for which to check access.
.UNINDENT
.INDENT 0.0
.TP
.B *action*
Use \fIaction\fP as the action to check.
.UNINDENT
.INDENT 0.0
.TP
.B *filename*
Read the policy from \fIfilename\fP, or \- for standard input.
.UNINDENT
.SH AVAILABILITY
.sp
\fBrgw\-policy\-test\fP is part of Ceph, a massively scalable, open\-source,
distributed storage system.  Please refer to the Ceph documentation at
\%<https://\:docs\:.ceph\:.com/> for more information.
.SH SEE ALSO
.sp
radosgw \%<>(8)
.SH Copyright
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" End of generated man page.