labmex

Purpose:

make and execute a program

Usage:

labmex [<option>] ... <executable> [<arguments>]

Options:

-c, --clean=[before|after|both]

do a 'make <make_options> clean' before, after, or before and after compiling the target

-h, --help

print a help message

-l, --log=<DIR>

specifies the directory in which the compile log will be created (default is '.' or, if called by labrun, the directory in which labrun's log files are stored). This log file is not created if compilation succeeds.

-k, --keep

always keep the compile log

-m, --makeflag=<OPTION>

pass the given option to each call of make; use multiple -m options for multiple make options

-M, --Make=<COMMAND>

use <COMMAND> instead of "make" when compiling the executable

--nolabrc

do not read ~/.labrc and ./labrc

-t, --target=<TARGET>

target for make (default is <exectuable>); multiple -t options are allowed

-v, --verbose

verbose mode

--version

print version information

-x, --exec=<DIR>

where to execute <executable> (default is '.')

With @FILE or @ FILE (some) command-line options are read from FILE (see section ).

Result:

Program is compiled and run. If the --keep option is used or the compilation fails, a compile log and a link to this file called current.clog is created in the current directory, the log directory of labrun if called from labrun, or the log directory specified on the command line.

Examples:

• labmex --clean both timings 10 20 5

  Performs a make clean and then a make timings. Runs the program timings with arguments 10 20 5. Then does a second make clean.

• labmex -x benchmark -m -DCXXFLAGS=-O3 -t timings ~/src/timings

  Performs a make -DCXXFLAGS=-O3 timings in the current directory. Moves to the directory benchmark and executes the command ~/src/timings in that directory.

• labmex -M gmake -m -C.. -m '-DCXXFLAGS=-NDEBUG -NDEBUG2'
-x .. -t all timings

  Performs a gmake -C.. '-DCXXFLAGS=-NDEBUG -NDEBUG2' all command in the current directory, which compiles the target all in the parent directory (the -C.. option of gmake). Moves to the parent directory and executes the command timings.