obfuscate.h File Reference

Contains functions for internal obfuscation. More...

Go to the source code of this file.

Defines
#define	obf_sig(x)   (obf_mode ? obfuscate_name(x,'s') : x)
#define	obf_funit(x)   (obf_mode ? obfuscate_name(x,'f') : x)
#define	obf_file(x)   (obf_mode ? obfuscate_name(x,'v') : x)
#define	obf_inst(x)   (obf_mode ? obfuscate_name(x,'i') : x)
Functions
void	obfuscate_set_mode (bool value)
	Sets the global 'obf_mode' variable to the specified value.
char *	obfuscate_name (const char *real_name, char prefix)
	Gets an obfuscated name for the given actual name.
void	obfuscate_dealloc ()
	Deallocates all memory associated with obfuscation.
Variables
bool	obf_mode

---

Detailed Description

Contains functions for internal obfuscation.

Author:

Trevor Williams (phase1geo@gmail.com)

Date:

9/16/2006

---

Define Documentation

#define obf_file

(

x

)

(obf_mode ? obfuscate_name(x,'v') : x)

Used for obfuscating file names. Improves performance when obfuscation mode is not turned on.

Referenced by assertion_funit_summary(), assertion_funit_verbose(), assertion_instance_verbose(), bind_perform(), bind_signal(), bind_task_function_namedblock(), combination_funit_summary(), combination_funit_verbose(), combination_instance_verbose(), covered_cb_error_handler(), db_add_file_version(), db_add_function_task_namedblock(), db_add_instance(), db_add_module(), db_create_expression(), db_read(), db_statement_connect(), db_write(), enumerate_resolve(), fsm_arg_parse_attr(), fsm_arg_parse_trans(), fsm_funit_summary(), fsm_funit_verbose(), fsm_instance_verbose(), line_funit_summary(), line_funit_verbose(), line_instance_verbose(), memory_ae_funit_summary(), memory_funit_verbose(), memory_instance_verbose(), memory_toggle_funit_summary(), print_output(), race_handle_race_condition(), race_report_summary(), race_report_verbose(), scope_find_param(), scope_find_signal(), scope_find_task_function_namedblock(), toggle_funit_summary(), toggle_funit_verbose(), toggle_instance_verbose(), VLerror(), and VLwarn().

#define obf_funit

(

x

)

(obf_mode ? obfuscate_name(x,'f') : x)

Used for obfuscating functional unit names. Improves performance when obfuscation mode is not turned on.

Referenced by bind_display_list(), bind_signal(), combination_funit_summary(), covered_parse_instance(), covered_parse_task_func(), db_add_function_task_namedblock(), db_add_instance(), db_add_module(), db_create_expression(), db_find_signal(), db_remove_statement_from_current_funit(), fsm_var_bind_expr(), funit_db_write(), funit_display_expressions(), funit_display_signals(), funit_link_display(), gen_item_resolve(), memory_funit_verbose(), ovl_display_verbose(), race_report_verbose(), scope_find_param(), scope_find_signal(), scope_find_task_function_namedblock(), and toggle_funit_verbose().

#define obf_inst

(

x

)

(obf_mode ? obfuscate_name(x,'i') : x)

Used for obfuscating instance names. Improves performance when obfuscation mode is not turned on.

Referenced by combination_instance_summary(), covered_parse_instance(), db_add_instance(), db_add_override_param(), db_assign_symbol(), db_set_vcd_scope(), db_vcd_upscope(), gen_item_resolve(), gen_item_stringify(), and ovl_display_verbose().

#define obf_sig

(

x

)

(obf_mode ? obfuscate_name(x,'s') : x)

Used for obfuscating signal names. Improves performance when obfuscation mode is not turned on.

Referenced by bind_display_list(), bind_signal(), covered_create_value_change_cb(), covered_parse_signals(), covered_parse_task_func(), covered_value_change_bin(), covered_value_change_real(), db_add_declared_param(), db_add_defparam(), db_add_override_param(), db_add_signal(), db_add_vector_param(), db_assign_symbol(), db_find_signal(), defparam_add(), fsm_arg_parse_attr(), fsm_var_bind_expr(), gen_item_resolve(), gen_item_stringify(), mod_parm_display(), scope_find_param(), scope_find_signal(), scope_gen_printable(), sig_link_display(), vsignal_display(), and vsignal_vcd_assign().

---

Function Documentation

void obfuscate_dealloc

(

)

Deallocates all memory associated with obfuscation.

References PROFILE, PROFILE_END, and tree_dealloc().

Referenced by main().

                         { PROFILE(OBFUSCATE_DEALLOC);

  tree_dealloc( obf_tree );

  PROFILE_END;

}

char* obfuscate_name	(	const char *	real_name,
		char	prefix
	)

Gets an obfuscated name for the given actual name.

Returns:

Returns the obfuscated name for this object.

Looks up the given real name in the obfuscation tree. If it exists, simply return the given name; otherwise, create a new element in the tree to represent this new name.

Parameters:

	real_name	Name of actual object in design
	prefix	Character representing the prefix of the obfuscated name

References FALSE, free_safe, malloc_safe, obf_curr_id, PROFILE, PROFILE_END, tree_add(), tree_find(), and tnode_s::value.

  { PROFILE(OBFUSCATE_NAME);

  tnode*       obfnode;    /* Pointer to obfuscated tree node */
  char*        key;        /* Temporary name used for searching */
  char         tname[30];  /* Temporary name used for sizing obfuscation ID */
  unsigned int rv;         /* Return value from snprintf calls */
  unsigned int slen;       /* String length */

  /* Create temporary name */
  slen = strlen( real_name ) + 3;
  key = (char*)malloc_safe( slen );
  rv = snprintf( key, slen, "%s-%c", real_name, prefix );
  assert( rv < slen );

  /* If the name was not previously obfuscated, create a new obfuscated entry in the tree and return the new name */
  if( (obfnode = tree_find( key, obf_tree )) == NULL ) {

    /* Create obfuscated name */
    rv = snprintf( tname, 30, "%c%04d", prefix, obf_curr_id );
    assert( rv < 30 );
    obf_curr_id++;

    /* Add the obfuscated name to the tree and get the pointer to the new node */
    obfnode = tree_add( key, tname, FALSE, &obf_tree );

  }

  /* Deallocate key string */
  free_safe( key, (strlen( key ) + 1) );

  PROFILE_END;

  return( obfnode->value );

}

void obfuscate_set_mode

(

bool

value

)

Sets the global 'obf_mode' variable to the specified value.

Parameters:

value

Boolean value to set obfuscation mode to

References obf_mode, PROFILE, and PROFILE_END.

Referenced by main().

  { PROFILE(OBFUSCATE_SET_MODE);

  obf_mode = value;

  PROFILE_END;

}

---

Variable Documentation

bool obf_mode

Specifies obfuscation mode.

Referenced by obfuscate_set_mode().