About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/ciaoshmem.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 ciaoshmem Context: gui

Synopsis

Provides information on and configuration of CIAO sessions.

Syntax

ciaoshmem
ciaoshmem -c [all|<hkfile>]
ciaoshmem -d
ciaoshmem -f
ciaoshmem -i
ciaoshmem -kill
ciaoshmem -l
ciaoshmem -p
ciaoshmem -s <skey>
ciaoshmem -x <hkfile>

Description

The ciaoshmem tool provides information about and configuration of CIAO sessions. It is intended to help track down or clean up problems related to session management and resource allocation and so should be rarely - if at all - needed.

The tool is most useful for checking which applications are associated with the current session (see "ahelp session" for more information on CIAO sessions). Its default behaviour is to display information about the current session, as shown in the following example:

  unix% ciaoshmem

            The current session for this window...
   --------------------------------------------------------
   |  session id: v2.0.ciaouser.chandra.chandra           |
   |  shm id:                 73201                       |
   |  - - - - - - - - - - - - - - - - - - - - - - - - -   |
   |  Application   Instance   Process id   Access Name   |
   |  -----------   --------   ----------   -----------   |
   |  prism             1         22514     prism         |
   --------------------------------------------------------

This tells us that in the current session - which has a session key of v2.0.ciaouser.chandra.chandra (see "ahelp session") - there is currently one application - prism - running, its process id and the name of its XPA access point.

Other behaviour is available by specifying one of the following command-line options (the options are case insensitive):

Option Description
-c [all|<hkfile>] Cleans up any left-over resources. If "all" is given then all CIAO-allocated resources are cleaned up; if a filename is given (which must be one of the session house keeping files in $HOME/.ciao/), then only that specific resource is cleaned up; otherwise only resources associated with the current session are removed.
-d List those processes which have a lock on system resources. A value of 0 indicates that no locks exist.
-f Include extra information - taken from ciao.par - in the output.
-h Display all the command-line options for the tool.
-i Prints out the current session key.
-kill Terminates all applications in the current session. This is functionally equivalent to selecting the "Exit Session" item in the "Session" menu of a CIAO GUI.
-l Lists any session house-keeping files that are present in your $HOME/.ciao/ directory.
-p Equivalent to running the tool without any commmand-line option.
-s <skey> Prints out information for the listed session key rather than using the current session.
-x <hkfile> Prints out information for the session referred to by the supplied session housekeeping file (i.e. $HOME/.ciao/session_xxx).
Hardcopy (PDF): A4 | Letter
Last modified: December 2006



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.