4.1  General Overview

The cdsclient package is a set of C and shell routines which can be built on Unix stations or PCs running Linux, which once compiled allow to query some databases located at CDS or on mirrors over the network.

The cdsclient package includes two generic query programs:

Specific programs like find2mass or finducac3 are connecting directly to one of the very large surveys available from CDS (a very large survey has 107 or more rows). Using a specific program is faster than the generic vizquery program which has to locate and transport the data via data-base queries; but such progams exist only for the list of enumerated large surveys below.

4.2  Package Installation

The tar file is available at http://cdsarc.cds.unistra.fr/ftp/pub/sw/cdsclient.tar.gz or as the file cdsclient.tar.gz in the ftp://cdsarc.cds.unistra.fr/pub/sw/ directory.

  1. Once the file is copied e.g. as the file cdsclient.tar.gz in your home directory, untar the file:

    tar xvfz cdsclient.tar.gz

    (the z option is available in the GNU tar; if your installation doesn't know the z option, execute
    gzip -cd cdsclient.tar.gz | tar xvf -

    A subdirectory cdsclient-V.vv (where V.vv represents the version number) is created; move to that directory by
    cd cdsclient-V.vv

  2. To configure the package for your system, type

    (on some old versions of System V, you might need to type sh configure )

    If you wish a final installation (executables, libraries, and manpages) in a non-standard directory tree structure (the default is /usr/local), specify the preferred prefix, e.g.
    ./configure --prefix=$HOME
    to prepare an installation of executables in your ~/bin directory — an installation which does not require any root privilege.

  3. Type make to compile the package.

  4. Type make install moves the various pieces to the standard directories (/usr/local/bin by default for the executables, see item 2 above to reconfigure, or just modify the value of PREFIX in the Makefile)

There are several query programs; as a rule, each program can be executed with the -help option to list the basic available options, e.g.

findgsc -help

A -HELP option is also available for details on the column contents for the programs that return data, like findgsc or findpmm

4.3  Package Contents

The available programs are:

4.4  Proxys and firewall

Most programs are using the port 1660 which may be closed (more and more institutes are closing almost all ports except a dozen or so like http, ssh, https, ...). It is possible to use alternative ports or servers via a CDSCLIENT environment variable:

Version 30-Dec-2009 For any question or problem, please contact cds-question

©UDS/CNRS  Contact: Question@simbad