1TKRZW_DBM_PERF(1)                User Commands               TKRZW_DBM_PERF(1)
2
3
4

NAME

6       tkrzw_dbm_perf - manual page for tkrzw_dbm_perf 0.9.3
7

DESCRIPTION

9       tkrzw_dbm_perf: Performance checker of DBM implementations of Tkrzw
10
11   Usage:
12              tkrzw_dbm_perf sequence [options]
13
14              : Checks setting/getting/removing performance in sequence.
15
16              tkrzw_dbm_perf parallel [options]
17
18              : Checks setting/getting/removing performance in parallel.
19
20              tkrzw_dbm_perf wicked [options]
21
22              : Checks consistency with various operations.
23
24              tkrzw_dbm_perf index [options]
25
26              : Checks performance of on-memory indexing.
27
28   Common options:
29       --dbm  impl : The name of a DBM implementation: auto, hash, tree, skip,
30              tiny, baby, cache,  stdhash,  stdtree,  poly,  shard.  (default:
31              auto)
32
33       --iter num : The number of iterations. (default: 10000)
34
35       --size num : The size of each record value. (default: 8)
36
37       --threads num : The number of threads. (default: 1)
38
39       --verbose : Prints verbose reports.
40
41       --path path : The path of the file to write or read.
42
43       --file  impl : The name of a file implementation: mmap-para, mmap-atom,
44              pos-para, pos-atom. (default: mmap-para)
45
46       --no_wait : Fails if the file is locked by another process.
47
48       --no_lock : Omits file locking.
49
50       --alloc_init num : The initial allocation size. (default: 1048576)
51
52       --alloc_inc num : The allocation increment factor. (default: 2.0)
53
54   Options for the sequence subcommand:
55       --random_key : Uses random keys rather than sequential ones.
56
57       --random_value : Uses random length values rather than fixed ones.
58
59       --set_only : Does only setting.
60
61       --get_only : Does only getting.
62
63       --remove_only : Does only removing.
64
65   Options for the parallel subcommand:
66       --random_key : Uses random keys rather than sequential ones.
67
68       --random_value : Uses random length values rather than fixed ones.
69
70       --keys : The number of unique keys.
71
72       --rebuild : Rebuilds the database occasionally.
73
74       --sleep num : The duration to sleep between iterations. (default: 0)
75
76   Options for the wicked subcommand:
77       --iterator : Uses iterators occasionally.
78
79       --clear : Clears the database occasionally.
80
81       --rebuild : Rebuilds the database occasionally.
82
83   Options for the index subcommand:
84       --type expr : The types of the key and value of the index:  file,  mem,
85              n2n, n2s, s2n, s2s, str, file. (default: file)
86
87       --random_key : Uses random keys rather than sequential ones.
88
89       --random_value : Uses random length values rather than fixed ones.
90
91   Options for HashDBM:
92       --append : Uses the appending mode rather than the in-place mode.
93
94       --offset_width  num  :  The  width  to represent the offset of records.
95              (default: 4)
96
97       --align_pow num : Sets the power to align records. (default: 3)
98
99       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
100              1048583)
101
102       --fbp_cap  num  :  Sets  the capacity of the free block pool. (default:
103              2048)
104
105       --lock_mem_buckets : Locks the memory for the hash buckets.
106
107   Options for TreeDBM and FileIndex:
108       --append : Uses the appending mode rather than the in-place mode.
109
110       --offset_width num : The width to  represent  the  offset  of  records.
111              (default: 4)
112
113       --align_pow num : Sets the power to align records. (default: 10)
114
115       --buckets  num  :  Sets  the  number  of buckets for hashing. (default:
116              131101)
117
118       --fbp_cap num : Sets the capacity of the  free  block  pool.  (default:
119              2048)
120
121       --lock_mem_buckets : Locks the memory for the hash buckets.
122
123       --max_page_size num : Sets the maximum size of a page. (default: 8130)
124
125       --max_branches  num  :  Sets  the  maximum  number of branches of inner
126              nodes. (default: 256)
127
128       --max_chached_pages num : Sets the  maximum  number  of  cached  pages.
129              (default: 10000)
130
131   Options for SkipDBM:
132       --offset_width  num  :  The  width  to represent the offset of records.
133              (default: 4)
134
135       --step_unit num : Sets the step unit of the skip list. (default: 4)
136
137       --max_level num : Sets the maximum level of the  skip  list.  (default:
138              14)
139
140       --sort_mem_size  num : Sets the memory size used for sorting. (default:
141              268435456)
142
143       --insert_in_order : Inserts records in ascending  order  order  of  the
144              key.
145
146       --max_cached_records  num : Sets the number of cached records (default:
147              65536)
148
149       --reducer func : Sets the reducer: none, first, second,  last,  concat,
150              total. (default: none)
151
152   Options for TinyDBM and StdHashDBM:
153       --buckets  num  :  Sets  the  number  of buckets for hashing. (default:
154              1048583)
155
156   Options for CacheDBM:
157       --cap_rec_num num : Sets  the  maximum  number  of  records.  (default:
158              1048576)
159
160       --cap_memsize num : Sets the total memory size to use.
161
162   Options for PolyDBM and ShardDBM:
163       --params str : Sets the parameters in "key=value,key=value" format.
164
165
166
167tkrzw_dbm_perf 0.9.3             January 2021                TKRZW_DBM_PERF(1)