void drms_segment_filename ( DRMS_Segment_t seg,
char *  filename 
)

Returns the absolute path to the segment file associated with seg in filename. The size of the buffer to which filename points must be at least DRMS_MAXPATHLEN+1 bytes long.

After creating a new series record, but before committing it to PostgreSQL, all segment's files get written into SUMS, typically with the drms_segment_write call or the drms_segment_write_from_file call. During this writing, the segment's file name is assigned. The name gets saved in the record's sg_XXX_file column (where XXX refers to the segment number) when the containing record gets committed into the database. When an existing series' records are opened, the name in the sg_XXX_file column is then used to populate the segment's filename field, where it then becomes available when the drms_segment_filename function is called.

Parameters:
seg DRMS segment whose associated file's name will be returned.
filename Buffer to hold the filename upon return.

Definition at line 598 of file drms_segment.c.


Generated on Mon Mar 26 07:00:50 2018 for JSOC_Documentation by  doxygen 1.5.7.1