|
NAMEXmtVaRegisterSymbols(), XmtLookupSymbol() - register a name for application variables, and lookup variables by name.SYNOPSIS#include <Xmt/Symbols.h>
void XmtVaRegisterSymbols(String name,
String type, int size, XtPointer
address,
XmtSymbol XmtLookupSymbol(String name) ARGUMENTSINPUTS
RETURNS XmtLookupSymbol() returns the opaque XmtSymbol structure created when the named symbol was registered. DESCRIPTIONXmtVaRegisterSymbols() lets you register symbolic names for application variables. It takes a NULL-terminated list of (name, type, size, address) quadruples. For each set of values, it registers name as the symbolic name for the variable at address with size size and representation type type.Both of the String arguments, name and type must be constant strings, or at least permanently allocated strings-the symbol registration function does not make copies of these strings, so they must not be in memory that will be freed, nor in memory on the stack. Similarly, of course, you will want the address argument to be the address of a static or global variable, or at least the address of memory that has been allocated and will never be freed. XmtLookupSymbol() looks up an XmtSymbol structure for a named symbol. The XmtSymbol is an internal representation that is created when symbols are registered. It can be used with other symbol manipulation functions. SEE ALSOChapter 12, Symbols,XmtSymbolAddCallback(), XmtSymbolGetValue(), XmtSymbolRemoveCallback(), XmtSymbolSetValue().
Visit the GSP FreeBSD Man Page Interface. |