From owner-p4-projects@FreeBSD.ORG Mon Jun 15 11:20:37 2009 Return-Path: Delivered-To: p4-projects@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 32767) id 36ECE106592A; Mon, 15 Jun 2009 11:20:32 +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 25EEC106587F for ; Mon, 15 Jun 2009 11:20:31 +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 05CA98FC19 for ; Mon, 15 Jun 2009 11:20:31 +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 n5FBKUa6076118 for ; Mon, 15 Jun 2009 11:20:30 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 n5FBKUC3076116 for perforce@freebsd.org; Mon, 15 Jun 2009 11:20:30 GMT (envelope-from bb+lists.freebsd.perforce@cyrus.watson.org) Date: Mon, 15 Jun 2009 11:20:30 GMT Message-Id: <200906151120.n5FBKUC3076116@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 164417 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 11:20:56 -0000 http://perforce.freebsd.org/chv.cgi?CH=164417 Change 164417 by rwatson@rwatson_freebsd_capabilities on 2009/06/15 11:20:26 Trim HOST API information from sandbox API man page. Affected files ... .. //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_sandbox.3#3 edit Differences ... ==== //depot/projects/trustedbsd/capabilities/src/lib/libcapability/libcapability_sandbox.3#3 (text+ko) ==== @@ -79,59 +79,6 @@ .Xr libcapability 3 ; information on host I/O facilities may be found in .Xr libcapability_host 3 . -.Sh HOST API -.Fn lch_recv -and -.Fn lch_send -provide simple wrappers around -.Xr recv 2 -and -.Xr send 2 -to avoid sandbox consumers from having to query sandbox socket file -descriptors before use. -.Pp -.Fn lch_recv_rights -and -.Fn lch_send_rights -are similar, but allow file descriptors to be attached the the messages -received and sent. -Both accept a pointer to a file descriptor array, -.Va fdp . -Callers to -.Fn lch_recv_rights -will pass in the length of the array via -.Va fdcountp , -whose value will be changed to the actual number of file descriptors -received. -Callers to -.Fn lch_send_rights -will pass in the number of file descriptors in the array via -Va fdcount . -.Pp -.Fn lch_rpc -provides a simple synchronous RPC facility, and is intended to be used in -coordination with the -.Fn lcs_recvrpc -and -.Fn lcs_sendrpc -sandbox APIs. -The host provides an operation number meaningful to th sandbox, -.Va opno, -RPC arguments represented by -.Va req -and -.Va reqcount -using an -.Vt iovec -in the style of -.Xr writev 2 , -and similar receive buffers passed via -.Va rep -and -.Va repcount . -If the RPC fails, -1 will be returned, or 0 and the size of any reply will be -returned by reference using -.Va replenp . .Sh SANDBOX API .Fn lcs_recv and