aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Asselstine <benasselstine@gmail.com>2021-06-03 21:25:15 +0930
committerAlan Modra <amodra@gmail.com>2021-06-03 21:26:33 +0930
commitbbd47c1230b3fbc25e6292ea3f2f5d275d4d459a (patch)
tree5a953db079d0418465433394d6a19ec61a795a8c
parent364d77297723712a2952072fd6768601f17070bd (diff)
downloadfsf-binutils-gdb-bbd47c1230b3fbc25e6292ea3f2f5d275d4d459a.zip
fsf-binutils-gdb-bbd47c1230b3fbc25e6292ea3f2f5d275d4d459a.tar.gz
fsf-binutils-gdb-bbd47c1230b3fbc25e6292ea3f2f5d275d4d459a.tar.bz2
PR4283, update gprof manual with note about GMON_OUT_PREFIX
PR 4283 * gprof.texi (Executing): Note GMON_OUT_PREFIX environment variable.
-rw-r--r--gprof/ChangeLog5
-rw-r--r--gprof/gprof.texi8
2 files changed, 10 insertions, 3 deletions
diff --git a/gprof/ChangeLog b/gprof/ChangeLog
index 24deb11..6d73b3c 100644
--- a/gprof/ChangeLog
+++ b/gprof/ChangeLog
@@ -1,3 +1,8 @@
+2021-06-03 Ben Asselstine <benasselstine@gmail.com>
+
+ PR 4283
+ * gprof.texi (Executing): Note GMON_OUT_PREFIX environment variable.
+
2021-05-08 Mike Frysinger <vapier@gentoo.org>
* Makefile.am (html-local, doc/gprof/index.html): New targets.
diff --git a/gprof/gprof.texi b/gprof/gprof.texi
index b2b2048..5085159 100644
--- a/gprof/gprof.texi
+++ b/gprof/gprof.texi
@@ -381,9 +381,11 @@ initialization and in cleanup, but not much else.
Your program will write the profile data into a file called @file{gmon.out}
just before exiting. If there is already a file called @file{gmon.out},
-its contents are overwritten. There is currently no way to tell the
-program to write the profile data under a different name, but you can rename
-the file afterwards if you are concerned that it may be overwritten.
+its contents are overwritten. You can rename the file afterwards if you
+are concerned that it may be overwritten. If your system libc allows you
+may be able to write the profile data under a different name. Set the
+GMON_OUT_PREFIX environment variable; this name will be appended with
+the PID of the running program.
In order to write the @file{gmon.out} file properly, your program must exit
normally: by returning from @code{main} or by calling @code{exit}. Calling