From owner-p4-projects@FreeBSD.ORG  Thu Jun 11 20:59:37 2009
Return-Path: <owner-p4-projects@FreeBSD.ORG>
Delivered-To: p4-projects@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id A11F010657C1; Thu, 11 Jun 2009 20:59:35 +0000 (UTC)
Delivered-To: perforce@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 13B551065691
	for <perforce@freebsd.org>; Thu, 11 Jun 2009 20:59:35 +0000 (UTC)
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: from repoman.freebsd.org (repoman.freebsd.org
	[IPv6:2001:4f8:fff6::29])
	by mx1.freebsd.org (Postfix) with ESMTP id 0050F8FC0A
	for <perforce@freebsd.org>; Thu, 11 Jun 2009 20:59:35 +0000 (UTC)
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: from repoman.freebsd.org (localhost [127.0.0.1])
	by repoman.freebsd.org (8.14.3/8.14.3) with ESMTP id n5BKxY3p037954
	for <perforce@freebsd.org>; Thu, 11 Jun 2009 20:59:34 GMT
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Received: (from perforce@localhost)
	by repoman.freebsd.org (8.14.3/8.14.3/Submit) id n5BKxYkM037952
	for perforce@freebsd.org; Thu, 11 Jun 2009 20:59:34 GMT
	(envelope-from bb+lists.freebsd.perforce@cyrus.watson.org)
Date: Thu, 11 Jun 2009 20:59:34 GMT
Message-Id: <200906112059.n5BKxYkM037952@repoman.freebsd.org>
X-Authentication-Warning: repoman.freebsd.org: perforce set sender to
	bb+lists.freebsd.perforce@cyrus.watson.org using -f
From: Robert Watson <rwatson@FreeBSD.org>
To: Perforce Change Reviews <perforce@freebsd.org>
Cc: 
Subject: PERFORCE change 164145 for review
X-BeenThere: p4-projects@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: p4 projects tree changes <p4-projects.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/p4-projects>
List-Post: <mailto:p4-projects@freebsd.org>
List-Help: <mailto:p4-projects-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/p4-projects>,
	<mailto:p4-projects-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 11 Jun 2009 20:59:37 -0000

http://perforce.freebsd.org/chv.cgi?CH=164145

Change 164145 by rwatson@rwatson_freebsd_capabilities on 2009/06/11 20:59:20

	Document lc_limitfd().

Affected files ...

.. //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability.3#14 edit

Differences ...

==== //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability.3#14 (text+ko) ====

@@ -89,6 +89,14 @@
 Applications may also use RPC generators such as
 .Xr rpcgen 1
 to build event handling and marshaling code.
+.Sh CAPABILITY API
+.Fn lc_limitfd
+is a wrapper around
+.Xr cap_new 2
+and
+.Xr dup2 2
+which takes an existing file descriptor and replaces it with a capability
+with the requested rights mask.
 .Sh HOST API
 The
 .Nm
@@ -227,6 +235,7 @@
 .Xr rpcgen 1 ,
 .Xr cap_enter 2 ,
 .Xr cap_new 2 ,
+.Xr dup2 2 ,
 .Xr recv 2 ,
 .Xr send 2 ,
 .Xr writev 2 ,