Date: Mon, 15 Jun 2009 11:20:30 GMT From: Robert Watson <rwatson@FreeBSD.org> To: Perforce Change Reviews <perforce@freebsd.org> Subject: PERFORCE change 164417 for review Message-ID: <200906151120.n5FBKUC3076116@repoman.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200906151120.n5FBKUC3076116>