NAME
          irLibState - return the library state of a channel

     SYNOPSIS
          #include <irapi.h>

          int irLibState (channel_id cid);

     DESCRIPTION
          This function returns the library state associated with the
          cid. Channels are placed into various library states depend-
          ing on the channel activity and resource allocation situa-
          tions.

     EVENT
          No event results from the call to irLibState.

     RETURN VALUE
          A channel state [see IrSTATES(4IRAPI)] is returned if irLib-
          State is successful.

          IRR_FAIL is returned if an error occurs.

     ERROR
          irError is set to IRER_INVALID if the cid is invalid.

     SEE ALSO
          irServiceState(3IRAPI), IrSTATES(4IRAPI)

     VERSION
          This is version 11/25/02 of this man page.