rle_open(3)                         CLIX                         rle_open(3)



  NAME

    rle_open - Opens a Run Length Encoding (RLE) channel

  LIBRARY

    Intergraph Device Library ibix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int rle_open(
      int channel );

  PARAMETERS

    channel   Represents an RLE channel.

  DESCRIPTION

    The rle_open() function opens the specified Run Length Encoding (RLE)
    channel.  Only one process is allowed to open an RLE channel at a time.
    Each RLE board in the system is represented by a channel number so that
    channel 0 references the RLE board with the lowest Shared Resource (SR)
    Bus slot number.

  EXAMPLES

    To open RLE channel 0 for use:

    channel = 0;
    if (status = rle_open(channel)) {
         fprintf(stderr, "rle_open: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "rle_open: succeeded\n");


  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the failure codes listed in the ERRORS section is returned.

  ERRORS

    The rle_open() function fails if one of the following is true:

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



  2/94 - Intergraph Corporation                                              1

  rle_open(3)                         CLIX                         rle_open(3)



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

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

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

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

  RELATED INFORMATION

    Functions:  rle_cancel(3), rle_close(3), rle_pipe_mem(3), rle_setup(3)

    Files:  xrle(7)





































  2                                              Intergraph Corporation - 2/94