Command-Line Options

From BaseX Documentation
Revision as of 21:28, 23 January 2011 by CG (talk | contribs) (→‎BaseX Server)
Jump to navigation Jump to search

This page gives an overview on all command-line options of the BaseX Startup scripts:

BaseX Server

Console command

> basexserver

If the server has been succesfully started, this is coming up:

BaseX [Server]
Server was started.

Additional command-line flags can be listed by adding -h to the call:

> basexserver -h

Usage: BaseXServer [-dpsz] [-c] [stop]
  stop     Stop existing server
  -c<cmd>  Execute initial database command(s)
  -d       Activate debugging mode
  -i       Enter interactive mode
  -p<num>  Set server port
  -s       Start as service
  -z       Suppress logging

The command-line flags have the following meaning:

Flag Description Examples
stop Stop an existing server instance; remaining input is ignored.
-c<cmd> Launch database commands before the server itself is started; all remaining text is interpreted as command input. Several commands can be separated by semicolons. -c"open database;info"
-d Turns on debugging. Debugging information is output to standard error (STDERR).
-i Interactively enter commands on the console, similar to standalone and client mode.
-p<num> Specify the port on which the server can be addressed. -p9999
-s Start the server as service (i.e., in background).
-z Do not generate log files.

BaseX Client

Console command

> basexclient

Next, the user name and password has to be entered. By default, the user admin has admin as password:

Username: admin
Password:
> _

All available command-line flags can be listed by adding -h to the call:

> basexclient -h

Usage: BaseXClient [-npPU] [-dovVwz] [-cq] [file]
  [file]     Execute XQuery file
  -c<cmd>    Execute database command(s)
  -d         Activate debugging mode
  -n<name>   Set server (host) name
  -o<file>   Write output to file
  -p<num>    Set server port
  -P<pass>   Specify user password
  -q<expr>   Execute XQuery expression
  -U<name>   Specify user name
  -v/V       Show (all) process info
  -w         Keep whitespaces from source files
  -z         Skip output of results

BaseX Standalone

Console command

> basex

All available command-line flags can be listed by adding -h to the call:

> basex -h

Usage: BaseX [-diosuvVwz] [-cq] [file]
  [file]     Execute XQuery file
  -c<cmd>    Execute database command(s)
  -d         Activate debugging mode
  -i<file>   Open initial file or database
  -o<file>   Write output to file
  -q<expr>   Execute XQuery expression
  -s<pars>   Set serialization parameter(s)
  -u         Modifiy original files after updates
  -v/V       Show (all) process info
  -w         wrap query result to xml
  -z         Skip output of results