[Bug libgomp/30540] New: Document default value of implementation-dependent OpenMP settings

[Bug libgomp/30540] New: Document default value of implementation-dependent OpenMP settings

[burnus at gcc dot gnu dot org]

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 980 bytes --]

http://gcc.gnu.org/onlinedocs/libgomp.pdf

2.1 omp_get_dynamic – Dynamic teams setting
etc.

Here, the default value is not documented; it can be found in
"3 Environment Variables" ("If undefined, dynamic adjustment is disabled by
default."), but this is not obvious. Especially, since the omp_get_* functions
only link to omp_set_* and not to the OMP_* environment variables.

And OMP_NUM_THREADS's default setting is completely undefined; does it use by
default one or the maximal number of available processors?


-- 
           Summary: Document default value of implementation-dependent
                    OpenMP settings
           Product: gcc
           Version: 4.3.0
            Status: UNCONFIRMED
          Keywords: documentation
          Severity: normal
          Priority: P3
         Component: libgomp
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: burnus at gcc dot gnu dot org


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[dfranke at gcc dot gnu dot org]

------- Comment #1 from dfranke at gcc dot gnu dot org  2007-01-26 09:58 -------
> Here, the default value is not documented; it can be found in
> "3 Environment Variables" ("If undefined, dynamic adjustment is disabled 
> by default."), but this is not obvious. Especially, since the omp_get_*
> functions only link to omp_set_* and not to the OMP_* environment variables.

Agreed. Regarding this, it was almost done, but then I removed what I had.
Don't ask why ...


> And OMP_NUM_THREADS's default setting is completely undefined; does it 
> use by default one or the maximal number of available processors?

Section 3.3 states:
"If undefined one thread per CPU online is used."


-- 

dfranke at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         AssignedTo|unassigned at gcc dot gnu   |dfranke at gcc dot gnu dot
                   |dot org                     |org
             Status|UNCONFIRMED                 |ASSIGNED
     Ever Confirmed|0                           |1
   Last reconfirmed|0000-00-00 00:00:00         |2007-01-26 09:58:54
               date|                            |


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[burnus at gcc dot gnu dot org]

------- Comment #2 from burnus at gcc dot gnu dot org  2007-01-26 11:06 -------
> > And OMP_NUM_THREADS's default setting is completely undefined; does it 
> > use by default one or the maximal number of available processors?
>
> Section 3.3 states:
> "If undefined one thread per CPU online is used."

Missed that since the order changed from
  what, allowed values, default
(used in the description of the other environment variables) to
  what, default, allowed values
for OMP_NUM_THREADS.


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[patchapp at dberlin dot org]

------- Comment #3 from patchapp at dberlin dot org  2007-01-29 22:55 -------
Subject: Bug number PR30540

A patch for this bug has been added to the patch tracker.
The mailing list url for the patch is
http://gcc.gnu.org/ml/gcc-patches/2007-01/msg02413.html


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[dfranke at gcc dot gnu dot org]

------- Comment #4 from dfranke at gcc dot gnu dot org  2007-01-30 21:16 -------
Subject: Bug 30540

Author: dfranke
Date: Tue Jan 30 21:16:30 2007
New Revision: 121360

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=121360
Log:
2007-01-29  Daniel Franke <franke.daniel@gmail.com>

        PR libgomp/30540
        * libgomp.texi: More about implementation-dependent settings.


Modified:
    trunk/libgomp/ChangeLog
    trunk/libgomp/libgomp.texi


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[dfranke at gcc dot gnu dot org]

------- Comment #5 from dfranke at gcc dot gnu dot org  2007-02-06 18:11 -------
Subject: Bug 30540

Author: dfranke
Date: Tue Feb  6 18:11:30 2007
New Revision: 121657

URL: http://gcc.gnu.org/viewcvs?root=gcc&view=rev&rev=121657
Log:
2007-02-07  Daniel Franke  <franke.daniel@gmail.com>

        Backport from mainline:
        2007-01-31  Ralf Wildenhues  <Ralf.Wildenhues@gmx.de>

        * libgomp.texi: Fix spacing after abbreviations.

        Backport from mainline:
        2007-01-29  Daniel Franke  <franke.daniel@gmail.com>

        PR libgomp/30540
        * libgomp.texi: More about implementation-dependent settings.


Modified:
    branches/gcc-4_2-branch/libgomp/ChangeLog
    branches/gcc-4_2-branch/libgomp/libgomp.texi


-- 


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[dfranke at gcc dot gnu dot org]

------- Comment #6 from dfranke at gcc dot gnu dot org  2007-02-06 18:15 -------
Fixed in mainline and 4.2. Closing.


-- 

dfranke at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |RESOLVED
         Resolution|                            |FIXED


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540

[Bug libgomp/30540] Document default value of implementation-dependent OpenMP settings

[dfranke at gcc dot gnu dot org]

-- 

dfranke at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
   Target Milestone|---                         |4.2.0


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=30540