--- a/core/builtins/objinfo.cif Tue Nov 30 11:11:58 2010 +0000
+++ b/core/builtins/objinfo.cif Tue Dec 07 17:29:09 2010 +0000
@@ -20,13 +20,21 @@
Given a kernel object address, prints details of the threads and processes that are currently holding handles to it (note, kernel objects addresses can be found using L<ps|ps> (e.g. C<ps -A> or C<ps -At>), L<chunkinfo|chunkinfo> or L<svrinfo|svrinfo>). Given a thread or process identifier, lists details of all the owned objects.
+To see all the threads and processes that have a handle open to the DObject 0x12345678:
+
+ objinfo 0x12345678
+
+For example, to see all the handles opened by process 23:
+
+ objinfo --process-id 23 --all
+
==see-also
L<ps|ps>, L<chunkinfo|chunkinfo>, L<svrinfo|svrinfo>
==argument uint object_address optional
-The address of the kernel object to find the owners of. If not specified, a thread or process identifier must be specified using C<-t> or C<-p>.
+The address of the kernel object to find the owners of. If not specified, a thread or process identifier must be specified using C<--thread-id> or C<--process-id>.
==option bool r referencers
@@ -42,7 +50,7 @@
==option bool a all
-Include details of objects referenced by threads of a given process. Only useful in conjunction with the C<-p> option.
+Include details of objects referenced by threads of a given process, ie show the thread-local handles held by threads in that process as well as the process-global handles. Only useful in conjunction with the C<--process-id> option.
==copyright