forked from I2P_Developers/i2p.i2p
18d3f5d25d
* Within the tunnel, use xor(IV, msg[0:16]) as the flag to detect dups,
rather than the IV by itself, preventing an attack that would let
colluding internal adversaries tag a message to determine that they are
in the same tunnel. Thanks dvorak for the catch!
* Drop long inactive profiles on startup and shutdown
* /configstats.jsp: web interface to pick what stats to log
* Deliver more session tags to account for wider window sizes
* Cache some intermediate values in our HMACSHA256 and BC's HMAC
* Track the client send rate (stream.sendBps and client.sendBpsRaw)
* UrlLauncher: adjust the browser selection order
* I2PAppContext: hooks for dummy HMACSHA256 and a weak PRNG
* StreamSinkClient: add support for sending an unlimited amount of data
* Migrate the tests out of the default build jars
2005-06-22 Comwiz
* Migrate the core tests to junit
94 lines
3.3 KiB
Java
94 lines
3.3 KiB
Java
package net.i2p.data.i2np;
|
|
/*
|
|
* free (adj.): unencumbered; not under the control of others
|
|
* Written by jrandom in 2003 and released into the public domain
|
|
* with no warranty of any kind, either expressed or implied.
|
|
* It probably won't make your computer catch on fire, or eat
|
|
* your children, but it might. Use at your own risk.
|
|
*
|
|
*/
|
|
|
|
import java.io.IOException;
|
|
import java.io.InputStream;
|
|
|
|
import net.i2p.data.DataStructure;
|
|
|
|
/**
|
|
* Base interface for all I2NP messages
|
|
*
|
|
* @author jrandom
|
|
*/
|
|
public interface I2NPMessage extends DataStructure {
|
|
final long MAX_ID_VALUE = (1l<<32l)-1l;
|
|
final int MAX_SIZE = 64*1024; // insane
|
|
|
|
/**
|
|
* Read the body into the data structures, after the initial type byte, using
|
|
* the current class's format as defined by the I2NP specification
|
|
*
|
|
* @param in stream to read from
|
|
* @param type I2NP message type
|
|
* @param buffer scratch buffer to be used when reading and parsing
|
|
* @return size of the message read (including headers)
|
|
* @throws I2NPMessageException if the stream doesn't contain a valid message
|
|
* that this class can read.
|
|
* @throws IOException if there is a problem reading from the stream
|
|
*/
|
|
public int readBytes(InputStream in, int type, byte buffer[]) throws I2NPMessageException, IOException;
|
|
public int readBytes(byte data[], int type, int offset) throws I2NPMessageException, IOException;
|
|
|
|
/**
|
|
* Read the body into the data structures, after the initial type byte and
|
|
* the uniqueId / expiration, using the current class's format as defined by
|
|
* the I2NP specification
|
|
*
|
|
* @param data data to read from
|
|
* @param offset where to start in the data array
|
|
* @param dataSize how long into the data to read
|
|
* @param type I2NP message type
|
|
* @throws I2NPMessageException if the stream doesn't contain a valid message
|
|
* that this class can read.
|
|
* @throws IOException if there is a problem reading from the stream
|
|
*/
|
|
public void readMessage(byte data[], int offset, int dataSize, int type) throws I2NPMessageException, IOException;
|
|
|
|
/**
|
|
* Return the unique identifier for this type of I2NP message, as defined in
|
|
* the I2NP spec
|
|
*/
|
|
public int getType();
|
|
|
|
/**
|
|
* Replay resistent message Id
|
|
*/
|
|
public long getUniqueId();
|
|
public void setUniqueId(long id);
|
|
|
|
/**
|
|
* Date after which the message should be dropped (and the associated uniqueId forgotten)
|
|
*
|
|
*/
|
|
public long getMessageExpiration();
|
|
public void setMessageExpiration(long exp);
|
|
|
|
|
|
/** How large the message is, including any checksums */
|
|
public int getMessageSize();
|
|
/** How large the raw message is */
|
|
public int getRawMessageSize();
|
|
|
|
|
|
/**
|
|
* write the message to the buffer, returning the number of bytes written.
|
|
* the data is formatted so as to be self contained, with the type, size,
|
|
* expiration, unique id, as well as a checksum bundled along.
|
|
*/
|
|
public int toByteArray(byte buffer[]);
|
|
/**
|
|
* write the message to the buffer, returning the number of bytes written.
|
|
* the data is is not self contained - it does not include the size,
|
|
* unique id, or any checksum, but does include the type and expiration.
|
|
*/
|
|
public int toRawByteArray(byte buffer[]);
|
|
}
|