summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--usr.bin/gcore/gcore.115
1 files changed, 8 insertions, 7 deletions
diff --git a/usr.bin/gcore/gcore.1 b/usr.bin/gcore/gcore.1
index d3b1cd5..59b6b03 100644
--- a/usr.bin/gcore/gcore.1
+++ b/usr.bin/gcore/gcore.1
@@ -59,12 +59,13 @@ The following options are available:
Write the core file to the specified file instead of
.Dq Pa core.<pid> .
.It Fl f
-Dumps all the available segments, excluding only the malformed ones and
-un-dumpable ones. Unlike the default invocation, it also dumps
-device- and sglist-mapped areas that may invalidate the state of
-some transactions. This flag must be used very carefully, when the
-behavior of the application is fully understood and the fallouts can
-be easily controlled.
+Dumps all available segments, excluding only malformed and undumpable segments.
+Unlike the default invocation, this flag dumps mappings of devices which
+may invalidate the state of device transactions or trigger other unexpected
+behavior.
+As a result, this flag should only be used when the behavior of the
+application and any devices it has mapped is fully understood and any side
+effects can be controlled or tolerated.
.It Fl s
Stop the process while gathering the core image, and resume it
when done.
@@ -90,7 +91,7 @@ Because of the
.Xr ptrace 2
usage
.Nm
-may not work with processes which are actively investigated with
+may not work with processes which are actively being investigated with
.Xr truss 1
or
.Xr gdb 1 .
OpenPOWER on IntegriCloud