Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
KYUA-DB-EXEC(1)		FreeBSD	General	Commands Manual	       KYUA-DB-EXEC(1)

     kyua db-exec -- Executes a	SQL statement in a results file

     kyua db-exec [--no-headers] [--results-file file] statement

     The kyua db-exec command provides a way to	execute	an arbitrary SQL
     statement within the database.  This command is mostly intended to	aid in
     debugging,	but can	also be	used to	extract	information from the database
     when the current interfaces do not	provide	the desired functionality.

     The input database	must exist.  It	makes no sense to use kyua db-exec on
     an	non-existent or	empty database.

     The kyua db-exec command takes one	or more	arguments, all of which	are
     concatenated to form a single SQL statement.  Once	the statement is exe-
     cuted, kyua db-exec prints	the resulting table on the screen, if any.

     The following subcommand options are recognized:

	 Avoids	printing the headers of	the table in the output	of the com-

     --results-file path, -s path
	 Specifies the results file to operate on.  Defaults to	`LATEST',
	 which causes kyua db-exec to automatically load the latest results
	 file from the current test suite.

	 The following values are accepted:

	     Requests the load of the latest results file available for	the
	     test suite	rooted at the current directory.

	     Requests the load of the latest results file available for	the
	     test suite	rooted at the given directory.

	 Test suite name
	     Requests the load of the latest results file available for	the
	     given test	suite.

	 Results identifier
	     Requests the load of a specific results file.

	 Explicit file name (aka everything else)
	     Load the specified	results	file.

	 See Results files for more details.

   Results files
     Results files contain, as their name implies, the results of the execu-
     tion of a test suite.  Each test suite executed by	kyua-test(1) generates
     a new results file, and such results files	can be loaded later on by in-
     spection commands such as kyua-report(1) to analyze their contents.

     Results files support identifier-based lookups and	also path name
     lookups.  The differences between the two are described below.

     The default naming	scheme for the results files provides simple support
     for identifier-based lookups and historical recording of test suite runs.
     Each results file is given	an identifier derived from the test suite that
     generated it and the time the test	suite was run.	Kyua can later look up
     results files by these fileds.

     The identifier follows this pattern:


     where `test_suite'	is the path to the root	of the test suite that was run
     with all slashes replaced by underscores and `YYYYMMDD-HHMMSS-uuuuuu' is
     a timestamp with microsecond resolution.

     When using	the default naming scheme, results files are stored in the
     ~/.kyua/store/ subdirectory and each file holds a name of the form:


     Results files are simple SQLite databases with the	schema described in
     the /usr/local/share/kyua/store/schema_v?.sql files.  For details on the
     schema, please refer to the heavily commented SQL file.

     The kyua db-exec command returns 0	on success or 1	if the SQL statement
     is	invalid	or fails to run.

     Additional	exit codes may be returned as described	in kyua(1).

     kyua(1), kyua-test(1)

FreeBSD	13.0		       October 13, 2014			  FreeBSD 13.0


Want to link to this manual page? Use this URL:

home | help