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.16
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: std, mmap-para,
44              mmap-atom, 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       --block_size num : The block size of the positional access  file.  (de‐
55              fault: 1)
56
57       --direct_io  :  Enables  the direct I/O option of the positional access
58              file.
59
60       --sync_io : Enables the synchronous I/O option of the positional access
61              file.
62
63   Options for the sequence subcommand:
64       --random_key : Uses random keys rather than sequential ones.
65
66       --random_value : Uses random length values rather than fixed ones.
67
68       --set_only : Does only setting.
69
70       --get_only : Does only getting.
71
72       --remove_only : Does only removing.
73
74   Options for the parallel subcommand:
75       --random_key : Uses random keys rather than sequential ones.
76
77       --random_value : Uses random length values rather than fixed ones.
78
79       --keys : The number of unique keys.
80
81       --rebuild : Rebuilds the database occasionally.
82
83       --sleep num : The duration to sleep between iterations. (default: 0)
84
85   Options for the wicked subcommand:
86       --iterator : Uses iterators occasionally.
87
88       --clear : Clears the database occasionally.
89
90       --rebuild : Rebuilds the database occasionally.
91
92   Options for the index subcommand:
93       --type  expr  : The types of the key and value of the index: file, mem,
94              n2n, n2s, s2n, s2s, str, file. (default: file)
95
96       --random_key : Uses random keys rather than sequential ones.
97
98       --random_value : Uses random length values rather than fixed ones.
99
100   Options for HashDBM:
101       --append : Uses the appending mode rather than the in-place mode.
102
103       --offset_width num : The width to represent the offset of records. (de‐
104              fault: 4)
105
106       --align_pow num : Sets the power to align records. (default: 3)
107
108       --buckets  num  :  Sets  the  number  of buckets for hashing. (default:
109              1048583)
110
111       --fbp_cap num : Sets the capacity of the  free  block  pool.  (default:
112              2048)
113
114       --lock_mem_buckets : Locks the memory for the hash buckets.
115
116       --cache_buckets : Caches the hash buckets on memory.
117
118   Options for TreeDBM and FileIndex:
119       --append : Uses the appending mode rather than the in-place mode.
120
121       --offset_width num : The width to represent the offset of records. (de‐
122              fault: 4)
123
124       --align_pow num : Sets the power to align records. (default: 10)
125
126       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
127              131101)
128
129       --fbp_cap  num  :  Sets  the capacity of the free block pool. (default:
130              2048)
131
132       --lock_mem_buckets : Locks the memory for the hash buckets.
133
134       --cache_buckets : Caches the hash buckets on memory.
135
136       --max_page_size num : Sets the maximum size of a page. (default: 8130)
137
138       --max_branches num : Sets the  maximum  number  of  branches  of  inner
139              nodes. (default: 256)
140
141       --max_chached_pages num : Sets the maximum number of cached pages. (de‐
142              fault: 10000)
143
144   Options for SkipDBM:
145       --offset_width num : The width to represent the offset of records. (de‐
146              fault: 4)
147
148       --step_unit num : Sets the step unit of the skip list. (default: 4)
149
150       --max_level  num  :  Sets the maximum level of the skip list. (default:
151              14)
152
153       --sort_mem_size num : Sets the memory size used for sorting.  (default:
154              268435456)
155
156       --insert_in_order  :  Inserts  records  in ascending order order of the
157              key.
158
159       --max_cached_records num : Sets the number of cached records  (default:
160              65536)
161
162       --reducer  func  : Sets the reducer: none, first, second, last, concat,
163              total. (default: none)
164
165   Options for TinyDBM and StdHashDBM:
166       --buckets num : Sets the  number  of  buckets  for  hashing.  (default:
167              1048583)
168
169   Options for CacheDBM:
170       --cap_rec_num  num  :  Sets  the  maximum  number of records. (default:
171              1048576)
172
173       --cap_memsize num : Sets the total memory size to use.
174
175   Options for PolyDBM and ShardDBM:
176       --params str : Sets the parameters in "key=value,key=value" format.
177
178
179
180tkrzw_dbm_perf 0.9.16              May 2021                  TKRZW_DBM_PERF(1)