Missing documentation on src/tracer/wrappers/OMP/genstubs-*.sh

[valentin-seitz]

This issue relates to #117
In the current version of Extrae (v4.2.1) it's not very clear on how to use the src/tracer/wrappers/OMP/genstubs-kmpc-11.sh script. The same does apply for the src/tracer/wrappers/OMP/genstubs-libgomp.sh script.
Searching the documentation did not clarify on how to use it.
The script currently also doesn't provide any usage information.

Additionally, it required the Makefile.am.in to be present which is also not a part of the current distribution see #117 :

extrae/src/tracer/wrappers/OMP/genstubs-kmpc-11.sh

Line 131 in 4556241

cp ${INTERMEDIATE_PATH}/Makefile.am.in ${INTERMEDIATE_PATH}/Makefile.am

[gllort]

Related to #117, get the sources from our Github instead. Then, you can increase the number of stubs generated:

cd src/tracer/wrappers/OMP
vi genstubs-kmpc-11.sh

Increase the value of MAX_WRAPPERS above 648, for example try setting it to 700 or 800.

Then do the whole configure && make && make install and try again. Please note, the building will take significantly more time to compile!

[valentin-seitz]

I think it would be nice if MAX_WRAPPERS would be a command line argument, so you could use it like:

cd src/tracer/wrappers/OMP
./genstubs-kmpc-11.sh 649

Just executing ./genstubs-kmpc-11.sh would print a small usage header and exit.
In the error message generated to the users (see below) one would be able to include the command the user should invoke.

extrae/src/tracer/wrappers/OMP/intel-kmpc-11.c

Lines 1196 to 1199 in 4556241

	fprintf (stderr, PACKAGE_NAME": Error! Can't retrieve handler to stub '%s' (%d arguments)! Quitting!\n"
	PACKAGE_NAME": Recompile Extrae to support this number of arguments!\n"
	PACKAGE_NAME": Use src/tracer/wrappers/OMP/genstubs-kmpc-11.sh to do so.\n",
	kmpc_parallel_sched_name, argc);

A solution proposal can be found in #121