PERFORCE change 164417 for review

[Robert Watson]

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

Change 164417 by rwatson at 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