Struct linux_taskstats::taskstats
source · #[repr(C)]pub struct taskstats {Show 44 fields
pub version: c_ushort,
pub ac_exitcode: c_uint,
pub ac_flag: c_uchar,
pub ac_nice: c_uchar,
pub cpu_count: c_ulonglong,
pub cpu_delay_total: c_ulonglong,
pub blkio_count: c_ulonglong,
pub blkio_delay_total: c_ulonglong,
pub swapin_count: c_ulonglong,
pub swapin_delay_total: c_ulonglong,
pub cpu_run_real_total: c_ulonglong,
pub cpu_run_virtual_total: c_ulonglong,
pub ac_comm: [c_char; 32],
pub ac_sched: c_uchar,
pub ac_pad: [c_uchar; 3],
pub __unused_padding: u32,
pub ac_uid: c_uint,
pub ac_gid: c_uint,
pub ac_pid: c_uint,
pub ac_ppid: c_uint,
pub ac_btime: c_uint,
pub ac_etime: c_ulonglong,
pub ac_utime: c_ulonglong,
pub ac_stime: c_ulonglong,
pub ac_minflt: c_ulonglong,
pub ac_majflt: c_ulonglong,
pub coremem: c_ulonglong,
pub virtmem: c_ulonglong,
pub hiwater_rss: c_ulonglong,
pub hiwater_vm: c_ulonglong,
pub read_char: c_ulonglong,
pub write_char: c_ulonglong,
pub read_syscalls: c_ulonglong,
pub write_syscalls: c_ulonglong,
pub read_bytes: c_ulonglong,
pub write_bytes: c_ulonglong,
pub cancelled_write_bytes: c_ulonglong,
pub nvcsw: c_ulonglong,
pub nivcsw: c_ulonglong,
pub ac_utimescaled: c_ulonglong,
pub ac_stimescaled: c_ulonglong,
pub cpu_scaled_run_real_total: c_ulonglong,
pub freepages_count: c_ulonglong,
pub freepages_delay_total: c_ulonglong,
}
Expand description
This is custom copy of the generated struct taskstats
from linux version 3.10.0 and in this crate
this type is used to read binary data transferred from linux kernel.
The reason of doing this despite the bindgen
generates rust bindings including struct taskstats
is due to potential corruption of on-memory struct layout likely caused by old clang version.
ref: https://github.com/rust-lang/rust-bindgen/issues/867
Specifically, when bindgen
generates struct taskstats
with older clang version, the resulting
struct defined in generated rust source code contains size padding as the last member of the struct
causing offset of members after ac_uid
to shift 4-byte or more and the result data becomes unreliable.
The bindgen
generated definition works well in environment that uses newer clang versions, but I
decided to use copied definition of this struct for the time being by following considerations:
- The struct definition rarely evolves.
- Returning corrupted data silently is critical and much worse than not providing from the beginning.
- If user of this crate still needs to access the exactly original definition generated by
bindgen
, it might still be possible by casting type to__bindgen_taskstats
exported by this crate.
Fields§
§version: c_ushort
§ac_exitcode: c_uint
§ac_flag: c_uchar
§ac_nice: c_uchar
§cpu_count: c_ulonglong
§cpu_delay_total: c_ulonglong
§blkio_count: c_ulonglong
§blkio_delay_total: c_ulonglong
§swapin_count: c_ulonglong
§swapin_delay_total: c_ulonglong
§cpu_run_real_total: c_ulonglong
§cpu_run_virtual_total: c_ulonglong
§ac_comm: [c_char; 32]
§ac_sched: c_uchar
§ac_pad: [c_uchar; 3]
§__unused_padding: u32
§ac_uid: c_uint
§ac_gid: c_uint
§ac_pid: c_uint
§ac_ppid: c_uint
§ac_btime: c_uint
§ac_etime: c_ulonglong
§ac_utime: c_ulonglong
§ac_stime: c_ulonglong
§ac_minflt: c_ulonglong
§ac_majflt: c_ulonglong
§coremem: c_ulonglong
§virtmem: c_ulonglong
§hiwater_rss: c_ulonglong
§hiwater_vm: c_ulonglong
§read_char: c_ulonglong
§write_char: c_ulonglong
§read_syscalls: c_ulonglong
§write_syscalls: c_ulonglong
§read_bytes: c_ulonglong
§write_bytes: c_ulonglong
§cancelled_write_bytes: c_ulonglong
§nvcsw: c_ulonglong
§nivcsw: c_ulonglong
§ac_utimescaled: c_ulonglong
§ac_stimescaled: c_ulonglong
§cpu_scaled_run_real_total: c_ulonglong
§freepages_count: c_ulonglong
§freepages_delay_total: c_ulonglong