GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > QLSM / V2-0-0

Constituent: qlsm     Tag: linux-gcc


Interface   Data Structures   File List   Data Fields   Globals  

QLSM_istream.h File Reference

Interface to the stream reading of QLSM CCSDS encapsulated datagrams. More...

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


Data Structures

struct  _QLSM_istreamDsc
 Descriptor for the read object. More...

Typedefs

typedef _QLSM_istream QLSM_istream
 Typedef for struct _QLSM_istream.
typedef _CCSDS_istream CCSDS_istream
typedef _QLSM_istreamDsc QLSM_istreamDsc
 Typedef for struct _QLSM_istreamDsc.

Functions

int QLSM_istreamSizeof (void)
 Returns the size, in bytes, of QLSM_istream handle.
QLSM_istreamQLSM_istreamNew (void)
 Allocates a QLSM_istream handle.
int QLSM_istreamConstruct (QLSM_istream *istream, CCSDS_istream *ccsds)
 Opens a QLSM file or data for reading.
int QLSM_istreamRead (QLSM_istream *istream, QLSM_istreamDsc *dsc, unsigned int filter)
 Reads the next object in the QLSM stream.
int QLSM_istreamClose (QLSM_istream *istream)
 Closes the stream.
int QLSM_istreamDelete (QLSM_istream *istream)
 Deletes the QLSM_istream.
int QLSM_istreamFileOpen (QLSM_istream *istream, const char *filename, unsigned int options, unsigned char *buf, unsigned int buf_size)
 Convenience routine to construct a QLSM_istreamFileOpen to read from the specified name file filename.

Detailed Description

Interface to the stream reading of QLSM CCSDS encapsulated datagrams.

Author:
JJRussell - russell@slac.stanford.edu
   CVS $Id: QLSM_istream.h,v 1.1 2008/09/20 00:39:15 russell Exp $

Function Documentation

int QLSM_istreamClose QLSM_istream stream  ) 
 

Closes the stream.

This function only closes the file.To free the memory associated with the contents of the file, the user must call QLSM_istreamFree().

int QLSM_istreamConstruct QLSM_istream istream,
CCSDS_istream *  ccsds
 

Opens a QLSM file or data for reading.

Return values:
0,success 
!= 0, failure
Parameters:
istream The stream handle to construct
ccsds A previously construct CCSDS_istream

int QLSM_istreamDelete QLSM_istream istream  ) 
 

Deletes the QLSM_istream.

Parameters:
istream The event builder stream handle
After calling QLSM_istreamDelete, the contents and the QLSM stream handle are no longer valid.

int QLSM_istreamFileOpen QLSM_istream istream,
const char *  filename,
unsigned int  options,
unsigned char *  buf,
unsigned int  buf_size
 

Convenience routine to construct a QLSM_istreamFileOpen to read from the specified name file filename.

Return values:
0,If successful
-1,If could not allocate a new stream (i.e. out of memory)
-2,If the file does not exist
Parameters:
istream The target CCSDS_istream
filename The name of the file to open
options Bit list of options, currently unused, specify as 0
buf Optional parameter specifying the FILE's input read buffer
buf_size Optional parameter specifying the size of buf

int QLSM_istreamRead QLSM_istream istream,
QLSM_istreamDsc dsc,
unsigned int  filter
 

Reads the next object in the QLSM stream.

Return values:
0,if successful
-1,if not
Parameters:
istream A previously opened event builder stream handle
dsc If successful, filled in with a description of the read object. This includes its
  • type
  • length, in 32-bit words
  • address
filter A bit mask of the object(s) the user wishes to have returned.

int QLSM_istreamSizeof void   ) 
 

Returns the size, in bytes, of QLSM_istream handle.

Returns:
The size, in bytes, of QLSM_istream handle


Generated on Sun Jun 14 02:17:28 2009 by  doxygen 1.4.4