Tokyo Tyrant基本规范，翻译自Tokyo Tyrant官网。
本节介绍Tokyo Tyrant的客户端程序。
四. 客户端程序
1) tcrtest
'tcrtest'命令是用于敏捷测试和性能测试的工具。这个命令的使用格式如下。'host'指定服务器的主机名, 'rnum'指定重复测试的数目。
1. tcrtest write [-port num] [-cnum num] [-tout num] [-nr] [-rnd] host rnum
使用8字节作为key存储记录。key依次更改为'00000001', '00000002'...
2. tcrtest read [-port num] [-cnum num] [-tout num] [-mul num] [-rnd] host
获取数据库中的所有记录
3. tcrtest remove [-port num] [-cnum num] [-tout num] [-rnd] host
删除数据库中的所有记录
4. tcrtest rcat [-port num] [-cnum num] [-tout num] [-shl num] [-dai|-dad] [-ext name] [-xlr|-xlg] host rnum
使用连锁模式(concatenate mode)用中途重复的key来存储记录
5. tcrtest misc [-port num] [-cnum num] [-tout num] host rnum
执行不同操作的混合测试。
6. tcrtest wicked [-port num] [-cnum num] [-tout num] host rnum
随机选取list和map来执行更新操作
7. tcrtest table [-port num] [-cnum num] [-tout num] [-exp num] host rnum
执行table extension的混合测试
选项如下：
选项 意义
-port num 指定端口号
-cnum num 指定连接数
-tout num 指定每个会话的超时时间，单位秒
-nr 使用函数'tcrdbputnr'代替'tcrdbput'
-rnd 随机选取key
-mul num 为mget命令指定记录数
-shl num 使用'tcrdbputshl'并指定宽度
-dai 使用'tcrdbaddint'代替'tcrdbputcat'
-dad 使用'tcrdbadddouble'代替'tcrdbputcat'
-ext name 调用脚本语言扩展函数
-xlr 执行记录锁定
-xlg 执行全局锁定
-exp num 指定过期测试的生存时间
如果端口号不大于0，将使用UNIX domain socket同时socket文件的路径将由主机参数指定。这个命令成功时返回0，失败返回其他。
2) tcrmttest
'tcrmttest'是多线程环境下的敏捷测试工具。这个命令的使用格式如下。'host'指定服务器的主机名, 'rnum'指定重复测试的数目。
1. tcrmttest write [-port num] [-tnum num] [-nr] [-rnd] [-ext name] host rnum
使用8字节作为key存储记录。key依次更改为'00000001', '00000002'...
2. tcrmttest read [-port num] [-tnum num] [-mul num] host
获取数据库中的所有记录
3. tcrmttest remove [-port num] [-tnum num] host
删除数据库中的所有记录
选项如下：
选项 意义
-port num 指定端口号
-tnum num 指定运行的线程数
-nr 使用函数'tcrdbputnr'代替'tcrdbput'
-rnd 随机选取key
-ext name 调用脚本语言扩展函数
-mul num 为mget命令指定记录数
如果端口号不大于0，将使用UNIX domain socket同时socket文件的路径将由主机参数指定。这个命令成功时返回0，失败返回其他。
3) tcrmgr
'tcrmgr'是用于远程数据库API和应用程序的测试和调试工具。'host'指定服务器主机名，'key'指定记录的key。'value'指定记录的值。'params'指定调试参数。'dpath'指定目标文件。'func'指定函数名。'arg'指定函数的参
数。'file'指定输入文件。'upath'指定更新日志目录。'mhost'指定复制时master的主机名。'url'指定目标URL。
1. tcrmgr inform [-port num] [-st] host
打印各种信息到标准输出
2. tcrmgr put [-port num] [-sx] [-sep chr] [-dk|-dc|-dai|-dad] host key value
存储记录
3. tcrmgr out [-port num] [-sx] [-sep chr] host key
删除记录
4. tcrmgr get [-port num] [-sx] [-sep chr] [-px] [-pz] host key
打印记录的值
5. tcrmgr mget [-port num] [-sx] [-sep chr] [-px] host [key...]
打印多条记录的key和value
6. tcrmgr list [-port num] [-sep chr] [-m num] [-pv] [-px] [-fm str] host
打印所有记录的key，每行一条
7. tcrmgr ext [-port num] [-xlr|-xlg] [-sx] [-sep chr] [-px] host func [key [value]]
调用脚本语言扩展函数
8. tcrmgr sync [-port num] host
使用数据库文件同步更新内容
9. tcrmgr optimize [-port num] host [params]
优化数据库文件
10. tcrmgr vanish [-port num] host
删除所有记录
11. tcrmgr copy [-port num] host dpath
复制数据库文件
12. tcrmgr misc [-port num] [-mnu] [-sx] [-sep chr] [-px] host func [arg...]
为多种操作调用通用函数
13. tcrmgr importtsv [-port num] [-nr] [-sc] host [file]
从TSV文件的每行中读取并存储记录
14. tcrmgr restore [-port num] [-ts num] [-rcc] host upath
用更新日志恢复数据库
15. tcrmgr setmst [-port num] [-mport num] [-ts num] [-rcc] host [mhost]
设置复制的master。
16. tcrmgr repl [-port num] [-ts num] [-sid num] [-ph] host
复制更新日志
17. tcrmgr http [-ah name value] [-ih] url
使用HTTP获取URL的资源
18. tcrmgr version
打印Tokyo Tyrant的版本信息