PK_FFOPRD_f_t

typedef void (*PK_FFOPRD_f_t)
(
--- received arguments ---
const int *guise,
const int *format,
const char name[],
const int *namlen,
const int *skiphd,
--- returned arguments ---
int *strid,
int *ifail
);

Used in:

PK_SESSION_ask_fru_o_t
PK_SESSION_frustrum_t
PK_SESSION_register_fru_o_t

  Open all guises of file (except rollback) for reading

Receives:
  int                      *guise          --- class of file:
                                           ---  FFCSNP,FFCJNL,FFCXMT
                                           ---  FFCXMO,FFCSCH,FFCLNC
                                           ---  snapshot,journal,C-transmit,
                                           ---  Fortran-transmit,schema,licence
  int                      *format         --- format code:
                                           ---  FFBNRY,FFTEXT (binary or text)
  char                      name[]         --- key which identifies file
                                           ---  (terminator not required)
  int                      *namlen         --- length of name
  int                      *skiphd         --- action required on opening file
                                           ---  FFSKHD,FFLVHD
                                           ---  skip header (the usual case) or
                                           ---  leave header (used by Frustrum
                                           ---                acceptance tests)

Returns:
  int                      *strid          --- id for stream on which
                                           --- file is open
  int                      *ifail          --- error code: FR_no_errors
                                           ---             FR_bad_name
                                           ---             FR_not_found
                                           ---             FR_bad_header
                                           ---             FR_open_fail


Description:
  This function opens all guises of existing files (except rollback) for
  reading, i.e. schema, C and Fortran transmit, journal, licence and snapshot
  files.

  If the 'skiphd' flag is set to FFSKHD, the header data is skipped when
  the file is opened. This is the mode which is used by Parasolid.

  If the 'skiphd' flag is set to FFLVHD, the header data is not skipped
  when the file is opened; the preamble, the parts data and the trailer
  are read by subsequent calls to FFREAD. This mode is only used by the
  TESTFR to validate what has been written by a particular implementation.

  The routine returns a frustrum stream identifier or 'strid'.
  This is used in subsequent calls to FFREAD and FFCLOS.