GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > QSE / V1-5-2

Constituent: qsd     Tag: sun-gcc


Interface   Data Structures   File List   Data Fields   Globals  

QSD_process.h File Reference

Shareable to process a file of LSF datagrams. The processor is supplied either as a dynamically mapped shareable or passed by a parameter. More...

This graph shows which files directly or indirectly include this file:


Functions

int QSD_process (int argc, char *const argv[], const char *facility, const QSF_schema *generic)
 Process a file of datagrams.

Detailed Description

Shareable to process a file of LSF datagrams. The processor is supplied either as a dynamically mapped shareable or passed by a parameter.

Author:
JJRussell - russell@slac.stanford.edu
   CVS $Id: QSD_process.h,v 1.2 2005/11/18 01:32:31 russell Exp $

Function Documentation

int QSD_process int  argc,
char *const   argv[],
const char *  facility,
const QSF_schema generic
 

Process a file of datagrams.

Returns:
Overall status
Parameters:
argc The argument count
argv The vector of command line strings
facility The name of the facility invoking this utility.
generic The generic or default processor to use if none is supplied via the command line
Usage
This utility scans an input .lsd file, processing each datagram. The datagrams are processed by attempting to dynamically load a datagram specific processor meant to be customized for both
  1. The type of datagram being processed (from the datagram's ID) and
  2. The type of processing being requested (from the facility)

To this end the utility attempts to load a shareable whose name is constructed of these pieces
       lib<facility>_<datagram_id><variant>.so
  

Each of these components come from a different place

  • facility is from the calling program and is meant to define the type of processing being requested, e.g.

  • qsd_print, for a print utility
  • qsd_analyze, for a analysis utility

  • datagram_id is from the datagram itself. This number is formatted as a 0-filled 5-digit hex number, e.g. f0200 or 00111. Note that the hex digits represented by letters (a-f) are formatted in lower case.

  • variant is from the command line and is meant to indicate variations on the basic theme (i.e. a verbose print or a terse print option. This is not the greatest method since one can quickly enter permutation hell trying to build a shareable specific for each possible combination of options.


Generated on Tue Nov 21 01:38:55 2006 by  doxygen 1.4.4