NAME
          iraReadRegFile, iraReadRegFP - Read the contents of an IRAPI
          Application Registration file into an AD_APPL structure.

     SYNOPSIS
          #include <irapi-ad.h>

          int iraReadRegFile(const char *reg_file, AD_APPL *p_appl)

          int iraReadRegFP(FILE *fp, AD_APPL *p_appl)

     DESCRIPTION
          These two functions read the contents of a registration file
          and place the information into a AD_APPL structure pointed
          to by p_appl.

          The iraReadRegFile function takes a filename of a registra-
          tion file and uses the function iraRegFilePath(3IRAPI) to
          translate the filename into a full pathname to the registra-
          tion file.  It then opens the file and calls iraReadRegFP to
          read the file.

          The iraReadRegFP function takes a FILE pointer to an already
          open registration file.

     RETURN VALUE
          IRR_OK if successful.

          IRR_FAIL on failure.

     ERROR
          On error, irError is set as follows:

          IRER_INVALID if an invalid argument is passed in.

          IRER_SYSERROR if a system error occurred, irSysError will be
          set to errno accordingly.

     SEE ALSO
          iraRegFilePath(3IRAPI-AD), iraWriteReg(3IRAPI), IRAPI-
          AD(4IRAPI-AD)

     VERSION
          This is version 8/31/00 of this man page.