Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

URL: http://cxc.harvard.edu/chips/ahelp/list_servers.html
AHELP for CIAO 4.9 ChIPS v1

list_servers

Context: server

Synopsis

Displays a list of ChIPS servers.

Syntax

list_servers()

Description

The list_servers command returns a list of servers that may be available to the user. The list is derived by checking for local socket files used by chips.

Before attempting to connect to a listed server, it is recommended that the user run the check_server_exists command to verify that the server is indeed available for connections. It is possible that old socket files may exist - e.g. if ChIPS exited improperly at some point - and those servers are not available for use.

Example

chips> print(list_servers())
['ChipsServer_15015_1']
chips> check_server_exists("ChipsServer_15015_1")
True

Retrieve a list of potentially available ChIPS servers.

Removing old server files

Socket files are stored by default in "/tmp/.chips.<username>/". Although ChIPS does attempt to remove these files when they are no-longer required, this may not happen in exceptional cases. If necessary, use list_servers() and check_server_exists(), to determine whether these files can be removed.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

server
check_server_exists, connect, create_server, disconnect, get_server_cwd, get_server_id, lock, unlock

Last modified: December 2013
Smithsonian Institute Smithsonian Institute

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