2 * Copyright (c) 1997, 1998 Kenneth D. Merry.
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. The name of the author may not be used to endorse or promote products
14 * derived from this software without specific prior written permission.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 * $FreeBSD: src/lib/libdevstat/devstat.c,v 1.6 1999/08/28 00:04:26 peter Exp $
29 * $DragonFly: src/lib/libdevstat/devstat.c,v 1.5 2005/01/08 19:19:26 joerg Exp $
32 #include <sys/types.h>
33 #include <sys/sysctl.h>
34 #include <sys/errno.h>
44 char devstat_errbuf[DEVSTAT_ERRBUF_SIZE];
47 * Table to match descriptive strings with device types. These are in
48 * order from most common to least common to speed search time.
50 struct devstat_match_table match_table[] = {
51 {"da", DEVSTAT_TYPE_DIRECT, DEVSTAT_MATCH_TYPE},
52 {"cd", DEVSTAT_TYPE_CDROM, DEVSTAT_MATCH_TYPE},
53 {"scsi", DEVSTAT_TYPE_IF_SCSI, DEVSTAT_MATCH_IF},
54 {"ide", DEVSTAT_TYPE_IF_IDE, DEVSTAT_MATCH_IF},
55 {"other", DEVSTAT_TYPE_IF_OTHER, DEVSTAT_MATCH_IF},
56 {"worm", DEVSTAT_TYPE_WORM, DEVSTAT_MATCH_TYPE},
57 {"sa", DEVSTAT_TYPE_SEQUENTIAL,DEVSTAT_MATCH_TYPE},
58 {"pass", DEVSTAT_TYPE_PASS, DEVSTAT_MATCH_PASS},
59 {"optical", DEVSTAT_TYPE_OPTICAL, DEVSTAT_MATCH_TYPE},
60 {"array", DEVSTAT_TYPE_STORARRAY, DEVSTAT_MATCH_TYPE},
61 {"changer", DEVSTAT_TYPE_CHANGER, DEVSTAT_MATCH_TYPE},
62 {"scanner", DEVSTAT_TYPE_SCANNER, DEVSTAT_MATCH_TYPE},
63 {"printer", DEVSTAT_TYPE_PRINTER, DEVSTAT_MATCH_TYPE},
64 {"floppy", DEVSTAT_TYPE_FLOPPY, DEVSTAT_MATCH_TYPE},
65 {"proc", DEVSTAT_TYPE_PROCESSOR, DEVSTAT_MATCH_TYPE},
66 {"comm", DEVSTAT_TYPE_COMM, DEVSTAT_MATCH_TYPE},
67 {"enclosure", DEVSTAT_TYPE_ENCLOSURE, DEVSTAT_MATCH_TYPE},
72 * Local function declarations.
74 static int compare_select(const void *arg1, const void *arg2);
81 const char *func_name = "getnumdevs";
83 numdevsize = sizeof(int);
86 * Find out how many devices we have in the system.
88 if (sysctlbyname("kern.devstat.numdevs", &numdevs,
89 &numdevsize, NULL, 0) == -1) {
90 sprintf(devstat_errbuf, "%s: error getting number of devices\n"
91 "%s: %s", func_name, func_name, strerror(errno));
98 * This is an easy way to get the generation number, but the generation is
99 * supplied in a more atmoic manner by the kern.devstat.all sysctl.
100 * Because this generation sysctl is separate from the statistics sysctl,
101 * the device list and the generation could change between the time that
102 * this function is called and the device list is retreived.
109 const char *func_name = "getgeneration";
111 gensize = sizeof(long);
114 * Get the current generation number.
116 if (sysctlbyname("kern.devstat.generation", &generation,
117 &gensize, NULL, 0) == -1) {
118 sprintf(devstat_errbuf,"%s: error getting devstat generation\n"
119 "%s: %s", func_name, func_name, strerror(errno));
126 * Get the current devstat version. The return value of this function
127 * should be compared with DEVSTAT_VERSION, which is defined in
128 * sys/devicestat.h. This will enable userland programs to determine
129 * whether they are out of sync with the kernel.
136 const char *func_name = "getversion";
138 versize = sizeof(int);
141 * Get the current devstat version.
143 if (sysctlbyname("kern.devstat.version", &version, &versize,
145 sprintf(devstat_errbuf, "%s: error getting devstat version\n"
146 "%s: %s", func_name, func_name, strerror(errno));
153 * Check the devstat version we know about against the devstat version the
154 * kernel knows about. If they don't match, print an error into the
155 * devstat error buffer, and return -1. If they match, return 0.
162 const char *func_name = "checkversion";
165 version = getversion();
167 if (version != DEVSTAT_VERSION) {
172 * This is really pretty silly, but basically the idea is
173 * that if getversion() returns an error (i.e. -1), then it
174 * has printed an error message in the buffer. Therefore,
175 * we need to add a \n to the end of that message before we
176 * print our own message in the buffer.
179 buflen = strlen(devstat_errbuf);
180 errlen = snprintf(tmpstr, sizeof(tmpstr), "\n");
181 strncat(devstat_errbuf, tmpstr,
182 DEVSTAT_ERRBUF_SIZE - buflen - 1);
186 errlen = snprintf(tmpstr, sizeof(tmpstr),
187 "%s: userland devstat version %d is not "
188 "the same as the kernel\n%s: devstat "
189 "version %d\n", func_name, DEVSTAT_VERSION,
193 strncat(devstat_errbuf, tmpstr,
194 DEVSTAT_ERRBUF_SIZE - buflen - 1);
197 strncpy(devstat_errbuf, tmpstr, DEVSTAT_ERRBUF_SIZE);
198 devstat_errbuf[DEVSTAT_ERRBUF_SIZE - 1] = '\0';
201 if (version < DEVSTAT_VERSION)
202 snprintf(tmpstr, sizeof(tmpstr),
203 "%s: libdevstat newer than kernel\n",
206 snprintf(tmpstr, sizeof(tmpstr),
207 "%s: kernel newer than libdevstat\n",
210 strncat(devstat_errbuf, tmpstr,
211 DEVSTAT_ERRBUF_SIZE - buflen - 1);
220 * Get the current list of devices and statistics, and the current
225 * 0 -- device list is unchanged
226 * 1 -- device list has changed
229 getdevs(struct statinfo *stats)
235 struct devinfo *dinfo;
236 const char *func_name = "getdevs";
238 dinfo = stats->dinfo;
241 sprintf(devstat_errbuf, "%s: stats->dinfo was NULL", func_name);
245 oldgeneration = dinfo->generation;
248 * If this is our first time through, mem_ptr will be null.
250 if (dinfo->mem_ptr == NULL) {
252 * Get the number of devices. If it's negative, it's an
253 * error. Don't bother setting the error string, since
254 * getnumdevs() has already done that for us.
256 if ((dinfo->numdevs = getnumdevs()) < 0)
260 * The kern.devstat.all sysctl returns the current generation
261 * number, as well as all the devices. So we need four
264 dssize =(dinfo->numdevs * sizeof(struct devstat)) +sizeof(long);
265 dinfo->mem_ptr = (u_int8_t *)malloc(dssize);
267 dssize =(dinfo->numdevs * sizeof(struct devstat)) +sizeof(long);
269 /* Get the current time when we get the stats */
270 gettimeofday(&stats->busy_time, NULL);
273 * Request all of the devices. We only really allow for one
274 * ENOMEM failure. It would, of course, be possible to just go in
275 * a loop and keep reallocing the device structure until we don't
276 * get ENOMEM back. I'm not sure it's worth it, though. If
277 * devices are being added to the system that quickly, maybe the
278 * user can just wait until all devices are added.
280 if ((error = sysctlbyname("kern.devstat.all", dinfo->mem_ptr,
281 &dssize, NULL, 0)) == -1) {
283 * If we get ENOMEM back, that means that there are
284 * more devices now, so we need to allocate more
285 * space for the device array.
287 if (errno == ENOMEM) {
289 * No need to set the error string here, getnumdevs()
290 * will do that if it fails.
292 if ((dinfo->numdevs = getnumdevs()) < 0)
295 dssize = (dinfo->numdevs * sizeof(struct devstat)) +
297 dinfo->mem_ptr = (u_int8_t *)realloc(dinfo->mem_ptr,
299 if ((error = sysctlbyname("kern.devstat.all",
300 dinfo->mem_ptr, &dssize, NULL, 0)) == -1) {
301 sprintf(devstat_errbuf,
302 "%s: error getting device stats\n"
303 "%s: %s", func_name, func_name,
308 sprintf(devstat_errbuf,
309 "%s: error getting device stats\n"
310 "%s: %s", func_name, func_name,
317 * The sysctl spits out the generation as the first four bytes,
318 * then all of the device statistics structures.
320 dinfo->generation = *(long *)dinfo->mem_ptr;
323 * If the generation has changed, and if the current number of
324 * devices is not the same as the number of devices recorded in the
325 * devinfo structure, it is likely that the device list has shrunk.
326 * The reason that it is likely that the device list has shrunk in
327 * this case is that if the device list has grown, the sysctl above
328 * will return an ENOMEM error, and we will reset the number of
329 * devices and reallocate the device array. If the second sysctl
330 * fails, we will return an error and therefore never get to this
331 * point. If the device list has shrunk, the sysctl will not
332 * return an error since we have more space allocated than is
333 * necessary. So, in the shrinkage case, we catch it here and
334 * reallocate the array so that we don't use any more space than is
337 if (oldgeneration != dinfo->generation) {
338 if (getnumdevs() != dinfo->numdevs) {
339 if ((dinfo->numdevs = getnumdevs()) < 0)
341 dssize = (dinfo->numdevs * sizeof(struct devstat)) +
343 dinfo->mem_ptr = (u_int8_t *)realloc(dinfo->mem_ptr,
349 dinfo->devices = (struct devstat *)(dinfo->mem_ptr + sizeof(long));
357 * Devices are selected/deselected based upon the following criteria:
358 * - devices specified by the user on the command line
359 * - devices matching any device type expressions given on the command line
360 * - devices with the highest I/O, if 'top' mode is enabled
361 * - the first n unselected devices in the device list, if maxshowdevs
362 * devices haven't already been selected and if the user has not
363 * specified any devices on the command line and if we're in "add" mode.
366 * - device selection list (dev_select)
367 * - current number of devices selected (num_selected)
368 * - total number of devices in the selection list (num_selections)
369 * - devstat generation as of the last time selectdevs() was called
370 * (select_generation)
371 * - current devstat generation (current_generation)
372 * - current list of devices and statistics (devices)
373 * - number of devices in the current device list (numdevs)
374 * - compiled version of the command line device type arguments (matches)
375 * - This is optional. If the number of devices is 0, this will be ignored.
376 * - The matching code pays attention to the current selection mode. So
377 * if you pass in a matching expression, it will be evaluated based
378 * upon the selection mode that is passed in. See below for details.
379 * - number of device type matching expressions (num_matches)
380 * - Set to 0 to disable the matching code.
381 * - list of devices specified on the command line by the user (dev_selections)
382 * - number of devices selected on the command line by the user
383 * (num_dev_selections)
384 * - Our selection mode. There are four different selection modes:
385 * - add mode. (DS_SELECT_ADD) Any devices matching devices explicitly
386 * selected by the user or devices matching a pattern given by the
387 * user will be selected in addition to devices that are already
388 * selected. Additional devices will be selected, up to maxshowdevs
390 * - only mode. (DS_SELECT_ONLY) Only devices matching devices
391 * explicitly given by the user or devices matching a pattern
392 * given by the user will be selected. No other devices will be
394 * - addonly mode. (DS_SELECT_ADDONLY) This is similar to add and
395 * only. Basically, this will not de-select any devices that are
396 * current selected, as only mode would, but it will also not
397 * gratuitously select up to maxshowdevs devices as add mode would.
398 * - remove mode. (DS_SELECT_REMOVE) Any devices matching devices
399 * explicitly selected by the user or devices matching a pattern
400 * given by the user will be de-selected.
401 * - maximum number of devices we can select (maxshowdevs)
402 * - flag indicating whether or not we're in 'top' mode (perf_select)
405 * - the device selection list may be modified and passed back out
406 * - the number of devices selected and the total number of items in the
407 * device selection list may be changed
408 * - the selection generation may be changed to match the current generation
412 * 0 -- selected devices are unchanged
413 * 1 -- selected devices changed
416 selectdevs(struct device_selection **dev_select, int *num_selected,
417 int *num_selections, long *select_generation,
418 long current_generation, struct devstat *devices, int numdevs,
419 struct devstat_match *matches, int num_matches,
420 char **dev_selections, int num_dev_selections,
421 devstat_select_mode select_mode, int maxshowdevs, int perf_select)
424 int init_selections = 0, init_selected_var = 0;
425 struct device_selection *old_dev_select = NULL;
426 int old_num_selections = 0, old_num_selected;
427 int selection_number = 0;
428 int changed = 0, found = 0;
430 if ((dev_select == NULL) || (devices == NULL) || (numdevs <= 0))
434 * We always want to make sure that we have as many dev_select
435 * entries as there are devices.
438 * In this case, we haven't selected devices before.
440 if (*dev_select == NULL) {
441 *dev_select = (struct device_selection *)malloc(numdevs *
442 sizeof(struct device_selection));
443 *select_generation = current_generation;
447 * In this case, we have selected devices before, but the device
448 * list has changed since we last selected devices, so we need to
449 * either enlarge or reduce the size of the device selection list.
451 } else if (*num_selections != numdevs) {
452 *dev_select = (struct device_selection *)realloc(*dev_select,
453 numdevs * sizeof(struct device_selection));
454 *select_generation = current_generation;
457 * In this case, we've selected devices before, and the selection
458 * list is the same size as it was the last time, but the device
461 } else if (*select_generation < current_generation) {
462 *select_generation = current_generation;
467 * If we're in "only" mode, we want to clear out the selected
468 * variable since we're going to select exactly what the user wants
471 if (select_mode == DS_SELECT_ONLY)
472 init_selected_var = 1;
475 * In all cases, we want to back up the number of selected devices.
476 * It is a quick and accurate way to determine whether the selected
477 * devices have changed.
479 old_num_selected = *num_selected;
482 * We want to make a backup of the current selection list if
483 * the list of devices has changed, or if we're in performance
484 * selection mode. In both cases, we don't want to make a backup
485 * if we already know for sure that the list will be different.
486 * This is certainly the case if this is our first time through the
489 if (((init_selected_var != 0) || (init_selections != 0)
490 || (perf_select != 0)) && (changed == 0)){
491 old_dev_select = (struct device_selection *)malloc(
492 *num_selections * sizeof(struct device_selection));
493 old_num_selections = *num_selections;
494 bcopy(*dev_select, old_dev_select,
495 sizeof(struct device_selection) * *num_selections);
498 if (init_selections != 0) {
499 bzero(*dev_select, sizeof(struct device_selection) * numdevs);
501 for (i = 0; i < numdevs; i++) {
502 (*dev_select)[i].device_number =
503 devices[i].device_number;
504 strncpy((*dev_select)[i].device_name,
505 devices[i].device_name,
507 (*dev_select)[i].device_name[DEVSTAT_NAME_LEN - 1]='\0';
508 (*dev_select)[i].unit_number = devices[i].unit_number;
509 (*dev_select)[i].position = i;
511 *num_selections = numdevs;
512 } else if (init_selected_var != 0) {
513 for (i = 0; i < numdevs; i++)
514 (*dev_select)[i].selected = 0;
517 /* we haven't gotten around to selecting anything yet.. */
518 if ((select_mode == DS_SELECT_ONLY) || (init_selections != 0)
519 || (init_selected_var != 0))
523 * Look through any devices the user specified on the command line
524 * and see if they match known devices. If so, select them.
526 for (i = 0; (i < *num_selections) && (num_dev_selections > 0); i++) {
529 snprintf(tmpstr, sizeof(tmpstr), "%s%d",
530 (*dev_select)[i].device_name,
531 (*dev_select)[i].unit_number);
532 for (j = 0; j < num_dev_selections; j++) {
533 if (strcmp(tmpstr, dev_selections[j]) == 0) {
535 * Here we do different things based on the
536 * mode we're in. If we're in add or
537 * addonly mode, we only select this device
538 * if it hasn't already been selected.
539 * Otherwise, we would be unnecessarily
540 * changing the selection order and
541 * incrementing the selection count. If
542 * we're in only mode, we unconditionally
543 * select this device, since in only mode
544 * any previous selections are erased and
545 * manually specified devices are the first
546 * ones to be selected. If we're in remove
547 * mode, we de-select the specified device and
548 * decrement the selection count.
550 switch(select_mode) {
552 case DS_SELECT_ADDONLY:
553 if ((*dev_select)[i].selected)
557 (*dev_select)[i].selected =
561 case DS_SELECT_REMOVE:
562 (*dev_select)[i].selected = 0;
565 * This isn't passed back out, we
566 * just use it to keep track of
567 * how many devices we've removed.
569 num_dev_selections--;
578 * Go through the user's device type expressions and select devices
579 * accordingly. We only do this if the number of devices already
580 * selected is less than the maximum number we can show.
582 for (i = 0; (i < num_matches) && (*num_selected < maxshowdevs); i++) {
583 /* We should probably indicate some error here */
584 if ((matches[i].match_fields == DEVSTAT_MATCH_NONE)
585 || (matches[i].num_match_categories <= 0))
588 for (j = 0; j < numdevs; j++) {
589 int num_match_categories;
591 num_match_categories = matches[i].num_match_categories;
594 * Determine whether or not the current device
595 * matches the given matching expression. This if
596 * statement consists of three components:
597 * - the device type check
598 * - the device interface check
599 * - the passthrough check
600 * If a the matching test is successful, it
601 * decrements the number of matching categories,
602 * and if we've reached the last element that
603 * needed to be matched, the if statement succeeds.
606 if ((((matches[i].match_fields & DEVSTAT_MATCH_TYPE)!=0)
607 && ((devices[j].device_type & DEVSTAT_TYPE_MASK) ==
608 (matches[i].device_type & DEVSTAT_TYPE_MASK))
609 &&(((matches[i].match_fields & DEVSTAT_MATCH_PASS)!=0)
610 || (((matches[i].match_fields &
611 DEVSTAT_MATCH_PASS) == 0)
612 && ((devices[j].device_type &
613 DEVSTAT_TYPE_PASS) == 0)))
614 && (--num_match_categories == 0))
615 || (((matches[i].match_fields & DEVSTAT_MATCH_IF) != 0)
616 && ((devices[j].device_type & DEVSTAT_TYPE_IF_MASK) ==
617 (matches[i].device_type & DEVSTAT_TYPE_IF_MASK))
618 &&(((matches[i].match_fields & DEVSTAT_MATCH_PASS)!=0)
619 || (((matches[i].match_fields &
620 DEVSTAT_MATCH_PASS) == 0)
621 && ((devices[j].device_type &
622 DEVSTAT_TYPE_PASS) == 0)))
623 && (--num_match_categories == 0))
624 || (((matches[i].match_fields & DEVSTAT_MATCH_PASS)!=0)
625 && ((devices[j].device_type & DEVSTAT_TYPE_PASS) != 0)
626 && (--num_match_categories == 0))) {
629 * This is probably a non-optimal solution
630 * to the problem that the devices in the
631 * device list will not be in the same
632 * order as the devices in the selection
635 for (k = 0; k < numdevs; k++) {
636 if ((*dev_select)[k].position == j) {
643 * There shouldn't be a case where a device
644 * in the device list is not in the
645 * selection list...but it could happen.
648 fprintf(stderr, "selectdevs: couldn't"
649 " find %s%d in selection "
651 devices[j].device_name,
652 devices[j].unit_number);
657 * We do different things based upon the
658 * mode we're in. If we're in add or only
659 * mode, we go ahead and select this device
660 * if it hasn't already been selected. If
661 * it has already been selected, we leave
662 * it alone so we don't mess up the
663 * selection ordering. Manually specified
664 * devices have already been selected, and
665 * they have higher priority than pattern
666 * matched devices. If we're in remove
667 * mode, we de-select the given device and
668 * decrement the selected count.
670 switch(select_mode) {
672 case DS_SELECT_ADDONLY:
674 if ((*dev_select)[k].selected != 0)
676 (*dev_select)[k].selected =
680 case DS_SELECT_REMOVE:
681 (*dev_select)[k].selected = 0;
690 * Here we implement "top" mode. Devices are sorted in the
691 * selection array based on two criteria: whether or not they are
692 * selected (not selection number, just the fact that they are
693 * selected!) and the number of bytes in the "bytes" field of the
694 * selection structure. The bytes field generally must be kept up
695 * by the user. In the future, it may be maintained by library
696 * functions, but for now the user has to do the work.
698 * At first glance, it may seem wrong that we don't go through and
699 * select every device in the case where the user hasn't specified
700 * any devices or patterns. In fact, though, it won't make any
701 * difference in the device sorting. In that particular case (i.e.
702 * when we're in "add" or "only" mode, and the user hasn't
703 * specified anything) the first time through no devices will be
704 * selected, so the only criterion used to sort them will be their
705 * performance. The second time through, and every time thereafter,
706 * all devices will be selected, so again selection won't matter.
708 if (perf_select != 0) {
710 /* Sort the device array by throughput */
711 qsort(*dev_select, *num_selections,
712 sizeof(struct device_selection),
715 if (*num_selected == 0) {
717 * Here we select every device in the array, if it
718 * isn't already selected. Because the 'selected'
719 * variable in the selection array entries contains
720 * the selection order, the devstats routine can show
721 * the devices that were selected first.
723 for (i = 0; i < *num_selections; i++) {
724 if ((*dev_select)[i].selected == 0) {
725 (*dev_select)[i].selected =
731 selection_number = 0;
732 for (i = 0; i < *num_selections; i++) {
733 if ((*dev_select)[i].selected != 0) {
734 (*dev_select)[i].selected =
742 * If we're in the "add" selection mode and if we haven't already
743 * selected maxshowdevs number of devices, go through the array and
744 * select any unselected devices. If we're in "only" mode, we
745 * obviously don't want to select anything other than what the user
746 * specifies. If we're in "remove" mode, it probably isn't a good
747 * idea to go through and select any more devices, since we might
748 * end up selecting something that the user wants removed. Through
749 * more complicated logic, we could actually figure this out, but
750 * that would probably require combining this loop with the various
751 * selections loops above.
753 if ((select_mode == DS_SELECT_ADD) && (*num_selected < maxshowdevs)) {
754 for (i = 0; i < *num_selections; i++)
755 if ((*dev_select)[i].selected == 0) {
756 (*dev_select)[i].selected = ++selection_number;
762 * Look at the number of devices that have been selected. If it
763 * has changed, set the changed variable. Otherwise, if we've
764 * made a backup of the selection list, compare it to the current
765 * selection list to see if the selected devices have changed.
767 if ((changed == 0) && (old_num_selected != *num_selected))
769 else if ((changed == 0) && (old_dev_select != NULL)) {
771 * Now we go through the selection list and we look at
772 * it three different ways.
774 for (i = 0; (i < *num_selections) && (changed == 0) &&
775 (i < old_num_selections); i++) {
777 * If the device at index i in both the new and old
778 * selection arrays has the same device number and
779 * selection status, it hasn't changed. We
780 * continue on to the next index.
782 if (((*dev_select)[i].device_number ==
783 old_dev_select[i].device_number)
784 && ((*dev_select)[i].selected ==
785 old_dev_select[i].selected))
789 * Now, if we're still going through the if
790 * statement, the above test wasn't true. So we
791 * check here to see if the device at index i in
792 * the current array is the same as the device at
793 * index i in the old array. If it is, that means
794 * that its selection number has changed. Set
795 * changed to 1 and exit the loop.
797 else if ((*dev_select)[i].device_number ==
798 old_dev_select[i].device_number) {
803 * If we get here, then the device at index i in
804 * the current array isn't the same device as the
805 * device at index i in the old array.
811 * Search through the old selection array
812 * looking for a device with the same
813 * device number as the device at index i
814 * in the current array. If the selection
815 * status is the same, then we mark it as
816 * found. If the selection status isn't
817 * the same, we break out of the loop.
818 * Since found isn't set, changed will be
821 for (j = 0; j < old_num_selections; j++) {
822 if (((*dev_select)[i].device_number ==
823 old_dev_select[j].device_number)
824 && ((*dev_select)[i].selected ==
825 old_dev_select[j].selected)){
829 else if ((*dev_select)[i].device_number
830 == old_dev_select[j].device_number)
838 if (old_dev_select != NULL)
839 free(old_dev_select);
845 * Comparison routine for qsort() above. Note that the comparison here is
846 * backwards -- generally, it should return a value to indicate whether
847 * arg1 is <, =, or > arg2. Instead, it returns the opposite. The reason
848 * it returns the opposite is so that the selection array will be sorted in
849 * order of decreasing performance. We sort on two parameters. The first
850 * sort key is whether or not one or the other of the devices in question
851 * has been selected. If one of them has, and the other one has not, the
852 * selected device is automatically more important than the unselected
853 * device. If neither device is selected, we judge the devices based upon
857 compare_select(const void *arg1, const void *arg2)
859 if ((((const struct device_selection *)arg1)->selected)
860 && (((const struct device_selection *)arg2)->selected == 0))
862 else if ((((const struct device_selection *)arg1)->selected == 0)
863 && (((const struct device_selection *)arg2)->selected))
865 else if (((const struct device_selection *)arg2)->bytes <
866 ((const struct device_selection *)arg1)->bytes)
868 else if (((const struct device_selection *)arg2)->bytes >
869 ((const struct device_selection *)arg1)->bytes)
876 * Take a string with the general format "arg1,arg2,arg3", and build a
877 * device matching expression from it.
880 buildmatch(const char *match_str, struct devstat_match **matches,
885 char *matchbuf_orig; /* strdup of match_str */
886 char *matchbuf; /* allow strsep to clobber */
891 /* We can't do much without a string to parse */
892 if (match_str == NULL) {
893 sprintf(devstat_errbuf, "%s: no match expression", __func__);
898 * Break the (comma delimited) input string out into separate strings.
899 * strsep is destructive, so copy the string first.
901 matchbuf = matchbuf_orig = strdup(match_str);
902 if (matchbuf == NULL) {
903 sprintf(devstat_errbuf, "%s: out of memory", __func__);
906 for (tempstr = tstr, num_args = 0;
907 (*tempstr = strsep(&matchbuf, ",")) != NULL && (num_args < 5);
909 if (**tempstr != '\0')
910 if (++tempstr >= &tstr[5])
913 /* The user gave us too many type arguments */
915 sprintf(devstat_errbuf, "%s: too many type arguments",
921 * Since you can't realloc a pointer that hasn't been malloced
922 * first, we malloc first and then realloc.
924 if (*num_matches == 0)
925 *matches = (struct devstat_match *)malloc(
926 sizeof(struct devstat_match));
928 *matches = (struct devstat_match *)realloc(*matches,
929 sizeof(struct devstat_match) * (*num_matches + 1));
931 /* Make sure the current entry is clear */
932 bzero(&matches[0][*num_matches], sizeof(struct devstat_match));
935 * Step through the arguments the user gave us and build a device
936 * matching expression from them.
938 for (i = 0; i < num_args; i++) {
939 char *tempstr2, *tempstr3;
942 * Get rid of leading white space.
945 while (isspace(*tempstr2) && (*tempstr2 != '\0'))
949 * Get rid of trailing white space.
951 tempstr3 = &tempstr2[strlen(tempstr2) - 1];
953 while ((*tempstr3 != '\0') && (tempstr3 > tempstr2)
954 && (isspace(*tempstr3))) {
960 * Go through the match table comparing the user's
961 * arguments to known device types, interfaces, etc.
963 for (j = 0; match_table[j].match_str != NULL; j++) {
965 * We do case-insensitive matching, in case someone
966 * wants to enter "SCSI" instead of "scsi" or
967 * something like that. Only compare as many
968 * characters as are in the string in the match
969 * table. This should help if someone tries to use
970 * a super-long match expression.
972 if (strncasecmp(tempstr2, match_table[j].match_str,
973 strlen(match_table[j].match_str)) == 0) {
975 * Make sure the user hasn't specified two
976 * items of the same type, like "da" and
977 * "cd". One device cannot be both.
979 if (((*matches)[*num_matches].match_fields &
980 match_table[j].match_field) != 0) {
981 sprintf(devstat_errbuf,
982 "%s: cannot have more than "
983 "one match item in a single "
984 "category", __func__);
988 * If we've gotten this far, we have a
989 * winner. Set the appropriate fields in
992 (*matches)[*num_matches].match_fields |=
993 match_table[j].match_field;
994 (*matches)[*num_matches].device_type |=
996 (*matches)[*num_matches].num_match_categories++;
1001 * We should have found a match in the above for loop. If
1002 * not, that means the user entered an invalid device type
1005 if ((*matches)[*num_matches].num_match_categories != (i + 1)) {
1006 snprintf(devstat_errbuf, sizeof(devstat_errbuf),
1007 "%s: unknown match item \"%s\"", __func__,
1016 free(matchbuf_orig);
1021 * Compute a number of device statistics. Only one field is mandatory, and
1022 * that is "current". Everything else is optional. The caller passes in
1023 * pointers to variables to hold the various statistics he desires. If he
1024 * doesn't want a particular staistic, he should pass in a NULL pointer.
1030 compute_stats(struct devstat *current, struct devstat *previous,
1031 long double etime, u_int64_t *total_bytes,
1032 u_int64_t *total_transfers, u_int64_t *total_blocks,
1033 long double *kb_per_transfer, long double *transfers_per_second,
1034 long double *mb_per_second, long double *blocks_per_second,
1035 long double *ms_per_transaction)
1037 u_int64_t totalbytes, totaltransfers, totalblocks;
1040 * current is the only mandatory field.
1042 if (current == NULL) {
1043 sprintf(devstat_errbuf, "%s: current stats structure was NULL",
1048 totalbytes = (current->bytes_written + current->bytes_read) -
1049 ((previous) ? (previous->bytes_written +
1050 previous->bytes_read) : 0);
1053 *total_bytes = totalbytes;
1055 totaltransfers = (current->num_reads +
1056 current->num_writes +
1057 current->num_other) -
1059 (previous->num_reads +
1060 previous->num_writes +
1061 previous->num_other) : 0);
1062 if (total_transfers)
1063 *total_transfers = totaltransfers;
1065 if (transfers_per_second) {
1067 *transfers_per_second = totaltransfers;
1068 *transfers_per_second /= etime;
1070 *transfers_per_second = 0.0;
1073 if (kb_per_transfer) {
1074 *kb_per_transfer = totalbytes;
1075 *kb_per_transfer /= 1024;
1076 if (totaltransfers > 0)
1077 *kb_per_transfer /= totaltransfers;
1079 *kb_per_transfer = 0.0;
1082 if (mb_per_second) {
1083 *mb_per_second = totalbytes;
1084 *mb_per_second /= 1024 * 1024;
1086 *mb_per_second /= etime;
1088 *mb_per_second = 0.0;
1091 totalblocks = totalbytes;
1092 if (current->block_size > 0)
1093 totalblocks /= current->block_size;
1098 *total_blocks = totalblocks;
1100 if (blocks_per_second) {
1101 *blocks_per_second = totalblocks;
1103 *blocks_per_second /= etime;
1105 *blocks_per_second = 0.0;
1108 if (ms_per_transaction) {
1109 if (totaltransfers > 0) {
1110 *ms_per_transaction = etime;
1111 *ms_per_transaction /= totaltransfers;
1112 *ms_per_transaction *= 1000;
1114 *ms_per_transaction = 0.0;
1121 compute_stats_read(struct devstat *current, struct devstat *previous,
1122 long double etime, u_int64_t *total_bytes,
1123 u_int64_t *total_transfers, u_int64_t *total_blocks,
1124 long double *kb_per_transfer, long double *transfers_per_second,
1125 long double *mb_per_second, long double *blocks_per_second,
1126 long double *ms_per_transaction)
1128 u_int64_t totalbytes, totaltransfers, totalblocks;
1131 * current is the only mandatory field.
1133 if (current == NULL) {
1134 sprintf(devstat_errbuf, "%s: current stats structure was NULL",
1139 totalbytes = current->bytes_read -
1140 (previous ? previous->bytes_read : 0);
1143 *total_bytes = totalbytes;
1145 totaltransfers = current->num_reads -
1146 (previous ? previous->num_reads : 0);
1147 if (total_transfers)
1148 *total_transfers = totaltransfers;
1150 if (transfers_per_second) {
1152 *transfers_per_second = totaltransfers;
1153 *transfers_per_second /= etime;
1155 *transfers_per_second = 0.0;
1158 if (kb_per_transfer) {
1159 *kb_per_transfer = totalbytes;
1160 *kb_per_transfer /= 1024;
1161 if (totaltransfers > 0)
1162 *kb_per_transfer /= totaltransfers;
1164 *kb_per_transfer = 0.0;
1167 if (mb_per_second) {
1168 *mb_per_second = totalbytes;
1169 *mb_per_second /= 1024 * 1024;
1171 *mb_per_second /= etime;
1173 *mb_per_second = 0.0;
1176 totalblocks = totalbytes;
1177 if (current->block_size > 0)
1178 totalblocks /= current->block_size;
1183 *total_blocks = totalblocks;
1185 if (blocks_per_second) {
1186 *blocks_per_second = totalblocks;
1188 *blocks_per_second /= etime;
1190 *blocks_per_second = 0.0;
1193 if (ms_per_transaction) {
1194 if (totaltransfers > 0) {
1195 *ms_per_transaction = etime;
1196 *ms_per_transaction /= totaltransfers;
1197 *ms_per_transaction *= 1000;
1199 *ms_per_transaction = 0.0;
1206 compute_stats_write(struct devstat *current, struct devstat *previous,
1207 long double etime, u_int64_t *total_bytes,
1208 u_int64_t *total_transfers, u_int64_t *total_blocks,
1209 long double *kb_per_transfer, long double *transfers_per_second,
1210 long double *mb_per_second, long double *blocks_per_second,
1211 long double *ms_per_transaction)
1213 u_int64_t totalbytes, totaltransfers, totalblocks;
1216 * current is the only mandatory field.
1218 if (current == NULL) {
1219 sprintf(devstat_errbuf, "%s: current stats structure was NULL",
1224 totalbytes = current->bytes_written -
1225 (previous ? previous->bytes_written : 0);
1228 *total_bytes = totalbytes;
1230 totaltransfers = current->num_writes -
1231 (previous ? previous->num_writes : 0);
1232 if (total_transfers)
1233 *total_transfers = totaltransfers;
1235 if (transfers_per_second) {
1237 *transfers_per_second = totaltransfers;
1238 *transfers_per_second /= etime;
1240 *transfers_per_second = 0.0;
1243 if (kb_per_transfer) {
1244 *kb_per_transfer = totalbytes;
1245 *kb_per_transfer /= 1024;
1246 if (totaltransfers > 0)
1247 *kb_per_transfer /= totaltransfers;
1249 *kb_per_transfer = 0.0;
1252 if (mb_per_second) {
1253 *mb_per_second = totalbytes;
1254 *mb_per_second /= 1024 * 1024;
1256 *mb_per_second /= etime;
1258 *mb_per_second = 0.0;
1261 totalblocks = totalbytes;
1262 if (current->block_size > 0)
1263 totalblocks /= current->block_size;
1268 *total_blocks = totalblocks;
1270 if (blocks_per_second) {
1271 *blocks_per_second = totalblocks;
1273 *blocks_per_second /= etime;
1275 *blocks_per_second = 0.0;
1278 if (ms_per_transaction) {
1279 if (totaltransfers > 0) {
1280 *ms_per_transaction = etime;
1281 *ms_per_transaction /= totaltransfers;
1282 *ms_per_transaction *= 1000;
1284 *ms_per_transaction = 0.0;
1291 compute_etime(struct timeval cur_time, struct timeval prev_time)
1293 struct timeval busy_time;
1294 u_int64_t busy_usec;
1297 timersub(&cur_time, &prev_time, &busy_time);
1299 busy_usec = busy_time.tv_sec;
1300 busy_usec *= 1000000;
1301 busy_usec += busy_time.tv_usec;