[Bug driver/12602] New: -pthreads and -threads undocumented for Solaris

[Bug driver/12602] New: -pthreads and -threads undocumented for Solaris

[sebor at roguewave dot com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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

           Summary: -pthreads and -threads undocumented for Solaris
           Product: gcc
           Version: 3.3
            Status: UNCONFIRMED
          Severity: normal
          Priority: P2
         Component: driver
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: sebor at roguewave dot com
                CC: gcc-bugs at gcc dot gnu dot org

The target-specific gcc command line options -pthreads and -threads implemented
in gcc 2.95.2 with this patch [1] and still available in gcc 3.3 are not
documented in the gcc manual. This is a request to document the options
according to their historical behavior. Note that it was suggested in this
thread [2] that the options may not be used without reconfiguring the compiler
for the particular thread model. The documention here [3] explains why this
should not be (and a large body of successfully tested code confirms that indeed
it isn't) necessary.

Regards
Martin

PS The suggested documentation might be something along the following lines
(following the documentation of the gcc -threads options for HP-UX):

-pthreads
    Add support for multithreading using the POSIX threads library under
    Solaris. This option sets flags for both the preprocessor and linker.
    This option does not affect the thread safety of object code produced
    by the compiler or that of libraries supplied with it.

-threads
    Add support for multithreading using the Solaris threads library. This
    option sets flags for both the preprocessor and linker. This option does
    not affect the thread safety of object code produced by the compiler or
    that of libraries supplied with it.

The most suitable place for this documentation seems to be here [4].

[1] http://gcc.gnu.org/ml/gcc/1997-09/msg01087.html
[2] http://gcc.gnu.org/ml/libstdc++/2003-10/msg00112.html
[3] http://docs.sun.com/db/doc/805-5080/6j4q7emhs?a=view
[4] http://gcc.gnu.org/onlinedocs/gcc-3.3.1/gcc/SPARC-Options.html#SPARC%20Options

[Bug driver/12602] -pthreads and -threads undocumented for Solaris

[gdr at integrable-solutions dot net]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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



------- Additional Comments From gdr at integrable-solutions dot net  2003-10-14 04:43 -------
Subject: Re:  New: -pthreads and -threads undocumented for Solaris

"sebor at roguewave dot com" <gcc-bugzilla@gcc.gnu.org> writes:

| PS The suggested documentation might be something along the following lines
| (following the documentation of the gcc -threads options for HP-UX):

Counter-suggestion:  Have GCC make a consistency statement about thread 
model specified at configuration time and thread model specified at
link time.  If these models are compatible, in the sense that they can
be interchanged, then the whole program behaves as if only one
threading model has been specified.  Otherwise, the meaning is
undefined. 

Since GCC does not distribute POSIX threads nor Solaris threads, it
should state guarantee about libraries it does not have power on.
Put differently, what the host provides is what you get.  If the host
provides a compatible thread library, then you get a compatible
library.

-- Gaby

[Bug driver/12602] -pthreads and -threads undocumented for Solaris

[ebotcazou at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


ebotcazou at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |ebotcazou at gcc dot gnu dot
                   |                            |org

[Bug driver/12602] -pthreads and -threads undocumented for almost every target

[pinskia at gcc dot gnu dot org]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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


pinskia at gcc dot gnu dot org changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|UNCONFIRMED                 |NEW
     Ever Confirmed|                            |1
           Keywords|                            |documentation
   Last reconfirmed|0000-00-00 00:00:00         |2003-10-28 15:31:14
               date|                            |
            Summary|-pthreads and -threads      |-pthreads and -threads
                   |undocumented for Solaris    |undocumented for almost
                   |                            |every target

[Bug driver/12602] -pthreads and -threads undocumented for almost every target

[ebotcazou at gcc dot gnu dot org]

------- Additional Comments From ebotcazou at gcc dot gnu dot org  2004-07-12 17:21 -------
I'll merge the proposed documentation.


-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|ebotcazou at gcc dot gnu dot|
                   |org                         |
         AssignedTo|unassigned at gcc dot gnu   |ebotcazou at gcc dot gnu dot
                   |dot org                     |org
             Status|NEW                         |ASSIGNED


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

[Bug target/12602] -pthreads and -threads undocumented for almost every target

[cvs-commit at gcc dot gnu dot org]

------- Additional Comments From cvs-commit at gcc dot gnu dot org  2004-07-13 10:36 -------
Subject: Bug 12602

CVSROOT:	/cvs/gcc
Module name:	gcc
Changes by:	ebotcazou@gcc.gnu.org	2004-07-13 10:36:30

Modified files:
	gcc            : ChangeLog 
	gcc/doc        : invoke.texi 

Log message:
	PR target/12602
	* doc/invoke.texi (SPARC options): Document -threads
	and -pthreads on Solaris.

Patches:
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/ChangeLog.diff?cvsroot=gcc&r1=2.4501&r2=2.4502
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/doc/invoke.texi.diff?cvsroot=gcc&r1=1.486&r2=1.487



-- 


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

[Bug target/12602] -pthreads and -threads undocumented for almost every target

[cvs-commit at gcc dot gnu dot org]

------- Additional Comments From cvs-commit at gcc dot gnu dot org  2004-07-13 10:43 -------
Subject: Bug 12602

CVSROOT:	/cvs/gcc
Module name:	gcc
Branch: 	gcc-3_4-branch
Changes by:	ebotcazou@gcc.gnu.org	2004-07-13 10:43:41

Modified files:
	gcc            : ChangeLog 
	gcc/doc        : invoke.texi 

Log message:
	PR target/12602
	* doc/invoke.texi (SPARC options): Document -threads
	and -pthreads on Solaris.

Patches:
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/ChangeLog.diff?cvsroot=gcc&only_with_tag=gcc-3_4-branch&r1=2.2326.2.552&r2=2.2326.2.553
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/doc/invoke.texi.diff?cvsroot=gcc&only_with_tag=gcc-3_4-branch&r1=1.390.2.30&r2=1.390.2.31



-- 


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

[Bug target/12602] -pthreads and -threads undocumented for almost every target

[cvs-commit at gcc dot gnu dot org]

------- Additional Comments From cvs-commit at gcc dot gnu dot org  2004-07-13 10:50 -------
Subject: Bug 12602

CVSROOT:	/cvs/gcc
Module name:	gcc
Branch: 	gcc-3_3-branch
Changes by:	ebotcazou@gcc.gnu.org	2004-07-13 10:50:33

Modified files:
	gcc            : ChangeLog 
	gcc/doc        : invoke.texi 

Log message:
	PR target/12602
	* doc/invoke.texi (SPARC options): Document -threads
	and -pthreads on Solaris.

Patches:
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/ChangeLog.diff?cvsroot=gcc&only_with_tag=gcc-3_3-branch&r1=1.16114.2.998&r2=1.16114.2.999
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/doc/invoke.texi.diff?cvsroot=gcc&only_with_tag=gcc-3_3-branch&r1=1.209.2.57&r2=1.209.2.58



-- 


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

[Bug target/12602] -pthreads and -threads undocumented for almost every target

[ebotcazou at gcc dot gnu dot org]

------- Additional Comments From ebotcazou at gcc dot gnu dot org  2004-07-13 10:53 -------
See http://gcc.gnu.org/ml/gcc-patches/2004-07/msg01327.html

-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ASSIGNED                    |RESOLVED
         Resolution|                            |FIXED
   Target Milestone|---                         |3.3.5


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

[Bug target/12602] -pthreads and -threads undocumented for almost every target

[cludwig at cdc dot informatik dot tu-darmstadt dot de]

------- Additional Comments From cludwig at cdc dot informatik dot tu-darmstadt dot de  2004-07-13 11:30 -------
Subject: Re:  -pthreads and -threads undocumented for almost every target

On Tue, Jul 13, 2004 at 10:53:18AM -0000, ebotcazou at gcc dot gnu dot org wrote:
> ------- Additional Comments From ebotcazou at gcc dot gnu dot org  2004-07-13 10:53 -------
> See http://gcc.gnu.org/ml/gcc-patches/2004-07/msg01327.html
>
> --
>            What    |Removed                     |Added
> ----------------------------------------------------------------------------
>              Status|ASSIGNED                    |RESOLVED
>          Resolution|                            |FIXED
>    Target Milestone|---                         |3.3.5

Excuse my insistence, but why do you consider this PR resolved? AFAICT
you added documentation for the Sparc platform, but what about (e.g.)
x86? There is documentation for a Mingw32 specific option -mthreads,
but no documentation for -pthread (or was it -pthreads?).

The reason I bring this up again is PR#11953. It would help if the
effects of -pthread were documented if you need to detect at compile
time whether -pthread was on the command line.

Regards

Christoph


-- 


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

[Bug target/12602] -pthreads and -threads undocumented for Solaris/SPARC

[ebotcazou at gcc dot gnu dot org]

------- Additional Comments From ebotcazou at gcc dot gnu dot org  2004-07-13 12:33 -------
> Excuse my insistence, but why do you consider this PR resolved? AFAICT
> you added documentation for the Sparc platform, but what about (e.g.)
> x86? There is documentation for a Mingw32 specific option -mthreads,
> but no documentation for -pthread (or was it -pthreads?).

The PR was originally about -threads and -pthreads on Solaris, which can both be
specified at runtime.  I don't know the status for other OSes.

I'll open a new PR for the platform-independant case.


-- 
           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|-pthreads and -threads      |-pthreads and -threads
                   |undocumented for almost     |undocumented for
                   |every target                |Solaris/SPARC


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