4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
23 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
32 * Return B_TRUE if "str" is a number string, B_FALSE otherwise.
33 * Works for integer and floating point numbers.
36 zfs_isnumber(const char *str)
39 if (!(isdigit(*str) || (*str == '.')))
46 * Convert a number to an appropriately human-readable output.
49 zfs_nicenum_format(uint64_t num, char *buf, size_t buflen,
50 enum zfs_nicenum_format format)
55 const char *units[3][7] = {
56 [ZFS_NICENUM_1024] = {"", "K", "M", "G", "T", "P", "E"},
57 [ZFS_NICENUM_BYTES] = {"B", "K", "M", "G", "T", "P", "E"},
58 [ZFS_NICENUM_TIME] = {"ns", "us", "ms", "s", "?", "?", "?"}
61 const int units_len[] = {[ZFS_NICENUM_1024] = 6,
62 [ZFS_NICENUM_BYTES] = 6,
63 [ZFS_NICENUM_TIME] = 4};
65 const int k_unit[] = { [ZFS_NICENUM_1024] = 1024,
66 [ZFS_NICENUM_BYTES] = 1024,
67 [ZFS_NICENUM_TIME] = 1000};
71 if (format == ZFS_NICENUM_RAW) {
72 snprintf(buf, buflen, "%llu", (u_longlong_t)num);
74 } else if (format == ZFS_NICENUM_RAWTIME && num > 0) {
75 snprintf(buf, buflen, "%llu", (u_longlong_t)num);
77 } else if (format == ZFS_NICENUM_RAWTIME && num == 0) {
78 snprintf(buf, buflen, "%s", "-");
82 while (n >= k_unit[format] && index < units_len[format]) {
87 u = units[format][index];
89 /* Don't print zero latencies since they're invalid */
90 if ((format == ZFS_NICENUM_TIME) && (num == 0)) {
91 (void) snprintf(buf, buflen, "-");
92 } else if ((index == 0) || ((num %
93 (uint64_t)powl(k_unit[format], index)) == 0)) {
95 * If this is an even multiple of the base, always display
96 * without any decimal precision.
98 (void) snprintf(buf, buflen, "%llu%s", (u_longlong_t)n, u);
102 * We want to choose a precision that reflects the best choice
103 * for fitting in 5 characters. This can get rather tricky when
104 * we have numbers that are very close to an order of magnitude.
105 * For example, when displaying 10239 (which is really 9.999K),
106 * we want only a single place of precision for 10.0K. We could
107 * develop some complex heuristics for this, but it's much
108 * easier just to try each combination in turn.
111 for (i = 2; i >= 0; i--) {
113 (uint64_t)powl(k_unit[format], index);
116 * Don't print floating point values for time. Note,
117 * we use floor() instead of round() here, since
118 * round can result in undesirable results. For
119 * example, if "num" is in the range of
120 * 999500-999999, it will print out "1000us". This
121 * doesn't happen if we use floor().
123 if (format == ZFS_NICENUM_TIME) {
124 if (snprintf(buf, buflen, "%d%s",
125 (unsigned int) floor(val), u) <= 5)
129 if (snprintf(buf, buflen, "%.*f%s", i,
138 * Convert a number to an appropriately human-readable output.
141 zfs_nicenum(uint64_t num, char *buf, size_t buflen)
143 zfs_nicenum_format(num, buf, buflen, ZFS_NICENUM_1024);
147 * Convert a time to an appropriately human-readable output.
148 * @num: Time in nanoseconds
151 zfs_nicetime(uint64_t num, char *buf, size_t buflen)
153 zfs_nicenum_format(num, buf, buflen, ZFS_NICENUM_TIME);
157 * Print out a raw number with correct column spacing
160 zfs_niceraw(uint64_t num, char *buf, size_t buflen)
162 zfs_nicenum_format(num, buf, buflen, ZFS_NICENUM_RAW);
166 * Convert a number of bytes to an appropriately human-readable output.
169 zfs_nicebytes(uint64_t num, char *buf, size_t buflen)
171 zfs_nicenum_format(num, buf, buflen, ZFS_NICENUM_BYTES);