This release contains a fairly large internal restructuring, which has noticeable public API changes. A lot of core functionality has been brought into a new procfs-core crate that contains platform-independent data structures and parsing. This crate can be used on all platforms. The procfs crate now depends on procfs-core, and contains all of the Linux-specific code (and thus remains only usable on Linux).

Some procfs functions require information about the running system. For example, the rss_bytes() function needs to know the page size. These functions now have a more complicated API. See the docs for more information, but generally you now have to add a call to .get(), for example:

Old:

let prc = procfs::process::Process::myself().unwrap();
let stat = prc.stat().unwrap();
println!("RSS:   {} bytes", stat.rss_bytes());

New:

use procfs::prelude::*;  // to bring `WithCurrentSystemInfo` into scope

let prc = procfs::process::Process::myself().unwrap();
let stat = prc.stat().unwrap();
println!("RSS:   {} bytes", stat.rss_bytes().get());

We think this new complication is unavoidable, but if you have some thoughts on this, your ideas are welcome in a new issue or discussion thread

New Features

• Implementation of a split crate scheme. by @afranchuk in https://github.com/eminence/procfs/pull/257
• Add /proc/mounts by @tatref in https://github.com/eminence/procfs/pull/261
• add /proc/pid/clear_refs by @tatref in https://github.com/eminence/procfs/pull/268
• Implement some standard traits by @tatref in https://github.com/eminence/procfs/pull/254
• Support /proc/net/snmp and /proc/net/snmp6 by @wfly1998 in https://github.com/eminence/procfs/pull/281
• Add support for /proc/partitions parsing by @berrange in https://github.com/eminence/procfs/pull/286

Bug Fixes

• Don't hide process creation errors in all_processes by @tatref in https://github.com/eminence/procfs/pull/260
• Fix O_PATH for old kernels by @tatref in https://github.com/eminence/procfs/pull/266

Full Changelog: https://github.com/eminence/procfs/compare/v0.15.1...v0.16.0

New features

• Change Stat::comm documentation by @rust1248 in https://github.com/eminence/procfs/pull/251
• Add docs and a as_str method to MMPermission by @eminence in https://github.com/eminence/procfs/pull/252

New Contributors

• @rust1248 made their first contribution in https://github.com/eminence/procfs/pull/251

Full Changelog: https://github.com/eminence/procfs/compare/v0.15.0...v0.15.1

New Features

• Add /proc/iomem by @tatref in https://github.com/eminence/procfs/pull/216
• Add new functions to read various net files for a specific process by @eminence in https://github.com/eminence/procfs/pull/226
• add /proc/kpageflags by @tatref in https://github.com/eminence/procfs/pull/233
• Enable oppportunistic fd counting fast path by @bobrik in https://github.com/eminence/procfs/pull/234
• add /proc/kpagecount by @tatref in https://github.com/eminence/procfs/pull/232
• Add new /proc/meminfo fields. by @afranchuk in https://github.com/eminence/procfs/pull/238
• impl Hash for kernel version by @tatref in https://github.com/eminence/procfs/pull/240

Bug fixes

• fix chrono::Local::timestamp deprecated in chrono 0.4.23 by @tatref in https://github.com/eminence/procfs/pull/220
• Fix some minor documentation issues by @eminence in https://github.com/eminence/procfs/pull/225
• Fixes the reported path when a task's function returns an error by @eminence in https://github.com/eminence/procfs/pull/230
• fix shm size type by @tatref in https://github.com/eminence/procfs/pull/243

Breaking changes

• ticks_per_second and page_size are infallible by @eminence in https://github.com/eminence/procfs/pull/235
• parse uid for /proc/net/{tcp,udp} by @trinity-1686a in https://github.com/eminence/procfs/pull/231
• Refactor and expose memory map processing. by @afranchuk in https://github.com/eminence/procfs/pull/237

New Contributors

• @trinity-1686a made their first contribution in https://github.com/eminence/procfs/pull/231
• @afranchuk made their first contribution in https://github.com/eminence/procfs/pull/238

Full Changelog: https://github.com/eminence/procfs/compare/v0.14.2...v0.15.0

MSRV Note

This v0.15 release is only tested against the latest stable rust compiler, but is known to work with older versions (down to rust 1.48). Support for these older compilers may break in procfs patch releases. See also #223

New Features

• Process: Namespace: Use openat instead of building a path by @arilou in https://github.com/eminence/procfs/pull/192
• add serde serialize/deserialize derives for public types by @eliad-wiz in https://github.com/eminence/procfs/pull/193
• Disabling default features on the chrono crate by @Will-Low in https://github.com/eminence/procfs/pull/210
• Implement smaps_rollup by @TaborKelly in https://github.com/eminence/procfs/pull/214

Bug fixes

