# objinfo.cif
# 
# Copyright (c) 2010 Accenture. All rights reserved.
# This component and the accompanying materials are made available
# under the terms of the "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Accenture - Initial contribution
#

==name objinfo

==short-description

Display information about kernel objects.

==long-description

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.

==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>.

==option bool r referencers

Print the names of threads and processes that are holding handles to a given object.

==option uint p process-id

List all the objects that the specified process references.

==option uint t thread-id

List all the objects that the specified thread references.

==option bool a all

Include details of objects referenced by threads of a given process. Only useful in conjunction with the C<-p> option.

==copyright

Copyright (c) 2006-2010 Accenture. All rights reserved.