14 releases

0.10.2 Sep 1, 2024
0.10.1 Jul 19, 2023
0.9.1 Jan 30, 2023
0.9.0 Dec 28, 2022
0.3.0 Jul 29, 2019

#22 in Unix APIs

Download history 52298/week @ 2024-08-03 51670/week @ 2024-08-10 56261/week @ 2024-08-17 54904/week @ 2024-08-24 60835/week @ 2024-08-31 57768/week @ 2024-09-07 55988/week @ 2024-09-14 52738/week @ 2024-09-21 53264/week @ 2024-09-28 58605/week @ 2024-10-05 57249/week @ 2024-10-12 59715/week @ 2024-10-19 54817/week @ 2024-10-26 52615/week @ 2024-11-02 54142/week @ 2024-11-09 47619/week @ 2024-11-16

219,976 downloads per month
Used in 197 crates (52 directly)

MIT license

180KB
5K SLoC

rlimit

Latest Version Documentation License Downloads

Resource limits.

Documentation: https://docs.rs/rlimit

Contributing

Sponsor

If my open-source work has been helpful to you, please sponsor me.

Every little bit helps. Thank you!


lib.rs:

rlimit - Resource limits.

Set resource limit

use rlimit::{setrlimit, Resource};

const DEFAULT_SOFT_LIMIT: u64 = 4 * 1024 * 1024;
const DEFAULT_HARD_LIMIT: u64 = 8 * 1024 * 1024;
assert!(Resource::FSIZE.set(DEFAULT_SOFT_LIMIT, DEFAULT_HARD_LIMIT).is_ok());

let soft = 16384;
let hard = soft * 2;
assert!(setrlimit(Resource::NOFILE, soft, hard).is_ok());

Get resource limit

use rlimit::{getrlimit, Resource};

assert!(Resource::NOFILE.get().is_ok());
assert_eq!(getrlimit(Resource::CPU).unwrap(), (rlimit::INFINITY, rlimit::INFINITY));

Windows

Windows does not have Unix-like resource limits. It only supports changing the number of simultaneously open files currently permitted at the stdio level.

See the official documentation of _getmaxstdio and _setmaxstdio.

println!("{}", rlimit::getmaxstdio()); // 512
rlimit::setmaxstdio(2048).unwrap();
println!("{}", rlimit::getmaxstdio()); // 2048

Increase NOFILE limit

See the example nofile.

You can also use the tool function rlimit::increase_nofile_limit

rlimit::increase_nofile_limit(10240).unwrap();
rlimit::increase_nofile_limit(u64::MAX).unwrap();

Troubleshoot

Failed to increase NOFILE to hard limit on macOS

On macOS, getrlimit by default reports that the hard limit is unlimited, but there is usually a stricter hard limit discoverable via sysctl (kern.maxfilesperproc). Failing to discover this secret stricter hard limit will cause the call to setrlimit to fail.

rlimit::increase_nofile_limit respects kern.maxfilesperproc.

Dependencies