XmtVaRegisterSymbols(3) FreeBSD Library Functions Manual
NAME
XmtVaRegisterSymbols(), 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,
{ String name, String type, int size, XtPointer a
ddress, }
NULL)
XmtSymbol XmtLookupSymbol(String name)
ARGUMENTS
INPUTS
name The name of a symbol to be registered, or looked up. For
XmtVaRegisterSymbols() this argument may appear any number
of times as part of a NULL terminated variable-length
argument list.
type The representation type of the variable to be registered.
This argument may appear any number of times as part of a
NULL-terminated variable-length argument list.
size The size, in bytes, of the variable to be registered. This
argument may appear any number of times as part of a
NULL-terminated variable-length argument list.
address
The address of the variable to be registered. This argument
may appear any number of times as part of a NULL-terminated
variable-length argument list.
RETURNS
XmtLookupSymbol() returns the opaque XmtSymbol structure created
when the named symbol was registered.
DESCRIPTION
XmtVaRegisterSymbols() 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 ALSO
Chapter 12, Symbols,
XmtSymbolAddCallback(), XmtSymbolGetValue(), XmtSymbolRemoveCallback(),
XmtSymbolSetValue().
Xmt Motif Tools XmtVaRegisterSymbols(3)
permalink to the XmtVaRegisterSymbols command:
https://manpage.me/?XmtVaRegisterSymbols
link by Name, Section, and OS version of this man page:
/?q=XmtVaRegisterSymbols&manpath=FreeBSD+11.1-RELEASE+and+Ports