---
name: "tcrmttest"
section: "1"
platform: "linux"
package: "tokyotyrant-utils"
version: "1.1.40-4.2+b1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/tcrmttest"
---

# tcrmttest(1)

test cases of the remote database API

## NAME

tcrmttest - test cases of the remote database API

## DESCRIPTION

The command \`**tcrmttest**' is a utility for facility test under multi-thread situation.  This command is used in the following format.  \`*host*' specifies the host name of the server.  \`*rnum*' specifies the number of iterations.

**tcrmttest write** \[**-port** *num*\] \[**-tnum** *num*\] \[**-nr**\] \[**-rnd**\] \[**-ext** *name*\] *host* *rnum*

Store records with keys of 8 bytes.  They change as \`00000001', \`00000002'...

**tcrmttest read** \[**-port** *num*\] \[**-tnum** *num*\] \[**-mul** *num*\] *host*

Retrieve all records of the database above.

**tcrmttest remove** \[**-port** *num*\] \[**-tnum** *num*\] *host*

Remove all records of the database above.

Options feature the following.

**-port** *num* : specify the port number.\
 **-tnum** *num* : specify the number of running threads.\
 **-nr** : use the function \`tcrdbputnr' instead of \`tcrdbput'.\
 **-rnd** : select keys at random.\
 **-ext** *name* : call a script language extension function.\
 **-mul** *num* : specify the number of records for the mget command.\

If the port number is not more than 0, UNIX domain socket is used and the path of the socket file is specified by the host parameter.  This command returns 0 on success, another on failure.

## SEE ALSO

[**ttserver**(1)](/ttserver/1.md), [**ttultest**(1)](/ttultest/1.md), [**ttulmgr**(1)](/ttulmgr/1.md), [**tcrtest**(1)](/tcrtest/1.md), [**tcrmgr**(1)](/tcrmgr/1.md), [**ttutil**(3)](/ttutil/3.md), [**tcrdb**(3)](/tcrdb/3.md)