+++ /dev/null
-# we can use CEPH_CONF to override the normal configuration file location.
- $ env CEPH_CONF=from-env ceph-conf -s foo bar
- global_init: unable to open config file. (re)
- [1]
-
-# command-line arguments should override environment
- $ env -u CEPH_CONF ceph-conf -c from-args
- global_init: unable to open config file. (re)
- [1]
-
+++ /dev/null
- $ ceph-conf --help
- Ceph configuration query tool
-
- USAGE
- ceph-conf <flags> <action>
-
- ACTIONS
- -L|--list-all-sections List all sections
- -l|--list-sections <prefix> List sections with the given prefix
- --filter-key <key> Filter section list to only include sections
- with given key defined.
- --filter-key-value <key>=<val> Filter section list to only include sections
- with given key/value pair.
- --lookup <key> Print a configuration setting to stdout.
- Returns 0 (success) if the configuration setting is
- found; 1 otherwise.
- -r|--resolve-search search for the first file that exists and
- can be opened in the resulted comma
- delimited search list.
-
- FLAGS
- --name name Set type.id
- [-s <section>] Add to list of sections to search
-
- If there is no action given, the action will default to --lookup.
-
- EXAMPLES
- [$] ceph-conf --name mon.0 -c /etc/ceph/ceph.conf 'mon addr' (re)
- Find out what the value of 'mon add' is for monitor 0.
-
- [$] ceph-conf -l mon (re)
- List sections beginning with 'mon'.
-
- RETURN CODE
- Return code will be 0 on success; error code otherwise.
- [1]
+++ /dev/null
- $ cat >test.conf <<EOF
- > [bar]
- > bar = green
- > EOF
-
-# TODO output an error
- $ ceph-conf -c test.conf broken
- [1]
-
- $ ceph-conf -c test.conf --name total.garbage
- You must pass a string of the form TYPE.ID to the --name option. Valid types are: auth, mon, osd, mds, client
- [1]
-
- $ ceph-conf -c test.conf -s bar
- You must give an action, such as --lookup or --list-all-sections.
- Pass --help for more help.
- [1]
+++ /dev/null
-# setup
- $ cat >foo.conf <<'EOF'
- > ; ---------------------
- > [group cephnet]
- > addr = 10.3.14.0/24
- >
- > [global]
- > pid file = /home/sage/ceph/src/out/$name.pid
- >
- > [osd]
- > osd data = /mnt/osd$id
- > [osd.3]
- > host = cosd3
- > EOF
-
-To extract the value of the "osd data" option for the osd0 daemon,
-
- $ ceph-conf -c foo.conf "osd data" --name osd.0
- /mnt/osd0
-
-This is equivalent to doing specifying sections [osd0], [osd.0],
-[osd], or [global], in that order of preference:
-
-# TODO the "admin" here seems like an actual bug
-
- $ ceph-conf -c foo.conf "osd data" -s osd0 -s osd.0 -s osd -s global
- /mnt/osdadmin
-
-To list all sections that begin with osd:
-
- $ ceph-conf -c foo.conf -l osd
- osd
- osd.3
+++ /dev/null
- $ cat >test.conf <<EOF
- > [bar]
- > bar = green
- > [foo]
- > bar = blue
- > [baz]
- > bar = yellow
- > [thud]
- > bar = red
- > [nobar]
- > other = 42
- > EOF
-
- $ ceph-conf -c test.conf bar -s foo
- blue
-
-# test the funny "equals sign" argument passing convention
- $ ceph-conf --conf=test.conf bar -s foo
- blue
-
- $ ceph-conf --conf=test.conf -L
- bar
- baz
- foo
- global
- nobar
- thud
-
- $ ceph-conf --conf=test.conf --list-all-sections
- bar
- baz
- foo
- global
- nobar
- thud
-
- $ ceph-conf --conf=test.conf --list_all_sections
- bar
- baz
- foo
- global
- nobar
- thud
-
-# TODO man page stops in the middle of a sentence
-
- $ ceph-conf -c test.conf bar -s xyzzy
- [1]
-
- $ ceph-conf -c test.conf bar -s xyzzy
- [1]
-
- $ ceph-conf -c test.conf bar -s xyzzy -s thud
- red
-
- $ ceph-conf -c test.conf bar -s nobar -s thud
- red
-
- $ ceph-conf -c test.conf bar -s thud -s baz
- red
-
- $ ceph-conf -c test.conf bar -s baz -s thud
- yellow
-
- $ ceph-conf -c test.conf bar -s xyzzy -s nobar -s thud -s baz
- red
-
+++ /dev/null
- $ cat >test.conf <<EOF
- > [bar]
- > bar = green
- > [foo]
- > bar = blue
- > [baz]
- > bar = yellow
- > [thud]
- > bar = yellow
- > EOF
-
- $ ceph-conf -c test.conf -l bar
- bar
-
- $ ceph-conf -c test.conf -l b
- bar
- baz
-
+++ /dev/null
- $ ceph-conf
- You must give an action, such as --lookup or --list-all-sections.
- Pass --help for more help.
- [1]
--- /dev/null
+# we can use CEPH_CONF to override the normal configuration file location.
+ $ env CEPH_CONF=from-env ceph-conf -s foo bar
+ global_init: unable to open config file. (re)
+ [1]
+
+# command-line arguments should override environment
+ $ env -u CEPH_CONF ceph-conf -c from-args
+ global_init: unable to open config file. (re)
+ [1]
+
--- /dev/null
+ $ ceph-conf --help
+ Ceph configuration query tool
+
+ USAGE
+ ceph-conf <flags> <action>
+
+ ACTIONS
+ -L|--list-all-sections List all sections
+ -l|--list-sections <prefix> List sections with the given prefix
+ --filter-key <key> Filter section list to only include sections
+ with given key defined.
+ --filter-key-value <key>=<val> Filter section list to only include sections
+ with given key/value pair.
+ --lookup <key> Print a configuration setting to stdout.
+ Returns 0 (success) if the configuration setting is
+ found; 1 otherwise.
+ -r|--resolve-search search for the first file that exists and
+ can be opened in the resulted comma
+ delimited search list.
+
+ FLAGS
+ --name name Set type.id
+ [-s <section>] Add to list of sections to search
+
+ If there is no action given, the action will default to --lookup.
+
+ EXAMPLES
+ [$] ceph-conf --name mon.0 -c /etc/ceph/ceph.conf 'mon addr' (re)
+ Find out what the value of 'mon add' is for monitor 0.
+
+ [$] ceph-conf -l mon (re)
+ List sections beginning with 'mon'.
+
+ RETURN CODE
+ Return code will be 0 on success; error code otherwise.
+ [1]
--- /dev/null
+ $ cat >test.conf <<EOF
+ > [bar]
+ > bar = green
+ > EOF
+
+# TODO output an error
+ $ ceph-conf -c test.conf broken
+ [1]
+
+ $ ceph-conf -c test.conf --name total.garbage
+ You must pass a string of the form TYPE.ID to the --name option. Valid types are: auth, mon, osd, mds, client
+ [1]
+
+ $ ceph-conf -c test.conf -s bar
+ You must give an action, such as --lookup or --list-all-sections.
+ Pass --help for more help.
+ [1]
--- /dev/null
+# setup
+ $ cat >foo.conf <<'EOF'
+ > ; ---------------------
+ > [group cephnet]
+ > addr = 10.3.14.0/24
+ >
+ > [global]
+ > pid file = /home/sage/ceph/src/out/$name.pid
+ >
+ > [osd]
+ > osd data = /mnt/osd$id
+ > [osd.3]
+ > host = cosd3
+ > EOF
+
+To extract the value of the "osd data" option for the osd0 daemon,
+
+ $ ceph-conf -c foo.conf "osd data" --name osd.0
+ /mnt/osd0
+
+This is equivalent to doing specifying sections [osd0], [osd.0],
+[osd], or [global], in that order of preference:
+
+# TODO the "admin" here seems like an actual bug
+
+ $ ceph-conf -c foo.conf "osd data" -s osd0 -s osd.0 -s osd -s global
+ /mnt/osdadmin
+
+To list all sections that begin with osd:
+
+ $ ceph-conf -c foo.conf -l osd
+ osd
+ osd.3
--- /dev/null
+ $ cat >test.conf <<EOF
+ > [bar]
+ > bar = green
+ > [foo]
+ > bar = blue
+ > [baz]
+ > bar = yellow
+ > [thud]
+ > bar = red
+ > [nobar]
+ > other = 42
+ > EOF
+
+ $ ceph-conf -c test.conf bar -s foo
+ blue
+
+# test the funny "equals sign" argument passing convention
+ $ ceph-conf --conf=test.conf bar -s foo
+ blue
+
+ $ ceph-conf --conf=test.conf -L
+ bar
+ baz
+ foo
+ global
+ nobar
+ thud
+
+ $ ceph-conf --conf=test.conf --list-all-sections
+ bar
+ baz
+ foo
+ global
+ nobar
+ thud
+
+ $ ceph-conf --conf=test.conf --list_all_sections
+ bar
+ baz
+ foo
+ global
+ nobar
+ thud
+
+# TODO man page stops in the middle of a sentence
+
+ $ ceph-conf -c test.conf bar -s xyzzy
+ [1]
+
+ $ ceph-conf -c test.conf bar -s xyzzy
+ [1]
+
+ $ ceph-conf -c test.conf bar -s xyzzy -s thud
+ red
+
+ $ ceph-conf -c test.conf bar -s nobar -s thud
+ red
+
+ $ ceph-conf -c test.conf bar -s thud -s baz
+ red
+
+ $ ceph-conf -c test.conf bar -s baz -s thud
+ yellow
+
+ $ ceph-conf -c test.conf bar -s xyzzy -s nobar -s thud -s baz
+ red
+
--- /dev/null
+ $ cat >test.conf <<EOF
+ > [bar]
+ > bar = green
+ > [foo]
+ > bar = blue
+ > [baz]
+ > bar = yellow
+ > [thud]
+ > bar = yellow
+ > EOF
+
+ $ ceph-conf -c test.conf -l bar
+ bar
+
+ $ ceph-conf -c test.conf -l b
+ bar
+ baz
+
--- /dev/null
+ $ ceph-conf
+ You must give an action, such as --lookup or --list-all-sections.
+ Pass --help for more help.
+ [1]