-
Notifications
You must be signed in to change notification settings - Fork 721
Add getrlimit(2) and setrlimit(2) #879
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Changes from 8 commits
63c438f
aaf89e4
f69bedb
2c4d804
13f75c1
7b537e3
8c18615
de89045
7242607
1c629ad
f87978b
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,124 @@ | ||
| //! Configure the process resource limits. | ||
| use std::mem; | ||
|
|
||
| use libc::{self, c_int, rlimit, RLIM_INFINITY}; | ||
| pub use libc::rlim_t; | ||
|
|
||
| use {Errno, Result}; | ||
|
|
||
| libc_enum!{ | ||
| #[repr(i32)] | ||
| pub enum Resource { | ||
| // POSIX | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Please provide doc comments for every entry here to give users an understanding of what they mean.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done |
||
| RLIMIT_AS, | ||
| RLIMIT_CORE, | ||
| RLIMIT_CPU, | ||
| RLIMIT_DATA, | ||
| RLIMIT_FSIZE, | ||
| RLIMIT_NOFILE, | ||
| RLIMIT_STACK, | ||
|
|
||
| // BSDs and Linux | ||
| #[cfg(any(target_os = "android", target_os = "freebsd", target_os = "linux", target_os = "openbsd"))] | ||
| RLIMIT_MEMLOCK, | ||
| #[cfg(any(target_os = "android", target_os = "freebsd", target_os = "linux", target_os = "openbsd"))] | ||
| RLIMIT_NPROC, | ||
| #[cfg(any(target_os = "android", target_os = "freebsd", target_os = "linux", target_os = "openbsd"))] | ||
| RLIMIT_RSS, | ||
|
|
||
| // Android and Linux only | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_LOCKS, | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_MSGQUEUE, | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_NICE, | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_RTPRIO, | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_RTTIME, | ||
| #[cfg(any(target_os = "android", target_os = "linux"))] | ||
| RLIMIT_SIGPENDING, | ||
|
|
||
| // Available on some BSD | ||
| #[cfg(target_os = "freebsd")] | ||
| RLIMIT_KQUEUES, | ||
| #[cfg(target_os = "freebsd")] | ||
| RLIMIT_NPTS, | ||
| #[cfg(any(target_os = "freebsd", target_os = "dragonfly"))] | ||
| RLIMIT_SBSIZE, | ||
| #[cfg(target_os = "freebsd")] | ||
| RLIMIT_SWAP, | ||
| } | ||
| } | ||
|
|
||
| /// Get the current processes resource limits | ||
| /// | ||
| /// A value of `None` corresponds to `RLIM_INFINITY`, which means there's no limit. | ||
|
||
| /// | ||
| /// # Parameters | ||
| /// | ||
| /// * `resource`: The [`Resource`] that we want to get the limits of. | ||
| /// | ||
| /// # Examples | ||
| /// | ||
| /// ``` | ||
| /// use nix::sys::resource::{getrlimit, Resource}; | ||
|
||
| /// | ||
| /// fn main() { | ||
| /// let (soft_limit, hard_limit) = getrlimit(Resource::RLIMIT_NOFILE).unwrap(); | ||
| /// println!("current soft_limit: {:?}", soft_limit); | ||
| /// println!("current hard_limit: {:?}", hard_limit); | ||
| /// } | ||
| /// ``` | ||
| /// | ||
| /// # References | ||
| /// | ||
| /// [getrlimit(2)](https://linux.die.net/man/2/getrlimit) | ||
| /// | ||
| /// [`Resource`]: enum.Resource.html | ||
| pub fn getrlimit(resource: Resource) -> Result<(Option<rlim_t>, Option<rlim_t>)> { | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Needs a doccomment, should have an example as well.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done |
||
| let mut rlim: rlimit = unsafe { mem::uninitialized() }; | ||
| let res = unsafe { libc::getrlimit(resource as c_int, &mut rlim as *mut _) }; | ||
| Errno::result(res).map(|_| { | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Ugly, but it works. Can you put a
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done |
||
| (if rlim.rlim_cur != RLIM_INFINITY { Some(rlim.rlim_cur) } else { None }, | ||
| if rlim.rlim_max != RLIM_INFINITY { Some(rlim.rlim_max) } else { None }) | ||
| }) | ||
| } | ||
|
|
||
| /// Set the current processes resource limits | ||
| /// | ||
| /// A value of `None` corresponds to `RLIM_INFINITY`, which means there's no limit. | ||
|
||
| /// | ||
| /// # Parameters | ||
| /// | ||
| /// * `resource`: The [`Resource`] that we want to set the limits of. | ||
| /// * `soft_limit`: The value that the kenrel enforces for the corresponding resource. | ||
|
||
| /// * `hard_limit`: The ceiling for the soft limit. Must be lower or equal to the current hard limit | ||
| /// for non-root users. | ||
| /// | ||
| /// # Examples | ||
| /// | ||
| /// ```no_run | ||
| /// use nix::sys::resource::{setrlimit, Resource}; | ||
| /// | ||
| /// fn main() { | ||
| /// let soft_limit = Some(1024); | ||
| /// let hard_limit = None; | ||
| /// setrlimit(Resource::RLIMIT_NOFILE, soft_limit, hard_limit).unwrap(); | ||
| /// } | ||
| /// ``` | ||
| /// | ||
| /// # References | ||
| /// | ||
| /// [setrlimit(2)](https://linux.die.net/man/2/setrlimit) | ||
| /// | ||
| /// [`Resource`]: enum.Resource.html | ||
| pub fn setrlimit(resource: Resource, soft_limit: Option<rlim_t>, hard_limit: Option<rlim_t>) -> Result<()> { | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I came in here to suggest changing this to pub fn setrlimit<S=rlim_t, H=rlim_t>(resource: Resource, soft_limit: Option<rlim_t>, hard_limit: Option<rlim_t>) -> Result<()>
where S: Into<Option<rlim_t>>, H: Into<Option<rlim_t>> { // ...playground example to take advantage for the but it turns out we can't use default type params in functions on stable. There's a WG looking into this, so maybe we can open it up later this year. (This would allow |
||
| let mut rlim: rlimit = unsafe { mem::uninitialized() }; | ||
| rlim.rlim_cur = soft_limit.unwrap_or(RLIM_INFINITY); | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Should this be checked to be less than
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I would prefer to leave this to the kernel. |
||
| rlim.rlim_max = hard_limit.unwrap_or(RLIM_INFINITY); | ||
|
|
||
| let res = unsafe { libc::setrlimit(resource as c_int, &rlim as *const _) }; | ||
| Errno::result(res).map(drop) | ||
|
||
| } | ||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| use nix::sys::resource::{Resource, getrlimit, setrlimit}; | ||
|
|
||
| #[test] | ||
| pub fn test_resource_limits_nofile() { | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Can you summarize what this test is doing? Makes it easier to fix or modify them later. |
||
| let (soft_limit, hard_limit) = getrlimit(Resource::RLIMIT_NOFILE).unwrap(); | ||
|
|
||
| // make sure the soft limit and hard limit are not equal | ||
| let soft_limit = match soft_limit { | ||
| Some(nofile) => Some(nofile -1), | ||
|
||
| None => Some(1024), | ||
| }; | ||
| setrlimit(Resource::RLIMIT_NOFILE, soft_limit, hard_limit).unwrap(); | ||
|
|
||
| let (new_soft_limit, new_hard_limit) = getrlimit(Resource::RLIMIT_NOFILE).unwrap(); | ||
| assert!(new_soft_limit != new_hard_limit); | ||
|
||
| } | ||
|
|
||
| #[test] | ||
| pub fn test_resource_limits_stack() { | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Could you provide some comments or a general summarizing comment here? It makes it easier for us reviewers to understand and to modify/fix them later. |
||
| let (mut soft_limit, hard_limit) = getrlimit(Resource::RLIMIT_STACK).unwrap(); | ||
| let orig_limit = (soft_limit, hard_limit); | ||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Your changes to the test do fix the previous failure, but the coverage isn't very good, since the soft and hard limits are often identical. How about setting
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Done
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Do we really need two tests? Does the stack test provide any extra coverage over the |
||
|
|
||
| soft_limit = hard_limit; | ||
| setrlimit(Resource::RLIMIT_STACK, soft_limit, hard_limit).unwrap(); | ||
|
|
||
| let limit2 = getrlimit(Resource::RLIMIT_STACK).unwrap(); | ||
| assert_eq!(soft_limit, limit2.0); | ||
| assert_eq!(hard_limit, limit2.1); | ||
|
|
||
| setrlimit(Resource::RLIMIT_STACK, orig_limit.0, orig_limit.1).unwrap(); | ||
|
|
||
| let final_limit = getrlimit(Resource::RLIMIT_STACK).unwrap(); | ||
| assert_eq!(orig_limit.0, final_limit.0); | ||
| assert_eq!(orig_limit.1, final_limit.1); | ||
| } | ||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This enum needs a doccomment as well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done