@@ -46,7 +46,8 @@ man1_MANS = \
ndctl-inject-error.1 \
ndctl-inject-smart.1 \
ndctl-update-firmware.1 \
- ndctl-list.1
+ ndctl-list.1 \
+ ndctl-monitor.1
CLEANFILES = $(man1_MANS)
new file mode 100644
@@ -0,0 +1,96 @@
+ndctl-monitor(1)
+================
+
+NAME
+----
+ndctl-monitor - Monitor the smart events of nvdimm objects
+
+SYNOPSIS
+--------
+[verse]
+'ndctl monitor' [<options>]
+
+DESCRIPTION
+-----------
+Ndctl monitor is used for monitoring the smart events of nvdimm
+objects and dumping the json format notifications to syslog or
+a logfile.
+
+The objects to monitor and smart evnets to notify can be selected
+by setting options and/or the default configuration file
+(/etc/ndctl/monitor.conf). Both of the values in configuration file
+and in options will work. If conflict, the values in options will
+override the values in configuration file. The changed values in
+configuration file will work after restart ndctl monitor.
+
+EXAMPLES
+--------
+
+Run a monitor as a daemon to monitor DIMMs on a provider named ndbus1
+[verse]
+ndctl monitor -b ndbus1 -f
+
+Run a monitor as a one-shot command and output the notifications to
+/var/log/ndctl.log
+[verse]
+ndctl monitor -l /var/log/ndctl.log
+
+Run a monitor daemon as a system service
+[verse]
+systemctl start ndctl-monitor.service
+
+OPTIONS
+-------
+-b::
+--bus=::
+ Enforce that the operation only be carried on devices that are
+ attached to the given bus. Where 'bus' can be a provider name
+ or a bus id number.
+
+-d::
+--dimm=::
+ A 'nmemX' device name, or dimm id number. Select the devices to
+ monitor refrerence the given dimm.
+
+-r::
+--region=::
+ A 'regionX' device name, or a region id number. The keyword 'all'
+ can be specified to carry out the operation on every region in
+ the system, optionally filtered by bus id (see --bus= option).
+
+-n::
+--namespace=::
+ A 'namespaceX.Y' device name, or namespace region plus id tuple
+ 'X.Y'.
+
+-l <file | syslog>::
+--logfile=<file | syslog>::
+ Output notifications to <file> or syslog.
+
+-f::
+--daemon::
+ Run a monitor as a daemon.
+
+-D::
+--dimm-event=::
+ A name of smart events come NVDIMM DIMMs.
+ - "dimm-spares-remaining": Spare Blocks Remaining value has gone
+ below the pre-programmed threshold limit
+ - "dimm-media-temperature": NVDIMM Media temperature value has
+ gone above the pre-programmed threshold limit
+ - "dimm-controller-temperature": NVDIMM Controller temperature
+ value has gone above the pre-programmed threshold limit
+ - "dimm-health-state": NVDIMM Normal Health Status has changed
+ - "dimm-unclean-shutdown": NVDIMM Last Shutdown Status was a dirty
+ shutdown.
+
+COPYRIGHT
+---------
+Copyright (c) 2018, FUJITSU LIMITED. License GPLv2: GNU GPL version 2
+<http://gnu.org/licenses/gpl.html>. This is free software: you are
+free to change and redistribute it. There is NO WARRANTY, to the
+extent permitted by law.
+
+SEE ALSO
+--------
+linkndctl:ndctl-list[1]
This patch is used to add manpage for ndctl monitor command. Signed-off-by: QI Fuli <qi.fuli@jp.fujitsu.com> --- Documentation/ndctl/Makefile.am | 3 +- Documentation/ndctl/ndctl-monitor.txt | 96 +++++++++++++++++++++++++++ 2 files changed, 98 insertions(+), 1 deletion(-) create mode 100644 Documentation/ndctl/ndctl-monitor.txt