+Note that if you plan to rotate (see man:lttng-concepts(7) to learn
+more) the selected recording session, this target only regenerates the
+metadata stream files of the current and next trace chunks.
+
+[IMPORTANT]
+====
+You can only use the `metadata` target when the selected
+recording session:
+
+* Is not in live mode (nloption:--live option of
+ man:lttng-create(1)).
+
+* If it has user space channels, they're configured to use a
+ per-user buffering scheme (nloption:--buffers-uid option of
+ man:lttng-enable-channel(1)).
++
+See man:lttng-concepts(7) to learn more about channels.
+====
+
+
+Regenerate the state dump event records of a recording session
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Use the `statedump` target to collect up-to-date state dump information
+and create corresponding event records.
+
+This is particularly useful if the selected recording session is in
+snapshot mode (nloption:--snapshot option of the man:lttng-create(1)
+command) or if LTTng rotates trace files for one of its channels (see
+man:lttng-concepts(7)): in both cases, the state dump information may be
+lost.
+
+
+include::common-lttng-cmd-options-head.txt[]