fpe_coproc_alloc(3)                 CLIX                 fpe_coproc_alloc(3)



  NAME

    fpe_coproc_alloc - Allocates a Floating Point Engine (FPE) coprocessor

  LIBRARY

    Intergraph Device Library libix.a

  SYNOPSIS

    #include <sys/xio/xerr.h>

    #include <sys/xio/xfpe.h>

    int fpe_coproc_alloc(
      int *fpeno ,
      struct fpe_info *info );

  PARAMETERS

    fpeno   A pointer to a Floating-Point Engine number

    info    A pointer to an fpe_info structure

  DESCRIPTION

    The fpe_coproc_alloc() function allocates a Floating-Point Engine (FPE)
    for application-specific numeric operations.  A process which successfully
    allocates an FPE has sole control until it deallocates the FPE, execs, or
    exits.

    The fpeno paramter points to a location that is updated with the number of
    the allocated FPE.  A process uses this number with subsequent FPE
    functions to access the allocated FPE.

    The info parameter points to an fpe_info structure filled in by
    fpe_coproc_alloc().  As defined in the header file <sys/xio/xfpe.h>, the
    structure has the following members:

    int   i_slot;  /* FPE hardware slot number */
    int  *i_fifo;  /* FPE fifo register pointer */
    int  *i_status;     /* FPE status register pointer */

    The access mode for the i_fifo pointer is read/write, and the access mode
    for the i_status pointer is read-only.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the following failure codes is returned.




  2/94 - Intergraph Corporation                                              1

  fpe_coproc_alloc(3)                 CLIX                 fpe_coproc_alloc(3)



  ERRORS

    The fpe_coproc_alloc() function will fail if one of the following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request.

    [FPE_NOT_PRESENT]
           A floating-point processor is not available for allocation.

    [BAD_DATA_BUFFER_ADDRESS]
           The info parameter points to a nonwritable memory address.

  RELATED INFORMATION

    Functions:  fpe_coproc_dealloc(3)

    Files:  xfpe(7)



































  2                                              Intergraph Corporation - 2/94