From 00b9bd52a8b69d902c02236ab593a34e638c0955 Mon Sep 17 00:00:00 2001 From: Jakub Jelinek Date: Sat, 14 Nov 2015 23:02:42 +0100 Subject: [PATCH] libgomp.texi: Update references from OpenMP 4.0 to OpenMP 4.5 sections. * libgomp.texi: Update references from OpenMP 4.0 to OpenMP 4.5 sections. From-SVN: r230384 --- libgomp/ChangeLog | 5 +++ libgomp/libgomp.texi | 112 +++++++++++++++++++++++++-------------------------- 2 files changed, 61 insertions(+), 56 deletions(-) diff --git a/libgomp/ChangeLog b/libgomp/ChangeLog index 15be014..2890218 100644 --- a/libgomp/ChangeLog +++ b/libgomp/ChangeLog @@ -1,4 +1,9 @@ 2015-11-14 Jakub Jelinek + + * libgomp.texi: Update references from OpenMP 4.0 to OpenMP 4.5 + sections. + +2015-11-14 Jakub Jelinek Aldy Hernandez Ilya Verbin diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi index 67e6d19..f25a17c 100644 --- a/libgomp/libgomp.texi +++ b/libgomp/libgomp.texi @@ -130,7 +130,7 @@ arranges for automatic linking of the OpenMP runtime library A complete description of all OpenMP directives accepted may be found in the @uref{http://www.openmp.org, OpenMP Application Program Interface} manual, -version 4.0. +version 4.5. @c --------------------------------------------------------------------- @@ -141,7 +141,7 @@ version 4.0. @chapter Runtime Library Routines The runtime routines described here are defined by Section 3 of the OpenMP -specification in version 4.0. The routines are structured in following +specification in version 4.5. The routines are structured in following three parts: @menu @@ -220,7 +220,7 @@ which enclose the calling call. @ref{omp_get_level}, @ref{omp_get_max_active_levels}, @ref{omp_set_max_active_levels} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.20. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.20. @end table @@ -249,7 +249,7 @@ zero to @code{omp_get_level} -1 is returned; if @var{level} is @ref{omp_get_level}, @ref{omp_get_thread_num}, @ref{omp_get_team_size} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.18. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.18. @end table @@ -277,7 +277,7 @@ deactivated. @ref{OMP_CANCELLATION} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.9. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.9. @end table @@ -302,7 +302,7 @@ Get the default device for target regions without device clause. @ref{OMP_DEFAULT_DEVICE}, @ref{omp_set_default_device} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.24. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.30. @end table @@ -334,7 +334,7 @@ disabled by default. @ref{omp_set_dynamic}, @ref{OMP_DYNAMIC} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.8. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.8. @end table @@ -360,7 +360,7 @@ which enclose the calling call. @ref{omp_get_active_level} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.17. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.17. @end table @@ -385,7 +385,7 @@ This function obtains the maximum allowed number of nested, active parallel regi @ref{omp_set_max_active_levels}, @ref{omp_get_active_level} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.16. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.16. @end table @@ -432,7 +432,7 @@ that does not use the clause @code{num_threads}. @ref{omp_set_num_threads}, @ref{omp_set_dynamic}, @ref{omp_get_thread_limit} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.3. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.3. @end table @@ -464,7 +464,7 @@ disabled by default. @ref{omp_set_nested}, @ref{OMP_NESTED} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.11. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.11. @end table @@ -486,7 +486,7 @@ Returns the number of target devices. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.25. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.31. @end table @@ -508,7 +508,7 @@ Returns the number of processors online on that device. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.5. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.5. @end table @@ -530,7 +530,7 @@ Returns the number of teams in the current team region. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.26. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.32. @end table @@ -563,7 +563,7 @@ one thread per CPU online is used. @ref{omp_get_max_threads}, @ref{omp_set_num_threads}, @ref{OMP_NUM_THREADS} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.2. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.2. @end table @@ -591,7 +591,7 @@ set via @env{OMP_PROC_BIND}. Possible values are @code{omp_proc_bind_false}, @ref{OMP_PROC_BIND}, @ref{OMP_PLACES}, @ref{GOMP_CPU_AFFINITY}, @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.22. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.22. @end table @@ -621,7 +621,7 @@ set to the value @code{omp_sched_static}, @code{omp_sched_dynamic}, @ref{omp_set_schedule}, @ref{OMP_SCHEDULE} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.13. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.13. @end table @@ -643,7 +643,7 @@ Returns the team number of the calling thread. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.27. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.33. @end table @@ -673,7 +673,7 @@ to @code{omp_get_num_threads}. @ref{omp_get_num_threads}, @ref{omp_get_level}, @ref{omp_get_ancestor_thread_num} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.19. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.19. @end table @@ -698,7 +698,7 @@ Return the maximum number of threads of the program. @ref{omp_get_max_threads}, @ref{OMP_THREAD_LIMIT} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.14. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.14. @end table @@ -727,7 +727,7 @@ value of the master thread of a team is always 0. @ref{omp_get_num_threads}, @ref{omp_get_ancestor_thread_num} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.4. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.4. @end table @@ -751,7 +751,7 @@ their language-specific counterparts. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.6. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.6. @end table @@ -774,7 +774,7 @@ and @code{false} represent their language-specific counterparts. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.21. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.21. @end table @@ -798,7 +798,7 @@ their language-specific counterparts. @end multitable @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.28. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.34. @end table @@ -825,7 +825,7 @@ shall be a nonnegative device number. @ref{OMP_DEFAULT_DEVICE}, @ref{omp_get_default_device} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.23. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.29. @end table @@ -854,7 +854,7 @@ adjustment of team sizes and @code{false} disables it. @ref{OMP_DYNAMIC}, @ref{omp_get_dynamic} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.7. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.7. @end table @@ -881,7 +881,7 @@ parallel regions. @ref{omp_get_max_active_levels}, @ref{omp_get_active_level} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.15. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.15. @end table @@ -910,7 +910,7 @@ dynamic adjustment of team sizes and @code{false} disables it. @ref{OMP_NESTED}, @ref{omp_get_nested} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.10. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.10. @end table @@ -938,7 +938,7 @@ argument of @code{omp_set_num_threads} shall be a positive integer. @ref{OMP_NUM_THREADS}, @ref{omp_get_num_threads}, @ref{omp_get_max_threads} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.1. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.1. @end table @@ -971,7 +971,7 @@ For @code{omp_sched_auto} the @var{chunk_size} argument is ignored. @ref{OMP_SCHEDULE} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.2.12. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.2.12. @end table @@ -998,7 +998,7 @@ an unlocked state. @ref{omp_destroy_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.1. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.1. @end table @@ -1027,7 +1027,7 @@ a deadlock occurs. @ref{omp_init_lock}, @ref{omp_test_lock}, @ref{omp_unset_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.3. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.4. @end table @@ -1057,7 +1057,7 @@ does not block if the lock is not available. This function returns @ref{omp_init_lock}, @ref{omp_set_lock}, @ref{omp_set_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.5. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.6. @end table @@ -1087,7 +1087,7 @@ again, set the lock to itself. @ref{omp_set_lock}, @ref{omp_test_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.4. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.5. @end table @@ -1114,7 +1114,7 @@ in the unlocked state. @ref{omp_init_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.2. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.3. @end table @@ -1141,7 +1141,7 @@ an unlocked state and the nesting count is set to zero. @ref{omp_destroy_nest_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.1. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.1. @end table @@ -1169,7 +1169,7 @@ nesting count for the lock is incremented. @ref{omp_init_nest_lock}, @ref{omp_unset_nest_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.3. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.4. @end table @@ -1200,7 +1200,7 @@ is returned. Otherwise, the return value equals zero. @ref{omp_init_lock}, @ref{omp_set_lock}, @ref{omp_set_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.5. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.6. @end table @@ -1230,7 +1230,7 @@ one of them is chosen to, again, set the lock to itself. @ref{omp_set_nest_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.4. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.5. @end table @@ -1257,7 +1257,7 @@ in the unlocked state and its nesting count must equal zero. @ref{omp_init_lock} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.3.2. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.3.3. @end table @@ -1283,7 +1283,7 @@ successive clock ticks. @ref{omp_get_wtime} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.4.2. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.4.2. @end table @@ -1311,7 +1311,7 @@ guaranteed not to change during the execution of the program. @ref{omp_get_wtick} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 3.4.1. +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 3.4.1. @end table @@ -1324,7 +1324,7 @@ guaranteed not to change during the execution of the program. @chapter Environment Variables The environment variables which beginning with @env{OMP_} are defined by -section 4 of the OpenMP specification in version 4.0, while those +section 4 of the OpenMP specification in version 4.5, while those beginning with @env{GOMP_} are GNU extensions. @menu @@ -1362,7 +1362,7 @@ if unset, cancellation is disabled and the @code{cancel} construct is ignored. @ref{omp_get_cancellation} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.11 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.11 @end table @@ -1380,7 +1380,7 @@ this information will not be shown. @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.12 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.12 @end table @@ -1401,7 +1401,7 @@ device number 0 will be used. @ref{omp_get_default_device}, @ref{omp_set_default_device}, @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.11 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.13 @end table @@ -1420,7 +1420,7 @@ disabled by default. @ref{omp_set_dynamic} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.3 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.3 @end table @@ -1438,7 +1438,7 @@ If undefined, the number of active levels is unlimited. @ref{omp_set_max_active_levels} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.9 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.9 @end table @@ -1478,7 +1478,7 @@ regions are disabled by default. @ref{omp_set_nested} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.6 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.6 @end table @@ -1498,7 +1498,7 @@ level. If undefined one thread per CPU is used. @ref{omp_set_num_threads} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.2 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.2 @end table @@ -1525,7 +1525,7 @@ When undefined, @env{OMP_PROC_BIND} defaults to @code{TRUE} when @ref{OMP_PLACES}, @ref{GOMP_CPU_AFFINITY}, @ref{omp_get_proc_bind} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.4 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.4 @end table @@ -1567,7 +1567,7 @@ between CPUs following no placement policy. @ref{OMP_DISPLAY_ENV} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.5 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.5 @end table @@ -1587,7 +1587,7 @@ stack size is left unchanged. If undefined, the stack size is system dependent. @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.7 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.7 @end table @@ -1608,7 +1608,7 @@ dynamic scheduling and a chunk size of 1 is used. @ref{omp_set_schedule} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Sections 2.7.1 and 4.1 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Sections 2.7.1.1 and 4.1 @end table @@ -1626,7 +1626,7 @@ the number of threads is not limited. @ref{OMP_NUM_THREADS}, @ref{omp_get_thread_limit} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.10 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.10 @end table @@ -1646,7 +1646,7 @@ before waiting passively. @ref{GOMP_SPINCOUNT} @item @emph{Reference}: -@uref{http://www.openmp.org/, OpenMP specification v4.0}, Section 4.8 +@uref{http://www.openmp.org/, OpenMP specification v4.5}, Section 4.8 @end table -- 2.7.4