Blame SOURCES/0002-add-manpages.patch

05d305
From ecac3e25a416bd66b19bc3074f9583dfd965a919 Mon Sep 17 00:00:00 2001
05d305
From: Andreas Gerstmayr <agerstmayr@redhat.com>
05d305
Date: Wed, 22 Jun 2022 17:01:09 +0200
05d305
Subject: [PATCH] add manpages
05d305
05d305
3d91f6
diff --git a/docs/man/man1/grafana-cli.1 b/docs/man/man1/grafana-cli.1
3d91f6
new file mode 100644
05d305
index 0000000000..39c0d5cee0
3d91f6
--- /dev/null
3d91f6
+++ b/docs/man/man1/grafana-cli.1
05d305
@@ -0,0 +1,63 @@
05d305
+.TH GRAFANA "1" "September 2022" "Grafana cli version 9.0.9" "User Commands"
3d91f6
+.SH NAME
3d91f6
+grafana-cli \- command line administration for the Grafana metrics dashboard and graph editor
3d91f6
+.SH DESCRIPTION
3d91f6
+.SS "NAME:"
3d91f6
+.IP
3d91f6
+grafana-cli
3d91f6
+.SS "USAGE:"
3d91f6
+.IP
3d91f6
+\fBgrafana\-cli\fP [\fIglobal options\fP] \fIcommand\fP [\fIcommand options\fP] [\fIarguments\fP...]
3d91f6
+.SS "COMMANDS:"
3d91f6
+.TP
3d91f6
+plugins
3d91f6
+Manage plugins for grafana
3d91f6
+.TP
3d91f6
+admin
3d91f6
+Grafana admin commands
3d91f6
+.TP
05d305
+cue
05d305
+Cue validation commands
05d305
+.TP
3d91f6
+help, h
3d91f6
+Shows a list of commands or help for one command
3d91f6
+.SS "GLOBAL OPTIONS:"
3d91f6
+.TP
3d91f6
+\fB\-\-pluginsDir\fR value
3d91f6
+path to the grafana plugin directory (default: "/var/lib/grafana/plugins") [$GF_PLUGIN_DIR]
3d91f6
+.TP
3d91f6
+\fB\-\-repo\fR value
3d91f6
+url to the plugin repository (default: "https://grafana.com/api/plugins") [$GF_PLUGIN_REPO]
3d91f6
+.TP
3d91f6
+\fB\-\-pluginUrl\fR value
3d91f6
+Full url to the plugin zip file instead of downloading the plugin from grafana.com/api [$GF_PLUGIN_URL]
3d91f6
+.TP
3d91f6
+\fB\-\-insecure\fR
05d305
+Skip TLS verification (insecure) (default: false)
3d91f6
+.TP
05d305
+\fB\-\-debug\fR
05d305
+Enable debug logging (default: false)
3d91f6
+.TP
3d91f6
+\fB\-\-configOverrides\fR value
3d91f6
+Configuration options to override defaults as a string. e.g. cfg:default.paths.log=/dev/null
3d91f6
+.TP
3d91f6
+\fB\-\-homepath\fR value
3d91f6
+Path to Grafana install/home path, defaults to working directory
3d91f6
+.TP
3d91f6
+\fB\-\-config\fR value
3d91f6
+Path to config file
3d91f6
+.TP
3d91f6
+\fB\-\-help\fR, \fB\-h\fR
3d91f6
+show help
3d91f6
+.TP
3d91f6
+\fB\-\-version\fR, \fB\-v\fR
3d91f6
+print the version
3d91f6
+.SH "SEE ALSO"
3d91f6
+Additional documentation for
3d91f6
+.B grafana-cli
3d91f6
+is available on-line at
3d91f6
+.BR http://docs.grafana.org/administration/cli/ .
3d91f6
+The full documentation for
3d91f6
+.B Grafana
3d91f6
+is available on-line at
3d91f6
+.BR http://docs.grafana.org/ .
3d91f6
diff --git a/docs/man/man1/grafana-server.1 b/docs/man/man1/grafana-server.1
3d91f6
new file mode 100644
05d305
index 0000000000..683a2369cc
3d91f6
--- /dev/null
3d91f6
+++ b/docs/man/man1/grafana-server.1
05d305
@@ -0,0 +1,80 @@
05d305
+.TH VERSION "1" "September 2022" "Version 9.0.9" "User Commands"
3d91f6
+.SH NAME
3d91f6
+grafana-server \- back-end server for the Grafana metrics dashboard and graph editor
3d91f6
+.SH DESCRIPTION
3d91f6
+.B grafana-server
3d91f6
+is the back-end server for the Grafana metrics dashboard and graph editor.
3d91f6
+The
3d91f6
+.B grafana-server
3d91f6
+program should not normally be run from the command line,
3d91f6
+except when testing or for development purposes.
3d91f6
+Rather it should be managed by
3d91f6
+.BR systemd .
3d91f6
+After installing Grafana, the systemd service should be enabled and started as follows:
3d91f6
+.P
3d91f6
+.in 1i
3d91f6
+.B systemctl daemon-reload
3d91f6
+.br
3d91f6
+.B systemctl enable grafana-server.service
3d91f6
+.br
3d91f6
+.B systemctl start grafana-server.service
3d91f6
+.in
3d91f6
+.P
3d91f6
+.SH OPTIONS
3d91f6
+The
05d305
+.B grafana-server
3d91f6
+configuration is specified in
3d91f6
+.BR /etc/grafana/grafana.ini
3d91f6
+and is well documented with comments.
3d91f6
+The command-line options listed below override options of
3d91f6
+the same (or similar) name in the configuration file.
3d91f6
+.P
3d91f6
+.HP
3d91f6
+\fB\-config\fR string
3d91f6
+.IP
3d91f6
+path to config file
3d91f6
+.HP
3d91f6
+\fB\-homepath\fR string
3d91f6
+.IP
3d91f6
+path to grafana install/home path, defaults to working directory
3d91f6
+.HP
3d91f6
+\fB\-packaging\fR string
3d91f6
+.IP
3d91f6
+describes the way Grafana was installed (default "unknown")
3d91f6
+.HP
3d91f6
+\fB\-pidfile\fR string
3d91f6
+.IP
3d91f6
+path to pid file
3d91f6
+.HP
3d91f6
+\fB\-profile\fR
3d91f6
+.IP
3d91f6
+Turn on pprof profiling
3d91f6
+.HP
05d305
+\fB\-profile\-addr\fR string
05d305
+.IP
05d305
+Define custom address for profiling (default "localhost")
05d305
+.HP
3d91f6
+\fB\-profile\-port\fR uint
3d91f6
+.IP
3d91f6
+Define custom port for profiling (default 6060)
3d91f6
+.HP
3d91f6
+\fB\-tracing\fR
3d91f6
+.IP
3d91f6
+Turn on tracing
3d91f6
+.HP
3d91f6
+\fB\-tracing\-file\fR string
3d91f6
+.IP
3d91f6
+Define tracing output file (default "trace.out")
3d91f6
+.TP
3d91f6
+\fB\-v\fR
3d91f6
+.IP
3d91f6
+prints current version and exits
05d305
+.TP
05d305
+\fB\-vv\fR
05d305
+.IP
05d305
+prints current version, all dependencies and exits
3d91f6
+.SH "SEE ALSO"
3d91f6
+The full documentation for
3d91f6
+.B Grafana
3d91f6
+is available on-line at
3d91f6
+.BR http://docs.grafana.org/ .