Tokyo Tyrant基本規(guī)范，翻譯自tt官網(wǎng)，地址。
本節(jié)介紹Tokyo Tyrant的服務(wù)器程序。
三. 服務(wù)器程序
1) ttserver
命令'ttserver'運行服務(wù)器端管理一個數(shù)據(jù)庫實例。因為數(shù)據(jù)庫被視為Tokyo Cabinet的抽象API，你可以在服務(wù)器啟動時選擇方案。支持的方案有on-memory hash database, on-memory tree database, hash database, 和 B+ tree database. 這個命令的使用格式如下。'dbname'指定數(shù)據(jù)庫名稱。缺省使用on-memory hash database。
ttserver [-host name] [-port num] [-thnum num] [-tout num] [-dmn] [-pid path] [-kl] [-log path] [-ld|-le] [-ulog path] [-ulim num] [-uas] [-sid num] [-mhost name] [-mport num] [-rts path] [-rcc] [-skel name] [-mul num] [-ext path] [-extpc name period] [-mask expr] [-unmask expr] [dbname]
選項說明如下：
-host name : 指定服務(wù)器的主機(jī)名或地址。默認(rèn)，每個網(wǎng)絡(luò)地址都將被綁定
-port num : 指定端口號。默認(rèn)為1978
-thnum num : 指定工作線程。默認(rèn)為8
-tout num : 指定每個會話(session)的超時時間，單位秒。默認(rèn)不超時。
-dmn : 作為守護(hù)進(jìn)程工作
-pid path : 輸出進(jìn)程id到文件
-kl : 如果發(fā)現(xiàn)進(jìn)程id文件存在，殺死已存在的進(jìn)程
-log path : 輸出日志信息到文件
-ld : 將debug信息寫入日志文件
-le : 僅僅寫入錯誤信息到日志文件
-ulog path : 指定更新日志目錄
-ulim num : 指定每個更新日志文件的大小限制
-uas : 為更新日志使用異步I/O
-sid num : 指定服務(wù)器ID
-mhost name : 指定復(fù)制主服務(wù)器的主機(jī)名
-mport num : 指定復(fù)制主服務(wù)器的端口號
-rts path : 指定復(fù)制時間戳文件
-rcc : 檢查復(fù)制的一致性
-skel name : 指定骨架(skeleton，基本?)數(shù)據(jù)庫類庫的名稱
-mul num : 指定多數(shù)據(jù)庫機(jī)制的分區(qū)數(shù)量
-ext path : 指定腳本語言擴(kuò)展文件
-extpc name period : 指定周期命令的函數(shù)名和調(diào)用周期
-mask expr : 指定禁用命令的名稱
-unmask expr : 指定容許使用的命令的名稱
發(fā)送SIGINT或SIGTERM到進(jìn)程可正常關(guān)閉服務(wù)器，。也可以在控制終端中按Ctrl-C。發(fā)送SIGHUP可重啟服務(wù)器。如果端口號不大于0，將使用UNIX domain socket同時socket文件的路徑將由主機(jī)參數(shù)指定。這個命令成功時返回0，失敗返回其他。
數(shù)據(jù)庫命名協(xié)定由Tokyo Cabinet的抽象API指定。名稱為
名稱 數(shù)據(jù)庫
"*" on-memory hash database
'+' on-memory tree database
".tch"后綴 hash database
".tcb"后綴 B+ tree database
".tcf" fixed-length database
".tct" table database
別的名稱則這個方法失敗。
名字后面可以追加調(diào)整參數(shù)，用"#"分隔。每個參數(shù)由名稱和值組成，用"="分隔。
數(shù)據(jù)庫 支持參數(shù)
On-memory hash database "bnum", "capnum", "capsiz"
On-memory tree database "capnum", "capsiz"
Hash database "mode", "bnum", "apow", "fpow", "opts", "rcnum", "xmsiz", "dfunit"
B+ tree database "mode", "lmemb", "nmemb", "bnum", "apow", "fpow", "opts", "lcnum", "ncnum", "xmsiz", "dfunit"
Fixed-length database "mode", "width", "limsiz"
Table database "mode", "bnum", "apow", "fpow", "opts", "rcnum", "lcnum", "ncnum", "xmsiz", "dfunit", "idx"
參數(shù)名 作用
"bnum" 指定bucket number
"capnum" 指定記錄的容量數(shù)
"capsiz" 指定使用內(nèi)存的容量大小. 超過容量的記錄將基于存儲順序被刪除.
"mode" 可包含"w"/寫, "r"/讀, "c"/創(chuàng)建, "t"/縮短(truncating), "e"/不加鎖, "f"/不阻塞鎖. 默認(rèn)模式為"wc".
"opts" 可包含"l" / large選項, "d" / Deflate選項，"b" / BZIP2 選項, "t" / TCBS 選項
"idx" 指定索引的列名和類型，用":"分隔。例如，"casket.tch#bnum=1000000#opts=ld" 表示數(shù)據(jù)庫文件名是"casket.tch", bucket number 是 1000000, 選項是large和Deflate.
命令掩碼表達(dá)式(command mask expression)是由","分隔的命令列表。例如，"out,vanish,copy"表示"out", "vanish"和"copy"的集合。memcached 兼容協(xié)議命令和HTTP 兼容協(xié)議命令也同樣被禁止或容許，和每個初始命令的掩碼相關(guān)。此外，還有meta 表達(dá)式：
表達(dá)式 表示的命令
"all" 所有命令
"allorg" 所有原始二進(jìn)制協(xié)議的命令
"allmc" 所有memcached兼容協(xié)議的命令
"allhttp" 所有HTTP兼容協(xié)議的命令"allread" 縮寫，包括'get', 'mget', 'vsiz', 'iterinit', 'iternext', 'fwmkeys', 'rnum', 'size', 'stat'.
"allwrite" 縮寫，包括'put', 'putkeep', 'putcat', 'putshl', 'putnr', 'out', 'addint', 'adddouble', 'vanish', 'misc'.
"allmanage" 縮寫，包括'sync', 'optimize', 'copy', 'restore', 'setmst'.
"repl" 作為master復(fù)制
"slave" 作為slave復(fù)制
2) ttservctl
'ttservctl'命令是服務(wù)器的啟動腳本。可以被操作系統(tǒng)的啟動程序的RC腳本調(diào)用。這個命令的使用格式如下：
1. ttservctl start
啟動服務(wù)器
2. ttservctl stop
停止服務(wù)器
3. ttservctl restart
重啟服務(wù)器
4. ttservctl hup
為日志輪換發(fā)送HUP信號到服務(wù)器
數(shù)據(jù)庫放置于"/var/ttserver/casket.tch"。日志和相關(guān)文件放置于"/var/ttserver"。這個命令成功時返回0，失敗時返回其他。
3) ttulmgr
'ttulmgr'命令是導(dǎo)入導(dǎo)出更新日志的工具。對于通過使用文本工具如grep和sed來過濾日志文件非常有用。這個命令的使用格式如下。'upath'指定更新日志目錄。
1. ttulmgr export [-ts num] [-sid num] upath
導(dǎo)出更新日志為TSV文本數(shù)據(jù)到標(biāo)準(zhǔn)輸出
2. ttulmgr import upath
從標(biāo)準(zhǔn)輸入中導(dǎo)入TSV文本數(shù)據(jù)到更新日志
選項如下
-ts num : 指定開始的時間戳
-sid num : 指定自己的服務(wù)器ID
這個命令成功時返回0，失敗時返回其他。