• Don't consider Zombies to be alive by @eminence in https://github.com/eminence/procfs/pull/198
• Fix doc and clippy warnings by @tatref in https://github.com/eminence/procfs/pull/219
• Fix memfd fd target by @trtt in https://github.com/eminence/procfs/pull/209
• Fix process iterator when used with a custom root by @ludo-c in https://github.com/eminence/procfs/pull/204

Dependency Updates

• Update to rustix 0.36. by @sunfishcode in https://github.com/eminence/procfs/pull/215
• Bump chorono to 0.4.20 by @pinkforest in https://github.com/eminence/procfs/pull/194

Full Changelog: https://github.com/eminence/procfs/compare/v0.14.0...v0.14.2

Bug fixes

• Don't consider Zombies to be alive by @eminence in https://github.com/eminence/procfs/pull/201

Full Changelog: https://github.com/eminence/procfs/compare/v0.14.0...v0.14.1

Bug fixes

• Don't consider Zombies to be alive by @eminence in https://github.com/eminence/procfs/pull/199

Full Changelog: https://github.com/eminence/procfs/compare/v0.13.2...v0.13.3

Breaking changes

• Process: namespaces: Change from Vec to HashMap by @arilou in https://github.com/eminence/procfs/pull/185

New features

• Add suport for /proc/[pid]/task/[tid]/children by @zmjackson in https://github.com/eminence/procfs/pull/180
• Add 'from_reader' for LoadAverage struct by @ludo-c in https://github.com/eminence/procfs/pull/191

Other changes

• Fix build.rs to allow cross-compilation by @eminence in https://github.com/eminence/procfs/pull/187
• Document MSRV in Cargo.toml by @eminence in https://github.com/eminence/procfs/pull/189
• Add some docs on the Process object by @eminence in https://github.com/eminence/procfs/pull/190

Full Changelog: https://github.com/eminence/procfs/compare/v0.13.2...v0.14.0

New features

• Re-introduce all_processes_with_root. by @sunfishcode in https://github.com/eminence/procfs/pull/184

Bug fixes

• Process: Correct AUXV to support 64bit Linux by @arilou in https://github.com/eminence/procfs/pull/178

Note: This fix is technically a breaking change, as the return value for a public API changed from HashMap<u32, u32> to HashMap<u64, u64>. However, since this function has been 100% broken for 4 years, I feel confident that no one is actually using this API.

New features

• Add support for /proc/pid/mem by @eminence in https://github.com/eminence/procfs/pull/182

Other improvements

• Remove obsolete document about stat field by @dalance in https://github.com/eminence/procfs/pull/177
• Small update to doc comment on fd_count() by @eminence in https://github.com/eminence/procfs/pull/183

Full Changelog: https://github.com/eminence/procfs/compare/v0.13.0...v0.13.1

Breaking changes

This release has several breaking API changes you should be aware of:

• MSRV has been changed from 1.34 to 1.48
• The Process struct has been changed in some important ways:
  • Internally, it now maintains a handle to an opened /proc/<pid> directory. So each Process will have an open file handle, which can matter in extreme cases when you have a large number of Process objects created.
  • Because each Process has a handle to its opened proc directory, there is no longer any PID reuse problems (that is, there is no risk of accidentally getting process information for a new process that has reused a PID)
  • Process no longer implements Clone.
  • Process no longer has a public member stats member that gets pre-populated on construction. If you want this info, you now need to explicitly call the Process::stat() function

New features

• Revive RFC: Change Process to use directory fd by @sunfishcode in https://github.com/eminence/procfs/pull/171
• Add support for /proc/<pid>/pagemap by @EliaGeretto in https://github.com/eminence/procfs/pull/166
• Process: Add support for network by @arilou in https://github.com/eminence/procfs/pull/176

Internal changes

• Add build-script to provide a nicely readable error if on unsupported platform by @macisamuele in https://github.com/eminence/procfs/pull/167
• Fix a race condition in the test_task_runsinglethread test. by @sunfishcode in https://github.com/eminence/procfs/pull/169
• Bump MSRV to 1.42 by @eminence in https://github.com/eminence/procfs/pull/170
• Update github-actions configuration to run all the github actions up to completion by @macisamuele in https://github.com/eminence/procfs/pull/172
• Improve CpuInfo performances by @macisamuele in https://github.com/eminence/procfs/pull/168
• Build with cargo update -Z minimal-versions by @xfix in https://github.com/eminence/procfs/pull/173
• Update to the latest rustix version by @eminence in https://github.com/eminence/procfs/pull/174
• Clippy and rustfmt fixes by @eminence in https://github.com/eminence/procfs/pull/175

Full Changelog: https://github.com/eminence/procfs/compare/v0.12.0...v0.13.0

Breaking changes

• Make the flate2 dependency optional by @eminence in https://github.com/eminence/procfs/pull/157

