PR4283, update gprof manual with note about GMON_OUT_PREFIX
authorBen Asselstine <benasselstine@gmail.com>
Thu, 3 Jun 2021 11:55:15 +0000 (21:25 +0930)
committerAlan Modra <amodra@gmail.com>
Thu, 3 Jun 2021 11:56:33 +0000 (21:26 +0930)
PR 4283
* gprof.texi (Executing): Note GMON_OUT_PREFIX environment variable.

gprof/ChangeLog
gprof/gprof.texi

index 24deb11f95b3bcdd5a88e9d5bd2ce82c737871ee..6d73b3cc8c98102bb6cafe9159180750302ca34e 100644 (file)
@@ -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.
index b2b204822d819e9cbc372c47d697fcfeb4f606e1..5085159bc70a27e8a8ea5204a6f37f7bcb92a367 100644 (file)
@@ -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