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 https://opensource.org/licenses/CDDL-1.0.
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]
22 * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
27 * Copyright 2016 Igor Kozhukhov <ikozhukhov@gmail.com>.
36 #include <thread_pool.h>
40 #include <sys/zfs_context.h>
43 #include "zpool_util.h"
46 * Private interface for iterating over pools specified on the command line.
47 * Most consumers will call for_each_pool, but in order to support iostat, we
48 * allow fined grained control through the zpool_list_t interface.
51 typedef struct zpool_node
{
52 zpool_handle_t
*zn_handle
;
53 uu_avl_node_t zn_avlnode
;
61 uu_avl_pool_t
*zl_pool
;
62 zprop_list_t
**zl_proplist
;
67 zpool_compare(const void *larg
, const void *rarg
, void *unused
)
70 zpool_handle_t
*l
= ((zpool_node_t
*)larg
)->zn_handle
;
71 zpool_handle_t
*r
= ((zpool_node_t
*)rarg
)->zn_handle
;
72 const char *lname
= zpool_get_name(l
);
73 const char *rname
= zpool_get_name(r
);
75 return (strcmp(lname
, rname
));
79 * Callback function for pool_list_get(). Adds the given pool to the AVL tree
83 add_pool(zpool_handle_t
*zhp
, void *data
)
85 zpool_list_t
*zlp
= data
;
86 zpool_node_t
*node
= safe_malloc(sizeof (zpool_node_t
));
89 node
->zn_handle
= zhp
;
90 uu_avl_node_init(node
, &node
->zn_avlnode
, zlp
->zl_pool
);
91 if (uu_avl_find(zlp
->zl_avl
, node
, NULL
, &idx
) == NULL
) {
92 if (zlp
->zl_proplist
&&
93 zpool_expand_proplist(zhp
, zlp
->zl_proplist
,
94 zlp
->zl_type
, zlp
->zl_literal
) != 0) {
99 uu_avl_insert(zlp
->zl_avl
, node
, idx
);
110 * Create a list of pools based on the given arguments. If we're given no
111 * arguments, then iterate over all pools in the system and add them to the AVL
112 * tree. Otherwise, add only those pool explicitly specified on the command
116 pool_list_get(int argc
, char **argv
, zprop_list_t
**proplist
, zfs_type_t type
,
117 boolean_t literal
, int *err
)
121 zlp
= safe_malloc(sizeof (zpool_list_t
));
123 zlp
->zl_pool
= uu_avl_pool_create("zfs_pool", sizeof (zpool_node_t
),
124 offsetof(zpool_node_t
, zn_avlnode
), zpool_compare
, UU_DEFAULT
);
126 if (zlp
->zl_pool
== NULL
)
129 if ((zlp
->zl_avl
= uu_avl_create(zlp
->zl_pool
, NULL
,
130 UU_DEFAULT
)) == NULL
)
133 zlp
->zl_proplist
= proplist
;
136 zlp
->zl_literal
= literal
;
139 (void) zpool_iter(g_zfs
, add_pool
, zlp
);
140 zlp
->zl_findall
= B_TRUE
;
144 for (i
= 0; i
< argc
; i
++) {
147 if ((zhp
= zpool_open_canfail(g_zfs
, argv
[i
])) !=
149 if (add_pool(zhp
, zlp
) != 0)
161 * Search for any new pools, adding them to the list. We only add pools when no
162 * options were given on the command line. Otherwise, we keep the list fixed as
163 * those that were explicitly specified.
166 pool_list_update(zpool_list_t
*zlp
)
169 (void) zpool_iter(g_zfs
, add_pool
, zlp
);
173 * Iterate over all pools in the list, executing the callback for each
176 pool_list_iter(zpool_list_t
*zlp
, int unavail
, zpool_iter_f func
,
179 zpool_node_t
*node
, *next_node
;
182 for (node
= uu_avl_first(zlp
->zl_avl
); node
!= NULL
; node
= next_node
) {
183 next_node
= uu_avl_next(zlp
->zl_avl
, node
);
184 if (zpool_get_state(node
->zn_handle
) != POOL_STATE_UNAVAIL
||
186 ret
|= func(node
->zn_handle
, data
);
193 * Remove the given pool from the list. When running iostat, we want to remove
194 * those pools that no longer exist.
197 pool_list_remove(zpool_list_t
*zlp
, zpool_handle_t
*zhp
)
199 zpool_node_t search
, *node
;
201 search
.zn_handle
= zhp
;
202 if ((node
= uu_avl_find(zlp
->zl_avl
, &search
, NULL
, NULL
)) != NULL
) {
203 uu_avl_remove(zlp
->zl_avl
, node
);
204 zpool_close(node
->zn_handle
);
210 * Free all the handles associated with this list.
213 pool_list_free(zpool_list_t
*zlp
)
218 if ((walk
= uu_avl_walk_start(zlp
->zl_avl
, UU_WALK_ROBUST
)) == NULL
) {
219 (void) fprintf(stderr
,
220 gettext("internal error: out of memory"));
224 while ((node
= uu_avl_walk_next(walk
)) != NULL
) {
225 uu_avl_remove(zlp
->zl_avl
, node
);
226 zpool_close(node
->zn_handle
);
230 uu_avl_walk_end(walk
);
231 uu_avl_destroy(zlp
->zl_avl
);
232 uu_avl_pool_destroy(zlp
->zl_pool
);
238 * Returns the number of elements in the pool list.
241 pool_list_count(zpool_list_t
*zlp
)
243 return (uu_avl_numnodes(zlp
->zl_avl
));
247 * High level function which iterates over all pools given on the command line,
248 * using the pool_list_* interfaces.
251 for_each_pool(int argc
, char **argv
, boolean_t unavail
,
252 zprop_list_t
**proplist
, zfs_type_t type
, boolean_t literal
,
253 zpool_iter_f func
, void *data
)
258 if ((list
= pool_list_get(argc
, argv
, proplist
, type
, literal
,
262 if (pool_list_iter(list
, unavail
, func
, data
) != 0)
265 pool_list_free(list
);
271 * This is the equivalent of for_each_pool() for vdevs. It iterates thorough
272 * all vdevs in the pool, ignoring root vdevs and holes, calling func() on
276 * @func: Function to call on each vdev
277 * @data: Custom data to pass to the function
280 for_each_vdev(zpool_handle_t
*zhp
, pool_vdev_iter_f func
, void *data
)
282 nvlist_t
*config
, *nvroot
= NULL
;
284 if ((config
= zpool_get_config(zhp
, NULL
)) != NULL
) {
285 verify(nvlist_lookup_nvlist(config
, ZPOOL_CONFIG_VDEV_TREE
,
288 return (for_each_vdev_cb((void *) zhp
, nvroot
, func
, data
));
292 * Process the vcdl->vdev_cmd_data[] array to figure out all the unique column
293 * names and their widths. When this function is done, vcdl->uniq_cols,
294 * vcdl->uniq_cols_cnt, and vcdl->uniq_cols_width will be filled in.
297 process_unique_cmd_columns(vdev_cmd_data_list_t
*vcdl
)
299 char **uniq_cols
= NULL
, **tmp
= NULL
;
300 int *uniq_cols_width
;
301 vdev_cmd_data_t
*data
;
306 for (int i
= 0; i
< vcdl
->count
; i
++) {
307 data
= &vcdl
->data
[i
];
308 /* For each column the vdev reported */
309 for (int j
= 0; j
< data
->cols_cnt
; j
++) {
310 /* Is this column in our list of unique column names? */
311 for (k
= 0; k
< cnt
; k
++) {
312 if (strcmp(data
->cols
[j
], uniq_cols
[k
]) == 0)
313 break; /* yes it is */
316 /* No entry for column, add to list */
317 tmp
= realloc(uniq_cols
, sizeof (*uniq_cols
) *
320 break; /* Nothing we can do... */
322 uniq_cols
[cnt
] = data
->cols
[j
];
329 * We now have a list of all the unique column names. Figure out the
330 * max width of each column by looking at the column name and all its
333 uniq_cols_width
= safe_malloc(sizeof (*uniq_cols_width
) * cnt
);
334 for (int i
= 0; i
< cnt
; i
++) {
335 /* Start off with the column title's width */
336 uniq_cols_width
[i
] = strlen(uniq_cols
[i
]);
338 for (int j
= 0; j
< vcdl
->count
; j
++) {
339 /* For each of the vdev's values in a column */
340 data
= &vcdl
->data
[j
];
341 for (k
= 0; k
< data
->cols_cnt
; k
++) {
342 /* Does this vdev have a value for this col? */
343 if (strcmp(data
->cols
[k
], uniq_cols
[i
]) == 0) {
344 /* Is the value width larger? */
346 MAX(uniq_cols_width
[i
],
347 strlen(data
->lines
[k
]));
353 vcdl
->uniq_cols
= uniq_cols
;
354 vcdl
->uniq_cols_cnt
= cnt
;
355 vcdl
->uniq_cols_width
= uniq_cols_width
;
360 * Process a line of command output
362 * When running 'zpool iostat|status -c' the lines of output can either be
371 * Process the column_name (if any) and value.
373 * Returns 0 if line was processed, and there are more lines can still be
376 * Returns 1 if this was the last line to process, or error.
379 vdev_process_cmd_output(vdev_cmd_data_t
*data
, char *line
)
389 equals
= strchr(line
, '=');
390 if (equals
!= NULL
) {
392 * We have a 'column=value' type line. Split it into the
393 * column and value strings by turning the '=' into a '\0'.
402 /* Do we already have a column by this name? If so, skip it. */
404 for (int i
= 0; i
< data
->cols_cnt
; i
++) {
405 if (strcmp(col
, data
->cols
[i
]) == 0)
406 return (0); /* Duplicate, skip */
411 tmp
= realloc(data
->lines
,
412 (data
->lines_cnt
+ 1) * sizeof (*data
->lines
));
417 data
->lines
[data
->lines_cnt
] = strdup(val
);
422 tmp
= realloc(data
->cols
,
423 (data
->cols_cnt
+ 1) * sizeof (*data
->cols
));
428 data
->cols
[data
->cols_cnt
] = strdup(col
);
432 if (val
!= NULL
&& col
== NULL
)
439 * Run the cmd and store results in *data.
442 vdev_run_cmd(vdev_cmd_data_t
*data
, char *cmd
)
445 char *argv
[2] = {cmd
};
446 char *env
[5] = {(char *)"PATH=/bin:/sbin:/usr/bin:/usr/sbin"};
451 /* Setup our custom environment variables */
452 rc
= asprintf(&env
[1], "VDEV_PATH=%s",
453 data
->path
? data
->path
: "");
459 rc
= asprintf(&env
[2], "VDEV_UPATH=%s",
460 data
->upath
? data
->upath
: "");
466 rc
= asprintf(&env
[3], "VDEV_ENC_SYSFS_PATH=%s",
467 data
->vdev_enc_sysfs_path
?
468 data
->vdev_enc_sysfs_path
: "");
474 /* Run the command */
475 rc
= libzfs_run_process_get_stdout_nopath(cmd
, argv
, env
, &lines
,
480 /* Process the output we got */
481 for (i
= 0; i
< lines_cnt
; i
++)
482 if (vdev_process_cmd_output(data
, lines
[i
]) != 0)
487 libzfs_free_str_array(lines
, lines_cnt
);
489 /* Start with i = 1 since env[0] was statically allocated */
490 for (i
= 1; i
< ARRAY_SIZE(env
); i
++)
495 * Generate the search path for zpool iostat/status -c scripts.
496 * The string returned must be freed.
499 zpool_get_cmd_search_path(void)
504 env
= getenv("ZPOOL_SCRIPTS_PATH");
506 return (strdup(env
));
508 env
= getenv("HOME");
510 if (asprintf(&sp
, "%s/.zpool.d:%s",
511 env
, ZPOOL_SCRIPTS_DIR
) != -1) {
516 if (asprintf(&sp
, "%s", ZPOOL_SCRIPTS_DIR
) != -1)
522 /* Thread function run for each vdev */
524 vdev_run_cmd_thread(void *cb_cmd_data
)
526 vdev_cmd_data_t
*data
= cb_cmd_data
;
527 char *cmd
= NULL
, *cmddup
, *cmdrest
;
529 cmddup
= strdup(data
->cmd
);
534 while ((cmd
= strtok_r(cmdrest
, ",", &cmdrest
))) {
535 char *dir
= NULL
, *sp
, *sprest
;
536 char fullpath
[MAXPATHLEN
];
538 if (strchr(cmd
, '/') != NULL
)
541 sp
= zpool_get_cmd_search_path();
546 while ((dir
= strtok_r(sprest
, ":", &sprest
))) {
547 if (snprintf(fullpath
, sizeof (fullpath
),
548 "%s/%s", dir
, cmd
) == -1)
551 if (access(fullpath
, X_OK
) == 0) {
552 vdev_run_cmd(data
, fullpath
);
561 /* For each vdev in the pool run a command */
563 for_each_vdev_run_cb(void *zhp_data
, nvlist_t
*nv
, void *cb_vcdl
)
565 vdev_cmd_data_list_t
*vcdl
= cb_vcdl
;
566 vdev_cmd_data_t
*data
;
567 const char *path
= NULL
;
569 const char *vdev_enc_sysfs_path
= NULL
;
571 zpool_handle_t
*zhp
= zhp_data
;
573 if (nvlist_lookup_string(nv
, ZPOOL_CONFIG_PATH
, &path
) != 0)
576 nvlist_lookup_string(nv
, ZPOOL_CONFIG_VDEV_ENC_SYSFS_PATH
,
577 &vdev_enc_sysfs_path
);
579 /* Spares show more than once if they're in use, so skip if exists */
580 for (i
= 0; i
< vcdl
->count
; i
++) {
581 if ((strcmp(vcdl
->data
[i
].path
, path
) == 0) &&
582 (strcmp(vcdl
->data
[i
].pool
, zpool_get_name(zhp
)) == 0)) {
583 /* vdev already exists, skip it */
588 /* Check for selected vdevs here, if any */
589 for (i
= 0; i
< vcdl
->vdev_names_count
; i
++) {
590 vname
= zpool_vdev_name(g_zfs
, zhp
, nv
, vcdl
->cb_name_flags
);
591 if (strcmp(vcdl
->vdev_names
[i
], vname
) == 0) {
599 /* If we selected vdevs, and this isn't one of them, then bail out */
600 if (!match
&& vcdl
->vdev_names_count
)
604 * Resize our array and add in the new element.
606 if (!(vcdl
->data
= realloc(vcdl
->data
,
607 sizeof (*vcdl
->data
) * (vcdl
->count
+ 1))))
608 return (ENOMEM
); /* couldn't realloc */
610 data
= &vcdl
->data
[vcdl
->count
];
612 data
->pool
= strdup(zpool_get_name(zhp
));
613 data
->path
= strdup(path
);
614 data
->upath
= zfs_get_underlying_path(path
);
615 data
->cmd
= vcdl
->cmd
;
616 data
->lines
= data
->cols
= NULL
;
617 data
->lines_cnt
= data
->cols_cnt
= 0;
618 if (vdev_enc_sysfs_path
)
619 data
->vdev_enc_sysfs_path
= strdup(vdev_enc_sysfs_path
);
621 data
->vdev_enc_sysfs_path
= NULL
;
628 /* Get the names and count of the vdevs */
630 all_pools_for_each_vdev_gather_cb(zpool_handle_t
*zhp
, void *cb_vcdl
)
632 return (for_each_vdev(zhp
, for_each_vdev_run_cb
, cb_vcdl
));
636 * Now that vcdl is populated with our complete list of vdevs, spawn
640 all_pools_for_each_vdev_run_vcdl(vdev_cmd_data_list_t
*vcdl
)
644 t
= tpool_create(1, 5 * sysconf(_SC_NPROCESSORS_ONLN
), 0, NULL
);
648 /* Spawn off the command for each vdev */
649 for (int i
= 0; i
< vcdl
->count
; i
++) {
650 (void) tpool_dispatch(t
, vdev_run_cmd_thread
,
651 (void *) &vcdl
->data
[i
]);
654 /* Wait for threads to finish */
660 * Run command 'cmd' on all vdevs in all pools in argv. Saves the first line of
661 * output from the command in vcdk->data[].line for all vdevs. If you want
662 * to run the command on only certain vdevs, fill in g_zfs, vdev_names,
663 * vdev_names_count, and cb_name_flags. Otherwise leave them as zero.
665 * Returns a vdev_cmd_data_list_t that must be freed with
666 * free_vdev_cmd_data_list();
668 vdev_cmd_data_list_t
*
669 all_pools_for_each_vdev_run(int argc
, char **argv
, char *cmd
,
670 libzfs_handle_t
*g_zfs
, char **vdev_names
, int vdev_names_count
,
673 vdev_cmd_data_list_t
*vcdl
;
674 vcdl
= safe_malloc(sizeof (vdev_cmd_data_list_t
));
677 vcdl
->vdev_names
= vdev_names
;
678 vcdl
->vdev_names_count
= vdev_names_count
;
679 vcdl
->cb_name_flags
= cb_name_flags
;
682 /* Gather our list of all vdevs in all pools */
683 for_each_pool(argc
, argv
, B_TRUE
, NULL
, ZFS_TYPE_POOL
,
684 B_FALSE
, all_pools_for_each_vdev_gather_cb
, vcdl
);
686 /* Run command on all vdevs in all pools */
687 all_pools_for_each_vdev_run_vcdl(vcdl
);
690 * vcdl->data[] now contains all the column names and values for each
691 * vdev. We need to process that into a master list of unique column
692 * names, and figure out the width of each column.
694 process_unique_cmd_columns(vcdl
);
700 * Free the vdev_cmd_data_list_t created by all_pools_for_each_vdev_run()
703 free_vdev_cmd_data_list(vdev_cmd_data_list_t
*vcdl
)
705 free(vcdl
->uniq_cols
);
706 free(vcdl
->uniq_cols_width
);
708 for (int i
= 0; i
< vcdl
->count
; i
++) {
709 free(vcdl
->data
[i
].path
);
710 free(vcdl
->data
[i
].pool
);
711 free(vcdl
->data
[i
].upath
);
713 for (int j
= 0; j
< vcdl
->data
[i
].lines_cnt
; j
++)
714 free(vcdl
->data
[i
].lines
[j
]);
716 free(vcdl
->data
[i
].lines
);
718 for (int j
= 0; j
< vcdl
->data
[i
].cols_cnt
; j
++)
719 free(vcdl
->data
[i
].cols
[j
]);
721 free(vcdl
->data
[i
].cols
);
722 free(vcdl
->data
[i
].vdev_enc_sysfs_path
);