nlf_open(3)                         CLIX                         nlf_open(3)



  NAME

    nlf_open - Opens an Non-Linear Filter (NLF) channel

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int nlf_open(
      int channel ,
      int *base );

  PARAMETERS

    channel   An integer representing a Non-Linear Filter (NLF) channel

    base      A pointer to the virtual base address of the specified NLF board

  DESCRIPTION

    The nlf_open() function opens the specified Non-Linear Filter (NLF)
    channel.  Only one process is allowed to open an NLF channel at a time.
    Each NLF board in the system is represented by a channel number so that
    channel 0 references the NLF board with the lowest Shared Resource (SR)
    Bus slot number.  If the call is successful, base will contain the virtual
    base address of the specified NLF board.  All filter parameters are
    available to the calling process through this mapping.

  RETURN VALUES

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

  ERRORS

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

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

    [NLF_REDUNDANT_REQ]
           The specified channel is currently opened by this process.

    [NLF_CHANNEL_INVALID]
           The specified channel is beyond the maximum allowed.




  2/94 - Intergraph Corporation                                              1

  nlf_open(3)                         CLIX                         nlf_open(3)



    [NLF_CHANNEL_NOT_FOUND]
           The specified channel is not in the system.

    [NLF_CHANNEL_BUSY]
           The specified channel is currently opened by another process.

  RELATED INFORMATION

    Files:  xnlf(7)













































  2                                              Intergraph Corporation - 2/94