'\" t
.\"     Title: cxl-monitor
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2024-01-12
.\"    Manual: cxl Manual
.\"    Source: cxl
.\"  Language: English
.\"
.TH "CXL\-MONITOR" "1" "2024-01-12" "cxl" "cxl Manual"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
cxl-monitor \- Monitor the CXL trace events
.SH "SYNOPSIS"
.sp
.nf
\fIcxl monitor\fP [<options>]
.fi
.br
.SH "DESCRIPTION"
.sp
cxl\-monitor is used for monitoring the CXL trace events emitted by
the kernel and convert them to json objects and dumping the json format
notifications to standard output or a logfile.
.SH "EXAMPLES"
.sp
Run a monitor as a daemon to monitor events and output to a log file.
.sp
.nf
cxl monitor \-\-daemon \-\-log=/var/log/cxl\-monitor.log
.fi
.br
.sp
Run a monitor as a one\-shot command and output the notifications to stdio.
.sp
.nf
cxl monitor
.fi
.br
.sp
Run a monitor daemon as a system service
.sp
.nf
systemctl start cxl\-monitor.service
.fi
.br
.SH "OPTIONS"
.sp
\-l, \-\-log=
.RS 4
Send log messages to the specified destination.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"<file>":
Send log messages to specified <file>.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
"standard":
Send messages to standard output.
.RE
.RE
.sp
The default log destination is \fI/var/log/cxl\-monitor.log\fP if "\-\-daemon" is specified,
otherwise \fIstandard\fP. Note that standard and relative path for <file>
will not work if "\-\-daemon" is specified.
.sp
\-\-daemon
.RS 4
Run a monitor as a daemon.
.RE
.sp
\-v, \-\-verbose
.RS 4
Emit more debug messages
.RE
.sp
\-u, \-\-human
.RS 4
By default the command will output machine\-friendly raw\-integer
data. Instead, with this flag, numbers representing storage size
will be formatted as human readable strings with units, other
fields are converted to hexadecimal strings.
.RE
.SH "COPYRIGHT"
.sp
Copyright \(co 2016 \- 2022, Intel Corporation. License GPLv2: GNU GPL
version 2 \c
.URL "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.
.SH "SEE ALSO"
.sp
cxl\-list(1)