PR4283, update gprof manual with note about GMON_OUT_PREFIX
Alan Modra
amodra@gmail.com
Thu Jun 3 11:59:40 GMT 2021
Another very old bug with a patch, slightly modified by me.
PR 4283
* gprof.texi (Executing): Note GMON_OUT_PREFIX environment variable.
diff --git a/gprof/gprof.texi b/gprof/gprof.texi
index b2b204822d8..5085159bc70 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
--
Alan Modra
Australia Development Lab, IBM
More information about the Binutils
mailing list