---

GLAST/LAT > DAQ and FSW > FSW > Doxygen Index > FILE / V3-8-1

Constituent: file_hdr     Tag: linux-gcc

---

         

---

FILE_hdr.c File Reference

Function definitions for FILE header interface library. More...

#include "string.h"
#include "FILE/FILE_hdr.h"
#include "ZLIB/zlib.h"
#include "PBI/Endianness.h"
#include "FILE_hdr_private.h"

Include dependency graph for FILE_hdr.c:

Functions
unsigned int	FILE_hdrSizeof (void)
	Get the size of a file header.
unsigned int	FILE_hdrCreate (void *buf, unsigned int length, unsigned int time, unsigned int chksum, unsigned short type, unsigned int key, FILE_Hdr_Compression_Flag compress, const char *name)
	Create a new file header.
unsigned int	FILE_hdrGetLength (const void *buf, unsigned int *length)
	Get the file data size.
unsigned int	FILE_hdrGetChksum (const void *buf, unsigned int *chksum)
	Get the file checksum.
unsigned int	FILE_hdrGetTime (const void *buf, unsigned int *time)
	Get the file timestamp.
unsigned int	FILE_hdrGetType (const void *buf, unsigned short *type)
	Get the file type.
unsigned int	FILE_hdrGetKey (const void *buf, unsigned int *key)
	Get the file key.
unsigned int	FILE_hdrGetCompression (const void *buf, unsigned short *compress)
	Get the file compression flag.
unsigned int	FILE_hdrGetName (const void *buf, char *name)
	Get the file name string.
unsigned int	FILE_hdrVerify (const void *buf)
	Verify the integrety of a file header.

---

Detailed Description

Function definitions for FILE header interface library.

Author:

D.L. Wood

---

Function Documentation

unsigned int FILE_hdrCreate (  void *  buf, unsigned int  length, unsigned int  time, unsigned int  chksum, unsigned short  type, unsigned int  key, FILE_Hdr_Compression_Flag  compress, const char *  name )

Create a new file header. Creates a file header in the buffer specified by buf. The user is resposible for actually writing the new header into file storage. This library only supports buffers whose total size is aligned on a 16-bit boundary. The function will fail with error #FILE_EHDRPARM if the length parameter is not correctly aligned. Parameters: buf  A pointer to the file header buffer. length  The size in bytes of file data to follow the file header. time  The file timestamp, in seconds. chksum  The checksum of the remainder of the file header and file data. type  The file type code. key  The file key value. compress  #FILE_HDR_UNCOMPRESSED - The file data following the header is uncompressed. #FILE_HDR_COMPRESSED The file data following the header is compressed. name  The ASCII file name. This parameter should point to a buffer containing #FILE_HDR_NAME_SIZE characters. Returns: A FHDR MSG value.

unsigned int FILE_hdrGetChksum (  const void *  buf, unsigned int *  chksum )

Get the file checksum. Returns the checksum of the remainder of the file header and file data. Parameters: buf  A pointer to the start of the file header buffer. chksum  Stores the checksum value. Returns: A FILE MSG value.

unsigned int FILE_hdrGetCompression (  const void *  buf, unsigned short *  compress )

Get the file compression flag. Returns the file compression flag value. Parameters: buf  A pointer to the start of the file header buffer. compress  Stores the compression flag value. Returns: A FILE MSG value.

unsigned int FILE_hdrGetKey (  const void *  buf, unsigned int *  key )

Get the file key. Returns the file key value. Parameters: buf  A pointer to the start of the file header buffer. key  Stores the key value. Returns: A FILE MSG value.

unsigned int FILE_hdrGetLength (  const void *  buf, unsigned int *  length )

Get the file data size. Returns the size in bytes of file data following the file header. Parameters: buf  A pointer to the start of the file header buffer. length  Stores the length value. Returns: A FILE MSG value.

unsigned int FILE_hdrGetName (  const void *  buf, char *  name )

Get the file name string. Returns the file name string. The ASCII characters are copied to the user buffer indicated by name. The string is not NULL terminated after return. Parameters: buf  A pointer to the start of the file header buffer. name  Stores the name string. Should be at least FILE_HDR_NAME_SIZE bytes in size. Returns: A FILE MSG value.

unsigned int FILE_hdrGetTime (  const void *  buf, unsigned int *  time )

Get the file timestamp. Returns the file timestamp. Parameters: buf  A pointer to the start of the file header buffer. time  Stores the timestamp value. Returns: A FILE MSG value.

unsigned int FILE_hdrGetType (  const void *  buf, unsigned short *  type )

Get the file type. Returns the file type code. Parameters: buf  A pointer to the start of the file header buffer. type  Stores the type value. Returns: A FILE MSG value.

unsigned int FILE_hdrSizeof (  void   )

Get the size of a file header. Returns the size in bytes of a LAT file header. Returns: The header size.

unsigned int FILE_hdrVerify (  const void *  buf  )

Verify the integrety of a file header. Verifies the format of a file header in buf. Calculates header checksum and compares it to value stored in header. Parameters: buf  A pointer to the start of the file header buffer. Returns: A FILE MSG value.

---