From owner-p4-projects@FreeBSD.ORG Mon Jun 15 13:04:17 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 76AB6106567A; Mon, 15 Jun 2009 13:04:17 +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 2F4131065673 for ; Mon, 15 Jun 2009 13:04:17 +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 1308C8FC1B for ; Mon, 15 Jun 2009 13:04:17 +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 n5FD4GQ8007444 for ; Mon, 15 Jun 2009 13:04:16 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 n5FD4GZi007442 for perforce@freebsd.org; Mon, 15 Jun 2009 13:04:16 GMT (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Date: Mon, 15 Jun 2009 13:04:16 GMT Message-Id: <200906151304.n5FD4GZi007442@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 To: Perforce Change Reviews Cc: Subject: PERFORCE change 164425 for review X-BeenThere: p4-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: p4 projects tree changes List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 15 Jun 2009 13:04:18 -0000 http://perforce.freebsd.org/chv.cgi?CH=164425 Change 164425 by rwatson@rwatson_freebsd_capabilities on 2009/06/15 13:03:56 Document (briefly) the file descriptor-passing variants of libcapability RPC functions. Update MLINKS. Affected files ... .. //depot/projects/trustedbsd/capabilities/src/lib/libcapability/Makefile#12 edit .. //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_host.3#4 edit .. //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_sandbox.3#5 edit Differences ... ==== //depot/projects/trustedbsd/capabilities/src/lib/libcapability/Makefile#12 (text+ko) ==== @@ -22,26 +22,29 @@ MAN+= libcapability_sandbox.3 MLINKS= libcapability.3 libcapabilitym.3 \ libcapability.3 lc_limitfd.3 \ - libcapability.3 lch_start.3 \ - libcapability.3 lch_start_flags.3 \ - libcapability.3 lch_startfd.3 \ - libcapability.3 lch_startfd_flags.3 \ - libcapability.3 lch_stop.3 \ - libcapability.3 lch_getsock.3 \ - libcapability.3 lch_getpid.3 \ - libcapability.3 lch_getprocdesc.3 \ - libcapability.3 lcs_get.3 \ - libcapability.3 lcs_getsock.3 \ + libcapability_host.3 lch_start.3 \ + libcapability_host.3 lch_start_flags.3 \ + libcapability_host.3 lch_startfd.3 \ + libcapability_host.3 lch_startfd_flags.3 \ + libcapability_host.3 lch_stop.3 \ + libcapability_host.3 lch_getsock.3 \ + libcapability_host.3 lch_getpid.3 \ + libcapability_host.3 lch_getprocdesc.3 \ libcapability_host.3 lch_recv.3 \ libcapability_host.3 lch_recv_rights.3 \ libcapability_host.3 lch_rpc.3 \ + libcapability_host.3 lch_rpc_rights.3 \ libcapability_host.3 lch_send.3 \ libcapability_host.3 lch_send_rights.3 \ + libcapability_sandbox.3 lcs_get.3 \ + libcapability_sandbox.3 lcs_getsock.3 \ libcapability_sandbox.3 lcs_recv.3 \ libcapability_sandbox.3 lcs_recv_rights.3 \ libcapability_sandbox.3 lcs_recvrpc.3 \ + libcapability_sandbox.3 lcs_recvrpc_rights.3 \ libcapability_sandbox.3 lcs_send.3 \ libcapability_sandbox.3 lcs_send_rights.3 \ - libcapability_sandbox.3 lcs_sendrpc.3 + libcapability_sandbox.3 lcs_sendrpc.3 \ + libcapability_sandbox.3 lcs_sendrpc_rights.3 .include ==== //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_host.3#4 (text+ko) ==== @@ -186,7 +186,7 @@ and .Fn lcs_sendrpc sandbox APIs. -The host provides an operation number meaningful to th sandbox, +The host provides an operation number meaningful to the sandbox, .Va opno, RPC arguments represented by .Va req @@ -203,6 +203,9 @@ If the RPC fails, -1 will be returned, or 0 and the size of any reply will be returned by reference using .Va replenp . +.Nm lch_rpc_rights +allows the sending and receiving of file descriptors as part of the RPC +operation. .Sh SEE ALSO .Xr rpcgen 1 , .Xr recv 2 , ==== //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_sandbox.3#5 (text+ko) ==== @@ -146,6 +146,10 @@ When the sandbox is done with the request data, it should free the memory using .Xr free 3 . +.Nm lcs_recvrpc_rights +and +.Nm lcs_sendrpc_rights +allow the receiving and sending of file descriptors along with the RPC. .Sh SEE ALSO .Xr rpcgen 1 , .Xr recv 2 ,