core/builtins/objinfo.cif
changeset 90 ceac7084e2e5
parent 0 7f656887cf89
equal deleted inserted replaced
89:17bed177107f 90:ceac7084e2e5
    18 
    18 
    19 ==long-description
    19 ==long-description
    20 
    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.
    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.
    22 
    22 
       
    23 To see all the threads and processes that have a handle open to the DObject 0x12345678:
       
    24 
       
    25     objinfo 0x12345678
       
    26 
       
    27 For example, to see all the handles opened by process 23:
       
    28 
       
    29     objinfo --process-id 23 --all
       
    30 
    23 ==see-also
    31 ==see-also
    24 
    32 
    25 L<ps|ps>, L<chunkinfo|chunkinfo>, L<svrinfo|svrinfo>
    33 L<ps|ps>, L<chunkinfo|chunkinfo>, L<svrinfo|svrinfo>
    26 
    34 
    27 ==argument uint object_address optional
    35 ==argument uint object_address optional
    28 
    36 
    29 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>.
    37 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>.
    30 
    38 
    31 ==option bool r referencers
    39 ==option bool r referencers
    32 
    40 
    33 Print the names of threads and processes that are holding handles to a given object.
    41 Print the names of threads and processes that are holding handles to a given object.
    34 
    42 
    40 
    48 
    41 List all the objects that the specified thread references.
    49 List all the objects that the specified thread references.
    42 
    50 
    43 ==option bool a all
    51 ==option bool a all
    44 
    52 
    45 Include details of objects referenced by threads of a given process. Only useful in conjunction with the C<-p> option.
    53 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.
    46 
    54 
    47 ==copyright
    55 ==copyright
    48 
    56 
    49 Copyright (c) 2006-2010 Accenture. All rights reserved.
    57 Copyright (c) 2006-2010 Accenture. All rights reserved.
    50 
    58