Content-type: text/html Manpage of QMAKE

QMAKE

Section: Sun Grid Engine User Commands (1)
Updated: 2002/07/19 09:44:03
Index Return to Main Contents

NAME

qmake - distributed parallel make, scheduling by Sun Grid Engine.

SYNTAX

qmake [ options ] -- [ gmake options ]

DESCRIPTION

Qmake is a parallel, distributed utility. Scheduling of the parallel make tasks is done by Sun Grid Engine. It is based on gmake (GNU make), version 3.78.1. Both Sun Grid Engine and gmake commandline options can be specified. They are separated by "--".

All Sun Grid Engine options valid with or can be specified with qmake - see for a description of all Sun Grid Engine commandline options. The manual page describes the gmake commandline syntax.

The syntax of qmake makefiles corresponds to gmake and is described in the "GNU Make Manual".

A typical qmake call will use the Sun Grid Engine commandline options -cwd to have a scheduled make started in the current working directory on the execution host, -v PATH if the Sun Grid Engine environment is not setup in the users .cshrc or .profile shell resource file and request slots in a parallel environment (see ).

If no resource request (Sun Grid Engine commandline option -l) is specified, qmake will use the environment variable ARCH to request the same architecture for task execution as has the submit host. If ARCH is set, the architecture specified in ARCH will be requested by inserting the option -l arch=$ARCH into the commandline options. If ARCH is not set, the make tasks can be executed on any available architecture. As this is critical for typical make (compile) jobs, a warning will be output.

EXAMPLES


qmake -cwd -v PATH -pe compiling 1-10 --

will request between 1 and 10 slots in parallel environment "compiling" on the same architecture as the submit host. The make tasks will inherit the complete environment of the calling shell. It will execute as many parallel tasks as slots have been granted by Sun Grid Engine.


qmake -cwd -v PATH -- -j 4

will request between 1 and 4 slots in parallel environment "make" on the same architecture as the submit host.


qmake -cwd -v PATH -l arch=solaris -pe make 3

will request 3 parallel make tasks to be executed on hosts of architecture "solaris". The submit may be done on a host of any architecture.

The shell script


#!/bin/sh
qmake -inherit --

can be submitted by


qsub -cwd -v PATH -pe make 1-10 [furter sge options] <script>

Qmake will inherit the resources granted for the job sumbitted above under parallel environment "make".

ENVIRONMENTAL VARIABLES

SGE_ROOT

Specifies the location of the Sun Grid Engine standard configuration files.

SGE_CELL

If set, specifies the default Sun Grid Engine cell. To address a Sun Grid Engine cell qmake uses (in the order of precedence):

The name of the cell specified in the environment variable SGE_CELL, if it is set.

The name of the default cell, i.e. default.

SGE_DEBUG_LEVEL

If set, specifies that debug information should be written to stderr. In addition the level of detail in which debug information is generated is defined.

ARCH

The architecture of the submit host. If this variable is set in the submission environment, qmake will request the given architecture for job execution (see DESCRIPTION above).

COMMD_PORT

If set, specifies the tcp port on which is expected to listen for communication requests. Most installations will use a services map entry instead to define that port.

COMMD_HOST

If set, specifies the host on which the particular to be used for Sun Grid Engine communication of the qmake client resides. Per default the local host is used.

KNOWN PROBLEMS

Slow NFS server

Very low file server performance may lead to problems on depending files.

Example: Host a compiles a.c to a.o, host b compiles b.c to b.o, host c shall link program c from a.o and b.o. In case of very bad NFS performance, host c might not yet see files a.o and b.o.

Multiple commands in one rule

If multiple commands are executed in one rule, the makefile has to ensure that they are handled as one commandline.

Example:


libx.a:
cd x
ar ru libx.a x.o

Building libx.a will fail, if the commands are executed in parallel (and possibly on different hosts). Write the following instead:


libx.a:
cd x ; ar ru libx.a x.o


libx.a:
cd x ; \
ar ru libx.a x.o

COPYRIGHT

Qmake contains portions of Gnu Make (gmake), which is the copyright of the Free Software Foundation, Inc., Boston, MA, and is protected by the Gnu General Public License.
See and the information provided in <sge_root>/3rd_party/qmake for a statement of further rights and permissions.

Index

ENVIRONMENTAL VARIABLES

KNOWN PROBLEMS

Slow NFS server
Multiple commands in one rule

SEE ALSO

COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 14:06:28 GMT, September 19, 2003