PERFORCE change 164425 for review

[Robert Watson]

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

Change 164425 by rwatson at 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 <bsd.lib.mk>

==== //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 ,