| [ Platform Documentation ] | [ Title ] | [ Contents ] | [ Previous ] | [ Next ] | [ Index ] |
lsmake
runs make tasks in parallel
SYNOPSIS
lsmake [-c num_tasks] [-F res_req] [-m "host_name ..."] [-E] [-G] [-M] [-V]
[makeoption ...] [target ...]
lsmake [-c num_tasks] [-F res_req] [-j max_processors] [-P minutes]
[-R res_req] [-E] [-G] [-M] [-V] [makeoption ...] [target ...]
DESCRIPTION
Runs make tasks in parallel on LSF hosts. Sets the environment variables on
the remote hosts when lsmake first starts.
By default, uses the local host, uses only one processor, starts only one task in each processor, and processes submakes sequentially.
lsmake is a modified version of GNU make. All the options provided by GNU
make are valid with lsmake.
OPTIONS
-c num_tasks
Starts the specified number of tasks concurrently on each processor. If you specify too many tasks, you could overload a host.
-F res_req
Temporarily reduces the number of tasks running when the load on the network file server exceeds the specified resource requirements. This might also reduce the number of processors used. The number of tasks is increased again when the load on the network file server is below the specified resource requirements.
The network file server is considered to be the host mounting the current
working directory on the local host. If this machine is not in the local cluster,
-F is ignored.
-m "host_name ..."
Uses the specified hosts. Specify a host name multiple times to use multiple processors on that host.
-j max_processors
Uses multiple processors. Specify the maximum number of processors to use. Uses all of the available processors if fewer processors are available.
When you specify -j and -R together, automatically selects processors on the
best available hosts that satisfy the resource requirements. The job fails if no
suitable host is found.
When you specify -j but not -R, automatically selects processors on the best
available hosts that are the same host type as the local host. The local host itself
can be selected.
-P minutes
Periodically reselects the best available processors. After the processor has been used for the specified number of minutes, it might be replaced if a better processor is available.
This is useful for long-running makes.
-R res_req
Uses only hosts that satisfy the specified resource requirements.
When you specify -R but not -j, uses one processor on one host that satisfies
the resource requirements.
-E
Sets the environment variables for every task sent remotely.
This is necessary when make files change or override the environment variables they inherit at startup.
-G
Enables debugging.
-M
Processes submakes in parallel. Some makefiles may not work correctly when run in parallel through Platform Make.
To use this feature, build each submake as a separate target in your makefile. Specify the make command for each submake with the built-in $(MAKE) macro. Makefiles that depend on sequential processing might have to be modified further.
For more information, see the Platform Make documentation.
-V
Verbose mode. Prints the names of the hosts used.
makeoption ...
Specifies GNU Make options. See gmake(1) for details.
target ...
Specifies targets to make.
SEE ALSO
lsfintro(1), lstcsh(1), gmake(1)
For a complete description of how to use Platform Make, see the Platform Make documentation.
LIMITATIONS
If a submake in a makefile specifies options which are specific to lsmake they
are ignored. Only the command line options are used.
When determining where to start tasks, lsmake consults the local task list (see
lsf.task(5)). If the task is found in the local task list, then it will be started
on the local host. The resource requirements of tasks in the remote task list are
not considered when dispatching tasks.
[ Top ]
| [ Platform Documentation ] | [ Title ] | [ Contents ] | [ Previous ] | [ Next ] | [ Index ] |
|
Date Modified: February 24, 2004
Platform Computing: www.platform.com Platform Support: support@platform.com Platform Information Development: doc@platform.com Copyright © 1994-2004 Platform Computing Corporation. All rights reserved. |