.TH drslib 

.SH NAME
drs_tool - Command-line interface to DRSLIB

.SH SYNPOSIS

.SH DESCRIPTION

.SH USAGE
Usage

Usage: drs_tool [command] [options] [drs-pattern]

command:
list 	list publication-level datasets
todo 	show file operations pending for the next version
upgrade 	make changes to the selected datasets to upgrade to the next version
mapfile 	make a mapfile of the selected dataset
history 	list all versions of the selected dataset
init 	initialise CMIP5 product detection data

.SH OPTIONS

.TP
\fB\-\-help\fR
display this help message and exit

.TP
\fB\-\-version\fR
output version information and exit


    -h, --help 	show this help message and exit
    -R ROOT, --root=ROOT
     	Root directory of the DRS tree
    -I INCOMING, --incoming=INCOMING
     	Incoming directory for DRS files. Defaults to <root>/output
    -a ACTIVITY, --activity=ACTIVITY
     	Set DRS attribute activity for dataset discovery
    -p PRODUCT, --product=PRODUCT
     	Set DRS attribute product for dataset discovery
    -i INSTITUTE, --institute=INSTITUTE
     	Set DRS attribute institute for dataset discovery
    -m MODEL, --model=MODEL
     	Set DRS attribute model for dataset discovery
    -e EXPERIMENT, --experiment=EXPERIMENT
     	Set DRS attribute experiment for dataset discovery
    -f FREQUENCY, --frequency=FREQUENCY
     	Set DRS attribute frequency for dataset discovery
    -r REALM, --realm=REALM
     	Set DRS attribute realm for dataset discovery
    -v VERSION, --version=VERSION
     	Force version upgrades to this version
    -P FILE, --profile=FILE
     	Profile the script exectuion into FILE
    --detect-product
     	Automatically detect the DRS product of incoming data

.SH REQUIRES

.SH
.SH FILES
.I drs_tool
uses 
.I metaconfig
to configure and store configuration information. Its configuration may be found then in a 
.I metaconfig.conf
file, in 
.B /etc/metaconfig/metaconfig.conf
on Debian systems, which may be overriden by 
.B $HOME/.metaconfig.conf 
or 
.B ./metaconfig.conf

.SH ENVIRONMENT VARIABLES
The variable
.B METACONF_CONF

.SH VERSION
0.3.0a3
.SH    BUGS
To query and report bugs in drs_tool, please use
.I reportbug
on Debian systems.
.SH    SEE ALSO
http://esgf.org/esgf-drslib-site/index.html

.SH AUTHOR
DRSLIB was written by Stephen Pascoe, STFC.SC.UK.
This manual page was written by Alastair McKinstry.