Man Linux: Main Page and Category List

NAME

       read_scf, fread_scf, read_scf_header - Read SCF files

SYNOPSIS

       #include <scf.h>

       Scf *read_scf(
            char *fn);

       Scf *fread_scf(
            FILE *fp);

       int read_scf_header(
            FILE *fp,
            Header *h);

DESCRIPTION

       These  functions  read  SCF  format  trace  files.  All  the  functions
       accepting a FILE * as an argument assume that the file  pointer  is  at
       the correct offset within the file.

       read_scf()  reads  an  entire  SCF file into the Scf structure (see the
       scf(4) manual page for the details of this structure). The data is read
       from the specified file name.

       fread_scf()  reads  an  entire SCF file into the Scf structure (see the
       scf(4) manual page for the details of this structure). The data is read
       from  the  specified  file  pointer, which is neither closed or rewound
       after the operation.

       read_scf_header() reads the Header structure from  the  specified  file
       pointer.

RETURN VALUES

       On  successful  completion,  the  read_scf()  and fread_scf() functions
       return a pointer to a Scf structure. Othewise these functions return  a
       null pointer.

       On  successful  completion,  the  read_scf_header() function returns 0.
       Otherwise the function returns -1.

SEE ALSO

       scf(4), write_scf(3)

                                                                   read_scf(3)