TCRTEST(1)

💖 NAME 💖

Okay bestie, welcome to TCRTEST(1) from Tokyo Tyrant 🫶 — tcrtest is literally test cases of the remote database API. That’s the name-section tea, and it ate 💅.

✨ DESCRIPTION ✨

The command tcrtest is a utility for facility test and performance test. It’s used in the following format, and we are keeping every command line exactly as written. host specifies the host name of the server. rnum specifies the number of iterations. No cap, every detail is staying 🌈.

tcrtest write

tcrtest write [-port num] [-cnum num] [-tout num] [-nr] [-rnd]
host rnum

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

tcrtest read

tcrtest read [-port num] [-cnum num] [-tout num] [-mul num]
[-rnd] host

Retrieve all records of the database above.

tcrtest remove

tcrtest remove [-port num] [-cnum num] [-tout num] [-rnd] host

Remove all records of the database above.

tcrtest rcat

tcrtest rcat [-port num] [-cnum num] [-tout num] [-shl num]
[-dai|-dad] [-ext name] [-xlr|-xlg] host rnum

Store records with partway duplicated keys using concatenate mode.

tcrtest misc

tcrtest misc [-port num] [-cnum num] [-tout num] host rnum

Perform miscellaneous test of various operations.

tcrtest wicked

tcrtest wicked [-port num] [-cnum num] [-tout num] host rnum

Perform updating operations of list and map selected at random.

tcrtest table

tcrtest table [-port num] [-cnum num] [-tout num] [-exp num] host
rnum

Perform miscellaneous test of the table extension.

Options are featuring the following, bestie 💅:

• -port num — specify the port number.
• -cnum num — specify the number of connections.
• -tout num — specify the timeout of each session in seconds.
• -nr — use the function tcrdbputnr instead of tcrdbput.
• -rnd — select keys at random.
• -mul num — specify the number of records for the mget command.
• -shl num — use tcrdbputshl and specify the width.
• -dai — use tcrdbaddint instead of tcrdbputcat.
• -dad — use tcrdbadddouble instead of tcrdbputcat.
• -ext name — call a script language extension function.
• -xlr — perform record locking.
• -xlg — perform global locking.
• -exp num — specify the lifetime of expiration test.

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 🦋

Go give these their flowers too: ttserver(1), ttultest(1), ttulmgr(1), tcrmttest(1), tcrmgr(1), ttutil(3), tcrdb(3) 💜.

---

Catch you later, bestie — this page is from the Tokyo Tyrant Man Page set, dated 2010-08-05, and signed off with maximum sparkle 🎀✨🫶