.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH GATE2WING 1 "DECEMBER 2008" "wing-utils" "User Commands"
.SH NAME
gate2wing \- transfer data from gateDB to wingDB
.SH SYNOPSIS
.B gate2wing [ -f ] [ -o
.I output-file
.B ]
.I component
.B ...
.SH DESCRIPTION
.B gate2wing 
reads the specified components from gateDB and transfers them to the
local wingDB. gate2wing transfers super modules, single chambers or
DCS boards. In the case of super modules or chambers, all electronics
mounted on the chamber will be transferred as well. This includes
ROBs, DCS board, ORIs and ORI configuration data. If the chamber is
not fully equipped,
.B gate2wing
will transfer the available parts and terminate successfully. 

Super modules can either be placed at the location specified in gateDB
or in any sector, independent from the information in gateDB.

When a single chamber is copied to a wingDB, a virtual super module
will be created in the requested location if none exists. The virtual
super module will have the slot (= sector) number + 100 as serial
number.

When a DCS board is inserted into a wingDB, a chamber of type L0C0
with a serial number of 1000 + the DCS board ID will be created. No
electronics will be installed on this chamber. A virtual super module
will be created if necessary.
.SH OPTIONS
.TP
\fBsm\fR\fIXY\fR\fR
transfer super module \fIXY\fR to sector specified in gateDB
.TP
\fBsm\fR\fIXY\fR=\fISLOT\fR
transfer super module \fIXY\fR to sector \fISLOT\fR
.TP
\fBL\fIX\fBC\fIY\fB_\fIABC\fR=\fISM_S_L\fR 
transfer chamber \fBL\fIX\fBC\fIY\fB_\fIABC\fR to super module
\fISM\fR, stack \fIS\fR layer \fIL\fR
.TP
\fBdcs\fIXYZ\fR=\fISM_S_L\fR
insert chamber with DCS board \fIXYZ\fR
at super module \fISM\fR, stack \fIS\fR layer \fIL\fR
.TP
\fB\-f\fR, \fB\-\-force\fR
force transfer by deleting any conflicting items from wingDB first
.TP
\fB\-o\fR, \fB\-\-file\fR=\fIFILENAME\fR
write SQL commands to \fIFILENAME\fR instead of direct transfer
to wingDB
.TP
\fB\-t\fR, \fB\-\-transfer\fR
direct transfer from gateDB to wingDB. This is the default and only provided 
for backwards compatibility. 
.SH FILES
.TP
.I /etc/trd/wingdb.conf ~/.wingdb
The system wide and user specific configuration file for accessing
wingDB. This file should look like:

Wing_Dbname   = host/dbname 

Wing_User     = user

Wing_Password = secret
.TP
.I /etc/trd/gatedb.conf ~/.gateDB
The system wide and user specific configuration file for accessing
gateDB. This file should look like:

Gate_Dbname   = gateDB

Gate_Host     = alice.physi.uni-heidelberg.de 

Gate_User     = alice

Gate_Password = PLEASE_ASK

.SH BUGS
None ;-)
.SH AUTHORS
Tom Dietel, Uwe Westerhoff