Scribd
Upload
10 views

Openmp Runtime

The OpenMP runtime library defines routines for querying and setting thread properties. Key routines include: - omp_get_wtime returns elapsed wall clock time in seconds for timing code sections - omp_set_num_threads sets the number of threads for the next parallel region - omp_get_num_threads returns the number of threads in the current team - omp_get_thread_num returns the thread number of the calling thread Additional routines control dynamic thread adjustment and parallel region nesting.

Uploaded by

ahmad.nawaz
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
10 views

Openmp Runtime

The OpenMP runtime library defines routines for querying and setting thread properties. Key routines include: - omp_get_wtime returns elapsed wall clock time in seconds for timing code sections - omp_set_num_threads sets the number of threads for the next parallel region - omp_get_num_threads returns the number of threads in the current team - omp_get_thread_num returns the thread number of the calling thread Additional routines control dynamic thread adjustment and parallel region nesting.

Uploaded by

ahmad.nawaz
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 9

Open MP

Runtime Library Routines


Runtime Library Routines
• The OpenMP standard defines an API for library calls that perform a variety of
functions:
•
• Query the number of threads/processors, set number of threads to use
• General purpose locking routines (semaphores)
• Portable wall clock timing routines
• Set execution environment functions: nested parallelism, dynamic adjustment of threads

• It will be necessary to specify the include file "omp.h“


• We will look at some of the more commonly used routines
omp_get_wtime
Purpose:
• Provides a portable wall clock timing routine
• Returns a double-precision floating point value equal to the number of elapsed seconds since some point in the past
• Used in "pairs" with the value of the first call subtracted from the value of the second call to obtain the elapsed time
• Designed to be "per thread" times, and therefore may not be globally consistent across all threads in a team - depends upon
what a thread is doing compared to other threads

Format:
#include <omp.h>
double omp_get_wtime (void)

Notes & Restrictions:


• Requires OpenMP version 2.0 support
omp_set_num_threads
Purpose: Notes & Restrictions:
• Sets the number of threads that will be • The dynamic threads mechanism
used in the next parallel region modifies the effect of this routine in one of
two ways:
• Enabled: specifies the maximum number of
• Must be a positive integer threads that can be used for any parallel
region by the dynamic threads mechanism
Format:
• Disabled: specifies exact number of threads
to use until next call to this routine
#include <omp.h>
void omp_set_num_threads(int num_threads) • This routine can only be called from the
serial portions of the code
omp_get_num_threads
Purpose:
• Returns the number of threads that are currently in the team executing the parallel region
from which it is called

Format:
#include <omp.h>
int omp_get_num_threads(void)

Notes & Restrictions:


• If this call is made from a serial portion of the program, or a nested parallel region that is
serialized, it will return 1
• The default number of threads is implementation dependent
omp_get_thread_num
Purpose:
• Returns the thread number of the thread, within the team, making this call
• This number is between 0 and omp_get_num_threads()-1
• The master thread of the team is thread 0

Format:
#include <omp.h>
int omp_get_thread_num (void)

Notes & Restrictions:


• If called from a nested parallel region, or a serial region, this function will return 0
omp_get_thread_num Example
This example illustrates the use of the omp_get_thread_num routine...
1 #include <omp.h>
2
3 main () {
4 int tid;
5
6 #pragma omp parallel private(tid)
7 {
8 tid=omp_get_thread_num();
9 printf(“Hello world from thread %d\n",tid);
10 }
11 }

• Without specifying tid as private this would result in incorrect execution – how?
• What if line 8 was inserted in line 5 instead?
omp_set_dynamic
Purpose:
• Enables or disables dynamic adjustment (by the run time system) of the number of threads available
for execution of parallel regions
•

Format:
#include <omp.h>
void omp_set_dynamic (int dynamic_threads)
Notes & Restrictions:
• If dynamic_threads evaluates to non-zero, then the mechanism is enabled, otherwise it is disabled
• The omp_set_dynamic routine has precedence over the omp_dynamic environment variable
• The default setting is implementation dependent
• Must be called from a serial section of the program
omp_get_dynamic
Purpose:
• Used to determine if dynamic thread adjustment is enabled or disabled
Format:
#include <omp.h>
int omp_get_dynamic (void)
Notes & Restrictions:
• non-zero will be returned if dynamic thread adjustment is enabled, and zero otherwise

You might also like