The flate2 dependencies was used only in the kernel_config method, which would try to read a compressed /proc/config.gz file if it existed. The flate2 dependency is now optional (and enabled by default). If you are using procfs with "default-features = false" and you are using the kernel_config method, pay special attention here -- you might want to manually enable the flate2 feature.

New features

• /proc/sysvipc/shm by @tatref in https://github.com/eminence/procfs/pull/154
• Add support for /proc/net/route by @pymongo in https://github.com/eminence/procfs/pull/162
• Add support for /proc/sys/kernel/{ostype,version} by @KernelErr in https://github.com/eminence/procfs/pull/163

Bug fixes

• fix: 32bit signed int by @tatref in https://github.com/eminence/procfs/pull/153

Full Changelog: https://github.com/eminence/procfs/compare/v0.11.0...v0.12.0

Bug fixes

• fix: 32bit signed int by @tatref in https://github.com/eminence/procfs/pull/153

Breaking changes

• Switch to u64 from usize in many places by @h33p in https://github.com/eminence/procfs/pull/147
  • On 64-bit machines, this change should have no impact on behavior, but it is still a breaking change as these types are part of the public API.
• Remove unwraps from our lazy statics by @eminence in https://github.com/eminence/procfs/pull/150
  • This change should make procfs panic even less, but as the cost of a breaking API change that wraps the return value of some functions in a Result

New Features

• Update docs and CI for MSRV by @eminence in https://github.com/eminence/procfs/pull/149
• Add support for /proc/uptime by @oblique in https://github.com/eminence/procfs/pull/146
• MMapPath::Vsys for /SYSV pseudo files by @tatref in https://github.com/eminence/procfs/pull/151

Bug fixes

• Handle process cgroup paths containng ':' by @alfonsoros88 in https://github.com/eminence/procfs/pull/152

New Contributors

• @h33p made their first contribution in https://github.com/eminence/procfs/pull/147
• @oblique made their first contribution in https://github.com/eminence/procfs/pull/146
• @tatref made their first contribution in https://github.com/eminence/procfs/pull/151
• @alfonsoros88 made their first contribution in https://github.com/eminence/procfs/pull/152

Full Changelog: https://github.com/eminence/procfs/compare/v0.10.1...v0.11.0

Note The v0.10.1 release was actually released August 26, 2021. This release created in github was done after the fact

What's Changed

New features

• Unpin hex and bitflags by @eminence in https://github.com/eminence/procfs/pull/145

Bug fixes

• fix compilation for 32-bit builds. It is tested for target armv7-unkn… by @anstylian in https://github.com/eminence/procfs/pull/142

New Contributors

• @anstylian made their first contribution in https://github.com/eminence/procfs/pull/142

Full Changelog: https://github.com/eminence/procfs/compare/v0.10.0...v0.10.1

Breaking changes

• Use u16 for kernel patch version number #137
• Changed inodes to u64, fixed a test, and updated a doc string #132

New features

• Derive Clone for all public structs and enums. #128
• Get all processes with a custom root of /proc path #122
• Create FDInfo from raw fd and pid #123
• feat: create task by specify pid and tid #134
• Add support for /proc/pid/ns #135

Bug fixes

• When writing files, don't open the file for read #120
• Pin hex to 0.4.2 to restore MSRV of 1.34 #129

Please note that this are several API incompatible changes, compared to the 0.8.x release. Also, the Minimum Supported Rust Version has been changed from 1.33.0 to 1.34.0

New features

• Swap libflate for flate2 (#100)
• Support /proc/[pid]/task/[tid]/status (#110)
• Introduce fd_count() in addition to fd() (#105)
• Add Android support (#95)

Bug fixes

• Handle locks that are marked as "blocked" (#109)

Breaking changes

• Minimum supported rust version has been changed from 1.33.0 to 1.34.0
• Remove deprecated functions (#107)
• Store cputime in ticks, not fractional seconds (#106)
• Add a private field to some large structs (#101)

(Released September 8, 2020)

New Features

• A new method Process::task_main_thread to get the task for the main thread (#93)
• A new method Task::Io() (#91)

Bug fixes

• Fixed parsing of /proc/cpuinfo on systems that add extra info at the end of the file (like on a Raspberry Pi) (#92)

New features

Several new sysctl functions are added, in the following areas:

• epoll
• fs
• keyring
• kernel

Support for parsing new files, in the following areas:

• kernel keyrings
• Listing tasks (threads) in a process
• File locks
• ARP table

Bug fixes

• Procfs should panic even less often now, when parsing garbage data

Breaking changes

• A typo is fixed in the name of a public field: hugetlbpages (#83)

New Features:

• Update version of libflate to v1.0. #73
• Add support for diskstat info. #71
• Add support for reading /proc/modules

New features:

• Cache boottime to improve performance (for example, when calling starttime()). #64

Bug fixes:

• Fix parsing of IPv6 addresses. #67