From owner-svn-src-head@FreeBSD.ORG  Tue Mar 15 23:51:47 2011
Return-Path: <owner-svn-src-head@FreeBSD.ORG>
Delivered-To: svn-src-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 575D61065670;
	Tue, 15 Mar 2011 23:51:47 +0000 (UTC)
	(envelope-from jilles@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c])
	by mx1.freebsd.org (Postfix) with ESMTP id 455F58FC1B;
	Tue, 15 Mar 2011 23:51:47 +0000 (UTC)
Received: from svn.freebsd.org (localhost [127.0.0.1])
	by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id p2FNplwq063194;
	Tue, 15 Mar 2011 23:51:47 GMT (envelope-from jilles@svn.freebsd.org)
Received: (from jilles@localhost)
	by svn.freebsd.org (8.14.3/8.14.3/Submit) id p2FNplUK063192;
	Tue, 15 Mar 2011 23:51:47 GMT (envelope-from jilles@svn.freebsd.org)
Message-Id: <201103152351.p2FNplUK063192@svn.freebsd.org>
From: Jilles Tjoelker <jilles@FreeBSD.org>
Date: Tue, 15 Mar 2011 23:51:47 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
	svn-src-head@freebsd.org
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: 
Subject: svn commit: r219682 - head/lib/libc/sys
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
	<svn-src-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 15 Mar 2011 23:51:47 -0000

Author: jilles
Date: Tue Mar 15 23:51:47 2011
New Revision: 219682
URL: http://svn.freebsd.org/changeset/base/219682

Log:
  rfork(2): Discourage rfork_thread-like approaches.
  
  Calling rfork_thread(3) does not interoperate with pthreads and global state
  is not properly protected.
  
  Remove the BUGS section suggesting LinuxThreads entirely. With the current
  pthread library libthr, all threads are kernel-level entities so there seems
  little reason to use LinuxThreads.

Modified:
  head/lib/libc/sys/rfork.2

Modified: head/lib/libc/sys/rfork.2
==============================================================================
--- head/lib/libc/sys/rfork.2	Tue Mar 15 23:28:15 2011	(r219681)
+++ head/lib/libc/sys/rfork.2	Tue Mar 15 23:51:47 2011	(r219682)
@@ -5,7 +5,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd May 14, 2007
+.Dd March 15, 2011
 .Dt RFORK 2
 .Os
 .Sh NAME
@@ -80,6 +80,7 @@ the new process to run on the provided s
 See
 .Xr rfork_thread 3
 for information.
+Note that a lot of code will not run correctly in such an environment.
 .It Dv RFSIGSHARE
 If set, the kernel will force sharing the sigacts structure between the
 child and the parent.
@@ -171,24 +172,9 @@ There is insufficient swap space for the
 .Xr intro 2 ,
 .Xr minherit 2 ,
 .Xr vfork 2 ,
+.Xr pthread_create 3 ,
 .Xr rfork_thread 3
 .Sh HISTORY
 The
 .Fn rfork
 function first appeared in Plan9.
-.Sh BUGS
-.Fx
-does not yet implement a native
-.Fn clone
-library call, and the current pthreads implementation does not use
-.Fn rfork
-with RFMEM.
-A native port of the linux threads library,
-.Pa /usr/ports/devel/linuxthreads ,
-contains a working
-.Fn clone
-call that utilizes RFMEM.
-The
-.Xr rfork_thread 3
-function can often be used instead of
-.Fn clone .