edu.wisc.cs.stego
Class Profile

java.lang.Object
  |
  +--edu.wisc.cs.stego.Profile

public class Profile

extends java.lang.Object

Use this class to gather information about a java application for future use in watermarking. Place calls to the methods contained in this class in places where watermarking code can be added without drastic performace degradation. When the program is run on the designated watermark detection input, the profile will be written containing a line for each profile point passesd. In the watermarked program, these calls will be replaced by the code which builds the watermark graph.
Some guidelines on the placement of calls to the profiling methods:

• Along all paths through the program, the call to initializeProfile MUST appear before calls to any other profiling method.
• Do not place more than one call to a profiling method in the same method. The watermarking tool will not be able to differentiate these calls.
• Do not place calls to a profiling method in more than one version of an overloaded method. Since the profiling tool cannot discover the exact signature of the calling method, these will also be indistinguishable.

Field Summary

static java.lang.String

VERSION String containing version information.

Constructor Summary

Profile()

Method Summary

static void	initializeProfile(java.lang.String filename) Records information about the first profile point along the path through the program.
static ProfilePoint[]	readProfile(java.io.File f)
static void	recordPoint() Records information about a non-parameterized profile point.
static void	recordPoint(long lval) Records information about a profile point parameterized by a long value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VERSION

public static final java.lang.String VERSION

String containing version information.

Constructor Detail

Profile

public Profile()

Method Detail

readProfile

public static ProfilePoint[] readProfile(java.io.File f)
                                  throws java.io.IOException

Parameters:

f - a readable file object representing a profile file.

Throws:

java.io.IOException - if there is a problem reading the profile file.

initializeProfile

public static void initializeProfile(java.lang.String filename)

Records information about the first profile point along the path through the program. This function must always occur before a call to any other profile point along all paths through the program.

Parameters:

filename - file to write profile data to

recordPoint

public static void recordPoint()

Records information about a non-parameterized profile point.

recordPoint

public static void recordPoint(long lval)

Records information about a profile point parameterized by a long value. This operation is currently unsupported.

Parameters:

lval - a long value parameterizing this profile point.