NAME

       ktserver - a lightweight database server

DESCRIPTION

       The  command  `ktserver'  runs  the  server  managing  database  instances.   This command is used in the
       following format.  `db' specifies a database name.  If no database is  specified,  an  unnamed  on-memory
       database is opened.

              ktserver  [-host  str] [-port num] [-tout num] [-th num] [-log file] [-li|-ls|-le|-lz] [-ulog dir]
              [-ulim num] [-uasi num] [-sid num] [-ord] [-oat|-oas|-onl|-otl|-onr] [-asi num] [-ash] [-bgs  dir]
              [-bgsi  num] [-bgc str] [-dmn] [-pid file] [-scr file] [-mhost str] [-mport num] [-rts file] [-riv
              num] [-plsv file] [-plex str] [-pldb file] [db...]

       Options feature the following.

              -host str : specifies the host name of the server.
              -port num : specifies the port number of the server.
              -tout num : specifies the timeout in seconds.
              -th num : specifies the number of worker threads.  By default, it is 8.
              -log file : specifies the path of the log file.  By default, logs are written  into  the  standard
              output.
              -li : sets the logging level "INFO".
              -ls : sets the logging level "SYSTEM".
              -le : sets the logging level "ERROR".
              -lz : sets the logging level "NONE".
              -ulog dir : specifies the path of the update log directory.  By default, it is disabled.
              -ulim num : specifies the limit size of each update log file.
              -uasi  num  :  specifies  the  interval of synchronization of update log files.  By default, it is
              disabled.
              -sid num : specifies the server ID number.
              -ord : opens the database as a reader.
              -oat : opens the database with the auto transaction option.
              -oas : opens the database with the auto synchronization option.
              -onl : opens the database with the no locking option.
              -otl : opens the database with the try locking option.
              -onr : opens the database with the no auto repair option.
              -asi num : specifies the interval of auto synchronization.  By default, it is disabled.
              -ash : does physical synchronization while auto synchronization.
              -bgs dir : specifies the path of the background snapshot directory.  By default, it is disabled.
              -bgsi num : specifies the interval of background snapshotting.  By default, it is 180.
              -bgsc str : specifies the compression algorithm of the snapshot.  "zlib", "lzo",  are  "lzma"  are
              supported.
              -dmn : switches to a daemon process.
              -pid file : specifies the file to contain the process ID to send signals by.
              -cmd  dir  :  specifies the command search path for outer commands.  By default, it is the current
              directroy.
              -scr file : specifies the script file for the scripting extention.
              -mhost str : specifies the host name of the master server of replication.
              -mport num : specifies the port number of the master server of replication.
              -rts file : specifies the file to contain the replication time stamp.
              -riv num : specifies the interval of each replication operation in milliseconds.  By  default,  it
              is 0.04.
              -plsv file : specifies the shared library file of a pluggable server.
              -plex str : specifies the configuration expression of a pluggable server.
              -pldb file : specifies the shared library file of a pluggable database.

       This command returns 0 on success, another on failure.

       To finish the server process running on foreground, input `Ctrl-C' on the terminal.  To finish the server
       process running as a daemon, send a termination signal such as SIGTERM  by  the  `kill'  command.   If  a
       daemon  process  catches  SIGHUP, the server restarts and the log file is re-opened.  Because thr current
       directory of a daemon process is changed to  the  root  directory,  paths  of  related  files  should  be
       described as their absolute paths.

       The  naming  convention  of database name is the same as polymorphic database of Kyoto Cabinet.  If it is
       "-", the database will be a prototype hash database.  If it is "+", the database will be a prototype tree
       database.   If  it  is  ":", the database will be a stash database.  If it is "*", the database will be a
       cache hash database.  If it is "%", the database will be a cache tree database.  If its suffix is ".kch",
       the  database  will  be  a file hash database.  If its suffix is ".kct", the database will be a file tree
       database.  If its suffix is ".kcd", the database will be a directory hash database.   If  its  suffix  is
       ".kcf",  the database will be a directory tree database.  Tuning parameters can trail the name, separated
       by "#".  Each parameter is composed of the name and the value, separated by "=".  If the "type" parameter
       is  specified,  the  database  type  is determined by the value in "-", "+", ":", "*", "%", "kch", "kct",
       "kcd", and "kcf".  All database types support the logging parameters of "log", "logkinds",  and  "logpx".
       The  prototype  hash  database and the prototype tree database do not support any other tuning parameter.
       The stash database supports "bnum".  The cache hash database supports "opts", "bnum", "zcomp",  "capcnt",
       "capsiz",  and "zkey".  The cache tree database supports all parameters of the cache hash database except
       for capacity limitation, and supports "psiz", "rcomp", "pccap"  in  addition.   The  file  hash  database
       supports  "apow",  "fpow", "opts", "bnum", "msiz", "dfunit", "zcomp", and "zkey".  The file tree database
       supports all parameters of the file  hash  database  and  "psiz",  "rcomp",  "pccap"  in  addition.   The
       directory  hash  database supports "opts", "zcomp", and "zkey".  The directory tree database supports all
       parameters of the directory hash database and "psiz", "rcomp", "pccap" in addition.

       Furthermore, several parameters are added by Kyoto Tycoon.  "ktopts"  sets  options  and  the  value  can
       contain  "p"  for the persistent option.  "ktcapcnt" sets the capacity by record number.  "ktcapsiz" sets
       the capacity by database size.

SEE ALSO

       ktremotetest(1), ktremotemgr(1)