9b6f3366ac
The script generates the MaxCtrl documentation by exporting the help output into a Markdown document.
54 lines
1.3 KiB
Bash
Executable File
54 lines
1.3 KiB
Bash
Executable File
#!/bin/bash
|
|
|
|
ITEMS=`node maxctrl.js help|awk '/^$/{p=0} {if(p){print $1}}/Commands:/{p=1}'`
|
|
|
|
TOC=$(for i in $ITEMS
|
|
do
|
|
echo "* [$i](#$i)"
|
|
done)
|
|
|
|
COMMANDS=$(for i in $ITEMS
|
|
do
|
|
echo "### \`$i\`"
|
|
echo
|
|
echo "\`\`\`"
|
|
node maxctrl.js help $i|awk 'BEGIN{p=1} /Global Options:/{p=0}{if(p){print $0}}'
|
|
echo "\`\`\`"
|
|
echo
|
|
done)
|
|
|
|
GLOBALOPTS=$(node maxctrl.js help $i|awk '{if(p){print $0}} /Global Options:/{p=1}')
|
|
|
|
cat <<EOF > ../Documentation/Reference/MaxCtrl.md
|
|
# MaxCtrl
|
|
|
|
MaxCtrl is a command line administrative client for MaxScale which uses
|
|
the MaxScale REST API for communication. It is intended to be the
|
|
replacement software for the legacy MaxAdmin command line client.
|
|
|
|
By default, the MaxScale REST API listens on port 8989 on the local host. The
|
|
default credentials for the REST API are \`admin:mariadb\`. The users used by the
|
|
REST API are the same that are used by the MaxAdmin network interface. This
|
|
means that any users created for the MaxAdmin network interface should work with
|
|
the MaxScale REST API and MaxCtrl.
|
|
|
|
For more information about the MaxScale REST API, refer to the
|
|
[REST API documentation](../REST-API/API.md) and the
|
|
[Configuration Guide](../Getting-Started/Configuration-Guide.md).
|
|
|
|
# Commands
|
|
|
|
$TOC
|
|
|
|
# Options
|
|
|
|
All command accept the following global options.
|
|
|
|
\`\`\`
|
|
$GLOBALOPTS
|
|
\`\`\`
|
|
|
|
$COMMANDS
|
|
|
|
EOF
|