summaryrefslogtreecommitdiffstats
path: root/src/test/cli/ceph-authtool/manpage.t
diff options
context:
space:
mode:
Diffstat (limited to 'src/test/cli/ceph-authtool/manpage.t')
-rw-r--r--src/test/cli/ceph-authtool/manpage.t32
1 files changed, 32 insertions, 0 deletions
diff --git a/src/test/cli/ceph-authtool/manpage.t b/src/test/cli/ceph-authtool/manpage.t
new file mode 100644
index 000000000..3201aa37b
--- /dev/null
+++ b/src/test/cli/ceph-authtool/manpage.t
@@ -0,0 +1,32 @@
+ $ ceph-authtool
+ ceph-authtool: -h or --help for usage
+ [1]
+
+# demonstrate that manpage examples fail without config
+# TODO fix the manpage
+ $ ceph-authtool --create-keyring --name client.foo --gen-key keyring
+ creating keyring
+
+# work around the above
+ $ touch ceph.conf
+
+To create a new keyring containing a key for client.foo:
+
+ $ ceph-authtool --create-keyring --id foo --gen-key keyring
+ creating keyring
+
+ $ ceph-authtool --create-keyring --name client.foo --gen-key keyring
+ creating keyring
+
+To associate some capabilities with the key (namely, the ability to mount a Ceph filesystem):
+
+ $ ceph-authtool -n client.foo --cap mds 'allow' --cap osd 'allow rw pool=data' --cap mon 'allow r' keyring
+
+To display the contents of the keyring:
+
+ $ ceph-authtool -l keyring
+ [client.foo]
+ \\tkey = [a-zA-Z0-9+/]+=* \(esc\) (re)
+ \tcaps mds = "allow" (esc)
+ \tcaps mon = "allow r" (esc)
+ \tcaps osd = "allow rw pool=data" (esc)