ch.ethz.ssh2.ChannelCondition Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of ganymed-ssh2 Show documentation

Ganymed SSH-2: Java based SSH-2 Protocol Implementation

The newest version!

/*
 * Copyright (c) 2006-2011 Christian Plattner. All rights reserved.
 * Please refer to the LICENSE.txt for licensing details.
 */
package ch.ethz.ssh2;

/**
 * Contains constants that can be used to specify what conditions to wait for on
 * a SSH-2 channel (e.g., represented by a {@link Session}).
 *
 * @see Session#waitForCondition(int, long)
 *
 * @author Christian Plattner
 * @version 2.50, 03/15/10
 */

public abstract interface ChannelCondition
{
	/**
	 * A timeout has occurred, none of your requested conditions is fulfilled.
	 * However, other conditions may be true - therefore, NEVER use the "=="
	 * operator to test for this (or any other) condition. Always use
	 * something like ((cond & ChannelCondition.CLOSED) != 0).
	 */
	public static final int TIMEOUT = 1;

	/**
	 * The underlying SSH-2 channel, however not necessarily the whole connection,
	 * has been closed. This implies EOF. Note that there may still
	 * be unread stdout or stderr data in the local window, i.e, STDOUT_DATA
	 * or/and STDERR_DATA may be set at the same time.
	 */
	public static final int CLOSED = 2;

	/**
	 * There is stdout data available that is ready to be consumed.
	 */
	public static final int STDOUT_DATA = 4;

	/**
	 * There is stderr data available that is ready to be consumed.
	 */
	public static final int STDERR_DATA = 8;

	/**
	 * EOF on has been reached, no more _new_ stdout or stderr data will arrive
	 * from the remote server. However, there may be unread stdout or stderr
	 * data, i.e, STDOUT_DATA or/and STDERR_DATA
	 * may be set at the same time.
	 */
	public static final int EOF = 16;

	/**
	 * The exit status of the remote process is available.
	 * Some servers never send the exist status, or occasionally "forget" to do so.
	 */
	public static final int EXIT_STATUS = 32;

	/**
	 * The exit signal of the remote process is available.
	 */
	public static final int EXIT_SIGNAL = 64;

}