NAME
trnew - create new trace database
SYNOPSIS
Dbptr trnew ( char *tr_path, char *schema_name );
DESCRIPTION
Trnew creates a new trace database, under the path specified
by
tr_path and with the schema specified by
schema_name.
If
tr_path is zero, then the database is created in /tmp, with
a name like trdbXXXXXX, where XXXXXX is an integer (following the
conventions of mktemp(3)) ;
If
schema_name is 0, then default_trace_schema from
trdefaults.pf(5)
is used.
FILES
Following the usual conventions for the location
of the schema, you may specify a local directory for
tr_path,
and place a schema file in that directory. Either name the file
"Trace4.1", or specify the name in the schema_name parameter.
RETURN VALUES
Trnew returns an invalid db pointer (dbinvalid), in the event of
an error.
LIBRARY
$(TRLIBS)
DIAGNOSTICS
-
Can't create temporary trace database
Probably, permissions prevented creation of the specified file.
-
Can't open temporary trace database
Probably the trace schema did not compile properly.
SEE ALSO
trintro(3)
dbintro(3)
AUTHOR
Daniel Quinlan