/*
 * Suspend (stop monitoring) a monitor request.
 *
 * Raises a Fam::Error exception if the monitor request could not be
 * suspended.  Note that this method exists under Gamin, but does not
 * actually do anything.
 * 
 * Aliases:
 *   Fam::Connection#suspend
 *
 * Examples:
 *   fam.suspend_monitor req
 *   fam.suspend req
 *
 */
static VALUE fam_conn_suspend(VALUE self, VALUE request)
{
  FAMConnection *conn;
  FAMRequest *req;
  int err;

  Data_Get_Struct(self, FAMConnection, conn);
  Data_Get_Struct(request, FAMRequest, req);
  err = FAMSuspendMonitor(conn, req);

  if (err == -1) {
    rb_raise(eError, "Couldn't suspend monitor request %d: %s",
             FAMREQUEST_GETREQNUM(req), fam_error());
  }

  return self;
}