2 * iostat: report CPU and I/O statistics
3 * (C) 1999-2016 by Sebastien Godard (sysstat <at> orange.fr)
11 /* I_: iostat - D_: Display - F_: Flag */
12 #define I_D_CPU 0x00001
13 #define I_D_DISK 0x00002
14 #define I_D_TIMESTAMP 0x00004
15 #define I_D_EXTENDED 0x00008
16 #define I_D_PART_ALL 0x00010
17 #define I_D_KILOBYTES 0x00020
18 #define I_F_HAS_SYSFS 0x00040
19 #define I_D_DEBUG 0x00080
20 #define I_D_UNFILTERED 0x00100
21 #define I_D_MEGABYTES 0x00200
22 #define I_D_PARTITIONS 0x00400
23 #define I_F_HAS_DISKSTATS 0x00800
24 #define I_D_HUMAN_READ 0x01000
25 #define I_D_PERSIST_NAME 0x02000
26 #define I_D_OMIT_SINCE_BOOT 0x04000
28 #define I_D_DEVMAP_NAME 0x10000
29 #define I_D_ISO 0x20000
30 #define I_D_GROUP_TOTAL_ONLY 0x40000
31 #define I_D_ZERO_OMIT 0x80000
33 #define DISPLAY_CPU(m) (((m) & I_D_CPU) == I_D_CPU)
34 #define DISPLAY_DISK(m) (((m) & I_D_DISK) == I_D_DISK)
35 #define DISPLAY_TIMESTAMP(m) (((m) & I_D_TIMESTAMP) == I_D_TIMESTAMP)
36 #define DISPLAY_EXTENDED(m) (((m) & I_D_EXTENDED) == I_D_EXTENDED)
37 #define DISPLAY_PART_ALL(m) (((m) & I_D_PART_ALL) == I_D_PART_ALL)
38 #define DISPLAY_KILOBYTES(m) (((m) & I_D_KILOBYTES) == I_D_KILOBYTES)
39 #define DISPLAY_MEGABYTES(m) (((m) & I_D_MEGABYTES) == I_D_MEGABYTES)
40 #define HAS_SYSFS(m) (((m) & I_F_HAS_SYSFS) == I_F_HAS_SYSFS)
41 #define DISPLAY_DEBUG(m) (((m) & I_D_DEBUG) == I_D_DEBUG)
42 #define DISPLAY_UNFILTERED(m) (((m) & I_D_UNFILTERED) == I_D_UNFILTERED)
43 #define DISPLAY_PARTITIONS(m) (((m) & I_D_PARTITIONS) == I_D_PARTITIONS)
44 #define HAS_DISKSTATS(m) (((m) & I_F_HAS_DISKSTATS) == I_F_HAS_DISKSTATS)
45 #define DISPLAY_HUMAN_READ(m) (((m) & I_D_HUMAN_READ) == I_D_HUMAN_READ)
46 #define DISPLAY_PERSIST_NAME_I(m) (((m) & I_D_PERSIST_NAME) == I_D_PERSIST_NAME)
47 #define DISPLAY_OMIT_SINCE_BOOT(m) (((m) & I_D_OMIT_SINCE_BOOT) == I_D_OMIT_SINCE_BOOT)
48 #define DISPLAY_DEVMAP_NAME(m) (((m) & I_D_DEVMAP_NAME) == I_D_DEVMAP_NAME)
49 #define DISPLAY_ISO(m) (((m) & I_D_ISO) == I_D_ISO)
50 #define DISPLAY_GROUP_TOTAL_ONLY(m) (((m) & I_D_GROUP_TOTAL_ONLY) == I_D_GROUP_TOTAL_ONLY)
51 #define DISPLAY_ZERO_OMIT(m) (((m) & I_D_ZERO_OMIT) == I_D_ZERO_OMIT)
53 /* Preallocation constants */
54 #define NR_DEV_PREALLOC 4
56 /* Environment variable */
57 #define ENV_POSIXLY_CORRECT "POSIXLY_CORRECT"
60 * Structures for I/O stats.
61 * The number of structures allocated corresponds to the number of devices
62 * present in the system, plus a preallocation number to handle those
63 * that can be registered dynamically.
64 * The number of devices is found by using /sys filesystem (if mounted).
65 * For each io_stats structure allocated corresponds a io_hdr_stats structure.
66 * A io_stats structure is considered as unused or "free" (containing no stats
67 * for a particular device) if the 'major' field of the io_hdr_stats
68 * structure is set to 0.
71 /* # of sectors read */
72 unsigned long rd_sectors __attribute__ ((aligned (8)));
73 /* # of sectors written */
74 unsigned long wr_sectors __attribute__ ((packed));
75 /* # of read operations issued to the device */
76 unsigned long rd_ios __attribute__ ((packed));
77 /* # of read requests merged */
78 unsigned long rd_merges __attribute__ ((packed));
79 /* # of write operations issued to the device */
80 unsigned long wr_ios __attribute__ ((packed));
81 /* # of write requests merged */
82 unsigned long wr_merges __attribute__ ((packed));
83 /* Time of read requests in queue */
84 unsigned int rd_ticks __attribute__ ((packed));
85 /* Time of write requests in queue */
86 unsigned int wr_ticks __attribute__ ((packed));
87 /* # of I/Os in progress */
88 unsigned int ios_pgr __attribute__ ((packed));
89 /* # of ticks total (for this device) for I/O */
90 unsigned int tot_ticks __attribute__ ((packed));
91 /* # of ticks requests spent in queue */
92 unsigned int rq_ticks __attribute__ ((packed));
95 #define IO_STATS_SIZE (sizeof(struct io_stats))
97 /* Possible values for field "status" in io_hdr_stats structure */
98 #define DISK_UNREGISTERED 0
99 #define DISK_REGISTERED 1
103 * Each io_stats structure has an associated io_hdr_stats structure.
104 * An io_hdr_stats structure tells if the corresponding device has been
105 * unregistered or not (status field) and also indicates the device name.
107 struct io_hdr_stats {
108 unsigned int status __attribute__ ((aligned (4)));
109 unsigned int used __attribute__ ((packed));
110 char name[MAX_NAME_LEN];
113 #define IO_HDR_STATS_SIZE (sizeof(struct io_hdr_stats))
115 /* List of devices entered on the command line */
117 /* Indicate whether its partitions are to be displayed or not */
118 int disp_part __attribute__ ((aligned (4)));
120 char dev_name[MAX_NAME_LEN];
123 #define IO_DLIST_SIZE (sizeof(struct io_dlist))
125 #endif /* _IOSTAT_H */